anantham-v2 2.0.0-alpha.1

package/dist/jobs/background-job-supervisor.js

@@ -0,0 +1,102 @@
+/**
+ * Background Job Supervisor & Worker Pool.
+ * Executes background tasks asynchronously, manages heartbeats, monitors deadlines,
+ * and enforces project-level concurrency limits.
+ * PRD Part 2 Section 120–135.
+ */
+export class BackgroundJobSupervisor {
+    jobManager;
+    heartbeatIntervalMs;
+    maxConcurrentJobsPerProject;
+    maxConcurrentJobsGlobal;
+    activeJobs = new Map();
+    constructor(options) {
+        this.jobManager = options.jobManager;
+        this.heartbeatIntervalMs = options.heartbeatIntervalMs ?? 5000;
+        this.maxConcurrentJobsPerProject = options.maxConcurrentJobsPerProject ?? 5;
+        this.maxConcurrentJobsGlobal = options.maxConcurrentJobsGlobal ?? 20;
+    }
+    /**
+     * Check if project or global concurrency capacity is available.
+     */
+    canAcceptJob(projectId) {
+        if (this.activeJobs.size >= this.maxConcurrentJobsGlobal) {
+            return false;
+        }
+        let projectCount = 0;
+        for (const info of this.activeJobs.values()) {
+            if (info.projectId === projectId)
+                projectCount++;
+        }
+        return projectCount < this.maxConcurrentJobsPerProject;
+    }
+    /**
+     * Dispatch a background job for execution in the worker pool.
+     */
+    async runJob(jobId, worker, workerFn) {
+        const initialJob = this.jobManager.getJob(jobId);
+        if (!initialJob) {
+            throw new Error(`Job "${jobId}" not found.`);
+        }
+        if (!this.canAcceptJob(initialJob.projectId)) {
+            throw new Error(`Concurrency limit reached for project "${initialJob.projectId}" or global worker pool.`);
+        }
+        // 1. Claim job and acquire generation-fenced lease
+        const { job, lease } = this.jobManager.claimJob(jobId, worker);
+        const abortController = new AbortController();
+        const activeInfo = {
+            abortController,
+            projectId: job.projectId,
+        };
+        this.activeJobs.set(jobId, activeInfo);
+        // 2. Start heartbeat timer
+        const intervalId = setInterval(() => {
+            const hbRes = this.jobManager.heartbeatJob(jobId, lease.id, lease.generation, worker);
+            if (!hbRes.success) {
+                if (hbRes.cancelled || hbRes.timedOut) {
+                    abortController.abort();
+                }
+                clearInterval(intervalId);
+            }
+        }, this.heartbeatIntervalMs);
+        activeInfo.timer = intervalId;
+        // 3. Execute worker function
+        try {
+            const result = await workerFn(job, abortController.signal);
+            clearInterval(intervalId);
+            this.activeJobs.delete(jobId);
+            return this.jobManager.completeJob(jobId, lease.id, lease.generation, result);
+        }
+        catch (err) {
+            clearInterval(intervalId);
+            this.activeJobs.delete(jobId);
+            if (abortController.signal.aborted) {
+                return this.jobManager.cancelJob(jobId, "Aborted during execution due to timeout or cancellation signal.");
+            }
+            this.jobManager.failJob(jobId, lease.id, lease.generation, err);
+            const updated = this.jobManager.getJob(jobId);
+            return updated;
+        }
+        finally {
+            clearInterval(intervalId);
+            this.activeJobs.delete(jobId);
+        }
+    }
+    /**
+     * Request abort for an active running job.
+     */
+    abortActiveJob(jobId, reason = "Supervisor abort") {
+        const active = this.activeJobs.get(jobId);
+        if (active) {
+            active.abortController.abort();
+            if (active.timer)
+                clearInterval(active.timer);
+            this.activeJobs.delete(jobId);
+        }
+        this.jobManager.cancelJob(jobId, reason);
+    }
+    getActiveCount() {
+        return this.activeJobs.size;
+    }
+}
+//# sourceMappingURL=background-job-supervisor.js.map

package/dist/jobs/background-job-supervisor.js.map

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

package/dist/jobs/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Anantham V2 — Background Tasks & Long-Running Jobs Subsystem
+ * PRD Part 2 Section 120–135 / P7.3
+ */
+export * from "./background-job-manager.js";
+export * from "./background-job-supervisor.js";
+export * from "./background-job-recovery.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/jobs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/jobs/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC"}

package/dist/jobs/index.js

@@ -0,0 +1,8 @@
+/**
+ * Anantham V2 — Background Tasks & Long-Running Jobs Subsystem
+ * PRD Part 2 Section 120–135 / P7.3
+ */
+export * from "./background-job-manager.js";
+export * from "./background-job-supervisor.js";
+export * from "./background-job-recovery.js";
+//# sourceMappingURL=index.js.map

package/dist/jobs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/jobs/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Anantham V2 — MCP Subsystem
+ *
+ * Export all MCP modules, client, registry, circuit breaker, normalizers, and sanitizers.
+ */
+export * from "./mcp-circuit-breaker.js";
+export * from "./mcp-output-sanitizer.js";
+export * from "./mcp-client.js";
+export * from "./mcp-tool-normalizer.js";
+export * from "./mcp-resource-normalizer.js";
+export * from "./mcp-prompt-manager.js";
+export * from "./mcp-registry.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC"}

