@superdurable/dex-agents 0.3.0 → 0.5.0

package/dist/src/connectors/connector-tool-source.js

@@ -0,0 +1,628 @@
+// 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 { RetryError, createCall, defaultConnectorStepExecuteRetryPolicy, runMutation, runQuery, throwDexRetry, } from "@superdurable/connectors-sdk";
+import { ToolExecutionError, ToolOutcomeUnknownError, } from "../agent-framework-runner.js";
+import { serializeJsonWithSpacedSeparators } from "../builtin-loop/json-schema-validation.js";
+import { checkConnectorInputSchema, compareCodePoints, findConnectorInputViolation } from "./connector-input-schema.js";
+import { ConnectorStepContext, hasReadCheckpoint, isFenceMarker, readFenceEvidence, readPreviousCheckpoint, } from "./connector-step-context.js";
+/**
+ * Default {@link ConnectorToolSource.sourceName}.
+ * @since 0.4.0
+ */
+export const defaultConnectorSourceName = "connectors";
+/**
+ * Default bound, in bytes of UTF-8 text, on the result one connector tool call gives the model: 64 KiB.
+ * @since 0.4.0
+ */
+export const defaultConnectorResultMaxBytes = 64 * 1024;
+/**
+ * Note appended to a truncated result; `{total_bytes}` is the size of the full result. The same text as the
+ * Python core.
+ * @since 0.4.0
+ */
+export const connectorResultTruncatedNote = "[Dex] truncated, {total_bytes} bytes";
+/**
+ * Error text of a single-attempt write whose fence proved no send before the connector's Retry; the same text as
+ * the Python core.
+ * @since 0.4.0
+ */
+export const connectorNotSentRetryLater = "not sent; the provider asked to retry later";
+// The most CallTool attempts of any tool; a connector's own policy can only narrow it.
+const maximumToolAttempts = 3;
+const defectBranch = "defect";
+const uncertainBranch = "uncertain";
+/**
+ * Returns what a connector tool call records for one selected branch.
+ *
+ * The rules apply in this order. The manifest listing comes after the checks that can only tighten an outcome to
+ * `outcome_unknown`:
+ *
+ * 1. `uncertain` is `outcome_unknown`, whatever `agent.branches` says or whether it is declared required. It means
+ *    the write may have happened, so a listing of it as `rejected` is a manifest error.
+ * 2. A Mutation's `defect` is `outcome_unknown`, whatever `agent.branches` says or whether it is declared required.
+ *    The Connector SDK selects `defect` for some attempts that already called the provider, such as an invalid
+ *    attempt or an undeclared branch, and a host cannot tell those apart.
+ * 3. A required branch other than `defect` is `succeeded`.
+ * 4. On a Mutation, any other branch is `outcome_unknown` when `mayHaveDispatched` is set: its single-dispatch
+ *    fence cannot prove that no request reached the provider.
+ * 5. A branch that `agent.branches` lists as `rejected` is `rejected`.
+ * 6. A branch that `agent.branches` lists as `unknown` is `outcome_unknown`.
+ * 7. Any other optional branch of a Mutation is `outcome_unknown`.
+ * 8. Any other branch of a Query, including `defect`, is `failed`.
+ *
+ * The rule fails closed: an optional branch of a Mutation that the manifest does not classify is
+ * `outcome_unknown`, because the write may have happened.
+ *
+ * Changed in 0.5.0: added `mayHaveDispatched`. `agent.branches` no longer decides a Mutation's `defect`, which is
+ * `outcome_unknown` instead of `failed`. A Query's `defect` follows `agent.branches`.
+ *
+ * @example
+ * ```ts
+ * classifyConnectorBranch({ kind: "mutation", branch: "defect", requiredBranches: new Set(["refunded"]),
+ *   agentBranches: { defect: "rejected" } }); // "outcome_unknown"
+ * ```
+ * @param options - The operation kind, the selected branch, the required branches, `agent.branches`, and
+ * `mayHaveDispatched`: whether the attempt's single-dispatch fence checkpoints leave open that the request reached
+ * the provider, because this attempt claimed a send and no canResend followed, or the earlier attempt's checkpoint
+ * is missing, not a fence marker, malformed, foreign, or does not allow this attempt a send.
+ * {@link ConnectorToolSource} computes it. It defaults to `false`
+ * and applies only to a Mutation.
+ * @returns The outcome to record.
+ * @since 0.4.0
+ */
+export function classifyConnectorBranch(options) {
+    const { kind, branch, requiredBranches, agentBranches } = options;
+    if (branch === uncertainBranch || (kind === "mutation" && branch === defectBranch)) {
+        return "outcome_unknown";
+    }
+    if (branch !== defectBranch && requiredBranches.has(branch)) {
+        return "succeeded";
+    }
+    if (kind === "mutation" && options.mayHaveDispatched === true) {
+        return "outcome_unknown";
+    }
+    const listed = Object.hasOwn(agentBranches, branch) ? agentBranches[branch] : undefined;
+    if (listed === "rejected") {
+        return "rejected";
+    }
+    if (listed === "unknown" || kind === "mutation") {
+        return "outcome_unknown";
+    }
+    return "failed";
+}
+/**
+ * Offers one reviewed Connector operation to a built-in loop agent as a tool.
+ *
+ * The tool's name, description, and argument schema come from the operation's entry in its package's
+ * `dex-connector.json`. Only an operation whose entry says `agent.exposed: true` can become a tool; nothing is
+ * exposed by default, and the application still names each operation it offers.
+ *
+ * The manifest decides how the call runs. A Query is `read` and runs in `CallTool`. A Mutation with
+ * `agent.retry: safe` is `idempotent_write` and runs in `CallTool`, whose retries stay inside the operation's own
+ * Execute retry policy and timeout. Any other Mutation is `non_idempotent_write` and runs once in
+ * `CallSingleAttemptTool`. The effect always comes from the manifest; a session's `toolPolicies` entry for the
+ * tool changes only its approval.
+ *
+ * A call waits for `resolve_interrupt` when the manifest says `agent.approval: recommended`;
+ * {@link ConnectorToolOptions.requiresApproval} overrides that. Arguments that break the schema never run, so
+ * they never wait for approval.
+ *
+ * Changed in 0.5.0: the default tool name keeps an acronym run as one word, as the Connector library does:
+ * `listStoryIDs` becomes `list_story_ids`, not `list_story_i_d_s`.
+ *
+ * @example
+ * ```ts
+ * import manifest from "@superdurable/connector-stripe/dex-connector.json" with { type: "json" };
+ * import { CreateRefundInputSchema, newProjectConnection } from "@superdurable/connector-stripe";
+ *
+ * const stripe = newProjectConnection(project, "billing-stripe");
+ * const refund = connectorTool(stripe.operations.createRefund(), stripe.reference, {
+ *   manifest,
+ *   inputValidator: CreateRefundInputSchema,
+ *   requiresApproval: (args) => Number(args["amount"]) > 5000,
+ * });
+ * const source = new ConnectorToolSource([refund]);
+ * ```
+ * @typeParam Input - The operation's input type.
+ * @typeParam Output - The operation's result value type.
+ * @param operation - The connector operation, a Query or a Mutation.
+ * @param connection - The logical connection reference the call runs with. Only the reference is stored; the
+ * Worker resolves credentials.
+ * @param options - The manifest, the input validator, and the application's choices.
+ * @returns The tool.
+ * @throws {TypeError} When the manifest has no entry for the operation, the entry is not `agent.exposed: true`,
+ * its kind differs from the operation's, its `agent` block holds an unknown value or lists a branch it may not,
+ * or its `inputSchema` uses a keyword the agent core cannot check.
+ * @throws {RangeError} When `maxResultBytes` is not positive.
+ * @since 0.4.0
+ */
+export function connectorTool(operation, connection, options) {
+    const definition = operation.definition();
+    const isMutation = typeof operation.idempotencyKey === "function";
+    const kind = isMutation ? "mutation" : "query";
+    const { connectorId, operationId } = definition.operation;
+    const label = `${connectorId} ${operationId}`;
+    const manifest = options.manifest;
+    if (manifest.connectorId !== connectorId) {
+        throw new TypeError(`${label}: the manifest describes Connector ${String(manifest.connectorId)}`);
+    }
+    const factory = manifest.factories.find((entry) => entry.operationId === operationId);
+    if (factory === undefined) {
+        throw new TypeError(`${label}: the manifest has no entry for this operation`);
+    }
+    const agent = factory.agent;
+    if (typeof agent !== "object" || agent === null || agent.exposed !== true) {
+        throw new TypeError(`${label} is not exposed to agents: its manifest lacks agent.exposed: true`);
+    }
+    if (factory.kind !== kind) {
+        throw new TypeError(`${label}: the manifest says ${String(factory.kind)}, the operation is a ${kind}`);
+    }
+    const { approval, retry } = agent;
+    const branches = agent.branches ?? {};
+    if (approval !== undefined && approval !== "recommended") {
+        throw new TypeError(`${label}: unknown agent.approval ${JSON.stringify(approval)}`);
+    }
+    if ((retry !== undefined && retry !== "safe") || (retry !== undefined && kind === "query")) {
+        throw new TypeError(`${label}: unknown agent.retry ${JSON.stringify(retry)}`);
+    }
+    if (typeof branches !== "object" ||
+        branches === null ||
+        Array.isArray(branches) ||
+        Object.values(branches).some((value) => value !== "rejected" && value !== "unknown")) {
+        throw new TypeError(`${label}: agent.branches values must be rejected or unknown`);
+    }
+    const agentBranches = branches;
+    const optionalBranches = new Set(definition.branches.filter((branch) => branch.optional === true).map((branch) => branch.id));
+    if (Object.keys(agentBranches).some((branch) => !optionalBranches.has(branch))) {
+        throw new TypeError(`${label}: agent.branches may list only optional branches`);
+    }
+    if (kind === "query" && Object.values(agentBranches).includes("unknown")) {
+        throw new TypeError(`${label}: agent.branches unknown is for Mutations only`);
+    }
+    const schema = factory.inputSchema;
+    if (typeof schema !== "object" || schema === null) {
+        throw new TypeError(`${label}: the manifest has no inputSchema`);
+    }
+    checkConnectorInputSchema(schema);
+    if (options.maxResultBytes !== undefined && !(options.maxResultBytes >= 1)) {
+        throw new RangeError("maxResultBytes must be positive");
+    }
+    const effect = kind === "query" ? "read" : retry === "safe" ? "idempotent_write" : "non_idempotent_write";
+    const inputValidator = options.inputValidator;
+    const toolName = options.name ?? `${connectorId}_${lowerCamelToSnake(operationId)}`;
+    const invoke = async (call, toolArguments) => {
+        const parsed = inputValidator.safeParse(toolArguments);
+        if (!parsed.success) {
+            // A fixed text: validator messages differ between languages and versions.
+            throw new ToolExecutionError(`invalid arguments for ${toolName}: arguments do not decode`);
+        }
+        return isMutation
+            ? runMutation(operation, call, parsed.data)
+            : runQuery(operation, call, parsed.data);
+    };
+    const timeout = definition.stepDefaults.executeMethodTimeoutMs;
+    return {
+        name: toolName,
+        description: options.description ?? factory.description ?? "",
+        inputSchema: schema,
+        connectorId,
+        operationId,
+        kind,
+        effect,
+        isApprovalRecommended: approval === "recommended",
+        requiresApproval: options.requiresApproval,
+        maxResultBytes: options.maxResultBytes,
+        connection,
+        agentBranches: { ...agentBranches },
+        requiredBranches: new Set(definition.branches.filter((branch) => branch.optional !== true).map((branch) => branch.id)),
+        executeMethodTimeout: timeout === undefined || timeout === 0 ? undefined : timeout,
+        retryPolicy: boundedRetryPolicy(definition.stepDefaults.executeRetry ?? defaultConnectorStepExecuteRetryPolicy()),
+        invoke,
+    };
+}
+/**
+ * Offers reviewed Connector operations to a built-in loop agent as tools.
+ *
+ * Put it in `AgentDefinition.toolSources`, as `McpToolSource` is. It lists exactly the tools the application
+ * passes; no Connector is exposed by default. Each call runs one operation invocation in its own tool Step, through
+ * the Connector SDK's `runQuery` or `runMutation`, so the connector's Call ID, idempotency key, credential
+ * handling, and single-dispatch fence apply. The Call ID is derived from the Flow ID and the tool Step's execution
+ * ID, so it is the same on every attempt of that Step.
+ *
+ * Before anything runs, the model's arguments are checked against the manifest's `inputSchema` and then decoded
+ * with the package's input validator. Either failure is a `failed` call the model can correct; the operation never
+ * runs.
+ *
+ * Connector writes of one model response run one at a time in the model's order, and reads run in parallel. A
+ * write whose approval is needed waits for it only when its turn comes. Once a write does not succeed, the later
+ * writes of that response are recorded `failed` with `skipped` set.
+ *
+ * The selected branch maps as {@link classifyConnectorBranch} describes. A connector retry throws through the
+ * Step, so the tool Step's retry policy applies. A single-attempt write that asks to retry ends `outcome_unknown`,
+ * unless its single-dispatch fence saved a `notSent` or `canResend` marker in this attempt: that proves the
+ * provider did not process the request, so the call records `failed` with {@link connectorNotSentRetryLater}.
+ * Either way it stops the later writes. A result longer than `maxResultBytes` reaches the model truncated, with
+ * {@link connectorResultTruncatedNote}, and the record's `truncatedOutputBytes` holds the full size.
+ *
+ * Install `@superdurable/connectors-sdk` next to this package; it is an optional peer dependency.
+ *
+ * @example
+ * ```ts
+ * const flow = createBuiltinAgentSessionFlow(
+ *   { name: "support", instructions: "You help customers.", model,
+ *     toolSources: [new ConnectorToolSource([refund, reply])] },
+ *   "SupportAgent",
+ * );
+ * ```
+ * @since 0.4.0
+ */
+export class ConnectorToolSource {
+    /** The source's stable name, stored with each call; keep it across deploys. */
+    sourceName;
+    toolsByName;
+    definitions;
+    maxResultBytes;
+    /**
+     * Creates the source.
+     * @param tools - The tools to offer, in the order the model sees them.
+     * @param options - `sourceName`, default {@link defaultConnectorSourceName}, and `maxResultBytes`, default
+     * {@link defaultConnectorResultMaxBytes}.
+     * @throws {TypeError} When two tools share a name or `sourceName` is blank.
+     * @throws {RangeError} When `maxResultBytes` is not positive.
+     */
+    constructor(tools, options = {}) {
+        const sourceName = options.sourceName ?? defaultConnectorSourceName;
+        if (sourceName.trim() === "") {
+            throw new TypeError("sourceName must not be blank");
+        }
+        const maxResultBytes = options.maxResultBytes ?? defaultConnectorResultMaxBytes;
+        if (!(maxResultBytes >= 1)) {
+            throw new RangeError("maxResultBytes must be positive");
+        }
+        this.toolsByName = new Map(tools.map((tool) => [tool.name, tool]));
+        if (this.toolsByName.size !== tools.length) {
+            throw new TypeError("two connector tools share a name");
+        }
+        this.sourceName = sourceName;
+        this.maxResultBytes = maxResultBytes;
+        this.definitions = tools.map((tool) => ({
+            name: tool.name,
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+        }));
+    }
+    /**
+     * Returns the tools; the list is fixed when the source is built.
+     * @returns The tool definitions.
+     */
+    async listTools() {
+        return this.definitions;
+    }
+    /**
+     * Returns the tools without I/O.
+     * @returns The tool definitions.
+     */
+    cachedTools() {
+        return this.definitions;
+    }
+    /**
+     * Returns every tool name, so the runner refuses a collision.
+     * @returns The names.
+     */
+    declaredToolNames() {
+        return new Set(this.toolsByName.keys());
+    }
+    /**
+     * Builds the call with the manifest's effect and the call's approval.
+     * @param turn - The `RunModel` context; a `toolPolicies` entry for the tool changes only its approval.
+     * @param call - The model's tool call.
+     * @returns The deferred call, ordered when it is a write.
+     */
+    deferredToolCall(turn, call) {
+        const tool = this.requireTool(call.toolName);
+        const sessionPolicy = turn.toolPolicies !== undefined && Object.hasOwn(turn.toolPolicies, call.toolName)
+            ? turn.toolPolicies[call.toolName]
+            : undefined;
+        const requiresApproval = sessionPolicy?.requiresApproval ?? requiresApprovalOf(tool, call.arguments);
+        return {
+            toolCallId: call.toolCallId,
+            toolName: call.toolName,
+            arguments: call.arguments,
+            policy: { effect: tool.effect, requiresApproval },
+            toolSourceReference: serializeJsonWithSpacedSeparators({ tool: tool.name }),
+            ordered: tool.effect !== "read",
+        };
+    }
+    /**
+     * Returns the operation's timeout and retry policy for the call's tool Step.
+     * @param toolCall - The record whose tool Step starts.
+     * @returns The options, or `undefined` when this source no longer has the tool.
+     */
+    toolCallStepOptions(toolCall) {
+        const tool = this.toolsByName.get(referenceToolName(toolCall));
+        if (tool === undefined) {
+            return undefined;
+        }
+        return {
+            ...(tool.executeMethodTimeout === undefined ? {} : { executeMethodTimeout: tool.executeMethodTimeout }),
+            executeRetry: tool.retryPolicy,
+        };
+    }
+    /**
+     * Checks, decodes, and runs one call, then maps the selected branch.
+     * @param call - The approved call, with the tool Step's live context.
+     * @returns The result value as JSON text, bounded by `maxResultBytes`.
+     * @throws {ToolExecutionError} When the arguments break the schema or do not decode, the operation selected a
+     * `rejected` or failed branch, or a single-attempt write asked to retry after its fence recorded `notSent` or
+     * `canResend` in this attempt, which proves the provider did not process it ({@link connectorNotSentRetryLater}).
+     * @throws {ToolOutcomeUnknownError} When the operation selected an unknown branch.
+     * @throws {RangeError} When this source no longer has the tool, so the effect decides the outcome.
+     * @throws Any other error, such as a connector retry for the tool Step's retry policy.
+     */
+    async executeDeferredToolCall(call) {
+        const record = call.toolCall;
+        const tool = this.toolsByName.get(referenceToolName(record));
+        if (tool === undefined) {
+            throw new RangeError(`connector tool ${record.toolName} is not configured on this Worker`);
+        }
+        const toolArguments = parseToolArguments(tool.name, record.arguments);
+        const problem = findConnectorInputViolation(toolArguments, tool.inputSchema);
+        if (problem !== undefined) {
+            throw new ToolExecutionError(`invalid arguments for ${tool.name}: ${problem}`);
+        }
+        if (call.context === undefined) {
+            throw new Error("a connector tool call needs the tool Step's context");
+        }
+        const stepContext = new ConnectorStepContext(call.context, {
+            previousCheckpoint: call.heartbeatCheckpoint,
+            heartbeat: () => call.heartbeat(),
+            ...(call.saveHeartbeatCheckpoint === undefined
+                ? {}
+                : { saveCheckpoint: (checkpoint) => call.saveHeartbeatCheckpoint(checkpoint) }),
+        });
+        const connectorCall = createCall(stepContext, tool.connection, {
+            connectorId: tool.connectorId,
+            operationId: tool.operationId,
+        });
+        let result;
+        try {
+            result = await tool.invoke(connectorCall, toolArguments);
+        }
+        catch (error) {
+            if (error instanceof RetryError) {
+                if (tool.effect === "non_idempotent_write" && isProvenNotSent(connectorCall, stepContext)) {
+                    // One attempt only, so a Retry would record outcome_unknown though nothing was sent.
+                    throw new ToolExecutionError(notSentDetail(tool, error.failure));
+                }
+                throwDexRetry(error);
+            }
+            throw error;
+        }
+        const outcome = classifyConnectorBranch({
+            kind: tool.kind,
+            branch: result.branch,
+            requiredBranches: tool.requiredBranches,
+            agentBranches: tool.agentBranches,
+            mayHaveDispatched: mayHaveDispatched(connectorCall, stepContext),
+        });
+        if (outcome === "succeeded") {
+            return boundConnectorResult(encodeResultValue(result.value), tool.maxResultBytes ?? this.maxResultBytes);
+        }
+        const detail = branchDetail(tool, result.branch, result.failure);
+        if (outcome === "outcome_unknown") {
+            throw new ToolOutcomeUnknownError(detail);
+        }
+        throw new ToolExecutionError(detail);
+    }
+    /**
+     * Refuses a poll: connector tools never start tool tasks.
+     * @param poll - The call.
+     * @returns Never.
+     * @throws {RangeError} Always.
+     */
+    async pollToolTask(poll) {
+        throw new RangeError(`connector tool ${poll.toolCall.toolName} starts no task`);
+    }
+    requireTool(toolName) {
+        const tool = this.toolsByName.get(toolName);
+        if (tool === undefined) {
+            throw new RangeError(`connector tool ${toolName} is not configured on this Worker`);
+        }
+        return tool;
+    }
+}
+/**
+ * Returns `output` whole, or its first `maxResultBytes` bytes and {@link connectorResultTruncatedNote}.
+ * @param output - The full result text.
+ * @param maxResultBytes - The bound, in bytes of UTF-8 text, on the kept part.
+ * @returns The result, with `truncatedOutputBytes` set when it was cut.
+ * @since 0.4.0
+ */
+export function boundConnectorResult(output, maxResultBytes) {
+    const encoded = Buffer.from(output, "utf8");
+    if (encoded.length <= maxResultBytes) {
+        return { output };
+    }
+    let end = maxResultBytes;
+    // A cut inside a character drops its partial bytes, as Python's "ignore" decoding does.
+    while (end > 0 && ((encoded[end] ?? 0) & 0xc0) === 0x80) {
+        end -= 1;
+    }
+    const kept = encoded.subarray(0, end).toString("utf8");
+    const note = connectorResultTruncatedNote.replace("{total_bytes}", String(encoded.length));
+    return { output: `${kept}\n${note}`, truncatedOutputBytes: encoded.length };
+}
+/**
+ * Returns the text the model reads for one result value, the same in every core: keys sorted by code point, no
+ * spaces, unescaped UTF-8, and a number with no fractional part written as an integer.
+ * @param jsonText - The result value as JSON text.
+ * @returns The canonical text.
+ * @since 0.4.0
+ */
+export function formatConnectorResult(jsonText) {
+    return JSON.stringify(sortObjectKeys(JSON.parse(jsonText)));
+}
+function sortObjectKeys(value) {
+    if (Array.isArray(value)) {
+        return value.map(sortObjectKeys);
+    }
+    if (typeof value === "object" && value !== null) {
+        const record = value;
+        return Object.fromEntries(Object.keys(record)
+            .sort(compareCodePoints)
+            .map((key) => [key, sortObjectKeys(record[key])]));
+    }
+    return value;
+}
+function encodeResultValue(value) {
+    return value === undefined || value === null ? "null" : formatConnectorResult(JSON.stringify(value));
+}
+function requiresApprovalOf(tool, toolArguments) {
+    const choice = tool.requiresApproval;
+    if (choice === undefined) {
+        return tool.isApprovalRecommended;
+    }
+    if (typeof choice === "boolean") {
+        return choice;
+    }
+    let values;
+    try {
+        values = JSON.parse(toolArguments === "" ? "{}" : toolArguments);
+    }
+    catch {
+        return false;
+    }
+    if (!isRecord(values) || findConnectorInputViolation(values, tool.inputSchema) !== undefined) {
+        // The tool Step refuses these arguments before the operation runs.
+        return false;
+    }
+    try {
+        return Boolean(choice(values));
+    }
+    catch {
+        return true;
+    }
+}
+function parseToolArguments(toolName, toolArguments) {
+    let values;
+    try {
+        values = JSON.parse(toolArguments === "" ? "{}" : toolArguments);
+    }
+    catch {
+        throw new ToolExecutionError(`invalid arguments for ${toolName}: arguments are not valid JSON`);
+    }
+    if (!isRecord(values)) {
+        throw new ToolExecutionError(`invalid arguments for ${toolName}: expected a JSON object`);
+    }
+    return values;
+}
+/** Reports whether fence events leave open that the request was sent, as sdkgo does. */
+export function mayHaveDispatched(call, context) {
+    return observeFence(call, context).mayHaveDispatched;
+}
+/** Reports whether this attempt's fence recorded proof that the write was not sent. */
+export function isProvenNotSent(call, context) {
+    return observeFence(call, context).isProvenNotSent;
+}
+function observeFence(call, context) {
+    const evidence = readFenceEvidence(context, call.id);
+    const isClaimed = evidence?.isClaimed ?? false;
+    const hasNotSentProof = evidence?.hasNotSentProof ?? false;
+    const isPriorDispatchPossible = hasReadCheckpoint(context) && isPriorDispatchPossibleFor(call, context);
+    const isDispatchPossible = isClaimed || isPriorDispatchPossible;
+    return { mayHaveDispatched: isDispatchPossible, isProvenNotSent: hasNotSentProof && !isDispatchPossible };
+}
+/** Reports whether the earlier attempt's checkpoint denies this attempt a send. */
+function isPriorDispatchPossibleFor(call, context) {
+    const previousCheckpoint = readPreviousCheckpoint(context);
+    if (previousCheckpoint === undefined) {
+        // A lost checkpoint after attempt one may hide an earlier send.
+        return context.attempt > 1;
+    }
+    let previous;
+    try {
+        previous = JSON.parse(previousCheckpoint);
+    }
+    catch {
+        return true;
+    }
+    // Not a marker or malformed: the fence fails closed, and so does this.
+    const isSendAllowed = isFenceMarker(previous) &&
+        previous["callId"] === call.id &&
+        previous["attempt"] === context.attempt - 1 &&
+        (previous["state"] === "notSent" || previous["state"] === "canResend") &&
+        (previous["providerId"] === undefined || previous["providerId"] === "");
+    return !isSendAllowed;
+}
+function notSentDetail(tool, failure) {
+    const detail = `${tool.connectorId} ${tool.operationId} ${connectorNotSentRetryLater}`;
+    return failure === undefined ? detail : `${detail}: ${failure.kind}: ${failure.message}`;
+}
+function branchDetail(tool, branch, failure) {
+    const detail = `${tool.connectorId} ${tool.operationId} returned ${branch}`;
+    return failure === undefined ? detail : `${detail}: ${failure.kind}: ${failure.message}`;
+}
+function referenceToolName(record) {
+    try {
+        const reference = JSON.parse(record.toolSourceReference ?? "");
+        const name = isRecord(reference) ? reference["tool"] : undefined;
+        return typeof name === "string" ? name : record.toolName;
+    }
+    catch {
+        return record.toolName;
+    }
+}
+function boundedRetryPolicy(policy) {
+    const attempts = policy.maximumAttempts;
+    return {
+        initialIntervalMs: policy.initialIntervalMs,
+        backoffCoefficient: policy.backoffCoefficient,
+        maximumIntervalMs: policy.maximumIntervalMs,
+        maximumAttempts: attempts <= 0 ? maximumToolAttempts : Math.min(attempts, maximumToolAttempts),
+        totalDurationMs: policy.totalDurationMs,
+    };
+}
+/**
+ * Returns an operation ID in snake case, as connectorctl `lowerCamelToSnake` names the Python Step factories.
+ * @param operationId - The lower camel case operation ID, such as `listStoryIDs`.
+ * @returns The snake case name, such as `list_story_ids`.
+ */
+export function lowerCamelToSnake(operationId) {
+    const characters = Array.from(operationId);
+    let converted = "";
+    for (const [index, character] of characters.entries()) {
+        if (!isAsciiUpper(character)) {
+            converted += character;
+            continue;
+        }
+        const previous = characters[index - 1];
+        const following = characters[index + 1];
+        const isPreviousLowerOrDigit = isAsciiLower(previous) || isAsciiDigit(previous);
+        // A trailing lowercase s pluralizes the acronym, as in listStoryIDs.
+        const isAcronymPlural = following === "s" && !isAsciiLower(characters[index + 2]);
+        const isEndOfAcronym = isAsciiUpper(previous) && isAsciiLower(following) && !isAcronymPlural;
+        if (isPreviousLowerOrDigit || isEndOfAcronym) {
+            converted += "_";
+        }
+        converted += character.toLowerCase();
+    }
+    return converted;
+}
+function isAsciiUpper(character) {
+    return character !== undefined && character >= "A" && character <= "Z";
+}
+function isAsciiLower(character) {
+    return character !== undefined && character >= "a" && character <= "z";
+}
+function isAsciiDigit(character) {
+    return character !== undefined && character >= "0" && character <= "9";
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=connector-tool-source.js.map

package/dist/src/connectors/connector-tool-source.js.map

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

package/dist/src/connectors/index.d.ts

@@ -0,0 +1,3 @@
+export { ConnectorToolSource, boundConnectorResult, classifyConnectorBranch, connectorNotSentRetryLater, connectorResultTruncatedNote, connectorTool, defaultConnectorResultMaxBytes, defaultConnectorSourceName, formatConnectorResult, type ApprovalPredicate, type ConnectorBranchOutcome, type ConnectorInputValidator, type ConnectorManifestFactory, type ConnectorPackageManifest, type ConnectorTool, type ConnectorToolOptions, } from "./connector-tool-source.js";
+export { ConnectorStepContext, type ConnectorStepHeartbeats } from "./connector-step-context.js";
+export { checkConnectorInputSchema, findConnectorInputViolation } from "./connector-input-schema.js";