@superdurable/dex-agents 0.0.0-stage → 0.1.0

package/dist/src/agent-session-codecs.js

@@ -0,0 +1,355 @@
+// Copyright (c) 2026 Super Durable, Inc.
+//
+// Licensed under the Sustainable Use License 1.0.
+// You may not use this file except in compliance with the License.
+// See the LICENSE file in the repository root.
+//
+// SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
+import { jsonCodec } from "@superdurable/dex";
+// Wire values are snake_case JSON shared with the Python core; TypeScript values are camelCase.
+const agentSessionStatuses = [
+    "waiting_for_user_message",
+    "running_model",
+    "running_tools",
+];
+const agentMessageRoles = ["user", "assistant", "tool"];
+const toolEffects = [
+    "read",
+    "idempotent_write",
+    "non_idempotent_write",
+    "unclassified",
+];
+const agentToolCallStatuses = [
+    "awaiting_approval",
+    "approved",
+    "rejected",
+    "succeeded",
+    "failed",
+    "outcome_unknown",
+];
+class WireRecordReader {
+    typeName;
+    record;
+    constructor(value, typeName) {
+        this.typeName = typeName;
+        if (typeof value !== "object" || value === null || Array.isArray(value)) {
+            throw new TypeError(`${typeName} must be a JSON object`);
+        }
+        this.record = value;
+    }
+    readString(field) {
+        const value = this.record[field];
+        if (typeof value !== "string") {
+            throw new TypeError(`${this.typeName}.${field} must be a string`);
+        }
+        return value;
+    }
+    readNullableString(field) {
+        const value = this.record[field];
+        if (value === undefined || value === null) {
+            return null;
+        }
+        if (typeof value !== "string") {
+            throw new TypeError(`${this.typeName}.${field} must be a string or null`);
+        }
+        return value;
+    }
+    readInteger(field) {
+        const value = this.record[field];
+        if (typeof value !== "number" || !Number.isSafeInteger(value)) {
+            throw new TypeError(`${this.typeName}.${field} must be an integer`);
+        }
+        return value;
+    }
+    readIntegerOrDefault(field, defaultValue) {
+        const value = this.record[field];
+        return value === undefined || value === null ? defaultValue : this.readInteger(field);
+    }
+    readNullableInteger(field) {
+        const value = this.record[field];
+        if (value === undefined || value === null) {
+            return null;
+        }
+        return this.readInteger(field);
+    }
+    readBoolean(field) {
+        const value = this.record[field];
+        if (typeof value !== "boolean") {
+            throw new TypeError(`${this.typeName}.${field} must be a boolean`);
+        }
+        return value;
+    }
+    readEnum(field, allowed) {
+        const value = this.readString(field);
+        if (!allowed.includes(value)) {
+            throw new TypeError(`${this.typeName}.${field} has unknown value ${value}`);
+        }
+        return value;
+    }
+    readArray(field) {
+        const value = this.record[field];
+        if (!Array.isArray(value)) {
+            throw new TypeError(`${this.typeName}.${field} must be an array`);
+        }
+        return value;
+    }
+    readObject(field) {
+        return this.record[field];
+    }
+}
+export function encodeAgentSessionStartInput(value) {
+    return { initial_message: value.initialMessage };
+}
+export function decodeAgentSessionStartInput(value) {
+    if (value === null || value === undefined) {
+        return { initialMessage: null };
+    }
+    const reader = new WireRecordReader(value, "AgentSessionStartInput");
+    return { initialMessage: reader.readNullableString("initial_message") };
+}
+export function encodeAgentState(value) {
+    return {
+        status: value.status,
+        turn_count: value.turnCount,
+        active_turn_id: value.activeTurnId,
+        next_message_sequence: value.nextMessageSequence,
+        last_turn_error: value.lastTurnError,
+    };
+}
+export function decodeAgentState(value) {
+    const reader = new WireRecordReader(value, "AgentState");
+    return {
+        status: reader.readEnum("status", agentSessionStatuses),
+        turnCount: reader.readInteger("turn_count"),
+        activeTurnId: reader.readNullableString("active_turn_id"),
+        nextMessageSequence: reader.readInteger("next_message_sequence"),
+        lastTurnError: reader.readNullableString("last_turn_error"),
+    };
+}
+export function encodeAgentMessage(value) {
+    return {
+        sequence: value.sequence,
+        turn_id: value.turnId,
+        role: value.role,
+        text: value.text,
+        tool_call_id: value.toolCallId,
+        tool_name: value.toolName,
+        tool_arguments: value.toolArguments,
+        tool_output: value.toolOutput,
+        framework_item: value.frameworkItem,
+        created_at: value.createdAt,
+    };
+}
+export function decodeAgentMessage(value) {
+    const reader = new WireRecordReader(value, "AgentMessage");
+    return {
+        sequence: reader.readInteger("sequence"),
+        turnId: reader.readString("turn_id"),
+        role: reader.readEnum("role", agentMessageRoles),
+        text: reader.readNullableString("text"),
+        toolCallId: reader.readNullableString("tool_call_id"),
+        toolName: reader.readNullableString("tool_name"),
+        toolArguments: reader.readNullableString("tool_arguments"),
+        toolOutput: reader.readNullableString("tool_output"),
+        frameworkItem: reader.readString("framework_item"),
+        createdAt: reader.readString("created_at"),
+    };
+}
+export function encodeAgentToolCall(value) {
+    return {
+        tool_call_id: value.toolCallId,
+        turn_id: value.turnId,
+        tool_name: value.toolName,
+        arguments: value.arguments,
+        effect: value.effect,
+        requires_approval: value.requiresApproval,
+        status: value.status,
+        output: value.output,
+        error: value.error,
+        rejection_message: value.rejectionMessage,
+        deferral_order: value.deferralOrder,
+    };
+}
+export function decodeAgentToolCall(value) {
+    const reader = new WireRecordReader(value, "AgentToolCall");
+    return {
+        toolCallId: reader.readString("tool_call_id"),
+        turnId: reader.readString("turn_id"),
+        toolName: reader.readString("tool_name"),
+        arguments: reader.readString("arguments"),
+        effect: reader.readEnum("effect", toolEffects),
+        requiresApproval: reader.readBoolean("requires_approval"),
+        status: reader.readEnum("status", agentToolCallStatuses),
+        output: reader.readNullableString("output"),
+        error: reader.readNullableString("error"),
+        rejectionMessage: reader.readNullableString("rejection_message"),
+        deferralOrder: reader.readIntegerOrDefault("deferral_order", 0),
+    };
+}
+export function encodeAgentInterrupt(value) {
+    return {
+        interrupt_id: value.interruptId,
+        kind: value.kind,
+        tool_call_id: value.toolCallId,
+        tool_name: value.toolName,
+        arguments: value.arguments,
+        created_at: value.createdAt,
+        deadline: value.deadline,
+    };
+}
+export function decodeAgentInterrupt(value) {
+    const reader = new WireRecordReader(value, "AgentInterrupt");
+    return {
+        interruptId: reader.readString("interrupt_id"),
+        kind: reader.readEnum("kind", ["tool_approval"]),
+        toolCallId: reader.readString("tool_call_id"),
+        toolName: reader.readString("tool_name"),
+        arguments: reader.readString("arguments"),
+        createdAt: reader.readString("created_at"),
+        deadline: reader.readNullableString("deadline"),
+    };
+}
+export function encodeAgentInterruptResolution(value) {
+    return { approved: value.approved, rejection_message: value.rejectionMessage };
+}
+export function decodeAgentInterruptResolution(value) {
+    const reader = new WireRecordReader(value, "AgentInterruptResolution");
+    return {
+        approved: reader.readBoolean("approved"),
+        rejectionMessage: reader.readNullableString("rejection_message"),
+    };
+}
+export function encodeAgentUsage(value) {
+    return {
+        model_calls: value.modelCalls,
+        input_tokens: value.inputTokens,
+        output_tokens: value.outputTokens,
+        cached_input_tokens: value.cachedInputTokens,
+        reasoning_tokens: value.reasoningTokens,
+    };
+}
+export function decodeAgentUsage(value) {
+    const reader = new WireRecordReader(value, "AgentUsage");
+    return {
+        modelCalls: reader.readInteger("model_calls"),
+        inputTokens: reader.readInteger("input_tokens"),
+        outputTokens: reader.readInteger("output_tokens"),
+        cachedInputTokens: reader.readInteger("cached_input_tokens"),
+        reasoningTokens: reader.readInteger("reasoning_tokens"),
+    };
+}
+export function encodeAgentUserMessage(value) {
+    return { text: value.text };
+}
+export function decodeAgentUserMessage(value) {
+    const reader = new WireRecordReader(value, "AgentUserMessage");
+    return { text: reader.readString("text") };
+}
+export function encodeToolCallCompleted(value) {
+    return { tool_call_id: value.toolCallId };
+}
+export function decodeToolCallCompleted(value) {
+    const reader = new WireRecordReader(value, "ToolCallCompleted");
+    return { toolCallId: reader.readString("tool_call_id") };
+}
+export function encodeAgentEvent(value) {
+    return {
+        type: value.type,
+        turn_id: value.turnId,
+        attempt: value.attempt,
+        step_execution_id: value.stepExecutionId,
+        payload: value.payload,
+    };
+}
+export function decodeAgentEvent(value) {
+    const reader = new WireRecordReader(value, "AgentEvent");
+    return {
+        type: reader.readString("type"),
+        turnId: reader.readNullableString("turn_id"),
+        attempt: reader.readInteger("attempt"),
+        stepExecutionId: reader.readNullableString("step_execution_id") ?? "",
+        payload: reader.readString("payload"),
+    };
+}
+export function encodeResolveInterruptInput(value) {
+    return {
+        interrupt_id: value.interruptId,
+        approved: value.approved,
+        rejection_message: value.rejectionMessage,
+    };
+}
+export function decodeResolveInterruptInput(value) {
+    const reader = new WireRecordReader(value, "ResolveInterruptInput");
+    return {
+        interruptId: reader.readString("interrupt_id"),
+        approved: reader.readBoolean("approved"),
+        rejectionMessage: reader.readNullableString("rejection_message"),
+    };
+}
+export function encodeAgentSnapshot(value) {
+    return {
+        state: value.state === null ? null : encodeAgentState(value.state),
+        messages: value.messages.map(encodeAgentMessage),
+        pending_interrupts: value.pendingInterrupts.map(encodeAgentInterrupt),
+        tool_calls: value.toolCalls.map(encodeAgentToolCall),
+        usage: encodeAgentUsage(value.usage),
+        queued_message_count: value.queuedMessageCount,
+    };
+}
+export function decodeAgentSnapshot(value) {
+    const reader = new WireRecordReader(value, "AgentSnapshot");
+    return {
+        state: reader.readObject("state") == null ? null : decodeAgentState(reader.readObject("state")),
+        messages: reader.readArray("messages").map(decodeAgentMessage),
+        pendingInterrupts: reader.readArray("pending_interrupts").map(decodeAgentInterrupt),
+        toolCalls: reader.readArray("tool_calls").map(decodeAgentToolCall),
+        usage: decodeAgentUsage(reader.readObject("usage")),
+        queuedMessageCount: reader.readIntegerOrDefault("queued_message_count", 0),
+    };
+}
+export function encodeListAgentMessagesInput(value) {
+    return { before_sequence: value.beforeSequence, limit: value.limit };
+}
+export function decodeListAgentMessagesInput(value) {
+    const reader = new WireRecordReader(value, "ListAgentMessagesInput");
+    return {
+        beforeSequence: reader.readNullableInteger("before_sequence"),
+        limit: reader.readIntegerOrDefault("limit", 50),
+    };
+}
+export function encodeAgentMessagesPage(value) {
+    return {
+        messages: value.messages.map(encodeAgentMessage),
+        next_before_sequence: value.nextBeforeSequence,
+    };
+}
+export function decodeAgentMessagesPage(value) {
+    const reader = new WireRecordReader(value, "AgentMessagesPage");
+    return {
+        messages: reader.readArray("messages").map(decodeAgentMessage),
+        nextBeforeSequence: reader.readNullableInteger("next_before_sequence"),
+    };
+}
+function snakeCaseJsonCodec(typeName, encode, decode) {
+    return jsonCodec({ typeName, encode, decode });
+}
+export const agentSessionStartInputCodec = snakeCaseJsonCodec("AgentSessionStartInput", encodeAgentSessionStartInput, decodeAgentSessionStartInput);
+export const agentStateCodec = snakeCaseJsonCodec("AgentState", encodeAgentState, decodeAgentState);
+export const agentMessageCodec = snakeCaseJsonCodec("AgentMessage", encodeAgentMessage, decodeAgentMessage);
+export const agentToolCallCodec = snakeCaseJsonCodec("AgentToolCall", encodeAgentToolCall, decodeAgentToolCall);
+export const agentInterruptListCodec = snakeCaseJsonCodec("AgentInterruptList", (value) => value.map(encodeAgentInterrupt), (value) => {
+    if (!Array.isArray(value)) {
+        throw new TypeError("PendingInterrupts must be a JSON array");
+    }
+    return value.map(decodeAgentInterrupt);
+});
+export const agentInterruptResolutionCodec = snakeCaseJsonCodec("AgentInterruptResolution", encodeAgentInterruptResolution, decodeAgentInterruptResolution);
+export const agentUsageCodec = snakeCaseJsonCodec("AgentUsage", encodeAgentUsage, decodeAgentUsage);
+export const agentUserMessageCodec = snakeCaseJsonCodec("AgentUserMessage", encodeAgentUserMessage, decodeAgentUserMessage);
+export const toolCallCompletedCodec = snakeCaseJsonCodec("ToolCallCompleted", encodeToolCallCompleted, decodeToolCallCompleted);
+export const agentEventCodec = snakeCaseJsonCodec("AgentEvent", encodeAgentEvent, decodeAgentEvent);
+export const resolveInterruptInputCodec = snakeCaseJsonCodec("ResolveInterruptInput", encodeResolveInterruptInput, decodeResolveInterruptInput);
+export const agentSnapshotCodec = snakeCaseJsonCodec("AgentSnapshot", encodeAgentSnapshot, decodeAgentSnapshot);
+export const listAgentMessagesInputCodec = snakeCaseJsonCodec("ListAgentMessagesInput", encodeListAgentMessagesInput, decodeListAgentMessagesInput);
+export const agentMessagesPageCodec = snakeCaseJsonCodec("AgentMessagesPage", encodeAgentMessagesPage, decodeAgentMessagesPage);
+//# sourceMappingURL=agent-session-codecs.js.map

