@deriest/ai-engineering-company 1.15.2

package/dist/index.js

@@ -0,0 +1,277 @@
+import * as os from "node:os";
+import * as path from "node:path";
+import { dispatchGatewayMethod } from "openclaw/plugin-sdk/gateway-method-runtime";
+import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
+import { registerAiCompanyCli } from "./cli.js";
+import { handleAiCompanyCommand } from "./commands/aicompany.js";
+import { AuditLogger } from "./audit-logger.js";
+import { DecisionQueue } from "./decision-queue.js";
+import { DispatchService } from "./dispatch-service.js";
+import { Dispatcher } from "./dispatcher.js";
+import { registerAiCompanyGatewayMethods } from "./gateway.js";
+import { MemoryLeaseProvider } from "./memory-lease-provider.js";
+import { MemoryQueueBackend } from "./memory-queue-backend.js";
+import { RedisLeaseProvider } from "./redis-lease-provider.js";
+import { RedisQueueBackend } from "./redis-queue-backend.js";
+import { MetricsRegistry } from "./metrics-registry.js";
+import { OrgEngine } from "./org-engine.js";
+import { PipelineCheckpoint } from "./pipeline-checkpoint.js";
+import { PipelineEngine } from "./pipeline-engine.js";
+import { TaskStateManager } from "./task-state.js";
+import { createAiCompanyTools } from "./tools.js";
+import { WorkboardGateway } from "./workboard-gateway.js";
+import { WorkerEngine } from "./worker-engine.js";
+// All metrics explicitly declared — no auto-registration
+const METRIC_DECLARATIONS = [
+    // Counters
+    { name: "dispatch_total", type: "counter", help: "Total dispatches" },
+    { name: "dispatch_by_source_gateway", type: "counter" },
+    { name: "dispatch_by_source_cli", type: "counter" },
+    { name: "dispatch_by_source_tool", type: "counter" },
+    { name: "dispatch_by_source_command", type: "counter" },
+    { name: "dispatch_by_status_success", type: "counter" },
+    { name: "dispatch_by_status_error", type: "counter" },
+    { name: "dispatch_by_status_rejected", type: "counter" },
+    { name: "pipeline_started_total", type: "counter" },
+    { name: "pipeline_completed_total", type: "counter" },
+    { name: "pipeline_failed_total", type: "counter" },
+    { name: "stage_started_total", type: "counter" },
+    { name: "stage_completed_total", type: "counter" },
+    { name: "stage_failed_total", type: "counter" },
+    { name: "approval_requested_total", type: "counter" },
+    { name: "approval_decided_total", type: "counter" },
+    { name: "approval_timeout_total", type: "counter" },
+    { name: "audit_events_total", type: "counter" },
+    { name: "audit_write_errors_total", type: "counter" },
+    { name: "rpc_total", type: "counter" },
+    { name: "rpc_errors_total", type: "counter" },
+    // Gauges
+    { name: "queue_depth", type: "gauge" },
+    { name: "active_pipelines", type: "gauge" },
+    // Histograms
+    { name: "dispatch_duration_ms", type: "histogram" },
+    { name: "stage_duration_ms", type: "histogram" },
+    { name: "approval_latency_ms", type: "histogram" },
+    { name: "approval_pending_duration_ms", type: "histogram" },
+    // Timers
+    { name: "pipeline_duration_ms", type: "timer" },
+];
+const plugin = definePluginEntry({
+    id: "ai-engineering-company",
+    name: "AI Engineering Company",
+    description: "Management layer that orchestrates AI agents for engineering tasks",
+    register(api) {
+        api.logger.info("Initializing AI Engineering Company Plugin");
+        const rootDir = api.rootDir || process.cwd();
+        const config = api.pluginConfig || {};
+        const officesPath = path.resolve(rootDir, config.offices || "config/offices.json");
+        const orgPath = path.resolve(rootDir, config.organization || "assets/organization/organization.json");
+        const workflowsPath = path.resolve(rootDir, config.workflows || "config/workflows.json");
+        const workersPath = path.resolve(rootDir, config.workers || "assets/workers");
+        // Metrics: instantiate, load persisted values (gauges NOT restored)
+        const metrics = new MetricsRegistry(METRIC_DECLARATIONS);
+        const metricsStorePath = path.resolve(rootDir, ".openclaw/metrics.json");
+        metrics.load(metricsStorePath);
+        const orgEngine = new OrgEngine(officesPath, orgPath);
+        const pipelineEngine = new PipelineEngine(workflowsPath);
+        const workerEngine = new WorkerEngine(workersPath);
+        // Workboard integration: Gateway RPC client via SDK dispatchGatewayMethod.
+        // Works when called from gateway method handlers (scope is set).
+        // Falls back to degraded mode when scope is unavailable (tool/CLI contexts).
+        const workboardGateway = new WorkboardGateway({
+            gateway: {
+                callMethod: async (method, params) => {
+                    const response = await dispatchGatewayMethod(method, params);
+                    return {
+                        ok: response.ok,
+                        data: response.payload,
+                        error: response.error,
+                    };
+                },
+            },
+            boardId: config.boardId ?? "ai-company",
+        });
+        // ponytail: remove cast when SDK types include session on PluginRuntimeCore
+        const session = api.runtime.session
+            ?? api.runtime.agent?.session;
+        // WP-24: Node identity resolution
+        const nodeId = config.nodeId || os.hostname();
+        // WP-24: Redis activation (opt-in)
+        const redisUrl = process.env.AI_COMPANY_REDIS_URL || config.redis?.url;
+        const redisPrefix = config.redis?.prefix || "ai-company:";
+        let queueBackend;
+        let leaseProvider;
+        let redisClose = null;
+        if (redisUrl) {
+            try {
+                const rqb = new RedisQueueBackend(redisUrl, redisPrefix);
+                const rlp = new RedisLeaseProvider(redisUrl, redisPrefix);
+                queueBackend = rqb;
+                leaseProvider = rlp;
+                redisClose = async () => { await rqb.close(); await rlp.close(); };
+                api.logger.info(`[distributed] Redis enabled at ${redisUrl.replace(/\/\/.*@/, "//***@")}`);
+            }
+            catch (err) {
+                api.logger.warn(`[distributed] Redis unavailable at ${redisUrl}. Falling back to single-node mode. Error: ${err.message}`);
+                queueBackend = new MemoryQueueBackend();
+                leaseProvider = new MemoryLeaseProvider();
+            }
+        }
+        else {
+            queueBackend = new MemoryQueueBackend();
+            leaseProvider = new MemoryLeaseProvider();
+        }
+        const taskState = new TaskStateManager();
+        const decisionQueue = new DecisionQueue(metrics, queueBackend);
+        const decisionStorePath = path.resolve(rootDir, ".openclaw/decisions.json");
+        decisionQueue.load(decisionStorePath);
+        // ponytail: 24h cleanup window — make configurable via plugin config if needed
+        decisionQueue.cleanup(24 * 60 * 60 * 1000);
+        decisionQueue.save();
+        // Recompute queue_depth from live state (never restore persisted gauge)
+        // WP-24: pendingCount is now async — computed from live state
+        decisionQueue.pendingCount().then(count => metrics.gauge("queue_depth", count)).catch(() => { });
+        const auditLogger = new AuditLogger(path.resolve(rootDir, ".openclaw/audit"), metrics);
+        const dispatcher = new Dispatcher(workerEngine, orgEngine, pipelineEngine);
+        const pipelineCheckpoint = new PipelineCheckpoint();
+        const checkpointStorePath = path.resolve(rootDir, ".openclaw/pipeline-checkpoints.json");
+        pipelineCheckpoint.load(checkpointStorePath);
+        // Report interrupted pipelines on startup
+        const interrupted = pipelineCheckpoint.list("running").concat(pipelineCheckpoint.list("awaiting_approval"));
+        if (interrupted.length > 0) {
+            api.logger.info(`[recovery] ${interrupted.length} interrupted pipeline(s) detected. Run 'ai-company recover' for details.`);
+        }
+        pipelineCheckpoint.cleanup(24 * 60 * 60 * 1000);
+        pipelineCheckpoint.save();
+        // Re-enqueue awaiting_approval checkpoints into DecisionQueue
+        const awaitingApproval = pipelineCheckpoint.list("awaiting_approval");
+        for (const cp of awaitingApproval) {
+            const stageEntry = cp.stages[cp.currentStageIndex];
+            if (stageEntry && !decisionQueue.get(cp.sessionKey)) {
+                decisionQueue.enqueue(cp.sessionKey, stageEntry.stage, stageEntry.worker, cp.objective);
+            }
+        }
+        // Recompute active_pipelines from live state (never restore persisted gauge)
+        metrics.gauge("active_pipelines", taskState.list("running").length);
+        const dispatchService = new DispatchService(api.runtime.subagent, session, workboardGateway, workerEngine, taskState, dispatcher, orgEngine, workersPath, decisionQueue, auditLogger, undefined, // approvalTimeoutMs default
+        pipelineCheckpoint, metrics, leaseProvider, nodeId);
+        // Subscribe to DecisionQueue decision events for audit logging
+        decisionQueue.on("decision", (evt) => {
+            auditLogger.write({
+                ts: new Date().toISOString(),
+                sessionKey: evt.sessionKey,
+                event: evt.status === "approved" ? "approved" : "rejected",
+                decisionStatus: evt.status,
+                reason: evt.reason,
+                operator: evt.operator,
+            });
+        });
+        // CLI commands: openclaw ai-company dispatch|status|result|audit
+        api.registerCli(async ({ program }) => {
+            registerAiCompanyCli({
+                program,
+                dispatchService,
+                session,
+                log: (msg) => api.logger.info(msg),
+                decisionQueue,
+                auditLogger,
+                pipelineCheckpoint,
+            });
+        }, {
+            descriptors: [
+                {
+                    name: "ai-company",
+                    description: "AI Engineering Company operator commands",
+                    hasSubcommands: true,
+                },
+            ],
+        });
+        // Agent tools: dispatch, status, result
+        const tools = createAiCompanyTools({ dispatchService, session, decisionQueue });
+        for (const tool of tools) {
+            api.registerTool(tool);
+        }
+        // Gateway RPC: dispatch, status, result, approvals
+        registerAiCompanyGatewayMethods({ api, dispatchService, session, decisionQueue, metrics });
+        // Slash command: /aicompany <task>
+        api.registerCommand({
+            name: "aicompany",
+            description: "Dispatch a natural-language engineering task to the AI Engineering Company",
+            acceptsArgs: true,
+            handler: handleAiCompanyCommand({ dispatchService, dispatcher }),
+        });
+        // Lifecycle cleanup registration.
+        // ponytail: init logic (engines, workboard) should run in a gateway_start hook.
+        // Move to registerHook when that API is available.
+        api.lifecycle.registerRuntimeLifecycle({
+            id: "ai-engineering-company-init",
+            cleanup: async () => {
+                decisionQueue.save();
+                pipelineCheckpoint.save();
+                metrics.save();
+                if (redisClose)
+                    await redisClose();
+            },
+        });
+    },
+});
+// Attach tool-plugin metadata so `openclaw plugins build` can extract manifest info.
+Object.defineProperty(plugin, Symbol.for("openclaw.plugin-sdk.tool-plugin.metadata"), {
+    value: {
+        id: "ai-engineering-company",
+        name: "AI Engineering Company",
+        description: "Management layer that orchestrates AI agents for engineering tasks",
+        activation: { onStartup: true },
+        configSchema: {
+            type: "object",
+            properties: {
+                offices: { type: "string", description: "Path to offices.json config" },
+                workflows: { type: "string", description: "Path to workflows.json config" },
+                workers: { type: "string", description: "Path to workers directory" },
+                boardId: { type: "string", description: "Workboard board ID for task cards" },
+            },
+        },
+        tools: [
+            {
+                name: "ai_company_dispatch",
+                label: "AI Company Dispatch",
+                description: "Submit a task to the AI Engineering Company Dispatcher agent.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        message: { type: "string", description: "Task description for the Dispatcher agent." },
+                        wait: { type: "boolean", description: "Wait for completion (default: true)." },
+                        timeout: { type: "number", description: "Max wait time in milliseconds (default: 900000)." },
+                    },
+                    required: ["message"],
+                },
+            },
+            {
+                name: "ai_company_status",
+                label: "AI Company Status",
+                description: "Query the status of a dispatched task or list recent dispatches.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        sessionKey: { type: "string", description: "Session key to query. Omit to list recent dispatches." },
+                    },
+                },
+            },
+            {
+                name: "ai_company_result",
+                label: "AI Company Result",
+                description: "Retrieve the result messages of a completed dispatch.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        sessionKey: { type: "string", description: "Session key of the completed task." },
+                        limit: { type: "number", description: "Max messages to retrieve (default: 50)." },
+                    },
+                    required: ["sessionKey"],
+                },
+            },
+        ],
+    },
+});
+export default plugin;
+//# 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,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAiC,MAAM,kCAAkC,CAAC;AACpG,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAA0B,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,yDAAyD;AACzD,MAAM,mBAAmB,GAAwB;IAC/C,WAAW;IACX,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,kBAAkB,EAAE;IACrE,EAAE,IAAI,EAAE,4BAA4B,EAAE,IAAI,EAAE,SAAS,EAAE;IACvD,EAAE,IAAI,EAAE,wBAAwB,EAAE,IAAI,EAAE,SAAS,EAAE;IACnD,EAAE,IAAI,EAAE,yBAAyB,EAAE,IAAI,EAAE,SAAS,EAAE;IACpD,EAAE,IAAI,EAAE,4BAA4B,EAAE,IAAI,EAAE,SAAS,EAAE;IACvD,EAAE,IAAI,EAAE,4BAA4B,EAAE,IAAI,EAAE,SAAS,EAAE;IACvD,EAAE,IAAI,EAAE,0BAA0B,EAAE,IAAI,EAAE,SAAS,EAAE;IACrD,EAAE,IAAI,EAAE,6BAA6B,EAAE,IAAI,EAAE,SAAS,EAAE;IACxD,EAAE,IAAI,EAAE,wBAAwB,EAAE,IAAI,EAAE,SAAS,EAAE;IACnD,EAAE,IAAI,EAAE,0BAA0B,EAAE,IAAI,EAAE,SAAS,EAAE;IACrD,EAAE,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,SAAS,EAAE;IAClD,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,SAAS,EAAE;IAChD,EAAE,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,SAAS,EAAE;IAClD,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,SAAS,EAAE;IAC/C,EAAE,IAAI,EAAE,0BAA0B,EAAE,IAAI,EAAE,SAAS,EAAE;IACrD,EAAE,IAAI,EAAE,wBAAwB,EAAE,IAAI,EAAE,SAAS,EAAE;IACnD,EAAE,IAAI,EAAE,wBAAwB,EAAE,IAAI,EAAE,SAAS,EAAE;IACnD,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,SAAS,EAAE;IAC/C,EAAE,IAAI,EAAE,0BAA0B,EAAE,IAAI,EAAE,SAAS,EAAE;IACrD,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;IACtC,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,SAAS,EAAE;IAC7C,SAAS;IACT,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE;IACtC,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,OAAO,EAAE;IAC3C,aAAa;IACb,EAAE,IAAI,EAAE,sBAAsB,EAAE,IAAI,EAAE,WAAW,EAAE;IACnD,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,WAAW,EAAE;IAChD,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,WAAW,EAAE;IAClD,EAAE,IAAI,EAAE,8BAA8B,EAAE,IAAI,EAAE,WAAW,EAAE;IAC3D,SAAS;IACT,EAAE,IAAI,EAAE,sBAAsB,EAAE,IAAI,EAAE,OAAO,EAAE;CAChD,CAAC;AAEF,MAAM,MAAM,GAAG,iBAAiB,CAAC;IAC/B,EAAE,EAAE,wBAAwB;IAC5B,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE,oEAAoE;IACjF,QAAQ,CAAC,GAAG;QACV,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;QAE9D,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC;QAEtC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAG,MAAM,CAAC,OAAkB,IAAI,qBAAqB,CAAC,CAAC;QAC/F,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAG,MAAM,CAAC,YAAuB,IAAI,uCAAuC,CAAC,CAAC;QAClH,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAChC,OAAO,EACN,MAAM,CAAC,SAAoB,IAAI,uBAAuB,CACxD,CAAC;QACF,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAG,MAAM,CAAC,OAAkB,IAAI,gBAAgB,CAAC,CAAC;QAE1F,oEAAoE;QACpE,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC,mBAAmB,CAAC,CAAC;QACzD,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,wBAAwB,CAAC,CAAC;QACzE,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAE/B,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACtD,MAAM,cAAc,GAAG,IAAI,cAAc,CAAC,aAAa,CAAC,CAAC;QACzD,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,WAAW,CAAC,CAAC;QAEnD,2EAA2E;QAC3E,iEAAiE;QACjE,6EAA6E;QAC7E,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAAC;YAC5C,OAAO,EAAE;gBACP,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;oBACnC,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;oBAC7D,OAAO;wBACL,EAAE,EAAE,QAAQ,CAAC,EAAE;wBACf,IAAI,EAAE,QAAQ,CAAC,OAAkC;wBACjD,KAAK,EAAE,QAAQ,CAAC,KAAK;qBACtB,CAAC;gBACJ,CAAC;aACF;YACD,OAAO,EAAG,MAAM,CAAC,OAAkB,IAAI,YAAY;SACpD,CAAC,CAAC;QAEH,4EAA4E;QAC5E,MAAM,OAAO,GAAI,GAAG,CAAC,OAAqE,CAAC,OAAO;eAC7F,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC;QAChC,kCAAkC;QAClC,MAAM,MAAM,GAAI,MAAM,CAAC,MAAiB,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC;QAE1D,mCAAmC;QACnC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAK,MAAM,CAAC,KAA0B,EAAE,GAAG,CAAC;QAC7F,MAAM,WAAW,GAAI,MAAM,CAAC,KAA6B,EAAE,MAAM,IAAI,aAAa,CAAC;QAEnF,IAAI,YAAoD,CAAC;QACzD,IAAI,aAAuD,CAAC;QAC5D,IAAI,UAAU,GAAiC,IAAI,CAAC;QAEpD,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,iBAAiB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;gBACzD,MAAM,GAAG,GAAG,IAAI,kBAAkB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;gBAC1D,YAAY,GAAG,GAAG,CAAC;gBACnB,aAAa,GAAG,GAAG,CAAC;gBACpB,UAAU,GAAG,KAAK,IAAI,EAAE,GAAG,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;gBACnE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,kCAAkC,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC7F,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,sCAAsC,QAAQ,8CAA+C,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;gBACtI,YAAY,GAAG,IAAI,kBAAkB,EAAE,CAAC;gBACxC,aAAa,GAAG,IAAI,mBAAmB,EAAE,CAAC;YAC5C,CAAC;QACH,CAAC;aAAM,CAAC;YACN,YAAY,GAAG,IAAI,kBAAkB,EAAE,CAAC;YACxC,aAAa,GAAG,IAAI,mBAAmB,EAAE,CAAC;QAC5C,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACzC,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAC/D,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,0BAA0B,CAAC,CAAC;QAC5E,aAAa,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACtC,+EAA+E;QAC/E,aAAa,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAC3C,aAAa,CAAC,IAAI,EAAE,CAAC;QAErB,wEAAwE;QACxE,8DAA8D;QAC9D,aAAa,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAEhG,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC,CAAC;QACvF,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,YAAY,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;QAC3E,MAAM,kBAAkB,GAAG,IAAI,kBAAkB,EAAE,CAAC;QACpD,MAAM,mBAAmB,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,qCAAqC,CAAC,CAAC;QACzF,kBAAkB,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAC7C,0CAA0C;QAC1C,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC;QAC5G,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,WAAW,CAAC,MAAM,0EAA0E,CAAC,CAAC;QAC9H,CAAC;QACD,kBAAkB,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAChD,kBAAkB,CAAC,IAAI,EAAE,CAAC;QAE1B,8DAA8D;QAC9D,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACtE,KAAK,MAAM,EAAE,IAAI,gBAAgB,EAAE,CAAC;YAClC,MAAM,UAAU,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC;YACnD,IAAI,UAAU,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC;gBACpD,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,KAAuE,EAAE,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC;YAC5J,CAAC;QACH,CAAC;QAED,6EAA6E;QAC7E,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;QAEpE,MAAM,eAAe,GAAG,IAAI,eAAe,CACzC,GAAG,CAAC,OAAO,CAAC,QAAQ,EACpB,OAAO,EACP,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,UAAU,EACV,SAAS,EACT,WAAW,EACX,aAAa,EACb,WAAW,EACX,SAAS,EAAE,4BAA4B;QACvC,kBAAkB,EAClB,OAAO,EACP,aAAa,EACb,MAAM,CACP,CAAC;QAEF,+DAA+D;QAC/D,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,GAAgG,EAAE,EAAE;YAChI,WAAW,CAAC,KAAK,CAAC;gBAChB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBAC5B,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,KAAK,EAAE,GAAG,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU;gBAC1D,cAAc,EAAE,GAAG,CAAC,MAAM;gBAC1B,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,QAAQ,EAAE,GAAG,CAAC,QAAQ;aACvB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,iEAAiE;QACjE,GAAG,CAAC,WAAW,CACb,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;YACpB,oBAAoB,CAAC;gBACnB,OAAO;gBACP,eAAe;gBACf,OAAO;gBACP,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;gBAClC,aAAa;gBACb,WAAW;gBACX,kBAAkB;aACnB,CAAC,CAAC;QACL,CAAC,EACD;YACE,WAAW,EAAE;gBACX;oBACE,IAAI,EAAE,YAAY;oBAClB,WAAW,EAAE,0CAA0C;oBACvD,cAAc,EAAE,IAAI;iBACrB;aACF;SACF,CACF,CAAC;QAEF,wCAAwC;QACxC,MAAM,KAAK,GAAG,oBAAoB,CAAC,EAAE,eAAe,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;QAChF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAED,mDAAmD;QACnD,+BAA+B,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC;QAE3F,mCAAmC;QACnC,GAAG,CAAC,eAAe,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,WAAW,EAAE,4EAA4E;YACzF,WAAW,EAAE,IAAI;YACjB,OAAO,EAAE,sBAAsB,CAAC,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC;SACjE,CAAC,CAAC;QAEH,kCAAkC;QAClC,gFAAgF;QAChF,mDAAmD;QACnD,GAAG,CAAC,SAAS,CAAC,wBAAwB,CAAC;YACrC,EAAE,EAAE,6BAA6B;YACjC,OAAO,EAAE,KAAK,IAAI,EAAE;gBAClB,aAAa,CAAC,IAAI,EAAE,CAAC;gBACrB,kBAAkB,CAAC,IAAI,EAAE,CAAC;gBAC1B,OAAO,CAAC,IAAI,EAAE,CAAC;gBACf,IAAI,UAAU;oBAAE,MAAM,UAAU,EAAE,CAAC;YACrC,CAAC;SACF,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC;AAEH,qFAAqF;AACrF,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,0CAA0C,CAAC,EAAE;IACpF,KAAK,EAAE;QACL,EAAE,EAAE,wBAAwB;QAC5B,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,oEAAoE;QACjF,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;QAC/B,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;gBACvE,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;gBAC3E,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;gBACrE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mCAAmC,EAAE;aAC9E;SACF;QACD,KAAK,EAAE;YACL;gBACE,IAAI,EAAE,qBAAqB;gBAC3B,KAAK,EAAE,qBAAqB;gBAC5B,WAAW,EAAE,+DAA+D;gBAC5E,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4CAA4C,EAAE;wBACtF,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,sCAAsC,EAAE;wBAC9E,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kDAAkD,EAAE;qBAC7F;oBACD,QAAQ,EAAE,CAAC,SAAS,CAAC;iBACtB;aACF;YACD;gBACE,IAAI,EAAE,mBAAmB;gBACzB,KAAK,EAAE,mBAAmB;gBAC1B,WAAW,EAAE,kEAAkE;gBAC/E,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uDAAuD,EAAE;qBACrG;iBACF;aACF;YACD;gBACE,IAAI,EAAE,mBAAmB;gBACzB,KAAK,EAAE,mBAAmB;gBAC1B,WAAW,EAAE,uDAAuD;gBACpE,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oCAAoC,EAAE;wBACjF,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yCAAyC,EAAE;qBAClF;oBACD,QAAQ,EAAE,CAAC,YAAY,CAAC;iBACzB;aACF;SACF;KACF;CACF,CAAC,CAAC;AAEH,eAAe,MAAkC,CAAC"}

