@xenosystem/agent-sdk 0.9.21 → 0.9.24

package/dist/coordination/index.d.ts

@@ -0,0 +1,395 @@
+declare const XENO_COORDINATION_SCHEMA_VERSION: 1;
+type XenoGoalStatus = "active" | "paused" | "waiting" | "blocked" | "completed" | "failed" | "cancelled";
+type XenoGoalTaskStatus = "pending" | "ready" | "running" | "blocked" | "failed" | "completed" | "cancelled" | "interrupted";
+interface XenoGoalCriterion {
+    id: string;
+    description: string;
+    required: boolean;
+}
+interface XenoGoalCriterionResult {
+    criterionId: string;
+    satisfied: boolean;
+    evidence: string[];
+    reason: string;
+    evaluatedAt: string;
+}
+interface XenoGoalVerification {
+    status: "pending" | "running" | "passed" | "failed";
+    criteria: XenoGoalCriterionResult[];
+    evidence: string[];
+    summary?: string;
+    verifiedAt?: string;
+    verifiedBy?: string;
+}
+interface XenoGoalTask {
+    id: string;
+    milestoneId: string;
+    parentTaskId?: string;
+    title: string;
+    description?: string;
+    status: XenoGoalTaskStatus;
+    assignedAgentId?: string;
+    dependsOn?: string[];
+    progress?: string;
+    resultEventId?: string;
+    createdAt: string;
+    updatedAt: string;
+    completedAt?: string;
+}
+interface XenoGoalMilestone {
+    id: string;
+    title: string;
+    description?: string;
+    status: "pending" | "active" | "blocked" | "completed" | "cancelled";
+    taskIds: string[];
+    createdAt: string;
+    updatedAt: string;
+    completedAt?: string;
+}
+interface XenoGoalProgress {
+    summary: string;
+    currentMilestoneId?: string;
+    currentTaskId?: string;
+    completedTaskCount: number;
+    totalTaskCount: number;
+    percent?: number;
+    outstanding: string[];
+    decisions: string[];
+    updatedAt: string;
+}
+interface XenoGoalRecord {
+    schemaVersion: typeof XENO_COORDINATION_SCHEMA_VERSION;
+    id: string;
+    version: number;
+    sessionId: string;
+    objective: string;
+    why?: string;
+    successCriteria: XenoGoalCriterion[];
+    constraints: string[];
+    limits?: {
+        maxIterations?: number;
+        maxTokens?: number;
+        maxWallClockMs?: number;
+    };
+    metadata: Record<string, string | number | boolean>;
+    status: XenoGoalStatus;
+    milestones: XenoGoalMilestone[];
+    tasks: XenoGoalTask[];
+    progress: XenoGoalProgress;
+    verification: XenoGoalVerification;
+    steering: Array<{
+        id: string;
+        instruction: string;
+        createdAt: string;
+        consumedAt?: string;
+    }>;
+    createdAt: string;
+    updatedAt: string;
+    completedAt?: string;
+}
+type XenoLoopKind = "agentic-development" | "goal-continuation" | "scheduled";
+type XenoLoopStatus = "running" | "paused" | "waiting" | "stopped" | "completed" | "failed";
+interface XenoLoopSchedule {
+    kind: "fixed-interval" | "dynamic";
+    intervalMs?: number;
+    nextRunAt?: string;
+    expiresAt?: string;
+}
+interface XenoLoopIteration {
+    number: number;
+    startedAt: string;
+    completedAt?: string;
+    status: "running" | "completed" | "failed" | "interrupted";
+    activity: string;
+    taskId?: string;
+    verificationEventId?: string;
+    error?: string;
+}
+interface XenoLoopRecord {
+    schemaVersion: typeof XENO_COORDINATION_SCHEMA_VERSION;
+    id: string;
+    version: number;
+    sessionId: string;
+    goalId?: string;
+    kind: XenoLoopKind;
+    status: XenoLoopStatus;
+    currentActivity?: string;
+    iterations: XenoLoopIteration[];
+    schedule?: XenoLoopSchedule;
+    stopReason?: string;
+    createdAt: string;
+    updatedAt: string;
+    stoppedAt?: string;
+}
+type XenoHandoffStatus = "prepared" | "available" | "claimed" | "completed" | "failed" | "cancelled";
+interface XenoHandoffOperation {
+    operationId: string;
+    kind: "tool" | "command" | "build" | "subagent" | "other";
+    status: "running" | "completed" | "interrupted";
+    sideEffecting: boolean;
+    recovery: "waited" | "resume" | "retry" | "manual";
+}
+interface XenoHandoffRecord {
+    schemaVersion: typeof XENO_COORDINATION_SCHEMA_VERSION;
+    id: string;
+    version: number;
+    sessionId: string;
+    goalId?: string;
+    loopId?: string;
+    status: XenoHandoffStatus;
+    sourceOwnerId: string;
+    targetOwnerId?: string;
+    claimedBy?: string;
+    sourceLeaseEpoch: number;
+    targetLeaseEpoch?: number;
+    workspace?: string;
+    branch?: string;
+    currentMilestoneId?: string;
+    currentTaskId?: string;
+    agentIds: string[];
+    operations: XenoHandoffOperation[];
+    contextDigest?: string;
+    createdAt: string;
+    updatedAt: string;
+    claimedAt?: string;
+    completedAt?: string;
+    failedAt?: string;
+    failureReason?: string;
+}
+interface XenoExecutionOwner {
+    ownerId: string;
+    leaseId: string;
+    epoch: number;
+    acquiredAt: string;
+    heartbeatAt: string;
+    expiresAt: string;
+    processId?: number;
+    host?: string;
+}
+type XenoCoordinationEventType = "goal.created" | "goal.updated" | "goal.steered" | "goal.completed" | "goal.cancelled" | "loop.started" | "loop.iteration" | "loop.paused" | "loop.waiting" | "loop.resumed" | "loop.stopped" | "loop.completed" | "loop.failed" | "handoff.created" | "handoff.claimed" | "handoff.completed" | "handoff.failed" | "ownership.acquired" | "ownership.renewed" | "ownership.released";
+interface XenoCoordinationEvent {
+    schemaVersion: typeof XENO_COORDINATION_SCHEMA_VERSION;
+    id: string;
+    sequence: number;
+    type: XenoCoordinationEventType;
+    sessionId: string;
+    goalId?: string;
+    loopId?: string;
+    handoffId?: string;
+    ownerId?: string;
+    timestamp: string;
+    data: Record<string, unknown>;
+}
+interface XenoCoordinationSessionState {
+    schemaVersion: typeof XENO_COORDINATION_SCHEMA_VERSION;
+    sessionId: string;
+    version: number;
+    ownershipEpoch: number;
+    owner?: XenoExecutionOwner;
+    goals: XenoGoalRecord[];
+    loops: XenoLoopRecord[];
+    handoffs: XenoHandoffRecord[];
+    events: XenoCoordinationEvent[];
+    createdAt: string;
+    updatedAt: string;
+}
+interface XenoCoordinationStoreOptions {
+    rootDirectory?: string;
+    now?: () => string;
+    idFactory?: (prefix: string) => string;
+    ownerLeaseMs?: number;
+    lockTimeoutMs?: number;
+    lockStaleMs?: number;
+    maximumEventsPerSession?: number;
+}
+interface CreateXenoGoalInput {
+    sessionId: string;
+    objective: string;
+    why?: string;
+    successCriteria?: Array<string | Omit<XenoGoalCriterion, "id"> & {
+        id?: string;
+    }>;
+    constraints?: string[];
+    limits?: XenoGoalRecord["limits"];
+    metadata?: Record<string, string | number | boolean>;
+}
+interface CreateXenoHandoffInput {
+    sessionId: string;
+    sourceOwnerId: string;
+    sourceLeaseId: string;
+    goalId?: string;
+    loopId?: string;
+    targetOwnerId?: string;
+    workspace?: string;
+    branch?: string;
+    currentMilestoneId?: string;
+    currentTaskId?: string;
+    agentIds?: string[];
+    operations?: XenoHandoffOperation[];
+    contextDigest?: string;
+}
+declare class XenoCoordinationError extends Error {
+    readonly code: "INVALID" | "NOT_FOUND" | "CONFLICT" | "NOT_OWNER" | "LEASE_EXPIRED" | "UNSAFE_HANDOFF" | "VERIFICATION_REQUIRED";
+    readonly details: Record<string, unknown>;
+    constructor(code: "INVALID" | "NOT_FOUND" | "CONFLICT" | "NOT_OWNER" | "LEASE_EXPIRED" | "UNSAFE_HANDOFF" | "VERIFICATION_REQUIRED", message: string, details?: Record<string, unknown>);
+}
+interface UpdateXenoGoalInput {
+    objective?: string;
+    why?: string;
+    constraints?: string[];
+    successCriteria?: XenoGoalCriterion[];
+    status?: Exclude<XenoGoalStatus, "completed">;
+    progress?: Partial<Omit<XenoGoalProgress, "updatedAt">>;
+    verification?: XenoGoalVerification;
+    metadata?: Record<string, string | number | boolean>;
+}
+interface StartXenoLoopInput {
+    sessionId: string;
+    goalId?: string;
+    kind: XenoLoopKind;
+    activity?: string;
+    schedule?: XenoLoopSchedule;
+}
+interface ClaimXenoHandoffInput {
+    sessionId: string;
+    handoffId: string;
+    targetOwnerId: string;
+    processId?: number;
+    host?: string;
+}
+declare class DurableXenoCoordinationStore {
+    private readonly rootDirectory;
+    private readonly now;
+    private readonly idFactory;
+    private readonly ownerLeaseMs;
+    private readonly lockTimeoutMs;
+    private readonly lockStaleMs;
+    private readonly maximumEventsPerSession;
+    constructor(options?: XenoCoordinationStoreOptions);
+    getSessionState(sessionId: string): Promise<XenoCoordinationSessionState>;
+    listSessionStates(): Promise<XenoCoordinationSessionState[]>;
+    createGoal(input: CreateXenoGoalInput): Promise<XenoGoalRecord>;
+    getGoal(sessionId: string, goalId?: string): Promise<XenoGoalRecord | undefined>;
+    updateGoal(sessionId: string, goalId: string, expectedVersion: number, update: UpdateXenoGoalInput): Promise<XenoGoalRecord>;
+    addMilestone(sessionId: string, goalId: string, expectedVersion: number, input: {
+        title: string;
+        description?: string;
+    }): Promise<XenoGoalRecord>;
+    addTask(sessionId: string, goalId: string, expectedVersion: number, input: {
+        milestoneId: string;
+        parentTaskId?: string;
+        title: string;
+        description?: string;
+        assignedAgentId?: string;
+        dependsOn?: string[];
+    }): Promise<XenoGoalRecord>;
+    updateTask(sessionId: string, goalId: string, taskId: string, expectedVersion: number, update: Pick<XenoGoalTask, "status"> & Partial<Pick<XenoGoalTask, "progress" | "resultEventId" | "assignedAgentId">>): Promise<XenoGoalRecord>;
+    steerGoal(sessionId: string, goalId: string, expectedVersion: number, instruction: string): Promise<XenoGoalRecord>;
+    consumeGoalSteering(sessionId: string, goalId: string, expectedVersion: number): Promise<{
+        goal: XenoGoalRecord;
+        instructions: Array<{
+            id: string;
+            instruction: string;
+            createdAt: string;
+        }>;
+    }>;
+    completeGoal(sessionId: string, goalId: string, expectedVersion: number, verification: XenoGoalVerification): Promise<XenoGoalRecord>;
+    cancelGoal(sessionId: string, goalId: string, expectedVersion: number, reason: string): Promise<XenoGoalRecord>;
+    startLoop(input: StartXenoLoopInput): Promise<XenoLoopRecord>;
+    getLoop(sessionId: string, loopId?: string): Promise<XenoLoopRecord | undefined>;
+    beginLoopIteration(sessionId: string, loopId: string, expectedVersion: number, activity: string, taskId?: string): Promise<XenoLoopRecord>;
+    finishLoopIteration(sessionId: string, loopId: string, expectedVersion: number, result: {
+        status: "completed" | "failed" | "interrupted";
+        verificationEventId?: string;
+        error?: string;
+        nextStatus?: Extract<XenoLoopStatus, "running" | "waiting" | "failed">;
+    }): Promise<XenoLoopRecord>;
+    setLoopStatus(sessionId: string, loopId: string, expectedVersion: number, status: Extract<XenoLoopStatus, "paused" | "running" | "waiting" | "stopped" | "completed" | "failed">, reason?: string): Promise<XenoLoopRecord>;
+    acquireOwnership(sessionId: string, ownerId: string, options?: {
+        processId?: number;
+        host?: string;
+        leaseMs?: number;
+    }): Promise<XenoExecutionOwner>;
+    renewOwnership(sessionId: string, ownerId: string, leaseId: string, leaseMs?: number): Promise<XenoExecutionOwner>;
+    releaseOwnership(sessionId: string, ownerId: string, leaseId: string): Promise<XenoExecutionOwner>;
+    createHandoff(input: CreateXenoHandoffInput): Promise<XenoHandoffRecord>;
+    claimHandoff(input: ClaimXenoHandoffInput): Promise<{
+        handoff: XenoHandoffRecord;
+        owner: XenoExecutionOwner;
+    }>;
+    completeHandoff(sessionId: string, handoffId: string, ownerId: string, leaseId: string): Promise<XenoHandoffRecord>;
+    failHandoff(sessionId: string, handoffId: string, reason: string): Promise<XenoHandoffRecord>;
+    private mutateGoal;
+    private mutateLoop;
+    private recalculateProgress;
+    private requireGoal;
+    private requireOwner;
+    private assertVersion;
+    private newOwner;
+    private ownerExpired;
+    private appendEvent;
+    private mutate;
+    private statePath;
+    private lockPath;
+    private readState;
+    private writeState;
+    private renameReplacing;
+    private withSessionLock;
+    private staleLockOwner;
+    private quarantineLock;
+}
+type XenoCoordinationAction = "state.get" | "goal.create" | "goal.update" | "goal.complete" | "goal.cancel" | "goal.steer" | "loop.start" | "loop.get" | "loop.begin" | "loop.finish" | "loop.set_status" | "ownership.acquire" | "ownership.renew" | "ownership.release" | "handoff.create" | "handoff.claim" | "handoff.complete" | "handoff.fail";
+interface ExecuteXenoCoordinationActionInput {
+    action: XenoCoordinationAction;
+    sessionId: string;
+    payload?: Record<string, unknown>;
+}
+interface ExecuteXenoCoordinationActionResult {
+    action: XenoCoordinationAction;
+    sessionId: string;
+    result: unknown;
+    state: XenoCoordinationSessionState;
+    event?: XenoCoordinationEvent;
+}
+declare function executeXenoCoordinationAction(store: DurableXenoCoordinationStore, input: ExecuteXenoCoordinationActionInput): Promise<ExecuteXenoCoordinationActionResult>;
+interface XenoExecutionLeaseSessionOptions {
+    store?: DurableXenoCoordinationStore;
+    sessionId: string;
+    ownerId?: string;
+    processId?: number;
+    host?: string;
+    leaseMs?: number;
+    heartbeatMs?: number;
+    claimHandoffId?: string;
+    onOwnershipLost?: (error: unknown) => void;
+}
+declare class XenoExecutionLeaseSession {
+    readonly sessionId: string;
+    readonly ownerId: string;
+    private readonly store;
+    private readonly processId;
+    private readonly host;
+    private readonly leaseMs;
+    private readonly heartbeatMs;
+    private readonly claimHandoffId?;
+    private readonly onOwnershipLost?;
+    private timer?;
+    private heartbeatInFlight;
+    private owner?;
+    private stopped;
+    private lostError?;
+    private preparedHandoffId?;
+    constructor(options: XenoExecutionLeaseSessionOptions);
+    get currentOwner(): XenoExecutionOwner | undefined;
+    get active(): boolean;
+    start(): Promise<XenoExecutionOwner>;
+    assertOwned(): Promise<XenoExecutionOwner>;
+    private renewHeldLease;
+    prepareHandoff(input?: Omit<CreateXenoHandoffInput, "sessionId" | "sourceOwnerId" | "sourceLeaseId">): Promise<XenoHandoffRecord>;
+    stop(options?: {
+        release?: boolean;
+    }): Promise<void>;
+    private heartbeat;
+    private markLost;
+}
+export { type ClaimXenoHandoffInput, type CreateXenoGoalInput, type CreateXenoHandoffInput, DurableXenoCoordinationStore, type ExecuteXenoCoordinationActionInput, type ExecuteXenoCoordinationActionResult, type StartXenoLoopInput, type UpdateXenoGoalInput, XENO_COORDINATION_SCHEMA_VERSION, type XenoCoordinationAction, XenoCoordinationError, type XenoCoordinationEvent, type XenoCoordinationEventType, type XenoCoordinationSessionState, type XenoCoordinationStoreOptions, XenoExecutionLeaseSession, type XenoExecutionLeaseSessionOptions, type XenoExecutionOwner, type XenoGoalCriterion, type XenoGoalCriterionResult, type XenoGoalMilestone, type XenoGoalProgress, type XenoGoalRecord, type XenoGoalStatus, type XenoGoalTask, type XenoGoalTaskStatus, type XenoGoalVerification, type XenoHandoffOperation, type XenoHandoffRecord, type XenoHandoffStatus, type XenoLoopIteration, type XenoLoopKind, type XenoLoopRecord, type XenoLoopSchedule, type XenoLoopStatus, executeXenoCoordinationAction };

