anantham-v2 2.0.0-alpha.1

package/dist/sdk/anantham-client.js

@@ -0,0 +1,136 @@
+import { AnanthamApiError } from "./sdk-errors.js";
+/**
+ * Typed Programmatic TypeScript Client SDK for Anantham V2.
+ * PRD Part 2 Section 215.
+ */
+export class AnanthamClient {
+    baseUrl;
+    apiKey;
+    bearerToken;
+    timeoutMs;
+    constructor(options) {
+        this.baseUrl = options.baseUrl.replace(/\/+$/, "");
+        this.apiKey = options.apiKey;
+        this.bearerToken = options.bearerToken ?? (options.apiKey ? undefined : "anantham-dev-key");
+        this.timeoutMs = options.timeoutMs ?? 10_000;
+    }
+    async request(method, path, body, headers) {
+        const url = `${this.baseUrl}${path.startsWith("/") ? path : `/${path}`}`;
+        const reqHeaders = {
+            "Content-Type": "application/json",
+            ...headers,
+        };
+        if (this.bearerToken) {
+            reqHeaders["Authorization"] = `Bearer ${this.bearerToken}`;
+        }
+        else if (this.apiKey) {
+            reqHeaders["X-API-Key"] = this.apiKey;
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const response = await fetch(url, {
+                method,
+                headers: reqHeaders,
+                body: body !== undefined ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+            const json = (await response.json());
+            if (!response.ok || json.success === false) {
+                throw new AnanthamApiError({
+                    message: json.error?.message ?? `API Error (HTTP ${response.status})`,
+                    statusCode: response.status,
+                    classification: json.error?.classification,
+                    code: json.error?.code,
+                    details: json.error?.details,
+                });
+            }
+            return json.data;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    // --- Health & Diagnostics ---
+    async health() {
+        const res = await this.request("GET", "/v1/health");
+        return res;
+    }
+    async doctor() {
+        return this.request("GET", "/v1/doctor");
+    }
+    // --- Projects Resource ---
+    projects = {
+        list: async () => {
+            return this.request("GET", "/v1/projects");
+        },
+        create: async (params, idempotencyKey) => {
+            const headers = idempotencyKey ? { "Idempotency-Key": idempotencyKey } : undefined;
+            return this.request("POST", "/v1/projects", params, headers);
+        },
+    };
+    // --- Sessions Resource ---
+    sessions = {
+        list: async (projectId) => {
+            return this.request("GET", `/v1/sessions?projectId=${encodeURIComponent(projectId)}`);
+        },
+        create: async (params, idempotencyKey) => {
+            const headers = idempotencyKey ? { "Idempotency-Key": idempotencyKey } : undefined;
+            return this.request("POST", "/v1/sessions", params, headers);
+        },
+    };
+    // --- Tasks Resource ---
+    tasks = {
+        list: async (sessionId) => {
+            return this.request("GET", `/v1/tasks?sessionId=${encodeURIComponent(sessionId)}`);
+        },
+        create: async (params, idempotencyKey) => {
+            const headers = idempotencyKey ? { "Idempotency-Key": idempotencyKey } : undefined;
+            return this.request("POST", "/v1/tasks", params, headers);
+        },
+        claim: async (taskId, params, idempotencyKey) => {
+            const headers = idempotencyKey ? { "Idempotency-Key": idempotencyKey } : undefined;
+            return this.request("POST", `/v1/tasks/${encodeURIComponent(taskId)}/claim`, params, headers);
+        },
+    };
+    // --- Background Jobs Resource ---
+    jobs = {
+        list: async (projectId) => {
+            return this.request("GET", `/v1/jobs?projectId=${encodeURIComponent(projectId)}`);
+        },
+        create: async (params, idempotencyKey) => {
+            const headers = idempotencyKey ? { "Idempotency-Key": idempotencyKey } : undefined;
+            return this.request("POST", "/v1/jobs", params, headers);
+        },
+    };
+    // --- Remote Nodes Resource ---
+    nodes = {
+        list: async () => {
+            return this.request("GET", "/v1/nodes");
+        },
+    };
+    // --- Artifacts Resource ---
+    artifacts = {
+        list: async (sessionId) => {
+            return this.request("GET", `/v1/artifacts?sessionId=${encodeURIComponent(sessionId)}`);
+        },
+    };
+    // --- Events Resource ---
+    events = {
+        list: async (query = {}) => {
+            const q = new URLSearchParams();
+            if (query.sessionId)
+                q.set("sessionId", query.sessionId);
+            if (query.projectId)
+                q.set("projectId", query.projectId);
+            if (query.type)
+                q.set("type", query.type);
+            if (query.limit)
+                q.set("limit", String(query.limit));
+            if (query.offset)
+                q.set("offset", String(query.offset));
+            return this.request("GET", `/v1/events?${q.toString()}`);
+        },
+    };
+}
+//# sourceMappingURL=anantham-client.js.map

package/dist/sdk/anantham-client.js.map

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

package/dist/sdk/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Anantham V2 — SDK Subsystem
+ * PRD Part 2 Section 215.
+ */
+export * from "./sdk-errors.js";
+export * from "./anantham-client.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC"}

package/dist/sdk/index.js

@@ -0,0 +1,7 @@
+/**
+ * Anantham V2 — SDK Subsystem
+ * PRD Part 2 Section 215.
+ */
+export * from "./sdk-errors.js";
+export * from "./anantham-client.js";
+//# sourceMappingURL=index.js.map

package/dist/sdk/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC"}

package/dist/sdk/sdk-errors.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Typed API Error representation for Anantham SDK clients.
+ * PRD Part 2 Section 215.
+ */
+export declare class AnanthamApiError extends Error {
+    readonly statusCode: number;
+    readonly classification: string;
+    readonly code: string;
+    readonly details?: Record<string, unknown>;
+    constructor(options: {
+        message: string;
+        statusCode: number;
+        classification?: string;
+        code?: string;
+        details?: Record<string, unknown>;
+    });
+}
+//# sourceMappingURL=sdk-errors.d.ts.map

package/dist/sdk/sdk-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-errors.d.ts","sourceRoot":"","sources":["../../src/sdk/sdk-errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,cAAc,EAAE,MAAM,CAAC;IACvC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEtC,OAAO,EAAE;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC;CAQF"}

package/dist/sdk/sdk-errors.js

@@ -0,0 +1,19 @@
+/**
+ * Typed API Error representation for Anantham SDK clients.
+ * PRD Part 2 Section 215.
+ */
+export class AnanthamApiError extends Error {
+    statusCode;
+    classification;
+    code;
+    details;
+    constructor(options) {
+        super(options.message);
+        this.name = "AnanthamApiError";
+        this.statusCode = options.statusCode;
+        this.classification = options.classification ?? "INTERNAL_ERROR";
+        this.code = options.code ?? "error";
+        this.details = options.details;
+    }
+}
+//# sourceMappingURL=sdk-errors.js.map

package/dist/sdk/sdk-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-errors.js","sourceRoot":"","sources":["../../src/sdk/sdk-errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzB,UAAU,CAAS;IACnB,cAAc,CAAS;IACvB,IAAI,CAAS;IACb,OAAO,CAA2B;IAElD,YAAY,OAMX;QACC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,gBAAgB,CAAC;QACjE,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACjC,CAAC;CACF"}

package/dist/side-effects/file-divergence-detector.d.ts

@@ -0,0 +1,11 @@
+import { type FileDivergenceRecord } from "../domain/side-effect.js";
+/**
+ * Anantham V2 — File Divergence Detector
+ * Playbook Section 59 & Section 138 (User Change Protection)
+ */
+export declare class FileDivergenceDetector {
+    computeFileHash(filePath: string): string | null;
+    detectDivergence(filePath: string, baseHash: string | null): FileDivergenceRecord;
+    assertNoDivergence(filePath: string, baseHash: string | null): void;
+}
+//# sourceMappingURL=file-divergence-detector.d.ts.map

package/dist/side-effects/file-divergence-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-divergence-detector.d.ts","sourceRoot":"","sources":["../../src/side-effects/file-divergence-detector.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,oBAAoB,EAC1B,MAAM,0BAA0B,CAAC;AAElC;;;GAGG;AACH,qBAAa,sBAAsB;IAC1B,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAYhD,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,oBAAoB;IA+DjF,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;CAQ3E"}

package/dist/side-effects/file-divergence-detector.js

@@ -0,0 +1,85 @@
+import fs from "node:fs";
+import crypto from "node:crypto";
+/**
+ * Anantham V2 — File Divergence Detector
+ * Playbook Section 59 & Section 138 (User Change Protection)
+ */
+export class FileDivergenceDetector {
+    computeFileHash(filePath) {
+        try {
+            if (!fs.existsSync(filePath)) {
+                return null;
+            }
+            const content = fs.readFileSync(filePath);
+            return crypto.createHash("sha256").update(content).digest("hex");
+        }
+        catch {
+            return null;
+        }
+    }
+    detectDivergence(filePath, baseHash) {
+        const currentHash = this.computeFileHash(filePath);
+        const now = new Date().toISOString();
+        if (baseHash === null && currentHash === null) {
+            return {
+                filePath,
+                baseHash: "none",
+                currentHash: "none",
+                status: "synced",
+                detectedAt: now,
+            };
+        }
+        if (baseHash === null && currentHash !== null) {
+            return {
+                filePath,
+                baseHash: "none",
+                currentHash,
+                status: "file_created",
+                detectedAt: now,
+            };
+        }
+        if (baseHash !== null && currentHash === null) {
+            return {
+                filePath,
+                baseHash,
+                currentHash: "none",
+                status: "file_missing",
+                detectedAt: now,
+            };
+        }
+        if (baseHash !== null && currentHash !== null) {
+            if (baseHash === currentHash) {
+                return {
+                    filePath,
+                    baseHash,
+                    currentHash,
+                    status: "synced",
+                    detectedAt: now,
+                };
+            }
+            else {
+                return {
+                    filePath,
+                    baseHash,
+                    currentHash,
+                    status: "diverged",
+                    detectedAt: now,
+                };
+            }
+        }
+        return {
+            filePath,
+            baseHash: baseHash || "none",
+            currentHash: currentHash || "none",
+            status: "diverged",
+            detectedAt: now,
+        };
+    }
+    assertNoDivergence(filePath, baseHash) {
+        const record = this.detectDivergence(filePath, baseHash);
+        if (record.status === "diverged") {
+            throw new Error(`FILE_DIVERGENCE_DETECTED: Target file "${filePath}" was modified externally since base hash "${baseHash}". Write aborted to prevent destroying user changes.`);
+        }
+    }
+}
+//# sourceMappingURL=file-divergence-detector.js.map

package/dist/side-effects/file-divergence-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-divergence-detector.js","sourceRoot":"","sources":["../../src/side-effects/file-divergence-detector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,MAAM,MAAM,aAAa,CAAC;AAKjC;;;GAGG;AACH,MAAM,OAAO,sBAAsB;IAC1B,eAAe,CAAC,QAAgB;QACrC,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC7B,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YAC1C,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAEM,gBAAgB,CAAC,QAAgB,EAAE,QAAuB;QAC/D,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;QACnD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAErC,IAAI,QAAQ,KAAK,IAAI,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YAC9C,OAAO;gBACL,QAAQ;gBACR,QAAQ,EAAE,MAAM;gBAChB,WAAW,EAAE,MAAM;gBACnB,MAAM,EAAE,QAAQ;gBAChB,UAAU,EAAE,GAAG;aAChB,CAAC;QACJ,CAAC;QAED,IAAI,QAAQ,KAAK,IAAI,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YAC9C,OAAO;gBACL,QAAQ;gBACR,QAAQ,EAAE,MAAM;gBAChB,WAAW;gBACX,MAAM,EAAE,cAAc;gBACtB,UAAU,EAAE,GAAG;aAChB,CAAC;QACJ,CAAC;QAED,IAAI,QAAQ,KAAK,IAAI,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YAC9C,OAAO;gBACL,QAAQ;gBACR,QAAQ;gBACR,WAAW,EAAE,MAAM;gBACnB,MAAM,EAAE,cAAc;gBACtB,UAAU,EAAE,GAAG;aAChB,CAAC;QACJ,CAAC;QAED,IAAI,QAAQ,KAAK,IAAI,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YAC9C,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;gBAC7B,OAAO;oBACL,QAAQ;oBACR,QAAQ;oBACR,WAAW;oBACX,MAAM,EAAE,QAAQ;oBAChB,UAAU,EAAE,GAAG;iBAChB,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,OAAO;oBACL,QAAQ;oBACR,QAAQ;oBACR,WAAW;oBACX,MAAM,EAAE,UAAU;oBAClB,UAAU,EAAE,GAAG;iBAChB,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO;YACL,QAAQ;YACR,QAAQ,EAAE,QAAQ,IAAI,MAAM;YAC5B,WAAW,EAAE,WAAW,IAAI,MAAM;YAClC,MAAM,EAAE,UAAU;YAClB,UAAU,EAAE,GAAG;SAChB,CAAC;IACJ,CAAC;IAEM,kBAAkB,CAAC,QAAgB,EAAE,QAAuB;QACjE,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACzD,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CACb,0CAA0C,QAAQ,8CAA8C,QAAQ,sDAAsD,CAC/J,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/side-effects/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Anantham V2 — Side Effects & Retry Plane
+ * PRD Part 1 Section 83-90 & PRD Part 2 Section 241-248 / P4.5
+ */
+export * from "./side-effect-classifier.js";
+export * from "./retry-budget-manager.js";
+export * from "./retry-decision-engine.js";
+export * from "./file-divergence-detector.js";
+export * from "./worktree-divergence-detector.js";
+export * from "./side-effect-journal.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/side-effects/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/side-effects/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mCAAmC,CAAC;AAClD,cAAc,0BAA0B,CAAC"}

package/dist/side-effects/index.js

@@ -0,0 +1,11 @@
+/**
+ * Anantham V2 — Side Effects & Retry Plane
+ * PRD Part 1 Section 83-90 & PRD Part 2 Section 241-248 / P4.5
+ */
+export * from "./side-effect-classifier.js";
+export * from "./retry-budget-manager.js";
+export * from "./retry-decision-engine.js";
+export * from "./file-divergence-detector.js";
+export * from "./worktree-divergence-detector.js";
+export * from "./side-effect-journal.js";
+//# sourceMappingURL=index.js.map

package/dist/side-effects/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/side-effects/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mCAAmC,CAAC;AAClD,cAAc,0BAA0B,CAAC"}

package/dist/side-effects/retry-budget-manager.d.ts

@@ -0,0 +1,19 @@
+import { type RetryBudgetConfig, type RetryBudgetUsage } from "../domain/side-effect.js";
+/**
+ * Anantham V2 — Hierarchical Retry Budget Manager
+ * PRD Part 1 Section 85 & PRD Part 2 Section 242-243
+ */
+export declare class RetryBudgetManager {
+    private readonly config;
+    private globalRetryCount;
+    private readonly taskRetryCounts;
+    private readonly operationRetryCounts;
+    constructor(config?: Partial<RetryBudgetConfig>);
+    getUsage(taskId?: string, operationKey?: string): RetryBudgetUsage;
+    canRetry(taskId?: string, operationKey?: string): boolean;
+    recordAttempt(taskId?: string, operationKey?: string): void;
+    getRemainingOperationRetries(operationKey?: string): number;
+    calculateBackoffDelay(attemptNumber: number): number;
+    resetOperation(operationKey: string): void;
+}
+//# sourceMappingURL=retry-budget-manager.d.ts.map

package/dist/side-effects/retry-budget-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-budget-manager.d.ts","sourceRoot":"","sources":["../../src/side-effects/retry-budget-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EAEtB,MAAM,0BAA0B,CAAC;AAElC;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA6B;IAC7D,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA6B;gBAEtD,MAAM,GAAE,OAAO,CAAC,iBAAiB,CAAM;IAI5C,QAAQ,CAAC,MAAM,SAAW,EAAE,YAAY,SAAY,GAAG,gBAAgB;IAQvE,QAAQ,CAAC,MAAM,SAAW,EAAE,YAAY,SAAY,GAAG,OAAO;IAe9D,aAAa,CAAC,MAAM,SAAW,EAAE,YAAY,SAAY,GAAG,IAAI;IAMhE,4BAA4B,CAAC,YAAY,SAAY,GAAG,MAAM;IAK9D,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IAKpD,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;CAGlD"}

package/dist/side-effects/retry-budget-manager.js

@@ -0,0 +1,51 @@
+import { RetryBudgetConfigSchema, } from "../domain/side-effect.js";
+/**
+ * Anantham V2 — Hierarchical Retry Budget Manager
+ * PRD Part 1 Section 85 & PRD Part 2 Section 242-243
+ */
+export class RetryBudgetManager {
+    config;
+    globalRetryCount = 0;
+    taskRetryCounts = new Map();
+    operationRetryCounts = new Map();
+    constructor(config = {}) {
+        this.config = RetryBudgetConfigSchema.parse(config);
+    }
+    getUsage(taskId = "global", operationKey = "default") {
+        return {
+            globalRetries: this.globalRetryCount,
+            taskRetries: this.taskRetryCounts.get(taskId) || 0,
+            operationRetries: this.operationRetryCounts.get(operationKey) || 0,
+        };
+    }
+    canRetry(taskId = "global", operationKey = "default") {
+        const usage = this.getUsage(taskId, operationKey);
+        if (usage.globalRetries >= this.config.maxGlobalRetries) {
+            return false;
+        }
+        if (usage.taskRetries >= this.config.maxTaskRetries) {
+            return false;
+        }
+        if (usage.operationRetries >= this.config.maxOperationRetries) {
+            return false;
+        }
+        return true;
+    }
+    recordAttempt(taskId = "global", operationKey = "default") {
+        this.globalRetryCount += 1;
+        this.taskRetryCounts.set(taskId, (this.taskRetryCounts.get(taskId) || 0) + 1);
+        this.operationRetryCounts.set(operationKey, (this.operationRetryCounts.get(operationKey) || 0) + 1);
+    }
+    getRemainingOperationRetries(operationKey = "default") {
+        const current = this.operationRetryCounts.get(operationKey) || 0;
+        return Math.max(0, this.config.maxOperationRetries - current);
+    }
+    calculateBackoffDelay(attemptNumber) {
+        const exponential = this.config.backoffBaseMs * Math.pow(2, attemptNumber);
+        return Math.min(exponential, this.config.backoffMaxMs);
+    }
+    resetOperation(operationKey) {
+        this.operationRetryCounts.delete(operationKey);
+    }
+}
+//# sourceMappingURL=retry-budget-manager.js.map

package/dist/side-effects/retry-budget-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-budget-manager.js","sourceRoot":"","sources":["../../src/side-effects/retry-budget-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAElC;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IACZ,MAAM,CAAoB;IACnC,gBAAgB,GAAG,CAAC,CAAC;IACZ,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,oBAAoB,GAAG,IAAI,GAAG,EAAkB,CAAC;IAElE,YAAY,SAAqC,EAAE;QACjD,IAAI,CAAC,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACtD,CAAC;IAEM,QAAQ,CAAC,MAAM,GAAG,QAAQ,EAAE,YAAY,GAAG,SAAS;QACzD,OAAO;YACL,aAAa,EAAE,IAAI,CAAC,gBAAgB;YACpC,WAAW,EAAE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;YAClD,gBAAgB,EAAE,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC;SACnE,CAAC;IACJ,CAAC;IAEM,QAAQ,CAAC,MAAM,GAAG,QAAQ,EAAE,YAAY,GAAG,SAAS;QACzD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAElD,IAAI,KAAK,CAAC,aAAa,IAAI,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;YACxD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,KAAK,CAAC,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YACpD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,KAAK,CAAC,gBAAgB,IAAI,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;YAC9D,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,aAAa,CAAC,MAAM,GAAG,QAAQ,EAAE,YAAY,GAAG,SAAS;QAC9D,IAAI,CAAC,gBAAgB,IAAI,CAAC,CAAC;QAC3B,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9E,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACtG,CAAC;IAEM,4BAA4B,CAAC,YAAY,GAAG,SAAS;QAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACjE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,mBAAmB,GAAG,OAAO,CAAC,CAAC;IAChE,CAAC;IAEM,qBAAqB,CAAC,aAAqB;QAChD,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;QAC3E,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACzD,CAAC;IAEM,cAAc,CAAC,YAAoB;QACxC,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/side-effects/retry-decision-engine.d.ts

@@ -0,0 +1,23 @@
+import { type SideEffectCategory, type OutcomeCertainty, type RetryDecision, type ToolExecutionError } from "../domain/index.js";
+import { SideEffectClassifier } from "./side-effect-classifier.js";
+import { RetryBudgetManager } from "./retry-budget-manager.js";
+export interface RetryEvaluationContext {
+    toolName: string;
+    category?: SideEffectCategory;
+    error: ToolExecutionError;
+    outcomeCertainty: OutcomeCertainty;
+    taskId?: string;
+    operationKey: string;
+    attemptNumber: number;
+    approvalExpired?: boolean;
+}
+export declare class RetryDecisionEngine {
+    private readonly classifier;
+    private readonly budgetManager;
+    constructor(options?: {
+        classifier?: SideEffectClassifier;
+        budgetManager?: RetryBudgetManager;
+    });
+    evaluate(context: RetryEvaluationContext): RetryDecision;
+}
+//# sourceMappingURL=retry-decision-engine.d.ts.map

package/dist/side-effects/retry-decision-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-decision-engine.d.ts","sourceRoot":"","sources":["../../src/side-effects/retry-decision-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,KAAK,EAAE,kBAAkB,CAAC;IAC1B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuB;IAClD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;gBAEvC,OAAO,GAAE;QACnB,UAAU,CAAC,EAAE,oBAAoB,CAAC;QAClC,aAAa,CAAC,EAAE,kBAAkB,CAAC;KAC/B;IAKC,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,aAAa;CAgFhE"}

package/dist/side-effects/retry-decision-engine.js

@@ -0,0 +1,84 @@
+import { SideEffectClassifier } from "./side-effect-classifier.js";
+import { RetryBudgetManager } from "./retry-budget-manager.js";
+export class RetryDecisionEngine {
+    classifier;
+    budgetManager;
+    constructor(options = {}) {
+        this.classifier = options.classifier || new SideEffectClassifier();
+        this.budgetManager = options.budgetManager || new RetryBudgetManager();
+    }
+    evaluate(context) {
+        const category = context.category || this.classifier.classify(context.toolName);
+        const maxAttempts = 3;
+        const budgetRemaining = this.budgetManager.getRemainingOperationRetries(context.operationKey);
+        // 1. Approval Validity Check
+        if (context.approvalExpired) {
+            return {
+                decisionCode: "reject_policy_expired",
+                allowRetry: false,
+                reason: "Approval expired between retry attempts. Re-authorization required.",
+                attemptNumber: context.attemptNumber,
+                maxAttempts,
+                budgetRemaining,
+            };
+        }
+        // 2. Non-Retryable Error Check
+        if (!context.error.retryable) {
+            return {
+                decisionCode: "reject_non_retryable_error",
+                allowRetry: false,
+                reason: `Operation failed with non-retryable error: ${context.error.message}`,
+                attemptNumber: context.attemptNumber,
+                maxAttempts,
+                budgetRemaining,
+            };
+        }
+        // 3. Unknown Outcome Handling (CRITICAL: UNKNOWN != RETRYABLE)
+        if (context.outcomeCertainty === "unknown") {
+            return {
+                decisionCode: "reject_unknown_outcome",
+                allowRetry: false,
+                reason: "Execution outcome is unknown (timeout or connection lost). Automatic duplicate retry is strictly prohibited.",
+                attemptNumber: context.attemptNumber,
+                maxAttempts,
+                budgetRemaining,
+                reconciliationAction: "Verify external state or resource existence before retrying.",
+            };
+        }
+        // 4. Non-Idempotent / Unsafe Side-Effect Check
+        if (!this.classifier.isSafeToRetry(category)) {
+            return {
+                decisionCode: "reject_non_idempotent",
+                allowRetry: false,
+                reason: `Side effect category "${category}" is non-idempotent or unknown. Blindly repeating side effects is prohibited.`,
+                attemptNumber: context.attemptNumber,
+                maxAttempts,
+                budgetRemaining,
+            };
+        }
+        // 5. Retry Budget Exhaustion Check
+        if (!this.budgetManager.canRetry(context.taskId, context.operationKey)) {
+            return {
+                decisionCode: "reject_budget_exhausted",
+                allowRetry: false,
+                reason: "Retry budget exhausted at global, task, or operation level.",
+                attemptNumber: context.attemptNumber,
+                maxAttempts,
+                budgetRemaining: 0,
+            };
+        }
+        // 6. Safe to Retry
+        const delay = this.budgetManager.calculateBackoffDelay(context.attemptNumber);
+        this.budgetManager.recordAttempt(context.taskId, context.operationKey);
+        return {
+            decisionCode: "allow_retry",
+            allowRetry: true,
+            reason: `Safe idempotent retry permitted for ${context.toolName} (Attempt ${context.attemptNumber + 1}).`,
+            attemptNumber: context.attemptNumber + 1,
+            maxAttempts,
+            budgetRemaining: this.budgetManager.getRemainingOperationRetries(context.operationKey),
+            recommendedDelayMs: delay,
+        };
+    }
+}
+//# sourceMappingURL=retry-decision-engine.js.map

package/dist/side-effects/retry-decision-engine.js.map

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

package/dist/side-effects/side-effect-classifier.d.ts

@@ -0,0 +1,15 @@
+import { type SideEffectCategory } from "../domain/side-effect.js";
+import { type ToolSpec } from "../domain/tool.js";
+/**
+ * Anantham V2 — Side Effect Classifier
+ * PRD Part 1 Section 83-90 & PRD Part 2 Section 241-248
+ */
+export declare class SideEffectClassifier {
+    private static readonly KNOWN_READ_ONLY_TOOLS;
+    private static readonly KNOWN_IDEMPOTENT_WRITE_TOOLS;
+    private static readonly KNOWN_REVERSIBLE_WRITE_TOOLS;
+    private static readonly KNOWN_NON_IDEMPOTENT_TOOLS;
+    classify(toolName: string, args?: Record<string, unknown>, toolSpec?: ToolSpec): SideEffectCategory;
+    isSafeToRetry(category: SideEffectCategory): boolean;
+}
+//# sourceMappingURL=side-effect-classifier.d.ts.map

package/dist/side-effects/side-effect-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"side-effect-classifier.d.ts","sourceRoot":"","sources":["../../src/side-effects/side-effect-classifier.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,kBAAkB,EAExB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAY1C;IAEH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,4BAA4B,CAIjD;IAEH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,4BAA4B,CAEjD;IAEH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,0BAA0B,CAK/C;IAEI,QAAQ,CACb,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAClC,QAAQ,CAAC,EAAE,QAAQ,GAClB,kBAAkB;IAuCd,aAAa,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO;CAI5D"}