package/dist/lease-provider.d.ts

@@ -0,0 +1,31 @@
+export interface Lease {
+    sessionKey: string;
+    nodeId: string;
+    acquiredAt: number;
+    expiresAt: number;
+}
+export interface LeaseProvider {
+    /**
+     * Attempt to acquire a lease. Returns true if acquired, false if already held.
+     * TTL is in seconds.
+     */
+    acquire(sessionKey: string, nodeId: string, ttlSeconds: number): Promise<boolean>;
+    /**
+     * Renew an existing lease. Returns true if renewed, false if not the current owner.
+     * TTL is in seconds.
+     */
+    renew(sessionKey: string, nodeId: string, ttlSeconds: number): Promise<boolean>;
+    /**
+     * Release a lease. Returns true if released, false if not the current owner.
+     */
+    release(sessionKey: string, nodeId: string): Promise<boolean>;
+    /**
+     * Get the current lease for a sessionKey, if any and not expired.
+     */
+    get(sessionKey: string): Promise<Lease | undefined>;
+    /**
+     * Remove expired leases. Returns count of removed leases.
+     */
+    cleanup(): Promise<number>;
+}
+//# sourceMappingURL=lease-provider.d.ts.map

package/dist/lease-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lease-provider.d.ts","sourceRoot":"","sources":["../src/lease-provider.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,KAAK;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAElF;;;OAGG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhF;;OAEG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9D;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IAEpD;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5B"}