package/dist/mcp/index.js

@@ -0,0 +1,13 @@
+/**
+ * Anantham V2 — MCP Subsystem
+ *
+ * Export all MCP modules, client, registry, circuit breaker, normalizers, and sanitizers.
+ */
+export * from "./mcp-circuit-breaker.js";
+export * from "./mcp-output-sanitizer.js";
+export * from "./mcp-client.js";
+export * from "./mcp-tool-normalizer.js";
+export * from "./mcp-resource-normalizer.js";
+export * from "./mcp-prompt-manager.js";
+export * from "./mcp-registry.js";
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC"}

package/dist/mcp/mcp-circuit-breaker.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Anantham V2 — MCP Circuit Breaker
+ *
+ * Implements deterministic 3-state circuit breaker (CLOSED -> OPEN -> HALF_OPEN)
+ * to protect the runtime from failing MCP servers and prevent cascading connection storms.
+ */
+export interface MCPCircuitBreakerOptions {
+    failureThreshold?: number;
+    cooldownMs?: number;
+    halfOpenMaxProbes?: number;
+    onStateChange?: (newState: "closed" | "open" | "half_open", previousState: "closed" | "open" | "half_open") => void;
+}
+export declare class MCPCircuitBreaker {
+    private state;
+    private consecutiveFailures;
+    private lastFailureTime;
+    private readonly failureThreshold;
+    private readonly cooldownMs;
+    private readonly halfOpenMaxProbes;
+    private activeProbes;
+    private readonly onStateChange?;
+    constructor(options?: MCPCircuitBreakerOptions);
+    getState(): "closed" | "open" | "half_open";
+    isOpen(): boolean;
+    getConsecutiveFailures(): number;
+    getCooldownRemainingMs(): number;
+    canExecute(): boolean;
+    recordSuccess(): void;
+    recordFailure(): void;
+    reset(): void;
+    private transitionTo;
+}
+//# sourceMappingURL=mcp-circuit-breaker.d.ts.map

package/dist/mcp/mcp-circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-circuit-breaker.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-circuit-breaker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,wBAAwB;IACvC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,EAAE,aAAa,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,KAAK,IAAI,CAAC;CACrH;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAsG;gBAEzH,OAAO,GAAE,wBAA6B;IAO3C,QAAQ,IAAI,QAAQ,GAAG,MAAM,GAAG,WAAW;IAU3C,MAAM,IAAI,OAAO;IAIjB,sBAAsB,IAAI,MAAM;IAIhC,sBAAsB,IAAI,MAAM;IAMhC,UAAU,IAAI,OAAO;IAerB,aAAa,IAAI,IAAI;IAQrB,aAAa,IAAI,IAAI;IAYrB,KAAK,IAAI,IAAI;IAOpB,OAAO,CAAC,YAAY;CAOrB"}

package/dist/mcp/mcp-circuit-breaker.js

@@ -0,0 +1,89 @@
+/**
+ * Anantham V2 — MCP Circuit Breaker
+ *
+ * Implements deterministic 3-state circuit breaker (CLOSED -> OPEN -> HALF_OPEN)
+ * to protect the runtime from failing MCP servers and prevent cascading connection storms.
+ */
+export class MCPCircuitBreaker {
+    state = "closed";
+    consecutiveFailures = 0;
+    lastFailureTime = 0;
+    failureThreshold;
+    cooldownMs;
+    halfOpenMaxProbes;
+    activeProbes = 0;
+    onStateChange;
+    constructor(options = {}) {
+        this.failureThreshold = options.failureThreshold || 3;
+        this.cooldownMs = options.cooldownMs || 10000;
+        this.halfOpenMaxProbes = options.halfOpenMaxProbes || 1;
+        this.onStateChange = options.onStateChange;
+    }
+    getState() {
+        if (this.state === "open") {
+            const elapsed = Date.now() - this.lastFailureTime;
+            if (elapsed >= this.cooldownMs) {
+                this.transitionTo("half_open");
+            }
+        }
+        return this.state;
+    }
+    isOpen() {
+        return this.getState() === "open";
+    }
+    getConsecutiveFailures() {
+        return this.consecutiveFailures;
+    }
+    getCooldownRemainingMs() {
+        if (this.state !== "open")
+            return 0;
+        const elapsed = Date.now() - this.lastFailureTime;
+        return Math.max(0, this.cooldownMs - elapsed);
+    }
+    canExecute() {
+        const currentState = this.getState();
+        if (currentState === "closed") {
+            return true;
+        }
+        if (currentState === "half_open") {
+            if (this.activeProbes < this.halfOpenMaxProbes) {
+                this.activeProbes++;
+                return true;
+            }
+            return false;
+        }
+        return false;
+    }
+    recordSuccess() {
+        this.consecutiveFailures = 0;
+        this.activeProbes = 0;
+        if (this.state !== "closed") {
+            this.transitionTo("closed");
+        }
+    }
+    recordFailure() {
+        this.consecutiveFailures++;
+        this.lastFailureTime = Date.now();
+        this.activeProbes = 0;
+        if (this.state === "closed" && this.consecutiveFailures >= this.failureThreshold) {
+            this.transitionTo("open");
+        }
+        else if (this.state === "half_open") {
+            this.transitionTo("open");
+        }
+    }
+    reset() {
+        this.consecutiveFailures = 0;
+        this.activeProbes = 0;
+        this.lastFailureTime = 0;
+        this.transitionTo("closed");
+    }
+    transitionTo(newState) {
+        if (this.state !== newState) {
+            const previous = this.state;
+            this.state = newState;
+            this.onStateChange?.(newState, previous);
+        }
+    }
+}
+//# sourceMappingURL=mcp-circuit-breaker.js.map

