anantham-v2 2.0.0-alpha.1

package/dist/resume/resume-contract.js

@@ -0,0 +1,113 @@
+import { z } from "zod";
+/**
+ * Resume target specification.
+ * PRD Part 1 Section 55 & PRD Part 3 Section 15.
+ */
+export const ResumeTargetSchema = z.discriminatedUnion("type", [
+    z.object({
+        type: z.literal("last"),
+        projectId: z.string().optional(),
+    }),
+    z.object({
+        type: z.literal("session"),
+        sessionId: z.string().min(1),
+    }),
+    z.object({
+        type: z.literal("project"),
+        projectName: z.string().min(1),
+    }),
+    z.object({
+        type: z.literal("checkpoint"),
+        checkpointId: z.string().min(1),
+    }),
+]);
+/**
+ * Optional resume configuration overrides.
+ */
+export const ResumeOptionsSchema = z.object({
+    overrideModelProfile: z.string().optional(),
+    overrideTrustProfile: z.string().optional(),
+    dryRun: z.boolean().optional(),
+    forceRebuildProjections: z.boolean().optional(),
+});
+/**
+ * Resume request.
+ */
+export const ResumeRequestSchema = z.object({
+    target: ResumeTargetSchema,
+    options: ResumeOptionsSchema.optional(),
+});
+/**
+ * Restored Task DAG and execution topology.
+ */
+export const RestoredTaskDAGSchema = z.object({
+    totalTasksCount: z.number().int().nonnegative(),
+    tasks: z.array(z.any()),
+    activeTaskId: z.string().nullable(),
+    queuedTasks: z.array(z.any()),
+    runningTasks: z.array(z.any()),
+    blockedTasks: z.array(z.any()),
+    completedTasks: z.array(z.any()),
+    failedTasks: z.array(z.any()),
+    cancelledTasks: z.array(z.any()),
+    executionOrder: z.array(z.string()),
+    unresolvedDependencies: z.record(z.array(z.string())),
+});
+/**
+ * Individual restored pending approval.
+ */
+export const PendingApprovalItemSchema = z.object({
+    approvalId: z.string().min(1),
+    taskId: z.string().min(1),
+    action: z.string().min(1),
+    riskLevel: z.enum(["low", "medium", "high", "critical"]),
+    requestedBy: z.string().min(1),
+    createdAt: z.string().min(1),
+    expiresAt: z.string().optional(),
+    payload: z.record(z.unknown()),
+});
+/**
+ * Restored pending approvals queue.
+ */
+export const RestoredPendingApprovalsSchema = z.object({
+    pendingApprovalsCount: z.number().int().nonnegative(),
+    approvals: z.array(PendingApprovalItemSchema),
+});
+/**
+ * Validation report produced during resume.
+ */
+export const ResumeValidationResultSchema = z.object({
+    isValid: z.boolean(),
+    projectValid: z.boolean(),
+    sessionValid: z.boolean(),
+    checkpointValid: z.boolean(),
+    gitStateValid: z.boolean(),
+    permissionsValid: z.boolean(),
+    errors: z.array(z.string()),
+    warnings: z.array(z.string()),
+});
+/**
+ * Complete, machine-verifiable Resume result.
+ * PRD Part 1 Section 56-57.
+ */
+export const ResumeResultSchema = z.object({
+    success: z.boolean(),
+    resumeId: z.string().min(1),
+    projectId: z.string().min(1),
+    sessionId: z.string().min(1),
+    project: z.any(),
+    session: z.any(),
+    checkpoint: z.any().optional(),
+    sessionState: z.any(),
+    taskDAG: RestoredTaskDAGSchema,
+    pendingApprovals: RestoredPendingApprovalsSchema,
+    artifactsSummary: z.object({
+        totalArtifactsCount: z.number().int().nonnegative(),
+        validArtifactsCount: z.number().int().nonnegative(),
+        missingArtifactIds: z.array(z.string()),
+    }),
+    eventOffset: z.number().int().nonnegative(),
+    resumedAt: z.string().min(1),
+    message: z.string(),
+});
+//# sourceMappingURL=resume-contract.js.map

package/dist/resume/resume-contract.js.map

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

package/dist/resume/session-resume-engine.d.ts

