@adonis-agora/agent 0.1.0

package/dist/src/testing/in-memory-store.js

@@ -0,0 +1,317 @@
+/** A fully in-memory `AgentStore` for tests and the offline demo. */
+export class InMemoryAgentStore {
+    threads = new Map();
+    toolCalls = new Map();
+    usage = [];
+    runs = new Map();
+    /** messageId → runId, so run-detail can gather a run's messages without mutating `StoredMessage`. */
+    messageRunIds = new Map();
+    now() {
+        return new Date().toISOString();
+    }
+    async createThread(input) {
+        const id = crypto.randomUUID();
+        const ts = this.now();
+        const row = {
+            id,
+            actorRef: input.actor.id,
+            title: input.title ?? 'New chat',
+            persona: input.persona,
+            transient: input.transient ?? false,
+            createdAt: ts,
+            updatedAt: ts,
+            messages: [],
+        };
+        this.threads.set(id, row);
+        return this.toSummary(row);
+    }
+    async getThread(threadId) {
+        const row = this.threads.get(threadId);
+        if (row === undefined) {
+            return null;
+        }
+        return {
+            ...this.toSummary(row),
+            messages: row.messages,
+            ...(row.activeStreamId !== undefined ? { activeStreamId: row.activeStreamId } : {}),
+        };
+    }
+    async listThreads(actorRef, limit = 50) {
+        return [...this.threads.values()]
+            .filter((row) => row.actorRef === actorRef && !row.transient)
+            .sort((a, b) => b.updatedAt.localeCompare(a.updatedAt))
+            .slice(0, limit)
+            .map((row) => this.toSummary(row));
+    }
+    async softDeleteThread(threadId) {
+        this.threads.delete(threadId);
+    }
+    async forkThread(threadId, fromMessageId) {
+        const source = this.threads.get(threadId);
+        if (source === undefined) {
+            throw new Error(`thread ${threadId} not found`);
+        }
+        const cutoff = source.messages.findIndex((message) => message.id === fromMessageId);
+        const kept = cutoff >= 0 ? source.messages.slice(0, cutoff + 1) : [...source.messages];
+        const id = crypto.randomUUID();
+        const ts = this.now();
+        const row = {
+            id,
+            actorRef: source.actorRef,
+            title: source.title,
+            persona: source.persona,
+            transient: false,
+            createdAt: ts,
+            updatedAt: ts,
+            messages: kept.map((message) => ({ ...message })),
+        };
+        this.threads.set(id, row);
+        return this.toSummary(row);
+    }
+    async setTitle(threadId, title) {
+        const row = this.threads.get(threadId);
+        if (row !== undefined) {
+            row.title = title;
+            row.updatedAt = this.now();
+        }
+    }
+    async setActiveStream(threadId, runId) {
+        const row = this.threads.get(threadId);
+        if (row !== undefined) {
+            if (runId === null) {
+                // biome-ignore lint/performance/noDelete: exactOptionalPropertyTypes forbids assigning undefined to an optional prop
+                delete row.activeStreamId;
+            }
+            else {
+                row.activeStreamId = runId;
+            }
+        }
+    }
+    async appendMessage(input) {
+        const row = this.threads.get(input.threadId);
+        if (row === undefined) {
+            throw new Error(`thread ${input.threadId} not found`);
+        }
+        const message = {
+            id: crypto.randomUUID(),
+            role: input.role,
+            content: input.content,
+            createdAt: this.now(),
+            ...(input.toolCalls !== undefined ? { toolCalls: input.toolCalls } : {}),
+            ...(input.toolResults !== undefined ? { toolResults: input.toolResults } : {}),
+            ...(input.attachments !== undefined ? { attachments: input.attachments } : {}),
+            ...(input.followUps !== undefined ? { followUps: input.followUps } : {}),
+            ...(input.usage !== undefined ? { usage: input.usage } : {}),
+        };
+        row.messages.push(message);
+        row.updatedAt = message.createdAt;
+        if (input.runId !== undefined) {
+            this.messageRunIds.set(message.id, input.runId);
+        }
+        return message;
+    }
+    async truncateFrom(threadId, messageId) {
+        const row = this.threads.get(threadId);
+        if (row === undefined) {
+            return;
+        }
+        const cutoff = row.messages.findIndex((message) => message.id === messageId);
+        if (cutoff >= 0) {
+            row.messages = row.messages.slice(0, cutoff);
+        }
+    }
+    async recordToolCall(input) {
+        this.toolCalls.set(input.toolCallId, {
+            toolCallId: input.toolCallId,
+            messageId: input.messageId,
+            threadId: this.threadIdForMessage(input.messageId) ?? '',
+            toolName: input.toolName,
+            toolType: input.toolType,
+            input: input.input,
+            status: input.status,
+            createdAt: this.now(),
+            ...(input.runId !== undefined ? { runId: input.runId } : {}),
+        });
+    }
+    async updateToolCall(input) {
+        const row = this.toolCalls.get(input.toolCallId);
+        if (row === undefined) {
+            return;
+        }
+        row.status = input.status;
+        if (input.output !== undefined) {
+            row.output = input.output;
+        }
+        if (input.error !== undefined) {
+            row.error = input.error;
+        }
+        if (input.executionMs !== undefined) {
+            row.executionMs = input.executionMs;
+        }
+    }
+    async recordUsage(input) {
+        const createdAt = this.now();
+        this.usage.push({
+            actorRef: input.actorRef,
+            threadId: input.threadId,
+            modelId: input.modelId,
+            purpose: input.purpose,
+            inputTokens: input.usage.inputTokens,
+            outputTokens: input.usage.outputTokens,
+            day: createdAt.slice(0, 10),
+            createdAt,
+            ...(input.runId !== undefined ? { runId: input.runId } : {}),
+            ...(input.usage.cacheWriteTokens !== undefined
+                ? { cacheWriteTokens: input.usage.cacheWriteTokens }
+                : {}),
+            ...(input.usage.cacheReadTokens !== undefined
+                ? { cacheReadTokens: input.usage.cacheReadTokens }
+                : {}),
+            ...(input.costUsd !== undefined ? { costUsd: input.costUsd } : {}),
+        });
+    }
+    async recordRunStart(input) {
+        this.runs.set(input.runId, {
+            runId: input.runId,
+            threadId: input.threadId,
+            actorRef: input.actor.id,
+            status: 'running',
+            startedAt: this.now(),
+            stepCount: 0,
+            inputTokens: 0,
+            outputTokens: 0,
+            durable: input.durable ?? false,
+            ...(input.actor.tenantRef !== undefined ? { tenantRef: input.actor.tenantRef } : {}),
+            ...(input.agentName !== undefined ? { agentName: input.agentName } : {}),
+        });
+    }
+    async recordRunEnd(input) {
+        const row = this.runs.get(input.runId);
+        // First terminal wins: a no-op when the run is unknown or already settled (mirrors the Lucid twin).
+        if (row === undefined || row.status !== 'running') {
+            return;
+        }
+        row.status = input.status;
+        row.finishedAt =
+            input.finishedAt !== undefined ? new Date(input.finishedAt).toISOString() : this.now();
+        if (input.stepCount !== undefined)
+            row.stepCount = input.stepCount;
+        if (input.inputTokens !== undefined)
+            row.inputTokens = input.inputTokens;
+        if (input.outputTokens !== undefined)
+            row.outputTokens = input.outputTokens;
+        if (input.costUsd !== undefined)
+            row.costUsd = input.costUsd;
+        if (input.error !== undefined)
+            row.error = input.error;
+    }
+    async quotaToday(actorRef, day) {
+        const usedTokens = this.usage
+            .filter((row) => row.actorRef === actorRef && row.day === day)
+            .reduce((sum, row) => sum + row.inputTokens + row.outputTokens, 0);
+        return { usedTokens };
+    }
+    /** Test helper: read the recorded usage rows (modelId + token totals). */
+    usageRows() {
+        return this.usage.map((row) => ({
+            actorRef: row.actorRef,
+            tokens: row.inputTokens + row.outputTokens,
+            modelId: row.modelId,
+        }));
+    }
+    /** Governance read-model feed: recorded usage rows with the input/output split + thread/day. */
+    governanceUsage() {
+        return this.usage.map((row) => ({
+            actorRef: row.actorRef,
+            threadId: row.threadId,
+            modelId: row.modelId,
+            purpose: row.purpose,
+            inputTokens: row.inputTokens,
+            outputTokens: row.outputTokens,
+            day: row.day,
+            createdAt: row.createdAt,
+            ...(row.runId !== undefined ? { runId: row.runId } : {}),
+            ...(row.cacheWriteTokens !== undefined ? { cacheWriteTokens: row.cacheWriteTokens } : {}),
+            ...(row.cacheReadTokens !== undefined ? { cacheReadTokens: row.cacheReadTokens } : {}),
+            ...(row.costUsd !== undefined ? { costUsd: row.costUsd } : {}),
+        }));
+    }
+    /** Governance read-model feed: recorded tool calls with the resolved thread + timestamp. */
+    governanceToolCalls() {
+        return [...this.toolCalls.values()].map((row) => ({
+            toolCallId: row.toolCallId,
+            toolName: row.toolName,
+            toolType: row.toolType,
+            status: row.status,
+            threadId: row.threadId,
+            input: row.input,
+            createdAt: row.createdAt,
+            ...(row.runId !== undefined ? { runId: row.runId } : {}),
+            ...(row.output !== undefined ? { output: row.output } : {}),
+            ...(row.error !== undefined ? { error: row.error } : {}),
+            ...(row.executionMs !== undefined ? { executionMs: row.executionMs } : {}),
+        }));
+    }
+    /** Governance read-model feed: recorded runs (full lifecycle + rollups). */
+    governanceRuns() {
+        return [...this.runs.values()].map((row) => ({ ...row }));
+    }
+    /** Governance read-model feed: recorded messages with their thread + run correlation. */
+    governanceMessages() {
+        const rows = [];
+        for (const thread of this.threads.values()) {
+            for (const message of thread.messages) {
+                const runId = this.messageRunIds.get(message.id);
+                rows.push({
+                    id: message.id,
+                    threadId: thread.id,
+                    role: message.role,
+                    content: message.content,
+                    createdAt: message.createdAt,
+                    ...(runId !== undefined ? { runId } : {}),
+                });
+            }
+        }
+        return rows;
+    }
+    /** Governance read-model feed: thread metadata (title/actor/message count/last activity). */
+    governanceThreads() {
+        return [...this.threads.values()].map((row) => ({
+            threadId: row.id,
+            title: row.title,
+            actorRef: row.actorRef,
+            messageCount: row.messages.length,
+            updatedAt: row.updatedAt,
+        }));
+    }
+    threadIdForMessage(messageId) {
+        for (const [threadId, row] of this.threads) {
+            if (row.messages.some((message) => message.id === messageId)) {
+                return threadId;
+            }
+        }
+        return undefined;
+    }
+    /** Test helper: read the recorded tool-call rows. */
+    toolCallRows() {
+        return [...this.toolCalls.values()].map((row) => ({
+            toolName: row.toolName,
+            status: row.status,
+            ...(row.output !== undefined ? { output: row.output } : {}),
+        }));
+    }
+    toSummary(row) {
+        const last = row.messages[row.messages.length - 1];
+        return {
+            id: row.id,
+            title: row.title,
+            persona: row.persona,
+            transient: row.transient,
+            createdAt: row.createdAt,
+            updatedAt: row.updatedAt,
+            ...(row.pinnedAt !== undefined ? { pinnedAt: row.pinnedAt } : {}),
+            ...(last !== undefined ? { lastMessagePreview: last.content.slice(0, 120) } : {}),
+        };
+    }
+}
+//# sourceMappingURL=in-memory-store.js.map