package/dist/coordination/index.js

@@ -0,0 +1,2 @@
+var I=1,p=class extends Error{constructor(s,r,e={}){super(r);this.code=s;this.details=e;this.name="XenoCoordinationError"}code;details};import{createHash as D,randomUUID as X}from"node:crypto";import*as f from"node:fs/promises";import*as A from"node:os";import*as m from"node:path";import{homedir as L,platform as P,release as _}from"node:os";import{resolve as x}from"node:path";var ee=P();var te=_(),ne=L();function N(){let d=process.env.XENO_AGENT_HOME?.trim();return d?x(d):x(L(),".xeno-agent")}var F=3e4,H=3e4,$=6e4,V=2e4,b=new Set(["EACCES","EBUSY","EPERM"]),T=[5,10,20,40,80,160,320],q=[5,10,20,40,80,160,320];function u(d,t,s=16384){let r=d.trim();if(!r||r.length>s)throw new p("INVALID",`${t} must be non-empty and no longer than ${s} characters`);return r}function k(d,t){return[...new Set((d??[]).map(s=>u(s,t)))]}function U(d){if(!d)return;let t={};for(let[s,r]of Object.entries(d))if(r!==void 0){if(!Number.isSafeInteger(r)||r<=0)throw new p("INVALID",`${s} must be a positive safe integer when provided`);t[s]=r}return t}function j(d){if(d){if(d.kind!=="fixed-interval"&&d.kind!=="dynamic")throw new p("INVALID","schedule.kind must be fixed-interval or dynamic");if(d.kind==="fixed-interval"&&(!Number.isSafeInteger(d.intervalMs)||(d.intervalMs??0)<=0))throw new p("INVALID","Fixed-interval schedules require a positive safe intervalMs");if(d.intervalMs!==void 0&&(!Number.isSafeInteger(d.intervalMs)||d.intervalMs<=0))throw new p("INVALID","schedule.intervalMs must be a positive safe integer when provided");for(let t of["nextRunAt","expiresAt"]){let s=d[t];if(s!==void 0&&!Number.isFinite(Date.parse(s)))throw new p("INVALID",`schedule.${t} must be an ISO timestamp when provided`)}return w(d)}}function w(d){return structuredClone(d)}function E(d){let t=Date.parse(d);return Number.isFinite(t)?t:0}function R(d){if(!Number.isInteger(d)||d<=0)return!1;try{return process.kill(d,0),!0}catch(t){return t.code==="EPERM"}}function J(d){return{summary:"Goal created; work has not started.",completedTaskCount:0,totalTaskCount:0,outstanding:[],decisions:[],updatedAt:d}}function B(){return{status:"pending",criteria:[],evidence:[]}}function W(d){return D("sha256").update(d).digest("hex")}var S=class{rootDirectory;now;idFactory;ownerLeaseMs;lockTimeoutMs;lockStaleMs;maximumEventsPerSession;constructor(t={}){this.rootDirectory=t.rootDirectory??m.join(N(),"coordination"),this.now=t.now??(()=>new Date().toISOString()),this.idFactory=t.idFactory??(s=>`${s}_${X()}`),this.ownerLeaseMs=t.ownerLeaseMs??F,this.lockTimeoutMs=t.lockTimeoutMs??H,this.lockStaleMs=t.lockStaleMs??$,this.maximumEventsPerSession=t.maximumEventsPerSession??V}async getSessionState(t){let s=u(t,"sessionId",1024);return w(await this.readState(s))}async listSessionStates(){let t=m.join(this.rootDirectory,"sessions"),s;try{s=await f.readdir(t)}catch(e){if(e.code==="ENOENT")return[];throw e}return(await Promise.all(s.filter(e=>e.endsWith(".json")).map(async e=>{try{let n=JSON.parse(await f.readFile(m.join(t,e),"utf8"));return n.schemaVersion!==1||typeof n.sessionId!="string"?void 0:((!Number.isSafeInteger(n.ownershipEpoch)||n.ownershipEpoch<0)&&(n.ownershipEpoch=Math.max(n.owner?.epoch??0,...n.handoffs.map(o=>o.targetLeaseEpoch??o.sourceLeaseEpoch??0))),n)}catch{return}}))).filter(e=>e!==void 0).sort((e,n)=>E(n.updatedAt)-E(e.updatedAt)).map(e=>w(e))}async createGoal(t){let s=u(t.sessionId,"sessionId",1024),r=U(t.limits);return this.mutate(s,e=>{let n=e.goals.find(c=>["active","paused","waiting","blocked"].includes(c.status));if(n)throw new p("CONFLICT",`Session ${s} already has active goal ${n.id}`);let o=this.now(),i=(t.successCriteria??[]).map(c=>typeof c=="string"?{id:this.idFactory("criterion"),description:u(c,"successCriteria"),required:!0}:{id:c.id?u(c.id,"successCriteria.id",512):this.idFactory("criterion"),description:u(c.description,"successCriteria.description"),required:c.required}),a={schemaVersion:1,id:this.idFactory("goal"),version:1,sessionId:s,objective:u(t.objective,"objective"),...t.why?{why:u(t.why,"why")}:{},successCriteria:i,constraints:k(t.constraints,"constraints"),...r?{limits:r}:{},metadata:w(t.metadata??{}),status:"active",milestones:[],tasks:[],progress:J(o),verification:B(),steering:[],createdAt:o,updatedAt:o};return e.goals.push(a),this.appendEvent(e,"goal.created",{goalId:a.id,data:{objective:a.objective}}),a})}async getGoal(t,s){let r=await this.getSessionState(t),e=s?r.goals.find(n=>n.id===s):[...r.goals].reverse().find(n=>["active","paused","waiting","blocked"].includes(n.status));return e?w(e):void 0}async updateGoal(t,s,r,e){return this.mutate(t,n=>{let o=this.requireGoal(n,s);if(this.assertVersion(o.id,o.version,r),["completed","cancelled","failed"].includes(o.status))throw new p("CONFLICT",`Goal ${o.id} is terminal (${o.status})`);return e.status==="active"&&o.status==="blocked"?o.status="active":e.status&&(o.status=e.status),e.objective!==void 0&&(o.objective=u(e.objective,"objective")),e.why!==void 0&&(o.why=u(e.why,"why")),e.constraints&&(o.constraints=k(e.constraints,"constraints")),e.successCriteria&&(o.successCriteria=w(e.successCriteria)),e.progress&&(o.progress={...o.progress,...w(e.progress),outstanding:k(e.progress.outstanding??o.progress.outstanding,"progress.outstanding"),decisions:k(e.progress.decisions??o.progress.decisions,"progress.decisions"),updatedAt:this.now()}),e.verification&&(o.verification=w(e.verification)),e.metadata&&(o.metadata=w(e.metadata)),o.version+=1,o.updatedAt=this.now(),this.appendEvent(n,"goal.updated",{goalId:o.id,data:{status:o.status,version:o.version}}),o})}async addMilestone(t,s,r,e){return this.mutateGoal(t,s,r,(n,o)=>{let i={id:this.idFactory("milestone"),title:u(e.title,"milestone.title"),...e.description?{description:u(e.description,"milestone.description")}:{},status:n.milestones.some(a=>a.status==="active")?"pending":"active",taskIds:[],createdAt:o,updatedAt:o};n.milestones.push(i),n.progress.currentMilestoneId??=i.id,n.progress.updatedAt=o})}async addTask(t,s,r,e){return this.mutateGoal(t,s,r,(n,o)=>{let i=n.milestones.find(l=>l.id===e.milestoneId);if(!i)throw new p("NOT_FOUND",`Milestone ${e.milestoneId} was not found`);if(e.parentTaskId&&!n.tasks.some(l=>l.id===e.parentTaskId))throw new p("NOT_FOUND",`Parent task ${e.parentTaskId} was not found`);let a=[...new Set(e.dependsOn??[])];for(let l of a)if(!n.tasks.some(g=>g.id===l))throw new p("NOT_FOUND",`Task dependency ${l} was not found`);let c={id:this.idFactory("task"),milestoneId:i.id,...e.parentTaskId?{parentTaskId:e.parentTaskId}:{},title:u(e.title,"task.title"),...e.description?{description:u(e.description,"task.description")}:{},status:a.length===0?"ready":"pending",...e.assignedAgentId?{assignedAgentId:u(e.assignedAgentId,"task.assignedAgentId",512)}:{},...a.length?{dependsOn:a}:{},createdAt:o,updatedAt:o};n.tasks.push(c),i.taskIds.push(c.id),i.updatedAt=o,n.progress.totalTaskCount=n.tasks.length,n.progress.outstanding=n.tasks.filter(l=>l.status!=="completed").map(l=>l.title),n.progress.updatedAt=o})}async updateTask(t,s,r,e,n){return this.mutateGoal(t,s,e,(o,i)=>{let a=o.tasks.find(l=>l.id===r);if(!a)throw new p("NOT_FOUND",`Task ${r} was not found`);a.status=n.status,n.progress!==void 0&&(a.progress=u(n.progress,"task.progress")),n.resultEventId!==void 0&&(a.resultEventId=u(n.resultEventId,"task.resultEventId",512)),n.assignedAgentId!==void 0&&(a.assignedAgentId=u(n.assignedAgentId,"task.assignedAgentId",512)),a.updatedAt=i,a.status==="completed"&&(a.completedAt=i);let c=o.milestones.find(l=>l.id===a.milestoneId);if(c){let l=o.tasks.filter(g=>g.milestoneId===c.id);l.length>0&&l.every(g=>g.status==="completed")?(c.status="completed",c.completedAt=i):l.some(g=>g.status==="running")?c.status="active":l.some(g=>g.status==="blocked")&&(c.status="blocked"),c.updatedAt=i}for(let l of o.tasks)l.status!=="pending"||!l.dependsOn?.length||l.dependsOn.every(g=>o.tasks.find(y=>y.id===g)?.status==="completed")&&(l.status="ready",l.updatedAt=i);this.recalculateProgress(o,i)})}async steerGoal(t,s,r,e){return this.mutateGoal(t,s,r,(n,o,i)=>{let a=this.idFactory("steer");n.steering.push({id:a,instruction:u(e,"instruction"),createdAt:o}),this.appendEvent(i,"goal.steered",{goalId:s,data:{steeringId:a}})},!1)}async consumeGoalSteering(t,s,r){let e=[];return{goal:await this.mutateGoal(t,s,r,(o,i)=>{e=o.steering.filter(a=>!a.consumedAt).map(({id:a,instruction:c,createdAt:l})=>({id:a,instruction:c,createdAt:l}));for(let a of o.steering)a.consumedAt||(a.consumedAt=i)}),instructions:e}}async completeGoal(t,s,r,e){if(e.status!=="passed")throw new p("VERIFICATION_REQUIRED","Goal completion requires passed verification");return this.mutate(t,n=>{let o=this.requireGoal(n,s);this.assertVersion(o.id,o.version,r);let i=o.successCriteria.filter(l=>l.required),a=i.filter(l=>{let g=e.criteria.find(y=>y.criterionId===l.id);return!g?.satisfied||g.evidence.length===0});if(a.length>0)throw new p("VERIFICATION_REQUIRED","Required success criteria lack passing evidence",{unmetCriteria:a.map(l=>l.id)});if(i.length===0&&e.evidence.length===0)throw new p("VERIFICATION_REQUIRED","Goal completion requires at least one durable evidence reference");let c=this.now();return o.status="completed",o.verification=w(e),o.verification.verifiedAt??=c,o.completedAt=c,o.updatedAt=c,o.version+=1,this.appendEvent(n,"goal.completed",{goalId:s,data:{evidence:o.verification.evidence}}),o})}async cancelGoal(t,s,r,e){return this.mutate(t,n=>{let o=this.requireGoal(n,s);if(this.assertVersion(o.id,o.version,r),["completed","cancelled","failed"].includes(o.status))return o;o.status="cancelled",o.updatedAt=this.now(),o.version+=1,this.appendEvent(n,"goal.cancelled",{goalId:s,data:{reason:u(e,"reason")}});for(let i of n.loops.filter(a=>a.goalId===s&&["running","paused","waiting"].includes(a.status)))i.status="stopped",i.stopReason=`Goal cancelled: ${e}`,i.stoppedAt=this.now(),i.updatedAt=i.stoppedAt,i.version+=1;return o})}async startLoop(t){return this.mutate(t.sessionId,s=>{if(t.kind==="goal-continuation"&&!t.goalId)throw new p("INVALID","Goal-continuation loops require a goalId");if(t.goalId){let i=this.requireGoal(s,t.goalId);if(["completed","cancelled","failed"].includes(i.status))throw new p("CONFLICT",`Cannot start a loop for terminal goal ${i.id}`)}if(t.kind==="scheduled"&&!t.schedule)throw new p("INVALID","Scheduled loops require schedule metadata");if(t.kind!=="scheduled"&&t.schedule)throw new p("INVALID","Only scheduled loops may carry schedule metadata");let r=j(t.schedule),e=s.loops.find(i=>i.goalId===t.goalId&&i.kind===t.kind&&["running","paused","waiting"].includes(i.status));if(e)throw new p("CONFLICT",`Loop ${e.id} is already active`);let n=this.now(),o={schemaVersion:1,id:this.idFactory("loop"),version:1,sessionId:s.sessionId,...t.goalId?{goalId:t.goalId}:{},kind:t.kind,status:"running",...t.activity?{currentActivity:u(t.activity,"activity")}:{},iterations:[],...r?{schedule:r}:{},createdAt:n,updatedAt:n};return s.loops.push(o),this.appendEvent(s,"loop.started",{loopId:o.id,goalId:o.goalId,data:{kind:o.kind}}),o})}async getLoop(t,s){let r=await this.getSessionState(t),e=s?r.loops.find(n=>n.id===s):[...r.loops].reverse().find(n=>["running","paused","waiting"].includes(n.status));return e?w(e):void 0}async beginLoopIteration(t,s,r,e,n){return this.mutateLoop(t,s,r,(o,i,a)=>{if(o.status!=="running")throw new p("CONFLICT",`Loop ${o.id} is ${o.status}`);if(o.iterations.some(l=>l.status==="running"))throw new p("CONFLICT",`Loop ${o.id} already has a running iteration`);let c=(o.iterations.at(-1)?.number??0)+1;o.currentActivity=u(e,"activity"),o.iterations.push({number:c,startedAt:i,status:"running",activity:o.currentActivity,...n?{taskId:u(n,"taskId",512)}:{}}),this.appendEvent(a,"loop.iteration",{loopId:s,goalId:o.goalId,data:{number:c,phase:"started",activity:o.currentActivity}})},!1)}async finishLoopIteration(t,s,r,e){return this.mutateLoop(t,s,r,(n,o,i)=>{let a=[...n.iterations].reverse().find(c=>c.status==="running");if(!a)throw new p("CONFLICT",`Loop ${n.id} has no running iteration`);a.status=e.status,a.completedAt=o,e.verificationEventId&&(a.verificationEventId=u(e.verificationEventId,"verificationEventId",512)),e.error&&(a.error=u(e.error,"error")),n.status=e.nextStatus??(n.status==="paused"||n.status==="waiting"?n.status:"running"),this.appendEvent(i,"loop.iteration",{loopId:s,goalId:n.goalId,data:{number:a.number,phase:"finished",status:e.status}})},!1)}async setLoopStatus(t,s,r,e,n){return this.mutateLoop(t,s,r,(o,i,a)=>{let c=o.status;if(["stopped","completed","failed"].includes(c))throw new p("CONFLICT",`Loop ${o.id} is terminal (${c})`);let l=[...o.iterations].reverse().find(y=>y.status==="running");if(l&&e==="completed")throw new p("CONFLICT",`Loop ${o.id} cannot complete while iteration ${l.number} is running`);l&&(e==="stopped"||e==="failed")&&(l.status=e==="failed"?"failed":"interrupted",l.completedAt=i,l.error=u(n??e,"reason")),o.status=e,["stopped","completed","failed"].includes(e)&&(o.stoppedAt=i,o.stopReason=u(n??e,"reason"));let g=e==="paused"?"loop.paused":e==="waiting"?"loop.waiting":e==="running"&&(c==="paused"||c==="waiting")?"loop.resumed":e==="completed"?"loop.completed":e==="failed"?"loop.failed":"loop.stopped";this.appendEvent(a,g,{loopId:s,goalId:o.goalId,data:{previous:c,status:e,...n?{reason:n}:{}}})},!1)}async acquireOwnership(t,s,r={}){return this.mutate(t,e=>{let n=this.now();if(e.owner&&!this.ownerExpired(e.owner,n)){if(e.owner.ownerId===s&&r.processId!==void 0&&e.owner.processId===r.processId&&(r.host===void 0||e.owner.host===r.host))return e.owner;throw new p("CONFLICT",`Session ${t} is owned by ${e.owner.ownerId}`,{owner:e.owner})}let o=e.owner&&this.ownerExpired(e.owner,n)?e.owner:void 0;if(o&&o.ownerId!==s)for(let c of e.handoffs.filter(l=>l.status==="claimed"&&l.claimedBy===o.ownerId))c.status="failed",c.failureReason=`Claimed owner ${o.ownerId} lost its execution lease before completing the handoff.`,c.failedAt=n,c.updatedAt=n,c.version+=1,this.appendEvent(e,"handoff.failed",{handoffId:c.id,goalId:c.goalId,loopId:c.loopId,data:{reason:c.failureReason,expiredLeaseId:o.leaseId}});let i=e.ownershipEpoch+1,a=this.newOwner(s,i,r,n);return e.owner=a,e.ownershipEpoch=i,this.appendEvent(e,"ownership.acquired",{ownerId:s,data:{epoch:i,leaseId:a.leaseId}}),a})}async renewOwnership(t,s,r,e=this.ownerLeaseMs){return this.mutate(t,n=>{let o=this.requireOwner(n,s,r);if(this.ownerExpired(o,this.now()))throw new p("LEASE_EXPIRED",`Ownership lease ${r} expired`);return o.heartbeatAt=this.now(),o.expiresAt=new Date(E(o.heartbeatAt)+e).toISOString(),this.appendEvent(n,"ownership.renewed",{ownerId:s,data:{epoch:o.epoch,leaseId:r}}),o})}async releaseOwnership(t,s,r){return this.mutate(t,e=>{let n=this.requireOwner(e,s,r);return e.owner=void 0,this.appendEvent(e,"ownership.released",{ownerId:s,data:{epoch:n.epoch}}),n})}async createHandoff(t){return this.mutate(t.sessionId,s=>{let r=this.requireOwner(s,t.sourceOwnerId,t.sourceLeaseId);if(this.ownerExpired(r,this.now()))throw new p("LEASE_EXPIRED",`Ownership lease ${r.leaseId} expired`);let e=(t.operations??[]).filter(a=>a.status==="running"&&a.sideEffecting&&a.recovery==="retry");if(e.length>0)throw new p("UNSAFE_HANDOFF","Running side-effecting operations cannot be transferred with automatic retry",{operationIds:e.map(a=>a.operationId)});if(t.goalId&&this.requireGoal(s,t.goalId),t.loopId&&!s.loops.some(a=>a.id===t.loopId))throw new p("NOT_FOUND",`Loop ${t.loopId} was not found`);let n=s.handoffs.find(a=>["prepared","available","claimed"].includes(a.status));if(n)throw new p("CONFLICT",`Handoff ${n.id} is already active`);let o=this.now(),i={schemaVersion:1,id:this.idFactory("handoff"),version:1,sessionId:s.sessionId,...t.goalId?{goalId:t.goalId}:{},...t.loopId?{loopId:t.loopId}:{},status:"available",sourceOwnerId:r.ownerId,...t.targetOwnerId?{targetOwnerId:u(t.targetOwnerId,"targetOwnerId",512)}:{},sourceLeaseEpoch:r.epoch,...t.workspace?{workspace:u(t.workspace,"workspace",32768)}:{},...t.branch?{branch:u(t.branch,"branch",1024)}:{},...t.currentMilestoneId?{currentMilestoneId:t.currentMilestoneId}:{},...t.currentTaskId?{currentTaskId:t.currentTaskId}:{},agentIds:[...new Set(t.agentIds??[])],operations:w(t.operations??[]),...t.contextDigest?{contextDigest:u(t.contextDigest,"contextDigest",512)}:{},createdAt:o,updatedAt:o};return s.handoffs.push(i),this.appendEvent(s,"handoff.created",{handoffId:i.id,goalId:i.goalId,loopId:i.loopId,ownerId:r.ownerId,data:{targetOwnerId:i.targetOwnerId}}),i})}async claimHandoff(t){let s;return{handoff:await this.mutate(t.sessionId,e=>{let n=e.handoffs.find(a=>a.id===t.handoffId);if(!n)throw new p("NOT_FOUND",`Handoff ${t.handoffId} was not found`);if(n.status!=="available")throw new p("CONFLICT",`Handoff ${n.id} is ${n.status}`,{claimedBy:n.claimedBy});if(n.targetOwnerId&&n.targetOwnerId!==t.targetOwnerId)throw new p("CONFLICT",`Handoff ${n.id} is reserved for ${n.targetOwnerId}`);let o=e.owner;if(!o||o.ownerId!==n.sourceOwnerId||o.epoch!==n.sourceLeaseEpoch)throw new p("CONFLICT",`Handoff ${n.id} no longer matches the source ownership epoch`);let i=this.now();return s=this.newOwner(t.targetOwnerId,o.epoch+1,{processId:t.processId,host:t.host},i),e.owner=s,e.ownershipEpoch=s.epoch,n.status="claimed",n.claimedBy=t.targetOwnerId,n.targetOwnerId=t.targetOwnerId,n.targetLeaseEpoch=s.epoch,n.claimedAt=i,n.updatedAt=i,n.version+=1,this.appendEvent(e,"handoff.claimed",{handoffId:n.id,goalId:n.goalId,loopId:n.loopId,ownerId:t.targetOwnerId,data:{sourceOwnerId:n.sourceOwnerId,epoch:s.epoch}}),n}),owner:w(s)}}async completeHandoff(t,s,r,e){return this.mutate(t,n=>{this.requireOwner(n,r,e);let o=n.handoffs.find(i=>i.id===s);if(!o)throw new p("NOT_FOUND",`Handoff ${s} was not found`);if(o.status!=="claimed"||o.claimedBy!==r)throw new p("CONFLICT",`Handoff ${o.id} cannot be completed by ${r}`);return o.status="completed",o.completedAt=this.now(),o.updatedAt=o.completedAt,o.version+=1,this.appendEvent(n,"handoff.completed",{handoffId:s,goalId:o.goalId,loopId:o.loopId,ownerId:r,data:{epoch:n.owner?.epoch}}),o})}async failHandoff(t,s,r){return this.mutate(t,e=>{let n=e.handoffs.find(o=>o.id===s);if(!n)throw new p("NOT_FOUND",`Handoff ${s} was not found`);return["completed","cancelled","failed"].includes(n.status)||(n.status="failed",n.failureReason=u(r,"reason"),n.failedAt=this.now(),n.updatedAt=n.failedAt,n.version+=1,this.appendEvent(e,"handoff.failed",{handoffId:s,goalId:n.goalId,loopId:n.loopId,data:{reason:n.failureReason}})),n})}async mutateGoal(t,s,r,e,n=!0){return this.mutate(t,o=>{let i=this.requireGoal(o,s);this.assertVersion(i.id,i.version,r);let a=this.now();return e(i,a,o),i.version+=1,i.updatedAt=a,n&&this.appendEvent(o,"goal.updated",{goalId:s,data:{status:i.status,version:i.version}}),i})}async mutateLoop(t,s,r,e,n=!0){return this.mutate(t,o=>{let i=o.loops.find(c=>c.id===s);if(!i)throw new p("NOT_FOUND",`Loop ${s} was not found`);this.assertVersion(i.id,i.version,r);let a=this.now();return e(i,a,o),i.version+=1,i.updatedAt=a,n&&this.appendEvent(o,"loop.iteration",{loopId:s,goalId:i.goalId,data:{status:i.status,version:i.version}}),i})}recalculateProgress(t,s){let r=t.tasks.filter(e=>e.status==="completed").length;t.progress.completedTaskCount=r,t.progress.totalTaskCount=t.tasks.length,t.progress.percent=t.tasks.length?Math.round(r/t.tasks.length*100):void 0,t.progress.outstanding=t.tasks.filter(e=>!["completed","cancelled"].includes(e.status)).map(e=>e.title),t.progress.updatedAt=s}requireGoal(t,s){let r=t.goals.find(e=>e.id===s);if(!r)throw new p("NOT_FOUND",`Goal ${s} was not found`);return r}requireOwner(t,s,r){let e=t.owner;if(!e||e.ownerId!==s||e.leaseId!==r)throw new p("NOT_OWNER",`${s} does not own session ${t.sessionId}`,{owner:e});return e}assertVersion(t,s,r){if(!Number.isInteger(r)||r<1||s!==r)throw new p("CONFLICT",`Expected ${t} version ${r}, found ${s}`,{expected:r,actual:s})}newOwner(t,s,r,e){let n=r.leaseMs??this.ownerLeaseMs;if(!Number.isSafeInteger(n)||n<1)throw new p("INVALID","leaseMs must be a positive safe integer");return{ownerId:u(t,"ownerId",512),leaseId:this.idFactory("owner"),epoch:s,acquiredAt:e,heartbeatAt:e,expiresAt:new Date(E(e)+n).toISOString(),...r.processId!==void 0?{processId:r.processId}:{},...r.host?{host:u(r.host,"host",512)}:{}}}ownerExpired(t,s){return E(t.expiresAt)<=E(s)?!0:t.processId!==void 0&&t.host===A.hostname()&&!R(t.processId)}appendEvent(t,s,r){let e={schemaVersion:1,id:this.idFactory("event"),sequence:(t.events.at(-1)?.sequence??0)+1,type:s,sessionId:t.sessionId,...r.goalId?{goalId:r.goalId}:{},...r.loopId?{loopId:r.loopId}:{},...r.handoffId?{handoffId:r.handoffId}:{},...r.ownerId?{ownerId:r.ownerId}:{},timestamp:this.now(),data:w(r.data)};t.events.push(e),t.events.length>this.maximumEventsPerSession&&t.events.splice(0,t.events.length-this.maximumEventsPerSession)}async mutate(t,s){let r=u(t,"sessionId",1024);return this.withSessionLock(r,async()=>{let e=await this.readState(r),n=s(e);return e.version+=1,e.updatedAt=this.now(),await this.writeState(e),w(n)})}statePath(t){return m.join(this.rootDirectory,"sessions",`${W(t)}.json`)}lockPath(t){return`${this.statePath(t)}.lock`}async readState(t){let s=this.statePath(t);try{let r=await f.readFile(s,"utf8"),e=JSON.parse(r);if(e.schemaVersion!==1||e.sessionId!==t)throw new p("INVALID",`Coordination state at ${s} does not match session ${t}`);return(!Number.isSafeInteger(e.ownershipEpoch)||e.ownershipEpoch<0)&&(e.ownershipEpoch=Math.max(e.owner?.epoch??0,...e.handoffs.map(n=>n.targetLeaseEpoch??n.sourceLeaseEpoch??0))),e}catch(r){if(r.code!=="ENOENT")throw r;let e=this.now();return{schemaVersion:1,sessionId:t,version:0,ownershipEpoch:0,goals:[],loops:[],handoffs:[],events:[],createdAt:e,updatedAt:e}}}async writeState(t){let s=this.statePath(t.sessionId),r=m.dirname(s);await f.mkdir(r,{recursive:!0});let e=`${s}.${process.pid}.${X()}.tmp`,n=await f.open(e,"wx");try{await n.writeFile(`${JSON.stringify(t,null,2)}
+`,"utf8"),await n.sync()}finally{await n.close()}try{await this.renameReplacing(e,s);try{let o=await f.open(r,"r");try{await o.sync()}finally{await o.close()}}catch{}}finally{await f.unlink(e).catch(()=>{})}}async renameReplacing(t,s){for(let r=0;;r+=1)try{await f.rename(t,s);return}catch(e){let n=e.code,o=T[r];if(process.platform!=="win32"||!n||!b.has(n)||o===void 0)throw e;await new Promise(i=>setTimeout(i,o))}}async withSessionLock(t,s){let r=this.lockPath(t),e=m.join(r,"owner.json"),n=X(),o=`${r}.candidate.${n}`,i=Date.now();await f.mkdir(m.dirname(r),{recursive:!0});let a={schemaVersion:1,token:n,pid:process.pid,host:A.hostname(),acquiredAt:this.now()};await f.mkdir(o),await f.writeFile(m.join(o,"owner.json"),JSON.stringify(a),{encoding:"utf8",flag:"wx"});for(let c=0;;c+=1)try{await f.rename(o,r);break}catch(l){let g=l.code;if(!(g==="EEXIST"||process.platform==="win32"&&!!g&&b.has(g)))throw await f.rm(o,{recursive:!0,force:!0}).catch(()=>{}),l;let C=await this.staleLockOwner(r,e);if(C){await this.quarantineLock(r,C.token,"stale");continue}if(Date.now()-i>=this.lockTimeoutMs)throw await f.rm(o,{recursive:!0,force:!0}).catch(()=>{}),new p("CONFLICT",`Timed out waiting for coordination lock for session ${t}`);await new Promise(M=>setTimeout(M,Math.min(100,5+c*5)+Math.floor(Math.random()*10)))}try{return await s()}finally{await this.quarantineLock(r,n,"released"),await f.rm(o,{recursive:!0,force:!0}).catch(()=>{})}}async staleLockOwner(t,s){try{let[r,e]=await Promise.all([f.readFile(s,"utf8").catch(()=>""),f.stat(t)]),n=r?JSON.parse(r):void 0;return!n||n.host===A.hostname()&&R(n.pid)?void 0:Date.now()-e.mtimeMs>this.lockStaleMs?n:void 0}catch{return}}async quarantineLock(t,s,r){let e=m.join(t,"owner.json"),n=`${t}.${r}.${s}.${X()}`;for(let o=0;;o+=1){let i;try{i=JSON.parse(await f.readFile(e,"utf8"))}catch(a){if(a.code==="ENOENT")return;throw a}if(i.token!==s)return;try{await f.rename(t,n);break}catch(a){let c=a.code;if(c==="ENOENT"||c==="EEXIST")return;let l=T[o];if(process.platform!=="win32"||!c||!b.has(c)||l===void 0)throw a;await new Promise(g=>setTimeout(g,l))}}for(let o=0;;o+=1)try{await f.rm(n,{recursive:!0});return}catch(i){let a=i.code;if(a==="ENOENT")return;let c=q[o];if(process.platform!=="win32"||!a||!b.has(a)||c===void 0)throw i;await new Promise(l=>setTimeout(l,c))}}};function O(d,t){if(!d||typeof d!="object"||Array.isArray(d))throw new Error(`${t} must be an object`);return d}function h(d,t){if(typeof d!="string"||!d.trim())throw new Error(`${t} must be a non-empty string`);return d}function v(d,t){if(typeof d!="number"||!Number.isInteger(d))throw new Error(`${t} must be an integer`);return d}async function de(d,t){let{action:s,sessionId:r}=t,e=t.payload??{},n;switch(s){case"state.get":n=await d.getSessionState(r);break;case"goal.create":n=await d.createGoal({sessionId:r,...e});break;case"goal.update":n=await d.updateGoal(r,h(e.goalId,"goalId"),v(e.expectedVersion,"expectedVersion"),O(e.update,"update"));break;case"goal.complete":n=await d.completeGoal(r,h(e.goalId,"goalId"),v(e.expectedVersion,"expectedVersion"),O(e.verification,"verification"));break;case"goal.cancel":n=await d.cancelGoal(r,h(e.goalId,"goalId"),v(e.expectedVersion,"expectedVersion"),h(e.reason,"reason"));break;case"goal.steer":n=await d.steerGoal(r,h(e.goalId,"goalId"),v(e.expectedVersion,"expectedVersion"),h(e.instruction,"instruction"));break;case"loop.start":n=await d.startLoop({sessionId:r,kind:h(e.kind,"kind"),...typeof e.goalId=="string"?{goalId:e.goalId}:{},...typeof e.activity=="string"?{activity:e.activity}:{},...e.schedule?{schedule:O(e.schedule,"schedule")}:{}});break;case"loop.get":n=await d.getLoop(r,typeof e.loopId=="string"?e.loopId:void 0);break;case"loop.begin":n=await d.beginLoopIteration(r,h(e.loopId,"loopId"),v(e.expectedVersion,"expectedVersion"),h(e.activity,"activity"),typeof e.taskId=="string"?e.taskId:void 0);break;case"loop.finish":n=await d.finishLoopIteration(r,h(e.loopId,"loopId"),v(e.expectedVersion,"expectedVersion"),O(e.result,"result"));break;case"loop.set_status":n=await d.setLoopStatus(r,h(e.loopId,"loopId"),v(e.expectedVersion,"expectedVersion"),h(e.status,"status"),typeof e.reason=="string"?e.reason:void 0);break;case"ownership.acquire":n=await d.acquireOwnership(r,h(e.ownerId,"ownerId"),O(e.options??{},"options"));break;case"ownership.renew":n=await d.renewOwnership(r,h(e.ownerId,"ownerId"),h(e.leaseId,"leaseId"),typeof e.leaseMs=="number"?e.leaseMs:void 0);break;case"ownership.release":n=await d.releaseOwnership(r,h(e.ownerId,"ownerId"),h(e.leaseId,"leaseId"));break;case"handoff.create":n=await d.createHandoff({sessionId:r,...e});break;case"handoff.claim":n=await d.claimHandoff({sessionId:r,handoffId:h(e.handoffId,"handoffId"),targetOwnerId:h(e.targetOwnerId,"targetOwnerId"),...typeof e.processId=="number"?{processId:e.processId}:{},...typeof e.host=="string"?{host:e.host}:{}});break;case"handoff.complete":n=await d.completeHandoff(r,h(e.handoffId,"handoffId"),h(e.ownerId,"ownerId"),h(e.leaseId,"leaseId"));break;case"handoff.fail":n=await d.failHandoff(r,h(e.handoffId,"handoffId"),h(e.reason,"reason"));break}let o=await d.getSessionState(r),i=s==="state.get"||s==="loop.get"?void 0:o.events.at(-1);return{action:s,sessionId:r,result:n,state:o,...i?{event:i}:{}}}import{randomUUID as K}from"node:crypto";import{hostname as Q}from"node:os";var G=class{sessionId;ownerId;store;processId;host;leaseMs;heartbeatMs;claimHandoffId;onOwnershipLost;timer;heartbeatInFlight=!1;owner;stopped=!1;lostError;preparedHandoffId;constructor(t){if(this.store=t.store??new S,this.sessionId=t.sessionId,this.processId=t.processId??process.pid,this.host=t.host??Q(),this.ownerId=t.ownerId??`runtime:${this.host}:${this.processId}:${K().slice(0,8)}`,this.leaseMs=t.leaseMs??3e4,this.heartbeatMs=t.heartbeatMs??Math.max(250,Math.floor(this.leaseMs/3)),this.heartbeatMs>=this.leaseMs)throw new Error("heartbeatMs must be shorter than leaseMs");this.claimHandoffId=t.claimHandoffId,this.onOwnershipLost=t.onOwnershipLost}get currentOwner(){return this.owner?structuredClone(this.owner):void 0}get active(){return!!this.owner&&!this.stopped&&this.lostError===void 0}async start(){if(this.owner)return structuredClone(this.owner);if(this.stopped)throw new Error("Execution lease session has already stopped");if(this.claimHandoffId){let t=await this.store.claimHandoff({sessionId:this.sessionId,handoffId:this.claimHandoffId,targetOwnerId:this.ownerId,processId:this.processId,host:this.host});this.owner=t.owner,await this.store.completeHandoff(this.sessionId,this.claimHandoffId,this.ownerId,this.owner.leaseId)}else this.owner=await this.store.acquireOwnership(this.sessionId,this.ownerId,{processId:this.processId,host:this.host,leaseMs:this.leaseMs});return this.timer=setInterval(()=>{this.heartbeat()},this.heartbeatMs),this.timer.unref?.(),structuredClone(this.owner)}async assertOwned(){if(this.stopped)throw new Error("Execution surface is detached");if(this.lostError)throw this.lostError;if(this.preparedHandoffId)throw new Error(`Execution surface prepared handoff ${this.preparedHandoffId} and is detached from mutation`);if(!this.owner)throw new Error("Execution ownership was not started");return this.renewHeldLease()}async renewHeldLease(){if(!this.owner)throw new Error("Execution ownership was not started");try{return this.owner=await this.store.renewOwnership(this.sessionId,this.ownerId,this.owner.leaseId,this.leaseMs),structuredClone(this.owner)}catch(t){throw this.markLost(t),t}}async prepareHandoff(t={}){if(this.preparedHandoffId)throw new Error(`Handoff ${this.preparedHandoffId} is already prepared`);let s=await this.assertOwned(),r=await this.store.createHandoff({...t,sessionId:this.sessionId,sourceOwnerId:s.ownerId,sourceLeaseId:s.leaseId});return this.preparedHandoffId=r.id,r}async stop(t={}){if(this.stopped)return;this.stopped=!0,this.timer&&clearInterval(this.timer),this.timer=void 0;let s=this.owner;if(this.owner=void 0,!(t.release===!1||this.preparedHandoffId||!s||this.lostError))try{await this.store.releaseOwnership(this.sessionId,s.ownerId,s.leaseId)}catch{}}async heartbeat(){if(!(!this.active||this.heartbeatInFlight)){this.heartbeatInFlight=!0;try{await this.renewHeldLease()}catch(t){this.markLost(t)}finally{this.heartbeatInFlight=!1}}}markLost(t){this.lostError===void 0&&(this.lostError=t,this.timer&&clearInterval(this.timer),this.timer=void 0,this.onOwnershipLost?.(t))}};export{S as DurableXenoCoordinationStore,I as XENO_COORDINATION_SCHEMA_VERSION,p as XenoCoordinationError,G as XenoExecutionLeaseSession,de as executeXenoCoordinationAction};