@@ -0,0 +1,42 @@
+import type { SqliteEngine } from "../persistence/sqlite-engine.js";
+import type { ProjectRepository } from "../persistence/repositories/project-repository.js";
+import type { SessionRepository } from "../persistence/repositories/session-repository.js";
+import type { TaskRepository } from "../persistence/repositories/task-repository.js";
+import type { CheckpointRepository } from "../persistence/repositories/checkpoint-repository.js";
+import type { ArtifactRepository } from "../persistence/repositories/artifact-repository.js";
+import type { EventRepository } from "../persistence/repositories/event-repository.js";
+import type { EventStore } from "../event-state/event-store.js";
+import type { ProjectionManager } from "../event-state/projections/projection-manager.js";
+import { LeaseManager } from "../recovery/lease-manager.js";
+import { type ResumeRequest, type ResumeResult } from "./resume-contract.js";
+export interface SessionResumeEngineOptions {
+    engine: SqliteEngine;
+    projectRepo: ProjectRepository;
+    sessionRepo: SessionRepository;
+    taskRepo: TaskRepository;
+    checkpointRepo: CheckpointRepository;
+    artifactRepo: ArtifactRepository;
+    eventRepo: EventRepository;
+    eventStore: EventStore;
+    projectionManager?: ProjectionManager;
+    leaseManager?: LeaseManager;
+}
+export declare class SessionResumeEngine {
+    private readonly engine;
+    private readonly projectRepo;
+    private readonly sessionRepo;
+    private readonly taskRepo;
+    private readonly checkpointRepo;
+    private readonly artifactRepo;
+    private readonly eventRepo;
+    private readonly eventStore;
+    private readonly projectionManager?;
+    private readonly leaseManager;
+    constructor(options: SessionResumeEngineOptions);
+    /**
+     * Executes the full deterministic session resume and runtime reconstruction algorithm.
+     * PRD Part 1 Section 55-58 & PRD Part 3 Section 15-16.
+     */
+    resume(request: ResumeRequest): Promise<ResumeResult>;
+}
+//# sourceMappingURL=session-resume-engine.d.ts.map

package/dist/resume/session-resume-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-resume-engine.d.ts","sourceRoot":"","sources":["../../src/resume/session-resume-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AAC3F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AAC3F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AACrF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sDAAsD,CAAC;AACjG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AAC7F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AACvF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAK5D,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,YAAY,EAGlB,MAAM,sBAAsB,CAAC;AAG9B,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,WAAW,EAAE,iBAAiB,CAAC;IAC/B,QAAQ,EAAE,cAAc,CAAC;IACzB,cAAc,EAAE,oBAAoB,CAAC;IACrC,YAAY,EAAE,kBAAkB,CAAC;IACjC,SAAS,EAAE,eAAe,CAAC;IAC3B,UAAU,EAAE,UAAU,CAAC;IACvB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAChD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuB;IACtD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAoB;IACvD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;gBAEhC,OAAO,EAAE,0BAA0B;IAa/C;;;OAGG;IACU,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;CA6LnE"}

package/dist/resume/session-resume-engine.js

