@jstn-sdk/rcs 0.1.0

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

@@ -0,0 +1,46 @@
+export declare const TERMINAL_RUN_OUTCOMES: readonly ["finish", "blocked_on_user", "failed", "cancelled"];
+export declare const NON_TERMINAL_RUN_OUTCOMES: readonly ["progress", "continue"];
+export declare const RUN_OUTCOMES: readonly ["progress", "continue", "finish", "blocked_on_user", "failed", "cancelled"];
+export declare const TERMINAL_LIFECYCLE_OUTCOMES: readonly ["finished", "blocked", "failed", "userinterlude", "askuserQuestion"];
+export type TerminalRunOutcome = (typeof TERMINAL_RUN_OUTCOMES)[number];
+export type NonTerminalRunOutcome = (typeof NON_TERMINAL_RUN_OUTCOMES)[number];
+export type RunOutcome = (typeof RUN_OUTCOMES)[number];
+export type TerminalLifecycleOutcome = (typeof TERMINAL_LIFECYCLE_OUTCOMES)[number];
+export interface RunOutcomeNormalizationResult {
+    outcome?: RunOutcome;
+    warning?: string;
+    error?: string;
+}
+export interface TerminalLifecycleOutcomeNormalizationOptions {
+    blockedOnUserStrategy?: 'blocked' | 'askuserQuestion' | 'userinterlude';
+}
+export interface TerminalLifecycleOutcomeNormalizationResult {
+    outcome?: TerminalLifecycleOutcome;
+    warning?: string;
+    error?: string;
+}
+export interface RunOutcomeValidationResult {
+    ok: boolean;
+    state?: Record<string, unknown>;
+    warning?: string;
+    error?: string;
+}
+export declare function compatibilityRunOutcomeFromTerminalLifecycleOutcome(outcome: TerminalLifecycleOutcome): TerminalRunOutcome;
+export declare function terminalLifecycleOutcomeFromRunOutcome(outcome: TerminalRunOutcome, options?: TerminalLifecycleOutcomeNormalizationOptions): TerminalLifecycleOutcome;
+export declare function normalizeRunOutcome(value: unknown): RunOutcomeNormalizationResult;
+export declare function normalizeTerminalLifecycleOutcome(value: unknown, options?: TerminalLifecycleOutcomeNormalizationOptions): TerminalLifecycleOutcomeNormalizationResult;
+export declare function classifyRunOutcome(value: unknown): RunOutcome;
+export declare function isTerminalRunOutcome(value: unknown): value is TerminalRunOutcome;
+export declare function isTerminalLifecycleOutcome(value: unknown, options?: TerminalLifecycleOutcomeNormalizationOptions): value is TerminalLifecycleOutcome;
+export declare function isNonTerminalRunOutcome(value: unknown): value is NonTerminalRunOutcome;
+export declare function isNonTerminalRunState(value: unknown): boolean;
+export declare function isTerminalRunState(value: unknown): boolean;
+export declare function inferTerminalLifecycleOutcome(candidate: Record<string, unknown>, options?: {
+    includeQuestionEnforcement?: boolean;
+    blockedOnUserStrategy?: 'blocked' | 'askuserQuestion' | 'userinterlude';
+}): TerminalLifecycleOutcome | undefined;
+export declare function inferRunOutcome(candidate: Record<string, unknown>): RunOutcome;
+export declare function applyRunOutcomeContract(candidate: Record<string, unknown>, options?: {
+    nowIso?: string;
+}): RunOutcomeValidationResult;
+//# sourceMappingURL=run-outcome.d.ts.map

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

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

package/dist/runtime/run-outcome.js

