@agent-native/core 0.59.1 → 0.60.0

package/dist/a2a/index.d.ts

@@ -1,5 +1,7 @@
 export { mountA2A } from "./server.js";
 export { generateAgentCard } from "./agent-card.js";
 export { A2AClient, callAgent, signA2AToken } from "./client.js";
+export { AgentInvocationError, buildAgentInvocationPrompt, invokeAgent, looksLikeAgentUrl, resolveAgentInvocationTarget, } from "./invoke.js";
 export type { A2AConfig, A2AHandler, A2AHandlerContext, A2AHandlerResult, AgentCard, AgentSkill, AgentCapabilities, Task, TaskState, TaskStatus, Message, Part, TextPart, FilePart, DataPart, Artifact, JsonRpcRequest, JsonRpcResponse, } from "./types.js";
+export type { AgentInvocationErrorCode, AgentInvocationResult, AgentInvocationRuntime, InvokeAgentOptions, ResolveAgentInvocationTargetOptions, ResolvedAgentInvocationTarget, } from "./invoke.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/a2a/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/a2a/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGjE,YAAY,EACV,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,IAAI,EACJ,SAAS,EACT,UAAU,EACV,OAAO,EACP,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,eAAe,GAChB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/a2a/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,WAAW,EACX,iBAAiB,EACjB,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,IAAI,EACJ,SAAS,EACT,UAAU,EACV,OAAO,EACP,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,mCAAmC,EACnC,6BAA6B,GAC9B,MAAM,aAAa,CAAC"}

package/dist/a2a/index.js

@@ -3,4 +3,5 @@ export { mountA2A } from "./server.js";
 export { generateAgentCard } from "./agent-card.js";
 // Client
 export { A2AClient, callAgent, signA2AToken } from "./client.js";
+export { AgentInvocationError, buildAgentInvocationPrompt, invokeAgent, looksLikeAgentUrl, resolveAgentInvocationTarget, } from "./invoke.js";
 //# sourceMappingURL=index.js.map

package/dist/a2a/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/a2a/index.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,SAAS;AACT,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC","sourcesContent":["// Server (H3/Nitro)\nexport { mountA2A } from \"./server.js\";\nexport { generateAgentCard } from \"./agent-card.js\";\n\n// Client\nexport { A2AClient, callAgent, signA2AToken } from \"./client.js\";\n\n// Types\nexport type {\n  A2AConfig,\n  A2AHandler,\n  A2AHandlerContext,\n  A2AHandlerResult,\n  AgentCard,\n  AgentSkill,\n  AgentCapabilities,\n  Task,\n  TaskState,\n  TaskStatus,\n  Message,\n  Part,\n  TextPart,\n  FilePart,\n  DataPart,\n  Artifact,\n  JsonRpcRequest,\n  JsonRpcResponse,\n} from \"./types.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/a2a/index.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,SAAS;AACT,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,WAAW,EACX,iBAAiB,EACjB,4BAA4B,GAC7B,MAAM,aAAa,CAAC","sourcesContent":["// Server (H3/Nitro)\nexport { mountA2A } from \"./server.js\";\nexport { generateAgentCard } from \"./agent-card.js\";\n\n// Client\nexport { A2AClient, callAgent, signA2AToken } from \"./client.js\";\nexport {\n  AgentInvocationError,\n  buildAgentInvocationPrompt,\n  invokeAgent,\n  looksLikeAgentUrl,\n  resolveAgentInvocationTarget,\n} from \"./invoke.js\";\n\n// Types\nexport type {\n  A2AConfig,\n  A2AHandler,\n  A2AHandlerContext,\n  A2AHandlerResult,\n  AgentCard,\n  AgentSkill,\n  AgentCapabilities,\n  Task,\n  TaskState,\n  TaskStatus,\n  Message,\n  Part,\n  TextPart,\n  FilePart,\n  DataPart,\n  Artifact,\n  JsonRpcRequest,\n  JsonRpcResponse,\n} from \"./types.js\";\nexport type {\n  AgentInvocationErrorCode,\n  AgentInvocationResult,\n  AgentInvocationRuntime,\n  InvokeAgentOptions,\n  ResolveAgentInvocationTargetOptions,\n  ResolvedAgentInvocationTarget,\n} from \"./invoke.js\";\n"]}

package/dist/a2a/invoke.d.ts

@@ -0,0 +1,63 @@
+import { discoverAgents as defaultDiscoverAgents, findAgent as defaultFindAgent, type DiscoveredAgent } from "../server/agent-discovery.js";
+import { callAgent as defaultCallAgent } from "./client.js";
+export type AgentInvocationErrorCode = "missing-target" | "missing-prompt" | "invalid-url" | "self-call" | "not-found";
+export declare class AgentInvocationError extends Error {
+    readonly code: AgentInvocationErrorCode;
+    readonly target?: string;
+    readonly availableAgents?: DiscoveredAgent[];
+    constructor(code: AgentInvocationErrorCode, message: string, options?: {
+        target?: string;
+        availableAgents?: DiscoveredAgent[];
+    });
+}
+export interface ResolvedAgentInvocationTarget {
+    kind: "discovered" | "url";
+    id?: string;
+    name: string;
+    description?: string;
+    url: string;
+    color?: string;
+}
+export interface AgentInvocationResult {
+    target: ResolvedAgentInvocationTarget;
+    prompt: string;
+    responseText: string;
+}
+export interface AgentInvocationRuntime {
+    findAgent: typeof defaultFindAgent;
+    discoverAgents: typeof defaultDiscoverAgents;
+    callAgent: typeof defaultCallAgent;
+}
+export interface ResolveAgentInvocationTargetOptions {
+    selfAppId?: string;
+    selfUrl?: string;
+    runtime?: Partial<AgentInvocationRuntime>;
+}
+export interface InvokeAgentOptions extends ResolveAgentInvocationTargetOptions {
+    target: string;
+    prompt: string;
+    apiKey?: string;
+    contextId?: string;
+    userEmail?: string;
+    orgDomain?: string;
+    orgSecret?: string;
+    async?: boolean;
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+    includeInvocationHint?: boolean;
+    runtime?: Partial<AgentInvocationRuntime>;
+}
+/**
+ * Resolve an A2A invocation target from a direct URL or from the connected app
+ * registry. ID/name resolution deliberately uses the same discovery path as
+ * the in-agent `call-agent` script.
+ */
+export declare function resolveAgentInvocationTarget(target: string, options?: ResolveAgentInvocationTargetOptions): Promise<ResolvedAgentInvocationTarget>;
+/**
+ * First-class headless A2A primitive: resolve an app/agent by id, name, or URL,
+ * send a text prompt, and return the text response with target metadata.
+ */
+export declare function invokeAgent(options: InvokeAgentOptions): Promise<AgentInvocationResult>;
+export declare function buildAgentInvocationPrompt(prompt: string, agentUrl: string): string;
+export declare function looksLikeAgentUrl(value: string): boolean;
+//# sourceMappingURL=invoke.d.ts.map

package/dist/a2a/invoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoke.d.ts","sourceRoot":"","sources":["../../src/a2a/invoke.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,IAAI,qBAAqB,EACvC,SAAS,IAAI,gBAAgB,EAC7B,KAAK,eAAe,EACrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,SAAS,IAAI,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE5D,MAAM,MAAM,wBAAwB,GAChC,gBAAgB,GAChB,gBAAgB,GAChB,aAAa,GACb,WAAW,GACX,WAAW,CAAC;AAEhB,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,EAAE,CAAC;gBAG3C,IAAI,EAAE,wBAAwB,EAC9B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,eAAe,EAAE,CAAA;KAAE;CAQrE;AAED,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,YAAY,GAAG,KAAK,CAAC;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,6BAA6B,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,OAAO,gBAAgB,CAAC;IACnC,cAAc,EAAE,OAAO,qBAAqB,CAAC;IAC7C,SAAS,EAAE,OAAO,gBAAgB,CAAC;CACpC;AAED,MAAM,WAAW,mCAAmC;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,kBAAmB,SAAQ,mCAAmC;IAC7E,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;CAC3C;AAED;;;;GAIG;AACH,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,mCAAwC,GAChD,OAAO,CAAC,6BAA6B,CAAC,CAqDxC;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,qBAAqB,CAAC,CAsChC;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,MAAM,CAOR;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAExD"}

package/dist/a2a/invoke.js

@@ -0,0 +1,157 @@
+import { discoverAgents as defaultDiscoverAgents, findAgent as defaultFindAgent, } from "../server/agent-discovery.js";
+import { callAgent as defaultCallAgent } from "./client.js";
+export class AgentInvocationError extends Error {
+    code;
+    target;
+    availableAgents;
+    constructor(code, message, options) {
+        super(message);
+        this.name = "AgentInvocationError";
+        this.code = code;
+        this.target = options?.target;
+        this.availableAgents = options?.availableAgents;
+    }
+}
+/**
+ * Resolve an A2A invocation target from a direct URL or from the connected app
+ * registry. ID/name resolution deliberately uses the same discovery path as
+ * the in-agent `call-agent` script.
+ */
+export async function resolveAgentInvocationTarget(target, options = {}) {
+    const cleanTarget = target.trim();
+    if (!cleanTarget) {
+        throw new AgentInvocationError("missing-target", "Error: agent target is required");
+    }
+    const directUrl = parseAgentUrl(cleanTarget);
+    if (directUrl) {
+        assertNotSelfUrl(directUrl, options.selfUrl);
+        return {
+            kind: "url",
+            name: directUrl,
+            url: directUrl,
+        };
+    }
+    if (options.selfAppId &&
+        normalizeAgentHandle(cleanTarget) ===
+            normalizeAgentHandle(options.selfAppId)) {
+        throw new AgentInvocationError("self-call", formatSelfCallError(options.selfAppId), { target: cleanTarget });
+    }
+    const findAgent = options.runtime?.findAgent ?? defaultFindAgent;
+    const discoverAgents = options.runtime?.discoverAgents ?? defaultDiscoverAgents;
+    const agent = await findAgent(cleanTarget, options.selfAppId);
+    if (!agent) {
+        const availableAgents = await discoverAgents(options.selfAppId);
+        const available = availableAgents.map((a) => a.name).join(", ");
+        throw new AgentInvocationError("not-found", `Error: Agent "${cleanTarget}" not found. Available agents: ${available || "(none)"}`, { target: cleanTarget, availableAgents });
+    }
+    return {
+        kind: "discovered",
+        id: agent.id,
+        name: agent.name,
+        description: agent.description,
+        url: agent.url,
+        color: agent.color,
+    };
+}
+/**
+ * First-class headless A2A primitive: resolve an app/agent by id, name, or URL,
+ * send a text prompt, and return the text response with target metadata.
+ */
+export async function invokeAgent(options) {
+    const prompt = options.prompt;
+    if (!prompt.trim()) {
+        throw new AgentInvocationError("missing-prompt", "Error: prompt is required", { target: options.target });
+    }
+    const target = await resolveAgentInvocationTarget(options.target, {
+        selfAppId: options.selfAppId,
+        selfUrl: options.selfUrl,
+        runtime: options.runtime,
+    });
+    const promptToSend = options.includeInvocationHint === false
+        ? prompt
+        : buildAgentInvocationPrompt(prompt, target.url);
+    const callAgent = options.runtime?.callAgent ?? defaultCallAgent;
+    const responseText = await callAgent(target.url, promptToSend, {
+        apiKey: options.apiKey,
+        contextId: options.contextId,
+        userEmail: options.userEmail,
+        orgDomain: options.orgDomain,
+        orgSecret: options.orgSecret,
+        async: options.async,
+        timeoutMs: options.timeoutMs,
+        pollIntervalMs: options.pollIntervalMs,
+    });
+    return {
+        target,
+        prompt: promptToSend,
+        responseText,
+    };
+}
+export function buildAgentInvocationPrompt(prompt, agentUrl) {
+    return (`${prompt}\n\n` +
+        `[Note: this request comes from another app via A2A. The caller cannot see your local UI, resource list, or navigation - only the literal text you put in your reply. ` +
+        `If you create or reference a deck/document/design/dashboard/resource, include its FULLY-QUALIFIED URL (e.g. ${agentUrl.replace(/\/$/, "")}/<path>/<id>) in your reply, not a relative path. ` +
+        `Use only artifact IDs and URL paths returned by successful actions - never invent slugs, IDs, or hosts.]`);
+}
+export function looksLikeAgentUrl(value) {
+    return /^[a-z][a-z0-9+.-]*:\/\//i.test(value.trim());
+}
+function parseAgentUrl(value) {
+    const trimmed = value.trim();
+    if (!looksLikeAgentUrl(trimmed))
+        return null;
+    let parsed;
+    try {
+        parsed = new URL(trimmed);
+    }
+    catch {
+        throw new AgentInvocationError("invalid-url", `Error: Invalid agent URL "${trimmed}"`, { target: trimmed });
+    }
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+        throw new AgentInvocationError("invalid-url", "Error: Agent URL must use http or https", { target: trimmed });
+    }
+    parsed.hash = "";
+    parsed.search = "";
+    return parsed.toString().replace(/\/$/, "");
+}
+function assertNotSelfUrl(targetUrl, selfUrl) {
+    if (!selfUrl)
+        return;
+    const target = canonicalAgentBaseUrl(targetUrl);
+    const self = canonicalAgentBaseUrl(selfUrl);
+    if (!target || !self || target !== self)
+        return;
+    throw new AgentInvocationError("self-call", "Error: You cannot invoke this app via A2A from itself. Use the app's own registered actions/tools instead. A2A invocation is only for communicating with other separately-deployed apps.", { target: targetUrl });
+}
+function canonicalAgentBaseUrl(value) {
+    try {
+        const parsed = new URL(value);
+        parsed.hash = "";
+        parsed.search = "";
+        let pathname = parsed.pathname.replace(/\/+$/, "");
+        if (pathname.endsWith("/_agent-native/a2a")) {
+            pathname = pathname.slice(0, -"/_agent-native/a2a".length);
+        }
+        else if (pathname.endsWith("/a2a")) {
+            pathname = pathname.slice(0, -"/a2a".length);
+        }
+        parsed.pathname = pathname || "/";
+        return parsed.toString().replace(/\/$/, "");
+    }
+    catch {
+        return null;
+    }
+}
+function normalizeAgentHandle(value) {
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "image" ||
+        normalized === "images" ||
+        normalized === "asset") {
+        return "assets";
+    }
+    return normalized;
+}
+function formatSelfCallError(selfAppId) {
+    return `Error: You cannot use A2A invocation to call yourself (${selfAppId}). Use your own registered actions/tools instead. A2A invocation is only for communicating with OTHER separately-deployed apps.`;
+}
+//# sourceMappingURL=invoke.js.map