package/dist/lease-provider.js

@@ -0,0 +1,4 @@
+// LeaseProvider interface — abstracts ownership leasing for pipeline execution.
+// Implementations: MemoryLeaseProvider (default).
+export {};
+//# sourceMappingURL=lease-provider.js.map

package/dist/lease-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lease-provider.js","sourceRoot":"","sources":["../src/lease-provider.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,kDAAkD"}

package/dist/memory-lease-provider.d.ts

@@ -0,0 +1,10 @@
+import type { Lease, LeaseProvider } from "./lease-provider.js";
+export declare class MemoryLeaseProvider implements LeaseProvider {
+    private readonly leases;
+    acquire(sessionKey: string, nodeId: string, ttlSeconds: number): Promise<boolean>;
+    renew(sessionKey: string, nodeId: string, ttlSeconds: number): Promise<boolean>;
+    release(sessionKey: string, nodeId: string): Promise<boolean>;
+    get(sessionKey: string): Promise<Lease | undefined>;
+    cleanup(): Promise<number>;
+}
+//# sourceMappingURL=memory-lease-provider.d.ts.map

package/dist/memory-lease-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-lease-provider.d.ts","sourceRoot":"","sources":["../src/memory-lease-provider.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEhE,qBAAa,mBAAoB,YAAW,aAAa;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IAEnD,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAejF,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS/E,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS7D,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;IAQnD,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;CAW3B"}