package/dist/src/agent-session-codecs.js.map

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

package/dist/src/agent-session-flow.d.ts

@@ -0,0 +1,148 @@
+import { type Context, type Flow, type RPCResult } from "@superdurable/dex";
+import type { AgentFrameworkRunner, ToolPolicy } from "./agent-framework-runner.js";
+import { type AgentSessionPersistence } from "./agent-session-persistence.js";
+import type { AgentMessagesPage, AgentSessionStartInput, AgentSnapshot, AgentUserMessage, ListAgentMessagesInput, ResolveInterruptInput, ToolEffect } from "./agent-session-values.js";
+/** Tool policies, live events, and approval deadline of one agent, passed to {@link createAgentSessionFlow}. */
+export interface AgentSessionOptions {
+    /**
+     * Policies by tool name. A policy overrides framework metadata and {@link defaultToolEffect}.
+     * Defaults to none.
+     */
+    readonly toolPolicies?: Readonly<Record<string, ToolPolicy>>;
+    /**
+     * Effect of a tool without a policy or framework metadata. Defaults to `"unclassified"`, so unknown
+     * tools run once and need approval.
+     */
+    readonly defaultToolEffect?: ToolEffect;
+    /**
+     * Approximate byte budget of the `AgentEvents` Stream, shared by every session of the Flow type.
+     * Defaults to 10 MiB.
+     */
+    readonly eventStreamCapacityBytes?: number;
+    /**
+     * Milliseconds an approval may stay pending before `AwaitToolApproval` rejects it with
+     * `"approval deadline passed"`. Defaults to no deadline: approvals wait indefinitely.
+     */
+    readonly interruptDeadlineMs?: number;
+}
+/** Options applied by an {@link AgentSessionFlow}, with every default filled in. */
+export interface ResolvedAgentSessionOptions {
+    /** Policies by tool name. */
+    readonly toolPolicies: Readonly<Record<string, ToolPolicy>>;
+    /** Effect of a tool without a policy or framework metadata. */
+    readonly defaultToolEffect: ToolEffect;
+    /** Byte budget of the `AgentEvents` Stream. */
+    readonly eventStreamCapacityBytes: number;
+    /** Approval deadline in milliseconds, or `undefined` for none. */
+    readonly interruptDeadlineMs: number | undefined;
+}
+/**
+ * Durable agent session Flow: one Flow execution is one agent session, and its Flow ID is the session ID.
+ *
+ * Create one per agent with {@link createAgentSessionFlow}, register it in the process `Registry`, and
+ * call its RPCs with `Client.invokeRPC`. The RPC names are `send_user_message`, `resolve_interrupt`,
+ * `get_agent_snapshot`, and `list_agent_messages`, the same as the Python core. The session never
+ * completes on its own: it waits for the next user message after every turn. Stop it with
+ * `Client.stopFlow`.
+ *
+ * The Flow's persistence definitions are properties of the Flow; pass them to `Client.getAttributes`
+ * or the Stream reads.
+ *
+ * @example
+ * ```ts
+ * const flow = createAgentSessionFlow(runner, "SupportAgent");
+ * const registry = new Registry([flow]);
+ * // ... start a Worker and a Client with this registry ...
+ * await client.startFlow(flow, sessionId, { initialMessage: null });
+ * await client.invokeRPC(flow.sendUserMessage, sessionId, { text: "Where is order 42?" });
+ * const snapshot = await client.invokeRPC(flow.getAgentSnapshot, sessionId);
+ * for (const interrupt of snapshot.pendingInterrupts) {
+ *   await client.invokeRPC(flow.resolveInterrupt, sessionId, {
+ *     interruptId: interrupt.interruptId, approved: true, rejectionMessage: null });
+ * }
+ * ```
+ */
+export interface AgentSessionFlow extends Flow<AgentSessionStartInput>, AgentSessionPersistence {
+    /** The framework runner passed to {@link createAgentSessionFlow}. */
+    readonly runner: AgentFrameworkRunner;
+    /** The options this Flow applies, with defaults filled in. */
+    readonly options: ResolvedAgentSessionOptions;
+    /**
+     * RPC `send_user_message`: queues one user message.
+     *
+     * The session starts one turn per queued message, in order, after the current turn ends.
+     * The RPC requires a running session.
+     *
+     * @param context - RPC Context supplied by Dex.
+     * @param message - Message to queue.
+     * @returns `true` when queued; `false` when the text is blank.
+     */
+    sendUserMessage(context: Context, message: AgentUserMessage): RPCResult<boolean>;
+    /**
+     * RPC `resolve_interrupt`: approves or rejects one pending interrupt.
+     *
+     * It removes the interrupt from `PendingInterrupts` and publishes the answer in one commit, so only
+     * one call succeeds per interrupt. It locks `PendingInterrupts`, so a call that races
+     * `AwaitToolApproval` can fail with `RpcLockConflictError`, which is safe to retry. The
+     * rejection message is dropped when `approved` is `true`.
+     *
+     * @param context - RPC Context supplied by Dex.
+     * @param input - Interrupt ID and decision.
+     * @returns `true` when the interrupt was pending and is now resolved; `false` when it is unknown,
+     * already resolved, or past its deadline.
+     */
+    resolveInterrupt(context: Context, input: ResolveInterruptInput): RPCResult<boolean>;
+    /**
+     * RPC `get_agent_snapshot`: returns the durable session view a UI renders.
+     *
+     * It reads committed state without locks, so it also serves a retained closed session. It loads the
+     * whole `AgentMessages` map.
+     *
+     * @param context - RPC Context supplied by Dex.
+     * @returns State, the last 200 messages, pending interrupts, the active turn's tool calls, usage,
+     * and the queued message count. Before `StartAgentSession` commits, `state` is `null` and the lists
+     * are empty.
+     */
+    getAgentSnapshot(context: Context): RPCResult<AgentSnapshot>;
+    /**
+     * RPC `list_agent_messages`: returns one page of stored messages, oldest first.
+     *
+     * Start with `beforeSequence` `null` for the newest page, then pass each page's
+     * `nextBeforeSequence` to walk back. It also serves a retained closed session.
+     *
+     * @param context - RPC Context supplied by Dex.
+     * @param input - Exclusive upper sequence bound, or `null`, and a page size clamped to 1..200.
+     * @returns Up to `limit` messages below `beforeSequence` in ascending order, and the bound of the
+     * next older page, or `null` when the page starts at the first message.
+     */
+    listAgentMessages(context: Context, input: ListAgentMessagesInput): RPCResult<AgentMessagesPage>;
+}
+/**
+ * Creates the shared agent session Flow for one agent and its framework runner.
+ *
+ * Construct it once per agent at application startup and pass the same object to the Registry and
+ * every Client call. Each call creates a distinct Flow with its own Step instances, persistence
+ * definitions, and RPC methods, so one Registry can hold several agents under different Flow types.
+ * Adapter packages wrap this function; applications usually call the adapter's factory instead.
+ *
+ * It is a function rather than a class because the Dex Client identifies an RPC by its method
+ * function, and two Flows of one class would share their RPC methods.
+ *
+ * @example
+ * ```ts
+ * const triage = createAgentSessionFlow(triageRunner, "TriageAgent", {
+ *   toolPolicies: { lookup_customer: { effect: "read" } },
+ *   interruptDeadlineMs: 24 * 60 * 60 * 1000,
+ * });
+ * const billing = createAgentSessionFlow(billingRunner, "BillingAgent");
+ * const registry = new Registry([triage, billing]);
+ * ```
+ * @param runner - Framework runner; the Flow owns no other dependency.
+ * @param flowType - Flow type, unique within the Registry, such as `"TriageAgent"`. Keep it stable:
+ * running sessions resume by it.
+ * @param options - Tool policies, Stream capacity, and approval deadline. Defaults to all defaults.
+ * @returns A new Flow to register in one Registry.
+ * @throws {TypeError} When `flowType` is blank, the runner is incomplete, or an effect is unknown.
+ * @throws {RangeError} When `eventStreamCapacityBytes` or `interruptDeadlineMs` is not positive.
+ */
+export declare function createAgentSessionFlow(runner: AgentFrameworkRunner, flowType: string, options?: AgentSessionOptions): AgentSessionFlow;