@shalwin04/x404r-sdk 0.1.0

package/dist/context.js

@@ -0,0 +1,65 @@
+/**
+ * Step Execution Context
+ * Provides checkpoint, logging, and AI access to step handlers
+ */
+/**
+ * Create a step context for task execution
+ */
+export function createStepContext(client, workflow, task, initialState = {}) {
+    let stepIndex = 0;
+    const state = { ...initialState };
+    const context = {
+        input: task.input,
+        state,
+        workflow: {
+            id: workflow.id,
+            name: workflow.name,
+            input: workflow.input,
+        },
+        task: {
+            id: task.id,
+            name: task.name,
+            attemptCount: task.attemptCount,
+        },
+        ai: client.ai,
+        checkpoint: async (newState) => {
+            if (newState) {
+                Object.assign(state, newState);
+            }
+            stepIndex++;
+            await client.createCheckpoint(task.id, stepIndex, state);
+            client.log(`Checkpoint created at step ${stepIndex}`, { taskId: task.id });
+        },
+        log: (message, data) => {
+            const prefix = `[${workflow.name}/${task.name}]`;
+            if (data) {
+                console.log(`${prefix} ${message}`, data);
+            }
+            else {
+                console.log(`${prefix} ${message}`);
+            }
+        },
+        sleep: async (ms) => {
+            await new Promise(resolve => setTimeout(resolve, ms));
+        },
+    };
+    return context;
+}
+/**
+ * Restore context from checkpoint
+ */
+export async function restoreFromCheckpoint(client, workflow, task) {
+    const checkpoint = await client.getCheckpoint(task.id);
+    if (!checkpoint) {
+        return null;
+    }
+    client.log(`Resuming from checkpoint at step ${checkpoint.stepIndex}`, {
+        taskId: task.id,
+    });
+    const context = createStepContext(client, workflow, task, checkpoint.state);
+    return {
+        context,
+        resumeFromStep: checkpoint.stepIndex,
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAe,EACf,QAAkB,EAClB,IAAU,EACV,eAAwC,EAAE;IAE1C,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,MAAM,KAAK,GAAG,EAAE,GAAG,YAAY,EAAE,CAAC;IAElC,MAAM,OAAO,GAAwB;QACnC,KAAK,EAAE,IAAI,CAAC,KAAe;QAC3B,KAAK;QAEL,QAAQ,EAAE;YACR,EAAE,EAAE,QAAQ,CAAC,EAAE;YACf,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,KAAK,EAAE,QAAQ,CAAC,KAAK;SACtB;QAED,IAAI,EAAE;YACJ,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC;QAED,EAAE,EAAE,MAAM,CAAC,EAAE;QAEb,UAAU,EAAE,KAAK,EAAE,QAAkC,EAAE,EAAE;YACvD,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;YACjC,CAAC;YACD,SAAS,EAAE,CAAC;YACZ,MAAM,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;YACzD,MAAM,CAAC,GAAG,CAAC,8BAA8B,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7E,CAAC;QAED,GAAG,EAAE,CAAC,OAAe,EAAE,IAA8B,EAAE,EAAE;YACvD,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC;YACjD,IAAI,IAAI,EAAE,CAAC;gBACT,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;YAC5C,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;QAED,KAAK,EAAE,KAAK,EAAE,EAAU,EAAE,EAAE;YAC1B,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QACxD,CAAC;KACF,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAe,EACf,QAAkB,EAClB,IAAU;IAEV,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEvD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,GAAG,CAAC,oCAAoC,UAAU,CAAC,SAAS,EAAE,EAAE;QACrE,MAAM,EAAE,IAAI,CAAC,EAAE;KAChB,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,iBAAiB,CAC/B,MAAM,EACN,QAAQ,EACR,IAAI,EACJ,UAAU,CAAC,KAAK,CACjB,CAAC;IAEF,OAAO;QACL,OAAO;QACP,cAAc,EAAE,UAAU,CAAC,SAAS;KACrC,CAAC;AACJ,CAAC"}

package/dist/durable.d.ts

@@ -0,0 +1,90 @@
+/**
+ * One-Line Durable API
+ *
+ * Simplifies crash-proof execution to a single function call.
+ *
+ * @example
+ * ```typescript
+ * import { durable } from '@x404-r/sdk';
+ *
+ * const result = await durable('process-data', async (ctx) => {
+ *   const data = await fetchData();
+ *   await ctx.checkpoint('fetched');
+ *
+ *   const processed = await processData(data);
+ *   await ctx.checkpoint('processed');
+ *
+ *   return processed;
+ * });
+ * ```
+ */
+import type { AIConfig, AIProvider } from './types.js';
+export interface DurableContext {
+    /** Create a named checkpoint (survives crashes) */
+    checkpoint: (name: string, state?: Record<string, unknown>) => Promise<void>;
+    /** Access persistent state */
+    state: Record<string, unknown>;
+    /** AI provider for LLM calls */
+    ai: AIProvider;
+    /** Log a message */
+    log: (message: string, data?: Record<string, unknown>) => void;
+    /** Sleep for specified milliseconds */
+    sleep: (ms: number) => Promise<void>;
+    /** Current execution info */
+    execution: {
+        id: string;
+        attemptCount: number;
+        checkpointName?: string;
+    };
+}
+export interface DurableOptions {
+    /** CockroachDB connection string (or uses DATABASE_URL env) */
+    connectionString?: string;
+    /** AI provider configuration */
+    ai?: AIConfig;
+    /** Maximum retry attempts */
+    maxAttempts?: number;
+    /** Timeout in milliseconds */
+    timeout?: number;
+    /** Tenant ID for multi-tenancy */
+    tenantId?: string;
+}
+type DurableHandler<T> = (ctx: DurableContext) => Promise<T>;
+/**
+ * Execute a function durably with automatic crash recovery.
+ *
+ * The function can call `ctx.checkpoint()` at any point to save progress.
+ * If the process crashes, execution resumes from the last checkpoint.
+ *
+ * @param name - Unique name for this durable function
+ * @param handler - The function to execute durably
+ * @param options - Configuration options
+ * @returns The result of the handler function
+ */
+export declare function durable<T>(name: string, handler: DurableHandler<T>, options?: DurableOptions): Promise<T>;
+/**
+ * Create a reusable durable function with preset options.
+ *
+ * @example
+ * ```typescript
+ * const processOrder = createDurable<{ orderId: string }, void>('process-order', {
+ *   maxAttempts: 5,
+ *   timeout: 60000,
+ * });
+ *
+ * // Later:
+ * await processOrder({ orderId: '123' }, async (ctx) => {
+ *   // ... implementation
+ * });
+ * ```
+ */
+export declare function createDurable<TInput, TOutput>(name: string, options?: DurableOptions): (input: TInput, handler: (ctx: DurableContext & {
+    input: TInput;
+}) => Promise<TOutput>) => Promise<TOutput>;
+/**
+ * Close the global runtime connection.
+ * Call this when shutting down your application.
+ */
+export declare function closeDurable(): Promise<void>;
+export {};
+//# sourceMappingURL=durable.d.ts.map

package/dist/durable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable.d.ts","sourceRoot":"","sources":["../src/durable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAe,MAAM,YAAY,CAAC;AAEpE,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7E,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B,gCAAgC;IAChC,EAAE,EAAE,UAAU,CAAC;IAEf,oBAAoB;IACpB,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAE/D,uCAAuC;IACvC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC,6BAA6B;IAC7B,SAAS,EAAE;QACT,EAAE,EAAE,MAAM,CAAC;QACX,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,gCAAgC;IAChC,EAAE,CAAC,EAAE,QAAQ,CAAC;IAEd,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,KAAK,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAyB7D;;;;;;;;;;GAUG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CA4DZ;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,EAC3C,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,cAAc,GACvB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAc7G;AAED;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAKlD"}

package/dist/durable.js

@@ -0,0 +1,143 @@
+/**
+ * One-Line Durable API
+ *
+ * Simplifies crash-proof execution to a single function call.
+ *
+ * @example
+ * ```typescript
+ * import { durable } from '@x404-r/sdk';
+ *
+ * const result = await durable('process-data', async (ctx) => {
+ *   const data = await fetchData();
+ *   await ctx.checkpoint('fetched');
+ *
+ *   const processed = await processData(data);
+ *   await ctx.checkpoint('processed');
+ *
+ *   return processed;
+ * });
+ * ```
+ */
+import { AgentDB } from './client.js';
+// Global connection pool (reused across calls)
+let globalRuntime = null;
+async function getRuntime(options) {
+    if (globalRuntime) {
+        return globalRuntime;
+    }
+    const connectionString = options?.connectionString || process.env.DATABASE_URL;
+    if (!connectionString) {
+        throw new Error('DATABASE_URL environment variable or connectionString option required');
+    }
+    globalRuntime = new AgentDB({
+        connectionString,
+        tenantId: options?.tenantId,
+        ai: options?.ai,
+    });
+    await globalRuntime.ready();
+    return globalRuntime;
+}
+/**
+ * Execute a function durably with automatic crash recovery.
+ *
+ * The function can call `ctx.checkpoint()` at any point to save progress.
+ * If the process crashes, execution resumes from the last checkpoint.
+ *
+ * @param name - Unique name for this durable function
+ * @param handler - The function to execute durably
+ * @param options - Configuration options
+ * @returns The result of the handler function
+ */
+export async function durable(name, handler, options) {
+    const runtime = await getRuntime(options);
+    // Create a workflow with a single step
+    const workflow = runtime.workflow(name, {
+        version: '1.0.0',
+        steps: [
+            {
+                name: 'execute',
+                maxAttempts: options?.maxAttempts ?? 3,
+                timeout: options?.timeout,
+                handler: async (ctx) => {
+                    // Create durable context wrapper
+                    let checkpointIndex = 0;
+                    const durableCtx = {
+                        state: ctx.state,
+                        ai: ctx.ai,
+                        log: ctx.log,
+                        sleep: ctx.sleep,
+                        execution: {
+                            id: ctx.task.id,
+                            attemptCount: ctx.task.attemptCount,
+                            checkpointName: ctx.state.__lastCheckpoint,
+                        },
+                        checkpoint: async (checkpointName, state) => {
+                            checkpointIndex++;
+                            await ctx.checkpoint({
+                                ...state,
+                                __lastCheckpoint: checkpointName,
+                                __checkpointIndex: checkpointIndex,
+                            });
+                        },
+                    };
+                    return handler(durableCtx);
+                },
+            },
+        ],
+    });
+    // Create worker and run
+    const worker = runtime.worker({ concurrency: 1 });
+    worker.register(workflow);
+    // Start worker in background
+    const workerPromise = worker.start();
+    try {
+        // Run workflow and wait for completion
+        const result = await workflow.run({}, { wait: true, timeout: options?.timeout });
+        if (result.status === 'failed') {
+            throw new Error(result.error || 'Durable function failed');
+        }
+        return result.output;
+    }
+    finally {
+        // Stop worker
+        await worker.stop();
+    }
+}
+/**
+ * Create a reusable durable function with preset options.
+ *
+ * @example
+ * ```typescript
+ * const processOrder = createDurable<{ orderId: string }, void>('process-order', {
+ *   maxAttempts: 5,
+ *   timeout: 60000,
+ * });
+ *
+ * // Later:
+ * await processOrder({ orderId: '123' }, async (ctx) => {
+ *   // ... implementation
+ * });
+ * ```
+ */
+export function createDurable(name, options) {
+    return async (input, handler) => {
+        return durable(name, async (ctx) => {
+            const contextWithInput = {
+                ...ctx,
+                input,
+            };
+            return handler(contextWithInput);
+        }, options);
+    };
+}
+/**
+ * Close the global runtime connection.
+ * Call this when shutting down your application.
+ */
+export async function closeDurable() {
+    if (globalRuntime) {
+        await globalRuntime.close();
+        globalRuntime = null;
+    }
+}
+//# sourceMappingURL=durable.js.map

package/dist/durable.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,74 @@
+/**
+ * x404-r SDK
+ * The runtime where context is never lost
+ * Database-native infrastructure for crash-proof AI agents
+ *
+ * @example
+ * ```typescript
+ * import { x404r } from '@x404-r/sdk';
+ *
+ * const runtime = await new x404r({
+ *   connectionString: process.env.DATABASE_URL,
+ *   ai: {
+ *     provider: 'gemini',
+ *     apiKey: process.env.GEMINI_API_KEY,
+ *   },
+ * }).ready();
+ *
+ * // Define a crash-proof workflow
+ * const refactor = runtime.workflow('refactor-code', {
+ *   steps: [
+ *     {
+ *       name: 'analyze',
+ *       handler: async (ctx) => {
+ *         const analysis = await ctx.ai.generate(
+ *           `Analyze this code: ${ctx.input.code}`
+ *         );
+ *         return { analysis };
+ *       },
+ *     },
+ *     {
+ *       name: 'refactor',
+ *       dependsOn: ['analyze'],
+ *       handler: async (ctx) => {
+ *         // Checkpoint after each file
+ *         for (const file of ctx.input.files) {
+ *           await ctx.checkpoint({ lastFile: file });
+ *           // If we crash here, we resume from checkpoint
+ *         }
+ *         return { success: true };
+ *       },
+ *     },
+ *   ],
+ * });
+ *
+ * // Start a worker (stateless - can crash anytime)
+ * const worker = runtime.worker({ concurrency: 5 });
+ * worker.register(refactor);
+ * await worker.start();
+ *
+ * // Run a workflow
+ * const result = await refactor.run({
+ *   code: 'function hello() { return "world"; }',
+ *   files: ['src/index.ts'],
+ * });
+ * ```
+ */
+export { AgentDB, x404r } from './client.js';
+export type { Backend } from './backend/index.js';
+export { EmbeddedBackend, CloudBackend, isEmbeddedBackend } from './backend/index.js';
+export type { EmbeddedBackendConfig, CloudBackendConfig } from './backend/index.js';
+export { WorkflowBuilder } from './workflow.js';
+export { Worker } from './worker.js';
+export { createStepContext, restoreFromCheckpoint } from './context.js';
+export { createAIProvider, MockAIProvider, estimateCost } from './ai/index.js';
+export { durable, createDurable, closeDurable } from './durable.js';
+export type { DurableContext, DurableOptions } from './durable.js';
+export { ChaosEngine, ChaosError, createChaosCheckpoint, withChaos, isChaosEnabled, DEFAULT_CHAOS_CONFIG, STRESS_CHAOS_CONFIG, } from './chaos.js';
+export type { ChaosConfig, ChaosFailureType } from './chaos.js';
+export { MetricsCollector, Histogram, RateCalculator, metrics, observe, withMetrics, } from './metrics.js';
+export type { MetricEvent, MetricsSummary, MetricsDatabaseConfig, ExecutionMetrics, CostMetrics, PerformanceMetrics, ReliabilityMetrics, AIMetrics, MemoryMetrics, } from './metrics.js';
+export type { Workflow, WorkflowStatus, Task, TaskStatus, Checkpoint, WorkflowDefinition, StepDefinition, StepHandler, StepContext, AIProvider, AIConfig, GenerateOptions, JSONSchema, TokenUsage, CostEstimate, GenerateResult, X404rConfig, EmbeddedConfig, CloudConfig, AgentDBConfig, // deprecated alias
+WorkerConfig, WorkflowEvent, EventHandler, RunOptions, RunResult, } from './types.js';
+export { isEmbeddedConfig, isCloudConfig } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAGH,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAG7C,YAAY,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACtF,YAAY,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGpF,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAGxE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG/E,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACpE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnE,OAAO,EACL,WAAW,EACX,UAAU,EACV,qBAAqB,EACrB,SAAS,EACT,cAAc,EACd,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGhE,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,cAAc,EACd,OAAO,EACP,OAAO,EACP,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,WAAW,EACX,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,SAAS,EACT,aAAa,GACd,MAAM,cAAc,CAAC;AAGtB,YAAY,EAEV,QAAQ,EACR,cAAc,EACd,IAAI,EACJ,UAAU,EACV,UAAU,EAGV,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,WAAW,EAGX,UAAU,EACV,QAAQ,EACR,eAAe,EACf,UAAU,EAGV,UAAU,EACV,YAAY,EACZ,cAAc,EAGd,WAAW,EACX,cAAc,EACd,WAAW,EACX,aAAa,EAAE,mBAAmB;AAClC,YAAY,EAGZ,aAAa,EACb,YAAY,EAGZ,UAAU,EACV,SAAS,GACV,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,76 @@
+/**
+ * x404-r SDK
+ * The runtime where context is never lost
+ * Database-native infrastructure for crash-proof AI agents
+ *
+ * @example
+ * ```typescript
+ * import { x404r } from '@x404-r/sdk';
+ *
+ * const runtime = await new x404r({
+ *   connectionString: process.env.DATABASE_URL,
+ *   ai: {
+ *     provider: 'gemini',
+ *     apiKey: process.env.GEMINI_API_KEY,
+ *   },
+ * }).ready();
+ *
+ * // Define a crash-proof workflow
+ * const refactor = runtime.workflow('refactor-code', {
+ *   steps: [
+ *     {
+ *       name: 'analyze',
+ *       handler: async (ctx) => {
+ *         const analysis = await ctx.ai.generate(
+ *           `Analyze this code: ${ctx.input.code}`
+ *         );
+ *         return { analysis };
+ *       },
+ *     },
+ *     {
+ *       name: 'refactor',
+ *       dependsOn: ['analyze'],
+ *       handler: async (ctx) => {
+ *         // Checkpoint after each file
+ *         for (const file of ctx.input.files) {
+ *           await ctx.checkpoint({ lastFile: file });
+ *           // If we crash here, we resume from checkpoint
+ *         }
+ *         return { success: true };
+ *       },
+ *     },
+ *   ],
+ * });
+ *
+ * // Start a worker (stateless - can crash anytime)
+ * const worker = runtime.worker({ concurrency: 5 });
+ * worker.register(refactor);
+ * await worker.start();
+ *
+ * // Run a workflow
+ * const result = await refactor.run({
+ *   code: 'function hello() { return "world"; }',
+ *   files: ['src/index.ts'],
+ * });
+ * ```
+ */
+// Main client
+export { AgentDB, x404r } from './client.js';
+export { EmbeddedBackend, CloudBackend, isEmbeddedBackend } from './backend/index.js';
+// Workflow builder
+export { WorkflowBuilder } from './workflow.js';
+// Worker
+export { Worker } from './worker.js';
+// Context
+export { createStepContext, restoreFromCheckpoint } from './context.js';
+// AI providers
+export { createAIProvider, MockAIProvider, estimateCost } from './ai/index.js';
+// One-line durable API
+export { durable, createDurable, closeDurable } from './durable.js';
+// Chaos engineering
+export { ChaosEngine, ChaosError, createChaosCheckpoint, withChaos, isChaosEnabled, DEFAULT_CHAOS_CONFIG, STRESS_CHAOS_CONFIG, } from './chaos.js';
+// Metrics & Observability
+export { MetricsCollector, Histogram, RateCalculator, metrics, observe, withMetrics, } from './metrics.js';
+// Type guards
+export { isEmbeddedConfig, isCloudConfig } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAEH,cAAc;AACd,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAI7C,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGtF,mBAAmB;AACnB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,SAAS;AACT,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,UAAU;AACV,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAExE,eAAe;AACf,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE/E,uBAAuB;AACvB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGpE,oBAAoB;AACpB,OAAO,EACL,WAAW,EACX,UAAU,EACV,qBAAqB,EACrB,SAAS,EACT,cAAc,EACd,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,0BAA0B;AAC1B,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,cAAc,EACd,OAAO,EACP,OAAO,EACP,WAAW,GACZ,MAAM,cAAc,CAAC;AAuDtB,cAAc;AACd,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}