laohuang 0.4.2 → 0.5.0

package/dist/runtime/history-committer.js

@@ -0,0 +1,77 @@
+/** Commits canonical conversation history while preserving session atomicity. */
+export class HistoryCommitter {
+    messages;
+    context;
+    cancelToken;
+    createCancelled;
+    constructor(options) {
+        this.messages = options.messages;
+        this.context = options.context;
+        this.cancelToken = options.cancelToken;
+        this.createCancelled = options.createCancelled;
+    }
+    commitInput(content) {
+        const message = { role: "user", content };
+        const commitInput = this.context?.commitInput;
+        if (typeof commitInput === "function") {
+            return this.commitContextMessage((append, rollback) => commitInput.call(this.context, append, rollback), message);
+        }
+        this.raiseIfCancelled();
+        this.messages.push(message);
+        return true;
+    }
+    commitPending(batch) {
+        const content = batch.content ?? "";
+        if (content === "") {
+            return true;
+        }
+        const message = { role: "user", content };
+        const commitPending = this.context?.commitPending;
+        if (typeof commitPending === "function") {
+            return this.commitContextMessage((append, rollback) => commitPending.call(this.context, batch, append, rollback), message);
+        }
+        this.raiseIfCancelled();
+        this.messages.push(message);
+        return true;
+    }
+    commitAssistant(message) {
+        const commitIfActive = this.context?.commitIfActive;
+        if (typeof commitIfActive === "function") {
+            return commitIfActive.call(this.context, () => {
+                this.messages.push(message);
+            });
+        }
+        this.raiseIfCancelled();
+        this.messages.push(message);
+        return true;
+    }
+    commitToolResults(toolCalls, toolResults) {
+        for (let index = 0; index < toolCalls.length; index += 1) {
+            this.messages.push({
+                role: "tool",
+                tool_call_id: toolCalls[index]?.id,
+                content: JSON.stringify(toolResults[index]),
+            });
+        }
+    }
+    snapshot() {
+        return [...this.messages];
+    }
+    commitContextMessage(commit, message) {
+        const append = () => {
+            this.messages.push(message);
+        };
+        const rollback = () => {
+            if (this.messages.at(-1) === message) {
+                this.messages.pop();
+            }
+        };
+        return Boolean(commit(append, rollback));
+    }
+    raiseIfCancelled() {
+        if (this.cancelToken !== null && this.cancelToken.isCancelled()) {
+            throw this.createCancelled(this.cancelToken.reason || "cancelled");
+        }
+    }
+}
+//# sourceMappingURL=history-committer.js.map

package/dist/runtime/history-committer.js.map

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

package/dist/runtime/human-intent-router.d.ts

@@ -0,0 +1,5 @@
+/** Convert user-facing intents into the session action protocol. */
+import type { SessionState as SessionStateValue } from "../session.ts";
+import type { UserIntent } from "./user-intent.ts";
+import type { SessionAction } from "./session-action.ts";
+export declare function routeHumanIntent(intent: UserIntent, state: SessionStateValue): SessionAction;

package/dist/runtime/human-intent-router.js

@@ -0,0 +1,38 @@
+/** Convert user-facing intents into the session action protocol. */
+import { shlexSplit } from "../commands.js";
+import { makeAnswerAction, makeApprovalAction, makeCancelAction, makeCommandAction, makeExitAction, makePromptAction, makeSteerAction, makeFollowUpAction, } from "./session-action-protocol.js";
+function commandAction(text, source) {
+    const [name, ...arguments_] = shlexSplit(text);
+    if (name === undefined) {
+        return makePromptAction(text, source);
+    }
+    if (name === "/exit" && arguments_.length === 0) {
+        return makeExitAction(source);
+    }
+    return makeCommandAction(name, arguments_, source, text);
+}
+export function routeHumanIntent(intent, state) {
+    switch (intent.type) {
+        case "prompt":
+            if (intent.text.startsWith("/")) {
+                return commandAction(intent.text, intent.source);
+            }
+            void state;
+            return makePromptAction(intent.text, intent.source);
+        case "command":
+            return makeCommandAction(intent.name, intent.arguments, intent.source);
+        case "steer":
+            return makeSteerAction(intent.text, intent.source);
+        case "follow_up":
+            return makeFollowUpAction(intent.text, intent.source);
+        case "cancel":
+            return makeCancelAction(intent.reason, intent.source);
+        case "approval":
+            return makeApprovalAction(intent.text, intent.source);
+        case "answer":
+            return makeAnswerAction(intent.text, intent.source);
+        case "exit":
+            return makeExitAction(intent.source);
+    }
+}
+//# sourceMappingURL=human-intent-router.js.map

