@superdurable/dex-agents 0.1.0 → 0.3.0

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

@@ -0,0 +1,58 @@
+import { FlowNotActiveOrNotFoundError, type Client } from "@superdurable/dex";
+import type { AgentFrameworkRunner, DeferredToolOutcome } from "./agent-framework-runner.js";
+import type { AgentSessionFlow } from "./agent-session-flow.js";
+import type { AgentSnapshot, AgentUserMessage } from "./agent-session-values.js";
+/**
+ * Reports a message sent to a session that failed. {@link sendAgentUserMessage} throws it in place of the Dex
+ * error for a closed Flow, and it stays a `FlowNotActiveOrNotFoundError`. The message did not reach the session.
+ * Messages queued earlier stay readable in {@link AgentSnapshot.queuedMessages} and never run.
+ */
+export declare class AgentSessionFailedError extends FlowNotActiveOrNotFoundError {
+    readonly reason: string;
+    /**
+     * Creates the error from the Dex error it replaces.
+     * @param sessionId - The failed session.
+     * @param reason - Why the session failed, such as `run state of 67492 bytes exceeds the maximum of 65536 bytes`.
+     * @param cause - The Dex error for the closed Flow.
+     */
+    constructor(sessionId: string, reason: string, cause: FlowNotActiveOrNotFoundError);
+}
+/**
+ * Returns the snapshot of a session whose Flow failed, with what the session stores when it has room: status
+ * `failed`, the reason, no active turn, and no pending interrupts. `toolCalls` lists the active turn's calls, so it
+ * is empty too; a stale turn's calls will never finish. A snapshot with no state, or with status `failed`, is
+ * returned unchanged.
+ * @param snapshot - The stored snapshot.
+ * @param reason - The Flow's failure reason.
+ * @returns The snapshot to show.
+ */
+export declare function withSessionFailure(snapshot: AgentSnapshot, reason: string): AgentSnapshot;
+/**
+ * Returns why a session's Flow failed.
+ * @param client - An open Client.
+ * @param sessionId - Running or retained closed session.
+ * @returns The Flow's failure reason, or `undefined` when the Flow did not fail or does not exist.
+ */
+export declare function readSessionFailure(client: Client, sessionId: string): Promise<string | undefined>;
+/**
+ * Returns the session snapshot, with a failed Flow's status and reason. Prefer it to invoking `getAgentSnapshot`
+ * directly: that RPC reads only what the session stored. It costs one more call to Dex.
+ * @param client - An open Client whose Registry contains `flow`.
+ * @param flow - The registered agent session Flow.
+ * @param sessionId - Running or retained closed session.
+ * @returns The snapshot. See {@link withSessionFailure}.
+ */
+export declare function readAgentSnapshot(client: Client, flow: AgentSessionFlow<AgentFrameworkRunner<DeferredToolOutcome>>, sessionId: string): Promise<AgentSnapshot>;
+/**
+ * Queues one user message, and reports a failed session clearly.
+ * @param client - An open Client whose Registry contains `flow`.
+ * @param flow - The registered agent session Flow.
+ * @param sessionId - Running session.
+ * @param message - The user message.
+ * @returns `true` when queued; `false` for blank text, or for a `planMode` message when plan mode is off.
+ * @throws {@link AgentSessionFailedError} when the session failed. Its `reason` says why.
+ * @throws {FlowNotActiveOrNotFoundError} When the session is not running.
+ * @throws {DexServiceError} With `RESOURCE_EXHAUSTED` when the message does not fit under
+ * `limits.maxFlowStateBytes`. Nothing was queued, and the session stays as it was.
+ */
+export declare function sendAgentUserMessage(client: Client, flow: AgentSessionFlow<AgentFrameworkRunner<DeferredToolOutcome>>, sessionId: string, message: AgentUserMessage): Promise<boolean>;

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