@@ -0,0 +1,204 @@
+import { LeaseManager } from "../recovery/lease-manager.js";
+import { CheckpointValidator } from "../recovery/checkpoint-validator.js";
+import { reconstructSessionState } from "../event-state/reconstruction/session-reconstruct.js";
+import { TaskDagRestorer } from "./task-dag-restorer.js";
+import { PendingApprovalRestorer } from "./pending-approval-restorer.js";
+import { ResumeResultSchema, } from "./resume-contract.js";
+import { EventTypes } from "../domain/event.js";
+export class SessionResumeEngine {
+    engine;
+    projectRepo;
+    sessionRepo;
+    taskRepo;
+    checkpointRepo;
+    artifactRepo;
+    eventRepo;
+    eventStore;
+    projectionManager;
+    leaseManager;
+    constructor(options) {
+        this.engine = options.engine;
+        this.projectRepo = options.projectRepo;
+        this.sessionRepo = options.sessionRepo;
+        this.taskRepo = options.taskRepo;
+        this.checkpointRepo = options.checkpointRepo;
+        this.artifactRepo = options.artifactRepo;
+        this.eventRepo = options.eventRepo;
+        this.eventStore = options.eventStore;
+        this.projectionManager = options.projectionManager;
+        this.leaseManager = options.leaseManager ?? new LeaseManager({ taskRepo: this.taskRepo });
+    }
+    /**
+     * Executes the full deterministic session resume and runtime reconstruction algorithm.
+     * PRD Part 1 Section 55-58 & PRD Part 3 Section 15-16.
+     */
+    async resume(request) {
+        const resumeId = `res_${Date.now()}_${Math.random().toString(36).slice(2, 7)}`;
+        const errors = [];
+        const warnings = [];
+        // 1. Resolve Target Session and Project
+        let targetSessionId = null;
+        let targetCheckpointId = null;
+        const target = request.target;
+        switch (target.type) {
+            case "last": {
+                if (target.projectId) {
+                    const sessions = this.sessionRepo.listByProject(target.projectId);
+                    const first = sessions[0];
+                    if (!first) {
+                        throw new Error(`No sessions found for project ID '${target.projectId}'.`);
+                    }
+                    targetSessionId = first.id;
+                }
+                else {
+                    // Query latest active session across all projects
+                    const row = this.engine.raw
+                        .prepare("SELECT id FROM sessions ORDER BY updated_at DESC LIMIT 1;")
+                        .get();
+                    if (!row) {
+                        throw new Error("No existing sessions found in database to resume.");
+                    }
+                    targetSessionId = row.id;
+                }
+                break;
+            }
+            case "session":
+                targetSessionId = target.sessionId;
+                break;
+            case "project": {
+                const projects = this.projectRepo.list();
+                const matched = projects.find((p) => p.name.toLowerCase() === target.projectName.toLowerCase());
+                if (!matched) {
+                    throw new Error(`Project '${target.projectName}' not found.`);
+                }
+                const sessions = this.sessionRepo.listByProject(matched.id);
+                const first = sessions[0];
+                if (!first) {
+                    throw new Error(`No sessions found for project '${matched.name}'.`);
+                }
+                targetSessionId = first.id;
+                break;
+            }
+            case "checkpoint": {
+                targetCheckpointId = target.checkpointId;
+                const chk = this.checkpointRepo.findById(targetCheckpointId);
+                if (!chk) {
+                    throw new Error(`Checkpoint '${targetCheckpointId}' not found.`);
+                }
+                targetSessionId = chk.sessionId;
+                break;
+            }
+        }
+        if (!targetSessionId) {
+            throw new Error("Unable to resolve target session for resume.");
+        }
+        // 2. Load Session and Project
+        const session = this.sessionRepo.findById(targetSessionId);
+        if (!session) {
+            throw new Error(`Session '${targetSessionId}' not found.`);
+        }
+        const project = this.projectRepo.findById(session.projectId);
+        if (!project) {
+            throw new Error(`Project '${session.projectId}' referenced by session '${session.id}' not found.`);
+        }
+        // 3. Locate & Validate Checkpoint
+        let checkpoint = targetCheckpointId
+            ? this.checkpointRepo.findById(targetCheckpointId)
+            : this.checkpointRepo.findLatestBySession(session.id);
+        let checkpointValid = true;
+        if (checkpoint) {
+            const chkValidation = await CheckpointValidator.validateComplete(checkpoint, {
+                artifactRepo: this.artifactRepo,
+                eventRepo: this.eventRepo,
+            });
+            if (!chkValidation.isValid) {
+                checkpointValid = false;
+                warnings.push(`Checkpoint '${checkpoint.id}' failed integrity validation: ${chkValidation.errors.join("; ")}`);
+                // Fallback: If target was not explicitly checkpoint ID, proceed with pure event replay
+                if (target.type === "checkpoint") {
+                    throw new Error(`Target checkpoint '${checkpoint.id}' is corrupted: ${chkValidation.errors.join("; ")}`);
+                }
+            }
+        }
+        // 4. Query Authoritative Events
+        const events = this.eventStore.getEventsBySession(session.id);
+        const eventOffset = events.length;
+        // 5. Reconstruct Aggregate Session State
+        const sessionState = reconstructSessionState(session.id, events);
+        // 6. Synchronize / Rebuild Projections
+        if (this.projectionManager) {
+            this.projectionManager.rebuildAll();
+        }
+        // 7. Stale Lease Reclamation & Task Interruption Handling
+        this.leaseManager.reclaimStaleLeases();
+        // 8. Restore Task DAG & Execution Topology
+        const rawTasks = this.taskRepo.listBySession(session.id);
+        const taskDAG = TaskDagRestorer.restoreDAG(rawTasks, {
+            taskRepo: this.taskRepo,
+            reconcileInterruptedTasks: !request.options?.dryRun,
+        });
+        // 9. Restore Pending Approvals Queue
+        const pendingApprovals = PendingApprovalRestorer.restorePendingApprovals(events);
+        // 10. Validate Artifacts
+        const artifacts = this.artifactRepo.listBySession(session.id);
+        const missingArtifactIds = [];
+        for (const art of artifacts) {
+            if (!art.sha256 || art.sha256.length !== 64) {
+                missingArtifactIds.push(art.id);
+            }
+        }
+        // 11. Compile Validation Result
+        const validation = {
+            isValid: errors.length === 0,
+            projectValid: Boolean(project),
+            sessionValid: Boolean(session),
+            checkpointValid,
+            gitStateValid: true,
+            permissionsValid: Boolean(session.permissions),
+            errors,
+            warnings,
+        };
+        // 12. Record Durable Resume Event in EventStore (if not dryRun)
+        if (!request.options?.dryRun) {
+            this.eventStore.append({
+                id: `evt_res_${Date.now()}_${Math.random().toString(36).slice(2, 7)}`,
+                schemaVersion: 1,
+                projectId: project.id,
+                sessionId: session.id,
+                type: EventTypes.SESSION_RESUMED,
+                actor: "user",
+                payload: {
+                    resumeId,
+                    targetType: target.type,
+                    restoredTasksCount: taskDAG.totalTasksCount,
+                    activeTaskId: taskDAG.activeTaskId,
+                    pendingApprovalsCount: pendingApprovals.pendingApprovalsCount,
+                    validationStatus: validation.isValid ? "VALID" : "INVALID",
+                },
+                timestamp: new Date().toISOString(),
+            });
+        }
+        const result = {
+            success: true,
+            resumeId,
+            projectId: project.id,
+            sessionId: session.id,
+            project,
+            session,
+            checkpoint: checkpoint ?? undefined,
+            sessionState,
+            taskDAG,
+            pendingApprovals,
+            artifactsSummary: {
+                totalArtifactsCount: artifacts.length,
+                validArtifactsCount: artifacts.length - missingArtifactIds.length,
+                missingArtifactIds,
+            },
+            eventOffset,
+            resumedAt: new Date().toISOString(),
+            message: `Session '${session.name}' (${session.id}) successfully resumed with ${taskDAG.totalTasksCount} tasks (${taskDAG.queuedTasks.length} queued, ${pendingApprovals.pendingApprovalsCount} pending approvals).`,
+        };
+        return ResumeResultSchema.parse(result);
+    }
+}
+//# sourceMappingURL=session-resume-engine.js.map

