@axonflow/sdk 2.2.0 → 3.3.0

package/dist/cjs/index.js

@@ -42,7 +42,7 @@
  *
  * @example Proxy Mode
  * ```typescript
- * const response = await axonflow.executeQuery({
+ * const response = await axonflow.proxyLLMCall({
  *   userToken: 'user-123',
  *   query: 'What is the capital of France?',
  *   requestType: 'chat'
@@ -50,26 +50,12 @@
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VERSION = exports.APIError = exports.TimeoutError = exports.RateLimitError = exports.AuthenticationError = exports.PolicyViolationError = exports.PlanExecutionError = exports.ConnectorError = exports.ConnectionError = exports.ConfigurationError = exports.AxonFlowError = exports.wrapBedrockClient = exports.wrapOllamaClient = exports.wrapGeminiModel = exports.wrapAnthropicClient = exports.wrapOpenAIClient = exports.AxonFlow = void 0;
+exports.VERSION = exports.ExecutionHelpers = exports.WorkflowHelpers = exports.APIError = exports.TimeoutError = exports.RateLimitError = exports.AuthenticationError = exports.PolicyViolationError = exports.VersionConflictError = exports.PlanExecutionError = exports.ConnectorError = exports.ConnectionError = exports.ConfigurationError = exports.AxonFlowError = exports.wasRedacted = exports.AxonFlow = void 0;
 var client_1 = require("./client");
 Object.defineProperty(exports, "AxonFlow", { enumerable: true, get: function () { return client_1.AxonFlow; } });
-// LLM Interceptor Wrappers (DEPRECATED - use Gateway Mode or Proxy Mode instead)
-// These will be removed in v2.0.0. See: https://docs.getaxonflow.com/sdk/gateway-mode
-/** @deprecated Use Gateway Mode or Proxy Mode instead */
-var openai_1 = require("./interceptors/openai");
-Object.defineProperty(exports, "wrapOpenAIClient", { enumerable: true, get: function () { return openai_1.wrapOpenAIClient; } });
-/** @deprecated Use Gateway Mode or Proxy Mode instead */
-var anthropic_1 = require("./interceptors/anthropic");
-Object.defineProperty(exports, "wrapAnthropicClient", { enumerable: true, get: function () { return anthropic_1.wrapAnthropicClient; } });
-/** @deprecated Use Gateway Mode or Proxy Mode instead */
-var gemini_1 = require("./interceptors/gemini");
-Object.defineProperty(exports, "wrapGeminiModel", { enumerable: true, get: function () { return gemini_1.wrapGeminiModel; } });
-/** @deprecated Use Gateway Mode or Proxy Mode instead */
-var ollama_1 = require("./interceptors/ollama");
-Object.defineProperty(exports, "wrapOllamaClient", { enumerable: true, get: function () { return ollama_1.wrapOllamaClient; } });
-/** @deprecated Use Gateway Mode or Proxy Mode instead */
-var bedrock_1 = require("./interceptors/bedrock");
-Object.defineProperty(exports, "wrapBedrockClient", { enumerable: true, get: function () { return bedrock_1.wrapBedrockClient; } });
+// Export connector utilities
+var connector_1 = require("./types/connector");
+Object.defineProperty(exports, "wasRedacted", { enumerable: true, get: function () { return connector_1.wasRedacted; } });
 // Export error classes for proper error handling
 var errors_1 = require("./errors");
 Object.defineProperty(exports, "AxonFlowError", { enumerable: true, get: function () { return errors_1.AxonFlowError; } });
@@ -77,13 +63,18 @@ Object.defineProperty(exports, "ConfigurationError", { enumerable: true, get: fu
 Object.defineProperty(exports, "ConnectionError", { enumerable: true, get: function () { return errors_1.ConnectionError; } });
 Object.defineProperty(exports, "ConnectorError", { enumerable: true, get: function () { return errors_1.ConnectorError; } });
 Object.defineProperty(exports, "PlanExecutionError", { enumerable: true, get: function () { return errors_1.PlanExecutionError; } });
+Object.defineProperty(exports, "VersionConflictError", { enumerable: true, get: function () { return errors_1.VersionConflictError; } });
 Object.defineProperty(exports, "PolicyViolationError", { enumerable: true, get: function () { return errors_1.PolicyViolationError; } });
 Object.defineProperty(exports, "AuthenticationError", { enumerable: true, get: function () { return errors_1.AuthenticationError; } });
 Object.defineProperty(exports, "RateLimitError", { enumerable: true, get: function () { return errors_1.RateLimitError; } });
 Object.defineProperty(exports, "TimeoutError", { enumerable: true, get: function () { return errors_1.TimeoutError; } });
 Object.defineProperty(exports, "APIError", { enumerable: true, get: function () { return errors_1.APIError; } });
+var workflows_1 = require("./types/workflows");
+Object.defineProperty(exports, "WorkflowHelpers", { enumerable: true, get: function () { return workflows_1.WorkflowHelpers; } });
+var execution_1 = require("./types/execution");
+Object.defineProperty(exports, "ExecutionHelpers", { enumerable: true, get: function () { return execution_1.ExecutionHelpers; } });
 // Export version
-exports.VERSION = '3.0.0';
+exports.VERSION = '3.2.0';
 // Default export for convenience
 const client_2 = require("./client");
 exports.default = client_2.AxonFlow;

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;;;AAEH,mCAAoC;AAA3B,kGAAA,QAAQ,OAAA;AAEjB,iFAAiF;AACjF,sFAAsF;AACtF,yDAAyD;AACzD,gDAAyD;AAAhD,0GAAA,gBAAgB,OAAA;AACzB,yDAAyD;AACzD,sDAA+D;AAAtD,gHAAA,mBAAmB,OAAA;AAC5B,yDAAyD;AACzD,gDAAwD;AAA/C,yGAAA,eAAe,OAAA;AACxB,yDAAyD;AACzD,gDAAyD;AAAhD,0GAAA,gBAAgB,OAAA;AACzB,yDAAyD;AACzD,kDAA2D;AAAlD,4GAAA,iBAAiB,OAAA;AAE1B,iDAAiD;AACjD,mCAWkB;AAVhB,uGAAA,aAAa,OAAA;AACb,4GAAA,kBAAkB,OAAA;AAClB,yGAAA,eAAe,OAAA;AACf,wGAAA,cAAc,OAAA;AACd,4GAAA,kBAAkB,OAAA;AAClB,8GAAA,oBAAoB,OAAA;AACpB,6GAAA,mBAAmB,OAAA;AACnB,wGAAA,cAAc,OAAA;AACd,sGAAA,YAAY,OAAA;AACZ,kGAAA,QAAQ,OAAA;AA6GV,iBAAiB;AACJ,QAAA,OAAO,GAAG,OAAO,CAAC;AAE/B,iCAAiC;AACjC,qCAAoC;AACpC,kBAAe,iBAAQ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;;;AAEH,mCAAoC;AAA3B,kGAAA,QAAQ,OAAA;AAEjB,6BAA6B;AAC7B,+CAAgD;AAAvC,wGAAA,WAAW,OAAA;AAEpB,iDAAiD;AACjD,mCAYkB;AAXhB,uGAAA,aAAa,OAAA;AACb,4GAAA,kBAAkB,OAAA;AAClB,yGAAA,eAAe,OAAA;AACf,wGAAA,cAAc,OAAA;AACd,4GAAA,kBAAkB,OAAA;AAClB,8GAAA,oBAAoB,OAAA;AACpB,8GAAA,oBAAoB,OAAA;AACpB,6GAAA,mBAAmB,OAAA;AACnB,wGAAA,cAAc,OAAA;AACd,sGAAA,YAAY,OAAA;AACZ,kGAAA,QAAQ,OAAA;AA2JV,+CAAoD;AAA3C,4GAAA,eAAe,OAAA;AAgBxB,+CAAqD;AAA5C,6GAAA,gBAAgB,OAAA;AAEzB,iBAAiB;AACJ,QAAA,OAAO,GAAG,OAAO,CAAC;AAE/B,iCAAiC;AACjC,qCAAoC;AACpC,kBAAe,iBAAQ,CAAC"}

package/dist/cjs/types/connector.d.ts

@@ -22,12 +22,94 @@ export interface ConnectorInstallRequest {
     options: Record<string, any>;
     credentials: Record<string, string>;
 }
+/**
+ * Information about a policy match during evaluation
+ */
+export interface PolicyMatchInfo {
+    policy_id: string;
+    policy_name: string;
+    category: string;
+    severity: string;
+    action: string;
+}
+/**
+ * Policy evaluation information included in MCP responses
+ * Provides transparency into policy enforcement decisions
+ */
+export interface MCPPolicyInfo {
+    policies_evaluated: number;
+    blocked: boolean;
+    block_reason?: string;
+    redactions_applied: number;
+    processing_time_ms: number;
+    matched_policies?: PolicyMatchInfo[];
+    /** Exfiltration check information (Issue #966) */
+    exfiltration_check?: ExfiltrationCheckInfo;
+    /** Dynamic policy evaluation results (Issue #968) */
+    dynamic_policy_info?: DynamicPolicyInfo;
+}
+/**
+ * Information about exfiltration limit checks (Issue #966)
+ * Helps prevent large-scale data extraction via MCP queries
+ */
+export interface ExfiltrationCheckInfo {
+    /** Number of rows in the response */
+    rows_returned: number;
+    /** Configured maximum rows per query */
+    row_limit: number;
+    /** Size of the response data in bytes */
+    bytes_returned: number;
+    /** Configured maximum bytes per response */
+    byte_limit: number;
+    /** Whether the response is within configured limits */
+    within_limits: boolean;
+}
+/**
+ * Information about dynamic policy evaluation (Issue #968)
+ * Dynamic policies are evaluated by the Orchestrator and can include
+ * rate limiting, budget controls, time-based access, and role-based access
+ */
+export interface DynamicPolicyInfo {
+    /** Number of dynamic policies checked */
+    policies_evaluated: number;
+    /** Details about policies that matched */
+    matched_policies?: DynamicPolicyMatch[];
+    /** Whether the Orchestrator was reachable */
+    orchestrator_reachable: boolean;
+    /** Time taken for dynamic policy evaluation */
+    processing_time_ms: number;
+}
+/**
+ * Details about a matched dynamic policy
+ */
+export interface DynamicPolicyMatch {
+    /** Unique identifier of the policy */
+    policy_id: string;
+    /** Human-readable name of the policy */
+    policy_name: string;
+    /** Type of policy (rate-limit, budget, time-access, role-access, mcp, connector) */
+    policy_type: string;
+    /** Action taken (allow, block, log, etc.) */
+    action: string;
+    /** Context for the policy match */
+    reason?: string;
+}
 export interface ConnectorResponse {
     success: boolean;
     data: any;
     error?: string;
     meta?: Record<string, any>;
+    /** Whether any fields in the response were redacted by policy enforcement */
+    redacted?: boolean;
+    /** JSON paths of fields that were redacted (e.g., "data.rows[0].ssn") */
+    redacted_fields?: string[];
+    /** Policy evaluation details for this request/response cycle */
+    policy_info?: MCPPolicyInfo;
 }
+/**
+ * Returns true if the connector response had any fields redacted by policy evaluation.
+ */
+export declare function wasRedacted(response: ConnectorResponse): boolean;
 /**
  * Health status of an installed connector
  */

package/dist/cjs/types/connector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../../src/types/connector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,GAAG,CAAC;IACV,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../../src/types/connector.ts"],"names":[],"mappings":"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"}

package/dist/cjs/types/connector.js

@@ -3,4 +3,11 @@
  * MCP Connector types for AxonFlow SDK
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.wasRedacted = wasRedacted;
+/**
+ * Returns true if the connector response had any fields redacted by policy evaluation.
+ */
+function wasRedacted(response) {
+    return response.redacted === true;
+}
 //# sourceMappingURL=connector.js.map

package/dist/cjs/types/connector.js.map

@@ -1 +1 @@
-{"version":3,"file":"connector.js","sourceRoot":"","sources":["../../../src/types/connector.ts"],"names":[],"mappings":";AAAA;;GAEG"}
+{"version":3,"file":"connector.js","sourceRoot":"","sources":["../../../src/types/connector.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAsHH,kCAEC;AALD;;GAEG;AACH,SAAgB,WAAW,CAAC,QAA2B;IACrD,OAAO,QAAQ,CAAC,QAAQ,KAAK,IAAI,CAAC;AACpC,CAAC"}

package/dist/cjs/types/execution.d.ts

@@ -0,0 +1,227 @@
+/**
+ * Unified Execution Tracking Types for AxonFlow SDK.
+ *
+ * These types provide a consistent interface for tracking both Multi-Agent Planning (MAP)
+ * and Workflow Control Plane (WCP) executions. The unified schema enables consistent
+ * status tracking, progress reporting, and cost tracking across execution types.
+ *
+ * Issue #1075 - EPIC #1074: Unified Workflow Infrastructure
+ */
+/**
+ * Execution type distinguishing between MAP plans and WCP workflows.
+ */
+export type ExecutionType = 'map_plan' | 'wcp_workflow';
+/**
+ * Unified execution status values.
+ */
+export type ExecutionStatusValue = 'pending' | 'running' | 'completed' | 'failed' | 'cancelled' | 'aborted' | 'expired';
+/**
+ * Step status values.
+ */
+export type StepStatusValue = 'pending' | 'running' | 'completed' | 'failed' | 'skipped' | 'blocked' | 'approval';
+/**
+ * Step type indicating what kind of operation the step performs.
+ */
+export type UnifiedStepType = 'llm_call' | 'tool_call' | 'connector_call' | 'human_task' | 'synthesis' | 'action' | 'gate';
+/**
+ * Gate decision values (applicable to both MAP and WCP).
+ */
+export type UnifiedGateDecision = 'allow' | 'block' | 'require_approval';
+/**
+ * Approval status for require_approval decisions.
+ */
+export type UnifiedApprovalStatus = 'pending' | 'approved' | 'rejected';
+/**
+ * Detailed information about an individual execution step.
+ */
+export interface UnifiedStepStatus {
+    /** Unique step identifier */
+    step_id: string;
+    /** Step index in the execution (0-based) */
+    step_index: number;
+    /** Human-readable step name */
+    step_name: string;
+    /** Type of operation the step performs */
+    step_type: UnifiedStepType;
+    /** Current status of the step */
+    status: StepStatusValue;
+    /** When the step started executing */
+    started_at?: string;
+    /** When the step finished */
+    ended_at?: string;
+    /** Duration of step execution (human-readable, e.g., "2.5s") */
+    duration?: string;
+    /** Policy decision for this step (if applicable) */
+    decision?: UnifiedGateDecision;
+    /** Reason for the policy decision */
+    decision_reason?: string;
+    /** IDs of policies that matched during evaluation */
+    policies_matched?: string[];
+    /** Approval status (for require_approval decisions) */
+    approval_status?: UnifiedApprovalStatus;
+    /** Who approved the step (if approved) */
+    approved_by?: string;
+    /** When the step was approved */
+    approved_at?: string;
+    /** LLM model used (if applicable) */
+    model?: string;
+    /** LLM provider (if applicable) */
+    provider?: string;
+    /** Cost in USD for this step */
+    cost_usd?: number;
+    /** Step input data (may be large) */
+    input?: unknown;
+    /** Step output data (may be large) */
+    output?: unknown;
+    /** Human-readable result summary */
+    result_summary?: string;
+    /** Error message if step failed */
+    error?: string;
+}
+/**
+ * Unified execution status for both MAP plans and WCP workflows.
+ *
+ * This type provides a consistent interface for tracking execution progress,
+ * steps, costs, and metadata regardless of the underlying execution type.
+ *
+ * @example
+ * ```typescript
+ * // Get execution status
+ * const status = await client.getExecutionStatus('exec_123');
+ * console.log(`${status.execution_type}: ${status.name}`);
+ * console.log(`Progress: ${status.progress_percent}%`);
+ *
+ * // Check if complete
+ * if (status.status === 'completed') {
+ *   console.log(`Completed in ${status.duration}`);
+ * }
+ *
+ * // Access steps
+ * for (const step of status.steps) {
+ *   console.log(`Step ${step.step_index}: ${step.step_name} - ${step.status}`);
+ * }
+ * ```
+ */
+export interface ExecutionStatus {
+    /** Unique execution identifier */
+    execution_id: string;
+    /** Type of execution (MAP plan or WCP workflow) */
+    execution_type: ExecutionType;
+    /** Human-readable name of the execution */
+    name: string;
+    /** Source orchestrator (WCP-specific: langchain, crewai, etc.) */
+    source?: string;
+    /** Current execution status */
+    status: ExecutionStatusValue;
+    /** Current step being executed (0-based index) */
+    current_step_index: number;
+    /** Total number of steps in the execution */
+    total_steps: number;
+    /** Progress as a percentage (0-100) */
+    progress_percent: number;
+    /** When execution started (ISO 8601 timestamp) */
+    started_at: string;
+    /** When execution completed (ISO 8601 timestamp) */
+    completed_at?: string;
+    /** Duration of execution (human-readable, e.g., "1m 30s") */
+    duration?: string;
+    /** Estimated cost in USD (pre-execution) */
+    estimated_cost_usd?: number;
+    /** Actual cost in USD (post-execution) */
+    actual_cost_usd?: number;
+    /** Detailed step information */
+    steps: UnifiedStepStatus[];
+    /** Error message if execution failed */
+    error?: string;
+    /** Tenant ID for multi-tenancy */
+    tenant_id?: string;
+    /** Organization ID */
+    org_id?: string;
+    /** User ID who initiated the execution */
+    user_id?: string;
+    /** Client/application ID */
+    client_id?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+    /** When the execution record was created */
+    created_at: string;
+    /** When the execution record was last updated */
+    updated_at: string;
+}
+/**
+ * Request to list executions with optional filters.
+ */
+export interface UnifiedListExecutionsRequest {
+    /** Filter by execution type */
+    execution_type?: ExecutionType;
+    /** Filter by status */
+    status?: ExecutionStatusValue;
+    /** Filter by tenant ID */
+    tenant_id?: string;
+    /** Filter by organization ID */
+    org_id?: string;
+    /** Maximum number of results (default 50, max 100) */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+}
+/**
+ * Paginated response for listing executions.
+ */
+export interface UnifiedListExecutionsResponse {
+    /** List of executions */
+    executions: ExecutionStatus[];
+    /** Total count of matching executions */
+    total: number;
+    /** Limit used in the request */
+    limit: number;
+    /** Offset used in the request */
+    offset: number;
+    /** Whether more results are available */
+    has_more: boolean;
+}
+/**
+ * Options for the streamExecutionStatus method.
+ */
+export interface StreamExecutionStatusOptions {
+    /** AbortSignal to cancel the SSE stream */
+    signal?: AbortSignal;
+}
+/**
+ * Helper functions for working with execution types.
+ */
+export declare const ExecutionHelpers: {
+    /**
+     * Check if an execution status is terminal (no more updates expected).
+     */
+    isTerminal(status: ExecutionStatusValue): boolean;
+    /**
+     * Check if a step status is terminal.
+     */
+    isStepTerminal(status: StepStatusValue): boolean;
+    /**
+     * Check if a step is in a blocking state (blocked by policy or awaiting approval).
+     */
+    isStepBlocking(status: StepStatusValue): boolean;
+    /**
+     * Calculate progress percentage from steps.
+     */
+    calculateProgress(steps: UnifiedStepStatus[], totalSteps: number): number;
+    /**
+     * Get the currently running step, if any.
+     */
+    getCurrentStep(execution: ExecutionStatus): UnifiedStepStatus | undefined;
+    /**
+     * Calculate total cost from all steps.
+     */
+    calculateTotalCost(steps: UnifiedStepStatus[]): number;
+    /**
+     * Check if an execution is a MAP plan.
+     */
+    isMapPlan(execution: ExecutionStatus): boolean;
+    /**
+     * Check if an execution is a WCP workflow.
+     */
+    isWcpWorkflow(execution: ExecutionStatus): boolean;
+};
+//# sourceMappingURL=execution.d.ts.map

package/dist/cjs/types/execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../../../src/types/execution.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,cAAc,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B,SAAS,GACT,SAAS,GACT,WAAW,GACX,QAAQ,GACR,WAAW,GACX,SAAS,GACT,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,SAAS,GACT,WAAW,GACX,QAAQ,GACR,SAAS,GACT,SAAS,GACT,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,UAAU,GACV,WAAW,GACX,gBAAgB,GAChB,YAAY,GACZ,WAAW,GACX,QAAQ,GACR,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,OAAO,GAAG,kBAAkB,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAEhB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IAEnB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAElB,0CAA0C;IAC1C,SAAS,EAAE,eAAe,CAAC;IAE3B,iCAAiC;IACjC,MAAM,EAAE,eAAe,CAAC;IAExB,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAE/B,qCAAqC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B,uDAAuD;IACvD,eAAe,CAAC,EAAE,qBAAqB,CAAC;IAExC,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,qCAAqC;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,sCAAsC;IACtC,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,oCAAoC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;IAErB,mDAAmD;IACnD,cAAc,EAAE,aAAa,CAAC;IAE9B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IAEb,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,+BAA+B;IAC/B,MAAM,EAAE,oBAAoB,CAAC;IAE7B,kDAAkD;IAClD,kBAAkB,EAAE,MAAM,CAAC;IAE3B,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IAEpB,uCAAuC;IACvC,gBAAgB,EAAE,MAAM,CAAC;IAEzB,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;IAEnB,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,4CAA4C;IAC5C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,0CAA0C;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,gCAAgC;IAChC,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAE3B,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IAEnB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,+BAA+B;IAC/B,cAAc,CAAC,EAAE,aAAa,CAAC;IAE/B,uBAAuB;IACvB,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAE9B,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,yBAAyB;IACzB,UAAU,EAAE,eAAe,EAAE,CAAC;IAE9B,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IAEd,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IAEd,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IAEf,yCAAyC;IACzC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,2CAA2C;IAC3C,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B;;OAEG;uBACgB,oBAAoB,GAAG,OAAO;IAUjD;;OAEG;2BACoB,eAAe,GAAG,OAAO;IAIhD;;OAEG;2BACoB,eAAe,GAAG,OAAO;IAIhD;;OAEG;6BACsB,iBAAiB,EAAE,cAAc,MAAM,GAAG,MAAM;IAMzE;;OAEG;8BACuB,eAAe,GAAG,iBAAiB,GAAG,SAAS;IAIzE;;OAEG;8BACuB,iBAAiB,EAAE,GAAG,MAAM;IAItD;;OAEG;yBACkB,eAAe,GAAG,OAAO;IAI9C;;OAEG;6BACsB,eAAe,GAAG,OAAO;CAGnD,CAAC"}

package/dist/cjs/types/execution.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * Unified Execution Tracking Types for AxonFlow SDK.
+ *
+ * These types provide a consistent interface for tracking both Multi-Agent Planning (MAP)
+ * and Workflow Control Plane (WCP) executions. The unified schema enables consistent
+ * status tracking, progress reporting, and cost tracking across execution types.
+ *
+ * Issue #1075 - EPIC #1074: Unified Workflow Infrastructure
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExecutionHelpers = void 0;
+/**
+ * Helper functions for working with execution types.
+ */
+exports.ExecutionHelpers = {
+    /**
+     * Check if an execution status is terminal (no more updates expected).
+     */
+    isTerminal(status) {
+        return (status === 'completed' ||
+            status === 'failed' ||
+            status === 'cancelled' ||
+            status === 'aborted' ||
+            status === 'expired');
+    },
+    /**
+     * Check if a step status is terminal.
+     */
+    isStepTerminal(status) {
+        return status === 'completed' || status === 'failed' || status === 'skipped';
+    },
+    /**
+     * Check if a step is in a blocking state (blocked by policy or awaiting approval).
+     */
+    isStepBlocking(status) {
+        return status === 'blocked' || status === 'approval';
+    },
+    /**
+     * Calculate progress percentage from steps.
+     */
+    calculateProgress(steps, totalSteps) {
+        if (totalSteps === 0)
+            return 0;
+        const completedSteps = steps.filter(s => s.status === 'completed').length;
+        return (completedSteps / totalSteps) * 100;
+    },
+    /**
+     * Get the currently running step, if any.
+     */
+    getCurrentStep(execution) {
+        return execution.steps.find(s => s.status === 'running');
+    },
+    /**
+     * Calculate total cost from all steps.
+     */
+    calculateTotalCost(steps) {
+        return steps.reduce((total, step) => total + (step.cost_usd ?? 0), 0);
+    },
+    /**
+     * Check if an execution is a MAP plan.
+     */
+    isMapPlan(execution) {
+        return execution.execution_type === 'map_plan';
+    },
+    /**
+     * Check if an execution is a WCP workflow.
+     */
+    isWcpWorkflow(execution) {
+        return execution.execution_type === 'wcp_workflow';
+    },
+};
+//# sourceMappingURL=execution.js.map

package/dist/cjs/types/execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.js","sourceRoot":"","sources":["../../../src/types/execution.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAwQH;;GAEG;AACU,QAAA,gBAAgB,GAAG;IAC9B;;OAEG;IACH,UAAU,CAAC,MAA4B;QACrC,OAAO,CACL,MAAM,KAAK,WAAW;YACtB,MAAM,KAAK,QAAQ;YACnB,MAAM,KAAK,WAAW;YACtB,MAAM,KAAK,SAAS;YACpB,MAAM,KAAK,SAAS,CACrB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,MAAuB;QACpC,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,SAAS,CAAC;IAC/E,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,MAAuB;QACpC,OAAO,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,UAAU,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,KAA0B,EAAE,UAAkB;QAC9D,IAAI,UAAU,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAC/B,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM,CAAC;QAC1E,OAAO,CAAC,cAAc,GAAG,UAAU,CAAC,GAAG,GAAG,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,SAA0B;QACvC,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,KAA0B;QAC3C,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxE,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,SAA0B;QAClC,OAAO,SAAS,CAAC,cAAc,KAAK,UAAU,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,SAA0B;QACtC,OAAO,SAAS,CAAC,cAAc,KAAK,cAAc,CAAC;IACrD,CAAC;CACF,CAAC"}

package/dist/cjs/types/index.d.ts

@@ -10,4 +10,7 @@ export * from './proxy';
 export * from './code-governance';
 export * from './execution-replay';
 export * from './cost-controls';
+export * from './workflows';
+export * from './masfeat';
+export * from './execution';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/cjs/types/index.js

@@ -26,4 +26,7 @@ __exportStar(require("./proxy"), exports);
 __exportStar(require("./code-governance"), exports);
 __exportStar(require("./execution-replay"), exports);
 __exportStar(require("./cost-controls"), exports);
+__exportStar(require("./workflows"), exports);
+__exportStar(require("./masfeat"), exports);
+__exportStar(require("./execution"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,4CAA0B;AAC1B,6CAA2B;AAC3B,2CAAyB;AACzB,6CAA2B;AAC3B,8CAA4B;AAC5B,6CAA2B;AAC3B,4CAA0B;AAC1B,0CAAwB;AACxB,oDAAkC;AAClC,qDAAmC;AACnC,kDAAgC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,4CAA0B;AAC1B,6CAA2B;AAC3B,2CAAyB;AACzB,6CAA2B;AAC3B,8CAA4B;AAC5B,6CAA2B;AAC3B,4CAA0B;AAC1B,0CAAwB;AACxB,oDAAkC;AAClC,qDAAmC;AACnC,kDAAgC;AAChC,8CAA4B;AAC5B,4CAA0B;AAC1B,8CAA4B"}