@xopcai/xopc 0.0.180 → 0.0.188

package/dist/src/agent/goals/judge.js

@@ -1,176 +0,0 @@
-import { getApiKey, init_providers, resolveModel } from "../../providers/index.js";
-import { completeWithResolvedCredentials } from "../../providers/model-call.js";
-import { JUDGE_REASON_EN } from "../../i18n/goals-bundle.js";
-import { goalUiLocaleOrFallback, judgeFreeformBuiltinMessages, judgeResponseLanguageNote, localizeJudgeReasonText } from "./goal-locale.js";
-//#region src/agent/goals/judge.ts
-init_providers();
-const JUDGE_RESPONSE_SNIPPET_CHARS = 4e3;
-/**
-* Extract visible text from a pi-ai `AssistantMessage.content` array.
-* Handles `TextContent` (`type: 'text'`) and falls back to `ThinkingContent`
-* (`type: 'thinking'`) when the text blocks are empty — reasoning models
-* (DeepSeek-R1, Qwen-thinking, etc.) may place the entire response inside
-* thinking blocks, leaving the text portion blank.
-*/
-function extractAssistantText(content) {
-	if (!Array.isArray(content)) return "";
-	let textParts = "";
-	let thinkingParts = "";
-	for (const block of content) {
-		if (!block || typeof block !== "object") continue;
-		const typed = block;
-		const blockType = typed.type;
-		if (blockType === "text" && typeof typed.text === "string") textParts += typed.text;
-		else if (blockType === "thinking") {
-			const thinking = typeof typed.thinking === "string" ? typed.thinking : typeof typed.text === "string" ? typed.text : "";
-			thinkingParts += thinking;
-		}
-	}
-	return textParts.trim() ? textParts : thinkingParts;
-}
-/**
-* Strip markdown code fences (opening AND closing) from raw model output.
-* Handles `` ```json ``, `` ``` ``, and trailing `` ``` `` with optional whitespace.
-*/
-function stripCodeFences(raw) {
-	let text = raw.trim();
-	const openMatch = text.match(/^`{3,}[^\n]*\n?/);
-	if (openMatch) text = text.slice(openMatch[0].length);
-	const closeMatch = text.match(/\n?`{3,}\s*$/);
-	if (closeMatch) text = text.slice(0, -closeMatch[0].length);
-	return text.trim();
-}
-/** Mirrors `hermes_cli/goals.py` — strict judge, JSON-only reply. */
-const JUDGE_SYSTEM_PROMPT = "You are a strict judge evaluating whether an autonomous agent has achieved a user's stated goal. You receive the goal text and the agent's most recent response. Your only job is to decide whether the goal is fully satisfied based on that response.\n\nA goal is DONE only when:\n- The response explicitly confirms the goal was completed, OR\n- The response clearly shows the final deliverable was produced, OR\n- The response explains the goal is unachievable / blocked / needs user input (treat this as DONE with reason describing the block).\n\nOtherwise the goal is NOT done — CONTINUE.\n\nReply ONLY with a single JSON object on one line:\n{\"done\": <true|false>, \"reason\": \"<one-sentence rationale>\"}";
-const JUDGE_USER_PROMPT_TEMPLATE = "Goal:\n{goal}\n\nAgent's most recent response:\n{response}\n\nIs the goal satisfied?";
-const DEFAULT_JUDGE_TIMEOUT_MS = 6e4;
-function truncateGoalText(text, limit) {
-	if (!text) return "";
-	if (text.length <= limit) return text;
-	return text.slice(0, limit) + "… [truncated]";
-}
-async function resolveGoalJudgeApiKey(model) {
-	try {
-		return await getApiKey(model.provider);
-	} catch {
-		return;
-	}
-}
-function getAssistantMessageErrorReason(message) {
-	if (!message || typeof message !== "object") return null;
-	const record = message;
-	const stopReason = record.stopReason;
-	const errorMessage = typeof record.errorMessage === "string" ? record.errorMessage.trim() : "";
-	if (stopReason === "error") return errorMessage || "Judge model call failed.";
-	return null;
-}
-/** Parse judge JSON — fail-open to **continue** (Hermes semantics). */
-function parseJudgeResponseFailOpen(raw) {
-	if (!raw?.trim()) return {
-		done: false,
-		reason: JUDGE_REASON_EN.judge_returned_empty,
-		parseFailed: true
-	};
-	const text = stripCodeFences(raw);
-	let data = null;
-	try {
-		data = JSON.parse(text);
-	} catch {
-		const start = text.indexOf("{");
-		const end = text.lastIndexOf("}");
-		if (start !== -1 && end > start) try {
-			data = JSON.parse(text.slice(start, end + 1));
-		} catch {
-			data = null;
-		}
-	}
-	if (!data || typeof data !== "object") return {
-		done: false,
-		reason: JUDGE_REASON_EN.judge_reply_not_json,
-		parseFailed: true
-	};
-	const doneVal = data.done;
-	let done;
-	if (typeof doneVal === "string") done = [
-		"true",
-		"yes",
-		"1",
-		"done"
-	].includes(doneVal.trim().toLowerCase());
-	else done = Boolean(doneVal);
-	const reason = typeof data.reason === "string" ? data.reason.trim() : "";
-	return {
-		done,
-		reason: reason || JUDGE_REASON_EN.no_reason_provided,
-		parseFailed: false
-	};
-}
-/**
-* Ask the configured model whether the goal is satisfied.
-* Fail-open: any error → `continue` (Hermes — turn budget is the backstop).
-*/
-async function judgeGoalHermesStyle(goal, lastResponse, judgeModelRef, signal, opts) {
-	const locale = goalUiLocaleOrFallback(opts?.uiLocale);
-	const b = judgeFreeformBuiltinMessages(locale);
-	if (!goal.trim()) return {
-		verdict: "skipped",
-		reason: b.emptyGoal,
-		parseFailed: false
-	};
-	if (!lastResponse.trim()) return {
-		verdict: "continue",
-		reason: b.emptyResponse,
-		parseFailed: false
-	};
-	let model;
-	try {
-		model = resolveModel(judgeModelRef);
-	} catch {
-		return {
-			verdict: "continue",
-			reason: b.noModel,
-			parseFailed: false
-		};
-	}
-	const userContent = JUDGE_USER_PROMPT_TEMPLATE.replace("{goal}", truncateGoalText(goal, 2e3)).replace("{response}", truncateGoalText(lastResponse, JUDGE_RESPONSE_SNIPPET_CHARS)) + judgeResponseLanguageNote(locale);
-	const timeoutMs = typeof opts?.judgeTimeoutMs === "number" && Number.isFinite(opts.judgeTimeoutMs) ? Math.max(5e3, Math.min(12e4, Math.floor(opts.judgeTimeoutMs))) : DEFAULT_JUDGE_TIMEOUT_MS;
-	const controller = new AbortController();
-	const timer = setTimeout(() => controller.abort(), timeoutMs);
-	const merged = signal ? AbortSignal.any([signal, controller.signal]) : controller.signal;
-	try {
-		const combinedUser = {
-			role: "user",
-			content: `${JUDGE_SYSTEM_PROMPT}\n\n${userContent}`,
-			timestamp: Date.now()
-		};
-		const apiKey = await resolveGoalJudgeApiKey(model);
-		const result = await completeWithResolvedCredentials(model, { messages: [combinedUser] }, {
-			apiKey,
-			maxTokens: 200,
-			temperature: 0,
-			signal: merged
-		});
-		if (getAssistantMessageErrorReason(result)) return {
-			verdict: "continue",
-			reason: b.callFailed,
-			parseFailed: false
-		};
-		const { done, reason, parseFailed } = parseJudgeResponseFailOpen(extractAssistantText(result.content));
-		const reasonOut = localizeJudgeReasonText(reason, locale);
-		return {
-			verdict: done ? "done" : "continue",
-			reason: reasonOut,
-			parseFailed
-		};
-	} catch {
-		return {
-			verdict: "continue",
-			reason: b.callFailed,
-			parseFailed: false
-		};
-	} finally {
-		clearTimeout(timer);
-	}
-}
-//#endregion
-export { DEFAULT_JUDGE_TIMEOUT_MS, JUDGE_SYSTEM_PROMPT, JUDGE_USER_PROMPT_TEMPLATE, extractAssistantText, getAssistantMessageErrorReason, judgeGoalHermesStyle, parseJudgeResponseFailOpen, resolveGoalJudgeApiKey, stripCodeFences, truncateGoalText };