package/dist/resume/session-resume-engine.js.map

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

package/dist/resume/task-dag-restorer.d.ts

@@ -0,0 +1,14 @@
+import type { Task } from "../domain/task.js";
+import type { TaskRepository } from "../persistence/repositories/task-repository.js";
+import type { RestoredTaskDAG } from "./resume-contract.js";
+export declare class TaskDagRestorer {
+    /**
+     * Reconstructs the task dependency graph and execution order for a session.
+     * PRD Part 1 Section 56 & 57.
+     */
+    static restoreDAG(tasks: Readonly<Task>[], options?: {
+        taskRepo?: TaskRepository;
+        reconcileInterruptedTasks?: boolean;
+    }): RestoredTaskDAG;
+}
+//# sourceMappingURL=task-dag-restorer.d.ts.map

package/dist/resume/task-dag-restorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-dag-restorer.d.ts","sourceRoot":"","sources":["../../src/resume/task-dag-restorer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AACrF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,qBAAa,eAAe;IAC1B;;;OAGG;WACW,UAAU,CACtB,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,EACvB,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,cAAc,CAAC;QAC1B,yBAAyB,CAAC,EAAE,OAAO,CAAC;KACrC,GACA,eAAe;CA2InB"}

package/dist/resume/task-dag-restorer.js