@@ -0,0 +1,285 @@
+export const TERMINAL_RUN_OUTCOMES = [
+    'finish',
+    'blocked_on_user',
+    'failed',
+    'cancelled',
+];
+export const NON_TERMINAL_RUN_OUTCOMES = [
+    'progress',
+    'continue',
+];
+export const RUN_OUTCOMES = [
+    ...NON_TERMINAL_RUN_OUTCOMES,
+    ...TERMINAL_RUN_OUTCOMES,
+];
+export const TERMINAL_LIFECYCLE_OUTCOMES = [
+    'finished',
+    'blocked',
+    'failed',
+    'userinterlude',
+    'askuserQuestion',
+];
+const TERMINAL_RUN_OUTCOME_SET = new Set(TERMINAL_RUN_OUTCOMES);
+const NON_TERMINAL_RUN_OUTCOME_SET = new Set(NON_TERMINAL_RUN_OUTCOMES);
+const RUN_OUTCOME_SET = new Set(RUN_OUTCOMES);
+const TERMINAL_LIFECYCLE_OUTCOME_SET = new Set(TERMINAL_LIFECYCLE_OUTCOMES);
+const RUN_OUTCOME_ALIASES = {
+    finish: 'finish',
+    finished: 'finish',
+    complete: 'finish',
+    completed: 'finish',
+    done: 'finish',
+    blocked: 'blocked_on_user',
+    'blocked-on-user': 'blocked_on_user',
+    blocked_on_user: 'blocked_on_user',
+    failed: 'failed',
+    fail: 'failed',
+    error: 'failed',
+    cancelled: 'cancelled',
+    canceled: 'cancelled',
+    cancel: 'cancelled',
+    aborted: 'cancelled',
+    abort: 'cancelled',
+    progress: 'progress',
+    continue: 'continue',
+    continued: 'continue',
+};
+const TERMINAL_LIFECYCLE_OUTCOME_ALIASES = {
+    finished: 'finished',
+    finish: 'finished',
+    complete: 'finished',
+    completed: 'finished',
+    done: 'finished',
+    blocked: 'blocked',
+    failed: 'failed',
+    fail: 'failed',
+    error: 'failed',
+    userinterlude: 'userinterlude',
+    'user-interlude': 'userinterlude',
+    interrupted: 'userinterlude',
+    interrupt: 'userinterlude',
+    cancelled: 'userinterlude',
+    canceled: 'userinterlude',
+    cancel: 'userinterlude',
+    aborted: 'userinterlude',
+    abort: 'userinterlude',
+    askuserquestion: 'askuserQuestion',
+    'ask-user-question': 'askuserQuestion',
+    askuser: 'askuserQuestion',
+    question: 'askuserQuestion',
+};
+const TERMINAL_PHASE_TO_RUN_OUTCOME = {
+    complete: 'finish',
+    completed: 'finish',
+    blocked: 'blocked_on_user',
+    blocked_on_user: 'blocked_on_user',
+    'blocked-on-user': 'blocked_on_user',
+    failed: 'failed',
+    cancelled: 'cancelled',
+    cancel: 'cancelled',
+};
+const RUN_OUTCOME_FROM_LIFECYCLE = {
+    finished: 'finish',
+    blocked: 'blocked_on_user',
+    failed: 'failed',
+    userinterlude: 'cancelled',
+    askuserQuestion: 'blocked_on_user',
+};
+function normalizeRunOutcomeValue(value) {
+    return typeof value === 'string' ? value.trim().toLowerCase() : '';
+}
+function safeString(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+function resolveBlockedOnUserLifecycleOutcome(options = {}) {
+    return options.blockedOnUserStrategy ?? 'blocked';
+}
+function hasPendingQuestionEnforcement(candidate) {
+    const enforcement = candidate.question_enforcement;
+    if (!enforcement || typeof enforcement !== 'object')
+        return false;
+    const record = enforcement;
+    const obligationId = safeString(record.obligation_id);
+    const status = safeString(record.status).toLowerCase();
+    return obligationId !== '' && status === 'pending';
+}
+export function compatibilityRunOutcomeFromTerminalLifecycleOutcome(outcome) {
+    return RUN_OUTCOME_FROM_LIFECYCLE[outcome];
+}
+export function terminalLifecycleOutcomeFromRunOutcome(outcome, options = {}) {
+    switch (outcome) {
+        case 'finish':
+            return 'finished';
+        case 'blocked_on_user':
+            return resolveBlockedOnUserLifecycleOutcome(options);
+        case 'failed':
+            return 'failed';
+        case 'cancelled':
+            return 'userinterlude';
+    }
+}
+export function normalizeRunOutcome(value) {
+    const normalized = normalizeRunOutcomeValue(value);
+    if (!normalized)
+        return {};
+    if (RUN_OUTCOME_SET.has(normalized)) {
+        return { outcome: normalized };
+    }
+    const alias = RUN_OUTCOME_ALIASES[normalized];
+    if (alias) {
+        return {
+            outcome: alias,
+            warning: `normalized legacy run outcome "${value}" -> "${alias}"`,
+        };
+    }
+    return { error: `run_outcome must be one of: ${RUN_OUTCOMES.join(', ')}` };
+}
+export function normalizeTerminalLifecycleOutcome(value, options = {}) {
+    const normalized = normalizeRunOutcomeValue(value);
+    if (!normalized)
+        return {};
+    if (TERMINAL_LIFECYCLE_OUTCOME_SET.has(normalized)) {
+        return { outcome: normalized };
+    }
+    if (normalized === 'blocked_on_user' || normalized === 'blocked-on-user') {
+        const outcome = resolveBlockedOnUserLifecycleOutcome(options);
+        return {
+            outcome,
+            warning: `normalized legacy terminal lifecycle outcome "${value}" -> "${outcome}"`,
+        };
+    }
+    const alias = TERMINAL_LIFECYCLE_OUTCOME_ALIASES[normalized];
+    if (alias) {
+        return {
+            outcome: alias,
+            warning: `normalized legacy terminal lifecycle outcome "${value}" -> "${alias}"`,
+        };
+    }
+    return {
+        error: `lifecycle_outcome must be one of: ${TERMINAL_LIFECYCLE_OUTCOMES.join(', ')}`,
+    };
+}
+export function classifyRunOutcome(value) {
+    return normalizeRunOutcome(value).outcome ?? 'progress';
+}
+export function isTerminalRunOutcome(value) {
+    const normalized = normalizeRunOutcome(value).outcome;
+    return normalized !== undefined && TERMINAL_RUN_OUTCOME_SET.has(normalized);
+}
+export function isTerminalLifecycleOutcome(value, options = {}) {
+    const normalized = normalizeTerminalLifecycleOutcome(value, options).outcome;
+    return normalized !== undefined && TERMINAL_LIFECYCLE_OUTCOME_SET.has(normalized);
+}
+export function isNonTerminalRunOutcome(value) {
+    const normalized = normalizeRunOutcome(value).outcome;
+    return normalized !== undefined && NON_TERMINAL_RUN_OUTCOME_SET.has(normalized);
+}
+export function isNonTerminalRunState(value) {
+    return isNonTerminalRunOutcome(classifyRunOutcome(value));
+}
+export function isTerminalRunState(value) {
+    return isTerminalRunOutcome(classifyRunOutcome(value));
+}
+export function inferTerminalLifecycleOutcome(candidate, options = {}) {
+    const blockedOnUserStrategy = options.blockedOnUserStrategy
+        ?? (options.includeQuestionEnforcement && hasPendingQuestionEnforcement(candidate)
+            ? 'askuserQuestion'
+            : 'blocked');
+    const explicit = normalizeTerminalLifecycleOutcome(candidate.lifecycle_outcome ?? candidate.terminal_outcome, { blockedOnUserStrategy });
+    if (explicit.outcome)
+        return explicit.outcome;
+    const runOutcome = normalizeRunOutcome(candidate.run_outcome).outcome;
+    if (runOutcome && isTerminalRunOutcome(runOutcome)) {
+        return terminalLifecycleOutcomeFromRunOutcome(runOutcome, { blockedOnUserStrategy });
+    }
+    const phase = safeString(candidate.current_phase).toLowerCase();
+    if (phase) {
+        const normalizedPhase = normalizeTerminalLifecycleOutcome(phase, { blockedOnUserStrategy });
+        if (normalizedPhase.outcome)
+            return normalizedPhase.outcome;
+    }
+    if (options.includeQuestionEnforcement && hasPendingQuestionEnforcement(candidate)) {
+        return 'askuserQuestion';
+    }
+    if (candidate.active === true)
+        return undefined;
+    if (safeString(candidate.completed_at))
+        return 'finished';
+    if (candidate.active === false)
+        return 'finished';
+    return undefined;
+}
+export function inferRunOutcome(candidate) {
+    const explicit = normalizeRunOutcome(candidate.run_outcome);
+    if (explicit.outcome)
+        return explicit.outcome;
+    const lifecycleOutcome = inferTerminalLifecycleOutcome(candidate, {
+        includeQuestionEnforcement: false,
+    });
+    if (lifecycleOutcome) {
+        return compatibilityRunOutcomeFromTerminalLifecycleOutcome(lifecycleOutcome);
+    }
+    const phase = safeString(candidate.current_phase).toLowerCase();
+    if (phase && TERMINAL_PHASE_TO_RUN_OUTCOME[phase]) {
+        return TERMINAL_PHASE_TO_RUN_OUTCOME[phase];
+    }
+    if (candidate.active === true)
+        return 'continue';
+    if (safeString(candidate.completed_at))
+        return 'finish';
+    if (candidate.active === false)
+        return 'finish';
+    return 'continue';
+}
+export function applyRunOutcomeContract(candidate, options) {
+    const nowIso = options?.nowIso ?? new Date().toISOString();
+    const next = { ...candidate };
+    const normalizedLifecycle = normalizeTerminalLifecycleOutcome(next.lifecycle_outcome ?? next.terminal_outcome);
+    if (normalizedLifecycle.error)
+        return { ok: false, error: normalizedLifecycle.error };
+    const normalizedRunOutcome = normalizeRunOutcome(next.run_outcome);
+    if (normalizedRunOutcome.error)
+        return { ok: false, error: normalizedRunOutcome.error };
+    const lifecycleOutcome = normalizedLifecycle.outcome ?? inferTerminalLifecycleOutcome(next, {
+        includeQuestionEnforcement: false,
+    });
+    const outcome = normalizedLifecycle.outcome
+        ? compatibilityRunOutcomeFromTerminalLifecycleOutcome(normalizedLifecycle.outcome)
+        : normalizedRunOutcome.outcome ?? inferRunOutcome(next);
+    delete next.terminal_outcome;
+    next.run_outcome = outcome;
+    if (lifecycleOutcome) {
+        next.lifecycle_outcome = lifecycleOutcome;
+    }
+    else {
+        delete next.lifecycle_outcome;
+    }
+    const terminal = lifecycleOutcome !== undefined || isTerminalRunOutcome(outcome);
+    if (terminal) {
+        if (next.active === true) {
+            return {
+                ok: false,
+                error: `terminal run outcome "${lifecycleOutcome ?? outcome}" requires active=false`,
+            };
+        }
+        next.active = false;
+        if (!safeString(next.completed_at)) {
+            next.completed_at = nowIso;
+        }
+    }
+    else {
+        if (next.active === false) {
+            return { ok: false, error: `non-terminal run outcome "${outcome}" requires active=true` };
+        }
+        next.active = true;
+        if (safeString(next.completed_at)) {
+            delete next.completed_at;
+        }
+    }
+    return {
+        ok: true,
+        state: next,
+        warning: normalizedLifecycle.warning ?? normalizedRunOutcome.warning,
+    };
+}
+//# sourceMappingURL=run-outcome.js.map

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

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

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

@@ -0,0 +1,40 @@
+import { type RunOutcome, type TerminalLifecycleOutcome } from './run-outcome.js';
+export interface RunStateLike {
+    active?: unknown;
+    mode?: unknown;
+    current_phase?: unknown;
+    task_description?: unknown;
+    started_at?: unknown;
+    completed_at?: unknown;
+    iteration?: unknown;
+    max_iterations?: unknown;
+    error?: unknown;
+    outcome?: unknown;
+    run_outcome?: unknown;
+    lifecycle_outcome?: unknown;
+    terminal_outcome?: unknown;
+    question_enforcement?: unknown;
+    owner_rcs_session_id?: unknown;
+    [key: string]: unknown;
+}
+export interface RunState {
+    version: 1;
+    mode: string;
+    active: boolean;
+    outcome: RunOutcome;
+    lifecycle_outcome?: TerminalLifecycleOutcome;
+    updated_at: string;
+    current_phase?: string;
+    task_description?: string;
+    started_at?: string;
+    completed_at?: string;
+    iteration?: number;
+    max_iterations?: number;
+    error?: string;
+    owner_rcs_session_id?: string;
+}
+export declare function deriveRunOutcomeFromModeState(state: RunStateLike): RunOutcome;
+export declare function buildRunState(state: RunStateLike, existing?: Partial<RunState> | null, nowIso?: string): RunState;
+export declare function readRunState(workingDirectory?: string, explicitSessionId?: string): Promise<RunState | null>;
+export declare function syncRunStateFromModeState(state: RunStateLike, workingDirectory?: string, explicitSessionId?: string): Promise<RunState>;
+//# sourceMappingURL=run-state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run-state.d.ts","sourceRoot":"","sources":["../../src/runtime/run-state.ts"],"names":[],"mappings":"AAIA,OAAO,EAOL,KAAK,UAAU,EACf,KAAK,wBAAwB,EAC9B,MAAM,kBAAkB,CAAC;AAI1B,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,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,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,CAAC,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,UAAU,CAAC;IACpB,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAkBD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,YAAY,GAAG,UAAU,CAkB7E;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,YAAY,EACnB,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,EACnC,MAAM,GAAE,MAAiC,GACxC,QAAQ,CA8CV;AAiBD,wBAAsB,YAAY,CAChC,gBAAgB,CAAC,EAAE,MAAM,EACzB,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAU1B;AAED,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,YAAY,EACnB,gBAAgB,CAAC,EAAE,MAAM,EACzB,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,QAAQ,CAAC,CASnB"}

package/dist/runtime/run-state.js

@@ -0,0 +1,120 @@
+import { existsSync } from 'node:fs';
+import { mkdir, readFile, rename, unlink, writeFile } from 'node:fs/promises';
+import { getStateFilePath, resolveStateScope } from '../mcp/state-paths.js';
+import { classifyRunOutcome, compatibilityRunOutcomeFromTerminalLifecycleOutcome, inferTerminalLifecycleOutcome, isTerminalRunOutcome, normalizeTerminalLifecycleOutcome, normalizeRunOutcome, } from './run-outcome.js';
+const RUN_STATE_FILENAME = 'run-state.json';
+function optionalString(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed ? trimmed : undefined;
+}
+function optionalFiniteNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+function terminalOutcomeFromPhase(phase) {
+    if (!phase)
+        return null;
+    const normalized = normalizeRunOutcome(phase).outcome;
+    return normalized && isTerminalRunOutcome(normalized) ? normalized : null;
+}
+export function deriveRunOutcomeFromModeState(state) {
+    if (state.active === true)
+        return 'continue';
+    const lifecycleOutcome = inferTerminalLifecycleOutcome(state, {
+        includeQuestionEnforcement: true,
+    });
+    if (lifecycleOutcome)
+        return compatibilityRunOutcomeFromTerminalLifecycleOutcome(lifecycleOutcome);
+    const explicitOutcome = normalizeRunOutcome(state.outcome ?? state.run_outcome).outcome;
+    if (explicitOutcome)
+        return explicitOutcome;
+    const phaseOutcome = terminalOutcomeFromPhase(optionalString(state.current_phase));
+    if (phaseOutcome)
+        return phaseOutcome;
+    if (optionalString(state.error))
+        return 'failed';
+    if (optionalString(state.completed_at))
+        return 'finish';
+    return classifyRunOutcome(state.current_phase);
+}
+export function buildRunState(state, existing, nowIso = new Date().toISOString()) {
+    const lifecycleOutcome = normalizeTerminalLifecycleOutcome(state.lifecycle_outcome ?? state.terminal_outcome).outcome ?? inferTerminalLifecycleOutcome(state, {
+        includeQuestionEnforcement: true,
+    }) ?? existing?.lifecycle_outcome;
+    const outcome = deriveRunOutcomeFromModeState(state);
+    const active = state.active === true;
+    const next = {
+        version: 1,
+        mode: optionalString(state.mode) ?? optionalString(existing?.mode) ?? 'unknown',
+        active,
+        outcome,
+        updated_at: nowIso,
+    };
+    if (lifecycleOutcome)
+        next.lifecycle_outcome = lifecycleOutcome;
+    const currentPhase = optionalString(state.current_phase);
+    if (currentPhase)
+        next.current_phase = currentPhase;
+    const taskDescription = optionalString(state.task_description);
+    if (taskDescription)
+        next.task_description = taskDescription;
+    const startedAt = optionalString(state.started_at) ?? optionalString(existing?.started_at);
+    if (startedAt)
+        next.started_at = startedAt;
+    const completedAt = active
+        ? undefined
+        : optionalString(state.completed_at)
+            ?? (isTerminalRunOutcome(outcome) ? optionalString(existing?.completed_at) ?? nowIso : undefined);
+    if (completedAt)
+        next.completed_at = completedAt;
+    const iteration = optionalFiniteNumber(state.iteration);
+    if (iteration !== undefined)
+        next.iteration = iteration;
+    const maxIterations = optionalFiniteNumber(state.max_iterations);
+    if (maxIterations !== undefined)
+        next.max_iterations = maxIterations;
+    const error = optionalString(state.error);
+    if (error)
+        next.error = error;
+    const ownerSessionId = optionalString(state.owner_rcs_session_id);
+    if (ownerSessionId)
+        next.owner_rcs_session_id = ownerSessionId;
+    return next;
+}
+function getRunStatePath(workingDirectory, sessionId) {
+    return getStateFilePath(RUN_STATE_FILENAME, workingDirectory, sessionId);
+}
+async function writeAtomicFile(path, data) {
+    const tmpPath = `${path}.tmp.${process.pid}.${Date.now()}.${Math.random().toString(16).slice(2)}`;
+    await writeFile(tmpPath, data, 'utf-8');
+    try {
+        await rename(tmpPath, path);
+    }
+    catch (error) {
+        await unlink(tmpPath).catch(() => { });
+        throw error;
+    }
+}
+export async function readRunState(workingDirectory, explicitSessionId) {
+    const scope = await resolveStateScope(workingDirectory, explicitSessionId);
+    const path = getRunStatePath(workingDirectory, scope.sessionId);
+    if (!existsSync(path))
+        return null;
+    try {
+        return JSON.parse(await readFile(path, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+export async function syncRunStateFromModeState(state, workingDirectory, explicitSessionId) {
+    const scope = await resolveStateScope(workingDirectory, explicitSessionId);
+    const path = getRunStatePath(workingDirectory, scope.sessionId);
+    await mkdir(scope.stateDir, { recursive: true });
+    const existing = await readRunState(workingDirectory, scope.sessionId);
+    const next = buildRunState(state, existing);
+    await writeAtomicFile(path, JSON.stringify(next, null, 2));
+    return next;
+}
+//# sourceMappingURL=run-state.js.map

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

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

package/dist/runtime/terminal-lifecycle.d.ts

@@ -0,0 +1,11 @@
+import { TERMINAL_LIFECYCLE_OUTCOMES, compatibilityRunOutcomeFromTerminalLifecycleOutcome, type RunOutcome, type TerminalLifecycleOutcome, type TerminalLifecycleOutcomeNormalizationResult } from './run-outcome.js';
+export { TERMINAL_LIFECYCLE_OUTCOMES, compatibilityRunOutcomeFromTerminalLifecycleOutcome, };
+export type { TerminalLifecycleOutcome };
+export type TerminalLifecycleNormalizationResult = TerminalLifecycleOutcomeNormalizationResult;
+export declare function normalizeTerminalLifecycleOutcome(value: unknown): TerminalLifecycleNormalizationResult;
+export declare function inferTerminalLifecycleOutcome(candidate: {
+    lifecycle_outcome?: unknown;
+    run_outcome?: unknown;
+}): TerminalLifecycleNormalizationResult;
+export declare function preferredRunOutcomeForLifecycleOutcome(outcome: TerminalLifecycleOutcome): RunOutcome;
+//# sourceMappingURL=terminal-lifecycle.d.ts.map

package/dist/runtime/terminal-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-lifecycle.d.ts","sourceRoot":"","sources":["../../src/runtime/terminal-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,mDAAmD,EAInD,KAAK,UAAU,EACf,KAAK,wBAAwB,EAC7B,KAAK,2CAA2C,EACjD,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,2BAA2B,EAC3B,mDAAmD,GACpD,CAAC;AACF,YAAY,EAAE,wBAAwB,EAAE,CAAC;AACzC,MAAM,MAAM,oCAAoC,GAAG,2CAA2C,CAAC;AAU/F,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,OAAO,GAAG,oCAAoC,CAatG;AAED,wBAAgB,6BAA6B,CAAC,SAAS,EAAE;IACvD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GAAG,oCAAoC,CAyBvC;AAED,wBAAgB,sCAAsC,CACpD,OAAO,EAAE,wBAAwB,GAChC,UAAU,CAEZ"}

package/dist/runtime/terminal-lifecycle.js

@@ -0,0 +1,52 @@
+import { TERMINAL_LIFECYCLE_OUTCOMES, compatibilityRunOutcomeFromTerminalLifecycleOutcome, normalizeRunOutcome, normalizeTerminalLifecycleOutcome as normalizeTerminalLifecycleOutcomeContract, terminalLifecycleOutcomeFromRunOutcome, } from './run-outcome.js';
+export { TERMINAL_LIFECYCLE_OUTCOMES, compatibilityRunOutcomeFromTerminalLifecycleOutcome, };
+function rewriteWarning(warning) {
+    return warning?.replace('legacy terminal lifecycle outcome', 'legacy lifecycle outcome');
+}
+function isCanonicalTerminalLifecycleOutcome(value) {
+    return typeof value === 'string' && TERMINAL_LIFECYCLE_OUTCOMES.includes(value.trim());
+}
+export function normalizeTerminalLifecycleOutcome(value) {
+    if (isCanonicalTerminalLifecycleOutcome(value)) {
+        return { outcome: value.trim() };
+    }
+    const result = normalizeTerminalLifecycleOutcomeContract(value, {
+        blockedOnUserStrategy: 'blocked',
+    });
+    return {
+        ...(result.outcome ? { outcome: result.outcome } : {}),
+        ...(result.warning ? { warning: rewriteWarning(result.warning) } : {}),
+        ...(result.error ? { error: result.error } : {}),
+    };
+}
+export function inferTerminalLifecycleOutcome(candidate) {
+    const explicit = normalizeTerminalLifecycleOutcome(candidate.lifecycle_outcome);
+    if (explicit.outcome || explicit.error)
+        return explicit;
+    const runOutcome = normalizeRunOutcome(candidate.run_outcome);
+    if (runOutcome.error)
+        return { error: runOutcome.error };
+    switch (runOutcome.outcome) {
+        case 'finish':
+        case 'blocked_on_user':
+        case 'failed':
+            return {
+                outcome: terminalLifecycleOutcomeFromRunOutcome(runOutcome.outcome, {
+                    blockedOnUserStrategy: 'blocked',
+                }),
+            };
+        case 'cancelled':
+            return {
+                outcome: terminalLifecycleOutcomeFromRunOutcome('cancelled', {
+                    blockedOnUserStrategy: 'blocked',
+                }),
+                warning: 'normalized legacy run outcome "cancelled" -> "userinterlude"',
+            };
+        default:
+            return {};
+    }
+}
+export function preferredRunOutcomeForLifecycleOutcome(outcome) {
+    return compatibilityRunOutcomeFromTerminalLifecycleOutcome(outcome);
+}
+//# sourceMappingURL=terminal-lifecycle.js.map

package/dist/runtime/terminal-lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-lifecycle.js","sourceRoot":"","sources":["../../src/runtime/terminal-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,mDAAmD,EACnD,mBAAmB,EACnB,iCAAiC,IAAI,yCAAyC,EAC9E,sCAAsC,GAIvC,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,2BAA2B,EAC3B,mDAAmD,GACpD,CAAC;AAIF,SAAS,cAAc,CAAC,OAA2B;IACjD,OAAO,OAAO,EAAE,OAAO,CAAC,mCAAmC,EAAE,0BAA0B,CAAC,CAAC;AAC3F,CAAC;AAED,SAAS,mCAAmC,CAAC,KAAc;IACzD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,2BAAiD,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;AAChH,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,KAAc;IAC9D,IAAI,mCAAmC,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/C,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,EAA8B,EAAE,CAAC;IAC/D,CAAC;IAED,MAAM,MAAM,GAAG,yCAAyC,CAAC,KAAK,EAAE;QAC9D,qBAAqB,EAAE,SAAS;KACjC,CAAC,CAAC;IACH,OAAO;QACL,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,SAG7C;IACC,MAAM,QAAQ,GAAG,iCAAiC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAChF,IAAI,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,KAAK;QAAE,OAAO,QAAQ,CAAC;IAExD,MAAM,UAAU,GAAG,mBAAmB,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC9D,IAAI,UAAU,CAAC,KAAK;QAAE,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC;IACzD,QAAQ,UAAU,CAAC,OAAO,EAAE,CAAC;QAC3B,KAAK,QAAQ,CAAC;QACd,KAAK,iBAAiB,CAAC;QACvB,KAAK,QAAQ;YACX,OAAO;gBACL,OAAO,EAAE,sCAAsC,CAAC,UAAU,CAAC,OAAO,EAAE;oBAClE,qBAAqB,EAAE,SAAS;iBACjC,CAAC;aACH,CAAC;QACJ,KAAK,WAAW;YACd,OAAO;gBACL,OAAO,EAAE,sCAAsC,CAAC,WAAW,EAAE;oBAC3D,qBAAqB,EAAE,SAAS;iBACjC,CAAC;gBACF,OAAO,EAAE,8DAA8D;aACxE,CAAC;QACJ;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sCAAsC,CACpD,OAAiC;IAEjC,OAAO,mDAAmD,CAAC,OAAO,CAAC,CAAC;AACtE,CAAC"}

package/dist/scripts/__tests__/codex-native-hook.test.d.ts

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

package/dist/scripts/__tests__/codex-native-hook.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-native-hook.test.d.ts","sourceRoot":"","sources":["../../../src/scripts/__tests__/codex-native-hook.test.ts"],"names":[],"mappings":""}