anantham-v2 2.0.0-alpha.1

package/dist/domain/lease.js

@@ -0,0 +1,126 @@
+import { z } from "zod";
+import { AgentStartupPlanSchema } from "./agent.js";
+import { TaskPrioritySchema, TaskStatusSchema } from "./task.js";
+/**
+ * Authoritative Lease lifecycle status.
+ * PRD Part 2 Section 35.
+ */
+export const LeaseStatusSchema = z.enum([
+    "ACTIVE",
+    "RELEASED",
+    "EXPIRED",
+    "REVOKED",
+]);
+/**
+ * Authoritative TaskLease contract with monotonic generation fencing token.
+ * PRD Part 2 Section 35, Section 52.
+ */
+export const TaskLeaseSchema = z.object({
+    id: z.string().min(1), // leaseId
+    taskId: z.string().min(1),
+    agentId: z.string().min(1),
+    instanceId: z.string().min(1),
+    projectId: z.string().min(1),
+    sessionId: z.string().min(1),
+    generation: z.number().int().positive(), // fencing token (1, 2, 3...)
+    acquiredAt: z.string().min(1), // ISO timestamp
+    expiresAt: z.string().min(1), // ISO timestamp
+    lastHeartbeatAt: z.string().min(1), // ISO timestamp
+    ttlMs: z.number().int().positive(),
+    status: LeaseStatusSchema,
+    renewalCount: z.number().int().nonnegative(),
+    maxRenewals: z.number().int().positive(),
+    metadata: z.record(z.unknown()).optional(),
+});
+/**
+ * Task claim request payload.
+ */
+export const TaskClaimRequestSchema = z.object({
+    taskId: z.string().min(1),
+    agentId: z.string().min(1),
+    instanceId: z.string().min(1),
+    projectId: z.string().min(1),
+    sessionId: z.string().min(1),
+    startupPlan: AgentStartupPlanSchema.optional(),
+    ttlMs: z.number().int().positive().optional(),
+    maxRenewals: z.number().int().positive().optional(),
+});
+/**
+ * Task claim result payload.
+ */
+export const TaskClaimResultSchema = z.object({
+    success: z.boolean(),
+    lease: TaskLeaseSchema.optional(),
+    errorCode: z.string().optional(),
+    errorMessage: z.string().optional(),
+});
+/**
+ * Task heartbeat request payload.
+ * PRD Part 2 Section 36.
+ */
+export const TaskHeartbeatRequestSchema = z.object({
+    leaseId: z.string().min(1),
+    agentId: z.string().min(1),
+    instanceId: z.string().min(1),
+    generation: z.number().int().positive(),
+    currentAction: z.string().optional(),
+    lastTool: z.string().optional(),
+    lastModelRequest: z.string().optional(),
+    extensionMs: z.number().int().positive().optional(),
+});
+/**
+ * Task heartbeat result payload.
+ */
+export const TaskHeartbeatResultSchema = z.object({
+    success: z.boolean(),
+    lease: TaskLeaseSchema.optional(),
+    errorCode: z.string().optional(),
+    errorMessage: z.string().optional(),
+});
+/**
+ * Task board query filter parameters.
+ */
+export const TaskBoardFilterSchema = z.object({
+    projectId: z.string().min(1),
+    sessionId: z.string().optional(),
+    status: z.array(TaskStatusSchema).optional(),
+    agentRole: z.string().optional(),
+    priority: TaskPrioritySchema.optional(),
+    limit: z.number().int().positive().optional(),
+});
+/**
+ * Stalled agent classification.
+ * PRD Part 2 Section 37.
+ */
+export const StalledClassificationSchema = z.enum([
+    "AGENT_CRASHED",
+    "HEARTBEAT_TIMEOUT",
+    "MAX_DURATION_EXCEEDED",
+    "UNHEALTHY_PROCESS",
+    "UNKNOWN",
+]);
+/**
+ * Action taken when recovering a stalled lease.
+ */
+export const TaskRecoveryActionSchema = z.enum([
+    "RECLAIM_AND_REQUEUE",
+    "RETRY",
+    "FAIL",
+    "BLOCK_FOR_REVIEW",
+]);
+/**
+ * Record of a task recovery evaluation.
+ */
+export const TaskRecoveryRecordSchema = z.object({
+    taskId: z.string().min(1),
+    leaseId: z.string().min(1),
+    agentId: z.string().min(1),
+    classification: StalledClassificationSchema,
+    action: TaskRecoveryActionSchema,
+    attemptCount: z.number().int().positive(),
+    maxAttempts: z.number().int().positive(),
+    newGeneration: z.number().int().positive().optional(),
+    timestamp: z.string().min(1),
+    reason: z.string(),
+});
+//# sourceMappingURL=lease.js.map

package/dist/domain/lease.js.map

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