@@ -0,0 +1,130 @@
+export class TaskDagRestorer {
+    /**
+     * Reconstructs the task dependency graph and execution order for a session.
+     * PRD Part 1 Section 56 & 57.
+     */
+    static restoreDAG(tasks, options) {
+        const taskMap = new Map();
+        const shouldReconcile = options?.reconcileInterruptedTasks ?? true;
+        // 1. Process tasks and reconcile interrupted tasks if needed
+        for (const rawTask of tasks) {
+            let task = { ...rawTask };
+            if (shouldReconcile) {
+                // If task was left in running or claimed state during a crash, reset to queued
+                if (task.status === "running" || task.status === "claimed" || task.status === "verifying") {
+                    task.status = "queued";
+                    if (options?.taskRepo) {
+                        try {
+                            options.taskRepo.updateStatus(task.id, "blocked");
+                            options.taskRepo.updateStatus(task.id, "queued");
+                        }
+                        catch {
+                            // Best effort repository update
+                        }
+                    }
+                }
+            }
+            taskMap.set(task.id, task);
+        }
+        const queuedTasks = [];
+        const runningTasks = [];
+        const blockedTasks = [];
+        const completedTasks = [];
+        const failedTasks = [];
+        const cancelledTasks = [];
+        const unresolvedDependencies = {};
+        // 2. Classify task states and resolve dependencies
+        for (const task of taskMap.values()) {
+            const missingDeps = [];
+            for (const depId of task.dependencies || []) {
+                const depTask = taskMap.get(depId);
+                if (!depTask || depTask.status !== "completed") {
+                    missingDeps.push(depId);
+                }
+            }
+            if (missingDeps.length > 0) {
+                unresolvedDependencies[task.id] = missingDeps;
+                if (task.status !== "completed" && task.status !== "failed" && task.status !== "cancelled") {
+                    task.status = "blocked";
+                }
+            }
+            switch (task.status) {
+                case "queued":
+                    queuedTasks.push(task);
+                    break;
+                case "running":
+                case "claimed":
+                case "verifying":
+                    runningTasks.push(task);
+                    break;
+                case "blocked":
+                    blockedTasks.push(task);
+                    break;
+                case "completed":
+                    completedTasks.push(task);
+                    break;
+                case "failed":
+                    failedTasks.push(task);
+                    break;
+                case "cancelled":
+                    cancelledTasks.push(task);
+                    break;
+            }
+        }
+        // 3. Topologically sort tasks for deterministic execution order (Kahn algorithm)
+        const inDegree = new Map();
+        const adj = new Map();
+        for (const taskId of taskMap.keys()) {
+            inDegree.set(taskId, 0);
+            adj.set(taskId, []);
+        }
+        for (const task of taskMap.values()) {
+            for (const depId of task.dependencies || []) {
+                if (taskMap.has(depId)) {
+                    adj.get(depId).push(task.id);
+                    inDegree.set(task.id, (inDegree.get(task.id) || 0) + 1);
+                }
+            }
+        }
+        const queue = [];
+        for (const [taskId, deg] of inDegree.entries()) {
+            if (deg === 0) {
+                queue.push(taskId);
+            }
+        }
+        const executionOrder = [];
+        while (queue.length > 0) {
+            queue.sort(); // Deterministic tie-breaking
+            const u = queue.shift();
+            executionOrder.push(u);
+            for (const v of adj.get(u) || []) {
+                const newDeg = (inDegree.get(v) || 0) - 1;
+                inDegree.set(v, newDeg);
+                if (newDeg === 0) {
+                    queue.push(v);
+                }
+            }
+        }
+        // Append any un-ordered tasks (e.g. if cycle occurred) deterministically
+        for (const taskId of taskMap.keys()) {
+            if (!executionOrder.includes(taskId)) {
+                executionOrder.push(taskId);
+            }
+        }
+        const activeTask = runningTasks[0] || queuedTasks[0] || null;
+        return {
+            totalTasksCount: taskMap.size,
+            tasks: Array.from(taskMap.values()),
+            activeTaskId: activeTask ? activeTask.id : null,
+            queuedTasks,
+            runningTasks,
+            blockedTasks,
+            completedTasks,
+            failedTasks,
+            cancelledTasks,
+            executionOrder,
+            unresolvedDependencies,
+        };
+    }
+}
+//# sourceMappingURL=task-dag-restorer.js.map

package/dist/resume/task-dag-restorer.js.map

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

package/dist/sdk/anantham-client.d.ts