package/dist/src/agent/goals/persistent-goal-apis.d.ts

@@ -1,15 +0,0 @@
-import type { AgentMessage } from '@earendil-works/pi-agent-core';
-import type { SessionMetadata } from '../../session/types.js';
-/** Session persistence + scheduling for `/goal` on any channel (Hermes-style). */
-export interface PersistentGoalApis {
-    getSessionMetadata(key: string): Promise<SessionMetadata | null>;
-    updateSessionMetadata(key: string, updates: Partial<SessionMetadata>): Promise<void>;
-    loadMessages(key: string): Promise<AgentMessage[]>;
-    appendAssistantReceipt(sessionKey: string, text: string): Promise<void>;
-    scheduleContinuation(sessionKey: string, message: string): void;
-    /**
-     * Hermes-style guard: >1 while setting a new goal text means another inbound turn is still in-flight
-     * for the same session (e.g. concurrent requests).
-     */
-    inboundConcurrentDepth(sessionKey: string): number;
-}

package/dist/src/agent/goals/persistent-goal-apis.js

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

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

@@ -1,93 +0,0 @@
-/**
- * PersistentGoalService — owns the "/goal" runtime: continuation scheduling,
- * the `PersistentGoalApis` bag that command handlers receive, and the post-turn
- * verdict hook called from `OutboundCoordinator`.
- *
- * Previously this logic was scattered across `AgentService`:
- *   - `setPersistentGoalWebchatContinuationScheduler` + a private callback field
- *   - `schedulePersistentGoalContinuation` (bus vs webchat fork)
- *   - `getPersistentGoalApisForCommand` (~40-line API factory)
- *   - `recordPersistentGoalStreamOutcome` / `takePersistentGoalStreamOutcome`
- *   - the `/goal` half of `emitSessionTurnComplete` (delegated to
- *     `handlePersistentGoalPostTurn`)
- *
- * Concentrating it here gives the rest of `AgentService` a cleaner surface
- * (one collaborator instead of five methods) and makes the goal runtime
- * unit-testable in isolation.
- */
-import type { Config } from '../../config/schema.js';
-import type { MessageBus } from '../../infra/bus/index.js';
-import type { ModelManager } from '../models/index.js';
-import type { SessionStore } from '../../session/store.js';
-import type { SessionStateBag } from '../session/index.js';
-import type { GoalWithDetails } from '../../goals/types.js';
-import type { PersistentGoalApis } from './persistent-goal-apis.js';
-export interface PersistentGoalRouting {
-    sessionKey: string;
-    channel: string;
-    chatId: string;
-    inboundMetadata?: Record<string, unknown>;
-}
-export interface SessionTurnCompletionForGoal {
-    sessionKey: string;
-    channel: string;
-    chatId: string;
-    assistantPlainText: string;
-    aborted: boolean;
-    streamError?: string;
-    skipPersistentGoalPostTurn?: boolean;
-    outboundMetadata?: Record<string, unknown>;
-}
-export interface PersistentGoalServiceOptions {
-    bus: MessageBus;
-    sessionStore: SessionStore;
-    modelManager: ModelManager;
-    sessionState: SessionStateBag;
-    /** Effective config snapshot accessor. */
-    getConfig: () => Config | undefined;
-    /** Resolve the workspace directory for `appendAssistantReceipt` writes. */
-    getResolvedWorkspaceForSession: (sessionKey: string) => string;
-    /** Notify the gateway UI after a metadata change (replaces the in-bag emit). */
-    onSessionMetadataUpdated?: (sessionKey: string) => void;
-    /** Push an assistant token + transcript refresh into a live webchat stream. */
-    notifyWebchatTranscriptAppend: (sessionKey: string, assistantText: string) => void;
-    /** Gateway: durable goal status changed after post-turn judge. */
-    onGoalStatusUpdated?: (payload: {
-        goalId: string;
-        sessionKey: string;
-        previousStatus: string;
-        status: string;
-        goal: GoalWithDetails;
-    }) => void;
-}
-export declare class PersistentGoalService {
-    private readonly opts;
-    /** Gateway only: webchat continuations bypass the bus and reuse `runGatewayAgent`. */
-    private webchatContinuationScheduler?;
-    constructor(opts: PersistentGoalServiceOptions);
-    /** Register the gateway-side webchat continuation hook (set from `web-agent` wiring). */
-    setWebchatContinuationScheduler(fn: ((sessionKey: string, message: string) => void) | undefined): void;
-    /**
-     * Continue a session after `/goal` decides the previous turn needs follow-up.
-     * Webchat sessions go through the scheduler; bus-driven channels re-publish the
-     * follow-up message as an inbound bus event so the existing inbound loop picks it up.
-     */
-    scheduleContinuation(sessionKey: string, message: string, routing: {
-        channel: string;
-        chatId: string;
-        inboundMetadata?: Record<string, unknown>;
-    }): void;
-    /** Build the per-command `PersistentGoalApis` bag (transcript writers + scheduler closures). */
-    buildApisForRouting(routing: PersistentGoalRouting): PersistentGoalApis;
-    recordStreamOutcome(sessionKey: string, outcome: {
-        skipPersistentGoalPostTurn: boolean;
-    }): void;
-    takeStreamOutcome(sessionKey: string): {
-        skipPersistentGoalPostTurn: boolean;
-    } | undefined;
-    /**
-     * Run the `/goal` post-turn verdict for a completed user turn (called from
-     * `OutboundCoordinator.emitSessionTurnComplete`).
-     */
-    runPostTurn(payload: SessionTurnCompletionForGoal): Promise<void>;
-}

