@xopcai/xopc 0.0.208 → 0.0.210

package/dist/src/tasks/home-query-service.d.ts

@@ -14,6 +14,7 @@ type HomeAttention = HomeResponse['attention'][number];
 type HomeBriefingWin = HomeResponse['briefing']['wins'][number];
 type HomeAutomation = HomeResponse['upcomingAutomations'][number];
 type HomeFocusItem = HomeResponse['focusItems'][number];
+type HomeRecentTask = HomeResponse['recentTasks'][number];
 type HomeWorkflowRun = {
     id: string;
     definitionId: string;
@@ -151,7 +152,8 @@ export declare function buildHomeFocusItems(input: {
     activeWorkflowRuns: HomeWorkflowRun[];
     runningTasks: HomeResponse['tasks']['running'];
     wins: HomeBriefingWin[];
-    nextScheduled?: HomeAutomation;
+    scheduled: HomeAutomation[];
+    recentTasks: HomeRecentTask[];
     inboxCount: number;
     nowMs: number;
 }): HomeFocusItem[];

package/dist/src/tasks/home-query-service.js

@@ -124,6 +124,10 @@ function homeActionCopy(locale) {
 		viewProgress: "查看进度",
 		viewResult: "查看结果",
 		viewSchedule: "查看计划",
+		remaining: "项待继续",
+		taskCompleted: "任务已完成",
+		workflowCompleted: "工作流已完成",
+		automationCompleted: "自动化已完成",
 		runningTask: "任务正在推进",
 		runningWorkflow: "工作流正在推进",
 		scheduled: "下一项定时工作",
@@ -142,6 +146,10 @@ function homeActionCopy(locale) {
 		viewProgress: "View progress",
 		viewResult: "View result",
 		viewSchedule: "View schedule",
+		remaining: "remaining",
+		taskCompleted: "Task completed",
+		workflowCompleted: "Workflow completed",
+		automationCompleted: "Automation completed",
 		runningTask: "Task in progress",
 		runningWorkflow: "Workflow in progress",
 		scheduled: "Next scheduled work",
@@ -153,23 +161,26 @@ function homeActionCopy(locale) {
 		askAi: "Ask an agent"
 	};
 }
+function formatScheduleDistance(value, nowMs, locale) {
+	const distanceMs = Math.max(0, Date.parse(value) - nowMs);
+	const formatter = new Intl.RelativeTimeFormat(locale, { numeric: "always" });
+	const minutes = Math.max(1, Math.ceil(distanceMs / 6e4));
+	if (minutes < 60) return formatter.format(minutes, "minute");
+	const hours = Math.ceil(distanceMs / 36e5);
+	if (hours < 48) return formatter.format(hours, "hour");
+	return formatter.format(Math.ceil(distanceMs / 864e5), "day");
+}
 function buildHomeFocusItems(input) {
 	const copy = homeActionCopy(input.locale);
 	const decisions = input.decisions.map((decision) => {
 		const openAction = decision.kind === "agent_judgment" && decision.judgment ? {
-			type: "open",
+			type: "review_judgment",
 			label: copy.review,
-			target: "inbox_judgment",
-			targetId: decision.judgment.inboxItemId
-		} : decision.kind === "task" ? {
-			type: "open",
-			label: copy.review,
-			target: "task",
-			targetId: decision.id.replace(/^task:/, "")
+			itemId: decision.judgment.inboxItemId
 		} : {
 			type: "open",
 			label: copy.review,
-			target: "work"
+			href: decision.href
 		};
 		const connectorActions = decision.response?.kind === "connector_approval" ? {
 			primaryAction: {
@@ -196,7 +207,6 @@ function buildHomeFocusItems(input) {
 			summary: decision.detail || copy.review,
 			statusLabel: copy.review,
 			updatedAt: decision.updatedAt,
-			pinnable: false,
 			openAction,
 			...connectorActions
 		};
@@ -208,22 +218,10 @@ function buildHomeFocusItems(input) {
 		title: item.title,
 		summary: item.detail,
 		updatedAt: item.updatedAt,
-		pinnable: false,
-		openAction: item.kind === "workflow_run" ? item.sessionKey ? {
-			type: "open",
-			label: copy.review,
-			target: "session",
-			sessionKey: item.sessionKey
-		} : {
-			type: "open",
-			label: copy.review,
-			target: "workflow_run",
-			targetId: item.runId
-		} : {
+		openAction: {
 			type: "open",
 			label: copy.review,
-			target: "automation",
-			targetId: item.runId
+			href: item.href
 		},
 		primaryAction: {
 			type: "retry_run",
@@ -239,16 +237,10 @@ function buildHomeFocusItems(input) {
 		}]
 	}));
 	const workflows = input.activeWorkflowRuns.map((run) => {
-		const openAction = run.sessionKey ? {
-			type: "open",
-			label: copy.viewProgress,
-			target: "session",
-			sessionKey: run.sessionKey
-		} : {
+		const openAction = {
 			type: "open",
 			label: copy.viewProgress,
-			target: "workflow_run",
-			targetId: run.id
+			href: run.sessionKey ? `/chat/${encodeURIComponent(run.sessionKey)}` : `/workflows?runId=${encodeURIComponent(run.id)}`
 		};
 		return {
 			id: `workflow:${run.id}`,
@@ -258,7 +250,6 @@ function buildHomeFocusItems(input) {
 			summary: copy.runningWorkflow,
 			statusLabel: run.metrics.agentCount > 0 ? `${run.metrics.doneAgentCount}/${run.metrics.agentCount}` : void 0,
 			updatedAt: run.startedAtMs ?? run.createdAtMs,
-			pinnable: true,
 			openAction,
 			primaryAction: openAction,
 			secondaryActions: []
@@ -268,8 +259,7 @@ function buildHomeFocusItems(input) {
 		const openAction = {
 			type: "open",
 			label: copy.viewProgress,
-			target: "task",
-			targetId: task.id
+			href: `/tasks/${encodeURIComponent(task.id)}`
 		};
 		return {
 			id: `task:${task.id}`,
@@ -278,73 +268,82 @@ function buildHomeFocusItems(input) {
 			title: task.title,
 			summary: copy.runningTask,
 			updatedAt: task.updatedAt,
-			pinnable: true,
 			openAction,
 			primaryAction: openAction,
 			secondaryActions: []
 		};
 	});
 	const results = input.wins.map((win) => {
-		const openAction = win.kind === "workflow_run" ? {
-			type: "open",
-			label: copy.viewResult,
-			target: "workflow_run",
-			targetId: win.id.replace(/^workflow:/, "")
-		} : win.kind === "automation_run" ? {
-			type: "open",
-			label: copy.viewResult,
-			target: "automation",
-			targetId: win.id.replace(/^automation:/, "")
-		} : {
+		const openAction = {
 			type: "open",
 			label: copy.viewResult,
-			target: "task",
-			targetId: win.id.replace(/^task:/, "")
+			href: win.href
 		};
 		return {
 			id: win.id,
 			kind: "result",
 			priority: 40,
 			title: win.title,
-			summary: copy.viewResult,
+			summary: win.kind === "workflow_run" ? copy.workflowCompleted : win.kind === "automation_run" ? copy.automationCompleted : copy.taskCompleted,
 			updatedAt: win.completedAt,
-			pinnable: true,
 			openAction,
 			primaryAction: openAction,
 			secondaryActions: []
 		};
 	});
-	const scheduled = input.nextScheduled ? [{
-		id: `automation:${input.nextScheduled.id}:scheduled`,
+	const taskResults = input.recentTasks.map(({ taskId, taskTitle, receipt }) => {
+		const openAction = {
+			type: "open",
+			label: copy.viewResult,
+			href: `/tasks/${encodeURIComponent(taskId)}`
+		};
+		return {
+			id: `task-result:${taskId}:${receipt.runId}`,
+			kind: "result",
+			priority: 40,
+			title: taskTitle,
+			summary: receipt.summary,
+			statusLabel: receipt.remainingWork.length > 0 ? `${receipt.remainingWork.length} ${copy.remaining}` : void 0,
+			updatedAt: receipt.finalizedAt,
+			openAction,
+			primaryAction: openAction,
+			secondaryActions: []
+		};
+	});
+	const scheduled = input.scheduled.map((automation) => ({
+		id: `automation:${automation.id}:scheduled`,
 		kind: "scheduled",
 		priority: 30,
-		title: input.nextScheduled.name || input.nextScheduled.id,
+		title: automation.name || automation.id,
 		summary: copy.scheduled,
-		statusLabel: new Date(input.nextScheduled.nextRunAt).toLocaleString(input.locale),
-		updatedAt: Date.parse(input.nextScheduled.nextRunAt),
-		pinnable: true,
+		statusLabel: formatScheduleDistance(automation.nextRunAt, input.nowMs, input.locale),
+		updatedAt: Date.parse(automation.nextRunAt),
 		openAction: {
 			type: "open",
 			label: copy.viewSchedule,
-			target: "automation",
-			targetId: input.nextScheduled.id
+			href: `/automations?automation=${encodeURIComponent(automation.id)}`
 		},
 		primaryAction: {
 			type: "open",
 			label: copy.viewSchedule,
-			target: "automation",
-			targetId: input.nextScheduled.id
+			href: `/automations?automation=${encodeURIComponent(automation.id)}`
 		},
 		secondaryActions: []
-	}] : [];
+	}));
 	const items = [
 		...decisions,
 		...failures,
 		...workflows,
 		...tasks,
 		...results,
+		...taskResults,
 		...scheduled
-	].sort((left, right) => right.priority - left.priority || right.updatedAt - left.updatedAt);
+	].sort((left, right) => {
+		const priorityDelta = right.priority - left.priority;
+		if (priorityDelta !== 0) return priorityDelta;
+		if (left.kind === "scheduled" && right.kind === "scheduled") return left.updatedAt - right.updatedAt;
+		return right.updatedAt - left.updatedAt;
+	});
 	if (items.length > 0) return items;
 	if (input.inboxCount > 0) return [{
 		id: "suggestion:organize-inbox",
@@ -353,16 +352,15 @@ function buildHomeFocusItems(input) {
 		title: `${copy.organizeInbox} · ${input.inboxCount}`,
 		summary: copy.organizeInboxSummary,
 		updatedAt: input.nowMs,
-		pinnable: false,
 		openAction: {
 			type: "open",
 			label: copy.openInbox,
-			target: "inbox"
+			href: "/notes?status=inbox"
 		},
 		primaryAction: {
 			type: "open",
 			label: copy.openInbox,
-			target: "inbox"
+			href: "/notes?status=inbox"
 		},
 		secondaryActions: []
 	}];
@@ -373,7 +371,6 @@ function buildHomeFocusItems(input) {
 		title: copy.startSomething,
 		summary: copy.startSomethingSummary,
 		updatedAt: input.nowMs,
-		pinnable: false,
 		primaryAction: {
 			type: "ask_ai",
 			label: copy.askAi
@@ -525,7 +522,7 @@ var HomeQueryService = class {
 			id: `automation:${run.id}`,
 			kind: "automation_run",
 			title: run.automationName || run.automationId,
-			href: "/automations",
+			href: `/automations?automation=${encodeURIComponent(run.automationId)}&run=${encodeURIComponent(run.id)}`,
 			completedAt: run.endedAtMs ?? run.createdAtMs
 		}))].sort((left, right) => right.completedAt - left.completedAt);
 		const runningTasks = tasks.filter((task) => {
@@ -542,6 +539,11 @@ var HomeQueryService = class {
 			nextScheduled: upcomingAutomations[0],
 			nowMs
 		});
+		const recentTasks = tasks.flatMap((task) => this.#runs.listReceipts(task.id, 3).map((receipt) => ({
+			taskId: task.id,
+			taskTitle: task.title,
+			receipt
+		}))).sort((a, b) => b.receipt.finalizedAt - a.receipt.finalizedAt).slice(0, 8);
 		return {
 			focusItems: buildHomeFocusItems({
 				locale,
@@ -550,7 +552,8 @@ var HomeQueryService = class {
 				activeWorkflowRuns,
 				runningTasks,
 				wins,
-				nextScheduled: upcomingAutomations[0],
+				scheduled: upcomingAutomations.slice(0, 3),
+				recentTasks: recentTasks.slice(0, 3),
 				inboxCount: inbox.total,
 				nowMs
 			}),
@@ -590,7 +593,7 @@ var HomeQueryService = class {
 			},
 			upcomingAutomations,
 			tasks: { running: runningTasks },
-			recentTasks: tasks.flatMap((task) => this.#runs.listReceipts(task.id, 3)).sort((a, b) => b.finalizedAt - a.finalizedAt).slice(0, 8),
+			recentTasks,
 			recentAutomationRuns: automationRuns.slice(0, 5).map(toHomeAutomationRun)
 		};
 	}

package/dist/src/tui/backends/embedded-backend.js

@@ -1,8 +1,8 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { openXopcDatabase } from "../../storage/sqlite/connection.js";
-import { appendComposerInputHistory, listComposerInputHistory } from "../../storage/sqlite/composer-input-history-repository.js";
 import { init_agent_session_key, resolveAgentIdFromSessionKey } from "../../routing/agent-session-key.js";
+import { appendComposerInputHistory, listComposerInputHistory } from "../../storage/sqlite/composer-input-history-repository.js";
 import { getSessionMetadata } from "../../storage/sqlite/session-repository.js";
 import "../../storage/sqlite/index.js";
 import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";

package/dist/src/user-context/planner.d.ts

@@ -2,6 +2,7 @@ import type { AgentMessage } from '@earendil-works/pi-agent-core';
 import type { UserContextPlan } from '../agent/memory/context/types.js';
 export declare function prependAgentContext(message: AgentMessage, block: string): AgentMessage;
 export declare class UserContextPlanner {
+    private readonly retriever;
     plan(params: {
         sessionKey: string;
         workspaceId: string;

package/dist/src/user-context/planner.js

@@ -1,8 +1,10 @@
-import { consumeContextConsent, ensureContextConsent, getUserProfile, listCollaborationRules, listUnderstandings, recordContextRun } from "../storage/sqlite/user-context-repository.js";
+import { consumeContextConsent, ensureContextConsent, getUserProfile, listCollaborationRules, recordContextRun } from "../storage/sqlite/user-context-repository.js";
 import "../storage/sqlite/index.js";
 import { readAgentMessageContent } from "../agent/memory/agent-message-access.js";
 import { buildUserContextBlock } from "../agent/memory/context-fence.js";
 import { listUserFocuses } from "./sources/repository.js";
+import { matchesUserContextScope } from "./scope.js";
+import { UserUnderstandingRetriever } from "./retriever.js";
 import { randomUUID } from "node:crypto";
 //#region src/user-context/planner.ts
 const DEFAULT_MAX_CONTEXT_CHARS = 6e3;
@@ -33,28 +35,6 @@ function prependAgentContext(message, block) {
 	}
 	return message;
 }
-function scopeMatches(scope, input) {
-	if (scope.type === "global") return true;
-	if (scope.type === "session") return scope.id === input.sessionKey;
-	if (scope.type === "workspace") return scope.id === input.workspaceId;
-	return Boolean(input.projectId && scope.id === input.projectId);
-}
-function terms(value) {
-	const normalized = value.toLocaleLowerCase().replace(/[^\p{L}\p{N}]+/gu, " ").trim();
-	const words = normalized.split(/\s+/).filter((word) => word.length > 1);
-	const cjk = [...normalized.replace(/[^\p{Script=Han}]/gu, "")];
-	for (let index = 0; index < cjk.length - 1; index += 1) words.push(`${cjk[index]}${cjk[index + 1]}`);
-	return new Set(words);
-}
-function relevance(query, item) {
-	const queryTerms = terms(query);
-	const itemTerms = terms(item.statement);
-	const shared = [...queryTerms].filter((term) => itemTerms.has(term)).length;
-	const lexical = queryTerms.size ? shared / queryTerms.size : 0;
-	const baseline = item.kind === "boundary" && item.explicitness === "explicit" ? .8 : item.kind === "preference" && item.explicitness === "explicit" ? .35 : 0;
-	const explicitness = item.explicitness === "explicit" ? .1 : item.explicitness === "observed" ? .05 : 0;
-	return Math.min(1, Math.max(baseline, lexical * .75 + item.confidence * .15 + explicitness));
-}
 function sectionFor(item) {
 	if (item.kind === "boundary") return "safety";
 	if ([
@@ -77,18 +57,19 @@ function sourceLabel(item) {
 function rejectionReason(item, input, now) {
 	if (item.status === "needs_review" || item.status === "stale" || item.status === "candidate") return "needs_review";
 	if (item.status === "archived" || item.status === "rejected") return "disabled";
-	if (!scopeMatches(item.scope, input)) return "scope_mismatch";
+	if (!matchesUserContextScope(item.scope, input)) return "scope_mismatch";
 	if (item.validFrom && item.validFrom > now) return "not_yet_valid";
 	if (item.validTo && item.validTo < now || item.expiresAt && item.expiresAt < now) return "expired";
 	if (item.sensitivity === "secret" || item.sensitivity === "regulated") return "sensitive";
 	if (item.conflictGroupId) return "conflict";
 }
 function ruleMatches(rule, input) {
-	if (rule.status !== "active" || !scopeMatches(rule.scope, input)) return false;
+	if (rule.status !== "active" || !matchesUserContextScope(rule.scope, input)) return false;
 	const channel = typeof rule.conditions.channel === "string" ? rule.conditions.channel : void 0;
 	return !channel || channel === input.channel;
 }
 var UserContextPlanner = class {
+	retriever = new UserUnderstandingRetriever();
 	plan(params) {
 		const traceId = randomUUID();
 		const query = params.query.trim();
@@ -176,10 +157,16 @@ var UserContextPlanner = class {
 				injectedChars: rule.statement.length
 			});
 		}
-		const ranked = listUnderstandings(["active"]).filter((item) => !excluded.has(item.id)).map((item) => ({
-			item,
-			score: relevance(query, item)
-		})).sort((left, right) => right.score - left.score).slice(0, Math.max(maxResults * 5, 50));
+		const ranked = this.retriever.retrieve({
+			query,
+			sessionKey: params.sessionKey,
+			workspaceId: params.workspaceId,
+			...params.projectId ? { projectId: params.projectId } : {},
+			maxCandidates: Math.max(maxResults * 5, 50)
+		}).filter((result) => !excluded.has(result.understanding.id)).map((result) => ({
+			item: result.understanding,
+			score: result.score
+		}));
 		for (const { item, score } of ranked) {
 			if (items.length >= maxResults) {
 				rejected.push({

package/dist/src/user-context/retriever.d.ts

@@ -0,0 +1,15 @@
+import type { UserUnderstanding } from './domain.js';
+export interface UnderstandingRetrievalResult {
+    understanding: UserUnderstanding;
+    score: number;
+    reasons: string[];
+}
+export declare class UserUnderstandingRetriever {
+    retrieve(params: {
+        query: string;
+        sessionKey: string;
+        workspaceId: string;
+        projectId?: string;
+        maxCandidates: number;
+    }): UnderstandingRetrievalResult[];
+}

package/dist/src/user-context/retriever.js

@@ -0,0 +1,65 @@
+import { summarizeUnderstandingFeedback } from "../storage/sqlite/user-context-quality-repository.js";
+import { listUnderstandings, searchActiveUnderstandings } from "../storage/sqlite/user-context-repository.js";
+import { normalizeRetrievalText, retrievalLexicalSimilarity } from "../retrieval/textFeatures.js";
+import { buildRetrievalQueryProfile } from "../retrieval/queryProfile.js";
+import "../storage/sqlite/index.js";
+import { matchesUserContextScope } from "./scope.js";
+//#region src/user-context/retriever.ts
+function authorityBonus(item) {
+	if (item.explicitness === "explicit") return .1;
+	if (item.explicitness === "observed") return .05;
+	return 0;
+}
+function baseline(item) {
+	if (item.kind === "boundary" && item.explicitness === "explicit") return .8;
+	if (item.kind === "preference" && item.explicitness === "explicit") return .35;
+	return 0;
+}
+function feedbackAdjustment(summary) {
+	if (!summary || summary.total < 3) return 0;
+	const helpfulRate = (summary.helpful + 1) / (summary.total + 2);
+	const relevancePenalty = summary.irrelevant >= 3 ? .05 : 0;
+	return Math.max(-.1, Math.min(.05, (helpfulRate - .5) * .1 - relevancePenalty));
+}
+var UserUnderstandingRetriever = class {
+	retrieve(params) {
+		const profile = buildRetrievalQueryProfile(params.query, {
+			sessionKey: params.sessionKey,
+			workspaceId: params.workspaceId,
+			...params.projectId ? { projectId: params.projectId } : {}
+		});
+		if (!profile.normalized) return [];
+		const maxCandidates = Math.max(1, Math.min(200, Math.floor(params.maxCandidates)));
+		const fts = searchActiveUnderstandings(profile.normalized, Math.max(50, maxCandidates));
+		const ftsScores = new Map(fts.map((result) => [result.understanding.id, result.score]));
+		const recentLimit = Math.max(200, Math.min(500, maxCandidates * 5));
+		const recent = listUnderstandings(["active"]).slice(0, recentLimit);
+		const candidates = /* @__PURE__ */ new Map();
+		for (const result of fts) candidates.set(result.understanding.id, result.understanding);
+		for (const item of recent) candidates.set(item.id, item);
+		const feedback = new Map(summarizeUnderstandingFeedback([...candidates.keys()]).map((summary) => [summary.understandingId, summary]));
+		return [...candidates.values()].map((item) => {
+			const lexical = retrievalLexicalSimilarity(profile.normalized, item.statement);
+			const ftsScore = ftsScores.get(item.id) ?? 0;
+			const textScore = Math.max(lexical, ftsScore);
+			const kindMatched = profile.intentKinds.includes(item.kind);
+			const normalizedStatement = normalizeRetrievalText(item.statement);
+			const identifierMatched = profile.identifiers.some((identifier) => normalizedStatement.includes(identifier));
+			const feedbackScore = feedbackAdjustment(feedback.get(item.id));
+			return {
+				understanding: item,
+				score: Math.min(1, Math.max(0, Math.max(baseline(item), textScore * .7 + lexical * .1 + item.confidence * .1 + authorityBonus(item) + (kindMatched ? .08 : 0) + (identifierMatched ? .12 : 0) + (matchesUserContextScope(item.scope, params) && item.scope.type !== "global" ? .05 : 0)) + feedbackScore)),
+				reasons: [
+					ftsScore > 0 ? "fts" : "",
+					lexical > 0 ? "lexical" : "",
+					identifierMatched ? "identifier" : "",
+					kindMatched ? "kind" : "",
+					item.explicitness === "explicit" ? "explicit" : "",
+					feedbackScore !== 0 ? "feedback" : ""
+				].filter(Boolean)
+			};
+		}).sort((left, right) => Number(matchesUserContextScope(right.understanding.scope, params)) - Number(matchesUserContextScope(left.understanding.scope, params)) || right.score - left.score || right.understanding.updatedAt - left.understanding.updatedAt).slice(0, maxCandidates);
+	}
+};
+//#endregion
+export { UserUnderstandingRetriever };

package/dist/src/user-context/scope.d.ts

@@ -0,0 +1,7 @@
+import type { UserContextScope } from './domain.js';
+export interface UserContextScopeTarget {
+    sessionKey: string;
+    workspaceId: string;
+    projectId?: string;
+}
+export declare function matchesUserContextScope(scope: UserContextScope, target: UserContextScopeTarget): boolean;

package/dist/src/user-context/scope.js

@@ -0,0 +1,9 @@
+//#region src/user-context/scope.ts
+function matchesUserContextScope(scope, target) {
+	if (scope.type === "global") return true;
+	if (scope.type === "session") return scope.id === target.sessionKey;
+	if (scope.type === "workspace") return scope.id === target.workspaceId;
+	return Boolean(target.projectId && scope.id === target.projectId);
+}
+//#endregion
+export { matchesUserContextScope };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.208",
+  "version": "0.0.210",
   "description": "Local-first AI system that remembers context, coordinates AI, and sustains long-term progress.",
   "type": "module",
   "main": "dist/src/index.js",