@slashfi/agents-sdk 0.24.4 → 0.25.0

package/src/server.ts

@@ -45,9 +45,7 @@ import { type OIDCProviderConfig, createOIDCSignIn } from "./oidc-signin.js";
 import type { AgentRegistry } from "./registry.js";
 import type { AgentDefinition, CallAgentRequest, Visibility } from "./types.js";
 
-import type {
-  AgentCallbackTrigger,
-} from "./callback/index.js";
+import { callAgentInputSchema } from "./call-agent-schema.js";
 
 // ============================================
 // Server Types
@@ -434,37 +432,7 @@ function getToolDefinitions() {
       name: "call_agent",
       description:
         "Execute a tool on a registered agent. Provide the agent path and tool name.",
-      inputSchema: {
-        type: "object",
-        properties: {
-          request: {
-            type: "object",
-            description: "The call request",
-            properties: {
-              action: {
-                type: "string",
-                enum: ["execute_tool", "describe_tools", "load"],
-                description: "Action to perform",
-              },
-              path: {
-                type: "string",
-                description: "Agent path (e.g., '@my-agent')",
-              },
-              tool: {
-                type: "string",
-                description: "Tool name to call",
-              },
-              params: {
-                type: "object",
-                description: "Parameters for the tool",
-                additionalProperties: true,
-              },
-            },
-            required: ["action", "path"],
-          },
-        },
-        required: ["request"],
-      },
+      inputSchema: callAgentInputSchema,
     },
     {
       name: "list_agents",
@@ -576,7 +544,6 @@ export function createAgentServer(
   ) {
     switch (toolName) {
       case "call_agent": {
-        const trigger = args.trigger as AgentCallbackTrigger | undefined;
         const req = (args.request ?? args) as CallAgentRequest;
 
         // Inject auth context
@@ -592,12 +559,6 @@ export function createAgentServer(
           req.callerType = "system";
         }
 
-        // Pass trigger through to registry.call() which handles
-        // deferred execution via callbackStore if configured.
-        if (trigger) {
-          req.trigger = trigger;
-        }
-
         // Process secret params: resolve refs, store raw secrets
         if ((req as any).params && secretStore) {
           const ownerId = auth?.callerId ?? "anonymous";

package/src/types.ts

@@ -702,8 +702,6 @@ export interface AgentDefinition<TContext extends ToolContext = ToolContext> {
 // CallAgent Request Types
 // ============================================
 
-import type { AgentCallbackTrigger } from "./callback/index.js";
-
 /** Base request fields */
 interface CallAgentBaseRequest {
   /** Target agent path */
@@ -714,9 +712,6 @@ interface CallAgentBaseRequest {
   callerType?: CallerType;
   /** Additional metadata */
   metadata?: Record<string, unknown>;
-  /** When present, the call is deferred and stored as a callback.
-   *  The call executes when the trigger fires with the required values. */
-  trigger?: AgentCallbackTrigger;
 }
 
 /** Invoke: fire-and-forget */
@@ -835,13 +830,6 @@ export interface CallAgentErrorResponse {
   code?: string;
 }
 
-/** Success response for deferred callback creation */
-export interface CallAgentCallbackResponse {
-  success: true;
-  callbackId: string;
-  message: string;
-}
-
 /** Union of all response types */
 export type CallAgentResponse =
   | CallAgentInvokeResponse
@@ -850,5 +838,4 @@ export type CallAgentResponse =
   | CallAgentDescribeToolsResponse
   | CallAgentLoadResponse
   | CallAgentLearnResponse
-  | CallAgentCallbackResponse
   | CallAgentErrorResponse;

package/dist/callback/index.d.ts

@@ -1,79 +0,0 @@
-/**
- * Agent Callback — Deferred call_agent execution with triggers.
- *
- * An agent_callback is a call_agent command with an optional trigger.
- * When the trigger fires (e.g., user submits a form), template references
- * like {{trigger.variable_name}} are resolved with the trigger's values
- * and the call_agent command is executed.
- *
- * This module provides the unopinionated contract:
- * - Trigger schema (extensible discriminated union)
- * - Template resolution
- * - Store interface
- * - Validation utilities
- *
- * No platform-specific code (no Slack, no CockroachDB, no Atlas).
- */
-/**
- * Base trigger type. Implementations extend this with specific trigger sources
- * (e.g., slack_block_kit, webhook, timer).
- *
- * The `type` field discriminates between trigger sources.
- * Additional fields are trigger-specific.
- */
-export interface AgentCallbackTrigger {
-    type: string;
-    [key: string]: unknown;
-}
-export type AgentCallbackStatus = 'pending' | 'completed' | 'expired' | 'cancelled';
-/**
- * A stored agent_callback — a call_agent command waiting for its trigger to fire.
- */
-export interface AgentCallbackEntry {
-    id: string;
-    status: AgentCallbackStatus;
-    /** The call_agent command (includes trigger). Params may contain {{trigger.x}} templates. */
-    callback: Record<string, unknown>;
-    /** Key-value attributes for this callback (e.g., creator info, trigger metadata). */
-    attributes: Record<string, string>;
-    createdAt: Date;
-    completedAt?: Date;
-}
-export interface CreateAgentCallbackOptions {
-    /** The call_agent command (includes trigger). May contain {{trigger.x}} template references in params. */
-    callback: Record<string, unknown>;
-    /** Initial attributes to set on creation. */
-    attributes?: Record<string, string>;
-}
-export interface ResolveAgentCallbackOptions {
-    /** The callback ID to resolve. */
-    id: string;
-    /** Values from the trigger source, keyed by variable name. */
-    values: Record<string, string>;
-}
-/**
- * Agent Callback Store — persistence layer for deferred call_agent commands.
- * Implementations can use any backing store (CockroachDB, SQLite, in-memory, etc.).
- */
-export interface AgentCallbackStore {
-    create(options: CreateAgentCallbackOptions): Promise<string>;
-    get(id: string): Promise<AgentCallbackEntry | null>;
-    resolve(options: ResolveAgentCallbackOptions): Promise<AgentCallbackEntry>;
-    cancel(id: string): Promise<boolean>;
-    listPending(limit?: number): Promise<AgentCallbackEntry[]>;
-}
-/**
- * Resolve {{trigger.variable}} references in an object tree.
- * Scans all string values and replaces {{trigger.x}} with the
- * corresponding value from triggerValues.
- *
- * Unresolved references are left as-is.
- */
-export declare function resolveCallbackTemplates<T>(obj: T, triggerValues: Record<string, string>): T;
-/**
- * Validate that all {{trigger.x}} references in a callback have
- * corresponding variables in the provided set.
- * Returns array of unresolved variable names, or empty if valid.
- */
-export declare function validateCallbackTemplates(callback: Record<string, unknown>, knownVariables: string[]): string[];
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/callback/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAMD,MAAM,MAAM,mBAAmB,GAC3B,SAAS,GACT,WAAW,GACX,SAAS,GACT,WAAW,CAAC;AAMhB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,mBAAmB,CAAC;IAC5B,6FAA6F;IAC7F,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,qFAAqF;IACrF,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,CAAC,EAAE,IAAI,CAAC;CACpB;AAMD,MAAM,WAAW,0BAA0B;IACzC,0GAA0G;IAC1G,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAMD,MAAM,WAAW,2BAA2B;IAC1C,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAMD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7D,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IACpD,OAAO,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC3E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;CAC5D;AAMD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,EACxC,GAAG,EAAE,CAAC,EACN,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,CAAC,CAiBH;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,cAAc,EAAE,MAAM,EAAE,GACvB,MAAM,EAAE,CAoBV"}

package/dist/callback/index.js

@@ -1,70 +0,0 @@
-/**
- * Agent Callback — Deferred call_agent execution with triggers.
- *
- * An agent_callback is a call_agent command with an optional trigger.
- * When the trigger fires (e.g., user submits a form), template references
- * like {{trigger.variable_name}} are resolved with the trigger's values
- * and the call_agent command is executed.
- *
- * This module provides the unopinionated contract:
- * - Trigger schema (extensible discriminated union)
- * - Template resolution
- * - Store interface
- * - Validation utilities
- *
- * No platform-specific code (no Slack, no CockroachDB, no Atlas).
- */
-// ---------------------------------------------------------------------------
-// Template Resolution
-// ---------------------------------------------------------------------------
-/**
- * Resolve {{trigger.variable}} references in an object tree.
- * Scans all string values and replaces {{trigger.x}} with the
- * corresponding value from triggerValues.
- *
- * Unresolved references are left as-is.
- */
-export function resolveCallbackTemplates(obj, triggerValues) {
-    if (typeof obj === 'string') {
-        return obj.replace(/\{\{trigger\.(\w+)\}\}/g, (_match, varName) => {
-            return triggerValues[varName] ?? `{{trigger.${varName}}}`;
-        });
-    }
-    if (Array.isArray(obj)) {
-        return obj.map((item) => resolveCallbackTemplates(item, triggerValues));
-    }
-    if (obj !== null && typeof obj === 'object') {
-        const result = {};
-        for (const [key, val] of Object.entries(obj)) {
-            result[key] = resolveCallbackTemplates(val, triggerValues);
-        }
-        return result;
-    }
-    return obj;
-}
-/**
- * Validate that all {{trigger.x}} references in a callback have
- * corresponding variables in the provided set.
- * Returns array of unresolved variable names, or empty if valid.
- */
-export function validateCallbackTemplates(callback, knownVariables) {
-    const definedVars = new Set(knownVariables);
-    const referencedVars = [];
-    const scanForRefs = (obj) => {
-        if (typeof obj === 'string') {
-            const matches = obj.matchAll(/\{\{trigger\.(\w+)\}\}/g);
-            for (const match of matches) {
-                referencedVars.push(match[1]);
-            }
-        }
-        else if (Array.isArray(obj)) {
-            obj.forEach(scanForRefs);
-        }
-        else if (obj !== null && typeof obj === 'object') {
-            Object.values(obj).forEach(scanForRefs);
-        }
-    };
-    scanForRefs(callback);
-    return referencedVars.filter((v) => !definedVars.has(v));
-}
-//# sourceMappingURL=index.js.map

package/dist/callback/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/callback/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAoFH,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,GAAM,EACN,aAAqC;IAErC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,GAAG,CAAC,OAAO,CAAC,yBAAyB,EAAE,CAAC,MAAM,EAAE,OAAe,EAAE,EAAE;YACxE,OAAO,aAAa,CAAC,OAAO,CAAC,IAAI,aAAa,OAAO,IAAI,CAAC;QAC5D,CAAC,CAAM,CAAC;IACV,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,wBAAwB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAM,CAAC;IAC/E,CAAC;IACD,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5C,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAA8B,CAAC,EAAE,CAAC;YACxE,MAAM,CAAC,GAAG,CAAC,GAAG,wBAAwB,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,MAAW,CAAC;IACrB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,QAAiC,EACjC,cAAwB;IAExB,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC;IAC5C,MAAM,cAAc,GAAa,EAAE,CAAC;IAEpC,MAAM,WAAW,GAAG,CAAC,GAAY,EAAQ,EAAE;QACzC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC;YACxD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9B,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC3B,CAAC;aAAM,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACnD,MAAM,CAAC,MAAM,CAAC,GAA8B,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACrE,CAAC;IACH,CAAC,CAAC;IAEF,WAAW,CAAC,QAAQ,CAAC,CAAC;IAEtB,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/cjs/callback/index.js

@@ -1,74 +0,0 @@
-"use strict";
-/**
- * Agent Callback — Deferred call_agent execution with triggers.
- *
- * An agent_callback is a call_agent command with an optional trigger.
- * When the trigger fires (e.g., user submits a form), template references
- * like {{trigger.variable_name}} are resolved with the trigger's values
- * and the call_agent command is executed.
- *
- * This module provides the unopinionated contract:
- * - Trigger schema (extensible discriminated union)
- * - Template resolution
- * - Store interface
- * - Validation utilities
- *
- * No platform-specific code (no Slack, no CockroachDB, no Atlas).
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveCallbackTemplates = resolveCallbackTemplates;
-exports.validateCallbackTemplates = validateCallbackTemplates;
-// ---------------------------------------------------------------------------
-// Template Resolution
-// ---------------------------------------------------------------------------
-/**
- * Resolve {{trigger.variable}} references in an object tree.
- * Scans all string values and replaces {{trigger.x}} with the
- * corresponding value from triggerValues.
- *
- * Unresolved references are left as-is.
- */
-function resolveCallbackTemplates(obj, triggerValues) {
-    if (typeof obj === 'string') {
-        return obj.replace(/\{\{trigger\.(\w+)\}\}/g, (_match, varName) => {
-            return triggerValues[varName] ?? `{{trigger.${varName}}}`;
-        });
-    }
-    if (Array.isArray(obj)) {
-        return obj.map((item) => resolveCallbackTemplates(item, triggerValues));
-    }
-    if (obj !== null && typeof obj === 'object') {
-        const result = {};
-        for (const [key, val] of Object.entries(obj)) {
-            result[key] = resolveCallbackTemplates(val, triggerValues);
-        }
-        return result;
-    }
-    return obj;
-}
-/**
- * Validate that all {{trigger.x}} references in a callback have
- * corresponding variables in the provided set.
- * Returns array of unresolved variable names, or empty if valid.
- */
-function validateCallbackTemplates(callback, knownVariables) {
-    const definedVars = new Set(knownVariables);
-    const referencedVars = [];
-    const scanForRefs = (obj) => {
-        if (typeof obj === 'string') {
-            const matches = obj.matchAll(/\{\{trigger\.(\w+)\}\}/g);
-            for (const match of matches) {
-                referencedVars.push(match[1]);
-            }
-        }
-        else if (Array.isArray(obj)) {
-            obj.forEach(scanForRefs);
-        }
-        else if (obj !== null && typeof obj === 'object') {
-            Object.values(obj).forEach(scanForRefs);
-        }
-    };
-    scanForRefs(callback);
-    return referencedVars.filter((v) => !definedVars.has(v));
-}
-//# sourceMappingURL=index.js.map

package/dist/cjs/callback/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/callback/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;AA+FH,4DAoBC;AAOD,8DAuBC;AA7DD,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E;;;;;;GAMG;AACH,SAAgB,wBAAwB,CACtC,GAAM,EACN,aAAqC;IAErC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,GAAG,CAAC,OAAO,CAAC,yBAAyB,EAAE,CAAC,MAAM,EAAE,OAAe,EAAE,EAAE;YACxE,OAAO,aAAa,CAAC,OAAO,CAAC,IAAI,aAAa,OAAO,IAAI,CAAC;QAC5D,CAAC,CAAM,CAAC;IACV,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,wBAAwB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAM,CAAC;IAC/E,CAAC;IACD,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5C,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAA8B,CAAC,EAAE,CAAC;YACxE,MAAM,CAAC,GAAG,CAAC,GAAG,wBAAwB,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,MAAW,CAAC;IACrB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,SAAgB,yBAAyB,CACvC,QAAiC,EACjC,cAAwB;IAExB,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC;IAC5C,MAAM,cAAc,GAAa,EAAE,CAAC;IAEpC,MAAM,WAAW,GAAG,CAAC,GAAY,EAAQ,EAAE;QACzC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC;YACxD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9B,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC3B,CAAC;aAAM,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACnD,MAAM,CAAC,MAAM,CAAC,GAA8B,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACrE,CAAC;IACH,CAAC,CAAC;IAEF,WAAW,CAAC,QAAQ,CAAC,CAAC;IAEtB,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/src/callback/index.ts

@@ -1,161 +0,0 @@
-/**
- * Agent Callback — Deferred call_agent execution with triggers.
- *
- * An agent_callback is a call_agent command with an optional trigger.
- * When the trigger fires (e.g., user submits a form), template references
- * like {{trigger.variable_name}} are resolved with the trigger's values
- * and the call_agent command is executed.
- *
- * This module provides the unopinionated contract:
- * - Trigger schema (extensible discriminated union)
- * - Template resolution
- * - Store interface
- * - Validation utilities
- *
- * No platform-specific code (no Slack, no CockroachDB, no Atlas).
- */
-
-// ---------------------------------------------------------------------------
-// Trigger Schema
-// ---------------------------------------------------------------------------
-
-/**
- * Base trigger type. Implementations extend this with specific trigger sources
- * (e.g., slack_block_kit, webhook, timer).
- *
- * The `type` field discriminates between trigger sources.
- * Additional fields are trigger-specific.
- */
-export interface AgentCallbackTrigger {
-  type: string;
-  [key: string]: unknown;
-}
-
-// ---------------------------------------------------------------------------
-// Callback Status
-// ---------------------------------------------------------------------------
-
-export type AgentCallbackStatus =
-  | 'pending'
-  | 'completed'
-  | 'expired'
-  | 'cancelled';
-
-// ---------------------------------------------------------------------------
-// Callback Entry
-// ---------------------------------------------------------------------------
-
-/**
- * A stored agent_callback — a call_agent command waiting for its trigger to fire.
- */
-export interface AgentCallbackEntry {
-  id: string;
-  status: AgentCallbackStatus;
-  /** The call_agent command (includes trigger). Params may contain {{trigger.x}} templates. */
-  callback: Record<string, unknown>;
-  /** Key-value attributes for this callback (e.g., creator info, trigger metadata). */
-  attributes: Record<string, string>;
-  createdAt: Date;
-  completedAt?: Date;
-}
-
-// ---------------------------------------------------------------------------
-// Create Options
-// ---------------------------------------------------------------------------
-
-export interface CreateAgentCallbackOptions {
-  /** The call_agent command (includes trigger). May contain {{trigger.x}} template references in params. */
-  callback: Record<string, unknown>;
-  /** Initial attributes to set on creation. */
-  attributes?: Record<string, string>;
-}
-
-// ---------------------------------------------------------------------------
-// Resolve Options
-// ---------------------------------------------------------------------------
-
-export interface ResolveAgentCallbackOptions {
-  /** The callback ID to resolve. */
-  id: string;
-  /** Values from the trigger source, keyed by variable name. */
-  values: Record<string, string>;
-}
-
-// ---------------------------------------------------------------------------
-// Store Interface
-// ---------------------------------------------------------------------------
-
-/**
- * Agent Callback Store — persistence layer for deferred call_agent commands.
- * Implementations can use any backing store (CockroachDB, SQLite, in-memory, etc.).
- */
-export interface AgentCallbackStore {
-  create(options: CreateAgentCallbackOptions): Promise<string>;
-  get(id: string): Promise<AgentCallbackEntry | null>;
-  resolve(options: ResolveAgentCallbackOptions): Promise<AgentCallbackEntry>;
-  cancel(id: string): Promise<boolean>;
-  listPending(limit?: number): Promise<AgentCallbackEntry[]>;
-}
-
-// ---------------------------------------------------------------------------
-// Template Resolution
-// ---------------------------------------------------------------------------
-
-/**
- * Resolve {{trigger.variable}} references in an object tree.
- * Scans all string values and replaces {{trigger.x}} with the
- * corresponding value from triggerValues.
- *
- * Unresolved references are left as-is.
- */
-export function resolveCallbackTemplates<T>(
-  obj: T,
-  triggerValues: Record<string, string>,
-): T {
-  if (typeof obj === 'string') {
-    return obj.replace(/\{\{trigger\.(\w+)\}\}/g, (_match, varName: string) => {
-      return triggerValues[varName] ?? `{{trigger.${varName}}}`;
-    }) as T;
-  }
-  if (Array.isArray(obj)) {
-    return obj.map((item) => resolveCallbackTemplates(item, triggerValues)) as T;
-  }
-  if (obj !== null && typeof obj === 'object') {
-    const result: Record<string, unknown> = {};
-    for (const [key, val] of Object.entries(obj as Record<string, unknown>)) {
-      result[key] = resolveCallbackTemplates(val, triggerValues);
-    }
-    return result as T;
-  }
-  return obj;
-}
-
-/**
- * Validate that all {{trigger.x}} references in a callback have
- * corresponding variables in the provided set.
- * Returns array of unresolved variable names, or empty if valid.
- */
-export function validateCallbackTemplates(
-  callback: Record<string, unknown>,
-  knownVariables: string[],
-): string[] {
-  const definedVars = new Set(knownVariables);
-  const referencedVars: string[] = [];
-
-  const scanForRefs = (obj: unknown): void => {
-    if (typeof obj === 'string') {
-      const matches = obj.matchAll(/\{\{trigger\.(\w+)\}\}/g);
-      for (const match of matches) {
-        referencedVars.push(match[1]);
-      }
-    } else if (Array.isArray(obj)) {
-      obj.forEach(scanForRefs);
-    } else if (obj !== null && typeof obj === 'object') {
-      Object.values(obj as Record<string, unknown>).forEach(scanForRefs);
-    }
-  };
-
-  scanForRefs(callback);
-
-  return referencedVars.filter((v) => !definedVars.has(v));
-}