package/dist/src/agent/goals/persistent-goal-service.js

@@ -1,128 +0,0 @@
-import { createLogger } from "../../utils/logger/index.js";
-import { init_logger } from "../../utils/logger.js";
-import { handlePersistentGoalPostTurn } from "./post-turn.js";
-//#region src/agent/goals/persistent-goal-service.ts
-init_logger();
-const log = createLogger("PersistentGoalService");
-var PersistentGoalService = class {
-	opts;
-	/** Gateway only: webchat continuations bypass the bus and reuse `runGatewayAgent`. */
-	webchatContinuationScheduler;
-	constructor(opts) {
-		this.opts = opts;
-	}
-	/** Register the gateway-side webchat continuation hook (set from `web-agent` wiring). */
-	setWebchatContinuationScheduler(fn) {
-		this.webchatContinuationScheduler = fn;
-	}
-	/**
-	* Continue a session after `/goal` decides the previous turn needs follow-up.
-	* Webchat sessions go through the scheduler; bus-driven channels re-publish the
-	* follow-up message as an inbound bus event so the existing inbound loop picks it up.
-	*/
-	scheduleContinuation(sessionKey, message, routing) {
-		if (routing.channel === "webchat" && this.webchatContinuationScheduler) {
-			this.webchatContinuationScheduler(sessionKey, message);
-			return;
-		}
-		queueMicrotask(() => {
-			this.opts.bus.publishInbound({
-				channel: routing.channel,
-				chat_id: routing.chatId,
-				sender_id: "persistent-goal",
-				content: message,
-				metadata: {
-					sessionKey,
-					...routing.inboundMetadata
-				}
-			}).catch((err) => {
-				log.warn({
-					err,
-					sessionKey
-				}, "Persistent goal: publishInbound failed");
-			});
-		});
-	}
-	/** Build the per-command `PersistentGoalApis` bag (transcript writers + scheduler closures). */
-	buildApisForRouting(routing) {
-		return {
-			getSessionMetadata: (k) => this.opts.sessionStore.getMetadata(k),
-			updateSessionMetadata: async (k, u) => {
-				await this.opts.sessionStore.updateMetadata(k, u);
-				this.opts.onSessionMetadataUpdated?.(k);
-			},
-			loadMessages: (k) => this.opts.sessionStore.loadMessages(k),
-			appendAssistantReceipt: async (k, text) => {
-				const trimmed = text.trim();
-				if (!trimmed) return;
-				await this.opts.sessionStore.appendTranscriptMessage(k, {
-					role: "assistant",
-					content: [{
-						type: "text",
-						text: trimmed
-					}],
-					timestamp: Date.now()
-				});
-				this.opts.notifyWebchatTranscriptAppend(k, trimmed);
-			},
-			scheduleContinuation: (sk, msg) => {
-				this.scheduleContinuation(sk, msg, {
-					channel: routing.channel,
-					chatId: routing.chatId,
-					inboundMetadata: routing.inboundMetadata
-				});
-			},
-			inboundConcurrentDepth: (sk) => this.opts.sessionState.getInboundTurnDepth(sk)
-		};
-	}
-	recordStreamOutcome(sessionKey, outcome) {
-		this.opts.sessionState.recordPersistentGoalStreamOutcome(sessionKey, outcome);
-	}
-	takeStreamOutcome(sessionKey) {
-		return this.opts.sessionState.takePersistentGoalStreamOutcome(sessionKey);
-	}
-	/**
-	* Run the `/goal` post-turn verdict for a completed user turn (called from
-	* `OutboundCoordinator.emitSessionTurnComplete`).
-	*/
-	async runPostTurn(payload) {
-		const apis = this.buildApisForRouting({
-			sessionKey: payload.sessionKey,
-			channel: payload.channel,
-			chatId: payload.chatId,
-			inboundMetadata: payload.outboundMetadata
-		});
-		const publishVerdict = !(payload.channel === "webchat") && payload.channel !== "cli" ? async (text) => {
-			await this.opts.bus.publishOutbound({
-				channel: payload.channel,
-				chat_id: payload.chatId,
-				content: text,
-				type: "message",
-				metadata: {
-					accountId: payload.outboundMetadata?.accountId,
-					threadId: payload.outboundMetadata?.threadId
-				}
-			});
-		} : void 0;
-		let runtimeSessionModelRef;
-		try {
-			runtimeSessionModelRef = this.opts.modelManager.getModelForSession(payload.sessionKey);
-		} catch {
-			runtimeSessionModelRef = void 0;
-		}
-		await handlePersistentGoalPostTurn({
-			apis,
-			sessionKey: payload.sessionKey,
-			assistantPlainText: payload.assistantPlainText,
-			aborted: payload.aborted,
-			...payload.streamError !== void 0 ? { streamError: payload.streamError } : {},
-			skipPersistentGoalPostTurn: payload.skipPersistentGoalPostTurn ?? false,
-			config: this.opts.getConfig(),
-			runtimeSessionModelRef,
-			publishVerdictToChannel: publishVerdict,
-			onGoalStatusUpdated: this.opts.onGoalStatusUpdated
-		});
-	}
-};
-//#endregion
-export { PersistentGoalService };