package/dist/src/testing/in-memory-store.js.map

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

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

@@ -0,0 +1,11 @@
+export { FakeModelProvider, echoScript, type FakeTurn, type FakeScript, } from './fake-model-provider.js';
+export { InMemoryAgentStore, type GovernanceUsageRow, type GovernanceToolCallRow, type GovernanceThreadRow, type GovernanceRunRow, type GovernanceMessageRow, } from './in-memory-store.js';
+export { InMemoryGovernanceQueries, type InMemoryModelPrice, } from './in-memory-governance-queries.js';
+export { InMemoryTokenStreamSink } from './in-memory-sink.js';
+export { InMemoryActorDirectory } from './in-memory-actor-directory.js';
+export { InMemoryQuotaStore } from './in-memory-quota.js';
+export { InMemoryPricingStore } from './in-memory-pricing.js';
+export { FakeEmbeddingProvider, FakeReranker, inMemoryRetriever, } from './fake-embedding-provider.js';
+export { InMemoryAttachmentStagingStore, type StagedRecord, } from './in-memory-attachment-staging.js';
+export { FakeMediaManager, fakePdfExtractor, inMemoryMediaRagIngestion, } from './fake-media.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,KAAK,QAAQ,EACb,KAAK,UAAU,GAChB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,yBAAyB,EACzB,KAAK,kBAAkB,GACxB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EACL,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,GAClB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,8BAA8B,EAC9B,KAAK,YAAY,GAClB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC"}