package/dist/a2a/invoke.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoke.js","sourceRoot":"","sources":["../../src/a2a/invoke.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  discoverAgents as defaultDiscoverAgents,\n  findAgent as defaultFindAgent,\n  type DiscoveredAgent,\n} from \"../server/agent-discovery.js\";\nimport { callAgent as defaultCallAgent } from \"./client.js\";\n\nexport type AgentInvocationErrorCode =\n  | \"missing-target\"\n  | \"missing-prompt\"\n  | \"invalid-url\"\n  | \"self-call\"\n  | \"not-found\";\n\nexport class AgentInvocationError extends Error {\n  readonly code: AgentInvocationErrorCode;\n  readonly target?: string;\n  readonly availableAgents?: DiscoveredAgent[];\n\n  constructor(\n    code: AgentInvocationErrorCode,\n    message: string,\n    options?: { target?: string; availableAgents?: DiscoveredAgent[] },\n  ) {\n    super(message);\n    this.name = \"AgentInvocationError\";\n    this.code = code;\n    this.target = options?.target;\n    this.availableAgents = options?.availableAgents;\n  }\n}\n\nexport interface ResolvedAgentInvocationTarget {\n  kind: \"discovered\" | \"url\";\n  id?: string;\n  name: string;\n  description?: string;\n  url: string;\n  color?: string;\n}\n\nexport interface AgentInvocationResult {\n  target: ResolvedAgentInvocationTarget;\n  prompt: string;\n  responseText: string;\n}\n\nexport interface AgentInvocationRuntime {\n  findAgent: typeof defaultFindAgent;\n  discoverAgents: typeof defaultDiscoverAgents;\n  callAgent: typeof defaultCallAgent;\n}\n\nexport interface ResolveAgentInvocationTargetOptions {\n  selfAppId?: string;\n  selfUrl?: string;\n  runtime?: Partial<AgentInvocationRuntime>;\n}\n\nexport interface InvokeAgentOptions extends ResolveAgentInvocationTargetOptions {\n  target: string;\n  prompt: string;\n  apiKey?: string;\n  contextId?: string;\n  userEmail?: string;\n  orgDomain?: string;\n  orgSecret?: string;\n  async?: boolean;\n  timeoutMs?: number;\n  pollIntervalMs?: number;\n  includeInvocationHint?: boolean;\n  runtime?: Partial<AgentInvocationRuntime>;\n}\n\n/**\n * Resolve an A2A invocation target from a direct URL or from the connected app\n * registry. ID/name resolution deliberately uses the same discovery path as\n * the in-agent `call-agent` script.\n */\nexport async function resolveAgentInvocationTarget(\n  target: string,\n  options: ResolveAgentInvocationTargetOptions = {},\n): Promise<ResolvedAgentInvocationTarget> {\n  const cleanTarget = target.trim();\n  if (!cleanTarget) {\n    throw new AgentInvocationError(\n      \"missing-target\",\n      \"Error: agent target is required\",\n    );\n  }\n\n  const directUrl = parseAgentUrl(cleanTarget);\n  if (directUrl) {\n    assertNotSelfUrl(directUrl, options.selfUrl);\n    return {\n      kind: \"url\",\n      name: directUrl,\n      url: directUrl,\n    };\n  }\n\n  if (\n    options.selfAppId &&\n    normalizeAgentHandle(cleanTarget) ===\n      normalizeAgentHandle(options.selfAppId)\n  ) {\n    throw new AgentInvocationError(\n      \"self-call\",\n      formatSelfCallError(options.selfAppId),\n      { target: cleanTarget },\n    );\n  }\n\n  const findAgent = options.runtime?.findAgent ?? defaultFindAgent;\n  const discoverAgents =\n    options.runtime?.discoverAgents ?? defaultDiscoverAgents;\n  const agent = await findAgent(cleanTarget, options.selfAppId);\n  if (!agent) {\n    const availableAgents = await discoverAgents(options.selfAppId);\n    const available = availableAgents.map((a) => a.name).join(\", \");\n    throw new AgentInvocationError(\n      \"not-found\",\n      `Error: Agent \"${cleanTarget}\" not found. Available agents: ${available || \"(none)\"}`,\n      { target: cleanTarget, availableAgents },\n    );\n  }\n\n  return {\n    kind: \"discovered\",\n    id: agent.id,\n    name: agent.name,\n    description: agent.description,\n    url: agent.url,\n    color: agent.color,\n  };\n}\n\n/**\n * First-class headless A2A primitive: resolve an app/agent by id, name, or URL,\n * send a text prompt, and return the text response with target metadata.\n */\nexport async function invokeAgent(\n  options: InvokeAgentOptions,\n): Promise<AgentInvocationResult> {\n  const prompt = options.prompt;\n  if (!prompt.trim()) {\n    throw new AgentInvocationError(\n      \"missing-prompt\",\n      \"Error: prompt is required\",\n      { target: options.target },\n    );\n  }\n\n  const target = await resolveAgentInvocationTarget(options.target, {\n    selfAppId: options.selfAppId,\n    selfUrl: options.selfUrl,\n    runtime: options.runtime,\n  });\n\n  const promptToSend =\n    options.includeInvocationHint === false\n      ? prompt\n      : buildAgentInvocationPrompt(prompt, target.url);\n\n  const callAgent = options.runtime?.callAgent ?? defaultCallAgent;\n  const responseText = await callAgent(target.url, promptToSend, {\n    apiKey: options.apiKey,\n    contextId: options.contextId,\n    userEmail: options.userEmail,\n    orgDomain: options.orgDomain,\n    orgSecret: options.orgSecret,\n    async: options.async,\n    timeoutMs: options.timeoutMs,\n    pollIntervalMs: options.pollIntervalMs,\n  });\n\n  return {\n    target,\n    prompt: promptToSend,\n    responseText,\n  };\n}\n\nexport function buildAgentInvocationPrompt(\n  prompt: string,\n  agentUrl: string,\n): string {\n  return (\n    `${prompt}\\n\\n` +\n    `[Note: this request comes from another app via A2A. The caller cannot see your local UI, resource list, or navigation - only the literal text you put in your reply. ` +\n    `If you create or reference a deck/document/design/dashboard/resource, include its FULLY-QUALIFIED URL (e.g. ${agentUrl.replace(/\\/$/, \"\")}/<path>/<id>) in your reply, not a relative path. ` +\n    `Use only artifact IDs and URL paths returned by successful actions - never invent slugs, IDs, or hosts.]`\n  );\n}\n\nexport function looksLikeAgentUrl(value: string): boolean {\n  return /^[a-z][a-z0-9+.-]*:\\/\\//i.test(value.trim());\n}\n\nfunction parseAgentUrl(value: string): string | null {\n  const trimmed = value.trim();\n  if (!looksLikeAgentUrl(trimmed)) return null;\n\n  let parsed: URL;\n  try {\n    parsed = new URL(trimmed);\n  } catch {\n    throw new AgentInvocationError(\n      \"invalid-url\",\n      `Error: Invalid agent URL \"${trimmed}\"`,\n      { target: trimmed },\n    );\n  }\n\n  if (parsed.protocol !== \"http:\" && parsed.protocol !== \"https:\") {\n    throw new AgentInvocationError(\n      \"invalid-url\",\n      \"Error: Agent URL must use http or https\",\n      { target: trimmed },\n    );\n  }\n\n  parsed.hash = \"\";\n  parsed.search = \"\";\n  return parsed.toString().replace(/\\/$/, \"\");\n}\n\nfunction assertNotSelfUrl(targetUrl: string, selfUrl: string | undefined) {\n  if (!selfUrl) return;\n  const target = canonicalAgentBaseUrl(targetUrl);\n  const self = canonicalAgentBaseUrl(selfUrl);\n  if (!target || !self || target !== self) return;\n  throw new AgentInvocationError(\n    \"self-call\",\n    \"Error: You cannot invoke this app via A2A from itself. Use the app's own registered actions/tools instead. A2A invocation is only for communicating with other separately-deployed apps.\",\n    { target: targetUrl },\n  );\n}\n\nfunction canonicalAgentBaseUrl(value: string): string | null {\n  try {\n    const parsed = new URL(value);\n    parsed.hash = \"\";\n    parsed.search = \"\";\n    let pathname = parsed.pathname.replace(/\\/+$/, \"\");\n    if (pathname.endsWith(\"/_agent-native/a2a\")) {\n      pathname = pathname.slice(0, -\"/_agent-native/a2a\".length);\n    } else if (pathname.endsWith(\"/a2a\")) {\n      pathname = pathname.slice(0, -\"/a2a\".length);\n    }\n    parsed.pathname = pathname || \"/\";\n    return parsed.toString().replace(/\\/$/, \"\");\n  } catch {\n    return null;\n  }\n}\n\nfunction normalizeAgentHandle(value: string): string {\n  const normalized = value.trim().toLowerCase();\n  if (\n    normalized === \"image\" ||\n    normalized === \"images\" ||\n    normalized === \"asset\"\n  ) {\n    return \"assets\";\n  }\n  return normalized;\n}\n\nfunction formatSelfCallError(selfAppId: string): string {\n  return `Error: You cannot use A2A invocation to call yourself (${selfAppId}). Use your own registered actions/tools instead. A2A invocation is only for communicating with OTHER separately-deployed apps.`;\n}\n"]}

package/dist/agent/run-store.d.ts