package/dist/memory-lease-provider.js

@@ -0,0 +1,54 @@
+// MemoryLeaseProvider — default in-memory LeaseProvider implementation.
+// Single-node leases with TTL expiration. No distributed coordination.
+export class MemoryLeaseProvider {
+    leases = new Map();
+    acquire(sessionKey, nodeId, ttlSeconds) {
+        const existing = this.leases.get(sessionKey);
+        if (existing && existing.expiresAt > Date.now()) {
+            return Promise.resolve(false); // already held
+        }
+        const now = Date.now();
+        this.leases.set(sessionKey, {
+            sessionKey,
+            nodeId,
+            acquiredAt: now,
+            expiresAt: now + ttlSeconds * 1000,
+        });
+        return Promise.resolve(true);
+    }
+    renew(sessionKey, nodeId, ttlSeconds) {
+        const existing = this.leases.get(sessionKey);
+        if (!existing || existing.nodeId !== nodeId || existing.expiresAt <= Date.now()) {
+            return Promise.resolve(false);
+        }
+        existing.expiresAt = Date.now() + ttlSeconds * 1000;
+        return Promise.resolve(true);
+    }
+    release(sessionKey, nodeId) {
+        const existing = this.leases.get(sessionKey);
+        if (!existing || existing.nodeId !== nodeId) {
+            return Promise.resolve(false);
+        }
+        this.leases.delete(sessionKey);
+        return Promise.resolve(true);
+    }
+    get(sessionKey) {
+        const existing = this.leases.get(sessionKey);
+        if (!existing || existing.expiresAt <= Date.now()) {
+            return Promise.resolve(undefined);
+        }
+        return Promise.resolve(existing);
+    }
+    cleanup() {
+        const now = Date.now();
+        let removed = 0;
+        for (const [key, lease] of this.leases) {
+            if (lease.expiresAt <= now) {
+                this.leases.delete(key);
+                removed++;
+            }
+        }
+        return Promise.resolve(removed);
+    }
+}
+//# sourceMappingURL=memory-lease-provider.js.map

