@xopcai/xopc 0.0.110 → 0.0.112

package/dist/src/goals/goal-queue-store.js

@@ -0,0 +1,131 @@
+import { getSqliteDatabase, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
+import { randomUUID } from "node:crypto";
+//#region src/goals/goal-queue-store.ts
+function parsePayload(raw) {
+	try {
+		const parsed = JSON.parse(raw);
+		return parsed && typeof parsed === "object" ? parsed : {};
+	} catch {
+		return {};
+	}
+}
+function rowToSnapshot(row) {
+	const payload = parsePayload(row.payload_json);
+	return {
+		id: row.queue_id,
+		goalId: row.goal_id,
+		status: row.status,
+		attempts: row.attempts,
+		maxRetries: row.max_retries,
+		enqueuedAt: row.enqueued_at,
+		startedAt: row.started_at ?? void 0,
+		finishedAt: row.finished_at ?? void 0,
+		nextRunAt: row.next_run_at ?? void 0,
+		sessionKey: row.session_key ?? void 0,
+		message: payload.message,
+		lastError: row.last_error ?? void 0,
+		source: row.source
+	};
+}
+var GoalQueueStore = class {
+	enqueue(input) {
+		return runSqliteWriteTransaction((db) => {
+			const existing = db.prepare(`SELECT * FROM goal_queue
+           WHERE goal_id = ?
+             AND status IN ('queued', 'running', 'retry_waiting')
+           ORDER BY enqueued_at DESC
+           LIMIT 1`).get(input.goalId);
+			if (existing) return rowToSnapshot(existing);
+			const now = Date.now();
+			const row = {
+				queue_id: randomUUID(),
+				goal_id: input.goalId,
+				status: "queued",
+				payload_json: JSON.stringify({ message: input.message }),
+				attempts: 0,
+				max_retries: input.maxRetries,
+				enqueued_at: now,
+				started_at: null,
+				finished_at: null,
+				next_run_at: null,
+				session_key: null,
+				last_error: null,
+				source: input.source
+			};
+			db.prepare(`INSERT INTO goal_queue (
+          queue_id, goal_id, status, payload_json, attempts, max_retries,
+          enqueued_at, source
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)`).run(row.queue_id, row.goal_id, row.status, row.payload_json, row.attempts, row.max_retries, row.enqueued_at, row.source);
+			return rowToSnapshot(row);
+		});
+	}
+	claimNext(now = Date.now()) {
+		return runSqliteWriteTransaction((db) => {
+			const row = db.prepare(`SELECT * FROM goal_queue
+           WHERE status = 'queued'
+              OR (status = 'retry_waiting' AND COALESCE(next_run_at, 0) <= ?)
+           ORDER BY enqueued_at ASC
+           LIMIT 1`).get(now);
+			if (!row) return null;
+			const startedAt = Date.now();
+			db.prepare(`UPDATE goal_queue
+         SET status = 'running',
+             started_at = ?,
+             attempts = attempts + 1,
+             last_error = NULL
+         WHERE queue_id = ?`).run(startedAt, row.queue_id);
+			return rowToSnapshot(db.prepare(`SELECT * FROM goal_queue WHERE queue_id = ?`).get(row.queue_id));
+		});
+	}
+	markRetry(itemId, error, nextRunAt) {
+		return this.update(itemId, {
+			status: "retry_waiting",
+			next_run_at: nextRunAt,
+			last_error: error,
+			finished_at: null
+		});
+	}
+	markFinished(itemId, status, error) {
+		return this.update(itemId, {
+			status,
+			finished_at: Date.now(),
+			last_error: error ?? null
+		});
+	}
+	setSessionKey(itemId, sessionKey) {
+		return this.update(itemId, { session_key: sessionKey });
+	}
+	list(limit = 200) {
+		const safeLimit = Math.min(500, Math.max(1, Math.floor(limit)));
+		return getSqliteDatabase().prepare(`SELECT * FROM goal_queue ORDER BY enqueued_at DESC LIMIT ?`).all(safeLimit).map(rowToSnapshot);
+	}
+	resetRunningToRetry(reason = "Gateway restarted during goal run") {
+		return runSqliteWriteTransaction((db) => {
+			const result = db.prepare(`UPDATE goal_queue
+           SET status = 'retry_waiting',
+               next_run_at = ?,
+               last_error = ?
+           WHERE status = 'running'`).run(Date.now(), reason);
+			return Number(result.changes ?? 0);
+		});
+	}
+	update(itemId, patch) {
+		return runSqliteWriteTransaction((db) => {
+			const row = db.prepare(`SELECT * FROM goal_queue WHERE queue_id = ?`).get(itemId);
+			if (!row) return null;
+			const next = {
+				...row,
+				...patch
+			};
+			db.prepare(`UPDATE goal_queue SET
+          status = ?, attempts = ?, started_at = ?, finished_at = ?,
+          next_run_at = ?, session_key = ?, last_error = ?
+         WHERE queue_id = ?`).run(next.status, next.attempts, next.started_at, next.finished_at, next.next_run_at, next.session_key, next.last_error, itemId);
+			return rowToSnapshot(db.prepare(`SELECT * FROM goal_queue WHERE queue_id = ?`).get(itemId));
+		});
+	}
+};
+//#endregion
+export { GoalQueueStore };
+
+//# sourceMappingURL=goal-queue-store.js.map

package/dist/src/goals/goal-queue-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-queue-store.js","names":[],"sources":["../../../src/goals/goal-queue-store.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport { getSqliteDatabase, runSqliteWriteTransaction } from '../storage/sqlite/transaction.js';\n\nimport type { GoalQueueItemSnapshot, GoalQueueStatus } from './goal-queue-types.js';\n\ntype GoalQueueRow = {\n  queue_id: string;\n  goal_id: string;\n  status: GoalQueueStatus;\n  payload_json: string;\n  attempts: number;\n  max_retries: number;\n  enqueued_at: number;\n  started_at: number | null;\n  finished_at: number | null;\n  next_run_at: number | null;\n  session_key: string | null;\n  last_error: string | null;\n  source: GoalQueueItemSnapshot['source'];\n};\n\ntype GoalQueuePayload = {\n  message?: string;\n};\n\nfunction parsePayload(raw: string): GoalQueuePayload {\n  try {\n    const parsed = JSON.parse(raw) as GoalQueuePayload;\n    return parsed && typeof parsed === 'object' ? parsed : {};\n  } catch {\n    return {};\n  }\n}\n\nfunction rowToSnapshot(row: GoalQueueRow): GoalQueueItemSnapshot {\n  const payload = parsePayload(row.payload_json);\n  return {\n    id: row.queue_id,\n    goalId: row.goal_id,\n    status: row.status,\n    attempts: row.attempts,\n    maxRetries: row.max_retries,\n    enqueuedAt: row.enqueued_at,\n    startedAt: row.started_at ?? undefined,\n    finishedAt: row.finished_at ?? undefined,\n    nextRunAt: row.next_run_at ?? undefined,\n    sessionKey: row.session_key ?? undefined,\n    message: payload.message,\n    lastError: row.last_error ?? undefined,\n    source: row.source,\n  };\n}\n\nexport class GoalQueueStore {\n  enqueue(input: {\n    goalId: string;\n    message?: string;\n    maxRetries: number;\n    source: GoalQueueItemSnapshot['source'];\n  }): GoalQueueItemSnapshot {\n    return runSqliteWriteTransaction((db) => {\n      const existing = db\n        .prepare(\n          `SELECT * FROM goal_queue\n           WHERE goal_id = ?\n             AND status IN ('queued', 'running', 'retry_waiting')\n           ORDER BY enqueued_at DESC\n           LIMIT 1`,\n        )\n        .get(input.goalId) as GoalQueueRow | undefined;\n      if (existing) return rowToSnapshot(existing);\n\n      const now = Date.now();\n      const row: GoalQueueRow = {\n        queue_id: randomUUID(),\n        goal_id: input.goalId,\n        status: 'queued',\n        payload_json: JSON.stringify({ message: input.message }),\n        attempts: 0,\n        max_retries: input.maxRetries,\n        enqueued_at: now,\n        started_at: null,\n        finished_at: null,\n        next_run_at: null,\n        session_key: null,\n        last_error: null,\n        source: input.source,\n      };\n      db.prepare(\n        `INSERT INTO goal_queue (\n          queue_id, goal_id, status, payload_json, attempts, max_retries,\n          enqueued_at, source\n        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,\n      ).run(\n        row.queue_id,\n        row.goal_id,\n        row.status,\n        row.payload_json,\n        row.attempts,\n        row.max_retries,\n        row.enqueued_at,\n        row.source,\n      );\n      return rowToSnapshot(row);\n    });\n  }\n\n  claimNext(now = Date.now()): GoalQueueItemSnapshot | null {\n    return runSqliteWriteTransaction((db) => {\n      const row = db\n        .prepare(\n          `SELECT * FROM goal_queue\n           WHERE status = 'queued'\n              OR (status = 'retry_waiting' AND COALESCE(next_run_at, 0) <= ?)\n           ORDER BY enqueued_at ASC\n           LIMIT 1`,\n        )\n        .get(now) as GoalQueueRow | undefined;\n      if (!row) return null;\n\n      const startedAt = Date.now();\n      db.prepare(\n        `UPDATE goal_queue\n         SET status = 'running',\n             started_at = ?,\n             attempts = attempts + 1,\n             last_error = NULL\n         WHERE queue_id = ?`,\n      ).run(startedAt, row.queue_id);\n\n      const next = db\n        .prepare(`SELECT * FROM goal_queue WHERE queue_id = ?`)\n        .get(row.queue_id) as GoalQueueRow;\n      return rowToSnapshot(next);\n    });\n  }\n\n  markRetry(itemId: string, error: string, nextRunAt: number): GoalQueueItemSnapshot | null {\n    return this.update(itemId, {\n      status: 'retry_waiting',\n      next_run_at: nextRunAt,\n      last_error: error,\n      finished_at: null,\n    });\n  }\n\n  markFinished(itemId: string, status: GoalQueueStatus, error?: string): GoalQueueItemSnapshot | null {\n    return this.update(itemId, {\n      status,\n      finished_at: Date.now(),\n      last_error: error ?? null,\n    });\n  }\n\n  setSessionKey(itemId: string, sessionKey: string): GoalQueueItemSnapshot | null {\n    return this.update(itemId, { session_key: sessionKey });\n  }\n\n  list(limit = 200): GoalQueueItemSnapshot[] {\n    const safeLimit = Math.min(500, Math.max(1, Math.floor(limit)));\n    const rows = getSqliteDatabase()\n      .prepare(`SELECT * FROM goal_queue ORDER BY enqueued_at DESC LIMIT ?`)\n      .all(safeLimit) as GoalQueueRow[];\n    return rows.map(rowToSnapshot);\n  }\n\n  resetRunningToRetry(reason = 'Gateway restarted during goal run'): number {\n    return runSqliteWriteTransaction((db) => {\n      const result = db\n        .prepare(\n          `UPDATE goal_queue\n           SET status = 'retry_waiting',\n               next_run_at = ?,\n               last_error = ?\n           WHERE status = 'running'`,\n        )\n        .run(Date.now(), reason);\n      return Number(result.changes ?? 0);\n    });\n  }\n\n  private update(itemId: string, patch: Partial<GoalQueueRow>): GoalQueueItemSnapshot | null {\n    return runSqliteWriteTransaction((db) => {\n      const row = db\n        .prepare(`SELECT * FROM goal_queue WHERE queue_id = ?`)\n        .get(itemId) as GoalQueueRow | undefined;\n      if (!row) return null;\n      const next = { ...row, ...patch };\n      db.prepare(\n        `UPDATE goal_queue SET\n          status = ?, attempts = ?, started_at = ?, finished_at = ?,\n          next_run_at = ?, session_key = ?, last_error = ?\n         WHERE queue_id = ?`,\n      ).run(\n        next.status,\n        next.attempts,\n        next.started_at,\n        next.finished_at,\n        next.next_run_at,\n        next.session_key,\n        next.last_error,\n        itemId,\n      );\n      const updated = db\n        .prepare(`SELECT * FROM goal_queue WHERE queue_id = ?`)\n        .get(itemId) as GoalQueueRow;\n      return rowToSnapshot(updated);\n    });\n  }\n}\n\n"],"mappings":"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"}

package/dist/src/goals/goal-queue-types.d.ts

@@ -0,0 +1,31 @@
+import type { GoalWithDetails } from './types.js';
+export type GoalQueueStatus = 'queued' | 'running' | 'retry_waiting' | 'succeeded' | 'failed' | 'skipped';
+export interface GoalQueueItemSnapshot {
+    id: string;
+    goalId: string;
+    status: GoalQueueStatus;
+    attempts: number;
+    maxRetries: number;
+    enqueuedAt: number;
+    startedAt?: number;
+    finishedAt?: number;
+    nextRunAt?: number;
+    sessionKey?: string;
+    message?: string;
+    lastError?: string;
+    source: 'api' | 'cron' | 'workflow' | 'system';
+}
+export interface GoalRunnerOptions {
+    maxConcurrent?: number;
+    defaultMaxRetries?: number;
+    retryBaseMs?: number;
+    ensureSession: (goal: GoalWithDetails) => Promise<string>;
+    hasActiveRun: (sessionKey: string) => boolean;
+    runContinuation: (sessionKey: string, message: string) => Promise<void>;
+    emit?: (type: string, payload: unknown) => void;
+}
+export interface EnqueueGoalRunOptions {
+    message?: string;
+    maxRetries?: number;
+    source?: GoalQueueItemSnapshot['source'];
+}

package/dist/src/goals/goal-queue-types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/goals/goal-runner.d.ts

@@ -0,0 +1,17 @@
+import type { EnqueueGoalRunOptions, GoalQueueItemSnapshot, GoalRunnerOptions } from './goal-queue-types.js';
+export declare class GoalRunner {
+    private readonly opts;
+    private readonly goals;
+    private readonly store;
+    private active;
+    private pumpTimer;
+    constructor(opts: GoalRunnerOptions);
+    enqueue(goalId: string, options?: EnqueueGoalRunOptions): GoalQueueItemSnapshot;
+    snapshot(): GoalQueueItemSnapshot[];
+    private schedulePump;
+    private pump;
+    private runItem;
+    private retry;
+    private finish;
+    private emit;
+}

package/dist/src/goals/goal-runner.js

@@ -0,0 +1,127 @@
+import { createLogger } from "../utils/logger/index.js";
+import { init_logger } from "../utils/logger.js";
+import { GoalService } from "./goal-service.js";
+import { GoalQueueStore } from "./goal-queue-store.js";
+//#region src/goals/goal-runner.ts
+init_logger();
+const log = createLogger("GoalRunner");
+function terminalGoalStatus(status) {
+	return status === "done" || status === "archived";
+}
+var GoalRunner = class {
+	goals = new GoalService();
+	store = new GoalQueueStore();
+	active = 0;
+	pumpTimer = null;
+	constructor(opts) {
+		this.opts = opts;
+		this.store.resetRunningToRetry();
+		this.schedulePump(0);
+	}
+	enqueue(goalId, options = {}) {
+		const item = this.store.enqueue({
+			goalId,
+			maxRetries: Math.max(0, Math.floor(options.maxRetries ?? this.opts.defaultMaxRetries ?? 2)),
+			message: options.message?.trim() || void 0,
+			source: options.source ?? "api"
+		});
+		this.emit("goal.queue.updated", item);
+		this.schedulePump(0);
+		return item;
+	}
+	snapshot() {
+		return this.store.list();
+	}
+	schedulePump(delayMs) {
+		if (this.pumpTimer) return;
+		this.pumpTimer = setTimeout(() => {
+			this.pumpTimer = null;
+			this.pump();
+		}, delayMs);
+	}
+	async pump() {
+		const maxConcurrent = Math.max(1, Math.floor(this.opts.maxConcurrent ?? 1));
+		while (this.active < maxConcurrent) {
+			const item = this.store.claimNext();
+			if (!item) break;
+			this.active += 1;
+			this.runItem(item).finally(() => {
+				this.active -= 1;
+				this.schedulePump(0);
+			});
+		}
+		const nextRetry = this.store.list().filter((item) => item.status === "retry_waiting" && item.nextRunAt).sort((a, b) => (a.nextRunAt ?? 0) - (b.nextRunAt ?? 0))[0];
+		if (nextRetry) this.schedulePump(Math.max(0, (nextRetry.nextRunAt ?? Date.now()) - Date.now()));
+	}
+	async runItem(item) {
+		this.emit("goal.queue.updated", item);
+		try {
+			const goal = this.goals.get(item.goalId);
+			if (!goal) {
+				this.finish(item, "failed", "Goal not found");
+				return;
+			}
+			if (terminalGoalStatus(goal.status)) {
+				this.finish(item, "skipped", `Goal is ${goal.status}`);
+				return;
+			}
+			const activeGoal = goal.status === "paused" || goal.status === "blocked" || goal.status === "needs_input" ? this.goals.resume(goal.id) : goal;
+			if (!activeGoal) {
+				this.finish(item, "failed", "Goal not found");
+				return;
+			}
+			const sessionKey = activeGoal.activeSessionKey ?? await this.opts.ensureSession(activeGoal);
+			item = this.store.setSessionKey(item.id, sessionKey) ?? {
+				...item,
+				sessionKey
+			};
+			if (this.opts.hasActiveRun(sessionKey)) {
+				this.retry(item, "Goal session already has an active run");
+				return;
+			}
+			const message = item.message || activeGoal.nextAction || activeGoal.title;
+			await this.opts.runContinuation(sessionKey, message);
+			this.finish(item, "succeeded");
+		} catch (err) {
+			const message = err instanceof Error ? err.message : String(err);
+			if (item.attempts <= item.maxRetries) this.retry(item, message);
+			else this.finish(item, "failed", message);
+		}
+	}
+	retry(item, error) {
+		const base = Math.max(1e3, this.opts.retryBaseMs ?? 5e3);
+		item.status = "retry_waiting";
+		item.lastError = error;
+		item.nextRunAt = Date.now() + base * 2 ** Math.max(0, item.attempts - 1);
+		item = this.store.markRetry(item.id, error, item.nextRunAt) ?? item;
+		log.warn({
+			goalId: item.goalId,
+			attempts: item.attempts,
+			nextRunAt: item.nextRunAt,
+			errorMessage: error
+		}, `Goal run queued for retry: ${error}`);
+		this.emit("goal.queue.updated", item);
+		this.schedulePump(Math.max(0, item.nextRunAt - Date.now()));
+	}
+	finish(item, status, error) {
+		item = this.store.markFinished(item.id, status, error) ?? {
+			...item,
+			status,
+			finishedAt: Date.now(),
+			lastError: error
+		};
+		if (status === "failed") log.warn({
+			goalId: item.goalId,
+			attempts: item.attempts,
+			errorMessage: error
+		}, `Goal run failed: ${error}`);
+		this.emit("goal.queue.updated", item);
+	}
+	emit(type, item) {
+		this.opts.emit?.(type, { item: { ...item } });
+	}
+};
+//#endregion
+export { GoalRunner };
+
+//# sourceMappingURL=goal-runner.js.map

package/dist/src/goals/goal-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-runner.js","names":[],"sources":["../../../src/goals/goal-runner.ts"],"sourcesContent":["import { GoalQueueStore } from './goal-queue-store.js';\nimport { GoalService } from './goal-service.js';\nimport type { EnqueueGoalRunOptions, GoalQueueItemSnapshot, GoalQueueStatus, GoalRunnerOptions } from './goal-queue-types.js';\nimport type { GoalWithDetails } from './types.js';\nimport { createLogger } from '../utils/logger.js';\n\nconst log = createLogger('GoalRunner');\n\nfunction terminalGoalStatus(status: GoalWithDetails['status']): boolean {\n  return status === 'done' || status === 'archived';\n}\n\nexport class GoalRunner {\n  private readonly goals = new GoalService();\n  private readonly store = new GoalQueueStore();\n  private active = 0;\n  private pumpTimer: ReturnType<typeof setTimeout> | null = null;\n\n  constructor(private readonly opts: GoalRunnerOptions) {\n    this.store.resetRunningToRetry();\n    this.schedulePump(0);\n  }\n\n  enqueue(goalId: string, options: EnqueueGoalRunOptions = {}): GoalQueueItemSnapshot {\n    const item = this.store.enqueue({\n      goalId,\n      maxRetries: Math.max(0, Math.floor(options.maxRetries ?? this.opts.defaultMaxRetries ?? 2)),\n      message: options.message?.trim() || undefined,\n      source: options.source ?? 'api',\n    });\n    this.emit('goal.queue.updated', item);\n    this.schedulePump(0);\n    return item;\n  }\n\n  snapshot(): GoalQueueItemSnapshot[] {\n    return this.store.list();\n  }\n\n  private schedulePump(delayMs: number): void {\n    if (this.pumpTimer) return;\n    this.pumpTimer = setTimeout(() => {\n      this.pumpTimer = null;\n      void this.pump();\n    }, delayMs);\n  }\n\n  private async pump(): Promise<void> {\n    const maxConcurrent = Math.max(1, Math.floor(this.opts.maxConcurrent ?? 1));\n    while (this.active < maxConcurrent) {\n      const item = this.store.claimNext();\n      if (!item) break;\n      this.active += 1;\n      void this.runItem(item).finally(() => {\n        this.active -= 1;\n        this.schedulePump(0);\n      });\n    }\n\n    const nextRetry = this.store.list()\n      .filter((item) => item.status === 'retry_waiting' && item.nextRunAt)\n      .sort((a, b) => (a.nextRunAt ?? 0) - (b.nextRunAt ?? 0))[0];\n    if (nextRetry) this.schedulePump(Math.max(0, (nextRetry.nextRunAt ?? Date.now()) - Date.now()));\n  }\n\n  private async runItem(item: GoalQueueItemSnapshot): Promise<void> {\n    this.emit('goal.queue.updated', item);\n    try {\n      const goal = this.goals.get(item.goalId);\n      if (!goal) {\n        this.finish(item, 'failed', 'Goal not found');\n        return;\n      }\n      if (terminalGoalStatus(goal.status)) {\n        this.finish(item, 'skipped', `Goal is ${goal.status}`);\n        return;\n      }\n      const activeGoal =\n        goal.status === 'paused' || goal.status === 'blocked' || goal.status === 'needs_input'\n          ? this.goals.resume(goal.id)\n          : goal;\n      if (!activeGoal) {\n        this.finish(item, 'failed', 'Goal not found');\n        return;\n      }\n      const sessionKey = activeGoal.activeSessionKey ?? (await this.opts.ensureSession(activeGoal));\n      item = this.store.setSessionKey(item.id, sessionKey) ?? { ...item, sessionKey };\n      if (this.opts.hasActiveRun(sessionKey)) {\n        this.retry(item, 'Goal session already has an active run');\n        return;\n      }\n      const message = item.message || activeGoal.nextAction || activeGoal.title;\n      await this.opts.runContinuation(sessionKey, message);\n      this.finish(item, 'succeeded');\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      if (item.attempts <= item.maxRetries) {\n        this.retry(item, message);\n      } else {\n        this.finish(item, 'failed', message);\n      }\n    }\n  }\n\n  private retry(item: GoalQueueItemSnapshot, error: string): void {\n    const base = Math.max(1_000, this.opts.retryBaseMs ?? 5_000);\n    item.status = 'retry_waiting';\n    item.lastError = error;\n    item.nextRunAt = Date.now() + base * 2 ** Math.max(0, item.attempts - 1);\n    item = this.store.markRetry(item.id, error, item.nextRunAt) ?? item;\n    log.warn({ goalId: item.goalId, attempts: item.attempts, nextRunAt: item.nextRunAt, errorMessage: error }, `Goal run queued for retry: ${error}`);\n    this.emit('goal.queue.updated', item);\n    this.schedulePump(Math.max(0, item.nextRunAt - Date.now()));\n  }\n\n  private finish(item: GoalQueueItemSnapshot, status: GoalQueueStatus, error?: string): void {\n    item = this.store.markFinished(item.id, status, error) ?? { ...item, status, finishedAt: Date.now(), lastError: error };\n    if (status === 'failed') {\n      log.warn({ goalId: item.goalId, attempts: item.attempts, errorMessage: error }, `Goal run failed: ${error}`);\n    }\n    this.emit('goal.queue.updated', item);\n  }\n\n  private emit(type: string, item: GoalQueueItemSnapshot): void {\n    this.opts.emit?.(type, { item: { ...item } });\n  }\n}\n"],"mappings":"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"}

package/dist/src/goals/goal-service.d.ts

@@ -0,0 +1,77 @@
+import type { Config } from '../config/schema.js';
+import { GoalStore } from './goal-store.js';
+import type { CreateGoalInput, Goal, GoalChecklistAddedBy, GoalChecklistStatus, GoalJudgeDecision, GoalListQuery, GoalSource, GoalStatus, GoalUiLocale, GoalWithDetails } from './types.js';
+export declare class GoalService {
+    private readonly store;
+    constructor(store?: GoalStore);
+    create(input: Omit<CreateGoalInput, 'maxTurns' | 'agentId'> & {
+        maxTurns?: number;
+        agentId?: string;
+        config?: Config;
+    }): Goal;
+    get(goalId: string): GoalWithDetails | null;
+    getActiveForSession(sessionKey: string): GoalWithDetails | null;
+    list(query?: GoalListQuery): GoalWithDetails[];
+    update(goalId: string, patch: Partial<Pick<Goal, 'title' | 'description' | 'priority' | 'deadlineAt' | 'maxTurns' | 'judgeModelRef' | 'nextAction' | 'blockedReason' | 'activeSessionKey' | 'uiLocale'>>): GoalWithDetails | null;
+    setStatus(goalId: string, status: GoalStatus, opts?: {
+        reason?: string;
+    }): GoalWithDetails | null;
+    pause(goalId: string, reason?: string): GoalWithDetails | null;
+    resume(goalId: string): GoalWithDetails | null;
+    reopen(goalId: string): GoalWithDetails | null;
+    complete(goalId: string): GoalWithDetails | null;
+    archive(goalId: string): GoalWithDetails | null;
+    unarchive(goalId: string): GoalWithDetails | null;
+    attachSession(goalId: string, sessionKey: string): GoalWithDetails | null;
+    updateChecklist(goalId: string, op: {
+        type: 'add';
+        text: string;
+        addedBy?: GoalChecklistAddedBy;
+    } | {
+        type: 'mark';
+        itemId: string;
+        status: GoalChecklistStatus;
+        evidenceSummary?: string;
+    } | {
+        type: 'remove';
+        itemId: string;
+    } | {
+        type: 'reset';
+    }): GoalWithDetails | null;
+    recordJudgeDecision(input: {
+        goalId: string;
+        sessionKey: string;
+        source: GoalSource;
+        decision: GoalJudgeDecision;
+    }): GoalWithDetails | null;
+    syncPostTurnState(input: {
+        goalId: string;
+        sessionKey: string;
+        source: GoalSource;
+        status: GoalStatus;
+        turnsUsed: number;
+        maxTurns: number;
+        reason?: string;
+        nextAction?: string;
+        assistantPreview?: string;
+        verdict: 'continue' | 'done' | 'blocked' | 'needs_input' | 'decompose';
+        confidence?: number;
+        missingEvidence?: string[];
+        userQuestion?: string;
+        completedChecklistItemIds?: string[];
+        checklist?: Array<{
+            text: string;
+            status: 'pending' | 'completed' | 'impossible';
+            addedBy: 'user' | 'judge';
+            addedAt?: number;
+            completedAt?: number;
+            evidenceSummary?: string;
+        }>;
+    }): GoalWithDetails | null;
+    listRuns(goalId: string, limit?: number): import("./types.js").GoalRun[];
+    listRunsForSession(sessionKey: string, limit?: number): import("./types.js").GoalRun[];
+    listEvents(goalId: string, limit?: number): import("./types.js").GoalEvent[];
+    addEvidence(input: Parameters<GoalStore['addEvidence']>[0]): import("./types.js").GoalEvidence;
+    listEvidence(goalId: string, limit?: number): import("./types.js").GoalEvidence[];
+}
+export declare function normalizeGoalUiLocale(raw: unknown): GoalUiLocale | undefined;