package/dist/mcp/mcp-circuit-breaker.js.map

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

package/dist/mcp/mcp-client.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Anantham V2 — MCP Client & Transports
+ *
+ * Provider-neutral client managing JSON-RPC 2.0 protocol handshakes,
+ * capability discovery, tool calling, resource reading, and prompt expansion.
+ */
+import { type MCPServerConfig, type MCPDiscoveryResult, type MCPConnectionState, type MCPHealthStatus } from "../domain/mcp.js";
+import { MCPCircuitBreaker } from "./mcp-circuit-breaker.js";
+import { MCPOutputSanitizer } from "./mcp-output-sanitizer.js";
+import { type EventStore } from "../event-state/event-store.js";
+export interface MCPTransportAdapter {
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    sendRequest<T = any>(method: string, params?: Record<string, unknown>, timeoutMs?: number): Promise<T>;
+    isConnected(): boolean;
+}
+export interface MCPClientOptions {
+    config: MCPServerConfig;
+    transportAdapter?: MCPTransportAdapter;
+    eventStore?: EventStore;
+    circuitBreaker?: MCPCircuitBreaker;
+    sanitizer?: MCPOutputSanitizer;
+}
+export declare class MCPClient {
+    readonly config: MCPServerConfig;
+    private connectionState;
+    private healthStatus;
+    private readonly transportAdapter?;
+    private readonly eventStore?;
+    readonly circuitBreaker: MCPCircuitBreaker;
+    readonly sanitizer: MCPOutputSanitizer;
+    private discoveryResult?;
+    private lastConnectedAt?;
+    constructor(options: MCPClientOptions);
+    getConnectionState(): MCPConnectionState;
+    getHealthStatus(): MCPHealthStatus;
+    getLastConnectedAt(): string | undefined;
+    getDiscoveryResult(): MCPDiscoveryResult | undefined;
+    /**
+     * Connect and perform initialization handshake.
+     */
+    connect(): Promise<void>;
+    /**
+     * Run capability discovery across tools, resources, and prompts.
+     */
+    discover(): Promise<MCPDiscoveryResult>;
+    /**
+     * Invoke a discovered MCP tool.
+     */
+    callTool(toolName: string, args: Record<string, unknown>): Promise<any>;
+    /**
+     * Read an MCP resource by URI.
+     */
+    readResource(uri: string): Promise<any>;
+    /**
+     * Retrieve an MCP prompt template.
+     */
+    getPrompt(promptName: string, args?: Record<string, string>): Promise<any>;
+    /**
+     * Gracefully disconnect from server.
+     */
+    disconnect(): Promise<void>;
+    private emitEvent;
+}
+//# sourceMappingURL=mcp-client.d.ts.map

package/dist/mcp/mcp-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,kBAAkB,EAIvB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EAGrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAIhE,MAAM,WAAW,mBAAmB;IAClC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACvG,WAAW,IAAI,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,eAAe,CAAC;IACxB,gBAAgB,CAAC,EAAE,mBAAmB,CAAC;IACvC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,cAAc,CAAC,EAAE,iBAAiB,CAAC;IACnC,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC;AAED,qBAAa,SAAS;IACpB,SAAgB,MAAM,EAAE,eAAe,CAAC;IACxC,OAAO,CAAC,eAAe,CAAsC;IAC7D,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAsB;IACxD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAa;IACzC,SAAgB,cAAc,EAAE,iBAAiB,CAAC;IAClD,SAAgB,SAAS,EAAE,kBAAkB,CAAC;IAC9C,OAAO,CAAC,eAAe,CAAC,CAAqB;IAC7C,OAAO,CAAC,eAAe,CAAC,CAAS;gBAErB,OAAO,EAAE,gBAAgB;IA2B9B,kBAAkB,IAAI,kBAAkB;IAIxC,eAAe,IAAI,eAAe;IAIlC,kBAAkB,IAAI,MAAM,GAAG,SAAS;IAIxC,kBAAkB,IAAI,kBAAkB,GAAG,SAAS;IAI3D;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA2DrC;;OAEG;IACU,QAAQ,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAqGpD;;OAEG;IACU,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAwCpF;;OAEG;IACU,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAqCpD;;OAEG;IACU,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAwC3F;;OAEG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBxC,OAAO,CAAC,SAAS;CAalB"}