@xopcai/xopc 0.0.179 → 0.0.187

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 { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
-import { GoalService } from "../../goals/goal-service.js";
-import { OutcomeRepository } from "../../work/outcome-repository.js";
-import { resolveGoalUiLocale } from "./goal-locale.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[];

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

@@ -1,80 +0,0 @@
-import { CHECKLIST_ITEM_PENDING, TERMINAL_CHECKLIST_STATUSES } from "./checklist-types.js";
-//#region src/agent/goals/state.ts
-function defaultMaxTurns(cfg) {
-	const n = cfg?.maxTurns;
-	if (typeof n === "number" && Number.isFinite(n)) return Math.max(1, Math.min(500, Math.floor(n)));
-	return 20;
-}
-/** Render checklist for continuation prompt (Hermes-style, no numbers in body). */
-function renderChecklistPlain(items) {
-	if (!items.length) return "(empty)";
-	const lines = [];
-	for (const it of items) {
-		let line = `${it.status === "completed" ? "[x]" : it.status === "impossible" ? "[!]" : "[ ]"} ${it.text}`;
-		if (it.status === "impossible" && it.evidence) line += ` (impossible: ${it.evidence})`;
-		lines.push(line);
-	}
-	return lines.join("\n");
-}
-/** Numbered checklist for judge user prompts (1-based indices). */
-function renderChecklistNumbered(items) {
-	if (!items.length) return "(empty)";
-	const lines = [];
-	for (let i = 0; i < items.length; i++) {
-		const it = items[i];
-		let line = `${i + 1}. ${it.status === "completed" ? "[x]" : it.status === "impossible" ? "[!]" : "[ ]"} ${it.text}`;
-		if (it.status === "impossible" && it.evidence) line += ` (impossible: ${it.evidence})`;
-		lines.push(line);
-	}
-	return lines.join("\n");
-}
-/**
-* After LLM decomposition, keep existing checklist rows (e.g. user-added acceptance criteria)
-* and append judge-generated items, skipping duplicate text (case-insensitive trim).
-*/
-function mergeDecomposedChecklistItems(existing, decomposedTexts) {
-	const now = Date.now();
-	const next = existing.map((it) => ({ ...it }));
-	const seen = new Set(next.map((it) => it.text.trim().toLowerCase()));
-	for (const row of decomposedTexts) {
-		const t = row.text.trim();
-		if (!t) continue;
-		const key = t.toLowerCase();
-		if (seen.has(key)) continue;
-		seen.add(key);
-		next.push({
-			text: t,
-			status: CHECKLIST_ITEM_PENDING,
-			addedBy: "judge",
-			addedAt: now
-		});
-	}
-	return next;
-}
-function applyJudgeChecklistUpdates(items, parsed) {
-	const next = items.map((it) => ({ ...it }));
-	const now = Date.now();
-	for (const upd of parsed.updates) {
-		const idx = upd.index;
-		if (idx < 0 || idx >= next.length) continue;
-		const item = next[idx];
-		if (TERMINAL_CHECKLIST_STATUSES.has(item.status)) continue;
-		if (!TERMINAL_CHECKLIST_STATUSES.has(upd.status)) continue;
-		item.status = upd.status;
-		item.completedAt = now;
-		if (upd.evidence?.trim()) item.evidence = upd.evidence.trim();
-	}
-	for (const ni of parsed.newItems) {
-		const t = ni.text.trim();
-		if (!t) continue;
-		next.push({
-			text: t,
-			status: CHECKLIST_ITEM_PENDING,
-			addedBy: "judge",
-			addedAt: now
-		});
-	}
-	return next;
-}
-//#endregion
-export { applyJudgeChecklistUpdates, defaultMaxTurns, mergeDecomposedChecklistItems, renderChecklistNumbered, renderChecklistPlain };

package/dist/src/agent/memory/builtin-memory-store.d.ts

@@ -1,54 +0,0 @@
-/**
- * Bounded curated memory under the shared user context directory, §-delimited entries.
- * Snapshot for system prompt is captured at load time and not mutated until next load.
- */
-import type { MemorySnapshot, MemoryStoreConfig } from './types.js';
-export declare const MEMORY_ENTRY_DELIMITER = "\n\u00A7\n";
-export declare class BuiltinMemoryStore {
-    private readonly config;
-    private memoryEntries;
-    private userEntries;
-    private snapshot;
-    constructor(config: MemoryStoreConfig);
-    /** When false, global user memory is omitted from the snapshot and should not be edited via `curated_memory`. */
-    isUserProfileEnabled(): boolean;
-    /** Shared curated memory directory (`~/.xopc/user/memories/`). */
-    get memoriesDir(): string;
-    /** Global user memory file (`~/.xopc/user/MEMORY.md`). */
-    get userMemoryPath(): string;
-    /** Workspace whose profile and curated files participate in local memory search. */
-    get workspaceDir(): string;
-    pathFor(target: 'memory' | 'user'): string;
-    /**
-     * Load from disk and freeze {@link getSnapshot}. Sync for agent creation (prefix cache stability).
-     */
-    loadFromDiskSync(): void;
-    private readPathSync;
-    private parseFileContent;
-    getSnapshot(): MemorySnapshot;
-    /**
-     * Live entries for read/debug (may differ from snapshot after mutations).
-     */
-    getLiveEntries(target: 'memory' | 'user'): string[];
-    add(target: 'memory' | 'user', content: string): Promise<{
-        success: boolean;
-        error?: string;
-        message?: string;
-    }>;
-    replace(target: 'memory' | 'user', oldText: string, newContent: string): Promise<{
-        success: boolean;
-        error?: string;
-        message?: string;
-    }>;
-    remove(target: 'memory' | 'user', oldText: string): Promise<{
-        success: boolean;
-        error?: string;
-        message?: string;
-    }>;
-    private withFileLock;
-    private reloadTargetFromDisk;
-    private flushTargetToDisk;
-    private charLimit;
-    private renderBlock;
-}
-export declare function scanForThreats(content: string): string | null;