@orion-agents/orion-code 0.1.8 → 0.2.0

package/dist/runtime/thread-runtime.d.ts

@@ -0,0 +1,165 @@
+import { RuntimeEventBufferV1, type RuntimeEventBufferOptionsV1 } from './runtime-event-buffer';
+import { type ThreadAdmissionOptionsV1, type ThreadCommandAdmissionV1, type ThreadTurnRequestV1 } from './thread-admission';
+import { ThreadEventStore } from './thread-event-store';
+import { type AgentRuntimeCommandV1 } from './protocol/runtime-protocol-v1';
+import type { CompactPrepareSourceReceiptV1 } from './compact-transaction';
+export interface ThreadCompactCandidateDraftV1 {
+    readonly checkpoint: unknown;
+    readonly modelVisibleHistory: readonly unknown[];
+}
+export interface ThreadCompactMaintenanceRequestV1 {
+    readonly type: 'compact';
+    readonly source: 'automatic' | 'explicit';
+    readonly prepare: (context: {
+        readonly source: CompactPrepareSourceReceiptV1;
+        readonly history: readonly unknown[];
+        readonly taskContext: unknown;
+    }, signal: AbortSignal) => ThreadCompactCandidateDraftV1 | Promise<ThreadCompactCandidateDraftV1>;
+}
+export interface ThreadMaintenanceTurnRunnerV1 {
+    run(request: ThreadCompactMaintenanceRequestV1, context: ThreadTurnExecutionContextV1): Promise<ThreadTurnOutcomeV1>;
+}
+/** Internal, non-model maintenance turn used for durable Goal lifecycle control. */
+export interface ThreadGoalControlRequestV1 {
+    readonly type: 'goal_control';
+    readonly input: string;
+    readonly run: (context: ThreadTurnExecutionContextV1) => Promise<ThreadTurnOutcomeV1>;
+    readonly onRejected?: (reason: 'deadline_expired' | 'shutdown') => void;
+}
+export type ThreadTurnOutcomeV1 = {
+    readonly status: 'completed';
+    readonly outcome?: string;
+    /** Internal priority work that starts only after this turn is durably terminal. */
+    readonly maintenance?: ThreadCompactMaintenanceRequestV1;
+} | {
+    readonly status: 'failed';
+    readonly error: string;
+} | {
+    readonly status: 'interrupted';
+    readonly reason?: string;
+};
+export interface ThreadItemHandleV1 {
+    readonly turnId: string;
+    readonly stepId: string;
+    readonly itemId: string;
+}
+export interface ThreadTurnExecutionContextV1 {
+    readonly threadId: string;
+    readonly turnId: string;
+    readonly input: string;
+    readonly mode: ThreadTurnRequestV1['mode'];
+    readonly kind: 'regular' | 'goal' | 'maintenance';
+    readonly abortSignal: AbortSignal;
+    startItem(input: {
+        readonly kind: 'message' | 'reasoning' | 'command' | 'file_change' | 'mcp' | 'plan' | 'compact';
+        readonly stepId?: string;
+        readonly itemId?: string;
+        readonly role?: 'user' | 'assistant' | 'system' | 'tool';
+        readonly name?: string;
+        readonly inputDigest?: string;
+    }): ThreadItemHandleV1;
+    emitDelta(handle: ThreadItemHandleV1, delta: string, channel?: 'content' | 'reasoning' | 'output'): void;
+    completeItem(handle: ThreadItemHandleV1, input?: {
+        readonly content?: string;
+        readonly summary?: string;
+        readonly outputDigest?: string;
+    }): void;
+    failItem(handle: ThreadItemHandleV1, error: string): void;
+    onSteer(handler: (input: string, itemId: string) => void | Promise<void>): void;
+}
+export interface ThreadTurnRunnerV1 {
+    run(context: ThreadTurnExecutionContextV1): Promise<ThreadTurnOutcomeV1>;
+}
+export type ThreadGoalContinuationRequestV1 = ThreadTurnRequestV1 & {
+    readonly mode: 'goal';
+    readonly kind: 'goal';
+};
+export interface ThreadDurableTerminalV1 {
+    readonly turnId: string;
+    readonly input: string;
+    readonly mode: ThreadTurnRequestV1['mode'];
+    readonly kind: 'regular' | 'goal' | 'maintenance';
+    readonly terminal: 'completed' | 'failed' | 'interrupted';
+}
+export interface ThreadRuntimeOptionsV1 {
+    readonly store: ThreadEventStore;
+    readonly runner: ThreadTurnRunnerV1;
+    readonly maintenanceRunner?: ThreadMaintenanceTurnRunnerV1;
+    readonly projectPath?: string;
+    readonly admission?: ThreadAdmissionOptionsV1;
+    readonly idFactory?: () => string;
+    readonly recoverIncomplete?: boolean;
+    readonly requireTurnCommit?: boolean;
+    /** Observes a durable turn.start boundary; it must not own runtime state. */
+    readonly onTurnStarted?: (turn: {
+        readonly turnId: string;
+        readonly input: string;
+        readonly mode: ThreadTurnRequestV1['mode'];
+        readonly kind: 'regular' | 'goal' | 'maintenance';
+        readonly startedAt: number;
+    }) => void;
+    /** May release internal Goal work only after the matching terminal event is durable. */
+    readonly onTurnDurablyTerminal?: (terminal: ThreadDurableTerminalV1) => ThreadGoalContinuationRequestV1 | undefined;
+    /** Turn-scoped resources settle before any queued turn can be promoted. */
+    readonly onTurnSettled?: (turnId: string) => void | Promise<void>;
+}
+export declare class ThreadRuntimeV1 {
+    readonly threadId: string;
+    private readonly store;
+    private readonly runner;
+    private readonly maintenanceRunner?;
+    private readonly admission;
+    private readonly idFactory;
+    private readonly requireTurnCommit;
+    private readonly onTurnStarted?;
+    private readonly onTurnDurablyTerminal?;
+    private readonly onTurnSettled?;
+    private readonly consumers;
+    private readonly compactMaintenance;
+    private readonly goalControlTurns;
+    private readonly queuedGoalControls;
+    private activeAbort;
+    private activeTurnId;
+    private activeRun;
+    private steerHandler;
+    private readonly idleWaiters;
+    private readonly unsubscribeStore;
+    private deferredGoalContinuation;
+    private closed;
+    constructor(options: ThreadRuntimeOptionsV1);
+    dispatch(command: Extract<AgentRuntimeCommandV1, {
+        type: 'turn.start' | 'turn.steer' | 'turn.follow_up' | 'turn.interrupt';
+    }>): ThreadCommandAdmissionV1;
+    startMaintenance(input: string): ThreadCommandAdmissionV1;
+    /**
+     * Serialize a Goal control mutation through the same bounded admission and
+     * durable terminal lane as every other Thread turn. The callback owns no
+     * scheduling; it must write its TurnCommit before returning completed.
+     */
+    startGoalControl(request: ThreadGoalControlRequestV1): ThreadCommandAdmissionV1;
+    /** Start an explicit Compact maintenance transaction only from an idle boundary. */
+    startCompactMaintenance(request: ThreadCompactMaintenanceRequestV1, input?: string): ThreadCommandAdmissionV1;
+    subscribe(consumerId: string, cursor?: number, options?: Omit<RuntimeEventBufferOptionsV1, 'initialCursor'>): RuntimeEventBufferV1;
+    unsubscribe(consumerId: string): void;
+    replay(cursor?: number, limit?: number): import("./thread-event-store").ThreadEventReplayV1;
+    getProjection(): import("./thread-projection").ThreadProjectionV1;
+    getAdmissionSnapshot(): import("./thread-admission").ThreadAdmissionSnapshotV1;
+    waitForIdle(): Promise<void>;
+    waitForTurnTerminal(turnId: string): Promise<'completed' | 'failed' | 'interrupted'>;
+    close(reason?: string): void;
+    /** Runtime-owned entry for a recovered Goal; public input still uses dispatch(). */
+    startGoalContinuation(request: ThreadGoalContinuationRequestV1): ThreadCommandAdmissionV1;
+    private persistTurnStart;
+    private scheduleTurn;
+    private createExecutionContext;
+    private finalizeTurn;
+    private promoteQueuedTurn;
+    private persistQueuedTurn;
+    private requiredActiveTurn;
+    private promoteQueuedGoalControl;
+    private rejectQueuedGoalControl;
+    private commitAndPublish;
+    private publish;
+    private resolveIdleIfNeeded;
+}
+//# sourceMappingURL=thread-runtime.d.ts.map

package/dist/runtime/thread-runtime.d.ts.map

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