@@ -0,0 +1,126 @@
+// 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
+// A session at the state limit may have no room left to store `AgentState`. The commit that would store it
+// fails on the same limit, and the Flow closes without it. Dex always records that close, so a reader takes a
+// failed Flow's status and reason from it.
+import { FlowNotActiveOrNotFoundError, FlowNotFoundError } from "@superdurable/dex";
+const unknownFailure = "the session's Flow failed";
+/**
+ * Reports a message sent to a session that failed. {@link sendAgentUserMessage} throws it in place of the Dex
+ * error for a closed Flow, and it stays a `FlowNotActiveOrNotFoundError`. The message did not reach the session.
+ * Messages queued earlier stay readable in {@link AgentSnapshot.queuedMessages} and never run.
+ */
+export class AgentSessionFailedError extends FlowNotActiveOrNotFoundError {
+    reason;
+    /**
+     * Creates the error from the Dex error it replaces.
+     * @param sessionId - The failed session.
+     * @param reason - Why the session failed, such as `run state of 67492 bytes exceeds the maximum of 65536 bytes`.
+     * @param cause - The Dex error for the closed Flow.
+     */
+    constructor(sessionId, reason, cause) {
+        super(cause.code, cause.subStatus, `session ${sessionId} failed: ${reason}`, cause.operation, sessionId, { cause });
+        this.reason = reason;
+    }
+}
+/**
+ * Returns the snapshot of a session whose Flow failed, with what the session stores when it has room: status
+ * `failed`, the reason, no active turn, and no pending interrupts. `toolCalls` lists the active turn's calls, so it
+ * is empty too; a stale turn's calls will never finish. A snapshot with no state, or with status `failed`, is
+ * returned unchanged.
+ * @param snapshot - The stored snapshot.
+ * @param reason - The Flow's failure reason.
+ * @returns The snapshot to show.
+ */
+export function withSessionFailure(snapshot, reason) {
+    const state = snapshot.state;
+    if (state === null || !mayHideSessionFailure(snapshot)) {
+        return snapshot;
+    }
+    return {
+        ...snapshot,
+        state: {
+            ...state,
+            status: "failed",
+            turnCount: state.turnCount + (state.activeTurnId === null ? 0 : 1),
+            activeTurnId: null,
+            acceptsTurnControl: false,
+            lastTurnError: reason,
+        },
+        pendingInterrupts: [],
+        toolCalls: [],
+    };
+}
+/**
+ * Returns why a session's Flow failed.
+ * @param client - An open Client.
+ * @param sessionId - Running or retained closed session.
+ * @returns The Flow's failure reason, or `undefined` when the Flow did not fail or does not exist.
+ */
+export async function readSessionFailure(client, sessionId) {
+    try {
+        if ((await client.describeFlow(sessionId)).status !== "failed") {
+            return undefined;
+        }
+    }
+    catch (error) {
+        if (error instanceof FlowNotFoundError) {
+            return undefined;
+        }
+        throw error;
+    }
+    return (await client.waitForFlow(sessionId)).errorMessage || unknownFailure;
+}
+/**
+ * Returns the session snapshot, with a failed Flow's status and reason. Prefer it to invoking `getAgentSnapshot`
+ * directly: that RPC reads only what the session stored. It costs one more call to Dex.
+ * @param client - An open Client whose Registry contains `flow`.
+ * @param flow - The registered agent session Flow.
+ * @param sessionId - Running or retained closed session.
+ * @returns The snapshot. See {@link withSessionFailure}.
+ */
+export async function readAgentSnapshot(client, flow, sessionId) {
+    const snapshot = await client.invokeRPC(flow.getAgentSnapshot, sessionId);
+    if (!mayHideSessionFailure(snapshot)) {
+        return snapshot;
+    }
+    const reason = await readSessionFailure(client, sessionId);
+    return reason === undefined ? snapshot : withSessionFailure(snapshot, reason);
+}
+/** Reports whether the Flow's close could add to this snapshot. */
+function mayHideSessionFailure(snapshot) {
+    return snapshot.state !== null && snapshot.state.status !== "failed";
+}
+/**
+ * Queues one user message, and reports a failed session clearly.
+ * @param client - An open Client whose Registry contains `flow`.
+ * @param flow - The registered agent session Flow.
+ * @param sessionId - Running session.
+ * @param message - The user message.
+ * @returns `true` when queued; `false` for blank text, or for a `planMode` message when plan mode is off.
+ * @throws {@link AgentSessionFailedError} when the session failed. Its `reason` says why.
+ * @throws {FlowNotActiveOrNotFoundError} When the session is not running.
+ * @throws {DexServiceError} With `RESOURCE_EXHAUSTED` when the message does not fit under
+ * `limits.maxFlowStateBytes`. Nothing was queued, and the session stays as it was.
+ */
+export async function sendAgentUserMessage(client, flow, sessionId, message) {
+    try {
+        return await client.invokeRPC(flow.sendUserMessage, sessionId, message);
+    }
+    catch (error) {
+        if (!(error instanceof FlowNotActiveOrNotFoundError)) {
+            throw error;
+        }
+        const reason = await readSessionFailure(client, sessionId);
+        if (reason === undefined) {
+            throw error;
+        }
+        throw new AgentSessionFailedError(sessionId, reason, error);
+    }
+}
+//# sourceMappingURL=agent-session-failure.js.map

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

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

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

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/src/agent-session-flow-graph-cli.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+// 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 { writeFileSync } from "node:fs";
+import { parseArgs } from "node:util";
+import { renderSessionFlowGraph } from "./agent-session-flow-graph.js";
+const usage = "usage: dex-agents-session-graph --flow-type TYPE --permission PERMISSION [--out FILE]\n";
+function main() {
+    let values;
+    try {
+        ({ values } = parseArgs({
+            options: { "flow-type": { type: "string" }, permission: { type: "string" }, out: { type: "string" } },
+        }));
+    }
+    catch (error) {
+        process.stderr.write(`${error.message}\n${usage}`);
+        return 2;
+    }
+    const flowType = values["flow-type"];
+    const actionPermission = values.permission;
+    if (flowType === undefined || actionPermission === undefined) {
+        process.stderr.write(usage);
+        return 2;
+    }
+    let graph;
+    try {
+        graph = renderSessionFlowGraph({ flowType, actionPermission });
+    }
+    catch (error) {
+        process.stderr.write(`${error.message}\n`);
+        return 2;
+    }
+    if (values.out === undefined) {
+        process.stdout.write(graph);
+    }
+    else {
+        writeFileSync(values.out, graph);
+    }
+    return 0;
+}
+process.exitCode = main();
+//# sourceMappingURL=agent-session-flow-graph-cli.js.map