package/dist/memory-lease-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-lease-provider.js","sourceRoot":"","sources":["../src/memory-lease-provider.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,uEAAuE;AAIvE,MAAM,OAAO,mBAAmB;IACb,MAAM,GAAG,IAAI,GAAG,EAAiB,CAAC;IAEnD,OAAO,CAAC,UAAkB,EAAE,MAAc,EAAE,UAAkB;QAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,QAAQ,IAAI,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAChD,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe;QAChD,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE;YAC1B,UAAU;YACV,MAAM;YACN,UAAU,EAAE,GAAG;YACf,SAAS,EAAE,GAAG,GAAG,UAAU,GAAG,IAAI;SACnC,CAAC,CAAC;QACH,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,UAAkB,EAAE,MAAc,EAAE,UAAkB;QAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,MAAM,IAAI,QAAQ,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAChF,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QACD,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,GAAG,IAAI,CAAC;QACpD,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,CAAC,UAAkB,EAAE,MAAc;QACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC5C,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC/B,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,GAAG,CAAC,UAAkB;QACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAClD,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED,OAAO;QACL,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACvC,IAAI,KAAK,CAAC,SAAS,IAAI,GAAG,EAAE,CAAC;gBAC3B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACxB,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;CACF"}

package/dist/memory-queue-backend.d.ts