package/dist/src/testing/index.js

@@ -0,0 +1,11 @@
+export { FakeModelProvider, echoScript, } from './fake-model-provider.js';
+export { InMemoryAgentStore, } from './in-memory-store.js';
+export { InMemoryGovernanceQueries, } from './in-memory-governance-queries.js';
+export { InMemoryTokenStreamSink } from './in-memory-sink.js';
+export { InMemoryActorDirectory } from './in-memory-actor-directory.js';
+export { InMemoryQuotaStore } from './in-memory-quota.js';
+export { InMemoryPricingStore } from './in-memory-pricing.js';
+export { FakeEmbeddingProvider, FakeReranker, inMemoryRetriever, } from './fake-embedding-provider.js';
+export { InMemoryAttachmentStagingStore, } from './in-memory-attachment-staging.js';
+export { FakeMediaManager, fakePdfExtractor, inMemoryMediaRagIngestion, } from './fake-media.js';
+//# sourceMappingURL=index.js.map

package/dist/src/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,UAAU,GAGX,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,kBAAkB,GAMnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,yBAAyB,GAE1B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EACL,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,GAClB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,8BAA8B,GAE/B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC"}

package/dist/src/tool-discovery.d.ts

@@ -0,0 +1,35 @@
+import { type FunctionalTool } from './ai-tool-ref.js';
+import type { ToolRegistry } from './tool-registry.js';
+/** A tool registered at boot, echoed back so the provider can log what it wired. */
+export interface RegisteredTool {
+    name: string;
+    source: 'class' | 'functional';
+}
+/**
+ * Register one module export into the registry if it is an `@AiTool` class or a `defineTool(...)`
+ * functional tool; ignore anything else. A name already present is skipped (first wins). Returns the
+ * registered descriptor, or `null` when the export was not a tool / duplicated a registered name.
+ */
+export declare function registerToolExport(registry: ToolRegistry, exported: unknown, defaultRoles: string[]): RegisteredTool | null;
+/** Register a `defineTool` functional tool, applying `defaultRoles` when it declares none. */
+export declare function registerFunctionalTool(registry: ToolRegistry, tool: FunctionalTool, defaultRoles: string[]): RegisteredTool | null;
+/**
+ * Scan `dir` RECURSIVELY for modules and register every exported `@AiTool` class / `defineTool`
+ * tool into `registry` — the `app/agent_tools` convention. Only the environment-appropriate extension
+ * is imported and each export is visited once (deduped), so a built `.js` and a dev `.ts` of the same
+ * module never both register. Missing directory → no-op (the convention is opt-in). `defaultRoles`
+ * fills a tool that declares no `roles` (ADMIN-only by default).
+ */
+export declare function discoverTools(registry: ToolRegistry, dir: string, defaultRoles: string[]): Promise<RegisteredTool[]>;
+/**
+ * The build-time barrel shape the Assembler `init` hook generates for `app/agent_tools`
+ * (key → lazy module import), mirroring durable's steps/workflows barrels.
+ */
+export type ToolsBarrel = Record<string, () => Promise<Record<string, unknown>>>;
+/**
+ * Register every `@AiTool` / `defineTool` reachable from a generated {@link ToolsBarrel} — the
+ * build-time equivalent of {@link discoverTools} with no runtime `readdir`. Each module is imported
+ * once and each export registered once (deduped).
+ */
+export declare function registerToolsFromBarrel(registry: ToolRegistry, barrel: ToolsBarrel, defaultRoles: string[]): Promise<RegisteredTool[]>;
+//# sourceMappingURL=tool-discovery.d.ts.map

