Archived

This repository has been archived on 2026-06-01. You can view files and clone it. You cannot open issues or pull requests or push a commit.

Files

T

History

xiaoju e789c7bb34 refactor(core): stateful sense types — remove Signal, add initialState

Phase 1 of RFC #308: Stateful Sense refactor.

- SenseComputeFn<S> now takes state and returns { state, workflow }
- SenseModule<S> exports compute + initialState (no more table)
- Removed: Signal type, ComputeResult, RoutedSenseOutput,
  routeSenseComputeOutput, retention/DEFAULT_SENSE_SIGNAL_RETENTION
- Updated isSenseInfo (removed lastSignalTimestamp)

Refs #308, closes #309

2026-05-01 09:43:13 +00:00

src

refactor(core): stateful sense types — remove Signal, add initialState

2026-05-01 09:43:13 +00:00

package.json

refactor: pure sense compute — no db, no peers

2026-04-30 00:07:49 +00:00

README.md

chore: dead code cleanup — remove unused exports and fix stale docs

2026-04-30 14:29:45 +00:00

rslib.config.ts

refactor: move experimental-warning-suppression from core to daemon

2026-04-27 09:30:16 +00:00

tsconfig.json

feat(workflow-utils): RFC-003 Phase 3 — Extract Layer

2026-04-29 04:59:47 +00:00

README.md

@uncaged/nerve-core

Shared types and configuration parser for the nerve observation engine.

What's Inside

Type definitions — Signal, SenseConfig, SenseInfo, WorkflowConfig, NerveConfig, and related types
Config parser — parseNerveConfig(yaml) validates and parses nerve.yaml into NerveConfig (rejects reflex entries that declare a workflow key; reflexes only schedule senses)
Sense → workflow routing — parseWorkflowTrigger, routeSenseComputeOutput, and types WorkflowTrigger, RoutedSenseOutput
Daemon IPC protocol — request/response types (DaemonIpcRequest, DaemonIpcResponse, …) and parseDaemonIpcRequest for newline-delimited JSON on the CLI ↔ daemon socket
Workflow automaton types — START / END sentinel constants, WorkflowMessage, StartStep, RoleStep, ModeratorContext (start + steps; empty steps on first moderator call), Moderator (single context argument), WorkflowDefinition, Role, RoleResult, plus DEFAULT_ENGINE_MAX_ROUNDS
Result type — Result<T> with ok() / err() helpers for explicit error handling (no thrown exceptions for parse paths)

Usage

import { parseNerveConfig, ok, err } from "@uncaged/nerve-core";
import type { NerveConfig, Signal, Result } from "@uncaged/nerve-core";

const result: Result<NerveConfig> = parseNerveConfig(yamlString);
if (result.ok) {
  console.log(result.value.senses);
}

Sense return → signal vs workflow

import { parseWorkflowTrigger, routeSenseComputeOutput } from "@uncaged/nerve-core";

const directive = parseWorkflowTrigger({
  name: "my-workflow",
  maxRounds: 8,
  prompt: "Hello from sense",
  dryRun: false,
});
if (directive.ok) {
  console.log(directive.value.name, directive.value.maxRounds, directive.value.prompt);
}

const route = routeSenseComputeOutput({
  signal: { metric: 42 },
  workflow: {
    name: "my-workflow",
    maxRounds: 8,
    prompt: "Run now",
    dryRun: false,
  },
});
if (route.ok && route.value.workflow !== null) {
  console.log(route.value.workflow);
} else if (route.ok) {
  console.log(route.value.signal);
}

Duration Format

Config fields like throttle, timeout, and interval accept human-readable durations:

5s — 5 seconds
10m — 10 minutes
1h — 1 hour

Install

pnpm add @uncaged/nerve-core

License

MIT