@@ -0,0 +1,59 @@
+import { type CreateProjectRequest, type CreateSessionRequest, type CreateTaskRequest, type ClaimTaskRequest, type CreateBackgroundJobRequest, type QueryEventsRequest } from "../domain/api.js";
+import { type Project } from "../domain/project.js";
+import { type Session } from "../domain/session.js";
+import { type Task } from "../domain/task.js";
+import { type TaskLease } from "../domain/lease.js";
+import { type BackgroundJob } from "../domain/job.js";
+import { type NodeIdentity } from "../domain/node.js";
+import { type Artifact } from "../domain/artifact.js";
+import { type HarnessEvent } from "../domain/event.js";
+export interface AnanthamClientOptions {
+    baseUrl: string;
+    apiKey?: string;
+    bearerToken?: string;
+    timeoutMs?: number;
+}
+/**
+ * Typed Programmatic TypeScript Client SDK for Anantham V2.
+ * PRD Part 2 Section 215.
+ */
+export declare class AnanthamClient {
+    private readonly baseUrl;
+    private readonly apiKey?;
+    private readonly bearerToken?;
+    private readonly timeoutMs;
+    constructor(options: AnanthamClientOptions);
+    private request;
+    health(): Promise<{
+        status: string;
+        timestamp: string;
+    }>;
+    doctor(): Promise<Record<string, unknown>>;
+    readonly projects: {
+        list: () => Promise<Project[]>;
+        create: (params: CreateProjectRequest, idempotencyKey?: string) => Promise<Project>;
+    };
+    readonly sessions: {
+        list: (projectId: string) => Promise<Session[]>;
+        create: (params: CreateSessionRequest, idempotencyKey?: string) => Promise<Session>;
+    };
+    readonly tasks: {
+        list: (sessionId: string) => Promise<Task[]>;
+        create: (params: CreateTaskRequest, idempotencyKey?: string) => Promise<Task>;
+        claim: (taskId: string, params: ClaimTaskRequest, idempotencyKey?: string) => Promise<TaskLease>;
+    };
+    readonly jobs: {
+        list: (projectId: string) => Promise<BackgroundJob[]>;
+        create: (params: CreateBackgroundJobRequest, idempotencyKey?: string) => Promise<BackgroundJob>;
+    };
+    readonly nodes: {
+        list: () => Promise<NodeIdentity[]>;
+    };
+    readonly artifacts: {
+        list: (sessionId: string) => Promise<Artifact[]>;
+    };
+    readonly events: {
+        list: (query?: Partial<QueryEventsRequest>) => Promise<HarnessEvent[]>;
+    };
+}
+//# sourceMappingURL=anantham-client.d.ts.map

package/dist/sdk/anantham-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anantham-client.d.ts","sourceRoot":"","sources":["../../src/sdk/anantham-client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,EAAE,qBAAqB;YAO5B,OAAO;IAiDR,MAAM,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAKxD,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAMvD,SAAgB,QAAQ;oBACN,OAAO,CAAC,OAAO,EAAE,CAAC;yBAGX,oBAAoB,mBAAmB,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;MAIvF;IAIF,SAAgB,QAAQ;0BACE,MAAM,KAAG,OAAO,CAAC,OAAO,EAAE,CAAC;yBAG5B,oBAAoB,mBAAmB,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;MAIvF;IAIF,SAAgB,KAAK;0BACK,MAAM,KAAG,OAAO,CAAC,IAAI,EAAE,CAAC;yBAGzB,iBAAiB,mBAAmB,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;wBAI3D,MAAM,UAAU,gBAAgB,mBAAmB,MAAM,KAAG,OAAO,CAAC,SAAS,CAAC;MAIpG;IAIF,SAAgB,IAAI;0BACM,MAAM,KAAG,OAAO,CAAC,aAAa,EAAE,CAAC;yBAGlC,0BAA0B,mBAAmB,MAAM,KAAG,OAAO,CAAC,aAAa,CAAC;MAInG;IAIF,SAAgB,KAAK;oBACH,OAAO,CAAC,YAAY,EAAE,CAAC;MAGvC;IAIF,SAAgB,SAAS;0BACC,MAAM,KAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;MAGpD;IAIF,SAAgB,MAAM;uBACA,OAAO,CAAC,kBAAkB,CAAC,KAAQ,OAAO,CAAC,YAAY,EAAE,CAAC;MAU9E;CACH"}