avantgate 1.4.0 → 1.6.0

package/dist/client/index.mjs

@@ -0,0 +1,230 @@
+// src/client/browser-exporter.ts
+var DEFAULT_ENDPOINT = "http://localhost:3000/api/v1/ingest/events";
+var DEFAULT_INTERVAL_MS = 3e3;
+var DEFAULT_MAX_BATCH_SIZE = 20;
+var BrowserTelemetryExporter = class {
+  publicKey;
+  endpoint;
+  agentName;
+  runId;
+  batchIntervalMs;
+  maxBatchSize;
+  fetchFn;
+  onError;
+  buffer = [];
+  timer = null;
+  isFlushing = false;
+  isDestroyed = false;
+  handleVisibilityChange = () => {
+    if (typeof document !== "undefined" && document.visibilityState === "hidden") {
+      void this.flush();
+    }
+  };
+  handleBeforeUnload = () => {
+    void this.flush();
+  };
+  constructor(config) {
+    this.publicKey = config.publicKey;
+    this.endpoint = config.endpoint ?? DEFAULT_ENDPOINT;
+    this.agentName = config.agentName;
+    this.runId = config.runId;
+    this.batchIntervalMs = config.batchIntervalMs ?? DEFAULT_INTERVAL_MS;
+    this.maxBatchSize = config.maxBatchSize ?? DEFAULT_MAX_BATCH_SIZE;
+    this.fetchFn = config.fetchFn ?? (typeof fetch !== "undefined" ? fetch.bind(globalThis) : void 0);
+    this.onError = config.onError;
+    this.startTimer();
+    this.setupBrowserListeners();
+  }
+  updateContext = (context) => {
+    if (context.runId !== void 0) {
+      this.runId = context.runId;
+    }
+    if (context.agentName !== void 0) {
+      this.agentName = context.agentName;
+    }
+  };
+  getRunId = () => this.runId;
+  getAgentName = () => this.agentName;
+  startTimer() {
+    if (this.batchIntervalMs <= 0 || typeof setInterval === "undefined") {
+      return;
+    }
+    this.timer = setInterval(() => {
+      void this.flush();
+    }, this.batchIntervalMs);
+  }
+  setupBrowserListeners() {
+    if (typeof document !== "undefined" && typeof document.addEventListener === "function") {
+      document.addEventListener("visibilitychange", this.handleVisibilityChange);
+    }
+    if (typeof window !== "undefined" && typeof window.addEventListener === "function") {
+      window.addEventListener("beforeunload", this.handleBeforeUnload);
+    }
+  }
+  emit = (event) => {
+    if (this.isDestroyed) {
+      return;
+    }
+    this.buffer.push(event);
+    if (this.buffer.length >= this.maxBatchSize) {
+      void this.flush();
+    }
+  };
+  flush = async () => {
+    if (this.isFlushing || this.buffer.length === 0 || !this.fetchFn) {
+      return;
+    }
+    this.isFlushing = true;
+    const batch = [...this.buffer];
+    this.buffer = [];
+    const payload = {
+      runId: this.runId,
+      agentName: this.agentName,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      events: batch
+    };
+    try {
+      await this.dispatchPayload(payload);
+    } catch (err) {
+      this.handleFlushError(err, batch);
+    } finally {
+      this.isFlushing = false;
+    }
+  };
+  dispatchPayload = async (payload) => {
+    if (!this.fetchFn) {
+      throw new Error("No fetch implementation available in current environment");
+    }
+    const response = await this.fetchFn(this.endpoint, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${this.publicKey}`
+      },
+      body: JSON.stringify(payload),
+      keepalive: true
+    });
+    if (!response.ok) {
+      throw new Error(`Browser telemetry ingestion failed: ${response.status} ${response.statusText}`);
+    }
+  };
+  handleFlushError = (err, failedBatch) => {
+    if (!this.isDestroyed && this.buffer.length < this.maxBatchSize * 2) {
+      this.buffer.unshift(...failedBatch);
+    }
+    const error = err instanceof Error ? err : new Error(String(err));
+    if (this.onError) {
+      this.onError(error);
+    }
+  };
+  destroy = () => {
+    this.isDestroyed = true;
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+    if (typeof document !== "undefined" && typeof document.removeEventListener === "function") {
+      document.removeEventListener("visibilitychange", this.handleVisibilityChange);
+    }
+    if (typeof window !== "undefined" && typeof window.removeEventListener === "function") {
+      window.removeEventListener("beforeunload", this.handleBeforeUnload);
+    }
+    void this.flush();
+  };
+};
+
+// src/client/client.ts
+var createAvantGateClient = (config) => {
+  const exporter = new BrowserTelemetryExporter(config);
+  const trackSecurityAlert = (alertType, details) => {
+    const snippet = details.snippet ?? details.matchedPatternSnippet;
+    exporter.emit({
+      type: "CLIENT_SECURITY_ALERT",
+      alertType,
+      inputLength: details.inputLength,
+      snippet,
+      matchedPatternSnippet: snippet,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    });
+  };
+  const trackClientDataRendered = (toolId, options) => {
+    exporter.emit({
+      type: "CLIENT_DATA_RENDERED",
+      toolId,
+      channel: options?.channel,
+      renderedItemCount: options?.renderedItemCount,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    });
+  };
+  const trackFeedback = (feedback) => {
+    exporter.emit({
+      type: "USER_FEEDBACK",
+      rating: feedback.rating,
+      feedbackTag: feedback.tag,
+      userComment: feedback.comment,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    });
+  };
+  return {
+    trackSecurityAlert,
+    trackClientDataRendered,
+    trackFeedback,
+    updateContext: exporter.updateContext,
+    flush: exporter.flush,
+    destroy: exporter.destroy,
+    exporter
+  };
+};
+
+// src/client/useAvantGateTelemetry.ts
+import { useRef, useEffect, useCallback, useMemo } from "react";
+var useAvantGateTelemetry = (config) => {
+  const clientRef = useRef(null);
+  if (!clientRef.current) {
+    clientRef.current = createAvantGateClient(config);
+  }
+  useEffect(() => {
+    clientRef.current?.updateContext({
+      runId: config.runId,
+      agentName: config.agentName
+    });
+  }, [config.runId, config.agentName]);
+  useEffect(() => {
+    return () => {
+      clientRef.current?.destroy();
+      clientRef.current = null;
+    };
+  }, []);
+  const trackSecurityAlert = useCallback(
+    (alertType, details) => {
+      clientRef.current?.trackSecurityAlert(alertType, details);
+    },
+    []
+  );
+  const trackClientDataRendered = useCallback(
+    (toolId, options) => {
+      clientRef.current?.trackClientDataRendered(toolId, options);
+    },
+    []
+  );
+  const trackFeedback = useCallback(
+    (feedback) => {
+      clientRef.current?.trackFeedback(feedback);
+    },
+    []
+  );
+  return useMemo(
+    () => ({
+      trackSecurityAlert,
+      trackClientDataRendered,
+      trackFeedback,
+      exporter: clientRef.current?.exporter
+    }),
+    [trackSecurityAlert, trackClientDataRendered, trackFeedback]
+  );
+};
+export {
+  BrowserTelemetryExporter,
+  createAvantGateClient,
+  useAvantGateTelemetry
+};

package/dist/client/types.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Client Security Alert Event emitted when a local pre-flight guardrail detects an anomaly
+ * (prompt injection attempt, hardcoded API key, unredacted PII) before network egress.
+ */
+export interface ClientSecurityAlertEvent {
+    type: "CLIENT_SECURITY_ALERT";
+    alertType: "POTENTIAL_PROMPT_INJECTION" | "SUSPECTED_SECRET_INPUT" | "SUSPECTED_PII_INPUT";
+    inputLength: number;
+    snippet?: string;
+    matchedPatternSnippet?: string;
+    timestamp: string;
+}
+/**
+ * Client Data Rendered Event emitted when tool output or stream chunks are rendered in UI.
+ */
+export interface ClientDataRenderedEvent {
+    type: "CLIENT_DATA_RENDERED";
+    toolId: string;
+    channel?: "SOCKET" | "STREAM" | "HTTP";
+    renderedItemCount?: number;
+    timestamp: string;
+}
+/**
+ * User Feedback Event emitted when a user rates or comments on an agent response.
+ */
+export interface UserFeedbackEvent {
+    type: "USER_FEEDBACK";
+    rating: "POSITIVE" | "NEGATIVE";
+    feedbackTag?: "HELPFUL" | "INACCURATE" | "UNSAFE" | "OFF_TOPIC";
+    userComment?: string;
+    timestamp: string;
+}
+/**
+ * Union of all supported front-end client telemetry events.
+ */
+export type ClientTelemetryEvent = ClientSecurityAlertEvent | ClientDataRenderedEvent | UserFeedbackEvent;
+/**
+ * Configuration options for BrowserTelemetryExporter.
+ */
+export interface BrowserTelemetryExporterConfig {
+    publicKey: string;
+    endpoint?: string;
+    agentName?: string;
+    runId?: string;
+    batchIntervalMs?: number;
+    maxBatchSize?: number;
+    fetchFn?: typeof fetch;
+    onError?: (error: Error) => void;
+}
+/**
+ * Ingest payload format expected by POST /api/v1/ingest/events according to DESIGN-019.
+ */
+export interface ClientTelemetryIngestPayload {
+    runId?: string;
+    agentName?: string;
+    timestamp: string;
+    events: ClientTelemetryEvent[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/client/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,SAAS,EAAE,4BAA4B,GAAG,wBAAwB,GAAG,qBAAqB,CAAC;IAC3F,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IACvC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,EAAE,UAAU,GAAG,UAAU,CAAC;IAChC,WAAW,CAAC,EAAE,SAAS,GAAG,YAAY,GAAG,QAAQ,GAAG,WAAW,CAAC;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B,wBAAwB,GACxB,uBAAuB,GACvB,iBAAiB,CAAC;AAEtB;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,oBAAoB,EAAE,CAAC;CAChC"}

package/dist/client/useAvantGateTelemetry.d.ts

@@ -0,0 +1,14 @@
+import { type TrackSecurityAlertDetails, type TrackDataRenderedOptions, type TrackFeedbackOptions } from "./client";
+import type { BrowserTelemetryExporterConfig, ClientSecurityAlertEvent } from "./types";
+export type { TrackSecurityAlertDetails, TrackDataRenderedOptions, TrackFeedbackOptions, };
+/**
+ * Lightweight React Hook for front-end telemetry and client-side security event tracking.
+ * Encapsulates lifecycle management, useRef persistence, useCallback and useMemo optimization.
+ */
+export declare const useAvantGateTelemetry: (config: BrowserTelemetryExporterConfig) => {
+    trackSecurityAlert: (alertType: ClientSecurityAlertEvent["alertType"], details: TrackSecurityAlertDetails) => void;
+    trackClientDataRendered: (toolId: string, options?: TrackDataRenderedOptions) => void;
+    trackFeedback: (feedback: TrackFeedbackOptions) => void;
+    exporter: import("./browser-exporter").BrowserTelemetryExporter | undefined;
+};
+//# sourceMappingURL=useAvantGateTelemetry.d.ts.map

package/dist/client/useAvantGateTelemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAvantGateTelemetry.d.ts","sourceRoot":"","sources":["../../src/client/useAvantGateTelemetry.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EAC1B,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EACV,8BAA8B,EAC9B,wBAAwB,EACzB,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,yBAAyB,EACzB,wBAAwB,EACxB,oBAAoB,GACrB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,8BAA8B;oCAuB3D,wBAAwB,CAAC,WAAW,CAAC,WACvC,yBAAyB,KACjC,IAAI;sCAQG,MAAM,YACJ,wBAAwB,KACjC,IAAI;8BAOI,oBAAoB,KAAG,IAAI;;CAezC,CAAC"}

package/dist/index.js

@@ -33,6 +33,7 @@ __export(index_exports, {
   PromptRegistry: () => PromptRegistry,
   PromptTemplate: () => PromptTemplate,
   SEED_MODEL_PRICES: () => SEED_MODEL_PRICES,
+  WorkflowAbortSignal: () => WorkflowAbortSignal,
   WorkflowSagaRollbackError: () => WorkflowSagaRollbackError,
   WorkflowValidationError: () => WorkflowValidationError,
   ZenLLMControlLayer: () => AvantGateControlLayer,
@@ -43,6 +44,7 @@ __export(index_exports, {
   defineWorkflow: () => defineWorkflow,
   executeWorkflow: () => executeWorkflow,
   extractAndCleanJSON: () => extractAndCleanJSON,
+  isWorkflowAbortSignal: () => isWorkflowAbortSignal,
   resolveModelPrice: () => resolveModelPrice,
   resolveModelPriceAsync: () => resolveModelPriceAsync,
   sanitizePII: () => sanitizePII,
@@ -1893,21 +1895,35 @@ var WorkflowValidationError = class extends Error {
     this.issues = issues;
   }
 };
+var WorkflowAbortSignal = class extends Error {
+  __isWorkflowAbort = true;
+  reason;
+  payload;
+  constructor(reason, payload) {
+    super(`Workflow aborted: ${reason}`);
+    this.name = "WorkflowAbortSignal";
+    this.reason = reason;
+    this.payload = payload;
+  }
+};
+var isWorkflowAbortSignal = (value) => {
+  return typeof value === "object" && value !== null && value.__isWorkflowAbort === true;
+};
 
 // src/workflow/engine.ts
-function generateRunId(workflowId) {
+var generateRunId = (workflowId) => {
   const timestamp = Date.now();
   const randomSuffix = Math.random().toString(36).substring(2, 9);
   return `run_${workflowId}_${timestamp}_${randomSuffix}`;
-}
-function validateInput(config, input) {
+};
+var validateInput = (config, input) => {
   const parseResult = config.inputSchema.safeParse(input);
   if (!parseResult.success) {
     throw new WorkflowValidationError(config.id, parseResult.error.issues);
   }
   return parseResult.data;
-}
-function createStepContext(params) {
+};
+var createStepContext = (params) => {
   const { workflowId, stepId, runId, context, stepResults } = params;
   return {
     workflowId,
@@ -1936,10 +1952,13 @@ function createStepContext(params) {
         });
       }
       throw new StepSuspendedError(stepId, workflowId, options?.prompt);
+    },
+    abort: (reason, payload) => {
+      throw new WorkflowAbortSignal(reason, payload);
     }
   };
-}
-async function rollbackSaga(params) {
+};
+var rollbackSaga = async (params) => {
   const {
     workflowId,
     failedStepId,
@@ -1983,12 +2002,38 @@ async function rollbackSaga(params) {
     compensatedSteps,
     failedCompensations
   });
-}
-async function executeWorkflow(config, rawInput, context) {
+};
+var executeWorkflow = async (config, rawInput, context) => {
   const input = validateInput(config, rawInput);
   const runId = context?.runId ?? generateRunId(config.id);
   const stepResults = {};
   const completedSteps = [];
+  const handleAbort = async (stepId, signal) => {
+    stepResults[stepId] = {
+      aborted: true,
+      reason: signal.reason,
+      payload: signal.payload
+    };
+    if (context?.storage) {
+      await context.storage.updateStepStatus(config.id, stepId, "ABORTED", {
+        result: signal.payload,
+        metadata: { abortReason: signal.reason }
+      });
+    }
+    const abortOutput = signal.payload ?? {
+      aborted: true,
+      reason: signal.reason
+    };
+    return {
+      workflowId: config.id,
+      runId,
+      status: "ABORTED",
+      stepResults,
+      abortReason: signal.reason,
+      abortPayload: signal.payload,
+      output: abortOutput
+    };
+  };
   for (const step of config.steps) {
     const stepCtx = createStepContext({
       workflowId: config.id,
@@ -1999,6 +2044,9 @@ async function executeWorkflow(config, rawInput, context) {
     });
     try {
       const result = await step.execute(input, stepCtx);
+      if (isWorkflowAbortSignal(result)) {
+        return await handleAbort(step.id, result);
+      }
       stepResults[step.id] = result;
       completedSteps.push({ step, result });
       if (context?.storage) {
@@ -2013,6 +2061,9 @@ async function executeWorkflow(config, rawInput, context) {
           stepResults
         };
       }
+      if (isWorkflowAbortSignal(error)) {
+        return await handleAbort(step.id, error);
+      }
       await rollbackSaga({
         workflowId: config.id,
         failedStepId: step.id,
@@ -2033,22 +2084,22 @@ async function executeWorkflow(config, rawInput, context) {
     stepResults,
     output: finalOutput
   };
-}
+};
 
 // src/workflow/define-workflow.ts
-function resolveWorkflowImpact(config, options) {
+var resolveWorkflowImpact = (config, options) => {
   if (options?.impact) {
     return options.impact;
   }
   return config.impact ?? "MUTATIVE";
-}
-function resolveRequireApproval(impact, options) {
+};
+var resolveRequireApproval = (impact, options) => {
   if (options?.requireApproval !== void 0) {
     return options.requireApproval;
   }
   return impact === "DESTRUCTIVE";
-}
-function buildToolExecutionContext(options, toolCtx) {
+};
+var buildToolExecutionContext = (options, toolCtx) => {
   const tenantId = typeof toolCtx?.tenantId === "string" ? toolCtx.tenantId : options?.defaultContext?.tenantId;
   const userId = typeof toolCtx?.userId === "string" ? toolCtx.userId : options?.defaultContext?.userId;
   return {
@@ -2057,8 +2108,8 @@ function buildToolExecutionContext(options, toolCtx) {
     services: options?.defaultContext?.services ?? {},
     storage: options?.storage ?? options?.defaultContext?.storage
   };
-}
-function defineWorkflow(config) {
+};
+var defineWorkflow = (config) => {
   const workflowImpact = config.impact ?? "MUTATIVE";
   return {
     id: config.id,
@@ -2102,7 +2153,7 @@ function defineWorkflow(config) {
       return tool;
     }
   };
-}
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AvantGateBudgetExceededError,
@@ -2118,6 +2169,7 @@ function defineWorkflow(config) {
   PromptRegistry,
   PromptTemplate,
   SEED_MODEL_PRICES,
+  WorkflowAbortSignal,
   WorkflowSagaRollbackError,
   WorkflowValidationError,
   ZenLLMControlLayer,
@@ -2128,6 +2180,7 @@ function defineWorkflow(config) {
   defineWorkflow,
   executeWorkflow,
   extractAndCleanJSON,
+  isWorkflowAbortSignal,
   resolveModelPrice,
   resolveModelPriceAsync,
   sanitizePII,

package/dist/index.mjs

@@ -3,11 +3,13 @@ import {
   validateWithZod
 } from "./chunk-CO26LNFD.mjs";
 import {
+  WorkflowAbortSignal,
   WorkflowSagaRollbackError,
   WorkflowValidationError,
   defineWorkflow,
-  executeWorkflow
-} from "./chunk-DTM2OLCG.mjs";
+  executeWorkflow,
+  isWorkflowAbortSignal
+} from "./chunk-4XWO3NZW.mjs";
 import {
   sanitizePII
 } from "./chunk-5VA3EKPJ.mjs";
@@ -1049,6 +1051,7 @@ export {
   PromptRegistry,
   PromptTemplate,
   SEED_MODEL_PRICES,
+  WorkflowAbortSignal,
   WorkflowSagaRollbackError,
   WorkflowValidationError,
   AvantGateControlLayer as ZenLLMControlLayer,
@@ -1059,6 +1062,7 @@ export {
   defineWorkflow,
   executeWorkflow,
   extractAndCleanJSON,
+  isWorkflowAbortSignal,
   resolveModelPrice,
   resolveModelPriceAsync,
   sanitizePII,

package/dist/workflow/define-workflow.d.ts

@@ -1,3 +1,3 @@
 import type { WorkflowConfig, WorkflowInstance } from "./types";
-export declare function defineWorkflow<TInput = any, TOutput = any>(config: WorkflowConfig<TInput, TOutput>): WorkflowInstance<TInput, TOutput>;
+export declare const defineWorkflow: <TInput = any, TOutput = any>(config: WorkflowConfig<TInput, TOutput>) => WorkflowInstance<TInput, TOutput>;
 //# sourceMappingURL=define-workflow.d.ts.map

package/dist/workflow/define-workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define-workflow.d.ts","sourceRoot":"","sources":["../../src/workflow/define-workflow.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,cAAc,EAGd,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAmCjB,wBAAgB,cAAc,CAAC,MAAM,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG,EACxD,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,GACtC,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CA8DnC"}
+{"version":3,"file":"define-workflow.d.ts","sourceRoot":"","sources":["../../src/workflow/define-workflow.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,cAAc,EAGd,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAmCjB,eAAO,MAAM,cAAc,GAAI,MAAM,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG,EACxD,QAAQ,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,KACtC,gBAAgB,CAAC,MAAM,EAAE,OAAO,CA8DlC,CAAA"}

package/dist/workflow/engine.d.ts

@@ -1,3 +1,3 @@
 import type { WorkflowConfig, WorkflowExecutionContext, WorkflowExecutionResult } from "./types";
-export declare function executeWorkflow<TInput, TOutput>(config: WorkflowConfig<TInput, TOutput>, rawInput: TInput, context?: WorkflowExecutionContext): Promise<WorkflowExecutionResult<TOutput>>;
+export declare const executeWorkflow: <TInput, TOutput>(config: WorkflowConfig<TInput, TOutput>, rawInput: TInput, context?: WorkflowExecutionContext) => Promise<WorkflowExecutionResult<TOutput>>;
 //# sourceMappingURL=engine.d.ts.map

package/dist/workflow/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/workflow/engine.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,cAAc,EACd,wBAAwB,EACxB,uBAAuB,EAGxB,MAAM,SAAS,CAAC;AAsHjB,wBAAsB,eAAe,CAAC,MAAM,EAAE,OAAO,EACnD,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAyD3C"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/workflow/engine.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,cAAc,EACd,wBAAwB,EACxB,uBAAuB,EAGxB,MAAM,SAAS,CAAC;AAyHjB,eAAO,MAAM,eAAe,GAAU,MAAM,EAAE,OAAO,EACnD,QAAQ,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,UAAU,MAAM,EAChB,UAAU,wBAAwB,KACjC,OAAO,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAmG1C,CAAA"}

package/dist/workflow/errors.d.ts

@@ -21,4 +21,11 @@ export declare class WorkflowValidationError extends Error {
     readonly issues: unknown[];
     constructor(workflowId: string, issues: unknown[]);
 }
+export declare class WorkflowAbortSignal<TPayload = unknown> extends Error {
+    readonly __isWorkflowAbort = true;
+    readonly reason: string;
+    readonly payload?: TPayload;
+    constructor(reason: string, payload?: TPayload);
+}
+export declare const isWorkflowAbortSignal: (value: unknown) => value is WorkflowAbortSignal;
 //# sourceMappingURL=errors.d.ts.map

package/dist/workflow/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/workflow/errors.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,mBAAmB,EAAE,wBAAwB,EAAE,CAAC;gBAE7C,MAAM,EAAE;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,OAAO,CAAC;QACvB,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,mBAAmB,CAAC,EAAE,wBAAwB,EAAE,CAAC;KAClD;CAiBF;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;gBAEf,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE;CAMlD"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/workflow/errors.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,mBAAmB,EAAE,wBAAwB,EAAE,CAAC;gBAE7C,MAAM,EAAE;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,OAAO,CAAC;QACvB,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,mBAAmB,CAAC,EAAE,wBAAwB,EAAE,CAAC;KAClD;CAiBF;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;gBAEf,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE;CAMlD;AAED,qBAAa,mBAAmB,CAAC,QAAQ,GAAG,OAAO,CAAE,SAAQ,KAAK;IAChE,QAAQ,CAAC,iBAAiB,QAAQ;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC;gBAEhB,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ;CAM/C;AAED,eAAO,MAAM,qBAAqB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,mBAM/D,CAAC"}

package/dist/workflow/index.d.ts

@@ -1,5 +1,5 @@
 export { defineWorkflow } from "./define-workflow";
 export { executeWorkflow } from "./engine";
-export { WorkflowSagaRollbackError, WorkflowValidationError, type FailedCompensationRecord, } from "./errors";
+export { WorkflowSagaRollbackError, WorkflowValidationError, WorkflowAbortSignal, isWorkflowAbortSignal, type FailedCompensationRecord, } from "./errors";
 export type { WorkflowAsToolOptions, WorkflowConfig, WorkflowExecutionContext, WorkflowExecutionResult, WorkflowInstance, WorkflowStepConfig, WorkflowStepContext, } from "./types";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,KAAK,wBAAwB,GAC9B,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,qBAAqB,EACrB,cAAc,EACd,wBAAwB,EACxB,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,wBAAwB,GAC9B,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,qBAAqB,EACrB,cAAc,EACd,wBAAwB,EACxB,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,SAAS,CAAC"}