npm - @superdurable/dex-agents - Versions diffs - 0.4.0 → 0.5.0 - Mend

@superdurable/dex-agents 0.4.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (132) hide show

package/dist/src/{stepwise → builtin-loop}/model-client.d.ts RENAMED Viewed

@@ -1,13 +1,21 @@
-import type { AgentUsage } from "../agent-session-values.js";
+import type { AgentImageReference, AgentUsage } from "../agent-session-values.js";
 /**
  * User text in a model input, stored for a user message and for Dex notes such as the turn-failure note.
- * Wire shape: `{"type":"user_text","text"}`.
+ * Wire shape: `{"type":"user_text","text"}`, plus `"images"` when the message has images.
  */
 export interface ModelUserTextItem {
     /** Discriminator. Wire field: `type`. */
     readonly type: "user_text";
     /** The text. Wire field: `text`. */
     readonly text: string;
+    /**
+     * The images of a user message, after the text, in order. The item holds references only; the request's
+     * {@link ModelRequest.imageBytes} holds their bytes. Omitted or empty for a message without images and for every
+     * note Dex adds. Wire field: `images`, a list of snake_case image references, written only when non-empty.
+     *
+     * @since 0.5.0
+     */
+    readonly images?: readonly AgentImageReference[];
 }
 /** One tool call of a model response, in provider-neutral form. */
 export interface ModelToolCall {
@@ -44,7 +52,8 @@ export interface ModelOutputItem {
 }
 /**
  * The result of one tool call in a model input, in provider-neutral form.
- * Wire shape: `{"type":"tool_result","tool_call_id","tool_name","output"}`.
+ * Wire shape: `{"type":"tool_result","tool_call_id","tool_name","output"}`, plus `"images"` when the tool returned
+ * images.
  */
 export interface ModelToolResultItem {
     /** Discriminator. Wire field: `type`. */
@@ -55,9 +64,17 @@ export interface ModelToolResultItem {
     readonly toolName: string;
     /** Model-visible result text, from `describeToolCallOutcome`. Wire field: `output`. */
     readonly output: string;
+    /**
+     * The images the tool returned with {@link output}, from `AgentToolCall.images`, in order. The item holds
+     * references only; the request's {@link ModelRequest.imageBytes} holds their bytes. Wire field: `images`, written
+     * only when non-empty.
+     *
+     * @since 0.5.0
+     */
+    readonly images?: readonly AgentImageReference[];
 }
 /**
- * One item of a model input. The Stepwise runner stores each one as the `framework_item` of an
+ * One item of a model input. The built-in loop runner stores each one as the `framework_item` of an
  * `AgentMessage`, as snake_case JSON.
  */
 export type ModelInputItem = ModelUserTextItem | ModelOutputItem | ModelToolResultItem;
@@ -99,7 +116,7 @@ export interface ModelRequestMetadata {
     /** One-based attempt of the `RunModel` Step. */
     readonly attempt: number;
 }
-/** One model call, built by the Stepwise runner from committed session state only. */
+/** One model call, built by the built-in loop runner from committed session state only. */
 export interface ModelRequest {
     /** System instructions for this call. */
     readonly instructions: string;
@@ -115,6 +132,14 @@ export interface ModelRequest {
     readonly metadata: ModelRequestMetadata;
     /** Signal aborted when Dex cancels the attempt; pass it to the provider request. */
     readonly cancellationSignal: AbortSignal;
+    /**
+     * The bytes of every image of {@link inputItems}, keyed by `AgentImageReference.sha256`. The runner reads them
+     * from its media store right before `callModel`, so a client never reads a store. Omitted when the input has no
+     * images, and in the requests passed to `estimateInputTokens`, which count each image without its bytes.
+     *
+     * @since 0.5.0
+     */
+    readonly imageBytes?: ReadonlyMap<string, Uint8Array>;
 }
 /** Result of one model call. */
 export interface ModelResponse {
@@ -131,7 +156,7 @@ export interface ModelResponse {
     /** Provider finish reason, such as `"stop"` or `"tool-calls"`. */
     readonly finishReason: string;
 }
-/** Receives the live text of one model call; the Stepwise runner forwards it to `AgentEvents`. */
+/** Receives the live text of one model call; the built-in loop runner forwards it to `AgentEvents`. */
 export interface ModelOutputWriter {
     /**
      * Writes visible text as a `text_delta` event.
@@ -145,7 +170,7 @@ export interface ModelOutputWriter {
     writeReasoningDelta(text: string): void;
 }
 /**
- * Makes one model call for the Stepwise runner.
+ * Makes one model call for the built-in loop runner.
  *
  * Use `createAiSdkModelClient` from `@superdurable/dex-agents/ai-sdk` for any AI SDK provider, or
  * implement this interface for another model API. Every client follows these rules:
@@ -158,6 +183,10 @@ export interface ModelOutputWriter {
  *   thinking signatures or encrypted reasoning, from display text.
  * - Dex-authored items, {@link ModelUserTextItem} and {@link ModelToolResultItem}, are converted at call
  *   time. An item from another provider or API is replayed as its text and tool calls.
+ * - Images. A user text or tool result item may carry `images`. A client that sends images converts each one to
+ *   the provider's image part, with its bytes from {@link ModelRequest.imageBytes}, and throws when they are
+ *   missing. A client that ignores `images` shows the model the text only. The runner sends images only when it
+ *   has a media store; see `BuiltinLoopAgentRunner`.
  *
  * @example
  * ```ts

package/dist/src/builtin-loop/model-client.js.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"model-client.js","sourceRoot":"","sources":["../../../src/builtin-loop/model-client.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,kDAAkD;AAClD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,0DAA0D"}

package/dist/src/{stepwise → builtin-loop}/scripted-model-client.d.ts RENAMED Viewed

@@ -29,12 +29,12 @@ export interface ScriptedModelReply {
 /** The script: a function from the whole request to the reply. */
 export type ScriptedModelResponder = (request: ModelRequest) => ScriptedModelReply | Promise<ScriptedModelReply>;
 /**
- * A Stepwise {@link ModelClient} that answers every model call from a script, for demos and tests without a
+ * A built-in agent loop {@link ModelClient} that answers every model call from a script, for demos and tests without a
  * model key. It mirrors the Python core's `ScriptedModelClient`.
  *
- * Use it as `AgentDefinition.model` to run a Stepwise agent with no provider account: a local demo
+ * Use it as `AgentDefinition.model` to run a built-in loop agent with no provider account: a local demo
  * mode of an application, a tutorial, or an integration test. It is a supported part of
- * `@superdurable/dex-agents/stepwise` and needs no optional peer. `@superdurable/dex-agents/testing`
+ * `@superdurable/dex-agents/builtin-loop` and needs no optional peer. `@superdurable/dex-agents/testing`
  * exports the same class.
  *
  * The script is a function of the whole {@link ModelRequest}, so it can read the user text, with
@@ -50,7 +50,7 @@ export type ScriptedModelResponder = (request: ModelRequest) => ScriptedModelRep
  *   ScriptedModelClient.toolResults(request).length > 0
  *     ? { text: "done" }
  *     : { toolCalls: [{ toolName: "lookup_order", arguments: { order_id: "7" } }] });
- * const flow = createStepwiseAgentSessionFlow(
+ * const flow = createBuiltinAgentSessionFlow(
  *   { name: "demo", instructions: "Help.", model, tools: [lookupOrder] }, "DemoAgent");
  * ```
  */
@@ -92,8 +92,11 @@ export declare class ScriptedModelClient implements ModelClient {
     static userTexts(request: ModelRequest): string[];
     /**
      * Returns the tool results after the last user item of a request.
+     *
+     * A continuation message from `decideTurnContinuation` is a user item too. After one, this returns only the
+     * results that follow it, so a script that decides from these results must also read the earlier ones itself.
      * @param request - The request.
-     * @returns The current turn's tool results, oldest first.
+     * @returns The tool results after the last user item, oldest first.
      */
     static toolResults(request: ModelRequest): ModelToolResultItem[];
 }

package/dist/src/{stepwise → builtin-loop}/scripted-model-client.js RENAMED Viewed

@@ -13,12 +13,12 @@ export const scriptedModelApi = "scripted";
 /** Default number of latest requests {@link ScriptedModelClient.requests} keeps. */
 export const defaultMaxRecordedRequests = 100;
 /**
- * A Stepwise {@link ModelClient} that answers every model call from a script, for demos and tests without a
+ * A built-in agent loop {@link ModelClient} that answers every model call from a script, for demos and tests without a
  * model key. It mirrors the Python core's `ScriptedModelClient`.
  *
- * Use it as `AgentDefinition.model` to run a Stepwise agent with no provider account: a local demo
+ * Use it as `AgentDefinition.model` to run a built-in loop agent with no provider account: a local demo
  * mode of an application, a tutorial, or an integration test. It is a supported part of
- * `@superdurable/dex-agents/stepwise` and needs no optional peer. `@superdurable/dex-agents/testing`
+ * `@superdurable/dex-agents/builtin-loop` and needs no optional peer. `@superdurable/dex-agents/testing`
  * exports the same class.
  *
  * The script is a function of the whole {@link ModelRequest}, so it can read the user text, with
@@ -34,7 +34,7 @@ export const defaultMaxRecordedRequests = 100;
  *   ScriptedModelClient.toolResults(request).length > 0
  *     ? { text: "done" }
  *     : { toolCalls: [{ toolName: "lookup_order", arguments: { order_id: "7" } }] });
- * const flow = createStepwiseAgentSessionFlow(
+ * const flow = createBuiltinAgentSessionFlow(
  *   { name: "demo", instructions: "Help.", model, tools: [lookupOrder] }, "DemoAgent");
  * ```
  */
@@ -127,8 +127,11 @@ export class ScriptedModelClient {
     }
     /**
      * Returns the tool results after the last user item of a request.
+     *
+     * A continuation message from `decideTurnContinuation` is a user item too. After one, this returns only the
+     * results that follow it, so a script that decides from these results must also read the earlier ones itself.
      * @param request - The request.
-     * @returns The current turn's tool results, oldest first.
+     * @returns The tool results after the last user item, oldest first.
      */
     static toolResults(request) {
         let results = [];

package/dist/src/builtin-loop/scripted-model-client.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"scripted-model-client.js","sourceRoot":"","sources":["../../../src/builtin-loop/scripted-model-client.ts"],"names":[],"mappings":"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"}

package/dist/src/{stepwise → builtin-loop}/tool-source.d.ts RENAMED Viewed

@@ -16,7 +16,7 @@ export interface SourceToolDefinition {
     readonly inputSchema: Readonly<Record<string, unknown>>;
 }
 /**
- * Tools that a Stepwise agent lists at run time, such as an MCP server's tools, run one tool Step per call.
+ * Tools that a built-in loop agent lists at run time, such as an MCP server's tools, run one tool Step per call.
  *
  * Put a source in `AgentDefinition.toolSources`. `McpToolSource` from `@superdurable/dex-agents/mcp`
  * implements it. In every `RunModel` of a chat or executing turn, the runner awaits {@link listTools} and
@@ -39,7 +39,7 @@ export interface SourceToolDefinition {
  * @example
  * ```ts
  * const tools = new McpToolSource([{ name: "files", transport: "stdio", command: "mcp-files" }]);
- * const flow = createStepwiseAgentSessionFlow(
+ * const flow = createBuiltinAgentSessionFlow(
  *   { name: "files", instructions: "You manage reports.", model, toolSources: [tools] },
  *   "FilesAgent",
  * );

package/dist/src/builtin-loop/tool-source.js.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"tool-source.js","sourceRoot":"","sources":["../../../src/builtin-loop/tool-source.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,kDAAkD;AAClD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,0DAA0D"}

package/dist/src/connectors/connector-input-schema.js CHANGED Viewed

@@ -6,7 +6,7 @@
 //
 // SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
 // Checks the JSON Schema subset of Connector `inputSchema` values with the Python core's messages.
-import { serializeJsonWithSpacedSeparators } from "../stepwise/json-schema-validation.js";
+import { serializeJsonWithSpacedSeparators } from "../builtin-loop/json-schema-validation.js";
 // Keywords that constrain a value; an unlisted keyword refuses the tool, so nothing is unchecked.
 const checkedKeywords = new Set([
     "type",

package/dist/src/connectors/connector-input-schema.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"connector-input-schema.js","sourceRoot":"","sources":["../../../src/connectors/connector-input-schema.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,kDAAkD;AAClD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,0DAA0D;AAE1D,mGAAmG;AAEnG,OAAO,EAAE,iCAAiC,EAAE,MAAM,~~uCAAuC~~,CAAC;~~AAI1F~~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"}
1	+ {"version":3,"file":"connector-input-schema.js","sourceRoot":"","sources":["../../../src/connectors/connector-input-schema.ts"],"names":[],"mappings":"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"}

package/dist/src/connectors/connector-step-context.d.ts CHANGED Viewed

@@ -1,6 +1,23 @@
 import type { AsyncContext } from "@superdurable/dex";
-/** Returns the last heartbeat value this context saved in this attempt, or `undefined`. Internal to the core. */
-export declare function readSavedHeartbeatValue(context: ConnectorStepContext): unknown;
+/** What one call's saved fence markers in this attempt prove; a later checkpoint cannot erase it. Internal. */
+export interface FenceEvidence {
+    /** A claim stands: no valid `canResend` followed it. */
+    isClaimed: boolean;
+    /** The attempt claimed a send at some point. */
+    hasClaimed: boolean;
+    /** A claim recorded a provider ID. */
+    hasProviderId: boolean;
+    /** A `notSent` before any claim, or a valid `canResend`. */
+    hasNotSentProof: boolean;
+}
+/** Returns the evidence of one call's saved fence markers in this attempt, or `undefined`. Internal to the core. */
+export declare function readFenceEvidence(context: ConnectorStepContext, callId: string): Readonly<FenceEvidence> | undefined;
+/** Reports whether a value is a single-dispatch fence marker with only its declared fields. Internal to the core. */
+export declare function isFenceMarker(value: unknown): value is Readonly<Record<string, unknown>>;
+/** Returns the text checkpoint an earlier attempt saved, or `undefined`. Internal to the core. */
+export declare function readPreviousCheckpoint(context: ConnectorStepContext): string | undefined;
+/** Reports whether the operation asked this context for an earlier attempt's checkpoint. Internal to the core. */
+export declare function hasReadCheckpoint(context: ConnectorStepContext): boolean;
 /** How a {@link ConnectorStepContext} reaches the tool Step's heartbeats. */
 export interface ConnectorStepHeartbeats {
     /** The text checkpoint an earlier attempt of the tool Step saved, or `undefined`. */

package/dist/src/connectors/connector-step-context.js CHANGED Viewed

@@ -7,10 +7,63 @@
 // SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
 import { compareCodePoints } from "./connector-input-schema.js";
 // The source reads it on a Retry; a failed save leaves the earlier value.
-const savedHeartbeatValues = new WeakMap();
-/** Returns the last heartbeat value this context saved in this attempt, or `undefined`. Internal to the core. */
-export function readSavedHeartbeatValue(context) {
-    return savedHeartbeatValues.get(context);
+const fenceEvidence = new WeakMap();
+const fenceMarkerKeys = new Set(["callId", "attempt", "state", "providerId"]);
+/** Returns the evidence of one call's saved fence markers in this attempt, or `undefined`. Internal to the core. */
+export function readFenceEvidence(context, callId) {
+    return fenceEvidence.get(context)?.get(callId);
+}
+/** Reports whether a value is a single-dispatch fence marker with only its declared fields. Internal to the core. */
+export function isFenceMarker(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return false;
+    }
+    const record = value;
+    return (Object.keys(record).every((key) => fenceMarkerKeys.has(key)) &&
+        typeof record["callId"] === "string" &&
+        typeof record["attempt"] === "number" &&
+        Number.isInteger(record["attempt"]) &&
+        record["attempt"] >= 1 &&
+        (record["state"] === "notSent" || record["state"] === "claimed" || record["state"] === "canResend") &&
+        (record["providerId"] === undefined || typeof record["providerId"] === "string"));
+}
+function observeSavedHeartbeatValue(context, value) {
+    if (!isFenceMarker(value) || value["attempt"] !== context.attempt) {
+        return;
+    }
+    const callId = value["callId"];
+    const byCall = fenceEvidence.get(context) ?? new Map();
+    fenceEvidence.set(context, byCall);
+    const evidence = byCall.get(callId) ?? { isClaimed: false, hasClaimed: false, hasProviderId: false, hasNotSentProof: false };
+    byCall.set(callId, evidence);
+    const hasMarkerProviderId = value["providerId"] !== undefined && value["providerId"] !== "";
+    if (value["state"] === "claimed") {
+        evidence.isClaimed = true;
+        evidence.hasClaimed = true;
+        evidence.hasProviderId ||= hasMarkerProviderId;
+        evidence.hasNotSentProof = false;
+    }
+    else if (value["state"] === "canResend") {
+        // The fence allows canResend only after its own claim without a provider ID.
+        if (evidence.isClaimed && !evidence.hasProviderId && !hasMarkerProviderId) {
+            evidence.isClaimed = false;
+            evidence.hasNotSentProof = true;
+        }
+    }
+    else if (value["state"] === "notSent" && !evidence.hasClaimed && !hasMarkerProviderId) {
+        evidence.hasNotSentProof = true;
+    }
+}
+const previousCheckpoints = new WeakMap();
+/** Returns the text checkpoint an earlier attempt saved, or `undefined`. Internal to the core. */
+export function readPreviousCheckpoint(context) {
+    return previousCheckpoints.get(context);
+}
+// The source reads it to tell a lost fence checkpoint from an unfenced operation.
+const checkpointReaders = new WeakSet();
+/** Reports whether the operation asked this context for an earlier attempt's checkpoint. Internal to the core. */
+export function hasReadCheckpoint(context) {
+    return checkpointReaders.has(context);
 }
 /**
  * The Step context a connector operation sees inside an agent tool Step, with heartbeat values kept as text.
@@ -35,6 +88,7 @@ export class ConnectorStepContext {
     constructor(context, heartbeats) {
         this.context = context;
         this.heartbeats = heartbeats;
+        previousCheckpoints.set(this, heartbeats.previousCheckpoint);
     }
     /** The Flow ID. */
     get flowId() {
@@ -65,6 +119,7 @@ export class ConnectorStepContext {
      * @returns `true` when the session read a checkpoint for this attempt.
      */
     hasLastHeartbeatValue() {
+        checkpointReaders.add(this);
         return this.heartbeats.previousCheckpoint !== undefined;
     }
     /**
@@ -78,6 +133,7 @@ export class ConnectorStepContext {
         if (codec !== undefined) {
             throw new TypeError("ConnectorStepContext keeps heartbeat values as JSON and takes no codec");
         }
+        checkpointReaders.add(this);
         const previous = this.heartbeats.previousCheckpoint;
         return previous === undefined ? undefined : JSON.parse(previous);
     }
@@ -101,7 +157,7 @@ export class ConnectorStepContext {
             throw new TypeError("this tool Step cannot save heartbeat checkpoints");
         }
         await this.heartbeats.saveCheckpoint(stringifyWithSortedKeys(value));
-        savedHeartbeatValues.set(this, value);
+        observeSavedHeartbeatValue(this, value);
     }
 }
 /** Returns compact JSON with object keys sorted by code point, the text the Python core stores. */

package/dist/src/connectors/connector-step-context.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"connector-step-context.js","sourceRoot":"","sources":["../../../src/connectors/connector-step-context.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,kDAAkD;AAClD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,0DAA0D;AAI1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;~~AAEhE~~,0EAA0E;AAC1E,MAAM,~~oBAAoB~~,GAAG,IAAI,OAAO,~~EAAiC~~,CAAC;~~AAE1E~~,~~iHAAiH~~;~~AACjH~~,MAAM,UAAU,~~uBAAuB~~,CAAC,OAA6B;~~IACnE~~,OAAO,~~oBAAoB~~,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;~~AAC3C~~,CAAC;AAmBD;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,oBAAoB;IAOZ;IACA;IAPnB;;;;OAIG;IACH,YACmB,OAAqB,EACrB,UAAmC;QADnC,YAAO,GAAP,OAAO,CAAc;QACrB,eAAU,GAAV,UAAU,CAAyB;~~IACnD~~,CAAC;~~IAEJ~~,mBAAmB;IACnB,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED,uBAAuB;IACvB,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;IAC5B,CAAC;IAED,+DAA+D;IAC/D,IAAW,eAAe;QACxB,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC;IACtC,CAAC;IAED,6BAA6B;IAC7B,IAAW,OAAO;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;IAC9B,CAAC;IAED,8CAA8C;IAC9C,IAAW,QAAQ;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC/B,CAAC;IAED,yDAAyD;IACzD,IAAW,kBAAkB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC;IACzC,CAAC;IAED;;;OAGG;IACI,qBAAqB;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,kBAAkB,KAAK,SAAS,CAAC;IAC1D,CAAC;IAED;;;;;;OAMG;IACI,qBAAqB,CAAc,KAAe;QACvD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,SAAS,CAAC,wEAAwE,CAAC,CAAC;QAChG,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC;QACpD,OAAO,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAO,CAAC;IAC1E,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,eAAe,CAAI,KAAS,EAAE,KAAe;QACxD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,SAAS,CAAC,wEAAwE,CAAC,CAAC;QAChG,CAAC;QACD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC;YAClC,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;YACjD,MAAM,IAAI,SAAS,CAAC,kDAAkD,CAAC,CAAC;QAC1E,CAAC;QACD,MAAM,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC,CAAC;QACrE,~~oBAAoB~~,CAAC,~~GAAG,CAAC,~~IAAI,EAAE,KAAK,CAAC,CAAC;~~IACxC~~,CAAC;CACF;AAED,mGAAmG;AACnG,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,KAA0C,CAAC;QAC1D,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;aAChB,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC;aAC1C,IAAI,CAAC,iBAAiB,CAAC;aACvB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAC9C,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
1	+ {"version":3,"file":"connector-step-context.js","sourceRoot":"","sources":["../../../src/connectors/connector-step-context.ts"],"names":[],"mappings":"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"}

package/dist/src/connectors/connector-tool-source.d.ts CHANGED Viewed

@@ -2,7 +2,7 @@ import type { RetryPolicy } from "@superdurable/dex";
 import { type Call, type ConnectionRef, type Mutation, type Query, type QueryResult } from "@superdurable/connectors-sdk";
 import { type AgentTurnContext, type DeferredToolCall, type DeferredToolExecution, type ToolCallStepOptions, type ToolExecutionResult, type ToolTaskPoll, type ToolTaskPollOutcome } from "../agent-framework-runner.js";
 import type { AgentToolCall, ToolEffect } from "../agent-session-values.js";
-import type { SourceToolDefinition, ToolSource } from "../stepwise/tool-source.js";
+import type { SourceToolDefinition, ToolSource } from "../builtin-loop/tool-source.js";
 import { ConnectorStepContext } from "./connector-step-context.js";
 /**
  * Default {@link ConnectorToolSource.sourceName}.
@@ -37,9 +37,14 @@ export type ApprovalPredicate = (toolArguments: Readonly<Record<string, unknown>
  * - `succeeded`: a required branch, such as `sent` or `refunded`. The model reads the result value.
  * - `rejected`: a branch the manifest lists as `rejected` under `agent.branches`, such as `providerRejected`.
  *   Nothing took effect. The record is `failed` with an error the model reads, and the session continues.
- * - `failed`: `defect`, or an optional branch of a Query that `agent.branches` does not list.
- * - `outcome_unknown`: `uncertain`, a branch listed as `unknown`, or an optional branch of a Mutation that
- *   `agent.branches` does not list. The write may have taken effect.
+ * - `failed`: an optional branch of a Query that `agent.branches` does not list, including `defect`.
+ * - `outcome_unknown`: `uncertain`, a Mutation's `defect`, any optional branch of a Mutation whose single-dispatch
+ *   fence cannot prove that nothing was sent, a branch listed as `unknown`, or an optional branch of a Mutation
+ *   that `agent.branches` does not list. The write may have taken effect.
+ *
+ * Changed in 0.5.0: a Mutation's `defect` is always `outcome_unknown`, because the Connector SDK can select it
+ * after the provider was called. A Query's `defect` follows `agent.branches`. A fenced Mutation whose fence cannot
+ * prove that nothing was sent is `outcome_unknown` on any optional branch.
  * @since 0.4.0
  */
 export type ConnectorBranchOutcome = "succeeded" | "rejected" | "failed" | "outcome_unknown";
@@ -107,7 +112,14 @@ export interface ConnectorToolOptions<Input> {
     readonly manifest: ConnectorPackageManifest;
     /** The validator the package exports for the operation's input, such as `CreateRefundInputSchema`. */
     readonly inputValidator: ConnectorInputValidator<Input>;
-    /** Tool name; defaults to `<connectorId>_<operation in snake case>`, such as `stripe_create_refund`. */
+    /**
+     * Tool name; defaults to `<connectorId>_<operation in snake case>`, such as `stripe_create_refund`. The snake
+     * case is the one the Connector library uses for Python Step factory names: an acronym run stays one word, so
+     * `listStoryIDs` becomes `list_story_ids` and `getHTTPResponse` becomes `get_http_response`.
+     *
+     * Changed in 0.5.0: the default keeps an acronym run as one word; it used to split `listStoryIDs` into
+     * `list_story_i_d_s`.
+     */
     readonly name?: string;
     /** Model-facing description; defaults to the manifest's. */
     readonly description?: string;
@@ -120,7 +132,7 @@ export interface ConnectorToolOptions<Input> {
     readonly maxResultBytes?: number;
 }
 /**
- * One Connector operation offered to a Stepwise agent as a tool. Create it with {@link connectorTool}.
+ * One Connector operation offered to a built-in loop agent as a tool. Create it with {@link connectorTool}.
  * @since 0.4.0
  */
 export interface ConnectorTool {
@@ -163,15 +175,39 @@ export interface ConnectorTool {
 /**
  * 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: "invalidResponse", requiredBranches: new Set(["refunded"]),
- *   agentBranches: {} }); // "outcome_unknown"
+ * 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, and `agent.branches`.
+ * @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
  */
@@ -180,9 +216,10 @@ export declare function classifyConnectorBranch(options: {
     readonly branch: string;
     readonly requiredBranches: ReadonlySet<string>;
     readonly agentBranches: Readonly<Record<string, string>>;
+    readonly mayHaveDispatched?: boolean;
 }): ConnectorBranchOutcome;
 /**
- * Offers one reviewed Connector operation to a Stepwise agent as a tool.
+ * 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
@@ -198,6 +235,9 @@ export declare function classifyConnectorBranch(options: {
  * {@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" };
@@ -226,7 +266,7 @@ export declare function classifyConnectorBranch(options: {
  */
 export declare function connectorTool<Input, Output>(operation: Query<Input, Output> | Mutation<Input, Output>, connection: ConnectionRef, options: ConnectorToolOptions<Input>): ConnectorTool;
 /**
- * Offers reviewed Connector operations to a Stepwise agent as tools.
+ * 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
@@ -253,7 +293,7 @@ export declare function connectorTool<Input, Output>(operation: Query<Input, Out
  *
  * @example
  * ```ts
- * const flow = createStepwiseAgentSessionFlow(
+ * const flow = createBuiltinAgentSessionFlow(
  *   { name: "support", instructions: "You help customers.", model,
  *     toolSources: [new ConnectorToolSource([refund, reply])] },
  *   "SupportAgent",
@@ -349,5 +389,13 @@ export declare function boundConnectorResult(output: string, maxResultBytes: num
  * @since 0.4.0
  */
 export declare function formatConnectorResult(jsonText: string): string;
-/** Reports whether this attempt's last saved fence marker proves the write was not sent. */
+/** Reports whether fence events leave open that the request was sent, as sdkgo does. */
+export declare function mayHaveDispatched(call: Call, context: ConnectorStepContext): boolean;
+/** Reports whether this attempt's fence recorded proof that the write was not sent. */
 export declare function isProvenNotSent(call: Call, context: ConnectorStepContext): boolean;
+/**
+ * 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 declare function lowerCamelToSnake(operationId: string): string;