@shalwin04/x404r-sdk 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,242 @@
+/**
+ * x404r Client
+ * Main entry point for the SDK - supports both embedded and cloud modes
+ */
+import type { Backend } from './backend/index.js';
+import { WorkflowBuilder } from './workflow.js';
+import { Worker } from './worker.js';
+import type { X404rConfig, AIProvider, WorkflowDefinition, WorkerConfig, Workflow, Task, EventHandler, WorkflowEvent } from './types.js';
+/**
+ * x404r Client
+ *
+ * Supports two modes:
+ *
+ * **Embedded Mode** - Direct DB connection, run workers locally
+ * ```typescript
+ * const runtime = new x404r({
+ *   mode: 'embedded', // optional, default
+ *   connectionString: process.env.DATABASE_URL,
+ *   ai: { provider: 'gemini', apiKey: '...' }
+ * });
+ * runtime.worker().start(); // Run workers locally
+ * ```
+ *
+ * **Cloud Mode** - Connect to hosted API, workers run on Lambda
+ * ```typescript
+ * const runtime = new x404r({
+ *   mode: 'cloud',
+ *   apiKey: 'x404r_live_...'
+ * });
+ * // No workers needed - Lambda handles execution
+ * const result = await runtime.submit('my-workflow', { input });
+ * ```
+ */
+export declare class AgentDB {
+    private backend;
+    private aiProvider;
+    private mode;
+    private debug;
+    private eventHandlers;
+    private workflows;
+    private initPromise;
+    private tenantId;
+    constructor(config: X404rConfig);
+    /**
+     * Wait for client to be ready
+     */
+    ready(): Promise<this>;
+    /**
+     * Get current mode
+     */
+    get currentMode(): 'embedded' | 'cloud';
+    /**
+     * Check if running in embedded mode
+     */
+    get isEmbedded(): boolean;
+    /**
+     * Check if running in cloud mode
+     */
+    get isCloud(): boolean;
+    /**
+     * Define a new workflow
+     *
+     * In embedded mode, the workflow definition includes step handlers.
+     * In cloud mode, workflows must be pre-registered on the platform.
+     */
+    workflow<TInput = unknown, TOutput = unknown>(name: string, definition: Omit<WorkflowDefinition<TInput, TOutput>, 'name'>): WorkflowBuilder<TInput, TOutput>;
+    /**
+     * Get a registered workflow builder by name
+     */
+    getWorkflowBuilder(name: string): WorkflowBuilder<any, any> | undefined;
+    /**
+     * Create a worker to process tasks
+     *
+     * @throws Error if called in cloud mode
+     */
+    worker(config?: WorkerConfig): Worker;
+    /**
+     * Submit a workflow for execution (cloud mode)
+     *
+     * In cloud mode, this submits to the API and Lambda workers execute it.
+     * In embedded mode, this creates the workflow and you need to run workers.
+     */
+    submit(workflowName: string, input: Record<string, unknown>, options?: {
+        priority?: number;
+        wait?: boolean;
+        timeout?: number;
+    }): Promise<{
+        workflowId: string;
+        status: string;
+        output?: unknown;
+    }>;
+    /**
+     * Get workflow status
+     */
+    status(workflowId: string): Promise<Workflow | null>;
+    /**
+     * List workflows
+     */
+    list(options?: {
+        status?: 'pending' | 'running' | 'completed' | 'failed';
+        limit?: number;
+        offset?: number;
+    }): Promise<Workflow[]>;
+    /**
+     * Wait for workflow completion
+     */
+    wait(workflowId: string, options?: {
+        timeout?: number;
+        pollInterval?: number;
+    }): Promise<Workflow>;
+    /**
+     * Replay a workflow from a checkpoint
+     */
+    replay(workflowId: string, checkpointId: string, newInput?: Record<string, unknown>): Promise<Workflow>;
+    /**
+     * Get checkpoints for a workflow
+     */
+    checkpoints(workflowId: string): Promise<{
+        taskId: string;
+        taskName: string;
+        stepIndex: number;
+        state: Record<string, unknown>;
+        createdAt: Date;
+    }[]>;
+    /**
+     * Get cost summary for a workflow
+     */
+    cost(workflowId: string): Promise<{
+        totalTokens: number;
+        estimatedCostUsd: number;
+        savedByRecoveryUsd: number;
+    }>;
+    /**
+     * Register an event handler
+     */
+    on(handler: EventHandler): () => void;
+    /**
+     * Emit an event to all handlers
+     */
+    emit(event: WorkflowEvent): Promise<void>;
+    /**
+     * Get the backend instance
+     */
+    getBackend(): Backend;
+    /**
+     * Get the database pool (embedded mode only)
+     */
+    get db(): import("pg").Pool;
+    /**
+     * Get the AI provider
+     */
+    get ai(): AIProvider;
+    /**
+     * Get the tenant ID
+     */
+    get tenant(): string;
+    /**
+     * Log a debug message
+     */
+    log(message: string, data?: Record<string, unknown>): void;
+    /**
+     * Create a workflow record
+     */
+    createWorkflow(name: string, version: string, input: Record<string, unknown>, priority?: number): Promise<Workflow>;
+    /**
+     * Get a workflow from database by ID
+     */
+    getWorkflow(id: string): Promise<Workflow | null>;
+    /**
+     * Update workflow status
+     */
+    updateWorkflowStatus(id: string, status: string, output?: Record<string, unknown>, error?: string): Promise<void>;
+    /**
+     * Create tasks for a workflow
+     */
+    createTasks(workflowId: string, tasks: Array<{
+        name: string;
+        type: string;
+        input: Record<string, unknown>;
+        dependsOn: string[];
+        maxAttempts?: number;
+    }>): Promise<Task[]>;
+    /**
+     * Claim a task atomically (embedded mode only)
+     */
+    claimTask(workerId: string, taskTypes?: string[]): Promise<Task | null>;
+    /**
+     * Update task heartbeat (embedded mode only)
+     */
+    heartbeat(taskId: string): Promise<void>;
+    /**
+     * Complete a task
+     */
+    completeTask(taskId: string, output: Record<string, unknown>): Promise<void>;
+    /**
+     * Fail a task
+     */
+    failTask(taskId: string, error: string): Promise<void>;
+    /**
+     * Get tasks for a workflow
+     */
+    getWorkflowTasks(workflowId: string): Promise<Task[]>;
+    /**
+     * Create a checkpoint
+     */
+    createCheckpoint(taskId: string, stepIndex: number, state: Record<string, unknown>): Promise<void>;
+    /**
+     * Get latest checkpoint for a task
+     */
+    getCheckpoint(taskId: string): Promise<{
+        stepIndex: number;
+        state: Record<string, unknown>;
+    } | null>;
+    /**
+     * Store memory for learning
+     */
+    storeMemory(taskId: string, eventType: string, summary: string, embedding: number[], taskType?: string, errorCategory?: string, resolution?: string): Promise<void>;
+    /**
+     * Query similar memories
+     */
+    queryMemories(embedding: number[], taskType?: string, limit?: number): Promise<Array<{
+        summary: string;
+        eventType: string;
+        resolution?: string;
+        similarity: number;
+    }>>;
+    /**
+     * Check if workflow is complete
+     */
+    isWorkflowComplete(workflowId: string): Promise<{
+        complete: boolean;
+        failed: number;
+        done: number;
+        pending: number;
+    }>;
+    /**
+     * Close the client
+     */
+    close(): Promise<void>;
+}
+export { AgentDB as x404r };
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,401 @@
+/**
+ * x404r Client
+ * Main entry point for the SDK - supports both embedded and cloud modes
+ */
+import { createAIProvider, MockAIProvider } from './ai/index.js';
+import { EmbeddedBackend, CloudBackend, isEmbeddedBackend } from './backend/index.js';
+import { WorkflowBuilder } from './workflow.js';
+import { Worker } from './worker.js';
+/**
+ * Default tenant ID for single-tenant mode
+ */
+const DEFAULT_TENANT_ID = '00000000-0000-0000-0000-000000000000';
+/**
+ * x404r Client
+ *
+ * Supports two modes:
+ *
+ * **Embedded Mode** - Direct DB connection, run workers locally
+ * ```typescript
+ * const runtime = new x404r({
+ *   mode: 'embedded', // optional, default
+ *   connectionString: process.env.DATABASE_URL,
+ *   ai: { provider: 'gemini', apiKey: '...' }
+ * });
+ * runtime.worker().start(); // Run workers locally
+ * ```
+ *
+ * **Cloud Mode** - Connect to hosted API, workers run on Lambda
+ * ```typescript
+ * const runtime = new x404r({
+ *   mode: 'cloud',
+ *   apiKey: 'x404r_live_...'
+ * });
+ * // No workers needed - Lambda handles execution
+ * const result = await runtime.submit('my-workflow', { input });
+ * ```
+ */
+export class AgentDB {
+    backend;
+    aiProvider;
+    mode;
+    debug;
+    eventHandlers = [];
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    workflows = new Map();
+    initPromise;
+    tenantId;
+    constructor(config) {
+        this.debug = config.debug || false;
+        this.mode = config.mode === 'cloud' ? 'cloud' : 'embedded';
+        if (this.mode === 'cloud') {
+            // Cloud mode - HTTP API client
+            const cloudConfig = config;
+            this.backend = new CloudBackend({
+                apiKey: cloudConfig.apiKey,
+                baseUrl: cloudConfig.baseUrl,
+            });
+            this.tenantId = ''; // Managed by API
+            this.aiProvider = new MockAIProvider(); // AI calls handled by Lambda
+            // Don't call ready() automatically - let user call .ready() explicitly
+            this.initPromise = Promise.resolve();
+        }
+        else {
+            // Embedded mode - direct DB connection
+            const embeddedConfig = config;
+            this.tenantId = embeddedConfig.tenantId || DEFAULT_TENANT_ID;
+            this.backend = new EmbeddedBackend({
+                connectionString: embeddedConfig.connectionString,
+                tenantId: this.tenantId,
+            });
+            // Initialize AI provider asynchronously
+            if (embeddedConfig.ai) {
+                this.initPromise = Promise.all([
+                    this.backend.ready(),
+                    createAIProvider(embeddedConfig.ai).then((provider) => {
+                        this.aiProvider = provider;
+                    }),
+                ]).then(() => { });
+            }
+            else {
+                this.aiProvider = new MockAIProvider();
+                this.initPromise = this.backend.ready();
+            }
+        }
+    }
+    /**
+     * Wait for client to be ready
+     */
+    async ready() {
+        await this.initPromise;
+        return this;
+    }
+    /**
+     * Get current mode
+     */
+    get currentMode() {
+        return this.mode;
+    }
+    /**
+     * Check if running in embedded mode
+     */
+    get isEmbedded() {
+        return this.mode === 'embedded';
+    }
+    /**
+     * Check if running in cloud mode
+     */
+    get isCloud() {
+        return this.mode === 'cloud';
+    }
+    // ============ Workflow Definition ============
+    /**
+     * Define a new workflow
+     *
+     * In embedded mode, the workflow definition includes step handlers.
+     * In cloud mode, workflows must be pre-registered on the platform.
+     */
+    workflow(name, definition) {
+        if (this.mode === 'cloud') {
+            this.log('Warning: Workflow definitions in cloud mode are for reference only. ' +
+                'Actual workflow logic runs on Lambda workers.');
+        }
+        const fullDefinition = {
+            name,
+            ...definition,
+        };
+        const builder = new WorkflowBuilder(this, fullDefinition, this.tenantId);
+        this.workflows.set(name, builder);
+        return builder;
+    }
+    /**
+     * Get a registered workflow builder by name
+     */
+    getWorkflowBuilder(name) {
+        return this.workflows.get(name);
+    }
+    // ============ Worker (Embedded Mode Only) ============
+    /**
+     * Create a worker to process tasks
+     *
+     * @throws Error if called in cloud mode
+     */
+    worker(config = {}) {
+        if (this.mode === 'cloud') {
+            throw new Error('Workers are not available in cloud mode. ' +
+                'Tasks are executed by Lambda workers automatically.');
+        }
+        return new Worker(this, config);
+    }
+    // ============ Cloud Mode: Submit & Status ============
+    /**
+     * Submit a workflow for execution (cloud mode)
+     *
+     * In cloud mode, this submits to the API and Lambda workers execute it.
+     * In embedded mode, this creates the workflow and you need to run workers.
+     */
+    async submit(workflowName, input, options = {}) {
+        if (this.mode === 'cloud') {
+            const cloudBackend = this.backend;
+            const result = await cloudBackend.submit(workflowName, input, options);
+            if (options.wait) {
+                const workflow = await cloudBackend.waitForCompletion(result.workflowId, {
+                    timeout: options.timeout,
+                });
+                return {
+                    workflowId: workflow.id,
+                    status: workflow.status,
+                    output: workflow.output,
+                };
+            }
+            return result;
+        }
+        else {
+            // Embedded mode - create workflow directly
+            const workflow = await this.backend.createWorkflow(workflowName, '1.0.0', input, options.priority);
+            return {
+                workflowId: workflow.id,
+                status: workflow.status,
+            };
+        }
+    }
+    /**
+     * Get workflow status
+     */
+    async status(workflowId) {
+        return this.backend.getWorkflow(workflowId);
+    }
+    /**
+     * List workflows
+     */
+    async list(options) {
+        return this.backend.listWorkflows(options);
+    }
+    /**
+     * Wait for workflow completion
+     */
+    async wait(workflowId, options = {}) {
+        if (this.mode === 'cloud') {
+            return this.backend.waitForCompletion(workflowId, options);
+        }
+        // Embedded mode - poll for completion
+        const { timeout = 300000, pollInterval = 1000 } = options;
+        const startTime = Date.now();
+        while (Date.now() - startTime < timeout) {
+            const workflow = await this.backend.getWorkflow(workflowId);
+            if (!workflow) {
+                throw new Error(`Workflow ${workflowId} not found`);
+            }
+            if (workflow.status === 'completed' || workflow.status === 'failed') {
+                return workflow;
+            }
+            await new Promise((resolve) => setTimeout(resolve, pollInterval));
+        }
+        throw new Error(`Workflow ${workflowId} timed out after ${timeout}ms`);
+    }
+    // ============ Time Travel ============
+    /**
+     * Replay a workflow from a checkpoint
+     */
+    async replay(workflowId, checkpointId, newInput) {
+        if (!this.backend.replayFromCheckpoint) {
+            throw new Error('Replay not supported in this mode');
+        }
+        return this.backend.replayFromCheckpoint(workflowId, checkpointId, newInput);
+    }
+    /**
+     * Get checkpoints for a workflow
+     */
+    async checkpoints(workflowId) {
+        return this.backend.getWorkflowCheckpoints(workflowId);
+    }
+    // ============ Cost Tracking ============
+    /**
+     * Get cost summary for a workflow
+     */
+    async cost(workflowId) {
+        if (!this.backend.getWorkflowCost) {
+            return { totalTokens: 0, estimatedCostUsd: 0, savedByRecoveryUsd: 0 };
+        }
+        return this.backend.getWorkflowCost(workflowId);
+    }
+    // ============ Events ============
+    /**
+     * Register an event handler
+     */
+    on(handler) {
+        this.eventHandlers.push(handler);
+        return () => {
+            const index = this.eventHandlers.indexOf(handler);
+            if (index > -1)
+                this.eventHandlers.splice(index, 1);
+        };
+    }
+    /**
+     * Emit an event to all handlers
+     */
+    async emit(event) {
+        if (this.debug) {
+            console.log(`[x404-r] Event: ${event.type}`, event);
+        }
+        for (const handler of this.eventHandlers) {
+            await handler(event);
+        }
+    }
+    // ============ Accessors ============
+    /**
+     * Get the backend instance
+     */
+    getBackend() {
+        return this.backend;
+    }
+    /**
+     * Get the database pool (embedded mode only)
+     */
+    get db() {
+        if (this.mode === 'cloud') {
+            throw new Error('Direct database access not available in cloud mode');
+        }
+        return this.backend.db;
+    }
+    /**
+     * Get the AI provider
+     */
+    get ai() {
+        return this.aiProvider;
+    }
+    /**
+     * Get the tenant ID
+     */
+    get tenant() {
+        return this.tenantId;
+    }
+    /**
+     * Log a debug message
+     */
+    log(message, data) {
+        if (this.debug) {
+            console.log(`[x404-r] ${message}`, data || '');
+        }
+    }
+    // ============ Database Operations (for WorkflowBuilder compatibility) ============
+    /**
+     * Create a workflow record
+     */
+    async createWorkflow(name, version, input, priority = 0) {
+        return this.backend.createWorkflow(name, version, input, priority);
+    }
+    /**
+     * Get a workflow from database by ID
+     */
+    async getWorkflow(id) {
+        return this.backend.getWorkflow(id);
+    }
+    /**
+     * Update workflow status
+     */
+    async updateWorkflowStatus(id, status, output, error) {
+        return this.backend.updateWorkflowStatus(id, status, output, error);
+    }
+    /**
+     * Create tasks for a workflow
+     */
+    async createTasks(workflowId, tasks) {
+        return this.backend.createTasks(workflowId, tasks);
+    }
+    /**
+     * Claim a task atomically (embedded mode only)
+     */
+    async claimTask(workerId, taskTypes) {
+        if (!isEmbeddedBackend(this.backend)) {
+            throw new Error('Task claiming not available in cloud mode');
+        }
+        return this.backend.claimTask(workerId, taskTypes);
+    }
+    /**
+     * Update task heartbeat (embedded mode only)
+     */
+    async heartbeat(taskId) {
+        if (!isEmbeddedBackend(this.backend)) {
+            throw new Error('Heartbeat not available in cloud mode');
+        }
+        return this.backend.heartbeat(taskId);
+    }
+    /**
+     * Complete a task
+     */
+    async completeTask(taskId, output) {
+        return this.backend.completeTask(taskId, output);
+    }
+    /**
+     * Fail a task
+     */
+    async failTask(taskId, error) {
+        return this.backend.failTask(taskId, error);
+    }
+    /**
+     * Get tasks for a workflow
+     */
+    async getWorkflowTasks(workflowId) {
+        return this.backend.getWorkflowTasks(workflowId);
+    }
+    /**
+     * Create a checkpoint
+     */
+    async createCheckpoint(taskId, stepIndex, state) {
+        return this.backend.createCheckpoint(taskId, stepIndex, state);
+    }
+    /**
+     * Get latest checkpoint for a task
+     */
+    async getCheckpoint(taskId) {
+        return this.backend.getCheckpoint(taskId);
+    }
+    /**
+     * Store memory for learning
+     */
+    async storeMemory(taskId, eventType, summary, embedding, taskType, errorCategory, resolution) {
+        return this.backend.storeMemory(taskId, eventType, summary, embedding, taskType, errorCategory, resolution);
+    }
+    /**
+     * Query similar memories
+     */
+    async queryMemories(embedding, taskType, limit = 5) {
+        return this.backend.queryMemories(embedding, taskType, limit);
+    }
+    /**
+     * Check if workflow is complete
+     */
+    async isWorkflowComplete(workflowId) {
+        return this.backend.isWorkflowComplete(workflowId);
+    }
+    /**
+     * Close the client
+     */
+    async close() {
+        await this.backend.close();
+    }
+}
+// Export as both AgentDB and x404r for flexibility
+export { AgentDB as x404r };
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/context.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Step Execution Context
+ * Provides checkpoint, logging, and AI access to step handlers
+ */
+import type { AgentDB } from './client.js';
+import type { Task, Workflow, StepContext } from './types.js';
+/**
+ * Create a step context for task execution
+ */
+export declare function createStepContext<TInput = unknown>(client: AgentDB, workflow: Workflow, task: Task, initialState?: Record<string, unknown>): StepContext<TInput>;
+/**
+ * Restore context from checkpoint
+ */
+export declare function restoreFromCheckpoint<TInput = unknown>(client: AgentDB, workflow: Workflow, task: Task): Promise<{
+    context: StepContext<TInput>;
+    resumeFromStep: number;
+} | null>;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAE1E;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,GAAG,OAAO,EAChD,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,IAAI,EACV,YAAY,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACzC,WAAW,CAAC,MAAM,CAAC,CA8CrB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,GAAG,OAAO,EAC1D,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,IAAI,GACT,OAAO,CAAC;IAAE,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAsB1E"}