package/dist/coordination/metafile-cjs.json

@@ -0,0 +1 @@
+{"inputs":{"src/coordination/types.ts":{"bytes":7186,"imports":[],"format":"esm"},"src/utils/platform.ts":{"bytes":5600,"imports":[{"path":"node:os","kind":"import-statement","external":true},{"path":"node:child_process","kind":"import-statement","external":true},{"path":"node:path","kind":"import-statement","external":true}],"format":"esm"},"src/coordination/store.ts":{"bytes":50651,"imports":[{"path":"node:crypto","kind":"import-statement","external":true},{"path":"node:fs/promises","kind":"import-statement","external":true},{"path":"node:os","kind":"import-statement","external":true},{"path":"node:path","kind":"import-statement","external":true},{"path":"src/utils/platform.ts","kind":"import-statement","original":"../utils/platform.js"},{"path":"src/coordination/types.ts","kind":"import-statement","original":"./types.js"}],"format":"esm"},"src/coordination/runtime.ts":{"bytes":6174,"imports":[{"path":"./store.js","kind":"import-statement","external":true}],"format":"esm"},"src/coordination/lease.ts":{"bytes":5947,"imports":[{"path":"node:crypto","kind":"import-statement","external":true},{"path":"node:os","kind":"import-statement","external":true},{"path":"src/coordination/store.ts","kind":"import-statement","original":"./store.js"}],"format":"esm"},"src/coordination/index.ts":{"bytes":114,"imports":[{"path":"src/coordination/types.ts","kind":"import-statement","original":"./types.js"},{"path":"src/coordination/store.ts","kind":"import-statement","original":"./store.js"},{"path":"src/coordination/runtime.ts","kind":"import-statement","original":"./runtime.js"},{"path":"src/coordination/lease.ts","kind":"import-statement","original":"./lease.js"}],"format":"esm"}},"outputs":{"dist/coordination/index.cjs":{"imports":[{"path":"node:crypto","kind":"require-call","external":true},{"path":"node:fs/promises","kind":"require-call","external":true},{"path":"node:os","kind":"require-call","external":true},{"path":"node:path","kind":"require-call","external":true},{"path":"node:os","kind":"require-call","external":true},{"path":"node:path","kind":"require-call","external":true},{"path":"node:crypto","kind":"require-call","external":true},{"path":"node:os","kind":"require-call","external":true}],"exports":[],"entryPoint":"src/coordination/index.ts","inputs":{"src/coordination/index.ts":{"bytesInOutput":210},"src/coordination/types.ts":{"bytesInOutput":136},"src/coordination/store.ts":{"bytesInOutput":23981},"src/utils/platform.ts":{"bytesInOutput":240},"src/coordination/runtime.ts":{"bytesInOutput":2957},"src/coordination/lease.ts":{"bytesInOutput":3143}},"bytes":31400}}}

