@xopcai/xopc 0.0.109 → 0.0.111

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

@@ -0,0 +1,154 @@
+import { init_session_key, parseSessionKey } from "../routing/session-key.js";
+import { createLogger } from "../utils/logger/index.js";
+import { init_logger } from "../utils/logger.js";
+import { GoalService } from "./goal-service.js";
+//#region src/goals/goal-notifications.ts
+init_session_key();
+init_logger();
+const log = createLogger("GoalNotifications");
+function eventForQueueStatus(status) {
+	if (status === "failed") return "queue_failed";
+	if (status === "retry_waiting") return "queue_retry";
+	if (status === "succeeded") return "queue_succeeded";
+	if (status === "skipped") return "queue_skipped";
+	return null;
+}
+function eventForGoalStatus(status) {
+	if (status === "done" || status === "blocked" || status === "needs_input") return status;
+	return null;
+}
+function targetKey(target) {
+	return [
+		target.channel,
+		target.chatId,
+		target.accountId ?? "",
+		target.threadId ?? ""
+	].join("\0");
+}
+function formatGoalNotification(event, goal, opts) {
+	const lines = [`${{
+		done: "Goal completed",
+		blocked: "Goal blocked",
+		needs_input: "Goal needs input",
+		queue_failed: "Goal run failed",
+		queue_retry: "Goal run retry scheduled",
+		queue_succeeded: "Goal run finished",
+		queue_skipped: "Goal run skipped"
+	}[event]}: ${goal.title}`];
+	if (goal.blockedReason) lines.push(`Reason: ${goal.blockedReason}`);
+	if (goal.nextAction) lines.push(`Next: ${goal.nextAction}`);
+	if (goal.latestRun?.reason && goal.latestRun.reason !== goal.blockedReason) lines.push(`Run: ${goal.latestRun.reason}`);
+	if (opts?.queueItem?.lastError) lines.push(`Queue: ${opts.queueItem.lastError}`);
+	const progress = goal.checklist.length ? goal.checklist.filter((it) => it.status === "completed" || it.status === "impossible").length : 0;
+	if (goal.checklist.length) lines.push(`Checklist: ${progress}/${goal.checklist.length}`);
+	lines.push(`Turns: ${goal.turnsUsed}/${goal.maxTurns}`);
+	return lines.join("\n");
+}
+var GoalNotificationService = class {
+	goals = new GoalService();
+	sentKeys = /* @__PURE__ */ new Set();
+	constructor(opts) {
+		this.opts = opts;
+	}
+	handleGatewayEvent(type, payload) {
+		if (type === "goal.queue.updated") {
+			this.handleQueueUpdated(payload).catch((err) => {
+				log.warn({ err }, "Goal queue notification failed");
+			});
+			return;
+		}
+		if (type === "goal.status.updated") this.handleStatusUpdated(payload).catch((err) => {
+			log.warn({ err }, "Goal status notification failed");
+		});
+	}
+	async handleQueueUpdated(payload) {
+		const item = this.parseQueueItem(payload);
+		if (!item) return;
+		const event = eventForQueueStatus(item.status);
+		if (!event) return;
+		const goal = this.goals.get(item.goalId);
+		if (!goal) return;
+		await this.notify(event, goal, {
+			queueItem: item,
+			eventKey: `${item.id}:${item.status}:${item.attempts}`
+		});
+	}
+	async handleStatusUpdated(payload) {
+		if (!payload || typeof payload !== "object") return;
+		const rec = payload;
+		const goal = this.isGoal(rec.goal) ? rec.goal : typeof rec.goalId === "string" ? this.goals.get(rec.goalId) : null;
+		if (!goal) return;
+		const status = typeof rec.status === "string" ? rec.status : goal.status;
+		const event = eventForGoalStatus(status);
+		if (!event) return;
+		if (rec.previousStatus === status) return;
+		await this.notify(event, goal, { eventKey: `${goal.id}:${event}:${goal.updatedAt}` });
+	}
+	async notify(event, goal, opts) {
+		const policy = this.opts.getConfig().goals?.notifications;
+		if (!policy?.enabled) return;
+		if (!policy.events.includes(event)) return;
+		const targets = this.resolveTargets(event, goal);
+		if (targets.length === 0) return;
+		const text = formatGoalNotification(event, goal, { queueItem: opts?.queueItem });
+		for (const target of targets) {
+			const dedupeKey = `${opts?.eventKey ?? `${goal.id}:${event}`}:${targetKey(target)}`;
+			if (this.sentKeys.has(dedupeKey)) continue;
+			this.sentKeys.add(dedupeKey);
+			await this.opts.send({
+				...target,
+				text
+			}).catch((err) => {
+				this.sentKeys.delete(dedupeKey);
+				throw err;
+			});
+		}
+	}
+	resolveTargets(event, goal) {
+		const policy = this.opts.getConfig().goals?.notifications;
+		if (!policy?.enabled) return [];
+		const byKey = /* @__PURE__ */ new Map();
+		if (policy.includeLinkedSessions !== false && goal.activeSessionKey) {
+			const parsed = parseSessionKey(goal.activeSessionKey);
+			if (parsed && policy.channels.includes(parsed.source)) {
+				const target = {
+					channel: parsed.source,
+					chatId: parsed.peerId,
+					accountId: parsed.accountId,
+					...parsed.threadId ? { threadId: parsed.threadId } : {}
+				};
+				byKey.set(targetKey(target), target);
+			}
+		}
+		for (const target of policy.targets ?? []) {
+			const events = target.events;
+			if (events && !events.includes(event)) continue;
+			const normalized = {
+				channel: target.channel,
+				chatId: target.chatId,
+				...target.accountId ? { accountId: target.accountId } : {},
+				...target.threadId != null ? { threadId: target.threadId } : {},
+				...target.silent != null ? { silent: target.silent } : {}
+			};
+			byKey.set(targetKey(normalized), normalized);
+		}
+		return [...byKey.values()];
+	}
+	parseQueueItem(payload) {
+		if (!payload || typeof payload !== "object") return null;
+		const item = payload.item;
+		if (!item || typeof item !== "object") return null;
+		const rec = item;
+		if (typeof rec.id !== "string" || typeof rec.goalId !== "string" || typeof rec.status !== "string") return null;
+		return rec;
+	}
+	isGoal(value) {
+		if (!value || typeof value !== "object") return false;
+		const rec = value;
+		return typeof rec.id === "string" && typeof rec.title === "string" && Array.isArray(rec.checklist);
+	}
+};
+//#endregion
+export { GoalNotificationService };
+
+//# sourceMappingURL=goal-notifications.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"goal-notifications.js","names":[],"sources":["../../../src/goals/goal-notifications.ts"],"sourcesContent":["import type { Config } from '../config/schema.js';\nimport { parseSessionKey } from '../routing/session-key.js';\nimport { createLogger } from '../utils/logger.js';\n\nimport { GoalService } from './goal-service.js';\nimport type { GoalWithDetails } from './types.js';\nimport type { GoalQueueItemSnapshot } from './goal-queue-types.js';\n\nconst log = createLogger('GoalNotifications');\n\nexport type GoalNotificationEvent =\n  | 'done'\n  | 'blocked'\n  | 'needs_input'\n  | 'queue_failed'\n  | 'queue_retry'\n  | 'queue_succeeded'\n  | 'queue_skipped';\n\nexport interface GoalNotificationTarget {\n  channel: string;\n  chatId: string;\n  accountId?: string;\n  threadId?: string | number;\n  silent?: boolean;\n}\n\nexport interface GoalNotificationSendInput extends GoalNotificationTarget {\n  text: string;\n}\n\nexport interface GoalNotificationServiceOptions {\n  getConfig: () => Config;\n  send: (input: GoalNotificationSendInput) => Promise<void>;\n}\n\nfunction eventForQueueStatus(status: GoalQueueItemSnapshot['status']): GoalNotificationEvent | null {\n  if (status === 'failed') return 'queue_failed';\n  if (status === 'retry_waiting') return 'queue_retry';\n  if (status === 'succeeded') return 'queue_succeeded';\n  if (status === 'skipped') return 'queue_skipped';\n  return null;\n}\n\nfunction eventForGoalStatus(status: GoalWithDetails['status']): GoalNotificationEvent | null {\n  if (status === 'done' || status === 'blocked' || status === 'needs_input') return status;\n  return null;\n}\n\nfunction targetKey(target: GoalNotificationTarget): string {\n  return [\n    target.channel,\n    target.chatId,\n    target.accountId ?? '',\n    target.threadId ?? '',\n  ].join('\\u0000');\n}\n\nfunction formatGoalNotification(event: GoalNotificationEvent, goal: GoalWithDetails, opts?: {\n  queueItem?: GoalQueueItemSnapshot;\n}): string {\n  const labels: Record<GoalNotificationEvent, string> = {\n    done: 'Goal completed',\n    blocked: 'Goal blocked',\n    needs_input: 'Goal needs input',\n    queue_failed: 'Goal run failed',\n    queue_retry: 'Goal run retry scheduled',\n    queue_succeeded: 'Goal run finished',\n    queue_skipped: 'Goal run skipped',\n  };\n  const lines = [`${labels[event]}: ${goal.title}`];\n  if (goal.blockedReason) lines.push(`Reason: ${goal.blockedReason}`);\n  if (goal.nextAction) lines.push(`Next: ${goal.nextAction}`);\n  if (goal.latestRun?.reason && goal.latestRun.reason !== goal.blockedReason) {\n    lines.push(`Run: ${goal.latestRun.reason}`);\n  }\n  if (opts?.queueItem?.lastError) lines.push(`Queue: ${opts.queueItem.lastError}`);\n  const progress = goal.checklist.length\n    ? goal.checklist.filter((it) => it.status === 'completed' || it.status === 'impossible').length\n    : 0;\n  if (goal.checklist.length) lines.push(`Checklist: ${progress}/${goal.checklist.length}`);\n  lines.push(`Turns: ${goal.turnsUsed}/${goal.maxTurns}`);\n  return lines.join('\\n');\n}\n\nexport class GoalNotificationService {\n  private readonly goals = new GoalService();\n  private readonly sentKeys = new Set<string>();\n\n  constructor(private readonly opts: GoalNotificationServiceOptions) {}\n\n  handleGatewayEvent(type: string, payload: unknown): void {\n    if (type === 'goal.queue.updated') {\n      void this.handleQueueUpdated(payload).catch((err) => {\n        log.warn({ err }, 'Goal queue notification failed');\n      });\n      return;\n    }\n    if (type === 'goal.status.updated') {\n      void this.handleStatusUpdated(payload).catch((err) => {\n        log.warn({ err }, 'Goal status notification failed');\n      });\n    }\n  }\n\n  private async handleQueueUpdated(payload: unknown): Promise<void> {\n    const item = this.parseQueueItem(payload);\n    if (!item) return;\n    const event = eventForQueueStatus(item.status);\n    if (!event) return;\n    const goal = this.goals.get(item.goalId);\n    if (!goal) return;\n    await this.notify(event, goal, { queueItem: item, eventKey: `${item.id}:${item.status}:${item.attempts}` });\n  }\n\n  private async handleStatusUpdated(payload: unknown): Promise<void> {\n    if (!payload || typeof payload !== 'object') return;\n    const rec = payload as { goal?: unknown; status?: unknown; goalId?: unknown; previousStatus?: unknown };\n    const goal =\n      this.isGoal(rec.goal)\n        ? rec.goal\n        : typeof rec.goalId === 'string'\n          ? this.goals.get(rec.goalId)\n          : null;\n    if (!goal) return;\n    const status = typeof rec.status === 'string' ? rec.status : goal.status;\n    const event = eventForGoalStatus(status as GoalWithDetails['status']);\n    if (!event) return;\n    if (rec.previousStatus === status) return;\n    await this.notify(event, goal, { eventKey: `${goal.id}:${event}:${goal.updatedAt}` });\n  }\n\n  private async notify(\n    event: GoalNotificationEvent,\n    goal: GoalWithDetails,\n    opts?: { queueItem?: GoalQueueItemSnapshot; eventKey?: string },\n  ): Promise<void> {\n    const policy = this.opts.getConfig().goals?.notifications;\n    if (!policy?.enabled) return;\n    if (!policy.events.includes(event)) return;\n\n    const targets = this.resolveTargets(event, goal);\n    if (targets.length === 0) return;\n\n    const text = formatGoalNotification(event, goal, { queueItem: opts?.queueItem });\n    for (const target of targets) {\n      const dedupeKey = `${opts?.eventKey ?? `${goal.id}:${event}`}:${targetKey(target)}`;\n      if (this.sentKeys.has(dedupeKey)) continue;\n      this.sentKeys.add(dedupeKey);\n      await this.opts.send({ ...target, text }).catch((err) => {\n        this.sentKeys.delete(dedupeKey);\n        throw err;\n      });\n    }\n  }\n\n  private resolveTargets(event: GoalNotificationEvent, goal: GoalWithDetails): GoalNotificationTarget[] {\n    const policy = this.opts.getConfig().goals?.notifications;\n    if (!policy?.enabled) return [];\n    const byKey = new Map<string, GoalNotificationTarget>();\n\n    if (policy.includeLinkedSessions !== false && goal.activeSessionKey) {\n      const parsed = parseSessionKey(goal.activeSessionKey);\n      const eligible = parsed && policy.channels.includes(parsed.source);\n      if (eligible) {\n        const target: GoalNotificationTarget = {\n          channel: parsed.source,\n          chatId: parsed.peerId,\n          accountId: parsed.accountId,\n          ...(parsed.threadId ? { threadId: parsed.threadId } : {}),\n        };\n        byKey.set(targetKey(target), target);\n      }\n    }\n\n    for (const target of policy.targets ?? []) {\n      const events = target.events;\n      if (events && !events.includes(event)) continue;\n      const normalized: GoalNotificationTarget = {\n        channel: target.channel,\n        chatId: target.chatId,\n        ...(target.accountId ? { accountId: target.accountId } : {}),\n        ...(target.threadId != null ? { threadId: target.threadId } : {}),\n        ...(target.silent != null ? { silent: target.silent } : {}),\n      };\n      byKey.set(targetKey(normalized), normalized);\n    }\n\n    return [...byKey.values()];\n  }\n\n  private parseQueueItem(payload: unknown): GoalQueueItemSnapshot | null {\n    if (!payload || typeof payload !== 'object') return null;\n    const item = (payload as { item?: unknown }).item;\n    if (!item || typeof item !== 'object') return null;\n    const rec = item as Partial<GoalQueueItemSnapshot>;\n    if (typeof rec.id !== 'string' || typeof rec.goalId !== 'string' || typeof rec.status !== 'string') return null;\n    return rec as GoalQueueItemSnapshot;\n  }\n\n  private isGoal(value: unknown): value is GoalWithDetails {\n    if (!value || typeof value !== 'object') return false;\n    const rec = value as Partial<GoalWithDetails>;\n    return typeof rec.id === 'string' && typeof rec.title === 'string' && Array.isArray(rec.checklist);\n  }\n}\n"],"mappings":";;;;;kBAC4D;aACV;AAMlD,MAAM,MAAM,aAAa,oBAAoB;AA4B7C,SAAS,oBAAoB,QAAuE;AAClG,KAAI,WAAW,SAAU,QAAO;AAChC,KAAI,WAAW,gBAAiB,QAAO;AACvC,KAAI,WAAW,YAAa,QAAO;AACnC,KAAI,WAAW,UAAW,QAAO;AACjC,QAAO;;AAGT,SAAS,mBAAmB,QAAiE;AAC3F,KAAI,WAAW,UAAU,WAAW,aAAa,WAAW,cAAe,QAAO;AAClF,QAAO;;AAGT,SAAS,UAAU,QAAwC;AACzD,QAAO;EACL,OAAO;EACP,OAAO;EACP,OAAO,aAAa;EACpB,OAAO,YAAY;EACpB,CAAC,KAAK,KAAS;;AAGlB,SAAS,uBAAuB,OAA8B,MAAuB,MAE1E;CAUT,MAAM,QAAQ,CAAC,GAAG;EARhB,MAAM;EACN,SAAS;EACT,aAAa;EACb,cAAc;EACd,aAAa;EACb,iBAAiB;EACjB,eAAe;EAEO,CAAC,OAAO,IAAI,KAAK,QAAQ;AACjD,KAAI,KAAK,cAAe,OAAM,KAAK,WAAW,KAAK,gBAAgB;AACnE,KAAI,KAAK,WAAY,OAAM,KAAK,SAAS,KAAK,aAAa;AAC3D,KAAI,KAAK,WAAW,UAAU,KAAK,UAAU,WAAW,KAAK,cAC3D,OAAM,KAAK,QAAQ,KAAK,UAAU,SAAS;AAE7C,KAAI,MAAM,WAAW,UAAW,OAAM,KAAK,UAAU,KAAK,UAAU,YAAY;CAChF,MAAM,WAAW,KAAK,UAAU,SAC5B,KAAK,UAAU,QAAQ,OAAO,GAAG,WAAW,eAAe,GAAG,WAAW,aAAa,CAAC,SACvF;AACJ,KAAI,KAAK,UAAU,OAAQ,OAAM,KAAK,cAAc,SAAS,GAAG,KAAK,UAAU,SAAS;AACxF,OAAM,KAAK,UAAU,KAAK,UAAU,GAAG,KAAK,WAAW;AACvD,QAAO,MAAM,KAAK,KAAK;;AAGzB,IAAa,0BAAb,MAAqC;CACnC,QAAyB,IAAI,aAAa;CAC1C,2BAA4B,IAAI,KAAa;CAE7C,YAAY,MAAuD;AAAtC,OAAA,OAAA;;CAE7B,mBAAmB,MAAc,SAAwB;AACvD,MAAI,SAAS,sBAAsB;AAC5B,QAAK,mBAAmB,QAAQ,CAAC,OAAO,QAAQ;AACnD,QAAI,KAAK,EAAE,KAAK,EAAE,iCAAiC;KACnD;AACF;;AAEF,MAAI,SAAS,sBACN,MAAK,oBAAoB,QAAQ,CAAC,OAAO,QAAQ;AACpD,OAAI,KAAK,EAAE,KAAK,EAAE,kCAAkC;IACpD;;CAIN,MAAc,mBAAmB,SAAiC;EAChE,MAAM,OAAO,KAAK,eAAe,QAAQ;AACzC,MAAI,CAAC,KAAM;EACX,MAAM,QAAQ,oBAAoB,KAAK,OAAO;AAC9C,MAAI,CAAC,MAAO;EACZ,MAAM,OAAO,KAAK,MAAM,IAAI,KAAK,OAAO;AACxC,MAAI,CAAC,KAAM;AACX,QAAM,KAAK,OAAO,OAAO,MAAM;GAAE,WAAW;GAAM,UAAU,GAAG,KAAK,GAAG,GAAG,KAAK,OAAO,GAAG,KAAK;GAAY,CAAC;;CAG7G,MAAc,oBAAoB,SAAiC;AACjE,MAAI,CAAC,WAAW,OAAO,YAAY,SAAU;EAC7C,MAAM,MAAM;EACZ,MAAM,OACJ,KAAK,OAAO,IAAI,KAAK,GACjB,IAAI,OACJ,OAAO,IAAI,WAAW,WACpB,KAAK,MAAM,IAAI,IAAI,OAAO,GAC1B;AACR,MAAI,CAAC,KAAM;EACX,MAAM,SAAS,OAAO,IAAI,WAAW,WAAW,IAAI,SAAS,KAAK;EAClE,MAAM,QAAQ,mBAAmB,OAAoC;AACrE,MAAI,CAAC,MAAO;AACZ,MAAI,IAAI,mBAAmB,OAAQ;AACnC,QAAM,KAAK,OAAO,OAAO,MAAM,EAAE,UAAU,GAAG,KAAK,GAAG,GAAG,MAAM,GAAG,KAAK,aAAa,CAAC;;CAGvF,MAAc,OACZ,OACA,MACA,MACe;EACf,MAAM,SAAS,KAAK,KAAK,WAAW,CAAC,OAAO;AAC5C,MAAI,CAAC,QAAQ,QAAS;AACtB,MAAI,CAAC,OAAO,OAAO,SAAS,MAAM,CAAE;EAEpC,MAAM,UAAU,KAAK,eAAe,OAAO,KAAK;AAChD,MAAI,QAAQ,WAAW,EAAG;EAE1B,MAAM,OAAO,uBAAuB,OAAO,MAAM,EAAE,WAAW,MAAM,WAAW,CAAC;AAChF,OAAK,MAAM,UAAU,SAAS;GAC5B,MAAM,YAAY,GAAG,MAAM,YAAY,GAAG,KAAK,GAAG,GAAG,QAAQ,GAAG,UAAU,OAAO;AACjF,OAAI,KAAK,SAAS,IAAI,UAAU,CAAE;AAClC,QAAK,SAAS,IAAI,UAAU;AAC5B,SAAM,KAAK,KAAK,KAAK;IAAE,GAAG;IAAQ;IAAM,CAAC,CAAC,OAAO,QAAQ;AACvD,SAAK,SAAS,OAAO,UAAU;AAC/B,UAAM;KACN;;;CAIN,eAAuB,OAA8B,MAAiD;EACpG,MAAM,SAAS,KAAK,KAAK,WAAW,CAAC,OAAO;AAC5C,MAAI,CAAC,QAAQ,QAAS,QAAO,EAAE;EAC/B,MAAM,wBAAQ,IAAI,KAAqC;AAEvD,MAAI,OAAO,0BAA0B,SAAS,KAAK,kBAAkB;GACnE,MAAM,SAAS,gBAAgB,KAAK,iBAAiB;AAErD,OADiB,UAAU,OAAO,SAAS,SAAS,OAAO,OAAO,EACpD;IACZ,MAAM,SAAiC;KACrC,SAAS,OAAO;KAChB,QAAQ,OAAO;KACf,WAAW,OAAO;KAClB,GAAI,OAAO,WAAW,EAAE,UAAU,OAAO,UAAU,GAAG,EAAE;KACzD;AACD,UAAM,IAAI,UAAU,OAAO,EAAE,OAAO;;;AAIxC,OAAK,MAAM,UAAU,OAAO,WAAW,EAAE,EAAE;GACzC,MAAM,SAAS,OAAO;AACtB,OAAI,UAAU,CAAC,OAAO,SAAS,MAAM,CAAE;GACvC,MAAM,aAAqC;IACzC,SAAS,OAAO;IAChB,QAAQ,OAAO;IACf,GAAI,OAAO,YAAY,EAAE,WAAW,OAAO,WAAW,GAAG,EAAE;IAC3D,GAAI,OAAO,YAAY,OAAO,EAAE,UAAU,OAAO,UAAU,GAAG,EAAE;IAChE,GAAI,OAAO,UAAU,OAAO,EAAE,QAAQ,OAAO,QAAQ,GAAG,EAAE;IAC3D;AACD,SAAM,IAAI,UAAU,WAAW,EAAE,WAAW;;AAG9C,SAAO,CAAC,GAAG,MAAM,QAAQ,CAAC;;CAG5B,eAAuB,SAAgD;AACrE,MAAI,CAAC,WAAW,OAAO,YAAY,SAAU,QAAO;EACpD,MAAM,OAAQ,QAA+B;AAC7C,MAAI,CAAC,QAAQ,OAAO,SAAS,SAAU,QAAO;EAC9C,MAAM,MAAM;AACZ,MAAI,OAAO,IAAI,OAAO,YAAY,OAAO,IAAI,WAAW,YAAY,OAAO,IAAI,WAAW,SAAU,QAAO;AAC3G,SAAO;;CAGT,OAAe,OAA0C;AACvD,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;EAChD,MAAM,MAAM;AACZ,SAAO,OAAO,IAAI,OAAO,YAAY,OAAO,IAAI,UAAU,YAAY,MAAM,QAAQ,IAAI,UAAU"}

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

@@ -0,0 +1,16 @@
+import type { GoalQueueItemSnapshot, GoalQueueStatus } from './goal-queue-types.js';
+export declare class GoalQueueStore {
+    enqueue(input: {
+        goalId: string;
+        message?: string;
+        maxRetries: number;
+        source: GoalQueueItemSnapshot['source'];
+    }): GoalQueueItemSnapshot;
+    claimNext(now?: number): GoalQueueItemSnapshot | null;
+    markRetry(itemId: string, error: string, nextRunAt: number): GoalQueueItemSnapshot | null;
+    markFinished(itemId: string, status: GoalQueueStatus, error?: string): GoalQueueItemSnapshot | null;
+    setSessionKey(itemId: string, sessionKey: string): GoalQueueItemSnapshot | null;
+    list(limit?: number): GoalQueueItemSnapshot[];
+    resetRunningToRetry(reason?: string): number;
+    private update;
+}

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;