package/dist/src/agent-session-flow-graph-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session-flow-graph-cli.js","sourceRoot":"","sources":["../../src/agent-session-flow-graph-cli.ts"],"names":[],"mappings":";AACA,yCAAyC;AACzC,EAAE;AACF,kDAAkD;AAClD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,0DAA0D;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,MAAM,KAAK,GAAG,yFAAyF,CAAC;AAExG,SAAS,IAAI;IACX,IAAI,MAAuG,CAAC;IAC5G,IAAI,CAAC;QACH,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;YACtB,OAAO,EAAE,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;SACtG,CAAC,CAAC,CAAC;IACN,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAI,KAAe,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC;QAC9D,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IACrC,MAAM,gBAAgB,GAAG,MAAM,CAAC,UAAU,CAAC;IAC3C,IAAI,QAAQ,KAAK,SAAS,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;QAC7D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5B,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,KAAa,CAAC;IAClB,IAAI,CAAC;QACH,KAAK,GAAG,sBAAsB,CAAC,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC,CAAC;IACjE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAI,KAAe,CAAC,OAAO,IAAI,CAAC,CAAC;QACtD,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;SAAM,CAAC;QACN,aAAa,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,OAAO,CAAC,QAAQ,GAAG,IAAI,EAAE,CAAC"}

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

@@ -0,0 +1,38 @@
+/** What an application chooses for the session Flow Definition Graph of one agent. */
+export interface SessionFlowGraphOptions {
+    /** The Flow type of the agent, as passed to `createAgentSessionFlow`. */
+    readonly flowType: string;
+    /** The permission every session Action requires, such as `support-agent.operate`. */
+    readonly actionPermission: string;
+}
+/**
+ * Renders the Flow Definition Graph 2.0 file of one agent's session Flow.
+ *
+ * `dexcli visualize` cannot read the session Flow: the Flow lives in this library, and the application chooses its
+ * Flow type. This function fills both choices into the graph that ships with the package. Write the text to a file in
+ * the directory that Dex Web reads with `--flow-rendering-dir`. Dex Web then draws the session Steps and offers the
+ * `resolve_interrupt`, `answer_question`, `steer_user_message`, and `cancel_turn` Actions. Those Actions have no
+ * condition, because each RPC checks current state itself.
+ *
+ * The Python core renders the same bytes, so a graph from either core serves a session on Workers of either language.
+ * Render the file again after you upgrade this package. The `dex-agents-session-graph` command does the same from a
+ * build or deployment script.
+ *
+ * @example
+ * ```ts
+ * import { writeFileSync } from "node:fs";
+ * import { renderSessionFlowGraph } from "@superdurable/dex-agents";
+ *
+ * writeFileSync(
+ *   "definitions/support-agent.json",
+ *   renderSessionFlowGraph({ flowType: "SupportAgent", actionPermission: "support-agent.operate" }),
+ * );
+ * ```
+ *
+ * @param options - The Flow type and the Action permission.
+ * @returns The graph as JSON text that ends with a newline.
+ * @throws {TypeError} When `flowType` is blank, or when `actionPermission` is not lowercase letters, digits, dots, and
+ *   hyphens that start with a letter.
+ * @since 0.3.0
+ */
+export declare function renderSessionFlowGraph(options: SessionFlowGraphOptions): string;