package/dist/src/tool-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-discovery.d.ts","sourceRoot":"","sources":["../../src/tool-discovery.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,cAAc,EAIpB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,oFAAoF;AACpF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,GAAG,YAAY,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,OAAO,EACjB,YAAY,EAAE,MAAM,EAAE,GACrB,cAAc,GAAG,IAAI,CAqBvB;AAED,8FAA8F;AAC9F,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,cAAc,EACpB,YAAY,EAAE,MAAM,EAAE,GACrB,cAAc,GAAG,IAAI,CAQvB;AA4BD;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,YAAY,EACtB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,cAAc,EAAE,CAAC,CA6B3B;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAEjF;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,cAAc,EAAE,CAAC,CAiB3B"}

package/dist/src/tool-registry.d.ts

@@ -0,0 +1,45 @@
+import type { StandardSchemaV1 } from '@standard-schema/spec';
+import type { RolesPolicy } from './spi/roles-policy.js';
+import type { AiToolCtx, ToolHandler } from './spi/tool.js';
+import type { Actor, ToolDefinition, ToolSpec } from './types.js';
+/** Thrown when an actor invokes a tool their role is not allowed. */
+export declare class ToolForbiddenError extends Error {
+    readonly toolName: string;
+    constructor(toolName: string);
+}
+/** Thrown when a tool is invoked that was never registered. */
+export declare class ToolNotFoundError extends Error {
+    readonly toolName: string;
+    constructor(toolName: string);
+}
+/** Thrown when a tool's input fails its Standard Schema validation. */
+export declare class ToolInputInvalidError extends Error {
+    readonly toolName: string;
+    readonly issues: readonly StandardSchemaV1.Issue[];
+    constructor(toolName: string, issues: readonly StandardSchemaV1.Issue[]);
+}
+/**
+ * Holds every registered tool and gates invocation.
+ *
+ * Note: `definitionsFor` returns NEUTRAL definitions (no `execute`). The agent loop runs
+ * each tool itself as a (durable) step — so even read tools are not auto-executed by the
+ * model. `action` tools additionally require HITL approval before the loop runs them.
+ */
+export declare class ToolRegistry {
+    private readonly entries;
+    register(spec: ToolSpec, handler: ToolHandler): void;
+    has(name: string): boolean;
+    spec(name: string): ToolSpec | undefined;
+    allSpecs(): ToolSpec[];
+    /** The tools to offer the model for this actor+persona, after the two filter layers. */
+    definitionsFor(actor: Actor, policy: RolesPolicy, allowedTools?: string[]): Promise<ToolDefinition[]>;
+    /** Run a tool. Re-checks the role (defense-in-depth) and re-parses the input via Zod. */
+    invoke(name: string, input: unknown, ctx: AiToolCtx, policy: RolesPolicy): Promise<unknown>;
+}
+/** Default gate: one of the actor's roles must be in spec.roles (defaulting to ADMIN-only). */
+export declare class DefaultRolesPolicy implements RolesPolicy {
+    private readonly defaultRoles;
+    constructor(defaultRoles?: string[]);
+    can(actor: Actor, tool: ToolSpec): boolean;
+}
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/src/tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../src/tool-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAElE,qEAAqE;AACrE,qBAAa,kBAAmB,SAAQ,KAAK;aACf,QAAQ,EAAE,MAAM;gBAAhB,QAAQ,EAAE,MAAM;CAI7C;AAED,+DAA+D;AAC/D,qBAAa,iBAAkB,SAAQ,KAAK;aACd,QAAQ,EAAE,MAAM;gBAAhB,QAAQ,EAAE,MAAM;CAI7C;AAED,uEAAuE;AACvE,qBAAa,qBAAsB,SAAQ,KAAK;aAE5B,QAAQ,EAAE,MAAM;aAChB,MAAM,EAAE,SAAS,gBAAgB,CAAC,KAAK,EAAE;gBADzC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS,gBAAgB,CAAC,KAAK,EAAE;CAO5D;AAOD;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IAEpD,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAIpD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIxC,QAAQ,IAAI,QAAQ,EAAE;IAItB,wFAAwF;IAClF,cAAc,CAClB,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,WAAW,EACnB,YAAY,CAAC,EAAE,MAAM,EAAE,GACtB,OAAO,CAAC,cAAc,EAAE,CAAC;IAW5B,yFAAyF;IACnF,MAAM,CACV,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,OAAO,CAAC;CAcpB;AAED,+FAA+F;AAC/F,qBAAa,kBAAmB,YAAW,WAAW;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAAZ,YAAY,GAAE,MAAM,EAAc;IAE/D,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO;CAI3C"}

