@pinet/agent-goal 0.2.6

package/dist/sqlite-storage.d.ts

@@ -0,0 +1,23 @@
+import type { AgentGoal, GoalContinuationClaim, GoalPendingEvaluation, GoalStorage, GoalTerminalCandidateRecord } from "./domain.js";
+export declare class SqliteGoalStorage implements GoalStorage {
+    private readonly db;
+    constructor(path: string);
+    get(scopeId: string): Promise<AgentGoal | undefined>;
+    create(goal: AgentGoal): Promise<void>;
+    replace(goal: AgentGoal, expectedVersion: number): Promise<boolean>;
+    delete(scopeId: string, expectedVersion: number): Promise<boolean>;
+    getPendingEvaluation(scopeId: string): Promise<GoalPendingEvaluation | undefined>;
+    appendPendingEvaluation(pending: GoalPendingEvaluation): Promise<boolean>;
+    putPendingEvaluation(pending: GoalPendingEvaluation): Promise<boolean>;
+    replacePendingEvaluation(pending: GoalPendingEvaluation, expectedEvaluationId: string): Promise<boolean>;
+    deletePendingEvaluation(scopeId: string, expectedEvaluationId: string): Promise<boolean>;
+    commitEvaluation(goal: AgentGoal, expectedGoalVersion: number, expectedEvaluationId: string): Promise<boolean>;
+    getTerminalCandidate(scopeId: string): Promise<GoalTerminalCandidateRecord | undefined>;
+    putTerminalCandidate(candidate: GoalTerminalCandidateRecord): Promise<boolean>;
+    deleteTerminalCandidate(scopeId: string, expectedCandidateId: string): Promise<boolean>;
+    getContinuationClaim(scopeId: string): Promise<GoalContinuationClaim | undefined>;
+    createContinuationClaim(claim: GoalContinuationClaim): Promise<boolean>;
+    replaceContinuationClaim(claim: GoalContinuationClaim, expectedClaimId: string): Promise<boolean>;
+    deleteContinuationClaim(scopeId: string, expectedClaimId: string): Promise<boolean>;
+    close(): void;
+}

package/dist/sqlite-storage.js