@@ -0,0 +1,16 @@
+import type { DecisionStatus } from "./decision-queue.js";
+import type { QueueBackend, QueueEntry, QueueEntryUpdate } from "./queue-backend.js";
+export declare class MemoryQueueBackend implements QueueBackend {
+    private readonly entries;
+    private filePath;
+    enqueue(entry: QueueEntry): Promise<QueueEntry>;
+    get(sessionKey: string): Promise<QueueEntry | undefined>;
+    list(filter?: DecisionStatus): Promise<QueueEntry[]>;
+    update(sessionKey: string, update: QueueEntryUpdate): Promise<QueueEntry | null>;
+    remove(sessionKey: string): Promise<boolean>;
+    load(filePath: string): Promise<void>;
+    save(filePath?: string): Promise<void>;
+    trySave(): Promise<void>;
+    cleanup(maxAgeMs: number): Promise<number>;
+}
+//# sourceMappingURL=memory-queue-backend.d.ts.map

package/dist/memory-queue-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-queue-backend.d.ts","sourceRoot":"","sources":["../src/memory-queue-backend.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAErF,qBAAa,kBAAmB,YAAW,YAAY;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAuB;IAEvC,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAM/C,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAIxD,IAAI,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAKpD,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAWhF,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAM5C,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBrC,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAetC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAc3C"}

