@vibecook/chopsticks-core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 James Yong
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/events.d.ts

@@ -0,0 +1,210 @@
+/**
+ * Normalized agent events and the envelope that carries them (DESIGN §14),
+ * corrected by the Phase 0 probe (draft/HOOK-SURFACE-FINDINGS.md):
+ * - Claude Code supplies BOTH a prompt id (user turn, on all post-prompt hook
+ *   events) and a distinct assistant turn id (MessageDisplay) — the envelope
+ *   keeps both instead of collapsing them.
+ * - MessageDisplay streams deltas keyed by message id; assistant.message here
+ *   is the accumulated form, `final` marks completion.
+ * - Stop carries the final assistant text, surfaced on turn.completed.
+ */
+/** DESIGN ADR-001 — native-tui is a first-class mode, not a fallback. */
+export type AgentExecutionMode = 'native-tui' | 'structured' | 'acp';
+/**
+ * DESIGN §19.2 — the runtime must never overstate what it can observe.
+ * `structured` (above `native-hooks`) is a driver whose native surface is an
+ * authoritative structured protocol — streaming semantic events AND structured
+ * approvals — e.g. Codex's app-server (M5). `native-hooks` is authoritative
+ * lifecycle/tool state via hooks; the rest degrade from there.
+ */
+export type ObservationLevel = 'structured' | 'native-hooks' | 'native-log' | 'workspace-process' | 'terminal-only';
+/** DESIGN §14.1 — where a normalized event came from. */
+export type AgentEventSource = 'native-hook' | 'native-transcript' | 'workspace' | 'process' | 'terminal-inference' | 'runtime';
+export type AgentEventConfidence = 'authoritative' | 'derived' | 'inferred';
+/** DESIGN §21.4 — process exit and semantic turn completion are separate facts. */
+export type ProcessExitReason = 'completed' | 'user-terminated' | 'runtime-terminated' | 'signal' | 'crash' | 'spawn-failed' | 'workspace-failed' | 'unknown';
+export interface AgentEventEnvelope<T extends AgentEvent = AgentEvent> {
+    /** Monotonic per session, assigned by the runtime at ingestion, before fan-out. */
+    sequence: number;
+    sessionId: string;
+    nativeSessionId?: string;
+    /** User-turn correlation (Claude Code `prompt_id`). */
+    promptId?: string;
+    /** Assistant response-cycle correlation (Claude Code `turn_id`). */
+    turnId?: string;
+    timestamp: string;
+    monotonicTime: number;
+    source: AgentEventSource;
+    confidence: AgentEventConfidence;
+    event: T;
+    /** DESIGN ADR-008 — the raw native event is always retained. */
+    nativeEvent?: unknown;
+}
+export interface SessionStartedEvent {
+    type: 'session.started';
+    nativeSessionId?: string;
+    title?: string;
+    /** Claude Code `SessionStart.source`, e.g. "startup". */
+    startSource?: string;
+}
+export interface SessionReadyEvent {
+    type: 'session.ready';
+}
+export interface SessionExitedEvent {
+    type: 'session.exited';
+    /** Claude Code `SessionEnd.reason`; value set not yet fully mapped. */
+    reason?: string;
+}
+export interface TurnStartedEvent {
+    type: 'turn.started';
+    /** Claude Code `prompt_id`. */
+    turnId?: string;
+    prompt?: string;
+}
+export interface TurnCompletedEvent {
+    type: 'turn.completed';
+    turnId?: string;
+    stopReason?: string;
+    /** Claude Code `Stop.last_assistant_message`. */
+    lastAssistantMessage?: string;
+}
+export interface TurnFailedEvent {
+    type: 'turn.failed';
+    turnId?: string;
+    error?: string;
+}
+export interface AssistantMessageEvent {
+    type: 'assistant.message';
+    messageId?: string;
+    turnId?: string;
+    text: string;
+    /** False while deltas are still accumulating (MessageDisplay `final`). */
+    final?: boolean;
+    /** True when sourced from display events rather than the transcript. */
+    displayOnly?: boolean;
+}
+/** A protocol-authoritative reasoning phase. This carries presence, not hidden thought text. */
+export interface ReasoningStartedEvent {
+    type: 'reasoning.started';
+    reasoningId?: string;
+}
+/** An explicitly user-displayable reasoning summary, accumulated by the adapter. */
+export interface ReasoningSummaryEvent {
+    type: 'reasoning.summary';
+    reasoningId?: string;
+    text: string;
+    final?: boolean;
+}
+/** A reasoning pulse whose raw provider payload is retained on the envelope. */
+export interface ReasoningProgressEvent {
+    type: 'reasoning.progress';
+    reasoningId?: string;
+}
+export interface ReasoningCompletedEvent {
+    type: 'reasoning.completed';
+    reasoningId?: string;
+}
+export type ToolActivityKind = 'command' | 'web-search' | 'file-read' | 'file-edit' | 'browser' | 'mcp' | 'other';
+/** Provider-neutral UI metadata. Adapters classify native tool names here. */
+export interface ToolPresentation {
+    kind: ToolActivityKind;
+    title: string;
+    detail?: string;
+}
+export interface ToolRequestedEvent {
+    type: 'tool.requested';
+    toolCallId: string;
+    tool: string;
+    input?: unknown;
+    presentation?: ToolPresentation;
+}
+/** For structured/ACP drivers that distinguish acceptance from execution. */
+export interface ToolStartedEvent {
+    type: 'tool.started';
+    toolCallId: string;
+    tool?: string;
+    input?: unknown;
+    presentation?: ToolPresentation;
+}
+export interface ToolCompletedEvent {
+    type: 'tool.completed';
+    toolCallId: string;
+    tool?: string;
+    output?: unknown;
+    durationMs?: number;
+    presentation?: ToolPresentation;
+}
+export interface ToolFailedEvent {
+    type: 'tool.failed';
+    toolCallId: string;
+    tool?: string;
+    error?: string;
+    presentation?: ToolPresentation;
+}
+export interface PermissionRequestedEvent {
+    type: 'permission.requested';
+    requestId: string;
+    toolCallId?: string;
+    tool?: string;
+    input?: unknown;
+    presentation: 'native-tui' | 'host-ui';
+}
+export interface PermissionResolvedEvent {
+    type: 'permission.resolved';
+    requestId: string;
+    outcome: 'allowed' | 'denied' | 'dismissed' | 'unknown';
+}
+export interface SubagentStartedEvent {
+    type: 'subagent.started';
+    subagentId: string;
+    agentType?: string;
+}
+export interface SubagentStoppedEvent {
+    type: 'subagent.stopped';
+    subagentId: string;
+}
+export interface TaskCreatedEvent {
+    type: 'task.created';
+    taskId: string;
+    description?: string;
+}
+export interface TaskCompletedEvent {
+    type: 'task.completed';
+    taskId: string;
+}
+export interface WorkspaceChangedEvent {
+    type: 'workspace.changed';
+    paths?: string[];
+}
+export interface ProcessStartedEvent {
+    type: 'process.started';
+    pid: number;
+}
+export interface ProcessExitedEvent {
+    type: 'process.exited';
+    exitCode?: number;
+    signal?: string;
+    reason: ProcessExitReason;
+}
+export interface NativeNotificationEvent {
+    type: 'notification';
+    message?: string;
+    notificationType?: string;
+}
+/** DESIGN ADR-008 — unrecognized native events survive normalization. */
+export interface UnknownNativeEvent {
+    type: 'adapter.native-event';
+    adapter: string;
+    nativeType?: string;
+}
+export type AgentEvent = SessionStartedEvent | SessionReadyEvent | SessionExitedEvent | TurnStartedEvent | TurnCompletedEvent | TurnFailedEvent | AssistantMessageEvent | ReasoningStartedEvent | ReasoningProgressEvent | ReasoningSummaryEvent | ReasoningCompletedEvent | ToolRequestedEvent | ToolStartedEvent | ToolCompletedEvent | ToolFailedEvent | PermissionRequestedEvent | PermissionResolvedEvent | SubagentStartedEvent | SubagentStoppedEvent | TaskCreatedEvent | TaskCompletedEvent | WorkspaceChangedEvent | ProcessStartedEvent | ProcessExitedEvent | NativeNotificationEvent | UnknownNativeEvent;
+export interface EnvelopeStamper {
+    next<T extends AgentEvent>(fields: Omit<AgentEventEnvelope<T>, 'sequence'>): AgentEventEnvelope<T>;
+}
+/**
+ * Sequence numbers are assigned at ingestion, before fan-out, so every
+ * consumer observes the same order (DESIGN §12.1 applies the same rule to
+ * terminal chunks). One stamper per session.
+ */
+export declare function createEnvelopeStamper(): EnvelopeStamper;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"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"}