@@ -108,6 +108,21 @@ export declare function getRunByThread(threadId: string, options?: {
     completedAt: number | null;
     lastProgressAt: number | null;
 } | null>;
+export interface AgentRunSummary {
+    id: string;
+    threadId: string;
+    turnId: string | null;
+    status: string;
+    startedAt: number;
+    heartbeatAt: number | null;
+    completedAt: number | null;
+    lastProgressAt: number | null;
+    errorCode: string | null;
+    abortReason: string | null;
+}
+export declare function listRunsForThread(threadId: string, options?: {
+    limit?: number;
+}): Promise<AgentRunSummary[]>;
 /**
  * Read the current logical turn's recorded events for a thread, parsed into
  * `AgentChatEvent`s in seq order, for per-turn tool-call journal classification

package/dist/agent/run-store.d.ts.map

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

package/dist/agent/run-store.js

@@ -451,6 +451,34 @@ export async function getRunByThread(threadId, options) {
         lastProgressAt: r.last_progress_at == null ? null : Number(r.last_progress_at),
     };
 }
+export async function listRunsForThread(threadId, options = {}) {
+    await ensureRunTables();
+    const limit = Math.min(Math.max(options.limit ?? 10, 1), 50);
+    const client = getDbExec();
+    const { rows } = await client.execute({
+        sql: `SELECT id, thread_id, turn_id, status, started_at, heartbeat_at, completed_at, last_progress_at, error_code, abort_reason
+          FROM agent_runs
+          WHERE thread_id = ?
+          ORDER BY started_at DESC
+          LIMIT ?`,
+        args: [threadId, limit],
+    });
+    return rows.map((r) => {
+        const row = r;
+        return {
+            id: row.id,
+            threadId: row.thread_id,
+            turnId: row.turn_id ?? null,
+            status: row.status,
+            startedAt: Number(row.started_at),
+            heartbeatAt: row.heartbeat_at == null ? null : Number(row.heartbeat_at),
+            completedAt: row.completed_at == null ? null : Number(row.completed_at),
+            lastProgressAt: row.last_progress_at == null ? null : Number(row.last_progress_at),
+            errorCode: row.error_code ?? null,
+            abortReason: row.abort_reason ?? null,
+        };
+    });
+}
 /**
  * Read the current logical turn's recorded events for a thread, parsed into
  * `AgentChatEvent`s in seq order, for per-turn tool-call journal classification

package/dist/agent/run-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-store.js","sourceRoot":"","sources":["../../src/agent/run-store.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * SQL persistence for agent runs and events.\n * Enables cross-isolate access on Cloudflare Workers and\n * reliable reconnection after page refreshes.\n */\nimport { getDbExec, intType, isPostgres } from \"../db/client.js\";\nimport { captureError } from \"../server/capture-error.js\";\nimport type { AgentChatEvent } from \"./types.js\";\n\nlet _initPromise: Promise<void> | undefined;\n\n/**\n * Max time without a heartbeat before a \"running\" run is considered dead.\n * The run-manager heartbeats every 1.5s, so 15s tolerates ~9 missed writes.\n * Widened from 6s to absorb real-world DB latency spikes and GC pauses that\n * caused false-positive reaps: a live run whose heartbeat lagged 6s+ would be\n * reaped and a zombie would keep running, eventually clobbering the new row.\n */\nexport const RUN_STALE_MS = 15_000;\n\nexport const STALE_RUN_ERROR_EVENT = {\n  type: \"error\",\n  error:\n    \"The agent stopped before it could finish. It may have hit a server timeout or the worker may have been interrupted.\",\n  errorCode: \"stale_run\",\n  recoverable: true,\n  details:\n    \"The run heartbeat stopped while the run was still marked running. Partial output and tool calls were preserved when available.\",\n} as const;\n\nasync function ensureRunTables(): Promise<void> {\n  if (!_initPromise) {\n    _initPromise = (async () => {\n      const client = getDbExec();\n      await client.execute(`\n        CREATE TABLE IF NOT EXISTS agent_runs (\n          id TEXT PRIMARY KEY,\n          thread_id TEXT NOT NULL,\n          status TEXT NOT NULL DEFAULT 'running',\n          abort_reason TEXT,\n          started_at ${intType()} NOT NULL,\n          completed_at ${intType()},\n          heartbeat_at ${intType()},\n          last_progress_at ${intType()},\n          turn_id TEXT,\n          error_code TEXT,\n          error_detail TEXT\n        )\n      `);\n      // Backfill heartbeat_at on older deployments.\n      try {\n        if (isPostgres()) {\n          await client.execute(\n            `ALTER TABLE agent_runs ADD COLUMN IF NOT EXISTS heartbeat_at ${intType()}`,\n          );\n          await client.execute(\n            `ALTER TABLE agent_runs ADD COLUMN IF NOT EXISTS abort_reason TEXT`,\n          );\n        } else {\n          await client.execute(\n            `ALTER TABLE agent_runs ADD COLUMN heartbeat_at ${intType()}`,\n          );\n        }\n      } catch {\n        // Column already exists — ignore\n      }\n      try {\n        if (!isPostgres()) {\n          await client.execute(\n            `ALTER TABLE agent_runs ADD COLUMN abort_reason TEXT`,\n          );\n        }\n      } catch {\n        // Column already exists — ignore\n      }\n      // Backfill last_progress_at — this is distinct from heartbeat_at.\n      // heartbeat_at = \"the producer process is alive\" (bumped on a timer).\n      // last_progress_at = \"the agent is actually emitting events\" (bumped on\n      // each emit). The gap between them is the stuck-detector signal.\n      try {\n        if (isPostgres()) {\n          await client.execute(\n            `ALTER TABLE agent_runs ADD COLUMN IF NOT EXISTS last_progress_at ${intType()}`,\n          );\n        } else {\n          await client.execute(\n            `ALTER TABLE agent_runs ADD COLUMN last_progress_at ${intType()}`,\n          );\n        }\n      } catch {\n        // Column already exists — ignore\n      }\n      // Backfill turn_id / error_code / error_detail.\n      //   turn_id    = stable identity for one logical assistant turn that may\n      //                span several continuation runs, so the durable record\n      //                can be folded across runs instead of dropped per-run.\n      //   error_code / error_detail = terminal failure classification captured\n      //                at completion so errored/cut-off runs are queryable for\n      //                pattern analysis (see listErroredRuns).\n      for (const col of [\"turn_id\", \"error_code\", \"error_detail\"] as const) {\n        try {\n          if (isPostgres()) {\n            await client.execute(\n              `ALTER TABLE agent_runs ADD COLUMN IF NOT EXISTS ${col} TEXT`,\n            );\n          } else {\n            await client.execute(\n              `ALTER TABLE agent_runs ADD COLUMN ${col} TEXT`,\n            );\n          }\n        } catch {\n          // Column already exists — ignore\n        }\n      }\n      await client.execute(`\n        CREATE TABLE IF NOT EXISTS agent_run_events (\n          run_id TEXT NOT NULL,\n          seq ${intType()} NOT NULL,\n          event_data TEXT NOT NULL,\n          PRIMARY KEY (run_id, seq)\n        )\n      `);\n      // Tool-call result ledger: persists the outcome of write tool calls that\n      // completed AFTER their chunk was abandoned (zombie completions). A\n      // resumed continuation can recover the real result by matching\n      // thread_id + tool_key (name:stableInputHash) instead of re-executing\n      // the side effect. Entries are scoped to the thread and expire with it.\n      await client.execute(`\n        CREATE TABLE IF NOT EXISTS agent_tool_ledger (\n          thread_id TEXT NOT NULL,\n          tool_key TEXT NOT NULL,\n          result_summary TEXT NOT NULL,\n          completed_at ${intType()} NOT NULL,\n          PRIMARY KEY (thread_id, tool_key)\n        )\n      `);\n    })().catch((err) => {\n      // Retry init on the next call after a failed startup.\n      _initPromise = undefined;\n      throw err;\n    });\n  }\n  return _initPromise;\n}\n\n// ─── Tool-call result ledger ─────────────────────────────────────────────────\n//\n// When the run-level abort signal fires (soft timeout / user cancel) while a\n// write tool is in-flight, `Promise.race` abandons the call — but the action's\n// Promise continues running in the background (a \"zombie\"). If the zombie\n// resolves before the continuation's next tool dispatch, we record the result\n// here so the continuation can recover it without re-executing the side effect.\n//\n// Keyed by (thread_id, tool_key) where tool_key = \"<toolName>:<stableJsonHash>\".\n// The write is fire-and-forget from the hot path; reads are synchronous look-\n// ups at the start of each write-tool dispatch in the continuation.\n\n/** Max length for a persisted result summary (8 KB). */\nconst LEDGER_RESULT_MAX_CHARS = 8_000;\n\n/**\n * Persist a zombie tool-call completion to the ledger. Called by the detached\n * promise continuation after `Promise.race` abandons it. Best-effort — never\n * throws so a ledger write failure doesn't break any caller.\n */\nexport async function writeLedgerEntry(\n  threadId: string,\n  toolKey: string,\n  resultSummary: string,\n): Promise<void> {\n  try {\n    await ensureRunTables();\n    const client = getDbExec();\n    const capped =\n      resultSummary.length > LEDGER_RESULT_MAX_CHARS\n        ? resultSummary.slice(0, LEDGER_RESULT_MAX_CHARS) +\n          `\\n...[ledger truncated at ${LEDGER_RESULT_MAX_CHARS} chars]`\n        : resultSummary;\n    await client.execute({\n      sql: `INSERT INTO agent_tool_ledger (thread_id, tool_key, result_summary, completed_at)\n            VALUES (?, ?, ?, ?)\n            ON CONFLICT (thread_id, tool_key) DO UPDATE SET\n              result_summary = excluded.result_summary,\n              completed_at = excluded.completed_at`,\n      args: [threadId, toolKey, capped, Date.now()],\n    });\n  } catch {\n    // Ledger is best-effort; never surface failures to the caller.\n  }\n}\n\n/**\n * Look up a prior zombie completion for this thread + tool key. Returns the\n * persisted result summary, or `null` when no entry exists.\n */\nexport async function readLedgerEntry(\n  threadId: string,\n  toolKey: string,\n): Promise<string | null> {\n  try {\n    await ensureRunTables();\n    const client = getDbExec();\n    const { rows } = await client.execute({\n      sql: `SELECT result_summary FROM agent_tool_ledger WHERE thread_id = ? AND tool_key = ?`,\n      args: [threadId, toolKey],\n    });\n    if (rows.length === 0) return null;\n    const row = rows[0] as { result_summary: string };\n    return row.result_summary;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Delete ledger entries for a thread. Called after a turn fully completes so\n * old entries don't bleed into the next turn's disambiguation.\n * Best-effort — never throws.\n */\nexport async function clearLedgerForThread(threadId: string): Promise<void> {\n  try {\n    await ensureRunTables();\n    const client = getDbExec();\n    await client.execute({\n      sql: `DELETE FROM agent_tool_ledger WHERE thread_id = ?`,\n      args: [threadId],\n    });\n  } catch {\n    // Best-effort.\n  }\n}\n\nexport async function insertRun(\n  id: string,\n  threadId: string,\n  turnId?: string,\n): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const now = Date.now();\n  await client.execute({\n    sql: `INSERT INTO agent_runs (id, thread_id, status, started_at, heartbeat_at, last_progress_at, turn_id) VALUES (?, ?, 'running', ?, ?, ?, ?)`,\n    args: [id, threadId, now, now, now, turnId ?? id],\n  });\n}\n\n/**\n * Atomically acquire a run lease for a thread. Succeeds (returns true) only\n * when no other run for the same thread is currently status='running' with a\n * fresh heartbeat. Works for both Postgres and SQLite: the stale-cutoff\n * comparison lets a dead producer's run be replaced without waiting for the\n * reaper, mirroring the logic in `reapIfStale`.\n *\n * Callers that win the claim then insert the run row normally; callers that\n * lose skip the run and return the existing active runId to the caller.\n */\nexport async function tryClaimRunSlot(\n  threadId: string,\n  maxStaleMs: number = RUN_STALE_MS,\n): Promise<{ claimed: boolean; activeRunId: string | null }> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const heartbeatCutoff = Date.now() - maxStaleMs;\n  const { rows } = await client.execute({\n    sql: `SELECT id FROM agent_runs\n          WHERE thread_id = ?\n            AND status = 'running'\n            AND COALESCE(heartbeat_at, started_at) >= ?\n          ORDER BY started_at DESC LIMIT 1`,\n    args: [threadId, heartbeatCutoff],\n  });\n  if (rows.length > 0) {\n    const row = rows[0] as { id: string };\n    return { claimed: false, activeRunId: row.id };\n  }\n  return { claimed: true, activeRunId: null };\n}\n\n/**\n * Record terminal failure classification for a run so cut-off / errored runs\n * can be surfaced for pattern analysis (see listErroredRuns). Best-effort —\n * never throws, since it runs on the completion path that must not fail the run.\n */\nexport async function setRunError(\n  runId: string,\n  errorCode: string | undefined,\n  errorDetail: string | undefined,\n): Promise<void> {\n  if (!errorCode && !errorDetail) return;\n  try {\n    await ensureRunTables();\n    const client = getDbExec();\n    await client.execute({\n      sql: `UPDATE agent_runs SET error_code = ?, error_detail = ? WHERE id = ?`,\n      args: [\n        errorCode ?? null,\n        errorDetail ? errorDetail.slice(0, 2000) : null,\n        runId,\n      ],\n    });\n  } catch {\n    // Diagnostics are best-effort; never let them break completion.\n  }\n}\n\n/** Update the run's liveness heartbeat. Called periodically by run-manager. */\nexport async function updateRunHeartbeat(runId: string): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  await client.execute({\n    sql: `UPDATE agent_runs SET heartbeat_at = ? WHERE id = ?`,\n    args: [Date.now(), runId],\n  });\n}\n\n/**\n * Bump `last_progress_at` — call this whenever the agent actually emits an\n * event (token, tool call, message). Distinct from `heartbeat_at` so the\n * stuck-detector can tell \"process alive but nothing happening\" from\n * \"process dead.\" Callers should throttle (run-manager debounces to ~1/s).\n */\nexport async function bumpRunProgress(runId: string): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  await client.execute({\n    sql: `UPDATE agent_runs SET last_progress_at = ? WHERE id = ?`,\n    args: [Date.now(), runId],\n  });\n}\n\n/**\n * If the given run is marked \"running\" in SQL but its heartbeat is stale\n * (producer likely crashed), flip it to \"errored\" so watchers stop waiting.\n * Returns true if the row was reaped.\n */\nexport async function reapIfStale(\n  runId: string,\n  maxStaleMs: number = RUN_STALE_MS,\n): Promise<boolean> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const completedAt = Date.now();\n  const cutoff = completedAt - maxStaleMs;\n  const { rowsAffected } = await client.execute({\n    sql: `UPDATE agent_runs\n          SET status = 'errored',\n              completed_at = ?,\n              error_code = ?,\n              error_detail = ?\n          WHERE id = ?\n            AND status = 'running'\n            AND COALESCE(heartbeat_at, started_at) < ?`,\n    args: [\n      completedAt,\n      STALE_RUN_ERROR_EVENT.errorCode,\n      STALE_RUN_ERROR_EVENT.details,\n      runId,\n      cutoff,\n    ],\n  });\n  const reaped = (rowsAffected ?? 0) > 0;\n  if (reaped) {\n    await safeAppendTerminalRunEvent(\n      runId,\n      STALE_RUN_ERROR_EVENT,\n      \"reap-if-stale\",\n    );\n  }\n  return reaped;\n}\n\nexport async function updateRunStatus(\n  runId: string,\n  status: \"completed\" | \"errored\" | \"aborted\",\n): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  await client.execute({\n    sql: `UPDATE agent_runs SET status = ?, completed_at = ? WHERE id = ?`,\n    args: [status, Date.now(), runId],\n  });\n}\n\n/**\n * Conditional terminal status write: only updates if the row still belongs to\n * this run AND is still status='running'. Returns true when the update landed.\n *\n * This is the safe variant used by the producer's finally block so a zombie run\n * (reaped while executing) can never clobber the status written by the reaper\n * or a replacement run.\n */\nexport async function updateRunStatusIfRunning(\n  runId: string,\n  status: \"completed\" | \"errored\" | \"aborted\",\n): Promise<boolean> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const { rowsAffected } = await client.execute({\n    sql: `UPDATE agent_runs SET status = ?, completed_at = ? WHERE id = ? AND status = 'running'`,\n    args: [status, Date.now(), runId],\n  });\n  return (rowsAffected ?? 0) > 0;\n}\n\n/** Read the current status of a run row. Returns null when the row is missing. */\nexport async function getRunStatus(runId: string): Promise<string | null> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const { rows } = await client.execute({\n    sql: `SELECT status FROM agent_runs WHERE id = ?`,\n    args: [runId],\n  });\n  if (rows.length === 0) return null;\n  return String((rows[0] as { status: string }).status);\n}\n\nexport async function markRunAborted(\n  runId: string,\n  reason?: string,\n): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  await client.execute({\n    sql: `UPDATE agent_runs SET status = 'aborted', abort_reason = ?, completed_at = ? WHERE id = ?`,\n    args: [reason ?? \"user\", Date.now(), runId],\n  });\n  await safeAppendTerminalRunEvent(runId, { type: \"done\" }, \"mark-aborted\");\n}\n\nexport async function isRunAborted(runId: string): Promise<boolean> {\n  return (await getRunAbortState(runId)).aborted;\n}\n\nexport async function getRunAbortState(\n  runId: string,\n): Promise<{ aborted: boolean; reason?: string }> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const { rows } = await client.execute({\n    sql: `SELECT status, abort_reason FROM agent_runs WHERE id = ?`,\n    args: [runId],\n  });\n  if (rows.length === 0) return { aborted: false };\n  const row = rows[0] as { status: string; abort_reason?: string | null };\n  if (row.status !== \"aborted\") return { aborted: false };\n  return {\n    aborted: true,\n    ...(row.abort_reason ? { reason: row.abort_reason } : {}),\n  };\n}\n\nexport async function insertRunEvent(\n  runId: string,\n  seq: number,\n  eventData: string,\n): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  // ON CONFLICT DO NOTHING: a (runId, seq) collision can happen on the\n  // soft-timeout / terminal-event path where `pendingTerminalEvent` was\n  // assigned a seq that later gets reused by an event pushed after it.\n  // It can also race with `appendTerminalRunEvent` (max-seq + 1) when a\n  // run aborts at the same time the producer emits its final event.\n  // Treat the second write as a no-op so the run completes cleanly.\n  await client.execute({\n    sql: `INSERT INTO agent_run_events (run_id, seq, event_data) VALUES (?, ?, ?) ON CONFLICT (run_id, seq) DO NOTHING`,\n    args: [runId, seq, eventData],\n  });\n}\n\nexport async function getRunEventsSince(\n  runId: string,\n  fromSeq: number,\n): Promise<Array<{ seq: number; eventData: string }>> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const { rows } = await client.execute({\n    sql: `SELECT seq, event_data FROM agent_run_events WHERE run_id = ? AND seq >= ? ORDER BY seq ASC`,\n    args: [runId, fromSeq],\n  });\n  return rows.map((r) => {\n    const row = r as { seq: number | string; event_data: string };\n    return { seq: Number(row.seq), eventData: row.event_data };\n  });\n}\n\nexport async function getRunById(runId: string): Promise<{\n  id: string;\n  threadId: string;\n  status: string;\n  startedAt: number;\n} | null> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const { rows } = await client.execute({\n    sql: `SELECT id, thread_id, status, started_at FROM agent_runs WHERE id = ?`,\n    args: [runId],\n  });\n  if (rows.length === 0) return null;\n  const r = rows[0] as {\n    id: string;\n    thread_id: string;\n    status: string;\n    started_at: number | string;\n  };\n  return {\n    id: r.id,\n    threadId: r.thread_id,\n    status: r.status,\n    startedAt: Number(r.started_at),\n  };\n}\n\nexport async function getRunByThread(\n  threadId: string,\n  options?: { includeTerminal?: boolean },\n): Promise<{\n  id: string;\n  threadId: string;\n  turnId?: string | null;\n  status: string;\n  startedAt: number;\n  heartbeatAt: number | null;\n  completedAt: number | null;\n  lastProgressAt: number | null;\n} | null> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const sql = options?.includeTerminal\n    ? `SELECT id, thread_id, turn_id, status, started_at, heartbeat_at, completed_at, last_progress_at FROM agent_runs WHERE thread_id = ? ORDER BY started_at DESC LIMIT 1`\n    : `SELECT id, thread_id, turn_id, status, started_at, heartbeat_at, completed_at, last_progress_at FROM agent_runs WHERE thread_id = ? AND status = 'running' ORDER BY started_at DESC LIMIT 1`;\n  const { rows } = await client.execute({ sql, args: [threadId] });\n  if (rows.length === 0) return null;\n  const r = rows[0] as {\n    id: string;\n    thread_id: string;\n    turn_id?: string | null;\n    status: string;\n    started_at: number | string;\n    heartbeat_at: number | string | null;\n    completed_at: number | string | null;\n    last_progress_at: number | string | null;\n  };\n  return {\n    id: r.id,\n    threadId: r.thread_id,\n    turnId: r.turn_id ?? null,\n    status: r.status,\n    startedAt: Number(r.started_at),\n    heartbeatAt: r.heartbeat_at == null ? null : Number(r.heartbeat_at),\n    completedAt: r.completed_at == null ? null : Number(r.completed_at),\n    lastProgressAt:\n      r.last_progress_at == null ? null : Number(r.last_progress_at),\n  };\n}\n\n/**\n * Read the current logical turn's recorded events for a thread, parsed into\n * `AgentChatEvent`s in seq order, for per-turn tool-call journal classification\n * (see `tool-call-journal.ts`). Read-only and additive — reuses the existing\n * `agent_runs` / `agent_run_events` ledger with no schema change.\n *\n * A logical turn may span several continuation runs (each chunk is its own run\n * sharing one `turn_id`), so we union the events of every run that belongs to\n * the latest turn for this thread. Events are ordered by (started_at, seq) so\n * earlier chunks come before later ones and the positional `tool_start` →\n * `tool_done` matching in the classifier stays correct across chunk boundaries.\n *\n * Returns an empty array when the thread has no run yet or no parseable events.\n * Best-effort on parse: malformed ledger rows are skipped rather than thrown.\n */\nexport async function getCurrentTurnEventsForThread(\n  threadId: string,\n): Promise<AgentChatEvent[]> {\n  await ensureRunTables();\n  const client = getDbExec();\n  // Find the latest run for this thread (terminal or running) to learn the\n  // logical turn id. The journal is consulted on the resume path, where the\n  // just-interrupted run is typically already terminal.\n  const latest = await client.execute({\n    sql: `SELECT id, turn_id FROM agent_runs WHERE thread_id = ? ORDER BY started_at DESC LIMIT 1`,\n    args: [threadId],\n  });\n  if (latest.rows.length === 0) return [];\n  const latestRow = latest.rows[0] as { id: string; turn_id: string | null };\n  const turnId = latestRow.turn_id ?? latestRow.id;\n  // Gather every run that belongs to this logical turn, oldest chunk first, and\n  // read their events in seq order. COALESCE(turn_id, id) folds older rows that\n  // predate the turn_id backfill into a turn keyed by their own run id.\n  const { rows } = await client.execute({\n    sql: `SELECT e.event_data AS event_data\n          FROM agent_run_events e\n          JOIN agent_runs r ON r.id = e.run_id\n          WHERE r.thread_id = ?\n            AND COALESCE(r.turn_id, r.id) = ?\n          ORDER BY r.started_at ASC, e.seq ASC`,\n    args: [threadId, turnId],\n  });\n  const events: AgentChatEvent[] = [];\n  for (const r of rows) {\n    const raw = (r as { event_data?: string }).event_data;\n    if (!raw) continue;\n    try {\n      events.push(JSON.parse(raw) as AgentChatEvent);\n    } catch {\n      // Skip malformed ledger rows — the journal is best-effort.\n    }\n  }\n  return events;\n}\n\n/**\n * Expire any \"running\" rows whose heartbeat is stale — producer died.\n * Safe to call at server startup on multi-isolate deployments: only rows\n * without a fresh heartbeat get reaped, so runs owned by OTHER live\n * isolates (which keep heartbeating) are left alone.\n */\nexport async function reapAllStaleRuns(): Promise<number> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const heartbeatCutoff = Date.now() - RUN_STALE_MS;\n  const stale = await client.execute({\n    sql: `SELECT id FROM agent_runs\n          WHERE status = 'running'\n            AND COALESCE(heartbeat_at, started_at) < ?`,\n    args: [heartbeatCutoff],\n  });\n  const completedAt = Date.now();\n  const { rowsAffected } = await client.execute({\n    sql: `UPDATE agent_runs\n          SET status = 'errored',\n              completed_at = ?,\n              error_code = ?,\n              error_detail = ?\n          WHERE status = 'running'\n            AND COALESCE(heartbeat_at, started_at) < ?`,\n    args: [\n      completedAt,\n      STALE_RUN_ERROR_EVENT.errorCode,\n      STALE_RUN_ERROR_EVENT.details,\n      heartbeatCutoff,\n    ],\n  });\n  for (const row of stale.rows) {\n    const id = (row as { id?: unknown }).id;\n    if (typeof id === \"string\") {\n      await safeAppendTerminalRunEvent(\n        id,\n        STALE_RUN_ERROR_EVENT,\n        \"reap-all-stale\",\n      );\n    }\n  }\n  return rowsAffected ?? 0;\n}\n\n/** Delete old runs and expire stale \"running\" rows that haven't had activity\n *  (e.g. worker crashed before updating status). Completed runs are pruned at\n *  `olderThanMs`; errored/aborted runs are kept until `erroredOlderThanMs` (a\n *  longer window, falling back to `olderThanMs`) so their event log survives\n *  for cut-off pattern analysis via listErroredRuns. */\nexport async function cleanupOldRuns(\n  olderThanMs: number,\n  erroredOlderThanMs?: number,\n): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const cutoff = Date.now() - olderThanMs;\n  const erroredCutoff =\n    Date.now() - Math.max(erroredOlderThanMs ?? 0, olderThanMs);\n  // Expire stale running rows on the absolute-age threshold — safety net\n  // for runs that never received a heartbeat (very old deployments). The\n  // SELECT covers BOTH UPDATE conditions so the terminal-event-append loop\n  // below catches every row we're about to flip — a 24h-old row with a\n  // somehow-fresh heartbeat would slip past a heartbeat-only SELECT.\n  const heartbeatCutoff = Date.now() - RUN_STALE_MS;\n  const stale = await client.execute({\n    sql: `SELECT id FROM agent_runs\n          WHERE status = 'running'\n            AND (\n              COALESCE(heartbeat_at, started_at) < ?\n              OR started_at < ?\n    )`,\n    args: [heartbeatCutoff, cutoff],\n  });\n  const completedAt = Date.now();\n  await client.execute({\n    sql: `UPDATE agent_runs\n          SET status = 'errored',\n              completed_at = ?,\n              error_code = ?,\n              error_detail = ?\n          WHERE status = 'running' AND started_at < ?`,\n    args: [\n      completedAt,\n      STALE_RUN_ERROR_EVENT.errorCode,\n      STALE_RUN_ERROR_EVENT.details,\n      cutoff,\n    ],\n  });\n  // Also expire runs whose heartbeat is stale — producer has died.\n  await client.execute({\n    sql: `UPDATE agent_runs\n          SET status = 'errored',\n              completed_at = ?,\n              error_code = ?,\n              error_detail = ?\n          WHERE status = 'running'\n            AND COALESCE(heartbeat_at, started_at) < ?`,\n    args: [\n      completedAt,\n      STALE_RUN_ERROR_EVENT.errorCode,\n      STALE_RUN_ERROR_EVENT.details,\n      heartbeatCutoff,\n    ],\n  });\n  for (const row of stale.rows) {\n    const id = (row as { id?: unknown }).id;\n    if (typeof id === \"string\") {\n      await safeAppendTerminalRunEvent(\n        id,\n        STALE_RUN_ERROR_EVENT,\n        \"cleanup-old-runs\",\n      );\n    }\n  }\n  // Delete events for old terminal runs. Completed runs prune at `cutoff`;\n  // errored/aborted runs are retained until the (longer) `erroredCutoff`.\n  await client.execute({\n    sql: `DELETE FROM agent_run_events WHERE run_id IN (\n      SELECT id FROM agent_runs\n      WHERE (status = 'completed' AND completed_at < ?)\n         OR (status IN ('errored', 'aborted') AND completed_at < ?)\n    )`,\n    args: [cutoff, erroredCutoff],\n  });\n  await client.execute({\n    sql: `DELETE FROM agent_runs\n          WHERE (status = 'completed' AND completed_at < ?)\n             OR (status IN ('errored', 'aborted') AND completed_at < ?)`,\n    args: [cutoff, erroredCutoff],\n  });\n}\n\n/**\n * List recent errored/aborted runs for cut-off pattern analysis. Read-only,\n * bounded, and ordered newest-first. Surfaced via the list-errored-runs action\n * so the team can see why chats are failing (terminal error code, duration,\n * turn linkage) instead of discovering it ad hoc.\n */\nexport async function listErroredRuns(options?: {\n  limit?: number;\n  sinceMs?: number;\n}): Promise<\n  Array<{\n    id: string;\n    threadId: string;\n    turnId: string | null;\n    status: string;\n    errorCode: string | null;\n    errorDetail: string | null;\n    startedAt: number;\n    completedAt: number | null;\n    durationMs: number | null;\n  }>\n> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const limit = Math.min(Math.max(Math.floor(options?.limit ?? 100), 1), 1000);\n  const since =\n    options?.sinceMs && options.sinceMs > 0 ? Date.now() - options.sinceMs : 0;\n  const { rows } = await client.execute({\n    sql: `SELECT id, thread_id, turn_id, status, error_code, error_detail, started_at, completed_at\n          FROM agent_runs\n          WHERE status IN ('errored', 'aborted')\n            AND COALESCE(completed_at, started_at) >= ?\n          ORDER BY COALESCE(completed_at, started_at) DESC\n          LIMIT ${limit}`,\n    args: [since],\n  });\n  return rows.map((r) => {\n    const row = r as {\n      id: string;\n      thread_id: string;\n      turn_id: string | null;\n      status: string;\n      error_code: string | null;\n      error_detail: string | null;\n      started_at: number | string;\n      completed_at: number | string | null;\n    };\n    const startedAt = Number(row.started_at);\n    const completedAt =\n      row.completed_at == null ? null : Number(row.completed_at);\n    return {\n      id: row.id,\n      threadId: row.thread_id,\n      turnId: row.turn_id ?? null,\n      status: row.status,\n      errorCode: row.error_code ?? null,\n      errorDetail: row.error_detail ?? null,\n      startedAt,\n      completedAt,\n      durationMs: completedAt == null ? null : completedAt - startedAt,\n    };\n  });\n}\n\n/**\n * Idempotently append a terminal event to a run's event stream. No-op if the\n * stream already ends in a terminal event. Used by reapers AND by SSE\n * reconnect paths that discover an `errored` run row with no terminal event\n * (e.g. an earlier reaper's silent `.catch(() => {})` swallowed the append).\n *\n * Persisting from the reconnect path is what keeps the system self-healing:\n * subsequent reconnects replay the proper terminal event from SQL instead of\n * synthesizing a fresh one each time.\n */\nexport async function ensureTerminalRunEvent(\n  runId: string,\n  event: Record<string, unknown>,\n): Promise<void> {\n  return appendTerminalRunEvent(runId, event);\n}\n\n/**\n * Append a terminal run event, retrying once on failure and reporting to\n * Sentry if both attempts fail. Background reaper paths can't surface errors\n * to a user, but they MUST eventually persist a terminal event — losing it\n * leaves reconnecting clients staring at a bare `status='errored'` row with\n * no payload to render. The previous `.catch(() => {})` callsites silently\n * dropped transient SQL blips and produced exactly that bug. Never throws.\n */\nasync function safeAppendTerminalRunEvent(\n  runId: string,\n  event: Record<string, unknown>,\n  source: string,\n): Promise<void> {\n  let firstError: unknown;\n  try {\n    await appendTerminalRunEvent(runId, event);\n    return;\n  } catch (err) {\n    firstError = err;\n  }\n  // Brief backoff — most \"transient\" SQL failures (connection blip, lock\n  // contention) clear within a couple hundred ms.\n  await new Promise<void>((resolve) => setTimeout(resolve, 100));\n  try {\n    await appendTerminalRunEvent(runId, event);\n  } catch (retryErr) {\n    captureError(retryErr, {\n      tags: {\n        component: \"agent-run-store\",\n        operation: \"append-terminal-event\",\n        source,\n      },\n      extra: {\n        runId,\n        eventType: typeof event.type === \"string\" ? event.type : \"(unknown)\",\n        firstError:\n          firstError instanceof Error ? firstError.message : String(firstError),\n      },\n    });\n  }\n}\n\nasync function appendTerminalRunEvent(\n  runId: string,\n  event: Record<string, unknown>,\n): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const { rows } = await client.execute({\n    sql: `SELECT seq, event_data FROM agent_run_events WHERE run_id = ? ORDER BY seq DESC LIMIT 1`,\n    args: [runId],\n  });\n  const last = rows[0] as\n    | { seq?: number | string; event_data?: string }\n    | undefined;\n  if (last?.event_data) {\n    try {\n      const parsed = JSON.parse(last.event_data);\n      if (\n        parsed?.type === \"done\" ||\n        parsed?.type === \"error\" ||\n        parsed?.type === \"missing_api_key\" ||\n        parsed?.type === \"loop_limit\" ||\n        parsed?.type === \"auto_continue\"\n      ) {\n        return;\n      }\n    } catch {\n      // Ignore malformed rows and append the terminal event.\n    }\n  }\n  const nextSeq = last ? Number(last.seq ?? -1) + 1 : 0;\n  await client.execute({\n    sql: `INSERT INTO agent_run_events (run_id, seq, event_data) VALUES (?, ?, ?) ON CONFLICT (run_id, seq) DO NOTHING`,\n    args: [runId, nextSeq, JSON.stringify(event)],\n  });\n}\n"]}
+{"version":3,"file":"run-store.js","sourceRoot":"","sources":["../../src/agent/run-store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG1D,IAAI,YAAuC,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC;AAEnC,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,OAAO;IACb,KAAK,EACH,qHAAqH;IACvH,SAAS,EAAE,WAAW;IACtB,WAAW,EAAE,IAAI;IACjB,OAAO,EACL,gIAAgI;CAC1H,CAAC;AAEX,KAAK,UAAU,eAAe;IAC5B,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,YAAY,GAAG,CAAC,KAAK,IAAI,EAAE;YACzB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;YAC3B,MAAM,MAAM,CAAC,OAAO,CAAC;;;;;;uBAMJ,OAAO,EAAE;yBACP,OAAO,EAAE;yBACT,OAAO,EAAE;6BACL,OAAO,EAAE;;;;;OAK/B,CAAC,CAAC;YACH,8CAA8C;YAC9C,IAAI,CAAC;gBACH,IAAI,UAAU,EAAE,EAAE,CAAC;oBACjB,MAAM,MAAM,CAAC,OAAO,CAClB,gEAAgE,OAAO,EAAE,EAAE,CAC5E,CAAC;oBACF,MAAM,MAAM,CAAC,OAAO,CAClB,mEAAmE,CACpE,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,MAAM,MAAM,CAAC,OAAO,CAClB,kDAAkD,OAAO,EAAE,EAAE,CAC9D,CAAC;gBACJ,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,iCAAiC;YACnC,CAAC;YACD,IAAI,CAAC;gBACH,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;oBAClB,MAAM,MAAM,CAAC,OAAO,CAClB,qDAAqD,CACtD,CAAC;gBACJ,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,iCAAiC;YACnC,CAAC;YACD,kEAAkE;YAClE,sEAAsE;YACtE,wEAAwE;YACxE,iEAAiE;YACjE,IAAI,CAAC;gBACH,IAAI,UAAU,EAAE,EAAE,CAAC;oBACjB,MAAM,MAAM,CAAC,OAAO,CAClB,oEAAoE,OAAO,EAAE,EAAE,CAChF,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,MAAM,MAAM,CAAC,OAAO,CAClB,sDAAsD,OAAO,EAAE,EAAE,CAClE,CAAC;gBACJ,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,iCAAiC;YACnC,CAAC;YACD,gDAAgD;YAChD,yEAAyE;YACzE,uEAAuE;YACvE,uEAAuE;YACvE,yEAAyE;YACzE,yEAAyE;YACzE,yDAAyD;YACzD,KAAK,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,YAAY,EAAE,cAAc,CAAU,EAAE,CAAC;gBACrE,IAAI,CAAC;oBACH,IAAI,UAAU,EAAE,EAAE,CAAC;wBACjB,MAAM,MAAM,CAAC,OAAO,CAClB,mDAAmD,GAAG,OAAO,CAC9D,CAAC;oBACJ,CAAC;yBAAM,CAAC;wBACN,MAAM,MAAM,CAAC,OAAO,CAClB,qCAAqC,GAAG,OAAO,CAChD,CAAC;oBACJ,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,iCAAiC;gBACnC,CAAC;YACH,CAAC;YACD,MAAM,MAAM,CAAC,OAAO,CAAC;;;gBAGX,OAAO,EAAE;;;;OAIlB,CAAC,CAAC;YACH,yEAAyE;YACzE,oEAAoE;YACpE,+DAA+D;YAC/D,sEAAsE;YACtE,wEAAwE;YACxE,MAAM,MAAM,CAAC,OAAO,CAAC;;;;;yBAKF,OAAO,EAAE;;;OAG3B,CAAC,CAAC;QACL,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACjB,sDAAsD;YACtD,YAAY,GAAG,SAAS,CAAC;YACzB,MAAM,GAAG,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,gFAAgF;AAChF,EAAE;AACF,6EAA6E;AAC7E,+EAA+E;AAC/E,0EAA0E;AAC1E,8EAA8E;AAC9E,gFAAgF;AAChF,EAAE;AACF,iFAAiF;AACjF,8EAA8E;AAC9E,oEAAoE;AAEpE,wDAAwD;AACxD,MAAM,uBAAuB,GAAG,KAAK,CAAC;AAEtC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,QAAgB,EAChB,OAAe,EACf,aAAqB;IAErB,IAAI,CAAC;QACH,MAAM,eAAe,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,MAAM,GACV,aAAa,CAAC,MAAM,GAAG,uBAAuB;YAC5C,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,uBAAuB,CAAC;gBAC/C,6BAA6B,uBAAuB,SAAS;YAC/D,CAAC,CAAC,aAAa,CAAC;QACpB,MAAM,MAAM,CAAC,OAAO,CAAC;YACnB,GAAG,EAAE;;;;mDAIwC;YAC7C,IAAI,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;SAC9C,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,+DAA+D;IACjE,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAgB,EAChB,OAAe;IAEf,IAAI,CAAC;QACH,MAAM,eAAe,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;YACpC,GAAG,EAAE,mFAAmF;YACxF,IAAI,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;SAC1B,CAAC,CAAC;QACH,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAA+B,CAAC;QAClD,OAAO,GAAG,CAAC,cAAc,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,QAAgB;IACzD,IAAI,CAAC;QACH,MAAM,eAAe,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,MAAM,CAAC,OAAO,CAAC;YACnB,GAAG,EAAE,mDAAmD;YACxD,IAAI,EAAE,CAAC,QAAQ,CAAC;SACjB,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,EAAU,EACV,QAAgB,EAChB,MAAe;IAEf,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,GAAG,EAAE,0IAA0I;QAC/I,IAAI,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,IAAI,EAAE,CAAC;KAClD,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAgB,EAChB,aAAqB,YAAY;IAEjC,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC;IAChD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QACpC,GAAG,EAAE;;;;2CAIkC;QACvC,IAAI,EAAE,CAAC,QAAQ,EAAE,eAAe,CAAC;KAClC,CAAC,CAAC;IACH,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAmB,CAAC;QACtC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;IACjD,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAa,EACb,SAA6B,EAC7B,WAA+B;IAE/B,IAAI,CAAC,SAAS,IAAI,CAAC,WAAW;QAAE,OAAO;IACvC,IAAI,CAAC;QACH,MAAM,eAAe,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,MAAM,CAAC,OAAO,CAAC;YACnB,GAAG,EAAE,qEAAqE;YAC1E,IAAI,EAAE;gBACJ,SAAS,IAAI,IAAI;gBACjB,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;gBAC/C,KAAK;aACN;SACF,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,gEAAgE;IAClE,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAAa;IACpD,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,GAAG,EAAE,qDAAqD;QAC1D,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC;KAC1B,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAAa;IACjD,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,GAAG,EAAE,yDAAyD;QAC9D,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC;KAC1B,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAa,EACb,aAAqB,YAAY;IAEjC,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;IACxC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QAC5C,GAAG,EAAE;;;;;;;uDAO8C;QACnD,IAAI,EAAE;YACJ,WAAW;YACX,qBAAqB,CAAC,SAAS;YAC/B,qBAAqB,CAAC,OAAO;YAC7B,KAAK;YACL,MAAM;SACP;KACF,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,CAAC,YAAY,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,0BAA0B,CAC9B,KAAK,EACL,qBAAqB,EACrB,eAAe,CAChB,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAa,EACb,MAA2C;IAE3C,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,GAAG,EAAE,iEAAiE;QACtE,IAAI,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC;KAClC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,KAAa,EACb,MAA2C;IAE3C,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QAC5C,GAAG,EAAE,wFAAwF;QAC7F,IAAI,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC;KAClC,CAAC,CAAC;IACH,OAAO,CAAC,YAAY,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;AACjC,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAa;IAC9C,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QACpC,GAAG,EAAE,4CAA4C;QACjD,IAAI,EAAE,CAAC,KAAK,CAAC;KACd,CAAC,CAAC;IACH,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,MAAM,CAAE,IAAI,CAAC,CAAC,CAAwB,CAAC,MAAM,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAa,EACb,MAAe;IAEf,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,GAAG,EAAE,2FAA2F;QAChG,IAAI,EAAE,CAAC,MAAM,IAAI,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC;KAC5C,CAAC,CAAC;IACH,MAAM,0BAA0B,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,cAAc,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAa;IAC9C,OAAO,CAAC,MAAM,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;AACjD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAa;IAEb,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QACpC,GAAG,EAAE,0DAA0D;QAC/D,IAAI,EAAE,CAAC,KAAK,CAAC;KACd,CAAC,CAAC;IACH,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACjD,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAqD,CAAC;IACxE,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACxD,OAAO;QACL,OAAO,EAAE,IAAI;QACb,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1D,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAa,EACb,GAAW,EACX,SAAiB;IAEjB,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,qEAAqE;IACrE,sEAAsE;IACtE,qEAAqE;IACrE,sEAAsE;IACtE,kEAAkE;IAClE,kEAAkE;IAClE,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,GAAG,EAAE,8GAA8G;QACnH,IAAI,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,SAAS,CAAC;KAC9B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAa,EACb,OAAe;IAEf,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QACpC,GAAG,EAAE,6FAA6F;QAClG,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC;KACvB,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACpB,MAAM,GAAG,GAAG,CAAiD,CAAC;QAC9D,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAa;IAM5C,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QACpC,GAAG,EAAE,uEAAuE;QAC5E,IAAI,EAAE,CAAC,KAAK,CAAC;KACd,CAAC,CAAC;IACH,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAKf,CAAC;IACF,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,QAAQ,EAAE,CAAC,CAAC,SAAS;QACrB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC;KAChC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAAgB,EAChB,OAAuC;IAWvC,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,GAAG,GAAG,OAAO,EAAE,eAAe;QAClC,CAAC,CAAC,sKAAsK;QACxK,CAAC,CAAC,6LAA6L,CAAC;IAClM,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACjE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CASf,CAAC;IACF,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,QAAQ,EAAE,CAAC,CAAC,SAAS;QACrB,MAAM,EAAE,CAAC,CAAC,OAAO,IAAI,IAAI;QACzB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC;QAC/B,WAAW,EAAE,CAAC,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC;QACnE,WAAW,EAAE,CAAC,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC;QACnE,cAAc,EACZ,CAAC,CAAC,gBAAgB,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC;KACjE,CAAC;AACJ,CAAC;AAeD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAAgB,EAChB,UAA8B,EAAE;IAEhC,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QACpC,GAAG,EAAE;;;;kBAIS;QACd,IAAI,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC;KACxB,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACpB,MAAM,GAAG,GAAG,CAWX,CAAC;QACF,OAAO;YACL,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,QAAQ,EAAE,GAAG,CAAC,SAAS;YACvB,MAAM,EAAE,GAAG,CAAC,OAAO,IAAI,IAAI;YAC3B,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;YACjC,WAAW,EAAE,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC;YACvE,WAAW,EAAE,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC;YACvE,cAAc,EACZ,GAAG,CAAC,gBAAgB,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC;YACpE,SAAS,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI;YACjC,WAAW,EAAE,GAAG,CAAC,YAAY,IAAI,IAAI;SACtC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,QAAgB;IAEhB,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,yEAAyE;IACzE,0EAA0E;IAC1E,sDAAsD;IACtD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QAClC,GAAG,EAAE,yFAAyF;QAC9F,IAAI,EAAE,CAAC,QAAQ,CAAC;KACjB,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACxC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAA2C,CAAC;IAC3E,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,EAAE,CAAC;IACjD,8EAA8E;IAC9E,8EAA8E;IAC9E,sEAAsE;IACtE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QACpC,GAAG,EAAE;;;;;+CAKsC;QAC3C,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;KACzB,CAAC,CAAC;IACH,MAAM,MAAM,GAAqB,EAAE,CAAC;IACpC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,GAAG,GAAI,CAA6B,CAAC,UAAU,CAAC;QACtD,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,2DAA2D;QAC7D,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC;IAClD,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QACjC,GAAG,EAAE;;uDAE8C;QACnD,IAAI,EAAE,CAAC,eAAe,CAAC;KACxB,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC/B,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QAC5C,GAAG,EAAE;;;;;;uDAM8C;QACnD,IAAI,EAAE;YACJ,WAAW;YACX,qBAAqB,CAAC,SAAS;YAC/B,qBAAqB,CAAC,OAAO;YAC7B,eAAe;SAChB;KACF,CAAC,CAAC;IACH,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAI,GAAwB,CAAC,EAAE,CAAC;QACxC,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC3B,MAAM,0BAA0B,CAC9B,EAAE,EACF,qBAAqB,EACrB,gBAAgB,CACjB,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,YAAY,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED;;;;wDAIwD;AACxD,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,WAAmB,EACnB,kBAA2B;IAE3B,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC;IACxC,MAAM,aAAa,GACjB,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,kBAAkB,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC;IAC9D,uEAAuE;IACvE,uEAAuE;IACvE,yEAAyE;IACzE,qEAAqE;IACrE,mEAAmE;IACnE,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC;IAClD,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QACjC,GAAG,EAAE;;;;;MAKH;QACF,IAAI,EAAE,CAAC,eAAe,EAAE,MAAM,CAAC;KAChC,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC/B,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,GAAG,EAAE;;;;;sDAK6C;QAClD,IAAI,EAAE;YACJ,WAAW;YACX,qBAAqB,CAAC,SAAS;YAC/B,qBAAqB,CAAC,OAAO;YAC7B,MAAM;SACP;KACF,CAAC,CAAC;IACH,iEAAiE;IACjE,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,GAAG,EAAE;;;;;;uDAM8C;QACnD,IAAI,EAAE;YACJ,WAAW;YACX,qBAAqB,CAAC,SAAS;YAC/B,qBAAqB,CAAC,OAAO;YAC7B,eAAe;SAChB;KACF,CAAC,CAAC;IACH,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAI,GAAwB,CAAC,EAAE,CAAC;QACxC,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC3B,MAAM,0BAA0B,CAC9B,EAAE,EACF,qBAAqB,EACrB,kBAAkB,CACnB,CAAC;QACJ,CAAC;IACH,CAAC;IACD,yEAAyE;IACzE,wEAAwE;IACxE,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,GAAG,EAAE;;;;MAIH;QACF,IAAI,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC;KAC9B,CAAC,CAAC;IACH,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,GAAG,EAAE;;wEAE+D;QACpE,IAAI,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC;KAC9B,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAGrC;IAaC,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC7E,MAAM,KAAK,GACT,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7E,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QACpC,GAAG,EAAE;;;;;kBAKS,KAAK,EAAE;QACrB,IAAI,EAAE,CAAC,KAAK,CAAC;KACd,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACpB,MAAM,GAAG,GAAG,CASX,CAAC;QACF,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACzC,MAAM,WAAW,GACf,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC7D,OAAO;YACL,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,QAAQ,EAAE,GAAG,CAAC,SAAS;YACvB,MAAM,EAAE,GAAG,CAAC,OAAO,IAAI,IAAI;YAC3B,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,SAAS,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI;YACjC,WAAW,EAAE,GAAG,CAAC,YAAY,IAAI,IAAI;YACrC,SAAS;YACT,WAAW;YACX,UAAU,EAAE,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,GAAG,SAAS;SACjE,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,KAAa,EACb,KAA8B;IAE9B,OAAO,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,0BAA0B,CACvC,KAAa,EACb,KAA8B,EAC9B,MAAc;IAEd,IAAI,UAAmB,CAAC;IACxB,IAAI,CAAC;QACH,MAAM,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC3C,OAAO;IACT,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,UAAU,GAAG,GAAG,CAAC;IACnB,CAAC;IACD,uEAAuE;IACvE,gDAAgD;IAChD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IAC/D,IAAI,CAAC;QACH,MAAM,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,QAAQ,EAAE,CAAC;QAClB,YAAY,CAAC,QAAQ,EAAE;YACrB,IAAI,EAAE;gBACJ,SAAS,EAAE,iBAAiB;gBAC5B,SAAS,EAAE,uBAAuB;gBAClC,MAAM;aACP;YACD,KAAK,EAAE;gBACL,KAAK;gBACL,SAAS,EAAE,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW;gBACpE,UAAU,EACR,UAAU,YAAY,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;aACxE;SACF,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,KAAK,UAAU,sBAAsB,CACnC,KAAa,EACb,KAA8B;IAE9B,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QACpC,GAAG,EAAE,yFAAyF;QAC9F,IAAI,EAAE,CAAC,KAAK,CAAC;KACd,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAEN,CAAC;IACd,IAAI,IAAI,EAAE,UAAU,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC3C,IACE,MAAM,EAAE,IAAI,KAAK,MAAM;gBACvB,MAAM,EAAE,IAAI,KAAK,OAAO;gBACxB,MAAM,EAAE,IAAI,KAAK,iBAAiB;gBAClC,MAAM,EAAE,IAAI,KAAK,YAAY;gBAC7B,MAAM,EAAE,IAAI,KAAK,eAAe,EAChC,CAAC;gBACD,OAAO;YACT,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,uDAAuD;QACzD,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,GAAG,EAAE,8GAA8G;QACnH,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;KAC9C,CAAC,CAAC;AACL,CAAC","sourcesContent":["/**\n * SQL persistence for agent runs and events.\n * Enables cross-isolate access on Cloudflare Workers and\n * reliable reconnection after page refreshes.\n */\nimport { getDbExec, intType, isPostgres } from \"../db/client.js\";\nimport { captureError } from \"../server/capture-error.js\";\nimport type { AgentChatEvent } from \"./types.js\";\n\nlet _initPromise: Promise<void> | undefined;\n\n/**\n * Max time without a heartbeat before a \"running\" run is considered dead.\n * The run-manager heartbeats every 1.5s, so 15s tolerates ~9 missed writes.\n * Widened from 6s to absorb real-world DB latency spikes and GC pauses that\n * caused false-positive reaps: a live run whose heartbeat lagged 6s+ would be\n * reaped and a zombie would keep running, eventually clobbering the new row.\n */\nexport const RUN_STALE_MS = 15_000;\n\nexport const STALE_RUN_ERROR_EVENT = {\n  type: \"error\",\n  error:\n    \"The agent stopped before it could finish. It may have hit a server timeout or the worker may have been interrupted.\",\n  errorCode: \"stale_run\",\n  recoverable: true,\n  details:\n    \"The run heartbeat stopped while the run was still marked running. Partial output and tool calls were preserved when available.\",\n} as const;\n\nasync function ensureRunTables(): Promise<void> {\n  if (!_initPromise) {\n    _initPromise = (async () => {\n      const client = getDbExec();\n      await client.execute(`\n        CREATE TABLE IF NOT EXISTS agent_runs (\n          id TEXT PRIMARY KEY,\n          thread_id TEXT NOT NULL,\n          status TEXT NOT NULL DEFAULT 'running',\n          abort_reason TEXT,\n          started_at ${intType()} NOT NULL,\n          completed_at ${intType()},\n          heartbeat_at ${intType()},\n          last_progress_at ${intType()},\n          turn_id TEXT,\n          error_code TEXT,\n          error_detail TEXT\n        )\n      `);\n      // Backfill heartbeat_at on older deployments.\n      try {\n        if (isPostgres()) {\n          await client.execute(\n            `ALTER TABLE agent_runs ADD COLUMN IF NOT EXISTS heartbeat_at ${intType()}`,\n          );\n          await client.execute(\n            `ALTER TABLE agent_runs ADD COLUMN IF NOT EXISTS abort_reason TEXT`,\n          );\n        } else {\n          await client.execute(\n            `ALTER TABLE agent_runs ADD COLUMN heartbeat_at ${intType()}`,\n          );\n        }\n      } catch {\n        // Column already exists — ignore\n      }\n      try {\n        if (!isPostgres()) {\n          await client.execute(\n            `ALTER TABLE agent_runs ADD COLUMN abort_reason TEXT`,\n          );\n        }\n      } catch {\n        // Column already exists — ignore\n      }\n      // Backfill last_progress_at — this is distinct from heartbeat_at.\n      // heartbeat_at = \"the producer process is alive\" (bumped on a timer).\n      // last_progress_at = \"the agent is actually emitting events\" (bumped on\n      // each emit). The gap between them is the stuck-detector signal.\n      try {\n        if (isPostgres()) {\n          await client.execute(\n            `ALTER TABLE agent_runs ADD COLUMN IF NOT EXISTS last_progress_at ${intType()}`,\n          );\n        } else {\n          await client.execute(\n            `ALTER TABLE agent_runs ADD COLUMN last_progress_at ${intType()}`,\n          );\n        }\n      } catch {\n        // Column already exists — ignore\n      }\n      // Backfill turn_id / error_code / error_detail.\n      //   turn_id    = stable identity for one logical assistant turn that may\n      //                span several continuation runs, so the durable record\n      //                can be folded across runs instead of dropped per-run.\n      //   error_code / error_detail = terminal failure classification captured\n      //                at completion so errored/cut-off runs are queryable for\n      //                pattern analysis (see listErroredRuns).\n      for (const col of [\"turn_id\", \"error_code\", \"error_detail\"] as const) {\n        try {\n          if (isPostgres()) {\n            await client.execute(\n              `ALTER TABLE agent_runs ADD COLUMN IF NOT EXISTS ${col} TEXT`,\n            );\n          } else {\n            await client.execute(\n              `ALTER TABLE agent_runs ADD COLUMN ${col} TEXT`,\n            );\n          }\n        } catch {\n          // Column already exists — ignore\n        }\n      }\n      await client.execute(`\n        CREATE TABLE IF NOT EXISTS agent_run_events (\n          run_id TEXT NOT NULL,\n          seq ${intType()} NOT NULL,\n          event_data TEXT NOT NULL,\n          PRIMARY KEY (run_id, seq)\n        )\n      `);\n      // Tool-call result ledger: persists the outcome of write tool calls that\n      // completed AFTER their chunk was abandoned (zombie completions). A\n      // resumed continuation can recover the real result by matching\n      // thread_id + tool_key (name:stableInputHash) instead of re-executing\n      // the side effect. Entries are scoped to the thread and expire with it.\n      await client.execute(`\n        CREATE TABLE IF NOT EXISTS agent_tool_ledger (\n          thread_id TEXT NOT NULL,\n          tool_key TEXT NOT NULL,\n          result_summary TEXT NOT NULL,\n          completed_at ${intType()} NOT NULL,\n          PRIMARY KEY (thread_id, tool_key)\n        )\n      `);\n    })().catch((err) => {\n      // Retry init on the next call after a failed startup.\n      _initPromise = undefined;\n      throw err;\n    });\n  }\n  return _initPromise;\n}\n\n// ─── Tool-call result ledger ─────────────────────────────────────────────────\n//\n// When the run-level abort signal fires (soft timeout / user cancel) while a\n// write tool is in-flight, `Promise.race` abandons the call — but the action's\n// Promise continues running in the background (a \"zombie\"). If the zombie\n// resolves before the continuation's next tool dispatch, we record the result\n// here so the continuation can recover it without re-executing the side effect.\n//\n// Keyed by (thread_id, tool_key) where tool_key = \"<toolName>:<stableJsonHash>\".\n// The write is fire-and-forget from the hot path; reads are synchronous look-\n// ups at the start of each write-tool dispatch in the continuation.\n\n/** Max length for a persisted result summary (8 KB). */\nconst LEDGER_RESULT_MAX_CHARS = 8_000;\n\n/**\n * Persist a zombie tool-call completion to the ledger. Called by the detached\n * promise continuation after `Promise.race` abandons it. Best-effort — never\n * throws so a ledger write failure doesn't break any caller.\n */\nexport async function writeLedgerEntry(\n  threadId: string,\n  toolKey: string,\n  resultSummary: string,\n): Promise<void> {\n  try {\n    await ensureRunTables();\n    const client = getDbExec();\n    const capped =\n      resultSummary.length > LEDGER_RESULT_MAX_CHARS\n        ? resultSummary.slice(0, LEDGER_RESULT_MAX_CHARS) +\n          `\\n...[ledger truncated at ${LEDGER_RESULT_MAX_CHARS} chars]`\n        : resultSummary;\n    await client.execute({\n      sql: `INSERT INTO agent_tool_ledger (thread_id, tool_key, result_summary, completed_at)\n            VALUES (?, ?, ?, ?)\n            ON CONFLICT (thread_id, tool_key) DO UPDATE SET\n              result_summary = excluded.result_summary,\n              completed_at = excluded.completed_at`,\n      args: [threadId, toolKey, capped, Date.now()],\n    });\n  } catch {\n    // Ledger is best-effort; never surface failures to the caller.\n  }\n}\n\n/**\n * Look up a prior zombie completion for this thread + tool key. Returns the\n * persisted result summary, or `null` when no entry exists.\n */\nexport async function readLedgerEntry(\n  threadId: string,\n  toolKey: string,\n): Promise<string | null> {\n  try {\n    await ensureRunTables();\n    const client = getDbExec();\n    const { rows } = await client.execute({\n      sql: `SELECT result_summary FROM agent_tool_ledger WHERE thread_id = ? AND tool_key = ?`,\n      args: [threadId, toolKey],\n    });\n    if (rows.length === 0) return null;\n    const row = rows[0] as { result_summary: string };\n    return row.result_summary;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Delete ledger entries for a thread. Called after a turn fully completes so\n * old entries don't bleed into the next turn's disambiguation.\n * Best-effort — never throws.\n */\nexport async function clearLedgerForThread(threadId: string): Promise<void> {\n  try {\n    await ensureRunTables();\n    const client = getDbExec();\n    await client.execute({\n      sql: `DELETE FROM agent_tool_ledger WHERE thread_id = ?`,\n      args: [threadId],\n    });\n  } catch {\n    // Best-effort.\n  }\n}\n\nexport async function insertRun(\n  id: string,\n  threadId: string,\n  turnId?: string,\n): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const now = Date.now();\n  await client.execute({\n    sql: `INSERT INTO agent_runs (id, thread_id, status, started_at, heartbeat_at, last_progress_at, turn_id) VALUES (?, ?, 'running', ?, ?, ?, ?)`,\n    args: [id, threadId, now, now, now, turnId ?? id],\n  });\n}\n\n/**\n * Atomically acquire a run lease for a thread. Succeeds (returns true) only\n * when no other run for the same thread is currently status='running' with a\n * fresh heartbeat. Works for both Postgres and SQLite: the stale-cutoff\n * comparison lets a dead producer's run be replaced without waiting for the\n * reaper, mirroring the logic in `reapIfStale`.\n *\n * Callers that win the claim then insert the run row normally; callers that\n * lose skip the run and return the existing active runId to the caller.\n */\nexport async function tryClaimRunSlot(\n  threadId: string,\n  maxStaleMs: number = RUN_STALE_MS,\n): Promise<{ claimed: boolean; activeRunId: string | null }> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const heartbeatCutoff = Date.now() - maxStaleMs;\n  const { rows } = await client.execute({\n    sql: `SELECT id FROM agent_runs\n          WHERE thread_id = ?\n            AND status = 'running'\n            AND COALESCE(heartbeat_at, started_at) >= ?\n          ORDER BY started_at DESC LIMIT 1`,\n    args: [threadId, heartbeatCutoff],\n  });\n  if (rows.length > 0) {\n    const row = rows[0] as { id: string };\n    return { claimed: false, activeRunId: row.id };\n  }\n  return { claimed: true, activeRunId: null };\n}\n\n/**\n * Record terminal failure classification for a run so cut-off / errored runs\n * can be surfaced for pattern analysis (see listErroredRuns). Best-effort —\n * never throws, since it runs on the completion path that must not fail the run.\n */\nexport async function setRunError(\n  runId: string,\n  errorCode: string | undefined,\n  errorDetail: string | undefined,\n): Promise<void> {\n  if (!errorCode && !errorDetail) return;\n  try {\n    await ensureRunTables();\n    const client = getDbExec();\n    await client.execute({\n      sql: `UPDATE agent_runs SET error_code = ?, error_detail = ? WHERE id = ?`,\n      args: [\n        errorCode ?? null,\n        errorDetail ? errorDetail.slice(0, 2000) : null,\n        runId,\n      ],\n    });\n  } catch {\n    // Diagnostics are best-effort; never let them break completion.\n  }\n}\n\n/** Update the run's liveness heartbeat. Called periodically by run-manager. */\nexport async function updateRunHeartbeat(runId: string): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  await client.execute({\n    sql: `UPDATE agent_runs SET heartbeat_at = ? WHERE id = ?`,\n    args: [Date.now(), runId],\n  });\n}\n\n/**\n * Bump `last_progress_at` — call this whenever the agent actually emits an\n * event (token, tool call, message). Distinct from `heartbeat_at` so the\n * stuck-detector can tell \"process alive but nothing happening\" from\n * \"process dead.\" Callers should throttle (run-manager debounces to ~1/s).\n */\nexport async function bumpRunProgress(runId: string): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  await client.execute({\n    sql: `UPDATE agent_runs SET last_progress_at = ? WHERE id = ?`,\n    args: [Date.now(), runId],\n  });\n}\n\n/**\n * If the given run is marked \"running\" in SQL but its heartbeat is stale\n * (producer likely crashed), flip it to \"errored\" so watchers stop waiting.\n * Returns true if the row was reaped.\n */\nexport async function reapIfStale(\n  runId: string,\n  maxStaleMs: number = RUN_STALE_MS,\n): Promise<boolean> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const completedAt = Date.now();\n  const cutoff = completedAt - maxStaleMs;\n  const { rowsAffected } = await client.execute({\n    sql: `UPDATE agent_runs\n          SET status = 'errored',\n              completed_at = ?,\n              error_code = ?,\n              error_detail = ?\n          WHERE id = ?\n            AND status = 'running'\n            AND COALESCE(heartbeat_at, started_at) < ?`,\n    args: [\n      completedAt,\n      STALE_RUN_ERROR_EVENT.errorCode,\n      STALE_RUN_ERROR_EVENT.details,\n      runId,\n      cutoff,\n    ],\n  });\n  const reaped = (rowsAffected ?? 0) > 0;\n  if (reaped) {\n    await safeAppendTerminalRunEvent(\n      runId,\n      STALE_RUN_ERROR_EVENT,\n      \"reap-if-stale\",\n    );\n  }\n  return reaped;\n}\n\nexport async function updateRunStatus(\n  runId: string,\n  status: \"completed\" | \"errored\" | \"aborted\",\n): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  await client.execute({\n    sql: `UPDATE agent_runs SET status = ?, completed_at = ? WHERE id = ?`,\n    args: [status, Date.now(), runId],\n  });\n}\n\n/**\n * Conditional terminal status write: only updates if the row still belongs to\n * this run AND is still status='running'. Returns true when the update landed.\n *\n * This is the safe variant used by the producer's finally block so a zombie run\n * (reaped while executing) can never clobber the status written by the reaper\n * or a replacement run.\n */\nexport async function updateRunStatusIfRunning(\n  runId: string,\n  status: \"completed\" | \"errored\" | \"aborted\",\n): Promise<boolean> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const { rowsAffected } = await client.execute({\n    sql: `UPDATE agent_runs SET status = ?, completed_at = ? WHERE id = ? AND status = 'running'`,\n    args: [status, Date.now(), runId],\n  });\n  return (rowsAffected ?? 0) > 0;\n}\n\n/** Read the current status of a run row. Returns null when the row is missing. */\nexport async function getRunStatus(runId: string): Promise<string | null> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const { rows } = await client.execute({\n    sql: `SELECT status FROM agent_runs WHERE id = ?`,\n    args: [runId],\n  });\n  if (rows.length === 0) return null;\n  return String((rows[0] as { status: string }).status);\n}\n\nexport async function markRunAborted(\n  runId: string,\n  reason?: string,\n): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  await client.execute({\n    sql: `UPDATE agent_runs SET status = 'aborted', abort_reason = ?, completed_at = ? WHERE id = ?`,\n    args: [reason ?? \"user\", Date.now(), runId],\n  });\n  await safeAppendTerminalRunEvent(runId, { type: \"done\" }, \"mark-aborted\");\n}\n\nexport async function isRunAborted(runId: string): Promise<boolean> {\n  return (await getRunAbortState(runId)).aborted;\n}\n\nexport async function getRunAbortState(\n  runId: string,\n): Promise<{ aborted: boolean; reason?: string }> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const { rows } = await client.execute({\n    sql: `SELECT status, abort_reason FROM agent_runs WHERE id = ?`,\n    args: [runId],\n  });\n  if (rows.length === 0) return { aborted: false };\n  const row = rows[0] as { status: string; abort_reason?: string | null };\n  if (row.status !== \"aborted\") return { aborted: false };\n  return {\n    aborted: true,\n    ...(row.abort_reason ? { reason: row.abort_reason } : {}),\n  };\n}\n\nexport async function insertRunEvent(\n  runId: string,\n  seq: number,\n  eventData: string,\n): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  // ON CONFLICT DO NOTHING: a (runId, seq) collision can happen on the\n  // soft-timeout / terminal-event path where `pendingTerminalEvent` was\n  // assigned a seq that later gets reused by an event pushed after it.\n  // It can also race with `appendTerminalRunEvent` (max-seq + 1) when a\n  // run aborts at the same time the producer emits its final event.\n  // Treat the second write as a no-op so the run completes cleanly.\n  await client.execute({\n    sql: `INSERT INTO agent_run_events (run_id, seq, event_data) VALUES (?, ?, ?) ON CONFLICT (run_id, seq) DO NOTHING`,\n    args: [runId, seq, eventData],\n  });\n}\n\nexport async function getRunEventsSince(\n  runId: string,\n  fromSeq: number,\n): Promise<Array<{ seq: number; eventData: string }>> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const { rows } = await client.execute({\n    sql: `SELECT seq, event_data FROM agent_run_events WHERE run_id = ? AND seq >= ? ORDER BY seq ASC`,\n    args: [runId, fromSeq],\n  });\n  return rows.map((r) => {\n    const row = r as { seq: number | string; event_data: string };\n    return { seq: Number(row.seq), eventData: row.event_data };\n  });\n}\n\nexport async function getRunById(runId: string): Promise<{\n  id: string;\n  threadId: string;\n  status: string;\n  startedAt: number;\n} | null> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const { rows } = await client.execute({\n    sql: `SELECT id, thread_id, status, started_at FROM agent_runs WHERE id = ?`,\n    args: [runId],\n  });\n  if (rows.length === 0) return null;\n  const r = rows[0] as {\n    id: string;\n    thread_id: string;\n    status: string;\n    started_at: number | string;\n  };\n  return {\n    id: r.id,\n    threadId: r.thread_id,\n    status: r.status,\n    startedAt: Number(r.started_at),\n  };\n}\n\nexport async function getRunByThread(\n  threadId: string,\n  options?: { includeTerminal?: boolean },\n): Promise<{\n  id: string;\n  threadId: string;\n  turnId?: string | null;\n  status: string;\n  startedAt: number;\n  heartbeatAt: number | null;\n  completedAt: number | null;\n  lastProgressAt: number | null;\n} | null> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const sql = options?.includeTerminal\n    ? `SELECT id, thread_id, turn_id, status, started_at, heartbeat_at, completed_at, last_progress_at FROM agent_runs WHERE thread_id = ? ORDER BY started_at DESC LIMIT 1`\n    : `SELECT id, thread_id, turn_id, status, started_at, heartbeat_at, completed_at, last_progress_at FROM agent_runs WHERE thread_id = ? AND status = 'running' ORDER BY started_at DESC LIMIT 1`;\n  const { rows } = await client.execute({ sql, args: [threadId] });\n  if (rows.length === 0) return null;\n  const r = rows[0] as {\n    id: string;\n    thread_id: string;\n    turn_id?: string | null;\n    status: string;\n    started_at: number | string;\n    heartbeat_at: number | string | null;\n    completed_at: number | string | null;\n    last_progress_at: number | string | null;\n  };\n  return {\n    id: r.id,\n    threadId: r.thread_id,\n    turnId: r.turn_id ?? null,\n    status: r.status,\n    startedAt: Number(r.started_at),\n    heartbeatAt: r.heartbeat_at == null ? null : Number(r.heartbeat_at),\n    completedAt: r.completed_at == null ? null : Number(r.completed_at),\n    lastProgressAt:\n      r.last_progress_at == null ? null : Number(r.last_progress_at),\n  };\n}\n\nexport interface AgentRunSummary {\n  id: string;\n  threadId: string;\n  turnId: string | null;\n  status: string;\n  startedAt: number;\n  heartbeatAt: number | null;\n  completedAt: number | null;\n  lastProgressAt: number | null;\n  errorCode: string | null;\n  abortReason: string | null;\n}\n\nexport async function listRunsForThread(\n  threadId: string,\n  options: { limit?: number } = {},\n): Promise<AgentRunSummary[]> {\n  await ensureRunTables();\n  const limit = Math.min(Math.max(options.limit ?? 10, 1), 50);\n  const client = getDbExec();\n  const { rows } = await client.execute({\n    sql: `SELECT id, thread_id, turn_id, status, started_at, heartbeat_at, completed_at, last_progress_at, error_code, abort_reason\n          FROM agent_runs\n          WHERE thread_id = ?\n          ORDER BY started_at DESC\n          LIMIT ?`,\n    args: [threadId, limit],\n  });\n  return rows.map((r) => {\n    const row = r as {\n      id: string;\n      thread_id: string;\n      turn_id?: string | null;\n      status: string;\n      started_at: number | string;\n      heartbeat_at?: number | string | null;\n      completed_at?: number | string | null;\n      last_progress_at?: number | string | null;\n      error_code?: string | null;\n      abort_reason?: string | null;\n    };\n    return {\n      id: row.id,\n      threadId: row.thread_id,\n      turnId: row.turn_id ?? null,\n      status: row.status,\n      startedAt: Number(row.started_at),\n      heartbeatAt: row.heartbeat_at == null ? null : Number(row.heartbeat_at),\n      completedAt: row.completed_at == null ? null : Number(row.completed_at),\n      lastProgressAt:\n        row.last_progress_at == null ? null : Number(row.last_progress_at),\n      errorCode: row.error_code ?? null,\n      abortReason: row.abort_reason ?? null,\n    };\n  });\n}\n\n/**\n * Read the current logical turn's recorded events for a thread, parsed into\n * `AgentChatEvent`s in seq order, for per-turn tool-call journal classification\n * (see `tool-call-journal.ts`). Read-only and additive — reuses the existing\n * `agent_runs` / `agent_run_events` ledger with no schema change.\n *\n * A logical turn may span several continuation runs (each chunk is its own run\n * sharing one `turn_id`), so we union the events of every run that belongs to\n * the latest turn for this thread. Events are ordered by (started_at, seq) so\n * earlier chunks come before later ones and the positional `tool_start` →\n * `tool_done` matching in the classifier stays correct across chunk boundaries.\n *\n * Returns an empty array when the thread has no run yet or no parseable events.\n * Best-effort on parse: malformed ledger rows are skipped rather than thrown.\n */\nexport async function getCurrentTurnEventsForThread(\n  threadId: string,\n): Promise<AgentChatEvent[]> {\n  await ensureRunTables();\n  const client = getDbExec();\n  // Find the latest run for this thread (terminal or running) to learn the\n  // logical turn id. The journal is consulted on the resume path, where the\n  // just-interrupted run is typically already terminal.\n  const latest = await client.execute({\n    sql: `SELECT id, turn_id FROM agent_runs WHERE thread_id = ? ORDER BY started_at DESC LIMIT 1`,\n    args: [threadId],\n  });\n  if (latest.rows.length === 0) return [];\n  const latestRow = latest.rows[0] as { id: string; turn_id: string | null };\n  const turnId = latestRow.turn_id ?? latestRow.id;\n  // Gather every run that belongs to this logical turn, oldest chunk first, and\n  // read their events in seq order. COALESCE(turn_id, id) folds older rows that\n  // predate the turn_id backfill into a turn keyed by their own run id.\n  const { rows } = await client.execute({\n    sql: `SELECT e.event_data AS event_data\n          FROM agent_run_events e\n          JOIN agent_runs r ON r.id = e.run_id\n          WHERE r.thread_id = ?\n            AND COALESCE(r.turn_id, r.id) = ?\n          ORDER BY r.started_at ASC, e.seq ASC`,\n    args: [threadId, turnId],\n  });\n  const events: AgentChatEvent[] = [];\n  for (const r of rows) {\n    const raw = (r as { event_data?: string }).event_data;\n    if (!raw) continue;\n    try {\n      events.push(JSON.parse(raw) as AgentChatEvent);\n    } catch {\n      // Skip malformed ledger rows — the journal is best-effort.\n    }\n  }\n  return events;\n}\n\n/**\n * Expire any \"running\" rows whose heartbeat is stale — producer died.\n * Safe to call at server startup on multi-isolate deployments: only rows\n * without a fresh heartbeat get reaped, so runs owned by OTHER live\n * isolates (which keep heartbeating) are left alone.\n */\nexport async function reapAllStaleRuns(): Promise<number> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const heartbeatCutoff = Date.now() - RUN_STALE_MS;\n  const stale = await client.execute({\n    sql: `SELECT id FROM agent_runs\n          WHERE status = 'running'\n            AND COALESCE(heartbeat_at, started_at) < ?`,\n    args: [heartbeatCutoff],\n  });\n  const completedAt = Date.now();\n  const { rowsAffected } = await client.execute({\n    sql: `UPDATE agent_runs\n          SET status = 'errored',\n              completed_at = ?,\n              error_code = ?,\n              error_detail = ?\n          WHERE status = 'running'\n            AND COALESCE(heartbeat_at, started_at) < ?`,\n    args: [\n      completedAt,\n      STALE_RUN_ERROR_EVENT.errorCode,\n      STALE_RUN_ERROR_EVENT.details,\n      heartbeatCutoff,\n    ],\n  });\n  for (const row of stale.rows) {\n    const id = (row as { id?: unknown }).id;\n    if (typeof id === \"string\") {\n      await safeAppendTerminalRunEvent(\n        id,\n        STALE_RUN_ERROR_EVENT,\n        \"reap-all-stale\",\n      );\n    }\n  }\n  return rowsAffected ?? 0;\n}\n\n/** Delete old runs and expire stale \"running\" rows that haven't had activity\n *  (e.g. worker crashed before updating status). Completed runs are pruned at\n *  `olderThanMs`; errored/aborted runs are kept until `erroredOlderThanMs` (a\n *  longer window, falling back to `olderThanMs`) so their event log survives\n *  for cut-off pattern analysis via listErroredRuns. */\nexport async function cleanupOldRuns(\n  olderThanMs: number,\n  erroredOlderThanMs?: number,\n): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const cutoff = Date.now() - olderThanMs;\n  const erroredCutoff =\n    Date.now() - Math.max(erroredOlderThanMs ?? 0, olderThanMs);\n  // Expire stale running rows on the absolute-age threshold — safety net\n  // for runs that never received a heartbeat (very old deployments). The\n  // SELECT covers BOTH UPDATE conditions so the terminal-event-append loop\n  // below catches every row we're about to flip — a 24h-old row with a\n  // somehow-fresh heartbeat would slip past a heartbeat-only SELECT.\n  const heartbeatCutoff = Date.now() - RUN_STALE_MS;\n  const stale = await client.execute({\n    sql: `SELECT id FROM agent_runs\n          WHERE status = 'running'\n            AND (\n              COALESCE(heartbeat_at, started_at) < ?\n              OR started_at < ?\n    )`,\n    args: [heartbeatCutoff, cutoff],\n  });\n  const completedAt = Date.now();\n  await client.execute({\n    sql: `UPDATE agent_runs\n          SET status = 'errored',\n              completed_at = ?,\n              error_code = ?,\n              error_detail = ?\n          WHERE status = 'running' AND started_at < ?`,\n    args: [\n      completedAt,\n      STALE_RUN_ERROR_EVENT.errorCode,\n      STALE_RUN_ERROR_EVENT.details,\n      cutoff,\n    ],\n  });\n  // Also expire runs whose heartbeat is stale — producer has died.\n  await client.execute({\n    sql: `UPDATE agent_runs\n          SET status = 'errored',\n              completed_at = ?,\n              error_code = ?,\n              error_detail = ?\n          WHERE status = 'running'\n            AND COALESCE(heartbeat_at, started_at) < ?`,\n    args: [\n      completedAt,\n      STALE_RUN_ERROR_EVENT.errorCode,\n      STALE_RUN_ERROR_EVENT.details,\n      heartbeatCutoff,\n    ],\n  });\n  for (const row of stale.rows) {\n    const id = (row as { id?: unknown }).id;\n    if (typeof id === \"string\") {\n      await safeAppendTerminalRunEvent(\n        id,\n        STALE_RUN_ERROR_EVENT,\n        \"cleanup-old-runs\",\n      );\n    }\n  }\n  // Delete events for old terminal runs. Completed runs prune at `cutoff`;\n  // errored/aborted runs are retained until the (longer) `erroredCutoff`.\n  await client.execute({\n    sql: `DELETE FROM agent_run_events WHERE run_id IN (\n      SELECT id FROM agent_runs\n      WHERE (status = 'completed' AND completed_at < ?)\n         OR (status IN ('errored', 'aborted') AND completed_at < ?)\n    )`,\n    args: [cutoff, erroredCutoff],\n  });\n  await client.execute({\n    sql: `DELETE FROM agent_runs\n          WHERE (status = 'completed' AND completed_at < ?)\n             OR (status IN ('errored', 'aborted') AND completed_at < ?)`,\n    args: [cutoff, erroredCutoff],\n  });\n}\n\n/**\n * List recent errored/aborted runs for cut-off pattern analysis. Read-only,\n * bounded, and ordered newest-first. Surfaced via the list-errored-runs action\n * so the team can see why chats are failing (terminal error code, duration,\n * turn linkage) instead of discovering it ad hoc.\n */\nexport async function listErroredRuns(options?: {\n  limit?: number;\n  sinceMs?: number;\n}): Promise<\n  Array<{\n    id: string;\n    threadId: string;\n    turnId: string | null;\n    status: string;\n    errorCode: string | null;\n    errorDetail: string | null;\n    startedAt: number;\n    completedAt: number | null;\n    durationMs: number | null;\n  }>\n> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const limit = Math.min(Math.max(Math.floor(options?.limit ?? 100), 1), 1000);\n  const since =\n    options?.sinceMs && options.sinceMs > 0 ? Date.now() - options.sinceMs : 0;\n  const { rows } = await client.execute({\n    sql: `SELECT id, thread_id, turn_id, status, error_code, error_detail, started_at, completed_at\n          FROM agent_runs\n          WHERE status IN ('errored', 'aborted')\n            AND COALESCE(completed_at, started_at) >= ?\n          ORDER BY COALESCE(completed_at, started_at) DESC\n          LIMIT ${limit}`,\n    args: [since],\n  });\n  return rows.map((r) => {\n    const row = r as {\n      id: string;\n      thread_id: string;\n      turn_id: string | null;\n      status: string;\n      error_code: string | null;\n      error_detail: string | null;\n      started_at: number | string;\n      completed_at: number | string | null;\n    };\n    const startedAt = Number(row.started_at);\n    const completedAt =\n      row.completed_at == null ? null : Number(row.completed_at);\n    return {\n      id: row.id,\n      threadId: row.thread_id,\n      turnId: row.turn_id ?? null,\n      status: row.status,\n      errorCode: row.error_code ?? null,\n      errorDetail: row.error_detail ?? null,\n      startedAt,\n      completedAt,\n      durationMs: completedAt == null ? null : completedAt - startedAt,\n    };\n  });\n}\n\n/**\n * Idempotently append a terminal event to a run's event stream. No-op if the\n * stream already ends in a terminal event. Used by reapers AND by SSE\n * reconnect paths that discover an `errored` run row with no terminal event\n * (e.g. an earlier reaper's silent `.catch(() => {})` swallowed the append).\n *\n * Persisting from the reconnect path is what keeps the system self-healing:\n * subsequent reconnects replay the proper terminal event from SQL instead of\n * synthesizing a fresh one each time.\n */\nexport async function ensureTerminalRunEvent(\n  runId: string,\n  event: Record<string, unknown>,\n): Promise<void> {\n  return appendTerminalRunEvent(runId, event);\n}\n\n/**\n * Append a terminal run event, retrying once on failure and reporting to\n * Sentry if both attempts fail. Background reaper paths can't surface errors\n * to a user, but they MUST eventually persist a terminal event — losing it\n * leaves reconnecting clients staring at a bare `status='errored'` row with\n * no payload to render. The previous `.catch(() => {})` callsites silently\n * dropped transient SQL blips and produced exactly that bug. Never throws.\n */\nasync function safeAppendTerminalRunEvent(\n  runId: string,\n  event: Record<string, unknown>,\n  source: string,\n): Promise<void> {\n  let firstError: unknown;\n  try {\n    await appendTerminalRunEvent(runId, event);\n    return;\n  } catch (err) {\n    firstError = err;\n  }\n  // Brief backoff — most \"transient\" SQL failures (connection blip, lock\n  // contention) clear within a couple hundred ms.\n  await new Promise<void>((resolve) => setTimeout(resolve, 100));\n  try {\n    await appendTerminalRunEvent(runId, event);\n  } catch (retryErr) {\n    captureError(retryErr, {\n      tags: {\n        component: \"agent-run-store\",\n        operation: \"append-terminal-event\",\n        source,\n      },\n      extra: {\n        runId,\n        eventType: typeof event.type === \"string\" ? event.type : \"(unknown)\",\n        firstError:\n          firstError instanceof Error ? firstError.message : String(firstError),\n      },\n    });\n  }\n}\n\nasync function appendTerminalRunEvent(\n  runId: string,\n  event: Record<string, unknown>,\n): Promise<void> {\n  await ensureRunTables();\n  const client = getDbExec();\n  const { rows } = await client.execute({\n    sql: `SELECT seq, event_data FROM agent_run_events WHERE run_id = ? ORDER BY seq DESC LIMIT 1`,\n    args: [runId],\n  });\n  const last = rows[0] as\n    | { seq?: number | string; event_data?: string }\n    | undefined;\n  if (last?.event_data) {\n    try {\n      const parsed = JSON.parse(last.event_data);\n      if (\n        parsed?.type === \"done\" ||\n        parsed?.type === \"error\" ||\n        parsed?.type === \"missing_api_key\" ||\n        parsed?.type === \"loop_limit\" ||\n        parsed?.type === \"auto_continue\"\n      ) {\n        return;\n      }\n    } catch {\n      // Ignore malformed rows and append the terminal event.\n    }\n  }\n  const nextSeq = last ? Number(last.seq ?? -1) + 1 : 0;\n  await client.execute({\n    sql: `INSERT INTO agent_run_events (run_id, seq, event_data) VALUES (?, ?, ?) ON CONFLICT (run_id, seq) DO NOTHING`,\n    args: [runId, nextSeq, JSON.stringify(event)],\n  });\n}\n"]}