package/dist/src/agent/goals/post-turn.d.ts

@@ -1,28 +0,0 @@
-import type { Config, GoalsConfig } from '../../config/schema.js';
-import type { PersistentGoalApis } from './persistent-goal-apis.js';
-export declare function shouldRunInitialChecklistDecomposition(input: {
-    checklistLength: number;
-    turnsUsed: number;
-    checklistDecomposePolicy?: GoalsConfig['checklistDecomposePolicy'];
-}): boolean;
-export declare function handlePersistentGoalPostTurn(opts: {
-    apis: PersistentGoalApis;
-    sessionKey: string;
-    assistantPlainText: string;
-    aborted: boolean;
-    streamError?: string;
-    skipPersistentGoalPostTurn: boolean;
-    config: Config | undefined;
-    /** Active session model (overrides, per-agent defaults) when goals/global defaults are unset. */
-    runtimeSessionModelRef?: string;
-    signal?: AbortSignal;
-    /** Hermes-style: verdict line also sent as a normal outbound message (non-webchat). */
-    publishVerdictToChannel?: (text: string) => Promise<void>;
-    onGoalStatusUpdated?: (payload: {
-        goalId: string;
-        sessionKey: string;
-        previousStatus: string;
-        status: string;
-        goal: import('../../goals/types.js').GoalWithDetails;
-    }) => void;
-}): Promise<void>;