package/dist/events.js

@@ -0,0 +1,25 @@
+/**
+ * Normalized agent events and the envelope that carries them (DESIGN §14),
+ * corrected by the Phase 0 probe (draft/HOOK-SURFACE-FINDINGS.md):
+ * - Claude Code supplies BOTH a prompt id (user turn, on all post-prompt hook
+ *   events) and a distinct assistant turn id (MessageDisplay) — the envelope
+ *   keeps both instead of collapsing them.
+ * - MessageDisplay streams deltas keyed by message id; assistant.message here
+ *   is the accumulated form, `final` marks completion.
+ * - Stop carries the final assistant text, surfaced on turn.completed.
+ */
+/**
+ * Sequence numbers are assigned at ingestion, before fan-out, so every
+ * consumer observes the same order (DESIGN §12.1 applies the same rule to
+ * terminal chunks). One stamper per session.
+ */
+export function createEnvelopeStamper() {
+    let sequence = 0;
+    return {
+        next(fields) {
+            sequence += 1;
+            return { sequence, ...fields };
+        },
+    };
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkRH;;;;GAIG;AACH,MAAM,UAAU,qBAAqB;IACnC,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,OAAO;QACL,IAAI,CAAC,MAAM;YACT,QAAQ,IAAI,CAAC,CAAC;YACd,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,CAAC;QACjC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/host.d.ts

@@ -0,0 +1,69 @@
+/**
+ * AgentHost — the terminal/process capability an application (the workbench, a
+ * CLI, …) lends to an adapter so the adapter can own its FULL native-TUI spawn
+ * recipe without owning PTY infrastructure. This lifts the Claude adapter's
+ * `ports` shape (DESIGN §16) into core so every adapter shares ONE injection
+ * point, and it is what lets the Codex app-server + `codex --remote` and the
+ * Grok leader + `grok --leader` recipes move out of the app and into their
+ * adapters (ADR-007: process lifecycle belongs to the host; the adapter only
+ * asks the host to spawn/automate, and observes/controls the result).
+ */
+/** A native terminal (PTY) the host should spawn on the adapter's behalf. */
+export interface TerminalSpec {
+    command: string;
+    args: string[];
+    cwd: string;
+    /** Extra environment for the spawned process (merged over the host's base). */
+    env?: Record<string, string>;
+    /** Initial geometry; the host may substitute its own default when omitted. */
+    cols?: number;
+    rows?: number;
+}
+/**
+ * The capability surface an adapter needs from its host. Deliberately tiny:
+ * spawn a terminal and write raw bytes to one. Everything else (transcripts,
+ * app-servers, leaders, sockets) the adapter builds itself.
+ */
+export type TerminalAutomationOperation = {
+    kind: 'paste';
+    text: string;
+    submit: boolean;
+} | {
+    kind: 'text';
+    text: string;
+} | {
+    kind: 'interrupt';
+};
+export type TerminalAutomationResult = {
+    accepted: true;
+} | {
+    accepted: false;
+    reason: 'human-input-conflict' | string;
+};
+export interface AgentHost {
+    /** Spawn a native terminal for the agent; returns the host's routing id. */
+    spawnTerminal(spec: TerminalSpec): Promise<{
+        runtimeSessionId: string;
+    }>;
+    /**
+     * Submit one semantic automation operation. The terminal service orders it
+     * atomically against accepted human input without attaching a view, taking
+     * focus, or claiming resize control.
+     */
+    automateTerminal(runtimeSessionId: string, operation: TerminalAutomationOperation): Promise<TerminalAutomationResult>;
+}
+/**
+ * The options every native-TUI session factory accepts. Each adapter's
+ * `createXTuiSession` extends this with its own extras (executable, sandbox, …)
+ * and returns an {@link AgentSession} whose `runtimeSessionId` is the terminal
+ * the host spawned and whose `dispose()` tears down the adapter's own backing
+ * services (observer, app-server, leader client).
+ */
+export interface AgentTuiSessionOptions {
+    cwd: string;
+    /** Resume an existing session by its native/join id. */
+    resume?: string;
+    /** The host capability the adapter spawns/writes its terminal through. */
+    host: AgentHost;
+}
+//# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,+EAA+E;IAC/E,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,MAAM,2BAA2B,GACrC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC;AAE5G,MAAM,MAAM,wBAAwB,GAClC;IAAE,QAAQ,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAAA;CAAE,CAAC;AAEpF,MAAM,WAAW,SAAS;IACxB,4EAA4E;IAC5E,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC;QAAE,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzE;;;;OAIG;IACH,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,EAAE,SAAS,EAAE,2BAA2B,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;CACvH;AAED;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,IAAI,EAAE,SAAS,CAAC;CACjB"}

package/dist/host.js

@@ -0,0 +1,12 @@
+/**
+ * AgentHost — the terminal/process capability an application (the workbench, a
+ * CLI, …) lends to an adapter so the adapter can own its FULL native-TUI spawn
+ * recipe without owning PTY infrastructure. This lifts the Claude adapter's
+ * `ports` shape (DESIGN §16) into core so every adapter shares ONE injection
+ * point, and it is what lets the Codex app-server + `codex --remote` and the
+ * Grok leader + `grok --leader` recipes move out of the app and into their
+ * adapters (ADR-007: process lifecycle belongs to the host; the adapter only
+ * asks the host to spawn/automate, and observes/controls the result).
+ */
+export {};
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @vibecook/chopsticks-core — contracts for the chopsticks agent runtime.
+ *
+ * Zero I/O by design (DESIGN §8, acceptance criterion 19): types, the session
+ * state reducer, and pure helpers only. Anything touching a PTY, process,
+ * socket, or file lives in @vibecook/chopsticks-node or an adapter package.
+ */
+export * from './events.js';
+export * from './state.js';
+export * from './session.js';
+export * from './host.js';
+export declare const CHOPSTICKS_CORE_VERSION = "0.1.0";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAE1B,eAAO,MAAM,uBAAuB,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * @vibecook/chopsticks-core — contracts for the chopsticks agent runtime.
+ *
+ * Zero I/O by design (DESIGN §8, acceptance criterion 19): types, the session
+ * state reducer, and pure helpers only. Anything touching a PTY, process,
+ * socket, or file lives in @vibecook/chopsticks-node or an adapter package.
+ */
+export * from './events.js';
+export * from './state.js';
+export * from './session.js';
+export * from './host.js';
+export const CHOPSTICKS_CORE_VERSION = '0.1.0'; // x-release-please-version
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAE1B,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAO,CAAC,CAAC,2BAA2B"}

package/dist/session.d.ts

@@ -0,0 +1,63 @@
+/**
+ * The agent-agnostic session contract (DESIGN §9), lifted into core once a
+ * second driver existed to test it against (M5: Claude's hook+PTY driver and
+ * Codex's structured app-server driver). Before that, `AgentSession` lived as a
+ * concrete `ClaudeSession` in the Claude adapter — lifting off one example
+ * would have baked in Claude's shape.
+ *
+ * Zero I/O by design (like the rest of core): interfaces only. Concrete drivers
+ * (`createClaudeSession`, the forthcoming `createCodexSession`) implement these.
+ */
+import type { AgentEventEnvelope, ObservationLevel } from './events.js';
+import type { SessionRuntimeState } from './state.js';
+/**
+ * A programmatic prompt submission (generalized from the Claude guarded
+ * injector, DESIGN §17).
+ */
+export interface PromptSubmission {
+    text: string;
+    /**
+     * Paste-and-submit (default) appends Enter; paste-only leaves it staged.
+     * Meaningful only to guarded-paste (native-TUI) injectors; structured drivers
+     * submit atomically and ignore it.
+     */
+    mode?: 'paste-and-submit' | 'paste-only';
+    confirmationTimeoutMs?: number;
+}
+/**
+ * Outcome of a prompt submission. `uncertain` is first-class: a guarded-paste
+ * injector cannot always prove the agent accepted exactly our text (DESIGN
+ * §17). Structured drivers with deterministic confirmation never emit it.
+ */
+export type PromptReceipt = {
+    status: 'confirmed';
+    turnId?: string;
+} | {
+    status: 'rejected';
+    reason: string;
+} | {
+    status: 'uncertain';
+    reason: string;
+};
+/**
+ * The handle every driver returns for one live agent process/thread — observed
+ * and controlled. Process lifecycle (spawn/terminate) belongs to the host, not
+ * this handle (ADR-007); `dispose()` tears down observation/control only.
+ *
+ * Adapters MAY extend this with native extras, but applications should normally
+ * consume the provider-neutral AgentRuntime surface from chopsticks-runtime.
+ */
+export interface AgentSession {
+    /** Native/join id — the chopsticks ↔ spaghetti correlation key. */
+    readonly sessionId: string;
+    /** The host's id for the terminal session (attach/write/kill routing). */
+    readonly runtimeSessionId: string;
+    state(): SessionRuntimeState;
+    /** Honest, current observation level — never overstated (DESIGN §19.2). */
+    observationLevel(): ObservationLevel;
+    onEvent(listener: (envelope: AgentEventEnvelope) => void): () => void;
+    submitPrompt(submission: PromptSubmission): Promise<PromptReceipt>;
+    /** Tear down observation/control. Process lifecycle stays with the host. */
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,CAAC,EAAE,kBAAkB,GAAG,YAAY,CAAC;IACzC,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5C;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0EAA0E;IAC1E,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,KAAK,IAAI,mBAAmB,CAAC;IAC7B,2EAA2E;IAC3E,gBAAgB,IAAI,gBAAgB,CAAC;IACrC,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACtE,YAAY,CAAC,UAAU,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACnE,4EAA4E;IAC5E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}

package/dist/session.js

@@ -0,0 +1,12 @@
+/**
+ * The agent-agnostic session contract (DESIGN §9), lifted into core once a
+ * second driver existed to test it against (M5: Claude's hook+PTY driver and
+ * Codex's structured app-server driver). Before that, `AgentSession` lived as a
+ * concrete `ClaudeSession` in the Claude adapter — lifting off one example
+ * would have baked in Claude's shape.
+ *
+ * Zero I/O by design (like the rest of core): interfaces only. Concrete drivers
+ * (`createClaudeSession`, the forthcoming `createCodexSession`) implement these.
+ */
+export {};
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/state.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Session state reducer (DESIGN §15).
+ *
+ * All normalized events pass through this deterministic, pure reducer:
+ * - never throws on duplicate, out-of-order, or unknown events
+ * - duplicates (sequence <= lastSequence) are skipped by returning the SAME
+ *   state reference, so replays are idempotent
+ * - invalid transitions produce bounded diagnostics, never exceptions
+ * - the raw event log is retained upstream (envelopes are append-only);
+ *   state is always rebuildable by replay
+ *
+ * Terminal geometry and control-lease state (DESIGN §15's `terminal`/`control`
+ * fields) are owned by the node runtime, not this reducer — they derive from
+ * PTY and lease facts, not agent events.
+ */
+import type { AgentEventEnvelope, ProcessExitReason, ToolPresentation } from './events.js';
+export type SessionLifecycle = 'preparing' | 'starting' | 'ready' | 'running' | 'interrupting' | 'terminating' | 'exited' | 'failed';
+export interface ToolRuntimeState {
+    toolCallId: string;
+    tool?: string;
+    state: 'requested' | 'running';
+    input?: unknown;
+    presentation?: ToolPresentation;
+}
+export interface ReasoningRuntimeState {
+    reasoningId?: string;
+    startedAt: string;
+}
+export interface PermissionRuntimeState {
+    requestId: string;
+    toolCallId?: string;
+    tool?: string;
+}
+export interface SubagentRuntimeState {
+    subagentId: string;
+    agentType?: string;
+}
+export interface TaskRuntimeState {
+    taskId: string;
+    description?: string;
+}
+export interface ReducerDiagnostic {
+    sequence: number;
+    code: string;
+    message: string;
+}
+export interface SessionRuntimeState {
+    lifecycle: SessionLifecycle;
+    activeTurn?: {
+        id?: string;
+        startedAt: string;
+    };
+    /** Present only for providers with an explicit reasoning signal. */
+    activeReasoning?: ReasoningRuntimeState;
+    /** Tools currently in flight. Completed/failed tools LEAVE this map. */
+    tools: Map<string, ToolRuntimeState>;
+    /** Pending permission requests. Resolved requests leave this map. */
+    permissions: Map<string, PermissionRuntimeState>;
+    subagents: Map<string, SubagentRuntimeState>;
+    tasks: Map<string, TaskRuntimeState>;
+    lastAssistantMessage?: string;
+    exit?: {
+        exitCode?: number;
+        signal?: string;
+        reason?: ProcessExitReason | string;
+    };
+    counters: {
+        toolsCompleted: number;
+        toolsFailed: number;
+        unknownEvents: number;
+    };
+    lastSequence: number;
+    diagnostics: ReducerDiagnostic[];
+}
+export declare function createInitialSessionState(): SessionRuntimeState;
+export declare function reduceSessionState(state: SessionRuntimeState, envelope: AgentEventEnvelope): SessionRuntimeState;
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAc,kBAAkB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEvG,MAAM,MAAM,gBAAgB,GAC1B,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,cAAc,GAAG,aAAa,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAExG,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,WAAW,GAAG,SAAS,CAAC;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACjC;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,UAAU,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,oEAAoE;IACpE,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,wEAAwE;IACxE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACrC,qEAAqE;IACrE,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IACjD,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAC7C,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACrC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAA;KAAE,CAAC;IACnF,QAAQ,EAAE;QACR,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,iBAAiB,EAAE,CAAC;CAClC;AAID,wBAAgB,yBAAyB,IAAI,mBAAmB,CAW/D;AAgBD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,kBAAkB,GAAG,mBAAmB,CAyOhH"}

package/dist/state.js

@@ -0,0 +1,240 @@
+/**
+ * Session state reducer (DESIGN §15).
+ *
+ * All normalized events pass through this deterministic, pure reducer:
+ * - never throws on duplicate, out-of-order, or unknown events
+ * - duplicates (sequence <= lastSequence) are skipped by returning the SAME
+ *   state reference, so replays are idempotent
+ * - invalid transitions produce bounded diagnostics, never exceptions
+ * - the raw event log is retained upstream (envelopes are append-only);
+ *   state is always rebuildable by replay
+ *
+ * Terminal geometry and control-lease state (DESIGN §15's `terminal`/`control`
+ * fields) are owned by the node runtime, not this reducer — they derive from
+ * PTY and lease facts, not agent events.
+ */
+const MAX_DIAGNOSTICS = 50;
+export function createInitialSessionState() {
+    return {
+        lifecycle: 'preparing',
+        tools: new Map(),
+        permissions: new Map(),
+        subagents: new Map(),
+        tasks: new Map(),
+        counters: { toolsCompleted: 0, toolsFailed: 0, unknownEvents: 0 },
+        lastSequence: 0,
+        diagnostics: [],
+    };
+}
+function withDiagnostic(state, sequence, code, message) {
+    if (state.diagnostics.length >= MAX_DIAGNOSTICS)
+        return state;
+    return { ...state, diagnostics: [...state.diagnostics, { sequence, code, message }] };
+}
+function isTerminal(lifecycle) {
+    return lifecycle === 'exited' || lifecycle === 'failed';
+}
+export function reduceSessionState(state, envelope) {
+    // Duplicate / out-of-order guard: envelopes are stamped in ingestion order,
+    // so a non-increasing sequence is a replayed or stale event. Returning the
+    // same reference keeps replays idempotent.
+    if (envelope.sequence <= state.lastSequence)
+        return state;
+    let next = { ...state, lastSequence: envelope.sequence };
+    const event = envelope.event;
+    const seq = envelope.sequence;
+    switch (event.type) {
+        case 'process.started': {
+            if (next.lifecycle === 'preparing')
+                next = { ...next, lifecycle: 'starting' };
+            else
+                next = withDiagnostic(next, seq, 'process-started-late', `process.started in ${next.lifecycle}`);
+            break;
+        }
+        case 'session.started':
+        case 'session.ready': {
+            if (isTerminal(next.lifecycle)) {
+                next = withDiagnostic(next, seq, 'session-start-after-exit', `${event.type} in ${next.lifecycle}`);
+            }
+            else if (next.lifecycle !== 'running') {
+                next = { ...next, lifecycle: 'ready' };
+            }
+            break;
+        }
+        case 'turn.started': {
+            if (isTerminal(next.lifecycle)) {
+                next = withDiagnostic(next, seq, 'turn-after-exit', `turn.started in ${next.lifecycle}`);
+                break;
+            }
+            if (next.activeTurn) {
+                next = withDiagnostic(next, seq, 'turn-overlap', `turn.started while turn ${next.activeTurn.id ?? '?'} active`);
+            }
+            next = { ...next, lifecycle: 'running', activeTurn: { id: event.turnId, startedAt: envelope.timestamp } };
+            break;
+        }
+        case 'turn.completed':
+        case 'turn.failed': {
+            if (next.activeTurn && event.turnId && next.activeTurn.id && next.activeTurn.id !== event.turnId) {
+                next = withDiagnostic(next, seq, 'turn-mismatch', `${event.type} for ${event.turnId}, active is ${next.activeTurn.id}`);
+            }
+            next = { ...next, activeTurn: undefined, activeReasoning: undefined };
+            if (!isTerminal(next.lifecycle))
+                next = { ...next, lifecycle: 'ready' };
+            if (event.type === 'turn.completed' && event.lastAssistantMessage !== undefined) {
+                next = { ...next, lastAssistantMessage: event.lastAssistantMessage };
+            }
+            break;
+        }
+        case 'assistant.message': {
+            if (event.final !== false)
+                next = { ...next, lastAssistantMessage: event.text };
+            break;
+        }
+        case 'reasoning.started':
+            next = {
+                ...next,
+                activeReasoning: { reasoningId: event.reasoningId, startedAt: envelope.timestamp },
+            };
+            break;
+        case 'reasoning.progress':
+        case 'reasoning.summary':
+            if (!next.activeReasoning) {
+                next = {
+                    ...next,
+                    activeReasoning: { reasoningId: event.reasoningId, startedAt: envelope.timestamp },
+                };
+            }
+            break;
+        case 'reasoning.completed':
+            next = { ...next, activeReasoning: undefined };
+            break;
+        case 'tool.requested': {
+            const tools = new Map(next.tools);
+            tools.set(event.toolCallId, {
+                toolCallId: event.toolCallId,
+                tool: event.tool,
+                state: 'requested',
+                input: event.input,
+                presentation: event.presentation,
+            });
+            next = { ...next, tools };
+            break;
+        }
+        case 'tool.started': {
+            const existing = next.tools.get(event.toolCallId);
+            const tools = new Map(next.tools);
+            tools.set(event.toolCallId, {
+                toolCallId: event.toolCallId,
+                tool: event.tool ?? existing?.tool,
+                state: 'running',
+                input: event.input ?? existing?.input,
+                presentation: event.presentation ?? existing?.presentation,
+            });
+            next = { ...next, tools };
+            break;
+        }
+        case 'tool.completed':
+        case 'tool.failed': {
+            // Absent ids are not diagnostics: hook and transcript sources may both
+            // report the same completion, and the second one finds the map empty.
+            if (next.tools.has(event.toolCallId)) {
+                const tools = new Map(next.tools);
+                tools.delete(event.toolCallId);
+                next = { ...next, tools };
+            }
+            const counters = { ...next.counters };
+            if (event.type === 'tool.completed')
+                counters.toolsCompleted += 1;
+            else
+                counters.toolsFailed += 1;
+            next = { ...next, counters };
+            break;
+        }
+        case 'permission.requested': {
+            // Permission state is intentionally isolated from tool state (DESIGN §26.5).
+            const permissions = new Map(next.permissions);
+            permissions.set(event.requestId, { requestId: event.requestId, toolCallId: event.toolCallId, tool: event.tool });
+            next = { ...next, permissions };
+            break;
+        }
+        case 'permission.resolved': {
+            if (next.permissions.has(event.requestId)) {
+                const permissions = new Map(next.permissions);
+                permissions.delete(event.requestId);
+                next = { ...next, permissions };
+            }
+            break;
+        }
+        case 'subagent.started': {
+            const subagents = new Map(next.subagents);
+            subagents.set(event.subagentId, { subagentId: event.subagentId, agentType: event.agentType });
+            next = { ...next, subagents };
+            break;
+        }
+        case 'subagent.stopped': {
+            if (next.subagents.has(event.subagentId)) {
+                const subagents = new Map(next.subagents);
+                subagents.delete(event.subagentId);
+                next = { ...next, subagents };
+            }
+            break;
+        }
+        case 'task.created': {
+            const tasks = new Map(next.tasks);
+            tasks.set(event.taskId, { taskId: event.taskId, description: event.description });
+            next = { ...next, tasks };
+            break;
+        }
+        case 'task.completed': {
+            if (next.tasks.has(event.taskId)) {
+                const tasks = new Map(next.tasks);
+                tasks.delete(event.taskId);
+                next = { ...next, tasks };
+            }
+            break;
+        }
+        case 'session.exited': {
+            if (next.activeTurn) {
+                next = withDiagnostic(next, seq, 'turn-orphaned-on-exit', `session exited with turn ${next.activeTurn.id ?? '?'} active`);
+            }
+            if (next.tools.size > 0) {
+                next = withDiagnostic(next, seq, 'tools-orphaned-on-exit', `session exited with ${next.tools.size} tool(s) in flight`);
+            }
+            next = {
+                ...next,
+                lifecycle: 'exited',
+                activeTurn: undefined,
+                activeReasoning: undefined,
+                tools: new Map(),
+                permissions: new Map(),
+                exit: next.exit ?? { reason: event.reason },
+            };
+            break;
+        }
+        case 'process.exited': {
+            const failed = event.reason === 'crash' || event.reason === 'spawn-failed' || event.reason === 'workspace-failed';
+            next = {
+                ...next,
+                lifecycle: isTerminal(next.lifecycle) ? next.lifecycle : failed ? 'failed' : 'exited',
+                activeTurn: undefined,
+                activeReasoning: undefined,
+                exit: { exitCode: event.exitCode, signal: event.signal, reason: event.reason },
+            };
+            break;
+        }
+        case 'workspace.changed':
+        case 'notification':
+            break;
+        case 'adapter.native-event': {
+            next = { ...next, counters: { ...next.counters, unknownEvents: next.counters.unknownEvents + 1 } };
+            break;
+        }
+        default: {
+            // Unknown event types must never throw (DESIGN §15.2).
+            next = { ...next, counters: { ...next.counters, unknownEvents: next.counters.unknownEvents + 1 } };
+            break;
+        }
+    }
+    return next;
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAgEH,MAAM,eAAe,GAAG,EAAE,CAAC;AAE3B,MAAM,UAAU,yBAAyB;IACvC,OAAO;QACL,SAAS,EAAE,WAAW;QACtB,KAAK,EAAE,IAAI,GAAG,EAAE;QAChB,WAAW,EAAE,IAAI,GAAG,EAAE;QACtB,SAAS,EAAE,IAAI,GAAG,EAAE;QACpB,KAAK,EAAE,IAAI,GAAG,EAAE;QAChB,QAAQ,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE;QACjE,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,EAAE;KAChB,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CACrB,KAA0B,EAC1B,QAAgB,EAChB,IAAY,EACZ,OAAe;IAEf,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,IAAI,eAAe;QAAE,OAAO,KAAK,CAAC;IAC9D,OAAO,EAAE,GAAG,KAAK,EAAE,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;AACxF,CAAC;AAED,SAAS,UAAU,CAAC,SAA2B;IAC7C,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,QAAQ,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAA0B,EAAE,QAA4B;IACzF,4EAA4E;IAC5E,2EAA2E;IAC3E,2CAA2C;IAC3C,IAAI,QAAQ,CAAC,QAAQ,IAAI,KAAK,CAAC,YAAY;QAAE,OAAO,KAAK,CAAC;IAE1D,IAAI,IAAI,GAAwB,EAAE,GAAG,KAAK,EAAE,YAAY,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC;IAC9E,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAmB,CAAC;IAC3C,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC;IAE9B,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,iBAAiB,CAAC,CAAC,CAAC;YACvB,IAAI,IAAI,CAAC,SAAS,KAAK,WAAW;gBAAE,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;;gBACzE,IAAI,GAAG,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,sBAAsB,EAAE,sBAAsB,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;YACtG,MAAM;QACR,CAAC;QAED,KAAK,iBAAiB,CAAC;QACvB,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC/B,IAAI,GAAG,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,0BAA0B,EAAE,GAAG,KAAK,CAAC,IAAI,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;YACrG,CAAC;iBAAM,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;gBACxC,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;YACzC,CAAC;YACD,MAAM;QACR,CAAC;QAED,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC/B,IAAI,GAAG,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,iBAAiB,EAAE,mBAAmB,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;gBACzF,MAAM;YACR,CAAC;YACD,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACpB,IAAI,GAAG,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,cAAc,EAAE,2BAA2B,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC,CAAC;YAClH,CAAC;YACD,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC;YAC1G,MAAM;QACR,CAAC;QAED,KAAK,gBAAgB,CAAC;QACtB,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,IAAI,IAAI,CAAC,UAAU,IAAI,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjG,IAAI,GAAG,cAAc,CACnB,IAAI,EACJ,GAAG,EACH,eAAe,EACf,GAAG,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC,MAAM,eAAe,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CACrE,CAAC;YACJ,CAAC;YACD,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC;YACtE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC;gBAAE,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;YACxE,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,IAAI,KAAK,CAAC,oBAAoB,KAAK,SAAS,EAAE,CAAC;gBAChF,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,oBAAoB,EAAE,KAAK,CAAC,oBAAoB,EAAE,CAAC;YACvE,CAAC;YACD,MAAM;QACR,CAAC;QAED,KAAK,mBAAmB,CAAC,CAAC,CAAC;YACzB,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK;gBAAE,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,oBAAoB,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;YAChF,MAAM;QACR,CAAC;QAED,KAAK,mBAAmB;YACtB,IAAI,GAAG;gBACL,GAAG,IAAI;gBACP,eAAe,EAAE,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE;aACnF,CAAC;YACF,MAAM;QAER,KAAK,oBAAoB,CAAC;QAC1B,KAAK,mBAAmB;YACtB,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;gBAC1B,IAAI,GAAG;oBACL,GAAG,IAAI;oBACP,eAAe,EAAE,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE;iBACnF,CAAC;YACJ,CAAC;YACD,MAAM;QAER,KAAK,qBAAqB;YACxB,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC;YAC/C,MAAM;QAER,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE;gBAC1B,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,KAAK,EAAE,WAAW;gBAClB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,YAAY,EAAE,KAAK,CAAC,YAAY;aACjC,CAAC,CAAC;YACH,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC;YAC1B,MAAM;QACR,CAAC;QAED,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAClD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE;gBAC1B,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,QAAQ,EAAE,IAAI;gBAClC,KAAK,EAAE,SAAS;gBAChB,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,QAAQ,EAAE,KAAK;gBACrC,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,QAAQ,EAAE,YAAY;aAC3D,CAAC,CAAC;YACH,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC;YAC1B,MAAM;QACR,CAAC;QAED,KAAK,gBAAgB,CAAC;QACtB,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,uEAAuE;YACvE,sEAAsE;YACtE,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;gBACrC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAClC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBAC/B,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC;YAC5B,CAAC;YACD,MAAM,QAAQ,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtC,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB;gBAAE,QAAQ,CAAC,cAAc,IAAI,CAAC,CAAC;;gBAC7D,QAAQ,CAAC,WAAW,IAAI,CAAC,CAAC;YAC/B,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,CAAC;YAC7B,MAAM;QACR,CAAC;QAED,KAAK,sBAAsB,CAAC,CAAC,CAAC;YAC5B,6EAA6E;YAC7E,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC9C,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACjH,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,CAAC;YAChC,MAAM;QACR,CAAC;QAED,KAAK,qBAAqB,CAAC,CAAC,CAAC;YAC3B,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC1C,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;gBAC9C,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBACpC,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,CAAC;YAClC,CAAC;YACD,MAAM;QACR,CAAC;QAED,KAAK,kBAAkB,CAAC,CAAC,CAAC;YACxB,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC1C,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;YAC9F,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,CAAC;YAC9B,MAAM;QACR,CAAC;QAED,KAAK,kBAAkB,CAAC,CAAC,CAAC;YACxB,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;gBACzC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAC1C,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBACnC,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,CAAC;YAChC,CAAC;YACD,MAAM;QACR,CAAC;QAED,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;YAClF,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC;YAC1B,MAAM;QACR,CAAC;QAED,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;gBACjC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAClC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBAC3B,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC;YAC5B,CAAC;YACD,MAAM;QACR,CAAC;QAED,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACpB,IAAI,GAAG,cAAc,CACnB,IAAI,EACJ,GAAG,EACH,uBAAuB,EACvB,4BAA4B,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,GAAG,SAAS,CAC/D,CAAC;YACJ,CAAC;YACD,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBACxB,IAAI,GAAG,cAAc,CACnB,IAAI,EACJ,GAAG,EACH,wBAAwB,EACxB,uBAAuB,IAAI,CAAC,KAAK,CAAC,IAAI,oBAAoB,CAC3D,CAAC;YACJ,CAAC;YACD,IAAI,GAAG;gBACL,GAAG,IAAI;gBACP,SAAS,EAAE,QAAQ;gBACnB,UAAU,EAAE,SAAS;gBACrB,eAAe,EAAE,SAAS;gBAC1B,KAAK,EAAE,IAAI,GAAG,EAAE;gBAChB,WAAW,EAAE,IAAI,GAAG,EAAE;gBACtB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE;aAC5C,CAAC;YACF,MAAM;QACR,CAAC;QAED,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,KAAK,OAAO,IAAI,KAAK,CAAC,MAAM,KAAK,cAAc,IAAI,KAAK,CAAC,MAAM,KAAK,kBAAkB,CAAC;YAClH,IAAI,GAAG;gBACL,GAAG,IAAI;gBACP,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;gBACrF,UAAU,EAAE,SAAS;gBACrB,eAAe,EAAE,SAAS;gBAC1B,IAAI,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE;aAC/E,CAAC;YACF,MAAM;QACR,CAAC;QAED,KAAK,mBAAmB,CAAC;QACzB,KAAK,cAAc;YACjB,MAAM;QAER,KAAK,sBAAsB,CAAC,CAAC,CAAC;YAC5B,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,aAAa,GAAG,CAAC,EAAE,EAAE,CAAC;YACnG,MAAM;QACR,CAAC;QAED,OAAO,CAAC,CAAC,CAAC;YACR,uDAAuD;YACvD,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,aAAa,GAAG,CAAC,EAAE,EAAE,CAAC;YACnG,MAAM;QACR,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@vibecook/chopsticks-core",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Core contracts for the chopsticks agent runtime: events, session state reducer, adapter interfaces. Zero I/O.",
+  "license": "MIT",
+  "author": "James Yong",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jamesyong-42/chopsticks.git",
+    "directory": "packages/core"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "devDependencies": {
+    "fast-check": "^4.0.0"
+  },
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "build": "pnpm clean && tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}