package/dist/src/agent-session-flow-graph.js

@@ -0,0 +1,54 @@
+// 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 sessionFlowGraphTemplate from "./agent-session-flow-graph.json" with { type: "json" };
+const actionPermissionPattern = /^[a-z][a-z0-9]*(?:[.-][a-z0-9]+)*$/;
+/**
+ * Renders the Flow Definition Graph 2.0 file of one agent's session Flow.
+ *
+ * `dexcli visualize` cannot read the session Flow: the Flow lives in this library, and the application chooses its
+ * Flow type. This function fills both choices into the graph that ships with the package. Write the text to a file in
+ * the directory that Dex Web reads with `--flow-rendering-dir`. Dex Web then draws the session Steps and offers the
+ * `resolve_interrupt`, `answer_question`, `steer_user_message`, and `cancel_turn` Actions. Those Actions have no
+ * condition, because each RPC checks current state itself.
+ *
+ * The Python core renders the same bytes, so a graph from either core serves a session on Workers of either language.
+ * Render the file again after you upgrade this package. The `dex-agents-session-graph` command does the same from a
+ * build or deployment script.
+ *
+ * @example
+ * ```ts
+ * import { writeFileSync } from "node:fs";
+ * import { renderSessionFlowGraph } from "@superdurable/dex-agents";
+ *
+ * writeFileSync(
+ *   "definitions/support-agent.json",
+ *   renderSessionFlowGraph({ flowType: "SupportAgent", actionPermission: "support-agent.operate" }),
+ * );
+ * ```
+ *
+ * @param options - The Flow type and the Action permission.
+ * @returns The graph as JSON text that ends with a newline.
+ * @throws {TypeError} When `flowType` is blank, or when `actionPermission` is not lowercase letters, digits, dots, and
+ *   hyphens that start with a letter.
+ * @since 0.3.0
+ */
+export function renderSessionFlowGraph(options) {
+    if (options.flowType.trim() === "") {
+        throw new TypeError("flowType must not be empty");
+    }
+    if (!actionPermissionPattern.test(options.actionPermission)) {
+        throw new TypeError(`actionPermission ${JSON.stringify(options.actionPermission)} is not a valid permission`);
+    }
+    const graph = structuredClone(sessionFlowGraphTemplate);
+    graph.flow.name = options.flowType;
+    for (const action of graph.v2.actions) {
+        action.requiredPermission = options.actionPermission;
+    }
+    return `${JSON.stringify(graph, null, 2)}\n`;
+}
+//# sourceMappingURL=agent-session-flow-graph.js.map

package/dist/src/agent-session-flow-graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session-flow-graph.js","sourceRoot":"","sources":["../../src/agent-session-flow-graph.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,kDAAkD;AAClD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,0DAA0D;AAE1D,OAAO,wBAAwB,MAAM,iCAAiC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAE7F,MAAM,uBAAuB,GAAG,oCAAoC,CAAC;AAUrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAgC;IACrE,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACnC,MAAM,IAAI,SAAS,CAAC,4BAA4B,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,SAAS,CAAC,oBAAoB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,gBAAgB,CAAC,4BAA4B,CAAC,CAAC;IAChH,CAAC;IACD,MAAM,KAAK,GAAG,eAAe,CAAC,wBAAwB,CAAC,CAAC;IACxD,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC;IACnC,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC;QACtC,MAAM,CAAC,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IACvD,CAAC;IACD,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC"}