package/dist/src/tool-retry.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Transient tool-error classification + the retry loop that wraps a tool's own invocation. A
+ * classified-transient error (a DB deadlock, a lock-wait timeout, a serialization failure) means the
+ * server rolled the tool's work back — retrying THAT class is safe, unlike a tool's general business
+ * failure, which stays a one-shot outcome (no durable step retries: a tool may not be idempotent).
+ *
+ * `runAgentLoop` wraps `registry.invoke(...)` with {@link invokeWithTransientRetry} INSIDE the
+ * `tool:<call.id>` step body — so under durable replay the whole step is memoized on its successful
+ * result and a retry never becomes a new checkpoint; history still shows exactly one step per tool
+ * call and side effects run once.
+ */
+/**
+ * Default transient-tool-error classifier: true for a recognized MySQL/Postgres/SQLite
+ * lock-contention shape (by driver `code`/`errno`/`sqlState`, or a matching message), checked on the
+ * error itself and one level of `cause` (drivers commonly wrap the original error). A plain `Error`
+ * with none of these markers — any other business failure — is `false`.
+ */
+export declare function isTransientToolError(error: unknown): boolean;
+/** Total attempts (initial try + retries) when `toolTransientRetry` doesn't set `attempts`. */
+export declare const DEFAULT_TOOL_TRANSIENT_RETRY_ATTEMPTS = 2;
+/** Backoff base in ms — the wait between attempt N and N+1 is `backoffMs * N`. */
+export declare const DEFAULT_TOOL_TRANSIENT_RETRY_BACKOFF_MS = 150;
+/** The host-configurable policy — everything, including the (in-process) `classify` fn. */
+export interface ToolTransientRetryOptions {
+    /** Total attempts (initial try + retries). Defaults to {@link DEFAULT_TOOL_TRANSIENT_RETRY_ATTEMPTS}. */
+    attempts?: number;
+    /** Backoff base in ms. Defaults to {@link DEFAULT_TOOL_TRANSIENT_RETRY_BACKOFF_MS}. */
+    backoffMs?: number;
+    /** Overrides the default classifier — widen or narrow which errors are treated as transient. */
+    classify?: (error: unknown) => boolean;
+}
+/** `false` disables transient retry entirely — a tool's own thrown error surfaces immediately. */
+export type ToolTransientRetrySetting = ToolTransientRetryOptions | false;
+export interface InvokeWithTransientRetryOptions {
+    /**
+     * Recognizes the runner's control-flow signals (durable suspend / continue-as-new) so a retry
+     * never swallows one — same rule the loop's tool catch already applies. Undefined for a call site
+     * with no such notion (e.g. the inline runner, which has no workflow ctx to suspend on).
+     */
+    isControlFlowError?: (error: unknown) => boolean;
+    /**
+     * Called before each wait-and-retry, with the 1-based ordinal of the attempt that just failed and
+     * the error it threw. The call site uses this to emit the `tool.retry` diagnostics event —
+     * `invokeWithTransientRetry` itself carries no tool identity (name/callId), only the thunk.
+     */
+    onRetry?: (attempt: number, error: unknown) => void;
+}
+/**
+ * Retries `fn` in place — never a new durable step/checkpoint, just repeated attempts inside
+ * whichever step body already wraps this call. `setting: false` runs `fn` once, unwrapped (no
+ * classify/backoff bookkeeping at all). Otherwise: try; on a thrown error, rethrow immediately if
+ * it's a recognized control-flow signal, else if the (possibly custom) classifier calls it transient
+ * AND attempts remain, wait `backoffMs * attemptNumber` and retry; otherwise rethrow the error as-is.
+ */
+export declare function invokeWithTransientRetry<T>(fn: () => Promise<T>, setting: ToolTransientRetrySetting, options?: InvokeWithTransientRetryOptions): Promise<T>;
+//# sourceMappingURL=tool-retry.d.ts.map