package/dist/memory-queue-backend.js

@@ -0,0 +1,93 @@
+// MemoryQueueBackend — default in-memory QueueBackend implementation.
+// Matches current DecisionQueue behavior exactly.
+import * as fs from "node:fs";
+import * as path from "node:path";
+export class MemoryQueueBackend {
+    entries = new Map();
+    filePath = null;
+    enqueue(entry) {
+        this.entries.set(entry.sessionKey, entry);
+        this.trySave();
+        return Promise.resolve(entry);
+    }
+    get(sessionKey) {
+        return Promise.resolve(this.entries.get(sessionKey));
+    }
+    list(filter) {
+        const all = [...this.entries.values()];
+        return Promise.resolve(filter ? all.filter((d) => d.status === filter) : all);
+    }
+    update(sessionKey, update) {
+        const entry = this.entries.get(sessionKey);
+        if (!entry)
+            return Promise.resolve(null);
+        if (update.status !== undefined)
+            entry.status = update.status;
+        if (update.reason !== undefined)
+            entry.reason = update.reason;
+        if (update.operator !== undefined)
+            entry.operator = update.operator;
+        if (update.decidedAt !== undefined)
+            entry.decidedAt = update.decidedAt;
+        this.trySave();
+        return Promise.resolve(entry);
+    }
+    remove(sessionKey) {
+        const result = this.entries.delete(sessionKey);
+        if (result)
+            this.trySave();
+        return Promise.resolve(result);
+    }
+    load(filePath) {
+        this.filePath = filePath;
+        try {
+            const raw = fs.readFileSync(filePath, "utf-8");
+            const parsed = JSON.parse(raw);
+            if (!Array.isArray(parsed))
+                return Promise.resolve();
+            for (const entry of parsed) {
+                if (entry && typeof entry.sessionKey === "string" && entry.status === "pending") {
+                    this.entries.set(entry.sessionKey, entry);
+                }
+            }
+        }
+        catch {
+            // Missing or corrupt file — start with empty queue
+        }
+        return Promise.resolve();
+    }
+    save(filePath) {
+        const target = filePath ?? this.filePath;
+        if (!target)
+            return Promise.resolve();
+        const pending = [...this.entries.values()].filter((d) => d.status === "pending");
+        const tmpPath = target + ".tmp";
+        try {
+            fs.mkdirSync(path.dirname(target), { recursive: true });
+            fs.writeFileSync(tmpPath, JSON.stringify(pending, null, 2) + "\n", "utf-8");
+            fs.renameSync(tmpPath, target);
+        }
+        catch {
+            // Persistence failure — queue remains functional in-memory
+        }
+        return Promise.resolve();
+    }
+    trySave() {
+        return this.save();
+    }
+    cleanup(maxAgeMs) {
+        const now = Date.now();
+        let removed = 0;
+        for (const [key, entry] of this.entries) {
+            if (entry.status === "pending" && now - entry.requestedAt > maxAgeMs) {
+                this.entries.delete(key);
+                removed++;
+            }
+        }
+        if (removed > 0) {
+            this.trySave();
+        }
+        return Promise.resolve(removed);
+    }
+}
+//# sourceMappingURL=memory-queue-backend.js.map