package/dist/coordination/metafile-esm.json

@@ -0,0 +1 @@
+{"inputs":{"src/coordination/types.ts":{"bytes":7186,"imports":[],"format":"esm"},"src/utils/platform.ts":{"bytes":5600,"imports":[{"path":"node:os","kind":"import-statement","external":true},{"path":"node:child_process","kind":"import-statement","external":true},{"path":"node:path","kind":"import-statement","external":true}],"format":"esm"},"src/coordination/store.ts":{"bytes":50651,"imports":[{"path":"node:crypto","kind":"import-statement","external":true},{"path":"node:fs/promises","kind":"import-statement","external":true},{"path":"node:os","kind":"import-statement","external":true},{"path":"node:path","kind":"import-statement","external":true},{"path":"src/utils/platform.ts","kind":"import-statement","original":"../utils/platform.js"},{"path":"src/coordination/types.ts","kind":"import-statement","original":"./types.js"}],"format":"esm"},"src/coordination/runtime.ts":{"bytes":6174,"imports":[{"path":"./store.js","kind":"import-statement","external":true}],"format":"esm"},"src/coordination/lease.ts":{"bytes":5947,"imports":[{"path":"node:crypto","kind":"import-statement","external":true},{"path":"node:os","kind":"import-statement","external":true},{"path":"src/coordination/store.ts","kind":"import-statement","original":"./store.js"}],"format":"esm"},"src/coordination/index.ts":{"bytes":114,"imports":[{"path":"src/coordination/types.ts","kind":"import-statement","original":"./types.js"},{"path":"src/coordination/store.ts","kind":"import-statement","original":"./store.js"},{"path":"src/coordination/runtime.ts","kind":"import-statement","original":"./runtime.js"},{"path":"src/coordination/lease.ts","kind":"import-statement","original":"./lease.js"}],"format":"esm"}},"outputs":{"dist/coordination/index.js":{"imports":[{"path":"node:crypto","kind":"import-statement","external":true},{"path":"node:fs/promises","kind":"import-statement","external":true},{"path":"node:os","kind":"import-statement","external":true},{"path":"node:path","kind":"import-statement","external":true},{"path":"node:os","kind":"import-statement","external":true},{"path":"node:path","kind":"import-statement","external":true},{"path":"node:crypto","kind":"import-statement","external":true},{"path":"node:os","kind":"import-statement","external":true}],"exports":["DurableXenoCoordinationStore","XENO_COORDINATION_SCHEMA_VERSION","XenoCoordinationError","XenoExecutionLeaseSession","executeXenoCoordinationAction"],"entryPoint":"src/coordination/index.ts","inputs":{"src/coordination/types.ts":{"bytesInOutput":136},"src/coordination/index.ts":{"bytesInOutput":0},"src/coordination/store.ts":{"bytesInOutput":23927},"src/utils/platform.ts":{"bytesInOutput":216},"src/coordination/runtime.ts":{"bytesInOutput":2957},"src/coordination/lease.ts":{"bytesInOutput":3141}},"bytes":30552}}}