@@ -0,0 +1,420 @@
+import { mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { DatabaseSync } from "node:sqlite";
+export class SqliteGoalStorage {
+    db;
+    constructor(path) {
+        mkdirSync(dirname(path), { recursive: true });
+        this.db = new DatabaseSync(path, { timeout: 5000 });
+        const goalTableSql = `CREATE TABLE IF NOT EXISTS agent_goals (
+      scope_id TEXT PRIMARY KEY NOT NULL,
+      id TEXT UNIQUE NOT NULL,
+      objective TEXT NOT NULL,
+      status TEXT NOT NULL CHECK (status IN ('active', 'paused', 'blocked', 'budget_limited', 'complete')),
+      blocked_reason TEXT,
+      max_iterations INTEGER NOT NULL DEFAULT 25,
+      max_tokens INTEGER,
+      max_runtime_ms INTEGER,
+      iterations_used INTEGER NOT NULL DEFAULT 0,
+      tokens_used INTEGER NOT NULL DEFAULT 0,
+      last_settled_at TEXT,
+      last_evaluation_id TEXT,
+      last_evaluation_outcome TEXT,
+      last_evaluation_reason TEXT,
+      last_evaluation_at TEXT,
+      version INTEGER NOT NULL,
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL
+    )`;
+        this.db.exec(`PRAGMA journal_mode = WAL; ${goalTableSql};`);
+        const columns = new Set(this.db.prepare("PRAGMA table_info(agent_goals)").all().map(({ name }) => name));
+        for (const [name, definition] of [
+            ["max_iterations", "INTEGER NOT NULL DEFAULT 25"],
+            ["max_tokens", "INTEGER"],
+            ["max_runtime_ms", "INTEGER"],
+            ["iterations_used", "INTEGER NOT NULL DEFAULT 0"],
+            ["tokens_used", "INTEGER NOT NULL DEFAULT 0"],
+            ["last_settled_at", "TEXT"],
+            ["last_evaluation_id", "TEXT"],
+            ["last_evaluation_outcome", "TEXT"],
+            ["last_evaluation_reason", "TEXT"],
+            ["last_evaluation_at", "TEXT"],
+        ]) {
+            if (!columns.has(name))
+                this.db.exec(`ALTER TABLE agent_goals ADD COLUMN ${name} ${definition}`);
+        }
+        const tableDefinition = this.db
+            .prepare("SELECT sql FROM sqlite_master WHERE type = 'table' AND name = 'agent_goals'")
+            .get();
+        if (!tableDefinition.sql.includes("budget_limited")) {
+            this.db.exec(`
+        PRAGMA foreign_keys = OFF;
+        BEGIN IMMEDIATE;
+        DROP TABLE IF EXISTS agent_goal_pending_evaluations;
+        DROP TABLE IF EXISTS agent_goal_continuations;
+        ALTER TABLE agent_goals RENAME TO agent_goals_legacy;
+        ${goalTableSql};
+        INSERT INTO agent_goals
+          (scope_id, id, objective, status, blocked_reason, max_iterations, max_tokens,
+           max_runtime_ms, iterations_used, tokens_used, last_settled_at,
+           last_evaluation_id, last_evaluation_outcome, last_evaluation_reason, last_evaluation_at,
+           version, created_at, updated_at)
+        SELECT scope_id, id, objective, status, blocked_reason, max_iterations, max_tokens,
+          max_runtime_ms, iterations_used, tokens_used, last_settled_at,
+          last_evaluation_id, last_evaluation_outcome, last_evaluation_reason, last_evaluation_at,
+          version, created_at, updated_at
+        FROM agent_goals_legacy;
+        DROP TABLE agent_goals_legacy;
+        COMMIT;
+        PRAGMA foreign_keys = ON;
+      `);
+        }
+        this.db.exec(`
+      PRAGMA foreign_keys = ON;
+      CREATE TABLE IF NOT EXISTS agent_goal_terminal_candidates (
+        scope_id TEXT PRIMARY KEY NOT NULL,
+        goal_id TEXT NOT NULL,
+        goal_version INTEGER NOT NULL,
+        candidate_id TEXT UNIQUE NOT NULL,
+        outcome TEXT NOT NULL CHECK (outcome IN ('complete', 'blocked')),
+        reason TEXT NOT NULL,
+        created_at TEXT NOT NULL,
+        FOREIGN KEY (scope_id) REFERENCES agent_goals(scope_id) ON DELETE CASCADE
+      );
+      CREATE TABLE IF NOT EXISTS agent_goal_pending_evaluations (
+        scope_id TEXT PRIMARY KEY NOT NULL,
+        goal_id TEXT NOT NULL,
+        goal_version INTEGER NOT NULL,
+        evaluation_id TEXT UNIQUE NOT NULL,
+        iterations_delta INTEGER NOT NULL DEFAULT 1,
+        latest_output TEXT NOT NULL,
+        token_delta INTEGER NOT NULL,
+        candidate_outcome TEXT CHECK (candidate_outcome IN ('complete', 'blocked')),
+        candidate_reason TEXT,
+        attempt INTEGER NOT NULL,
+        available_at TEXT NOT NULL,
+        last_error TEXT,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL,
+        FOREIGN KEY (scope_id) REFERENCES agent_goals(scope_id) ON DELETE CASCADE
+      );
+      CREATE TABLE IF NOT EXISTS agent_goal_continuations (
+        scope_id TEXT PRIMARY KEY NOT NULL,
+        goal_id TEXT NOT NULL,
+        goal_version INTEGER NOT NULL,
+        claim_id TEXT UNIQUE NOT NULL,
+        state TEXT NOT NULL CHECK (state IN ('claimed', 'deferred', 'started')),
+        reason TEXT NOT NULL,
+        attempt INTEGER NOT NULL,
+        available_at TEXT NOT NULL,
+        expires_at TEXT NOT NULL,
+        last_error TEXT,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL,
+        FOREIGN KEY (scope_id) REFERENCES agent_goals(scope_id) ON DELETE CASCADE
+      );
+    `);
+        const pendingColumns = new Set(this.db.prepare("PRAGMA table_info(agent_goal_pending_evaluations)").all().map(({ name }) => name));
+        if (!pendingColumns.has("iterations_delta")) {
+            this.db.exec("ALTER TABLE agent_goal_pending_evaluations ADD COLUMN iterations_delta INTEGER NOT NULL DEFAULT 1");
+        }
+        if (!pendingColumns.has("candidate_outcome")) {
+            this.db.exec("ALTER TABLE agent_goal_pending_evaluations ADD COLUMN candidate_outcome TEXT CHECK (candidate_outcome IN ('complete', 'blocked'))");
+        }
+        if (!pendingColumns.has("candidate_reason")) {
+            this.db.exec("ALTER TABLE agent_goal_pending_evaluations ADD COLUMN candidate_reason TEXT");
+        }
+    }
+    async get(scopeId) {
+        const row = this.db.prepare("SELECT * FROM agent_goals WHERE scope_id = ?").get(scopeId);
+        if (!row)
+            return undefined;
+        return {
+            id: row.id,
+            scopeId: row.scope_id,
+            objective: row.objective,
+            status: row.status,
+            blockedReason: row.blocked_reason ?? undefined,
+            budget: {
+                maxIterations: row.max_iterations,
+                maxTokens: row.max_tokens ?? undefined,
+                maxRuntimeMs: row.max_runtime_ms ?? undefined,
+            },
+            usage: { iterations: row.iterations_used, tokens: row.tokens_used },
+            lastSettledAt: row.last_settled_at ?? undefined,
+            lastEvaluation: row.last_evaluation_id &&
+                row.last_evaluation_outcome &&
+                row.last_evaluation_reason &&
+                row.last_evaluation_at
+                ? {
+                    id: row.last_evaluation_id,
+                    outcome: row.last_evaluation_outcome,
+                    reason: row.last_evaluation_reason,
+                    at: row.last_evaluation_at,
+                }
+                : undefined,
+            version: row.version,
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+        };
+    }
+    async create(goal) {
+        this.db
+            .prepare(`INSERT INTO agent_goals
+          (scope_id, id, objective, status, blocked_reason, max_iterations, max_tokens,
+           max_runtime_ms, iterations_used, tokens_used, last_settled_at,
+           last_evaluation_id, last_evaluation_outcome, last_evaluation_reason, last_evaluation_at,
+           version, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+            .run(goal.scopeId, goal.id, goal.objective, goal.status, goal.blockedReason ?? null, goal.budget.maxIterations, goal.budget.maxTokens ?? null, goal.budget.maxRuntimeMs ?? null, goal.usage.iterations, goal.usage.tokens, goal.lastSettledAt ?? null, goal.lastEvaluation?.id ?? null, goal.lastEvaluation?.outcome ?? null, goal.lastEvaluation?.reason ?? null, goal.lastEvaluation?.at ?? null, goal.version, goal.createdAt, goal.updatedAt);
+    }
+    async replace(goal, expectedVersion) {
+        const result = this.db
+            .prepare(`UPDATE agent_goals SET objective = ?, status = ?, blocked_reason = ?,
+         max_iterations = ?, max_tokens = ?, max_runtime_ms = ?, iterations_used = ?,
+         tokens_used = ?, last_settled_at = ?, last_evaluation_id = ?,
+         last_evaluation_outcome = ?, last_evaluation_reason = ?, last_evaluation_at = ?,
+         version = ?, updated_at = ?
+         WHERE scope_id = ? AND id = ? AND version = ?`)
+            .run(goal.objective, goal.status, goal.blockedReason ?? null, goal.budget.maxIterations, goal.budget.maxTokens ?? null, goal.budget.maxRuntimeMs ?? null, goal.usage.iterations, goal.usage.tokens, goal.lastSettledAt ?? null, goal.lastEvaluation?.id ?? null, goal.lastEvaluation?.outcome ?? null, goal.lastEvaluation?.reason ?? null, goal.lastEvaluation?.at ?? null, goal.version, goal.updatedAt, goal.scopeId, goal.id, expectedVersion);
+        return result.changes === 1;
+    }
+    async delete(scopeId, expectedVersion) {
+        const result = this.db
+            .prepare("DELETE FROM agent_goals WHERE scope_id = ? AND version = ?")
+            .run(scopeId, expectedVersion);
+        return result.changes === 1;
+    }
+    async getPendingEvaluation(scopeId) {
+        const row = this.db
+            .prepare("SELECT * FROM agent_goal_pending_evaluations WHERE scope_id = ?")
+            .get(scopeId);
+        return row
+            ? {
+                scopeId: row.scope_id,
+                goalId: row.goal_id,
+                goalVersion: row.goal_version,
+                evaluationId: row.evaluation_id,
+                iterationsDelta: row.iterations_delta,
+                progress: {
+                    latestOutput: row.latest_output,
+                    tokenDelta: row.token_delta,
+                    terminalCandidate: row.candidate_outcome && row.candidate_reason
+                        ? { outcome: row.candidate_outcome, reason: row.candidate_reason }
+                        : undefined,
+                },
+                attempt: row.attempt,
+                availableAt: row.available_at,
+                lastError: row.last_error ?? undefined,
+                createdAt: row.created_at,
+                updatedAt: row.updated_at,
+            }
+            : undefined;
+    }
+    async appendPendingEvaluation(pending) {
+        const result = this.db
+            .prepare(`INSERT INTO agent_goal_pending_evaluations
+         (scope_id, goal_id, goal_version, evaluation_id, iterations_delta, latest_output,
+          token_delta, candidate_outcome, candidate_reason, attempt, available_at, last_error,
+          created_at, updated_at)
+         SELECT ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?
+         WHERE EXISTS (
+           SELECT 1 FROM agent_goals WHERE scope_id = ? AND id = ? AND version = ?
+         )
+         ON CONFLICT(scope_id) DO UPDATE SET goal_id = excluded.goal_id,
+           goal_version = excluded.goal_version, evaluation_id = excluded.evaluation_id,
+           iterations_delta = CASE
+             WHEN agent_goal_pending_evaluations.goal_id = excluded.goal_id
+              AND agent_goal_pending_evaluations.goal_version = excluded.goal_version
+             THEN agent_goal_pending_evaluations.iterations_delta + excluded.iterations_delta
+             ELSE excluded.iterations_delta END,
+           latest_output = excluded.latest_output,
+           token_delta = CASE
+             WHEN agent_goal_pending_evaluations.goal_id = excluded.goal_id
+              AND agent_goal_pending_evaluations.goal_version = excluded.goal_version
+             THEN agent_goal_pending_evaluations.token_delta + excluded.token_delta
+             ELSE excluded.token_delta END,
+           candidate_outcome = CASE
+             WHEN agent_goal_pending_evaluations.goal_id = excluded.goal_id
+              AND agent_goal_pending_evaluations.goal_version = excluded.goal_version
+             THEN COALESCE(excluded.candidate_outcome,
+               agent_goal_pending_evaluations.candidate_outcome)
+             ELSE excluded.candidate_outcome END,
+           candidate_reason = CASE
+             WHEN agent_goal_pending_evaluations.goal_id = excluded.goal_id
+              AND agent_goal_pending_evaluations.goal_version = excluded.goal_version
+             THEN COALESCE(excluded.candidate_reason,
+               agent_goal_pending_evaluations.candidate_reason)
+             ELSE excluded.candidate_reason END,
+           attempt = excluded.attempt, available_at = excluded.available_at,
+           last_error = excluded.last_error,
+           created_at = CASE
+             WHEN agent_goal_pending_evaluations.goal_id = excluded.goal_id
+              AND agent_goal_pending_evaluations.goal_version = excluded.goal_version
+             THEN agent_goal_pending_evaluations.created_at ELSE excluded.created_at END,
+           updated_at = excluded.updated_at`)
+            .run(pending.scopeId, pending.goalId, pending.goalVersion, pending.evaluationId, pending.iterationsDelta, pending.progress.latestOutput, pending.progress.tokenDelta ?? 0, pending.progress.terminalCandidate?.outcome ?? null, pending.progress.terminalCandidate?.reason ?? null, pending.attempt, pending.availableAt, pending.lastError ?? null, pending.createdAt, pending.updatedAt, pending.scopeId, pending.goalId, pending.goalVersion);
+        return result.changes === 1;
+    }
+    async putPendingEvaluation(pending) {
+        const result = this.db
+            .prepare(`INSERT INTO agent_goal_pending_evaluations
+         (scope_id, goal_id, goal_version, evaluation_id, iterations_delta, latest_output,
+          token_delta, candidate_outcome, candidate_reason, attempt, available_at, last_error,
+          created_at, updated_at)
+         SELECT ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?
+         WHERE EXISTS (
+           SELECT 1 FROM agent_goals WHERE scope_id = ? AND id = ? AND version = ?
+         )
+         ON CONFLICT(scope_id) DO UPDATE SET goal_id = excluded.goal_id,
+           goal_version = excluded.goal_version, evaluation_id = excluded.evaluation_id,
+           iterations_delta = excluded.iterations_delta,
+           latest_output = excluded.latest_output, token_delta = excluded.token_delta,
+           candidate_outcome = excluded.candidate_outcome,
+           candidate_reason = excluded.candidate_reason, attempt = excluded.attempt,
+           available_at = excluded.available_at,
+           last_error = excluded.last_error, created_at = excluded.created_at,
+           updated_at = excluded.updated_at`)
+            .run(pending.scopeId, pending.goalId, pending.goalVersion, pending.evaluationId, pending.iterationsDelta, pending.progress.latestOutput, pending.progress.tokenDelta ?? 0, pending.progress.terminalCandidate?.outcome ?? null, pending.progress.terminalCandidate?.reason ?? null, pending.attempt, pending.availableAt, pending.lastError ?? null, pending.createdAt, pending.updatedAt, pending.scopeId, pending.goalId, pending.goalVersion);
+        return result.changes === 1;
+    }
+    async replacePendingEvaluation(pending, expectedEvaluationId) {
+        const result = this.db
+            .prepare(`UPDATE agent_goal_pending_evaluations SET goal_id = ?, goal_version = ?,
+         evaluation_id = ?, iterations_delta = ?, latest_output = ?, token_delta = ?,
+         candidate_outcome = ?, candidate_reason = ?, attempt = ?, available_at = ?,
+         last_error = ?, created_at = ?, updated_at = ?
+         WHERE scope_id = ? AND evaluation_id = ? AND EXISTS (
+           SELECT 1 FROM agent_goals WHERE scope_id = ? AND id = ? AND version = ?
+         )`)
+            .run(pending.goalId, pending.goalVersion, pending.evaluationId, pending.iterationsDelta, pending.progress.latestOutput, pending.progress.tokenDelta ?? 0, pending.progress.terminalCandidate?.outcome ?? null, pending.progress.terminalCandidate?.reason ?? null, pending.attempt, pending.availableAt, pending.lastError ?? null, pending.createdAt, pending.updatedAt, pending.scopeId, expectedEvaluationId, pending.scopeId, pending.goalId, pending.goalVersion);
+        return result.changes === 1;
+    }
+    async deletePendingEvaluation(scopeId, expectedEvaluationId) {
+        const result = this.db
+            .prepare("DELETE FROM agent_goal_pending_evaluations WHERE scope_id = ? AND evaluation_id = ?")
+            .run(scopeId, expectedEvaluationId);
+        return result.changes === 1;
+    }
+    async commitEvaluation(goal, expectedGoalVersion, expectedEvaluationId) {
+        this.db.exec("BEGIN IMMEDIATE");
+        try {
+            const updated = this.db
+                .prepare(`UPDATE agent_goals SET objective = ?, status = ?, blocked_reason = ?,
+           max_iterations = ?, max_tokens = ?, max_runtime_ms = ?, iterations_used = ?,
+           tokens_used = ?, last_settled_at = ?, last_evaluation_id = ?,
+           last_evaluation_outcome = ?, last_evaluation_reason = ?, last_evaluation_at = ?,
+           version = ?, updated_at = ?
+           WHERE scope_id = ? AND id = ? AND version = ? AND EXISTS (
+             SELECT 1 FROM agent_goal_pending_evaluations
+             WHERE scope_id = ? AND evaluation_id = ?
+           )`)
+                .run(goal.objective, goal.status, goal.blockedReason ?? null, goal.budget.maxIterations, goal.budget.maxTokens ?? null, goal.budget.maxRuntimeMs ?? null, goal.usage.iterations, goal.usage.tokens, goal.lastSettledAt ?? null, goal.lastEvaluation?.id ?? null, goal.lastEvaluation?.outcome ?? null, goal.lastEvaluation?.reason ?? null, goal.lastEvaluation?.at ?? null, goal.version, goal.updatedAt, goal.scopeId, goal.id, expectedGoalVersion, goal.scopeId, expectedEvaluationId);
+            if (updated.changes !== 1) {
+                this.db.exec("ROLLBACK");
+                return false;
+            }
+            const deleted = this.db
+                .prepare("DELETE FROM agent_goal_pending_evaluations WHERE scope_id = ? AND evaluation_id = ?")
+                .run(goal.scopeId, expectedEvaluationId);
+            if (deleted.changes !== 1) {
+                this.db.exec("ROLLBACK");
+                return false;
+            }
+            this.db.exec("COMMIT");
+            return true;
+        }
+        catch (error) {
+            this.db.exec("ROLLBACK");
+            throw error;
+        }
+    }
+    async getTerminalCandidate(scopeId) {
+        const row = this.db
+            .prepare("SELECT * FROM agent_goal_terminal_candidates WHERE scope_id = ?")
+            .get(scopeId);
+        return row
+            ? {
+                scopeId: row.scope_id,
+                goalId: row.goal_id,
+                goalVersion: row.goal_version,
+                candidateId: row.candidate_id,
+                outcome: row.outcome,
+                reason: row.reason,
+                createdAt: row.created_at,
+            }
+            : undefined;
+    }
+    async putTerminalCandidate(candidate) {
+        const result = this.db
+            .prepare(`INSERT INTO agent_goal_terminal_candidates
+         (scope_id, goal_id, goal_version, candidate_id, outcome, reason, created_at)
+         SELECT ?, ?, ?, ?, ?, ?, ?
+         WHERE EXISTS (
+           SELECT 1 FROM agent_goals
+           WHERE scope_id = ? AND id = ? AND version = ? AND status = 'active'
+         )
+         ON CONFLICT(scope_id) DO UPDATE SET goal_id = excluded.goal_id,
+           goal_version = excluded.goal_version, candidate_id = excluded.candidate_id,
+           outcome = excluded.outcome, reason = excluded.reason, created_at = excluded.created_at`)
+            .run(candidate.scopeId, candidate.goalId, candidate.goalVersion, candidate.candidateId, candidate.outcome, candidate.reason, candidate.createdAt, candidate.scopeId, candidate.goalId, candidate.goalVersion);
+        return result.changes === 1;
+    }
+    async deleteTerminalCandidate(scopeId, expectedCandidateId) {
+        const result = this.db
+            .prepare("DELETE FROM agent_goal_terminal_candidates WHERE scope_id = ? AND candidate_id = ?")
+            .run(scopeId, expectedCandidateId);
+        return result.changes === 1;
+    }
+    async getContinuationClaim(scopeId) {
+        const row = this.db
+            .prepare("SELECT * FROM agent_goal_continuations WHERE scope_id = ?")
+            .get(scopeId);
+        return row
+            ? {
+                scopeId: row.scope_id,
+                goalId: row.goal_id,
+                goalVersion: row.goal_version,
+                claimId: row.claim_id,
+                state: row.state,
+                reason: row.reason,
+                attempt: row.attempt,
+                availableAt: row.available_at,
+                expiresAt: row.expires_at,
+                lastError: row.last_error ?? undefined,
+                createdAt: row.created_at,
+                updatedAt: row.updated_at,
+            }
+            : undefined;
+    }
+    async createContinuationClaim(claim) {
+        const result = this.db
+            .prepare(`INSERT OR IGNORE INTO agent_goal_continuations
+         (scope_id, goal_id, goal_version, claim_id, state, reason, attempt,
+          available_at, expires_at, last_error, created_at, updated_at)
+         SELECT ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?
+         WHERE EXISTS (
+           SELECT 1 FROM agent_goals
+           WHERE scope_id = ? AND id = ? AND version = ? AND status = 'active'
+         )`)
+            .run(claim.scopeId, claim.goalId, claim.goalVersion, claim.claimId, claim.state, claim.reason, claim.attempt, claim.availableAt, claim.expiresAt, claim.lastError ?? null, claim.createdAt, claim.updatedAt, claim.scopeId, claim.goalId, claim.goalVersion);
+        return result.changes === 1;
+    }
+    async replaceContinuationClaim(claim, expectedClaimId) {
+        const result = this.db
+            .prepare(`UPDATE agent_goal_continuations SET goal_id = ?, goal_version = ?, claim_id = ?,
+         state = ?, reason = ?, attempt = ?, available_at = ?, expires_at = ?,
+         last_error = ?, updated_at = ? WHERE scope_id = ? AND claim_id = ?`)
+            .run(claim.goalId, claim.goalVersion, claim.claimId, claim.state, claim.reason, claim.attempt, claim.availableAt, claim.expiresAt, claim.lastError ?? null, claim.updatedAt, claim.scopeId, expectedClaimId);
+        return result.changes === 1;
+    }
+    async deleteContinuationClaim(scopeId, expectedClaimId) {
+        const result = this.db
+            .prepare("DELETE FROM agent_goal_continuations WHERE scope_id = ? AND claim_id = ?")
+            .run(scopeId, expectedClaimId);
+        return result.changes === 1;
+    }
+    close() {
+        this.db.close();
+    }
+}

package/dist/wake-scheduler.d.ts

@@ -0,0 +1,10 @@
+import type { GoalWakeScheduler } from "./domain.js";
+export declare class TimerGoalWakeScheduler implements GoalWakeScheduler {
+    private readonly now;
+    private readonly timers;
+    private closed;
+    constructor(now?: () => number);
+    schedule(scopeId: string, wakeAt: string, wake: () => void): void;
+    cancel(scopeId: string): void;
+    close(): void;
+}

package/dist/wake-scheduler.js

@@ -0,0 +1,34 @@
+const MAX_TIMER_DELAY_MS = 2_147_483_647;
+export class TimerGoalWakeScheduler {
+    now;
+    timers = new Map();
+    closed = false;
+    constructor(now = Date.now) {
+        this.now = now;
+    }
+    schedule(scopeId, wakeAt, wake) {
+        if (this.closed)
+            return;
+        this.cancel(scopeId);
+        const delay = Math.min(MAX_TIMER_DELAY_MS, Math.max(0, Date.parse(wakeAt) - this.now()));
+        const timer = setTimeout(() => {
+            this.timers.delete(scopeId);
+            wake();
+        }, delay);
+        timer.unref?.();
+        this.timers.set(scopeId, timer);
+    }
+    cancel(scopeId) {
+        const timer = this.timers.get(scopeId);
+        if (!timer)
+            return;
+        clearTimeout(timer);
+        this.timers.delete(scopeId);
+    }
+    close() {
+        this.closed = true;
+        for (const timer of this.timers.values())
+            clearTimeout(timer);
+        this.timers.clear();
+    }
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@pinet/agent-goal",
+  "version": "0.2.6",
+  "type": "module",
+  "description": "Standalone single-agent durable goal loop for Pi",
+  "author": "Will Porcellini <5994936+gugu91@users.noreply.github.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gugu91/pinet.git",
+    "directory": "agent-goal"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "README.md",
+    "LICENSE",
+    "dist/"
+  ],
+  "keywords": [
+    "pi-package",
+    "goal",
+    "agent",
+    "autonomous"
+  ],
+  "pi": {
+    "extensions": [
+      "./dist/index.js"
+    ]
+  },
+  "scripts": {
+    "build": "node ../scripts/build-package.mjs",
+    "prepack": "pnpm run build",
+    "lint": "oxlint .",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --config ../vitest.config.ts"
+  },
+  "dependencies": {},
+  "peerDependencies": {
+    "@earendil-works/pi-ai": ">=0.74.0",
+    "@earendil-works/pi-coding-agent": ">=0.74.0"
+  }
+}