package/dist/runtime/human-intent-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"human-intent-router.js","sourceRoot":"","sources":["../../src/runtime/human-intent-router.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAEpE,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAI5C,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AAEtC,SAAS,aAAa,CAAC,IAAY,EAAE,MAAc;IACjD,MAAM,CAAC,IAAI,EAAE,GAAG,UAAU,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,IAAI,KAAK,OAAO,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,MAAkB,EAClB,KAAwB;IAExB,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,QAAQ;YACX,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAChC,OAAO,aAAa,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YACnD,CAAC;YACD,KAAK,KAAK,CAAC;YACX,OAAO,gBAAgB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACtD,KAAK,SAAS;YACZ,OAAO,iBAAiB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACzE,KAAK,OAAO;YACV,OAAO,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACrD,KAAK,WAAW;YACd,OAAO,kBAAkB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACxD,KAAK,QAAQ;YACX,OAAO,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACxD,KAAK,UAAU;YACb,OAAO,kBAAkB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACxD,KAAK,QAAQ;YACX,OAAO,gBAAgB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACtD,KAAK,MAAM;YACT,OAAO,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,33 @@
+import type { CancelToken } from "../cancellation.ts";
+import { type ChatClientLike, type ModelAdapter } from "../model-adapter.ts";
+import { type AssembledToolCall } from "../model-stream.ts";
+import type { ModelRuntimeEventHandler } from "./runtime-events.ts";
+/** Provider-neutral input for one model completion. */
+export interface ModelRuntimeRequest {
+    client: ChatClientLike;
+    model: string;
+    messages: Array<Record<string, unknown>>;
+    tools: Array<Record<string, unknown>>;
+    toolChoice?: string | Record<string, unknown> | null;
+    requestId?: string | undefined;
+    cancelToken?: CancelToken | null;
+    isRequestActive?: ((requestId: string) => boolean) | null;
+    onDelta?: ModelRuntimeEventHandler | null;
+    onRequestOpened?: (() => boolean | void) | null;
+}
+/** Fully validated model output, independent of a provider SDK response. */
+export interface ModelRuntimeResult {
+    readonly requestId: string;
+    readonly content: string | null;
+    readonly reasoningContent: string | null;
+    readonly toolCalls: readonly AssembledToolCall[];
+    readonly finishReason: string;
+    readonly usage: unknown;
+    messageDict(): Record<string, unknown>;
+}
+/** Owns adapter invocation, cancellation preflight, and error normalization. */
+export declare class ModelRuntime {
+    private readonly adapter;
+    constructor(adapter: ModelAdapter);
+    complete(request: ModelRuntimeRequest): Promise<ModelRuntimeResult>;
+}

package/dist/runtime/model-runtime.js

@@ -0,0 +1,70 @@
+import { ModelError, modelErrorKind, } from "../model-adapter.js";
+import { ModelStreamCancelled, ModelStreamError, } from "../model-stream.js";
+/** Owns adapter invocation, cancellation preflight, and error normalization. */
+export class ModelRuntime {
+    adapter;
+    constructor(adapter) {
+        this.adapter = adapter;
+    }
+    async complete(request) {
+        if (request.cancelToken?.isCancelled()) {
+            throw new ModelStreamCancelled(request.cancelToken.reason || "cancelled");
+        }
+        try {
+            const result = await this.adapter.complete(request.client, {
+                model: request.model,
+                messages: request.messages,
+                tools: request.tools,
+                toolChoice: request.toolChoice ?? null,
+                requestId: request.requestId,
+                cancelToken: request.cancelToken ?? null,
+                isRequestActive: request.isRequestActive ?? null,
+                onDelta: request.onDelta === undefined || request.onDelta === null
+                    ? null
+                    : (kind, payload) => request.onDelta?.(kind, payload),
+                onRequestOpened: request.onRequestOpened ?? null,
+            });
+            return toModelRuntimeResult(result);
+        }
+        catch (error) {
+            throw normalizeRuntimeError(error, request.cancelToken ?? null);
+        }
+    }
+}
+function toModelRuntimeResult(result) {
+    return {
+        requestId: result.requestId,
+        content: result.content,
+        reasoningContent: result.reasoningContent,
+        toolCalls: result.toolCalls,
+        finishReason: result.finishReason,
+        usage: result.usage,
+        messageDict: () => result.messageDict(),
+    };
+}
+function normalizeRuntimeError(error, cancelToken) {
+    if (error instanceof ModelStreamCancelled) {
+        return error;
+    }
+    if (cancelToken?.isCancelled()) {
+        return new ModelStreamCancelled(cancelToken.reason || "cancelled", { cause: error });
+    }
+    if (error instanceof ModelError) {
+        return error;
+    }
+    if (error instanceof ModelStreamError) {
+        return new ModelError(error.message, {
+            kind: modelErrorKind(error),
+            hadDelta: error.hadDelta,
+            cause: error,
+        });
+    }
+    return new ModelError(errorMessage(error), {
+        kind: modelErrorKind(error),
+        cause: error,
+    });
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=model-runtime.js.map

package/dist/runtime/model-runtime.js.map

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

package/dist/runtime/queue-bridge.d.ts

@@ -0,0 +1,11 @@
+/** Input batch claimed from the session queue for a subsequent turn. */
+export interface QueueInputBatch {
+    readonly content: string;
+    readonly eventIds: readonly string[];
+}
+/** Queue operations needed by the outer agent turn loop. */
+export interface QueueBridge {
+    drainPending(taskId: string): QueueInputBatch | null;
+    acknowledgeClaimedInput(taskId: string, eventIds: readonly string[]): boolean;
+    preserveTaskInputs(taskId: string, reason: string): number;
+}

package/dist/runtime/queue-bridge.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=queue-bridge.js.map

package/dist/runtime/queue-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-bridge.js","sourceRoot":"","sources":["../../src/runtime/queue-bridge.ts"],"names":[],"mappings":""}

package/dist/runtime/queue-dispatcher.d.ts

@@ -0,0 +1,45 @@
+/** Queue placement policy for already-routed session actions. */
+import { DeadLetterQueue, HeldQueue, PendingQueue, type RoutedEvent } from "../routing.ts";
+import type { SessionAction } from "./session-action.ts";
+export declare const QueueDispatchStatus: {
+    readonly StartNow: "start_now";
+    readonly Pending: "pending";
+    readonly Held: "held";
+    readonly CancelNow: "cancel_now";
+    readonly DeadLetter: "dead_letter";
+    readonly Ignored: "ignored";
+};
+export type QueueDispatchStatus = (typeof QueueDispatchStatus)[keyof typeof QueueDispatchStatus];
+export interface QueueDispatchResult {
+    readonly status: QueueDispatchStatus;
+    readonly actionId: string;
+    readonly position: number | null;
+    readonly reason: string | null;
+}
+export type QueueRuntimeState = "idle" | "running" | "cancelling" | "stopped";
+export interface QueueRuntimeSnapshot {
+    readonly state: QueueRuntimeState;
+}
+export interface QueueDispatcherOptions {
+    pending?: PendingQueue;
+    held?: HeldQueue;
+    deadLetters?: DeadLetterQueue;
+}
+/** Places user actions without changing the router's route decisions. */
+export declare class QueueDispatcher {
+    readonly pending: PendingQueue;
+    readonly held: HeldQueue;
+    readonly deadLetters: DeadLetterQueue;
+    constructor(options?: QueueDispatcherOptions);
+    dispatch(action: SessionAction, snapshot: QueueRuntimeSnapshot, routed: RoutedEvent): QueueDispatchResult;
+    private placementFor;
+    /** Queue APIs validate destination; preserve all other router metadata. */
+    private withPlacement;
+    private enqueuePending;
+    private enqueueHeld;
+    private deadLetterOverflow;
+}
+export declare function makeQueueDispatchResult(status: QueueDispatchStatus, actionId: string, options?: {
+    position?: number;
+    reason?: string;
+}): QueueDispatchResult;

package/dist/runtime/queue-dispatcher.js

@@ -0,0 +1,120 @@
+/** Queue placement policy for already-routed session actions. */
+import { DeadLetterQueue, HeldQueue, PendingQueue, QueueOverflowError, } from "../routing.js";
+export const QueueDispatchStatus = {
+    StartNow: "start_now",
+    Pending: "pending",
+    Held: "held",
+    CancelNow: "cancel_now",
+    DeadLetter: "dead_letter",
+    Ignored: "ignored",
+};
+/** Places user actions without changing the router's route decisions. */
+export class QueueDispatcher {
+    pending;
+    held;
+    deadLetters;
+    constructor(options = {}) {
+        this.pending = options.pending ?? new PendingQueue();
+        this.held = options.held ?? new HeldQueue();
+        this.deadLetters = options.deadLetters ?? new DeadLetterQueue();
+    }
+    dispatch(action, snapshot, routed) {
+        if (routed.decision.destination === "drop") {
+            this.deadLetters.put(routed.event, routed.decision.reason);
+            return makeQueueDispatchResult(QueueDispatchStatus.DeadLetter, action.id, {
+                reason: routed.decision.reason,
+            });
+        }
+        if (routed.decision.destination === "held" &&
+            routed.decision.timing === "after_cancel") {
+            return this.enqueueHeld(action.id, routed);
+        }
+        const placement = this.placementFor(action, snapshot);
+        if (placement === QueueDispatchStatus.StartNow) {
+            return makeQueueDispatchResult(QueueDispatchStatus.StartNow, action.id);
+        }
+        if (placement === QueueDispatchStatus.Pending) {
+            return this.enqueuePending(action.id, this.withPlacement(routed, "pending"));
+        }
+        if (placement === QueueDispatchStatus.Held) {
+            return this.enqueueHeld(action.id, this.withPlacement(routed, "held"));
+        }
+        if (placement === QueueDispatchStatus.CancelNow) {
+            return makeQueueDispatchResult(QueueDispatchStatus.CancelNow, action.id);
+        }
+        const destination = routed.decision.destination;
+        if (destination === "new_task" && snapshot.state === "idle") {
+            return makeQueueDispatchResult(QueueDispatchStatus.StartNow, action.id);
+        }
+        if (destination === "pending") {
+            return this.enqueuePending(action.id, routed);
+        }
+        if (destination === "held") {
+            return this.enqueueHeld(action.id, routed);
+        }
+        return makeQueueDispatchResult(QueueDispatchStatus.Ignored, action.id);
+    }
+    placementFor(action, snapshot) {
+        if (action.type === "cancel") {
+            return QueueDispatchStatus.CancelNow;
+        }
+        if (action.type === "prompt" && snapshot.state === "idle") {
+            return QueueDispatchStatus.StartNow;
+        }
+        if (snapshot.state === "running" &&
+            (action.type === "steer" || action.type === "follow_up")) {
+            return QueueDispatchStatus.Pending;
+        }
+        if (action.type === "prompt" && snapshot.state === "cancelling") {
+            return QueueDispatchStatus.Held;
+        }
+        return null;
+    }
+    /** Queue APIs validate destination; preserve all other router metadata. */
+    withPlacement(routed, destination) {
+        return {
+            event: routed.event,
+            decision: { ...routed.decision, destination },
+        };
+    }
+    enqueuePending(actionId, routed) {
+        try {
+            this.pending.put(routed);
+            return makeQueueDispatchResult(QueueDispatchStatus.Pending, actionId, {
+                position: this.pending.size,
+            });
+        }
+        catch (error) {
+            return this.deadLetterOverflow(actionId, routed, error);
+        }
+    }
+    enqueueHeld(actionId, routed) {
+        try {
+            this.held.put(routed);
+            return makeQueueDispatchResult(QueueDispatchStatus.Held, actionId, {
+                position: this.held.size,
+            });
+        }
+        catch (error) {
+            return this.deadLetterOverflow(actionId, routed, error);
+        }
+    }
+    deadLetterOverflow(actionId, routed, error) {
+        if (!(error instanceof QueueOverflowError)) {
+            throw error;
+        }
+        this.deadLetters.put(routed.event, error.message);
+        return makeQueueDispatchResult(QueueDispatchStatus.DeadLetter, actionId, {
+            reason: error.message,
+        });
+    }
+}
+export function makeQueueDispatchResult(status, actionId, options = {}) {
+    return {
+        status,
+        actionId,
+        position: options.position ?? null,
+        reason: options.reason ?? null,
+    };
+}
+//# sourceMappingURL=queue-dispatcher.js.map

package/dist/runtime/queue-dispatcher.js.map

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

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

@@ -0,0 +1,26 @@
+/** Runtime event contracts shared by producers and projections. */
+export declare const RuntimeEventKind: {
+    readonly ActionReceived: "action.received";
+    readonly TaskStarted: "task.started";
+    readonly TaskStateChanged: "task.state_changed";
+    readonly TaskCompleted: "task.completed";
+    readonly TaskFailed: "task.failed";
+    readonly TaskCancelled: "task.cancelled";
+    readonly Display: "display.action";
+};
+export type RuntimeEventKind = (typeof RuntimeEventKind)[keyof typeof RuntimeEventKind];
+/** Model-stream event names forwarded through the runtime boundary. */
+export type ModelRuntimeEventType = "model_text_delta" | "model_reasoning_delta" | "model_tool_call_delta" | "model_response_validating";
+export type ModelRuntimeEventHandler = (eventType: ModelRuntimeEventType, payload: Record<string, unknown>) => void;
+export interface RuntimeEvent<K extends RuntimeEventKind = RuntimeEventKind, P = unknown> {
+    readonly id: string;
+    readonly kind: K;
+    readonly timestamp: number;
+    readonly taskId: string | null;
+    readonly payload: P;
+}
+export declare function makeRuntimeEvent<K extends RuntimeEventKind, P>(kind: K, payload: P, options?: {
+    id?: string;
+    taskId?: string | null;
+    timestamp?: number;
+}): RuntimeEvent<K, P>;

package/dist/runtime/runtime-events.js

@@ -0,0 +1,21 @@
+/** Runtime event contracts shared by producers and projections. */
+import { randomUUID } from "node:crypto";
+export const RuntimeEventKind = {
+    ActionReceived: "action.received",
+    TaskStarted: "task.started",
+    TaskStateChanged: "task.state_changed",
+    TaskCompleted: "task.completed",
+    TaskFailed: "task.failed",
+    TaskCancelled: "task.cancelled",
+    Display: "display.action",
+};
+export function makeRuntimeEvent(kind, payload, options = {}) {
+    return {
+        id: options.id ?? `event_${randomUUID()}`,
+        kind,
+        timestamp: options.timestamp ?? Date.now(),
+        taskId: options.taskId ?? null,
+        payload,
+    };
+}
+//# sourceMappingURL=runtime-events.js.map

package/dist/runtime/runtime-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-events.js","sourceRoot":"","sources":["../../src/runtime/runtime-events.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAEnE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,cAAc,EAAE,iBAAiB;IACjC,WAAW,EAAE,cAAc;IAC3B,gBAAgB,EAAE,oBAAoB;IACtC,aAAa,EAAE,gBAAgB;IAC/B,UAAU,EAAE,aAAa;IACzB,aAAa,EAAE,gBAAgB;IAC/B,OAAO,EAAE,gBAAgB;CACjB,CAAC;AA4BX,MAAM,UAAU,gBAAgB,CAC9B,IAAO,EACP,OAAU,EACV,UAAuE,EAAE;IAEzE,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,SAAS,UAAU,EAAE,EAAE;QACzC,IAAI;QACJ,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE;QAC1C,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;QAC9B,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/runtime/session-action-protocol.d.ts

@@ -0,0 +1,10 @@
+import type { AnswerAction, ApprovalAction, CancelAction, CommandAction, ExitAction, FollowUpAction, PromptAction, SessionAction, SteerAction } from "./session-action.ts";
+export declare function makePromptAction(text: string, source: string): PromptAction;
+export declare function makeCommandAction(name: string, arguments_?: readonly string[], source?: string, text?: string): CommandAction;
+export declare function makeSteerAction(text: string, source: string): SteerAction;
+export declare function makeFollowUpAction(text: string, source: string): FollowUpAction;
+export declare function makeCancelAction(reason?: string, source?: string): CancelAction;
+export declare function makeApprovalAction(text: string, source: string): ApprovalAction;
+export declare function makeAnswerAction(text: string, source: string): AnswerAction;
+export declare function makeExitAction(source?: string): ExitAction;
+export declare function isSessionAction(value: unknown): value is SessionAction;

package/dist/runtime/session-action-protocol.js

@@ -0,0 +1,64 @@
+import { randomUUID } from "node:crypto";
+function actionId() {
+    return `action_${randomUUID()}`;
+}
+export function makePromptAction(text, source) {
+    return { id: actionId(), type: "prompt", text, source };
+}
+export function makeCommandAction(name, arguments_ = [], source = "command", text = [name, ...arguments_].join(" ")) {
+    return {
+        id: actionId(),
+        type: "command",
+        name,
+        arguments: [...arguments_],
+        source,
+        text,
+    };
+}
+export function makeSteerAction(text, source) {
+    return { id: actionId(), type: "steer", text, source };
+}
+export function makeFollowUpAction(text, source) {
+    return { id: actionId(), type: "follow_up", text, source };
+}
+export function makeCancelAction(reason = "cancelled", source = "user") {
+    return { id: actionId(), type: "cancel", reason, source };
+}
+export function makeApprovalAction(text, source) {
+    return { id: actionId(), type: "approval", text, source };
+}
+export function makeAnswerAction(text, source) {
+    return { id: actionId(), type: "answer", text, source };
+}
+export function makeExitAction(source = "user") {
+    return { id: actionId(), type: "exit", source };
+}
+export function isSessionAction(value) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    const action = value;
+    if (typeof action.id !== "string" || typeof action.source !== "string") {
+        return false;
+    }
+    switch (action.type) {
+        case "prompt":
+        case "steer":
+        case "follow_up":
+        case "approval":
+        case "answer":
+            return typeof action.text === "string";
+        case "command":
+            return (typeof action.name === "string" &&
+                Array.isArray(action.arguments) &&
+                action.arguments.every((item) => typeof item === "string") &&
+                (action.text === undefined || typeof action.text === "string"));
+        case "cancel":
+            return typeof action.reason === "string";
+        case "exit":
+            return true;
+        default:
+            return false;
+    }
+}
+//# sourceMappingURL=session-action-protocol.js.map

package/dist/runtime/session-action-protocol.js.map

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

package/dist/runtime/session-action.d.ts

@@ -0,0 +1,42 @@
+/** Actions accepted by a runtime session after intent routing. */
+export interface SessionActionBase {
+    readonly id: string;
+    readonly source: string;
+}
+export interface PromptAction extends SessionActionBase {
+    readonly type: "prompt";
+    readonly text: string;
+}
+export interface CommandAction extends SessionActionBase {
+    readonly type: "command";
+    readonly name: string;
+    readonly arguments: readonly string[];
+    /** Original command text, retained so quoted arguments survive dispatch. */
+    readonly text?: string;
+}
+export interface SteerAction extends SessionActionBase {
+    readonly type: "steer";
+    readonly text: string;
+}
+export interface FollowUpAction extends SessionActionBase {
+    readonly type: "follow_up";
+    readonly text: string;
+}
+export interface CancelAction extends SessionActionBase {
+    readonly type: "cancel";
+    readonly reason: string;
+}
+/** Compatibility shape until approvals have a dedicated runtime path. */
+export interface ApprovalAction extends SessionActionBase {
+    readonly type: "approval";
+    readonly text: string;
+}
+/** Compatibility shape until answers have a dedicated runtime path. */
+export interface AnswerAction extends SessionActionBase {
+    readonly type: "answer";
+    readonly text: string;
+}
+export interface ExitAction extends SessionActionBase {
+    readonly type: "exit";
+}
+export type SessionAction = PromptAction | CommandAction | SteerAction | FollowUpAction | CancelAction | ApprovalAction | AnswerAction | ExitAction;

package/dist/runtime/session-action.js

@@ -0,0 +1,3 @@
+/** Actions accepted by a runtime session after intent routing. */
+export {};
+//# sourceMappingURL=session-action.js.map

package/dist/runtime/session-action.js.map

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