@loom-framework/core 0.1.0-alpha.19 → 0.1.0-alpha.190

package/dist/backend/process/engine.d.ts

@@ -0,0 +1,127 @@
+/**
+ * ProcessEngine - Core orchestration engine
+ *
+ * Manages process definitions, triggers, concurrent execution, AI calls, and logging.
+ */
+import type { AIEngine } from '../../types/ai.js';
+import type { AuthConfig } from '../../types/auth.js';
+import type { ProcessesConfig, ProcessDefinition, ProcessStatus, ProcessQueueEntry, ProcessLogEntry, ProcessMetricsAggregate } from '../../types/process.js';
+import { ProcessLogger } from './logger.js';
+import type { ProcessMetricSnapshot, ProcessMetricsViewConfig } from '../../types/process.js';
+import { UserStore } from '../auth/user-store.js';
+import type { EventBus } from '../events/event-bus.js';
+import type { EventRegistry } from '../events/event-registry.js';
+import type { SessionManager } from '../ai/session-manager.js';
+import type { LoomPaths } from '../loom-paths.js';
+export interface ProcessEngineOptions {
+    config: ProcessesConfig;
+    engine: AIEngine;
+    sessionManager: SessionManager;
+    paths: LoomPaths;
+    defaultUserId?: string;
+    eventBus?: EventBus;
+    eventRegistry?: EventRegistry;
+    authConfig?: AuthConfig;
+    userStore?: UserStore;
+    serverUrl?: string;
+}
+export declare class ProcessEngine {
+    private registry;
+    private triggerManager;
+    private queue;
+    private logger;
+    private metricsStore;
+    private engine;
+    private sessionManager;
+    private config;
+    private paths;
+    private defaultUserId;
+    private eventBus?;
+    private eventRegistry?;
+    private authConfig?;
+    private userStore?;
+    private serverUrl?;
+    private isShutdown;
+    /** Tracks event subscriptions per process for pause/resume (processName → subscriptions) */
+    private eventSubscriptionMap;
+    constructor(options: ProcessEngineOptions);
+    initialize(): Promise<void>;
+    private registerEventPatterns;
+    addProcess(def: Omit<ProcessDefinition, 'createdAt' | 'updatedAt' | 'paused'>): Promise<ProcessDefinition>;
+    removeProcess(name: string): Promise<boolean>;
+    pauseProcess(name: string): Promise<void>;
+    resumeProcess(name: string): Promise<void>;
+    updateProcess(name: string, updates: Partial<Pick<ProcessDefinition, 'description' | 'cron' | 'cronTimezone' | 'prompt' | 'paused' | 'metricsConfig' | 'sources' | 'model'>>): Promise<ProcessDefinition | undefined>;
+    /** Register an event subscription for a process (in-memory + TriggerManager) */
+    registerEventSubscription(processName: string, eventBus: EventBus, pattern: string, filter?: Record<string, unknown>, debounceMs?: number, start?: boolean): void;
+    /** Unregister an event subscription for a process */
+    unregisterEventSubscription(processName: string, pattern?: string): void;
+    /** Get event subscriptions for a process (for API responses) */
+    getEventSubscriptions(processName: string): Array<{
+        pattern: string;
+        filter?: Record<string, unknown>;
+        debounceMs?: number;
+    }>;
+    runProcess(name: string, triggerType: 'cron' | 'event' | 'manual', eventPayload?: Record<string, unknown>): Promise<string>;
+    /** Build AI prompt from process definition */
+    buildProcessPrompt(definition: ProcessDefinition, runId: string, triggerType: 'cron' | 'event' | 'manual', eventPayload?: Record<string, unknown>): Promise<{
+        prompt: string;
+        files?: Array<{
+            name: string;
+            path: string;
+        }>;
+    }>;
+    /** Build the execution instruction telling the model to execute the process */
+    private buildExecutionInstruction;
+    /** Build the Metrics Protocol injection for processes with ## Metrics section */
+    private buildMetricsProtocol;
+    /**
+     * Consume AsyncGenerator<AIChunk> until completion or error.
+     * Timeout is handled by engine.call() internally.
+     * Returns claudeSessionId, usage, and contentBlocks for session persistence.
+     */
+    private consumeAIStream;
+    private tryExecuteNext;
+    private executeEntry;
+    getQueueStatus(): {
+        queued: number;
+        running: number;
+        maxConcurrent: number;
+        entries: ProcessQueueEntry[];
+    };
+    getProcessStatus(name: string): ProcessStatus;
+    listProcesses(options?: {
+        status?: 'active' | 'paused';
+    }): Promise<ProcessDefinition[]>;
+    /** Get all registry definitions (for config persistence by route layer) */
+    getRegistryDefinitions(): import('../../types/process.js').ProcessDefinitionConfig[];
+    getProcess(name: string): Promise<ProcessDefinition | undefined>;
+    getRunning(): ProcessQueueEntry[];
+    getLogger(): ProcessLogger;
+    getLogs(processName: string, options?: {
+        limit?: number;
+        offset?: number;
+        from?: string;
+        to?: string;
+    }): Promise<ProcessLogEntry[]>;
+    getLogCount(processName: string, options?: {
+        from?: string;
+        to?: string;
+    }): Promise<number>;
+    getLog(processName: string, runId: string): Promise<ProcessLogEntry | null>;
+    getMetrics(processName: string): Promise<ProcessMetricsAggregate[]>;
+    reportMetric(processName: string, snapshot: Omit<ProcessMetricSnapshot, 'timestamp'> & {
+        timestamp?: string;
+    }): Promise<void>;
+    getMetricSnapshots(processName: string, options?: {
+        metricName?: string;
+        from?: string;
+        to?: string;
+        limit?: number;
+    }): Promise<ProcessMetricSnapshot[]>;
+    getMetricsViewConfig(processName: string): Promise<ProcessMetricsViewConfig | null>;
+    setMetricsViewConfig(processName: string, config: ProcessMetricsViewConfig): Promise<void>;
+    deleteMetricsViewConfig(processName: string): Promise<void>;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/backend/process/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/backend/process/engine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAmC,MAAM,mBAAmB,CAAC;AAEnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,uBAAuB,EACxB,MAAM,wBAAwB,CAAC;AAMhC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,KAAK,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAC9F,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAgC,MAAM,0BAA0B,CAAC;AAE7F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAIlD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,QAAQ,CAAC;IACjB,cAAc,EAAE,cAAc,CAAC;IAC/B,KAAK,EAAE,SAAS,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,CAAW;IAC5B,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,UAAU,CAAC,CAAa;IAChC,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;IAC3B,4FAA4F;IAC5F,OAAO,CAAC,oBAAoB,CAA6G;gBAE7H,OAAO,EAAE,oBAAoB;IAuBnC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkCjC,OAAO,CAAC,qBAAqB;IAOvB,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,iBAAiB,EAAE,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA8B1G,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAwB7C,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWzC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB1C,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,aAAa,GAAG,MAAM,GAAG,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,eAAe,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAiB3N,gFAAgF;IAChF,yBAAyB,CACvB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,UAAU,CAAC,EAAE,MAAM,EACnB,KAAK,GAAE,OAAc,GACpB,IAAI;IAsBP,qDAAqD;IACrD,2BAA2B,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAiBxE,gEAAgE;IAChE,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAIvH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IA0BjI,8CAA8C;IACxC,kBAAkB,CACtB,UAAU,EAAE,iBAAiB,EAC7B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,EACxC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAiE7E,+EAA+E;IAC/E,OAAO,CAAC,yBAAyB;IAcjC,iFAAiF;IACjF,OAAO,CAAC,oBAAoB;IA8B5B;;;;OAIG;YACW,eAAe;IAmD7B,OAAO,CAAC,cAAc;YAYR,YAAY;IAuK1B,cAAc,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,iBAAiB,EAAE,CAAA;KAAE;IAI1G,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa;IAe7C,aAAa,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIvF,2EAA2E;IAC3E,sBAAsB,IAAI,OAAO,wBAAwB,EAAE,uBAAuB,EAAE;IAIpF,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAIhE,UAAU,IAAI,iBAAiB,EAAE;IAIjC,SAAS,IAAI,aAAa;IAIpB,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAInI,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3F,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAI3E,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAMnE,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,qBAAqB,EAAE,WAAW,CAAC,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ7H,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAIxJ,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC;IAInF,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1F,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CA8BhC"}