package/dist/src/agent/goals/post-turn.js

@@ -1,187 +0,0 @@
-import { createLogger } from "../../utils/logger/index.js";
-import { init_logger } from "../../utils/logger.js";
-import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
-import { resolveGoalUiLocale } from "./goal-locale.js";
-import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
-import { GoalService } from "../../goals/goal-service.js";
-import { OutcomeRepository } from "../../work/outcome-repository.js";
-import { evaluateAfterTurnHermesLike } from "./evaluate-turn.js";
-import "../../goals/index.js";
-//#region src/agent/goals/post-turn.ts
-init_schema();
-init_logger();
-const log = createLogger("PersistentGoal");
-const goalService = new GoalService();
-function buildHistoryExcerpt(messages, maxChars) {
-	if (maxChars <= 0) return "";
-	try {
-		const raw = JSON.stringify(messages);
-		if (raw.length <= maxChars) return raw;
-		return raw.slice(-maxChars);
-	} catch {
-		return "";
-	}
-}
-function buildGoalContextText(goal) {
-	const contract = new OutcomeRepository().getContract(goal.outcomeId, goal.outcomeContractVersion);
-	const lines = [`Outcome: ${contract?.objective ?? goal.title}`];
-	if (contract?.constraints.length) lines.push(`Constraints:\n${contract.constraints.map((item) => `- ${item}`).join("\n")}`);
-	if (contract?.deliverables.length) lines.push(`Deliverables:\n${contract.deliverables.map((item) => `- ${item}`).join("\n")}`);
-	if (goal.contextMessage?.text.trim()) lines.push(`Context:\n${goal.contextMessage.text.trim()}`);
-	if (goal.contextMessage?.attachments.length) lines.push(["Attachments:", ...goal.contextMessage.attachments.map((attachment) => `- ${attachment.name} (${attachment.mimeType}, ${attachment.size} bytes) ${attachment.uri}`)].join("\n"));
-	return lines.join("\n\n");
-}
-function resolveJudgeModelRef(config, sessionKey, storedJudge, runtimeSessionModelRef) {
-	const fromCfg = config?.goals?.judgeModelRef?.trim();
-	if (fromCfg) return fromCfg;
-	if (storedJudge?.trim()) return storedJudge.trim();
-	if (config) {
-		const profile = resolveEffectiveAgentProfileForSession(config, sessionKey);
-		if (profile.primaryModelRef?.trim()) return profile.primaryModelRef.trim();
-	}
-	if (runtimeSessionModelRef?.trim()) return runtimeSessionModelRef.trim();
-	if (config) return getAgentDefaultModelRef(config);
-}
-function shouldRunInitialChecklistDecomposition(input) {
-	if (input.checklistLength === 0) return true;
-	return input.checklistDecomposePolicy === "supplement_existing" && input.turnsUsed === 0;
-}
-async function appendAssistantLine(apis, sessionKey, text) {
-	await apis.appendAssistantReceipt(sessionKey, text);
-}
-async function handlePersistentGoalPostTurn(opts) {
-	const { apis, sessionKey, assistantPlainText, aborted, streamError, skipPersistentGoalPostTurn, config, runtimeSessionModelRef, signal, publishVerdictToChannel, onGoalStatusUpdated } = opts;
-	if (skipPersistentGoalPostTurn) return;
-	if (aborted || streamError) return;
-	if (!await apis.getSessionMetadata(sessionKey)) return;
-	const goal = goalService.getActiveForSession(sessionKey);
-	if (!goal || goal.status !== "active") return;
-	const goalsCfg = config?.goals;
-	const shouldDecomposeChecklist = shouldRunInitialChecklistDecomposition({
-		checklistLength: goal.checklist.length,
-		turnsUsed: goal.turnsUsed,
-		checklistDecomposePolicy: goalsCfg?.checklistDecomposePolicy
-	});
-	const state = {
-		goal: buildGoalContextText(goal),
-		status: "active",
-		turnsUsed: goal.turnsUsed,
-		maxTurns: goal.maxTurns,
-		createdAt: goal.createdAt,
-		lastTurnAt: goal.updatedAt,
-		lastReason: goal.blockedReason,
-		judgeModelRef: goal.judgeModelRef,
-		decomposed: shouldDecomposeChecklist ? void 0 : true,
-		uiLocale: goal.uiLocale,
-		checklist: goal.checklist.map((it) => ({
-			text: it.text,
-			status: it.status,
-			addedBy: it.addedBy,
-			addedAt: it.addedAt,
-			completedAt: it.completedAt,
-			evidence: it.evidenceSummary
-		}))
-	};
-	const judgeRef = resolveJudgeModelRef(config, sessionKey, state.judgeModelRef, runtimeSessionModelRef);
-	if (!judgeRef) {
-		log.warn({ sessionKey }, "Persistent goal: no judge model ref; skipping post-turn");
-		return;
-	}
-	const historyCap = goalsCfg?.checklistHistoryChars ?? 24e3;
-	let historyExcerpt = "";
-	try {
-		historyExcerpt = buildHistoryExcerpt(await apis.loadMessages(sessionKey), historyCap);
-	} catch (err) {
-		log.debug({
-			err,
-			sessionKey
-		}, `Persistent goal: could not load messages for judge context: ${err instanceof Error ? err.message : String(err)}`);
-	}
-	let decision = await evaluateAfterTurnHermesLike(state, assistantPlainText, judgeRef, signal, {
-		goalsSlice: goalsCfg,
-		historyExcerpt,
-		goalContextExcerpt: buildGoalContextText(goal),
-		uiLocale: resolveGoalUiLocale(state)
-	});
-	const executionGaps = goalService.getCompletionReadiness(goal.id)?.pendingCriteria ?? [];
-	if (decision.verdict === "done" && executionGaps.length > 0 && decision.newState) {
-		const reason = `Completion evidence or outcome still needed: ${executionGaps.join("; ")}`;
-		decision = {
-			...decision,
-			newState: {
-				...decision.newState,
-				status: "active",
-				lastVerdict: "continue",
-				lastReason: reason
-			},
-			shouldContinue: true,
-			continuationPrompt: `Before declaring the goal complete, address these gaps:\n${executionGaps.map((item) => `- ${item}`).join("\n")}`,
-			verdict: "continue",
-			reason,
-			message: reason,
-			missingEvidence: executionGaps
-		};
-	}
-	if (decision.newState) {
-		const ns = decision.newState;
-		const completedChecklistItemIds = decision.completedChecklistItemIndexes?.map((index) => goal.checklist[index]?.id).filter((id) => typeof id === "string" && id.length > 0);
-		try {
-			const updatedGoal = goalService.syncPostTurnState({
-				goalId: goal.id,
-				sessionKey,
-				source: "chat",
-				status: ns.status === "done" ? "done" : decision.verdict === "blocked" ? "blocked" : decision.verdict === "needs_input" ? "needs_input" : ns.status === "paused" ? "paused" : "active",
-				turnsUsed: ns.turnsUsed,
-				maxTurns: ns.maxTurns,
-				reason: ns.pausedReason ?? decision.reason,
-				nextAction: decision.continuationPrompt ?? void 0,
-				assistantPreview: assistantPlainText,
-				verdict: decision.verdict === "done" ? "done" : decision.verdict === "decompose" ? "decompose" : decision.verdict === "blocked" ? "blocked" : decision.verdict === "needs_input" ? "needs_input" : "continue",
-				confidence: decision.confidence,
-				missingEvidence: decision.missingEvidence,
-				userQuestion: decision.userQuestion,
-				completedChecklistItemIds,
-				checklist: ns.checklist?.map((it) => ({
-					text: it.text,
-					status: it.status,
-					addedBy: it.addedBy,
-					addedAt: it.addedAt,
-					completedAt: it.completedAt,
-					evidenceSummary: it.evidence
-				}))
-			});
-			if (updatedGoal && updatedGoal.status !== goal.status) onGoalStatusUpdated?.({
-				goalId: goal.id,
-				sessionKey,
-				previousStatus: goal.status,
-				status: updatedGoal.status,
-				goal: updatedGoal
-			});
-		} catch (err) {
-			log.warn({
-				err,
-				sessionKey,
-				goalId: goal.id
-			}, `Persistent goal: SQLite goal update failed: ${err instanceof Error ? err.message : String(err)}`);
-		}
-	}
-	if (decision.message) if (publishVerdictToChannel) try {
-		await publishVerdictToChannel(decision.message);
-	} catch (err) {
-		log.warn({
-			err,
-			sessionKey
-		}, `Persistent goal: channel verdict send failed: ${err instanceof Error ? err.message : String(err)}`);
-	}
-	else try {
-		await appendAssistantLine(apis, sessionKey, decision.message);
-	} catch (err) {
-		log.warn({
-			err,
-			sessionKey
-		}, `Persistent goal: failed to append status message: ${err instanceof Error ? err.message : String(err)}`);
-	}
-	if (decision.shouldContinue && decision.continuationPrompt) apis.scheduleContinuation(sessionKey, decision.continuationPrompt);
-}
-//#endregion
-export { handlePersistentGoalPostTurn, shouldRunInitialChecklistDecomposition };

