@ggakila/agentx-framework 0.1.0

package/dist/types/runtime.d.ts

@@ -0,0 +1,31 @@
+import { WorkflowDefinition, WorkflowExecution } from './workflow';
+import { ToolSpec } from './tool';
+import { TransportConfig } from './transport';
+import { Agent, AgentConfig } from './agent';
+import { Credential } from './credential';
+/**
+ * Core AgentX Runtime Interface
+ * Main entry point for the agentx framework
+ */
+export interface AgentXRuntime {
+    registerWorkflow(definition: WorkflowDefinition): Promise<void>;
+    executeWorkflow(id: string, input?: unknown): Promise<WorkflowExecution>;
+    registerTool(spec: ToolSpec, transport: TransportConfig): Promise<void>;
+    listTools(): Promise<ToolSpec[]>;
+    createAgent(config: AgentConfig): Promise<Agent>;
+    setCredential(scope: string, credential: Credential): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+/**
+ * Runtime configuration and metadata
+ */
+export interface RuntimeMetadata {
+    version: string;
+    startedAt: Date;
+    uptime: number;
+    activeWorkflows: number;
+    registeredTools: number;
+    activeAgents: number;
+}
+//# sourceMappingURL=runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/types/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;GAGG;AACH,MAAM,WAAW,aAAa;IAE5B,gBAAgB,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAGzE,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAGjC,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAGjD,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGpE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/types/runtime.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=runtime.js.map

package/dist/types/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/types/runtime.ts"],"names":[],"mappings":""}

package/dist/types/tool.d.ts

@@ -0,0 +1,72 @@
+import { JSONSchema7 } from 'json-schema';
+/**
+ * Tool System Types
+ */
+export interface ToolSpec {
+    name: string;
+    version: string;
+    description?: string;
+    inputSchema?: JSONSchema7;
+    outputSchema?: JSONSchema7;
+    metadata?: ToolMetadata;
+}
+export interface ToolMetadata {
+    category: string;
+    tags: string[];
+    author?: string;
+    documentation?: string;
+    requirements?: string[];
+}
+export interface ToolContext {
+    executionId: string;
+    workflowId: string;
+    stepId: string;
+    credentials: Record<string, unknown>;
+    logger: Logger;
+    metrics: MetricsCollector;
+}
+export interface ToolExecutor {
+    execute(input: unknown, context: ToolContext): Promise<ToolResult>;
+}
+export interface ToolResult {
+    success: boolean;
+    data?: unknown;
+    error?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface Logger {
+    debug(message: string, meta?: Record<string, unknown>): void;
+    info(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    error(message: string, error?: Error, meta?: Record<string, unknown>): void;
+}
+export interface MetricsCollector {
+    increment(metric: string, tags?: Record<string, string>): void;
+    gauge(metric: string, value: number, tags?: Record<string, string>): void;
+    histogram(metric: string, value: number, tags?: Record<string, string>): void;
+    timing(metric: string, duration: number, tags?: Record<string, string>): void;
+}
+export interface ToolRegistry {
+    tools: Map<string, RegisteredTool>;
+    register(spec: ToolSpec, transport: Transport): Promise<void>;
+    unregister(name: string): Promise<void>;
+    get(name: string): Promise<RegisteredTool | null>;
+    list(): Promise<RegisteredTool[]>;
+    search(query: ToolQuery): Promise<RegisteredTool[]>;
+}
+export interface RegisteredTool {
+    spec: ToolSpec;
+    transport: Transport;
+    registeredAt: Date;
+    lastUsed?: Date;
+    usageCount: number;
+    healthStatus: 'healthy' | 'unhealthy' | 'unknown';
+}
+export interface ToolQuery {
+    category?: string;
+    tags?: string[];
+    name?: string;
+    version?: string;
+}
+import { Transport } from './transport';
+//# sourceMappingURL=tool.d.ts.map

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

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

package/dist/types/tool.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=tool.js.map

package/dist/types/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/types/tool.ts"],"names":[],"mappings":""}

package/dist/types/transport.d.ts

@@ -0,0 +1,53 @@
+import { ToolSpec, ToolContext, ToolResult } from './tool';
+/**
+ * Transport System Types
+ */
+export interface Transport {
+    name: string;
+    initialize(config: TransportConfig): Promise<void>;
+    execute(tool: string, input: unknown, context: ToolContext): Promise<ToolResult>;
+    listTools(): Promise<ToolSpec[]>;
+    healthCheck(): Promise<boolean>;
+    shutdown(): Promise<void>;
+}
+export interface TransportConfig {
+    type: 'local' | 'http' | 'stdio' | 'queue';
+    config: Record<string, unknown>;
+}
+export interface LocalTransportConfig extends TransportConfig {
+    type: 'local';
+    config: {
+        modulePath: string;
+        className?: string;
+    };
+}
+export interface HttpTransportConfig extends TransportConfig {
+    type: 'http';
+    config: {
+        baseUrl: string;
+        authentication?: AuthConfig;
+        timeout?: number;
+        retries?: number;
+    };
+}
+export interface StdioTransportConfig extends TransportConfig {
+    type: 'stdio';
+    config: {
+        command: string;
+        args?: string[];
+        env?: Record<string, string>;
+    };
+}
+export interface QueueTransportConfig extends TransportConfig {
+    type: 'queue';
+    config: {
+        queueUrl: string;
+        requestQueue: string;
+        responseQueue: string;
+    };
+}
+export interface AuthConfig {
+    type: 'bearer' | 'basic' | 'api_key' | 'oauth2';
+    credentials: Record<string, string>;
+}
+//# sourceMappingURL=transport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/types/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAE3D;;GAEG;AAEH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACjF,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IAC3C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAGD,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE;QACN,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAGD,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,cAAc,CAAC,EAAE,UAAU,CAAC;QAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAGD,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC9B,CAAC;CACH;AAGD,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC;IAChD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC"}

package/dist/types/transport.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=transport.js.map

package/dist/types/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/types/transport.ts"],"names":[],"mappings":""}

package/dist/types/workflow.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Workflow Definition and Execution Types
+ */
+export interface WorkflowDefinition {
+    id: string;
+    name: string;
+    version: string;
+    trigger: TriggerConfig;
+    steps: WorkflowStep[];
+    errorHandling?: ErrorHandlingConfig;
+    retryPolicy?: RetryPolicy;
+}
+export interface WorkflowStep {
+    id: string;
+    type: 'tool' | 'agent' | 'condition' | 'loop' | 'parallel' | 'payment';
+    config: StepConfig;
+    dependencies?: string[];
+    timeout?: number;
+    retryPolicy?: RetryPolicy;
+    outputVariable?: string;
+}
+export interface TriggerConfig {
+    type: 'webhook' | 'cron' | 'polling' | 'manual';
+    config: Record<string, unknown>;
+}
+export interface StepConfig {
+    [key: string]: unknown;
+}
+export interface ErrorHandlingConfig {
+    strategy: 'fail_fast' | 'continue' | 'retry';
+    maxRetries?: number;
+    retryDelay?: number;
+    continueOnError?: boolean;
+    fallbackValue?: unknown;
+}
+export interface RetryPolicy {
+    maxAttempts: number;
+    backoffStrategy: 'linear' | 'exponential' | 'fixed';
+    baseDelay: number;
+    maxDelay: number;
+}
+export interface WorkflowExecution {
+    id: string;
+    workflowId: string;
+    status: ExecutionStatus;
+    input?: unknown;
+    output?: unknown;
+    error?: string;
+    startedAt: Date;
+    completedAt?: Date;
+    steps: StepExecution[];
+    context: ExecutionContext;
+}
+export interface StepExecution {
+    id: string;
+    stepId: string;
+    status: ExecutionStatus;
+    input?: unknown;
+    output?: unknown;
+    error?: string;
+    startedAt: Date;
+    completedAt?: Date;
+    retryCount: number;
+    duration: number;
+}
+export type ExecutionStatus = 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
+export interface ExecutionContext {
+    variables: Record<string, unknown>;
+    metadata: Record<string, unknown>;
+    traceId: string;
+}
+//# sourceMappingURL=workflow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/types/workflow.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IACvE,MAAM,EAAE,UAAU,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;IAChD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,QAAQ,GAAG,aAAa,GAAG,OAAO,CAAC;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE3F,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/types/workflow.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Workflow Definition and Execution Types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=workflow.js.map

package/dist/types/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../src/types/workflow.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/utils/factory.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Factory functions for creating AgentX components
+ */
+import { AgentXConfig } from '../types/config';
+import { AgentXRuntime as IAgentXRuntime } from '../types/runtime';
+/**
+ * Create a new AgentX runtime instance with default configuration
+ */
+export declare function createRuntime(config?: Partial<AgentXConfig>): Promise<IAgentXRuntime>;
+/**
+ * Default configuration for AgentX
+ */
+export declare const defaultConfig: AgentXConfig;
+//# sourceMappingURL=factory.d.ts.map

package/dist/utils/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/utils/factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,aAAa,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAInE;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CA8B3F;AAwDD;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,YAiD3B,CAAC"}

package/dist/utils/factory.js

@@ -0,0 +1,146 @@
+"use strict";
+/**
+ * Factory functions for creating AgentX components
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultConfig = void 0;
+exports.createRuntime = createRuntime;
+const AgentXRuntime_1 = require("../runtime/AgentXRuntime");
+/**
+ * Create a new AgentX runtime instance with default configuration
+ */
+async function createRuntime(config) {
+    const finalConfig = {
+        ...exports.defaultConfig,
+        ...config,
+        runtime: {
+            ...exports.defaultConfig.runtime,
+            ...config?.runtime,
+        },
+        logging: {
+            ...exports.defaultConfig.logging,
+            ...config?.logging,
+        },
+        metrics: {
+            ...exports.defaultConfig.metrics,
+            ...config?.metrics,
+        },
+        security: {
+            ...exports.defaultConfig.security,
+            ...config?.security,
+        },
+        storage: {
+            ...exports.defaultConfig.storage,
+            ...config?.storage,
+        },
+    };
+    const logger = createLogger(finalConfig.logging);
+    const metrics = createMetrics(finalConfig.metrics);
+    return new AgentXRuntime_1.AgentXRuntime(finalConfig, logger, metrics);
+}
+/**
+ * Create a logger instance
+ */
+function createLogger(config) {
+    return {
+        debug: (message, meta) => {
+            if (config.level === 'debug') {
+                console.log(`[DEBUG] ${message}`, meta || '');
+            }
+        },
+        info: (message, meta) => {
+            if (['debug', 'info'].includes(config.level)) {
+                console.log(`[INFO] ${message}`, meta || '');
+            }
+        },
+        warn: (message, meta) => {
+            if (['debug', 'info', 'warn'].includes(config.level)) {
+                console.warn(`[WARN] ${message}`, meta || '');
+            }
+        },
+        error: (message, error, meta) => {
+            console.error(`[ERROR] ${message}`, error?.message || '', meta || '');
+        },
+    };
+}
+/**
+ * Create a metrics collector instance
+ */
+function createMetrics(config) {
+    return {
+        increment: (metric, tags) => {
+            if (config.enabled) {
+                console.log(`[METRIC] ${metric} +1`, tags || '');
+            }
+        },
+        gauge: (metric, value, tags) => {
+            if (config.enabled) {
+                console.log(`[METRIC] ${metric} = ${value}`, tags || '');
+            }
+        },
+        histogram: (metric, value, tags) => {
+            if (config.enabled) {
+                console.log(`[METRIC] ${metric} histogram ${value}`, tags || '');
+            }
+        },
+        timing: (metric, duration, tags) => {
+            if (config.enabled) {
+                console.log(`[METRIC] ${metric} timing ${duration}ms`, tags || '');
+            }
+        },
+    };
+}
+/**
+ * Default configuration for AgentX
+ */
+exports.defaultConfig = {
+    runtime: {
+        maxConcurrentWorkflows: 10,
+        defaultTimeout: 30000,
+        retryPolicy: {
+            maxAttempts: 3,
+            backoffStrategy: 'exponential',
+            baseDelay: 1000,
+            maxDelay: 10000,
+        },
+        rateLimiting: {
+            enabled: true,
+            requestsPerSecond: 100,
+            burstSize: 200,
+        },
+    },
+    logging: {
+        level: 'info',
+        format: 'json',
+        outputs: [
+            {
+                type: 'console',
+                config: {},
+            },
+        ],
+    },
+    metrics: {
+        enabled: true,
+        provider: 'prometheus',
+        config: {},
+    },
+    security: {
+        encryption: {
+            algorithm: 'aes-256-gcm',
+            keySize: 256,
+        },
+        authentication: {
+            enabled: true,
+            providers: ['local'],
+        },
+        authorization: {
+            enabled: true,
+            defaultRole: 'user',
+        },
+    },
+    storage: {
+        type: 'memory',
+        config: {},
+    },
+};
+//# sourceMappingURL=factory.js.map

package/dist/utils/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/utils/factory.ts"],"names":[],"mappings":"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"}

package/dist/workflow/StateManager.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Workflow State Manager for persistence and recovery
+ */
+import { WorkflowExecution, ExecutionContext, ExecutionStatus } from '../types/workflow';
+import { Logger } from '../types/tool';
+export interface StateStore {
+    save(key: string, data: unknown): Promise<void>;
+    load(key: string): Promise<unknown | null>;
+    delete(key: string): Promise<void>;
+    list(prefix: string): Promise<string[]>;
+}
+export interface CheckpointData {
+    executionId: string;
+    workflowId: string;
+    status: ExecutionStatus;
+    input?: unknown;
+    context: ExecutionContext;
+    completedSteps: string[];
+    stepResults: Record<string, unknown>;
+    checkpointedAt: Date;
+    version: number;
+}
+export declare class InMemoryStateStore implements StateStore {
+    private store;
+    save(key: string, data: unknown): Promise<void>;
+    load(key: string): Promise<unknown | null>;
+    delete(key: string): Promise<void>;
+    list(prefix: string): Promise<string[]>;
+    clear(): void;
+}
+export declare class StateManager {
+    private store;
+    private logger;
+    private checkpointInterval;
+    constructor(store: StateStore, logger: Logger, checkpointInterval?: number);
+    /**
+     * Create a checkpoint for an execution
+     */
+    checkpoint(execution: WorkflowExecution): Promise<void>;
+    /**
+     * Load a checkpoint for recovery
+     */
+    loadCheckpoint(executionId: string): Promise<CheckpointData | null>;
+    /**
+     * Restore execution from checkpoint
+     */
+    restoreExecution(checkpoint: CheckpointData): Promise<WorkflowExecution>;
+    /**
+     * Delete checkpoint after successful completion
+     */
+    deleteCheckpoint(executionId: string): Promise<void>;
+    /**
+     * List all pending checkpoints (for recovery on startup)
+     */
+    listPendingCheckpoints(): Promise<CheckpointData[]>;
+    /**
+     * Get steps that need to be executed (not yet completed)
+     */
+    getStepsToExecute(checkpoint: CheckpointData, allStepIds: string[]): string[];
+    private getCheckpointKey;
+    private extractStepResults;
+}
+/**
+ * Idempotency key manager for ensuring workflow idempotency
+ */
+export declare class IdempotencyManager {
+    private store;
+    private logger;
+    private ttlMs;
+    constructor(store: StateStore, logger: Logger, ttlMs?: number);
+    /**
+     * Generate idempotency key from workflow ID and input
+     */
+    generateKey(workflowId: string, input: unknown): string;
+    /**
+     * Check if a workflow execution with this key already exists
+     */
+    checkIdempotency(key: string): Promise<{
+        exists: boolean;
+        executionId?: string;
+        result?: unknown;
+    }>;
+    /**
+     * Record an execution for idempotency
+     */
+    recordExecution(key: string, executionId: string, result?: unknown): Promise<void>;
+    /**
+     * Update result for an existing idempotency record
+     */
+    updateResult(key: string, result: unknown): Promise<void>;
+    private hashInput;
+}
+//# sourceMappingURL=StateManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StateManager.d.ts","sourceRoot":"","sources":["../../src/workflow/StateManager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,iBAAiB,EAEjB,gBAAgB,EAChB,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC3C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,cAAc,EAAE,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,kBAAmB,YAAW,UAAU;IACnD,OAAO,CAAC,KAAK,CAAmC;IAE1C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAK1C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAI7C,KAAK,IAAI,IAAI;CAGd;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,kBAAkB,CAAS;gBAEvB,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAE,MAAa;IAMhF;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB7D;;OAEG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAWzE;;OAEG;IACG,gBAAgB,CAAC,UAAU,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAkC9E;;OAEG;IACG,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM1D;;OAEG;IACG,sBAAsB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAiBzD;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAK7E,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,kBAAkB;CAW3B;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;gBAEV,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAA4B;IAMlF;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM;IAKvD;;OAEG;IACG,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAsBzG;;OAEG;IACG,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAWxF;;OAEG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAU/D,OAAO,CAAC,SAAS;CAWlB"}