@jstn-sdk/rcs 0.1.0

package/dist/runtime/__tests__/run-outcome.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-outcome.test.js","sourceRoot":"","sources":["../../../src/runtime/__tests__/run-outcome.test.ts"],"names":[],"mappings":"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"}

package/dist/runtime/__tests__/run-state.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=run-state.test.d.ts.map

package/dist/runtime/__tests__/run-state.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-state.test.d.ts","sourceRoot":"","sources":["../../../src/runtime/__tests__/run-state.test.ts"],"names":[],"mappings":""}

package/dist/runtime/__tests__/run-state.test.js

@@ -0,0 +1,37 @@
+import assert from 'node:assert/strict';
+import { mkdtemp, readFile, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { describe, it } from 'node:test';
+import { buildRunState, syncRunStateFromModeState } from '../run-state.js';
+describe('run state sync', () => {
+    it('preserves canonical askuserQuestion lifecycle while keeping legacy blocked_on_user outcome', () => {
+        const state = buildRunState({
+            mode: 'deep-interview',
+            active: false,
+            run_outcome: 'blocked_on_user',
+            lifecycle_outcome: 'askuserQuestion',
+        }, null, '2026-04-19T00:00:00.000Z');
+        assert.equal(state.outcome, 'blocked_on_user');
+        assert.equal(state.lifecycle_outcome, 'askuserQuestion');
+    });
+    it('writes canonical askuserQuestion lifecycle to run-state.json during sync', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'rcs-run-state-'));
+        try {
+            const synced = await syncRunStateFromModeState({
+                mode: 'deep-interview',
+                active: false,
+                run_outcome: 'blocked_on_user',
+                lifecycle_outcome: 'askuserQuestion',
+            }, wd);
+            const persisted = JSON.parse(await readFile(join(wd, '.rcs', 'state', 'run-state.json'), 'utf-8'));
+            assert.equal(synced.outcome, 'blocked_on_user');
+            assert.equal(synced.lifecycle_outcome, 'askuserQuestion');
+            assert.equal(persisted.lifecycle_outcome, 'askuserQuestion');
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=run-state.test.js.map

package/dist/runtime/__tests__/run-state.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-state.test.js","sourceRoot":"","sources":["../../../src/runtime/__tests__/run-state.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAE3E,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,4FAA4F,EAAE,GAAG,EAAE;QACpG,MAAM,KAAK,GAAG,aAAa,CACzB;YACE,IAAI,EAAE,gBAAgB;YACtB,MAAM,EAAE,KAAK;YACb,WAAW,EAAE,iBAAiB;YAC9B,iBAAiB,EAAE,iBAAiB;SACrC,EACD,IAAI,EACJ,0BAA0B,CAC3B,CAAC;QAEF,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;QAC/C,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0EAA0E,EAAE,KAAK,IAAI,EAAE;QACxF,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC;QAC3D,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAC5C;gBACE,IAAI,EAAE,gBAAgB;gBACtB,MAAM,EAAE,KAAK;gBACb,WAAW,EAAE,iBAAiB;gBAC9B,iBAAiB,EAAE,iBAAiB;aACrC,EACD,EAAE,CACH,CAAC;YAEF,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAC1B,MAAM,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC,CACpD,CAAC;YAEnB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;YAChD,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,CAAC;YAC1D,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,CAAC;QAC/D,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/runtime/bridge.d.ts

@@ -0,0 +1,214 @@
+/**
+ * TS Runtime Bridge — thin wrapper over rcs-runtime binary.
+ *
+ * All semantic state mutations route through `execCommand()`.
+ * All state queries read Rust-authored compatibility JSON files.
+ * Set RCS_RUNTIME_BRIDGE=0 to disable bridge (fallback to TS-direct).
+ */
+export interface RuntimeSnapshot {
+    schema_version: number;
+    authority: AuthoritySnapshot;
+    backlog: BacklogSnapshot;
+    replay: ReplaySnapshot;
+    readiness: ReadinessSnapshot;
+}
+export interface AuthoritySnapshot {
+    owner: string | null;
+    lease_id: string | null;
+    leased_until: string | null;
+    stale: boolean;
+    stale_reason: string | null;
+}
+export interface BacklogSnapshot {
+    pending: number;
+    notified: number;
+    delivered: number;
+    failed: number;
+}
+export interface ReplaySnapshot {
+    cursor: string | null;
+    pending_events: number;
+    last_replayed_event_id: string | null;
+    deferred_leader_notification: boolean;
+}
+export interface ReadinessSnapshot {
+    ready: boolean;
+    reasons: string[];
+}
+export type RuntimeCommand = {
+    command: 'AcquireAuthority';
+    owner: string;
+    lease_id: string;
+    leased_until: string;
+} | {
+    command: 'RenewAuthority';
+    owner: string;
+    lease_id: string;
+    leased_until: string;
+} | {
+    command: 'QueueDispatch';
+    request_id: string;
+    target: string;
+    metadata?: Record<string, unknown>;
+} | {
+    command: 'MarkNotified';
+    request_id: string;
+    channel: string;
+} | {
+    command: 'MarkDelivered';
+    request_id: string;
+} | {
+    command: 'MarkFailed';
+    request_id: string;
+    reason: string;
+} | {
+    command: 'RequestReplay';
+    cursor?: string;
+} | {
+    command: 'CaptureSnapshot';
+} | {
+    command: 'CreateMailboxMessage';
+    message_id: string;
+    from_worker: string;
+    to_worker: string;
+    body: string;
+} | {
+    command: 'MarkMailboxNotified';
+    message_id: string;
+} | {
+    command: 'MarkMailboxDelivered';
+    message_id: string;
+};
+export type RuntimeEvent = {
+    event: 'AuthorityAcquired';
+    owner: string;
+    lease_id: string;
+    leased_until: string;
+} | {
+    event: 'AuthorityRenewed';
+    owner: string;
+    lease_id: string;
+    leased_until: string;
+} | {
+    event: 'DispatchQueued';
+    request_id: string;
+    target: string;
+    metadata?: Record<string, unknown>;
+} | {
+    event: 'DispatchNotified';
+    request_id: string;
+    channel: string;
+} | {
+    event: 'DispatchDelivered';
+    request_id: string;
+} | {
+    event: 'DispatchFailed';
+    request_id: string;
+    reason: string;
+} | {
+    event: 'ReplayRequested';
+    cursor?: string;
+} | {
+    event: 'SnapshotCaptured';
+} | {
+    event: 'MailboxMessageCreated';
+    message_id: string;
+    from_worker: string;
+    to_worker: string;
+    body?: string;
+} | {
+    event: 'MailboxNotified';
+    message_id: string;
+} | {
+    event: 'MailboxDelivered';
+    message_id: string;
+};
+export interface DispatchRecord {
+    request_id: string;
+    target: string;
+    status: 'pending' | 'notified' | 'delivered' | 'failed';
+    created_at: string;
+    notified_at: string | null;
+    delivered_at: string | null;
+    failed_at: string | null;
+    reason: string | null;
+    metadata: Record<string, unknown> | null;
+}
+export interface MailboxRecord {
+    message_id: string;
+    from_worker: string;
+    to_worker: string;
+    body: string;
+    created_at: string;
+    notified_at: string | null;
+    delivered_at: string | null;
+}
+/**
+ * Raised when the rcs-runtime binary returns output that fails JSON decoding.
+ *
+ * Distinguishing parse failure from spawn failure (which `run()` already wraps
+ * in a generic `Error`) lets callers — e.g. dispatch loops in
+ * `team/state/dispatch.ts` — react with a typed `instanceof` check instead of
+ * inspecting error messages, and to mark the affected command failed without
+ * tearing down the surrounding watcher loop.
+ */
+export declare class RuntimeBridgeError extends Error {
+    readonly context: {
+        command?: string;
+        stdoutPreview?: string;
+        cause?: unknown;
+    };
+    constructor(message: string, context?: {
+        command?: string;
+        stdoutPreview?: string;
+        cause?: unknown;
+    });
+}
+export interface RuntimeBinaryDiscoveryOptions {
+    debugPath?: string;
+    releasePath?: string;
+    fallbackBinary?: string;
+    exists?: (path: string) => boolean;
+}
+export declare function resolveRuntimeBinaryPath(options?: RuntimeBinaryDiscoveryOptions): string;
+export declare function resolveBridgeStateDir(cwd: string, env?: NodeJS.ProcessEnv): string;
+export declare class RuntimeBridge {
+    private binaryPath;
+    private stateDir;
+    private enabled;
+    constructor(options?: {
+        stateDir?: string;
+        binaryPath?: string;
+    });
+    /** Whether the bridge is enabled (RCS_RUNTIME_BRIDGE != '0'). */
+    isEnabled(): boolean;
+    /** Execute a RuntimeCommand and return the resulting RuntimeEvent. */
+    execCommand(cmd: RuntimeCommand, options?: {
+        compact?: boolean;
+    }): RuntimeEvent;
+    /** Read the current RuntimeSnapshot. */
+    readSnapshot(): RuntimeSnapshot;
+    /** Initialize a fresh state directory. */
+    initStateDir(dir: string): void;
+    /** Read a Rust-authored compatibility file as typed JSON. */
+    readCompatFile<T>(filename: string): T | null;
+    /** Read authority snapshot from compatibility file. */
+    readAuthority(): AuthoritySnapshot | null;
+    /** Read readiness snapshot from compatibility file. */
+    readReadiness(): ReadinessSnapshot | null;
+    /** Read backlog snapshot from compatibility file. */
+    readBacklog(): BacklogSnapshot | null;
+    /**
+     * Read dispatch records from compatibility file.
+     * Transforms Rust format ({ records: [...] }) to flat array,
+     * and maps `target` → `to_worker` + merges metadata fields.
+     */
+    readDispatchRecords(): DispatchRecord[];
+    /** Read mailbox records from compatibility file. */
+    readMailboxRecords(): MailboxRecord[];
+    private validateSchemaOnce;
+    private run;
+}
+export declare function getDefaultBridge(stateDir?: string): RuntimeBridge;
+export declare function isBridgeEnabled(): boolean;
+//# sourceMappingURL=bridge.d.ts.map

package/dist/runtime/bridge.d.ts.map

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

package/dist/runtime/bridge.js

@@ -0,0 +1,223 @@
+/**
+ * TS Runtime Bridge — thin wrapper over rcs-runtime binary.
+ *
+ * All semantic state mutations route through `execCommand()`.
+ * All state queries read Rust-authored compatibility JSON files.
+ * Set RCS_RUNTIME_BRIDGE=0 to disable bridge (fallback to TS-direct).
+ */
+import { execFileSync } from 'node:child_process';
+import { readFileSync, existsSync } from 'node:fs';
+import { join, resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { resolveCanonicalTeamStateRoot } from '../team/state-root.js';
+import { safeJsonParse } from '../utils/safe-json.js';
+const __bridge_dirname = dirname(fileURLToPath(import.meta.url));
+// ---------------------------------------------------------------------------
+// Bridge class
+// ---------------------------------------------------------------------------
+/**
+ * Raised when the rcs-runtime binary returns output that fails JSON decoding.
+ *
+ * Distinguishing parse failure from spawn failure (which `run()` already wraps
+ * in a generic `Error`) lets callers — e.g. dispatch loops in
+ * `team/state/dispatch.ts` — react with a typed `instanceof` check instead of
+ * inspecting error messages, and to mark the affected command failed without
+ * tearing down the surrounding watcher loop.
+ */
+export class RuntimeBridgeError extends Error {
+    context;
+    constructor(message, context = {}) {
+        super(message);
+        this.name = 'RuntimeBridgeError';
+        this.context = context;
+    }
+}
+let schemaValidated = false;
+export function resolveRuntimeBinaryPath(options = {}) {
+    const exists = options.exists ?? existsSync;
+    const envOverride = process.env.RCS_RUNTIME_BINARY?.trim();
+    if (envOverride)
+        return envOverride;
+    const workspaceDebug = options.debugPath ?? resolve(__bridge_dirname, '../../target/debug/rcs-runtime');
+    if (exists(workspaceDebug))
+        return workspaceDebug;
+    const workspaceRelease = options.releasePath ?? resolve(__bridge_dirname, '../../target/release/rcs-runtime');
+    if (exists(workspaceRelease))
+        return workspaceRelease;
+    return options.fallbackBinary ?? 'rcs-runtime';
+}
+export function resolveBridgeStateDir(cwd, env = process.env) {
+    return resolveCanonicalTeamStateRoot(cwd, env);
+}
+export class RuntimeBridge {
+    binaryPath;
+    stateDir;
+    enabled;
+    constructor(options = {}) {
+        this.enabled = String(process.env.RCS_RUNTIME_BRIDGE ?? '').trim() !== '0';
+        this.stateDir = options.stateDir;
+        this.binaryPath = options.binaryPath ?? resolveRuntimeBinaryPath();
+    }
+    /** Whether the bridge is enabled (RCS_RUNTIME_BRIDGE != '0'). */
+    isEnabled() {
+        return this.enabled;
+    }
+    /** Execute a RuntimeCommand and return the resulting RuntimeEvent. */
+    execCommand(cmd, options) {
+        this.validateSchemaOnce();
+        const json = JSON.stringify(cmd);
+        const args = ['exec', json];
+        if (this.stateDir)
+            args.push(`--state-dir=${this.stateDir}`);
+        if (options?.compact)
+            args.push('--compact');
+        const stdout = this.run(args);
+        // Non-JSON stdout means the runtime contract was violated (truncated pipe,
+        // schema drift, panic before flush). Surface a typed error so dispatch
+        // callers can mark the command failed instead of bubbling SyntaxError up
+        // through unrelated layers.
+        try {
+            return JSON.parse(stdout);
+        }
+        catch (cause) {
+            throw new RuntimeBridgeError(`rcs-runtime exec returned non-JSON output for ${cmd.command}`, { command: cmd.command, stdoutPreview: stdout.slice(0, 200), cause });
+        }
+    }
+    /** Read the current RuntimeSnapshot. */
+    readSnapshot() {
+        const args = ['snapshot', '--json'];
+        if (this.stateDir)
+            args.push(`--state-dir=${this.stateDir}`);
+        const stdout = this.run(args);
+        // Same parse hazard as execCommand: a partial snapshot pipe surfaces
+        // here as a SyntaxError that the caller almost never expects.
+        try {
+            return JSON.parse(stdout);
+        }
+        catch (cause) {
+            throw new RuntimeBridgeError('rcs-runtime snapshot returned non-JSON output', {
+                command: 'snapshot',
+                stdoutPreview: stdout.slice(0, 200),
+                cause,
+            });
+        }
+    }
+    /** Initialize a fresh state directory. */
+    initStateDir(dir) {
+        this.run(['init', dir]);
+        this.stateDir = dir;
+    }
+    /** Read a Rust-authored compatibility file as typed JSON. */
+    readCompatFile(filename) {
+        if (!this.stateDir)
+            return null;
+        const filePath = join(this.stateDir, filename);
+        if (!existsSync(filePath))
+            return null;
+        // Compat files cross a Rust→JS boundary and can be observed mid-rename
+        // (`writeAtomic` swaps a tmp file into place) or empty (truncate-then-write).
+        // The only sane recovery is to return null so HUD/dispatch fall through to
+        // their JS-inferred state for this tick — throwing here would abort the
+        // entire query path. `readFileSync` itself can also raise EACCES/EISDIR
+        // on edge cases; treat those identically.
+        let content;
+        try {
+            content = readFileSync(filePath, 'utf-8');
+        }
+        catch {
+            return null;
+        }
+        return safeJsonParse(content, null);
+    }
+    /** Read authority snapshot from compatibility file. */
+    readAuthority() {
+        return this.readCompatFile('authority.json');
+    }
+    /** Read readiness snapshot from compatibility file. */
+    readReadiness() {
+        return this.readCompatFile('readiness.json');
+    }
+    /** Read backlog snapshot from compatibility file. */
+    readBacklog() {
+        return this.readCompatFile('backlog.json');
+    }
+    /**
+     * Read dispatch records from compatibility file.
+     * Transforms Rust format ({ records: [...] }) to flat array,
+     * and maps `target` → `to_worker` + merges metadata fields.
+     */
+    readDispatchRecords() {
+        const raw = this.readCompatFile('dispatch.json');
+        if (!raw?.records)
+            return [];
+        return raw.records;
+    }
+    /** Read mailbox records from compatibility file. */
+    readMailboxRecords() {
+        const raw = this.readCompatFile('mailbox.json');
+        if (!raw?.records)
+            return [];
+        return raw.records;
+    }
+    // -------------------------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------------------------
+    validateSchemaOnce() {
+        if (schemaValidated)
+            return;
+        try {
+            const stdout = this.run(['schema', '--json']);
+            const schema = JSON.parse(stdout);
+            const expectedCommands = [
+                'acquire-authority', 'renew-authority', 'queue-dispatch',
+                'mark-notified', 'mark-delivered', 'mark-failed',
+                'request-replay', 'capture-snapshot',
+            ];
+            const missing = expectedCommands.filter((c) => !schema.commands?.includes(c));
+            if (missing.length > 0) {
+                throw new Error(`rcs-runtime schema missing commands: ${missing.join(', ')}. ` +
+                    `Bridge types may be out of sync with the Rust binary.`);
+            }
+            schemaValidated = true;
+        }
+        catch (err) {
+            if (err instanceof Error && err.message.includes('schema missing'))
+                throw err;
+            // Binary not available — schema validation skipped
+            schemaValidated = true;
+        }
+    }
+    run(args) {
+        try {
+            const result = execFileSync(this.binaryPath, args, {
+                encoding: 'utf-8',
+                timeout: 10_000,
+                maxBuffer: 1024 * 1024,
+                windowsHide: true,
+            });
+            return result;
+        }
+        catch (err) {
+            const execErr = err;
+            const stderr = execErr.stderr?.trim() ?? execErr.message ?? 'unknown error';
+            throw new Error(`rcs-runtime ${args[0]} failed: ${stderr}`);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Module-level singleton for convenience
+// ---------------------------------------------------------------------------
+let _defaultBridge;
+export function getDefaultBridge(stateDir) {
+    if (stateDir) {
+        return new RuntimeBridge({ stateDir });
+    }
+    if (!_defaultBridge) {
+        _defaultBridge = new RuntimeBridge({ stateDir });
+    }
+    return _defaultBridge;
+}
+export function isBridgeEnabled() {
+    return String(process.env.RCS_RUNTIME_BRIDGE ?? '').trim() !== '0';
+}
+//# sourceMappingURL=bridge.js.map

package/dist/runtime/bridge.js.map

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

package/dist/runtime/run-loop.d.ts

@@ -0,0 +1,45 @@
+import { type RunOutcome, type TerminalLifecycleOutcome, type TerminalRunOutcome } from './run-outcome.js';
+export interface RunLoopIteration<TState> {
+    outcome: unknown;
+    state: TState;
+}
+export interface NormalizedRunLoopIteration<TState> {
+    iteration: number;
+    outcome: RunOutcome;
+    terminal: boolean;
+    state: TState;
+}
+export interface RunLoopTerminalResult<TState> {
+    iteration: number;
+    outcome: TerminalRunOutcome;
+    state: TState;
+    history: RunOutcome[];
+}
+export interface RunUntilTerminalOptions<TState> {
+    maxIterations?: number;
+    onIteration?: (result: NormalizedRunLoopIteration<TState>) => Promise<void> | void;
+}
+export interface RunContinuationStateLike {
+    current_phase?: unknown;
+    run_outcome?: unknown;
+    lifecycle_outcome?: unknown;
+    terminal_outcome?: unknown;
+    question_enforcement?: unknown;
+    active?: unknown;
+    completed_at?: unknown;
+    [key: string]: unknown;
+}
+export interface RunContinuationSnapshot {
+    outcome: RunOutcome;
+    lifecycleOutcome?: TerminalLifecycleOutcome;
+    terminal: boolean;
+    phase: string;
+}
+export declare function runUntilTerminal<TState>(step: (iteration: number) => Promise<RunLoopIteration<TState>>, options?: RunUntilTerminalOptions<TState>): Promise<RunLoopTerminalResult<TState>>;
+export declare function getRunContinuationSnapshot(candidate: RunContinuationStateLike | null | undefined, options?: {
+    phaseFallback?: string;
+}): RunContinuationSnapshot | null;
+export declare function shouldContinueRun(candidate: RunContinuationStateLike | null | undefined, options?: {
+    phaseFallback?: string;
+}): boolean;
+//# sourceMappingURL=run-loop.d.ts.map

package/dist/runtime/run-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-loop.d.ts","sourceRoot":"","sources":["../../src/runtime/run-loop.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,UAAU,EACf,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACxB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,gBAAgB,CAAC,MAAM;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,0BAA0B,CAAC,MAAM;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,UAAU,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB,CAAC,MAAM;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB,CAAC,MAAM;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,0BAA0B,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACpF;AAED,MAAM,WAAW,wBAAwB;IACvC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,UAAU,CAAC;IACpB,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;IAC5C,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAMD,wBAAsB,gBAAgB,CAAC,MAAM,EAC3C,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,EAC9D,OAAO,GAAE,uBAAuB,CAAC,MAAM,CAAM,GAC5C,OAAO,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CA8BxC;AAED,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,wBAAwB,GAAG,IAAI,GAAG,SAAS,EACtD,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GACvC,uBAAuB,GAAG,IAAI,CAchC;AAED,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,wBAAwB,GAAG,IAAI,GAAG,SAAS,EACtD,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GACvC,OAAO,CAGT"}

package/dist/runtime/run-loop.js

@@ -0,0 +1,51 @@
+import { classifyRunOutcome, inferRunOutcome, inferTerminalLifecycleOutcome, isTerminalRunOutcome, } from './run-outcome.js';
+function safeString(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+export async function runUntilTerminal(step, options = {}) {
+    const history = [];
+    const maxIterations = options.maxIterations ?? Number.POSITIVE_INFINITY;
+    for (let iteration = 1; iteration <= maxIterations; iteration += 1) {
+        const raw = await step(iteration);
+        const outcome = classifyRunOutcome(raw.outcome);
+        const terminal = isTerminalRunOutcome(outcome);
+        history.push(outcome);
+        const normalized = {
+            iteration,
+            outcome,
+            terminal,
+            state: raw.state,
+        };
+        await options.onIteration?.(normalized);
+        if (terminal) {
+            return {
+                iteration,
+                outcome,
+                state: raw.state,
+                history,
+            };
+        }
+    }
+    throw new Error(`run loop exceeded maxIterations=${maxIterations} without reaching a terminal outcome`);
+}
+export function getRunContinuationSnapshot(candidate, options = {}) {
+    if (!candidate || typeof candidate !== 'object')
+        return null;
+    const record = candidate;
+    const outcome = inferRunOutcome(record);
+    const lifecycleOutcome = inferTerminalLifecycleOutcome(record, {
+        includeQuestionEnforcement: true,
+    });
+    const phase = safeString(candidate.current_phase) || options.phaseFallback || 'active';
+    return {
+        outcome,
+        lifecycleOutcome,
+        terminal: lifecycleOutcome !== undefined || isTerminalRunOutcome(outcome),
+        phase,
+    };
+}
+export function shouldContinueRun(candidate, options = {}) {
+    const snapshot = getRunContinuationSnapshot(candidate, options);
+    return snapshot !== null && !snapshot.terminal;
+}
+//# sourceMappingURL=run-loop.js.map

package/dist/runtime/run-loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-loop.js","sourceRoot":"","sources":["../../src/runtime/run-loop.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,6BAA6B,EAC7B,oBAAoB,GAIrB,MAAM,kBAAkB,CAAC;AA4C1B,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACvD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAA8D,EAC9D,UAA2C,EAAE;IAE7C,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,MAAM,CAAC,iBAAiB,CAAC;IAExE,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,IAAI,aAAa,EAAE,SAAS,IAAI,CAAC,EAAE,CAAC;QACnE,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC;QAClC,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEtB,MAAM,UAAU,GAAuC;YACrD,SAAS;YACT,OAAO;YACP,QAAQ;YACR,KAAK,EAAE,GAAG,CAAC,KAAK;SACjB,CAAC;QAEF,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,CAAC;QAExC,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO;gBACL,SAAS;gBACT,OAAO;gBACP,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,OAAO;aACR,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,mCAAmC,aAAa,sCAAsC,CAAC,CAAC;AAC1G,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,SAAsD,EACtD,UAAsC,EAAE;IAExC,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC7D,MAAM,MAAM,GAAG,SAAoC,CAAC;IACpD,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,gBAAgB,GAAG,6BAA6B,CAAC,MAAM,EAAE;QAC7D,0BAA0B,EAAE,IAAI;KACjC,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,UAAU,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,aAAa,IAAI,QAAQ,CAAC;IACvF,OAAO;QACL,OAAO;QACP,gBAAgB;QAChB,QAAQ,EAAE,gBAAgB,KAAK,SAAS,IAAI,oBAAoB,CAAC,OAAO,CAAC;QACzE,KAAK;KACN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,SAAsD,EACtD,UAAsC,EAAE;IAExC,MAAM,QAAQ,GAAG,0BAA0B,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAChE,OAAO,QAAQ,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;AACjD,CAAC"}