package/dist/src/agent/goals/state.d.ts

@@ -1,46 +0,0 @@
-import { type ChecklistItemStatus, type GoalChecklistItem } from './checklist-types.js';
-import type { ServerLocale as GoalUiLocale } from '../../i18n/locale.js';
-export type PersistentGoalStatus = 'active' | 'paused' | 'done' | 'cleared';
-export interface PersistentGoalState {
-    goal: string;
-    status: PersistentGoalStatus;
-    turnsUsed: number;
-    maxTurns: number;
-    createdAt: number;
-    lastTurnAt: number;
-    lastVerdict?: 'done' | 'continue' | 'skipped' | 'decompose';
-    lastReason?: string;
-    pausedReason?: string;
-    judgeModelRef?: string;
-    /** Hermes-style: judge JSON parse failures in a row (API errors do not increment). */
-    consecutiveParseFailures?: number;
-    /** After first successful decomposition, checklist drives Phase-B judging. */
-    decomposed?: boolean;
-    checklist?: GoalChecklistItem[];
-    /** Gateway console language: drives judge `reason` language and system messages. */
-    uiLocale?: GoalUiLocale;
-}
-export declare function defaultMaxTurns(cfg: {
-    maxTurns?: number;
-} | undefined): number;
-/** Render checklist for continuation prompt (Hermes-style, no numbers in body). */
-export declare function renderChecklistPlain(items: GoalChecklistItem[]): string;
-/** Numbered checklist for judge user prompts (1-based indices). */
-export declare function renderChecklistNumbered(items: GoalChecklistItem[]): string;
-/**
- * After LLM decomposition, keep existing checklist rows (e.g. user-added acceptance criteria)
- * and append judge-generated items, skipping duplicate text (case-insensitive trim).
- */
-export declare function mergeDecomposedChecklistItems(existing: GoalChecklistItem[], decomposedTexts: {
-    text: string;
-}[]): GoalChecklistItem[];
-export declare function applyJudgeChecklistUpdates(items: GoalChecklistItem[], parsed: {
-    updates: {
-        index: number;
-        status: ChecklistItemStatus;
-        evidence?: string | null;
-    }[];
-    newItems: {
-        text: string;
-    }[];
-}): GoalChecklistItem[];