package/dist/memory-queue-backend.js.map

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

package/dist/metrics-registry.d.ts

@@ -0,0 +1,58 @@
+export type MetricType = "counter" | "gauge" | "histogram" | "timer";
+export interface MetricDeclaration {
+    name: string;
+    type: MetricType;
+    help?: string;
+    buckets?: number[];
+}
+export interface HistogramData {
+    buckets: number[];
+    counts: number[];
+    sum: number;
+    count: number;
+}
+export interface TimerData {
+    count: number;
+    sum: number;
+    min: number;
+    max: number;
+}
+export type MetricValue = number | HistogramData | TimerData;
+export interface MetricsSnapshot {
+    counters: Record<string, number>;
+    gauges: Record<string, number>;
+    histograms: Record<string, HistogramData>;
+    timers: Record<string, TimerData>;
+}
+export declare class MetricsRegistry {
+    private readonly declarations;
+    private readonly counters;
+    private readonly gauges;
+    private readonly histograms;
+    private readonly timers;
+    private filePath;
+    constructor(declarations: MetricDeclaration[]);
+    private assertDeclared;
+    increment(name: string, value?: number): void;
+    gauge(name: string, value: number): void;
+    observe(name: string, value: number): void;
+    startTimer(name: string): () => void;
+    getSnapshot(): MetricsSnapshot;
+    toJSON(): string;
+    /**
+     * Load persisted counters, histograms, and timers from JSON.
+     * Gauges are NOT restored — they must be recomputed from live state.
+     */
+    loadFromJSON(json: string): void;
+    /**
+     * Load from a JSON file. Gracefully handles missing or corrupt files.
+     */
+    load(filePath: string): void;
+    /**
+     * Save current snapshot to the configured file path. Atomic write (.tmp + rename).
+     */
+    save(filePath?: string): void;
+    /** Reset all metrics to initial values. Declarations are preserved. */
+    reset(): void;
+}
+//# sourceMappingURL=metrics-registry.d.ts.map

package/dist/metrics-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-registry.d.ts","sourceRoot":"","sources":["../src/metrics-registry.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,CAAC;AAErE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC1C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACnC;AAID,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwC;IACrE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoC;IAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,OAAO,CAAC,QAAQ,CAAuB;gBAE3B,YAAY,EAAE,iBAAiB,EAAE;IA+B7C,OAAO,CAAC,cAAc;IAUtB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,IAAI;IAMxC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKxC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAkB1C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,IAAI;IAapC,WAAW,IAAI,eAAe;IAgB9B,MAAM,IAAI,MAAM;IAIhB;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAiChC;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAU5B;;OAEG;IACH,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAa7B,uEAAuE;IACvE,KAAK,IAAI,IAAI;CAgBd"}