package/dist/src/tool-retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-retry.d.ts","sourceRoot":"","sources":["../../src/tool-retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA4BH;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAW5D;AAED,+FAA+F;AAC/F,eAAO,MAAM,qCAAqC,IAAI,CAAC;AACvD,kFAAkF;AAClF,eAAO,MAAM,uCAAuC,MAAM,CAAC;AAE3D,2FAA2F;AAC3F,MAAM,WAAW,yBAAyB;IACxC,yGAAyG;IACzG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gGAAgG;IAChG,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CACxC;AAED,kGAAkG;AAClG,MAAM,MAAM,yBAAyB,GAAG,yBAAyB,GAAG,KAAK,CAAC;AAE1E,MAAM,WAAW,+BAA+B;IAC9C;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IACjD;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACrD;AAQD;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAAC,CAAC,EAC9C,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,EAAE,yBAAyB,EAClC,OAAO,CAAC,EAAE,+BAA+B,GACxC,OAAO,CAAC,CAAC,CAAC,CAyBZ"}

package/dist/src/tool-retry.js

@@ -0,0 +1,95 @@
+/**
+ * Transient tool-error classification + the retry loop that wraps a tool's own invocation. A
+ * classified-transient error (a DB deadlock, a lock-wait timeout, a serialization failure) means the
+ * server rolled the tool's work back — retrying THAT class is safe, unlike a tool's general business
+ * failure, which stays a one-shot outcome (no durable step retries: a tool may not be idempotent).
+ *
+ * `runAgentLoop` wraps `registry.invoke(...)` with {@link invokeWithTransientRetry} INSIDE the
+ * `tool:<call.id>` step body — so under durable replay the whole step is memoized on its successful
+ * result and a retry never becomes a new checkpoint; history still shows exactly one step per tool
+ * call and side effects run once.
+ */
+/** Narrow, structural check for a MySQL/Postgres/SQLite transient error shape — no casts. */
+function hasTransientShape(error) {
+    if (typeof error !== 'object' || error === null) {
+        return false;
+    }
+    const code = 'code' in error ? error.code : undefined;
+    const errno = 'errno' in error ? error.errno : undefined;
+    const sqlState = 'sqlState' in error ? error.sqlState : undefined;
+    if (code === 1213 || code === 1205 || errno === 1213 || errno === 1205) {
+        return true; // MySQL ER_LOCK_DEADLOCK / ER_LOCK_WAIT_TIMEOUT numeric codes
+    }
+    if (code === 'ER_LOCK_DEADLOCK' || code === 'ER_LOCK_WAIT_TIMEOUT') {
+        return true; // MySQL driver string codes
+    }
+    if (code === '40001' || code === '40P01' || sqlState === '40001' || sqlState === '40P01') {
+        return true; // Postgres serialization_failure / deadlock_detected SQLSTATEs
+    }
+    if (code === 'SQLITE_BUSY') {
+        return true;
+    }
+    const message = 'message' in error ? error.message : undefined;
+    return (typeof message === 'string' && /deadlock|lock wait timeout|serialization failure/i.test(message));
+}
+/**
+ * Default transient-tool-error classifier: true for a recognized MySQL/Postgres/SQLite
+ * lock-contention shape (by driver `code`/`errno`/`sqlState`, or a matching message), checked on the
+ * error itself and one level of `cause` (drivers commonly wrap the original error). A plain `Error`
+ * with none of these markers — any other business failure — is `false`.
+ */
+export function isTransientToolError(error) {
+    if (hasTransientShape(error)) {
+        return true;
+    }
+    if (typeof error === 'object' && error !== null && 'cause' in error) {
+        const cause = error.cause;
+        if (cause !== undefined && cause !== error && hasTransientShape(cause)) {
+            return true;
+        }
+    }
+    return false;
+}
+/** Total attempts (initial try + retries) when `toolTransientRetry` doesn't set `attempts`. */
+export const DEFAULT_TOOL_TRANSIENT_RETRY_ATTEMPTS = 2;
+/** Backoff base in ms — the wait between attempt N and N+1 is `backoffMs * N`. */
+export const DEFAULT_TOOL_TRANSIENT_RETRY_BACKOFF_MS = 150;
+function delay(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+/**
+ * Retries `fn` in place — never a new durable step/checkpoint, just repeated attempts inside
+ * whichever step body already wraps this call. `setting: false` runs `fn` once, unwrapped (no
+ * classify/backoff bookkeeping at all). Otherwise: try; on a thrown error, rethrow immediately if
+ * it's a recognized control-flow signal, else if the (possibly custom) classifier calls it transient
+ * AND attempts remain, wait `backoffMs * attemptNumber` and retry; otherwise rethrow the error as-is.
+ */
+export async function invokeWithTransientRetry(fn, setting, options) {
+    if (setting === false) {
+        return fn();
+    }
+    const attempts = setting.attempts ?? DEFAULT_TOOL_TRANSIENT_RETRY_ATTEMPTS;
+    const backoffMs = setting.backoffMs ?? DEFAULT_TOOL_TRANSIENT_RETRY_BACKOFF_MS;
+    const classify = setting.classify ?? isTransientToolError;
+    let attempt = 1;
+    for (;;) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            if (options?.isControlFlowError?.(error) === true) {
+                throw error;
+            }
+            const attemptsRemain = attempt < attempts;
+            if (!attemptsRemain || !classify(error)) {
+                throw error;
+            }
+            options?.onRetry?.(attempt, error);
+            await delay(backoffMs * attempt);
+            attempt += 1;
+        }
+    }
+}
+//# sourceMappingURL=tool-retry.js.map

package/dist/src/tool-retry.js.map

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