@agentfield/sdk 0.1.110 → 0.1.111-rc.1

package/dist/index.js

@@ -1,6 +1,6 @@
-import fs, { promises } from 'fs';
+import fs, { promises, readFileSync } from 'fs';
 import * as path2 from 'path';
-import path2__default, { resolve } from 'path';
+import path2__default, { resolve, dirname } from 'path';
 import { createRequire } from 'module';
 import { spawn } from 'child_process';
 import express from 'express';
@@ -25,6 +25,7 @@ import { Buffer as Buffer$1 } from 'buffer';
 import { zodToJsonSchema } from 'zod-to-json-schema';
 import { generateKeyPair, exportJWK, importJWK, CompactEncrypt, compactDecrypt } from 'jose';
 import { readFile } from 'fs/promises';
+import { fileURLToPath } from 'url';
 
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -454,7 +455,7 @@ function resolveIdleMs(idleSeconds) {
   return seconds > 0 ? seconds * 1e3 : void 0;
 }
 function runCli(cmd, options) {
-  return new Promise((resolve2, reject) => {
+  return new Promise((resolve3, reject) => {
     const [bin, ...args] = cmd;
     const env = { ...process.env, ...options?.env };
     applyOpenRouterAttributionEnv(env);
@@ -514,7 +515,7 @@ function runCli(cmd, options) {
       }
       settled = true;
       cleanup();
-      resolve2({ stdout, stderr, exitCode: code ?? 0 });
+      resolve3({ stdout, stderr, exitCode: code ?? 0 });
     });
     proc.on("error", (err) => {
       if (settled) {
@@ -1008,8 +1009,8 @@ var init_runner = __esm({
         return base + jitter;
       }
       sleep(delaySeconds) {
-        return new Promise((resolve2) => {
-          setTimeout(resolve2, Math.max(0, delaySeconds) * 1e3);
+        return new Promise((resolve3) => {
+          setTimeout(resolve3, Math.max(0, delaySeconds) * 1e3);
         });
       }
     };
@@ -1200,8 +1201,8 @@ var PauseManager = class {
       return existing.promise;
     }
     let resolveFn;
-    const promise = new Promise((resolve2) => {
-      resolveFn = resolve2;
+    const promise = new Promise((resolve3) => {
+      resolveFn = resolve3;
     });
     this.pending.set(approvalRequestId, { resolve: resolveFn, promise });
     if (executionId) {
@@ -1423,7 +1424,7 @@ var ApprovalClient = class {
   }
 };
 function sleep(ms) {
-  return new Promise((resolve2) => setTimeout(resolve2, ms));
+  return new Promise((resolve3) => setTimeout(resolve3, ms));
 }
 
 // src/triggers/factories.ts
@@ -1481,6 +1482,77 @@ function triggerToPayload(trigger) {
   const _exhaustive = trigger;
   throw new TypeError(`Unknown trigger kind: ${_exhaustive}`);
 }
+
+// src/triggers/dispatch.ts
+function isTriggerEnvelope(body) {
+  if (!body || typeof body !== "object" || Array.isArray(body)) return false;
+  const obj = body;
+  if (!("event" in obj && "_meta" in obj)) return false;
+  const meta = obj._meta;
+  if (!meta || typeof meta !== "object" || Array.isArray(meta)) return false;
+  return "trigger_id" in meta;
+}
+function unwrapEnvelope(body) {
+  if (!isTriggerEnvelope(body)) {
+    return { input: body };
+  }
+  const meta = body._meta;
+  let receivedAt;
+  try {
+    receivedAt = new Date(meta.received_at);
+    if (isNaN(receivedAt.getTime())) {
+      receivedAt = /* @__PURE__ */ new Date();
+    }
+  } catch {
+    receivedAt = /* @__PURE__ */ new Date();
+  }
+  const triggerContext = {
+    triggerId: meta.trigger_id,
+    source: meta.source,
+    eventType: meta.event_type,
+    eventId: meta.event_id,
+    idempotencyKey: meta.idempotency_key,
+    receivedAt,
+    vcId: meta.vc_id
+  };
+  return {
+    input: body.event,
+    triggerContext
+  };
+}
+function applyTriggerTransform(triggerContext, bindings, input) {
+  if (!bindings || bindings.length === 0) return input;
+  let bestMatch;
+  let bestSpecificity = -1;
+  for (const binding of bindings) {
+    if (binding.kind !== "event") continue;
+    if (binding.spec.source !== triggerContext.source) continue;
+    const types = binding.spec.types ?? [];
+    if (types.length > 0) {
+      const matched = types.some(
+        (t) => triggerContext.eventType === t || triggerContext.eventType.startsWith(t + ".")
+      );
+      if (!matched) continue;
+      if (1 > bestSpecificity) {
+        bestMatch = binding;
+        bestSpecificity = 1;
+      }
+    } else {
+      if (0 > bestSpecificity) {
+        bestMatch = binding;
+        bestSpecificity = 0;
+      }
+    }
+  }
+  if (bestMatch?.spec.transform) {
+    try {
+      return bestMatch.spec.transform(input);
+    } catch {
+      return input;
+    }
+  }
+  return input;
+}
 var store = new AsyncLocalStorage();
 var ExecutionContext = class {
   input;
@@ -1830,6 +1902,12 @@ var ReasonerContext = class {
    * CPU loops, check `ctx.signal.aborted` periodically and throw.
    */
   signal;
+  /**
+   * Trigger context populated when the reasoner was invoked by an inbound
+   * webhook event or cron schedule. `undefined` for direct calls via
+   * `app.call(...)` or HTTP POST without a dispatcher envelope.
+   */
+  trigger;
   constructor(params) {
     this.input = params.input;
     this.executionId = params.executionId;
@@ -1852,6 +1930,7 @@ var ReasonerContext = class {
     this.workflow = params.workflow;
     this.did = params.did;
     this.signal = params.signal ?? new AbortController().signal;
+    this.trigger = params.trigger;
   }
   ai(prompt, options) {
     if (options?.tools) {
@@ -2165,7 +2244,7 @@ var StatelessRateLimiter = class {
     }
   }
   async _sleep(delaySeconds) {
-    await new Promise((resolve2) => setTimeout(resolve2, delaySeconds * 1e3));
+    await new Promise((resolve3) => setTimeout(resolve3, delaySeconds * 1e3));
   }
   _now() {
     return Date.now() / 1e3;
@@ -3289,7 +3368,7 @@ var AgentFieldClient = class {
   }
 };
 function sleep2(ms) {
-  return new Promise((resolve2) => setTimeout(resolve2, ms));
+  return new Promise((resolve3) => setTimeout(resolve3, ms));
 }
 async function safePauseCallback(cb) {
   if (!cb) return;
@@ -4748,6 +4827,44 @@ var Agent = class {
     }
     return this;
   }
+  /**
+   * Sugar for registering an event-triggered reasoner.
+   *
+   * Equivalent to:
+   * ```ts
+   * app.reasoner(name, handler, { triggers: [eventTrigger(spec)] });
+   * ```
+   *
+   * The reasoner name defaults to `handler.name` when not provided.
+   */
+  onEvent(spec, handler, options) {
+    const name = spec.name || handler.name || `on_${spec.source}`;
+    const { name: _discarded, ...triggerSpec } = spec;
+    const binding = eventTrigger(triggerSpec);
+    return this.reasoner(name, handler, {
+      ...options,
+      triggers: [...options?.triggers ?? [], binding]
+    });
+  }
+  /**
+   * Sugar for registering a schedule-triggered (cron) reasoner.
+   *
+   * Equivalent to:
+   * ```ts
+   * app.reasoner(name, handler, { triggers: [scheduleTrigger({ cron })] });
+   * ```
+   *
+   * The reasoner name defaults to `handler.name` when not provided.
+   */
+  onSchedule(cron, handler, options) {
+    const name = options?.name || handler.name || "on_schedule";
+    const binding = scheduleTrigger({ cron, timezone: options?.timezone });
+    const { name: _discarded, timezone: _tz, ...restOptions } = options ?? {};
+    return this.reasoner(name, handler, {
+      ...restOptions,
+      triggers: [...restOptions?.triggers ?? [], binding]
+    });
+  }
   skill(name, handler, options) {
     this.skills.register(name, handler, options);
     if (options?.requireRealtimeValidation) {
@@ -4918,9 +5035,9 @@ var Agent = class {
     try {
       const result = await Promise.race([
         future,
-        new Promise((resolve2) => {
+        new Promise((resolve3) => {
           timer = setTimeout(() => {
-            resolve2(
+            resolve3(
               new ApprovalResult({
                 decision: "expired",
                 feedback: "timed out waiting for approval",
@@ -4973,8 +5090,8 @@ var Agent = class {
     const port = this.config.port ?? 8001;
     const host = this.config.host ?? "0.0.0.0";
     await this.agentFieldClient.heartbeat("starting");
-    await new Promise((resolve2, reject) => {
-      this.server = this.app.listen(port, host, () => resolve2()).on("error", reject);
+    await new Promise((resolve3, reject) => {
+      this.server = this.app.listen(port, host, () => resolve3()).on("error", reject);
     });
     this.memoryEventClient.start();
     this.startHeartbeat();
@@ -4984,10 +5101,10 @@ var Agent = class {
       clearInterval(this.heartbeatTimer);
     }
     this.pauseManager.cancelAll();
-    await new Promise((resolve2, reject) => {
+    await new Promise((resolve3, reject) => {
       this.server?.close((err) => {
         if (err) reject(err);
-        else resolve2();
+        else resolve3();
       });
     });
     this.memoryEventClient.stop();
@@ -4998,6 +5115,12 @@ var Agent = class {
     if (!agentId || agentId === this.config.nodeId) {
       const local = this.reasoners.get(name);
       if (!local) throw new Error(`Reasoner not found: ${name}`);
+      const { input: unwrappedInput, triggerContext } = unwrapEnvelope(input);
+      let resolvedInput = unwrappedInput;
+      if (triggerContext) {
+        const bindings = local.options?.triggers ?? [];
+        resolvedInput = applyTriggerTransform(triggerContext, bindings, unwrappedInput);
+      }
       const runId2 = parentMetadata?.runId ?? parentMetadata?.executionId ?? randomUUID();
       const rootWorkflowId2 = parentMetadata?.rootWorkflowId ?? parentMetadata?.workflowId ?? runId2;
       const metadata = {
@@ -5012,7 +5135,7 @@ var Agent = class {
       const dummyReq = {};
       const dummyRes = {};
       const execCtx = new ExecutionContext({
-        input,
+        input: resolvedInput,
         metadata: {
           ...metadata,
           executionId: metadata.executionId ?? randomUUID()
@@ -5069,7 +5192,7 @@ var Agent = class {
         try {
           const result = await local.handler(
             new ReasonerContext({
-              input,
+              input: resolvedInput,
               executionId: execCtx.metadata.executionId,
               runId: execCtx.metadata.runId,
               sessionId: execCtx.metadata.sessionId,
@@ -5088,7 +5211,8 @@ var Agent = class {
               aiClient: this.aiClient,
               memory: this.getMemoryInterface(execCtx.metadata),
               workflow: this.getWorkflowReporter(execCtx.metadata),
-              did: this.getDidInterface(execCtx.metadata, input, name)
+              did: this.getDidInterface(execCtx.metadata, resolvedInput, name),
+              trigger: triggerContext
             })
           );
           this.executionLogger.system("reasoner.completed", "Reasoner execution completed", {
@@ -5851,8 +5975,14 @@ var Agent = class {
       rootWorkflowId: params.metadata.rootWorkflowId ?? params.metadata.workflowId ?? params.metadata.runId ?? params.metadata.executionId,
       reasonerId: params.metadata.reasonerId ?? params.targetName
     };
+    const { input: unwrappedInput, triggerContext } = unwrapEnvelope(params.input);
+    let resolvedInput = unwrappedInput;
+    if (triggerContext) {
+      const bindings = reasoner.options?.triggers ?? [];
+      resolvedInput = applyTriggerTransform(triggerContext, bindings, unwrappedInput);
+    }
     const execCtx = new ExecutionContext({
-      input: params.input,
+      input: resolvedInput,
       metadata: executionMetadata,
       req,
       res,
@@ -5881,7 +6011,7 @@ var Agent = class {
       });
       try {
         const ctx = new ReasonerContext({
-          input: params.input,
+          input: resolvedInput,
           executionId: executionMetadata.executionId,
           runId: executionMetadata.runId,
           sessionId: executionMetadata.sessionId,
@@ -5900,8 +6030,9 @@ var Agent = class {
           aiClient: this.aiClient,
           memory: this.getMemoryInterface(executionMetadata),
           workflow: this.getWorkflowReporter(executionMetadata),
-          did: this.getDidInterface(executionMetadata, params.input, params.targetName),
-          signal: controller.signal
+          did: this.getDidInterface(executionMetadata, resolvedInput, params.targetName),
+          signal: controller.signal,
+          trigger: triggerContext
         });
         const result = await reasoner.handler(ctx);
         this.executionLogger.system("reasoner.completed", "Reasoner execution completed", {
@@ -6146,7 +6277,7 @@ var Agent = class {
     const timeoutMs = 5 * 60 * 1e3;
     const deadline = Date.now() + timeoutMs;
     while (Date.now() < deadline) {
-      await new Promise((resolve2) => setTimeout(resolve2, pollInterval));
+      await new Promise((resolve3) => setTimeout(resolve3, pollInterval));
       try {
         const node = await this.agentFieldClient.getNode(this.config.nodeId);
         const status = node?.lifecycle_status;
@@ -7575,14 +7706,62 @@ var OpenRouterMediaProvider = class {
   }
 };
 function sleep3(ms) {
-  return new Promise((resolve2) => setTimeout(resolve2, ms));
+  return new Promise((resolve3) => setTimeout(resolve3, ms));
 }
 
 // src/harness/index.ts
 init_types();
 init_factory();
 init_runner();
+async function simulateTrigger(handler, options) {
+  const body = options.body ?? {};
+  const triggerContext = {
+    triggerId: options.triggerId ?? `trg_sim_${randomUUID().slice(0, 12)}`,
+    source: options.source,
+    eventType: options.eventType ?? "",
+    eventId: options.eventId ?? `evt_sim_${randomUUID().slice(0, 12)}`,
+    idempotencyKey: options.idempotencyKey ?? `idem_sim_${randomUUID().slice(0, 12)}`,
+    receivedAt: options.receivedAt ?? /* @__PURE__ */ new Date(),
+    vcId: options.vcId
+  };
+  let resolvedInput = body;
+  if (options.bindings && options.bindings.length > 0) {
+    resolvedInput = applyTriggerTransform(triggerContext, options.bindings, body);
+  }
+  const ctx = {
+    input: resolvedInput,
+    trigger: triggerContext,
+    executionId: `exec_sim_${randomUUID().slice(0, 12)}`
+  };
+  return handler(ctx);
+}
+async function simulateSchedule(handler, options) {
+  return simulateTrigger(handler, {
+    source: "cron",
+    body: options?.cron ? { cron: options.cron } : {},
+    eventType: "tick",
+    receivedAt: options?.receivedAt,
+    bindings: options?.bindings
+  });
+}
+function loadFixture(source) {
+  const dir = dirname(fileURLToPath(import.meta.url));
+  const candidates = [
+    resolve(dir, "fixtures", `${source}.json`),
+    resolve(dir, "..", "src", "triggers", "fixtures", `${source}.json`)
+  ];
+  for (const fixturePath of candidates) {
+    try {
+      const content = readFileSync(fixturePath, "utf-8");
+      return JSON.parse(content);
+    } catch {
+    }
+  }
+  throw new Error(
+    `No fixture for source="${source}". Looked at ${candidates.join(", ")}`
+  );
+}
 
-export { ACTIVE_STATUSES, AIClient, Agent, AgentRouter, ApprovalClient, ApprovalResult, Audio, CANONICAL_STATUSES, DIDAuthenticator, DidClient, DidInterface, DidManager, ExecutionContext, ExecutionLogger, ExecutionStatus, File, HEADER_CALLER_DID, HEADER_DID_NONCE, HEADER_DID_SIGNATURE, HEADER_DID_TIMESTAMP, HarnessRunner, Image, JWE_ALG, JWE_ENC, KEY_AGREEMENT_TYPE, MediaProviderError, MediaRouter, MemoryClient, MemoryClientBase, MemoryEventClient, MemoryInterface, MultimodalResponse, OpenRouterMediaProvider, PauseClock, PauseManager, PayloadEncryptionError, RateLimitError, RealtimeSession, ReasonerContext, SUPPORTED_PROVIDERS, SUPPORTED_SESSION_TRANSPORTS, SessionTransportError, SkillContext, StatelessRateLimiter, TERMINAL_STATUSES, Text, Video, WorkflowReporter, audioFromBase64, audioFromBuffer, audioFromFile, audioFromUrl, buildProvider, buildSessionDefinition, buildToolConfig, capabilitiesToTools, capabilityToMetadataTool, capabilityToTool, createExecutionLogger, createHarnessResult, createMetrics, createMultimodalResponse, createRawResult, decrypt, decryptToString, encryptForDid, encryptToJwk, eventTrigger, executeToolCallLoop, extractKeyAgreementJwk, fileFromBase64, fileFromBuffer, fileFromPath, fileFromUrl, generateX25519KeyPair, getCurrentContext, getCurrentSkillContext, imageFromBase64, imageFromBuffer, imageFromFile, imageFromUrl, installApprovalWebhookRoute, isActive, isExecutionLogBatchPayload, isTerminal, normalizeExecutionLogEntry, normalizeSessionTransportValue, normalizeStatus, scheduleTrigger, serializeExecutionLogEntry, text, triggerToPayload, validateSessionTransport, videoFromBase64, videoFromBuffer, videoFromFile, videoFromUrl };
+export { ACTIVE_STATUSES, AIClient, Agent, AgentRouter, ApprovalClient, ApprovalResult, Audio, CANONICAL_STATUSES, DIDAuthenticator, DidClient, DidInterface, DidManager, ExecutionContext, ExecutionLogger, ExecutionStatus, File, HEADER_CALLER_DID, HEADER_DID_NONCE, HEADER_DID_SIGNATURE, HEADER_DID_TIMESTAMP, HarnessRunner, Image, JWE_ALG, JWE_ENC, KEY_AGREEMENT_TYPE, MediaProviderError, MediaRouter, MemoryClient, MemoryClientBase, MemoryEventClient, MemoryInterface, MultimodalResponse, OpenRouterMediaProvider, PauseClock, PauseManager, PayloadEncryptionError, RateLimitError, RealtimeSession, ReasonerContext, SUPPORTED_PROVIDERS, SUPPORTED_SESSION_TRANSPORTS, SessionTransportError, SkillContext, StatelessRateLimiter, TERMINAL_STATUSES, Text, Video, WorkflowReporter, applyTriggerTransform, audioFromBase64, audioFromBuffer, audioFromFile, audioFromUrl, buildProvider, buildSessionDefinition, buildToolConfig, capabilitiesToTools, capabilityToMetadataTool, capabilityToTool, createExecutionLogger, createHarnessResult, createMetrics, createMultimodalResponse, createRawResult, decrypt, decryptToString, encryptForDid, encryptToJwk, eventTrigger, executeToolCallLoop, extractKeyAgreementJwk, fileFromBase64, fileFromBuffer, fileFromPath, fileFromUrl, generateX25519KeyPair, getCurrentContext, getCurrentSkillContext, imageFromBase64, imageFromBuffer, imageFromFile, imageFromUrl, installApprovalWebhookRoute, isActive, isExecutionLogBatchPayload, isTerminal, isTriggerEnvelope, loadFixture, normalizeExecutionLogEntry, normalizeSessionTransportValue, normalizeStatus, scheduleTrigger, serializeExecutionLogEntry, simulateSchedule, simulateTrigger, text, triggerToPayload, unwrapEnvelope, validateSessionTransport, videoFromBase64, videoFromBuffer, videoFromFile, videoFromUrl };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map