@xopcai/xopc 0.0.187 → 0.0.189

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

@@ -0,0 +1,34 @@
+import { isActionableUnderstandingContent, isNearDuplicateUnderstanding } from "./understandingQuality.js";
+//#region src/user-context/actionableInsights.ts
+const USER_CONFIRMED_MEMORY_TAG = "user-confirmed";
+const INSIGHT_ACCEPTED_TAG = "insight-action:accepted";
+const INSIGHT_DISMISSED_TAG = "insight-action:dismissed";
+function actionFor(record) {
+	if (record.kind === "routine") return "make_repeatable";
+	if (record.kind === "long_term_goal") return "start_progress";
+	if (record.kind === "task_lesson" || record.kind === "derived_insight") return "add_playbook";
+	return null;
+}
+function buildActionableInsightSuggestions(records, existingTaskTexts) {
+	const selected = [];
+	const sorted = records.filter((record) => record.status === "active").filter((record) => record.tags?.includes(USER_CONFIRMED_MEMORY_TAG)).filter((record) => !record.tags?.includes("insight-action:accepted") && !record.tags?.includes("insight-action:dismissed")).filter((record) => isActionableUnderstandingContent(record.content)).filter((record) => record.kind !== "long_term_goal" || record.durability !== "ephemeral").sort((left, right) => right.importance - left.importance || Date.parse(right.updatedAt) - Date.parse(left.updatedAt));
+	for (const record of sorted) {
+		const action = actionFor(record);
+		if (!action) continue;
+		if (selected.some((item) => item.action === action && isNearDuplicateUnderstanding(item.insight, record.content))) continue;
+		if (action === "start_progress" && existingTaskTexts.some((text) => isNearDuplicateUnderstanding(text, record.content))) continue;
+		selected.push({
+			id: record.id,
+			insight: record.content,
+			kind: record.kind,
+			action,
+			evidenceCount: record.evidence?.length ?? 0,
+			confidence: record.confidence,
+			sourceName: record.source.provider ?? "local"
+		});
+		if (selected.length === 5) break;
+	}
+	return selected;
+}
+//#endregion
+export { INSIGHT_ACCEPTED_TAG, INSIGHT_DISMISSED_TAG, USER_CONFIRMED_MEMORY_TAG, buildActionableInsightSuggestions };

package/dist/src/user-context/manual-understanding.js

@@ -2,6 +2,7 @@ import { listMemoryRecords, upsertMemoryRecord } from "../storage/sqlite/memory-
 import "../storage/sqlite/index.js";
 import { nextMemoryReviewAt } from "../agent/memory/lifecycle.js";
 import { isUserContextRecord } from "./projection.js";
+import { USER_CONFIRMED_MEMORY_TAG } from "./actionableInsights.js";
 //#region src/user-context/manual-understanding.ts
 const STATUSES = [
 	"candidate",
@@ -50,7 +51,11 @@ function createManualUnderstanding(input) {
 				path: "you://manual"
 			},
 			confidence: 1,
-			tags: ["user-understanding", "explicit-user-memory"],
+			tags: [
+				"user-understanding",
+				"explicit-user-memory",
+				USER_CONFIRMED_MEMORY_TAG
+			],
 			status: "active",
 			sensitivity: input.sensitivity,
 			explicitness: "explicit",

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

@@ -4,6 +4,7 @@ import type { KnowledgeSourceItem, KnowledgeSyncRun } from '../knowledge/types.j
 import type { ConnectorLearningJob } from '../storage/sqlite/index.js';
 export type UserContextFacet = 'basics' | 'collaboration' | 'boundaries' | 'priorities' | 'people' | 'current';
 export type UserContextOrigin = 'told_by_you' | 'observed' | 'inferred' | 'connected_source';
+export declare const USER_CONTEXT_MEMORY_KINDS: readonly MemoryKind[];
 export declare function isUserContextRecord(record: MemoryRecord): boolean;
 export declare function isUserContextMemoryKind(value: unknown): value is MemoryKind;
 export declare function facetForMemoryKind(kind: MemoryKind): UserContextFacet;
@@ -67,7 +68,7 @@ export declare function projectPersonalContextSources(definitions: ConnectorDefi
     }>;
 }): {
     category: import("../connectors/types.js").ConnectorCategory;
-    capabilities: ("context" | "tools" | "events" | "memory_source")[];
+    capabilities: ("tools" | "context" | "events" | "memory_source")[];
     access: {
         context: boolean;
         memory: boolean;

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

@@ -20,6 +20,7 @@ const CONTEXTUAL_USER_KINDS = new Set([
 	"derived_insight",
 	"task_lesson"
 ]);
+const USER_CONTEXT_MEMORY_KINDS = [...ALWAYS_PERSONAL_KINDS, ...CONTEXTUAL_USER_KINDS];
 function isUserContextRecord(record) {
 	if (ALWAYS_PERSONAL_KINDS.has(record.kind)) return true;
 	return CONTEXTUAL_USER_KINDS.has(record.kind) && record.tags?.includes("user-understanding") === true;
@@ -258,4 +259,4 @@ function projectPersonalContextSources(definitions, instances, knowledge = {}) {
 	});
 }
 //#endregion
-export { facetForMemoryKind, isPersonalContextConnector, isUserContextMemoryKind, isUserContextRecord, originForMemoryRecord, projectPersonalContextSources, projectUserContextRecord, recordsDerivedFromPersonalContextSource };
+export { USER_CONTEXT_MEMORY_KINDS, facetForMemoryKind, isPersonalContextConnector, isUserContextMemoryKind, isUserContextRecord, originForMemoryRecord, projectPersonalContextSources, projectUserContextRecord, recordsDerivedFromPersonalContextSource };

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

@@ -0,0 +1,5 @@
+import type { MemoryKind } from '../agent/memory/types.js';
+export declare function isStandaloneUnderstandingContent(content: string): boolean;
+export declare function isActionableUnderstandingContent(content: string): boolean;
+export declare function isDurableUnderstandingCandidate(kind: MemoryKind, content: string): boolean;
+export declare function isNearDuplicateUnderstanding(left: string, right: string): boolean;

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

@@ -0,0 +1,44 @@
+//#region src/user-context/understandingQuality.ts
+const INCOMPLETE_PREFIX = /^(?:and\b|also\b|then\b|plus\b|as\s+well\s+as\b|which\b|that\b|并且|并将|以及|然后|同时|另外|还有|而且|或者|的事项|事项[，,、：:]?)/i;
+const DEFERRED_OR_NEGATED_ACTION = /(?:not\s+now|no\s+need\s+to|do\s+not\s+(?:start|proceed)|don't\s+(?:start|proceed)|later\s+maybe|暂时不用|暂时不(?:用|要|开始)?|先不用|无需|不用开始|不要推进|不需要推进)/i;
+const ONE_OFF_ACTION_PREFIX = /^(?:please\s+|update\b|investigate\b|summari[sz]e\b|fix\b|write\b|add\b|record\b|track\b)|^(?:请|帮我|更新|调查|汇总|整理|修复|写入|加入|记录|跟进)/i;
+function meaningfulLength(content) {
+	return content.normalize("NFKC").replace(/[\p{P}\p{S}\s]/gu, "").length;
+}
+function isStandaloneUnderstandingContent(content) {
+	const normalized = content.normalize("NFKC").trim();
+	return meaningfulLength(normalized) >= 4 && !INCOMPLETE_PREFIX.test(normalized) && !DEFERRED_OR_NEGATED_ACTION.test(normalized);
+}
+function isActionableUnderstandingContent(content) {
+	return meaningfulLength(content) >= 8 && isStandaloneUnderstandingContent(content);
+}
+function isDurableUnderstandingCandidate(kind, content) {
+	if (!isStandaloneUnderstandingContent(content)) return false;
+	if ((kind === "commitment" || kind === "long_term_goal") && ONE_OFF_ACTION_PREFIX.test(content.trim())) return false;
+	return true;
+}
+function comparableText(content) {
+	return content.normalize("NFKC").toLocaleLowerCase().replace(/[\p{P}\p{S}\s]/gu, "");
+}
+function bigrams(content) {
+	const result = /* @__PURE__ */ new Set();
+	for (let index = 0; index < content.length - 1; index += 1) result.add(content.slice(index, index + 2));
+	return result;
+}
+function isNearDuplicateUnderstanding(left, right) {
+	const a = comparableText(left);
+	const b = comparableText(right);
+	if (!a || !b) return false;
+	if (a === b) return true;
+	const shorter = a.length <= b.length ? a : b;
+	const longer = a.length > b.length ? a : b;
+	if (shorter.length >= 8 && longer.includes(shorter) && shorter.length / longer.length >= .55) return true;
+	if (shorter.length < 4) return false;
+	const aPairs = bigrams(a);
+	const bPairs = bigrams(b);
+	let overlap = 0;
+	for (const pair of aPairs) if (bPairs.has(pair)) overlap += 1;
+	return 2 * overlap / (aPairs.size + bPairs.size) >= .78;
+}
+//#endregion
+export { isActionableUnderstandingContent, isDurableUnderstandingCandidate, isNearDuplicateUnderstanding, isStandaloneUnderstandingContent };

package/dist/src/utils/logger/log-stream.d.ts

@@ -1,15 +1,8 @@
-/**
- * Log Streaming Module - SSE real-time log delivery
- */
+/** In-process live log fan-out. */
 import type { LogLevel, LogEntry } from './types.js';
 export type { LogLevel, LogEntry };
+type LogSubscriber = (entry: LogEntry) => void;
+export declare function subscribeToLogs(subscriber: LogSubscriber): () => void;
 export declare function hasSubscribers(): boolean;
 /** @internal Called from Pino live emit stream */
 export declare function emitLogEntry(entry: LogEntry): void;
-/** Hono handler for `GET /api/logs/stream`. */
-export declare function createLogSSEHandler(): (c: {
-    req: {
-        raw: Request;
-        url: string;
-    };
-}) => Promise<Response>;

package/dist/src/utils/logger/log-stream.js

@@ -4,9 +4,6 @@ function subscribeToLogs(subscriber) {
 	subscribers.add(subscriber);
 	return () => subscribers.delete(subscriber);
 }
-function getSubscriberCount() {
-	return subscribers.size;
-}
 function hasSubscribers() {
 	return subscribers.size > 0;
 }
@@ -17,78 +14,10 @@ function emitLogEntry(entry) {
 		subscriber(entry);
 	} catch {}
 }
-function parseAllowedLevels(levelsParam) {
-	if (!levelsParam) return [
-		"info",
-		"warn",
-		"error",
-		"fatal"
-	];
-	return levelsParam.split(",").filter((l) => VALID_LEVELS.includes(l));
-}
-function createLogSseResponse(req, allowedLevels, moduleFilter) {
-	const stream = new ReadableStream({ start(controller) {
-		const encoder = new TextEncoder();
-		const sendEvent = (data) => {
-			const message = `data: ${JSON.stringify(data)}\n\n`;
-			controller.enqueue(encoder.encode(message));
-		};
-		sendEvent({
-			type: "connected",
-			message: "Log stream started"
-		});
-		const unsubscribe = subscribeToLogs((entry) => {
-			if (!allowedLevels.includes(entry.level)) return;
-			if (moduleFilter && entry.module !== moduleFilter) return;
-			sendEvent(entry);
-		});
-		const heartbeat = setInterval(() => {
-			try {
-				sendEvent({
-					type: "heartbeat",
-					subscribers: getSubscriberCount()
-				});
-			} catch {
-				clearInterval(heartbeat);
-			}
-		}, 3e4);
-		req.signal.addEventListener("abort", () => {
-			unsubscribe();
-			clearInterval(heartbeat);
-			try {
-				controller.close();
-			} catch {}
-		});
-	} });
-	return new Response(stream, { headers: {
-		"Content-Type": "text/event-stream",
-		"Cache-Control": "no-cache",
-		Connection: "keep-alive",
-		"X-Accel-Buffering": "no"
-	} });
-}
-/** Hono handler for `GET /api/logs/stream`. */
-function createLogSSEHandler() {
-	return async (c) => {
-		const url = new URL(c.req.url);
-		const allowedLevels = parseAllowedLevels(url.searchParams.get("levels"));
-		const moduleFilter = url.searchParams.get("module");
-		return createLogSseResponse(c.req.raw, allowedLevels, moduleFilter);
-	};
-}
-var subscribers, VALID_LEVELS;
+var subscribers;
 var init_log_stream = __esmMin((() => {
 	subscribers = /* @__PURE__ */ new Set();
-	VALID_LEVELS = [
-		"trace",
-		"debug",
-		"info",
-		"warn",
-		"error",
-		"fatal",
-		"silent"
-	];
 }));
 //#endregion
 init_log_stream();
-export { createLogSSEHandler, emitLogEntry, hasSubscribers, init_log_stream };
+export { emitLogEntry, hasSubscribers, init_log_stream, subscribeToLogs };

package/dist/src/utils/logger/pino-record.d.ts

@@ -1,5 +1,5 @@
 /**
- * Shared Pino JSON record → LogEntry conversion for file query and live SSE.
+ * Shared Pino JSON record → LogEntry conversion for file query and live realtime delivery.
  */
 import type { LogEntry } from './types.js';
 /** Convert a parsed Pino JSON object into a normalized LogEntry. */

package/dist/src/utils/logger/streams.js

@@ -32,7 +32,7 @@ function createLogStream(filePath) {
 		encoding: "utf-8"
 	});
 }
-/** Push parsed Pino lines to live SSE subscribers when any are connected. */
+/** Push parsed Pino lines to live realtime subscribers when any are connected. */
 function createLiveEmitStream() {
 	return new Writable({ write(chunk, _encoding, callback) {
 		if (hasSubscribers()) try {

package/dist/src/voice/local/model-files.js

@@ -2,8 +2,8 @@ import { dirname, join } from "node:path";
 import { createReadStream, createWriteStream } from "node:fs";
 import { createHash } from "node:crypto";
 import { mkdir, rm, stat } from "node:fs/promises";
-import { pipeline } from "node:stream/promises";
 import { Readable } from "node:stream";
+import { pipeline } from "node:stream/promises";
 //#region src/voice/local/model-files.ts
 function resolveModelFileUrl(remoteHost, model, file) {
 	const base = remoteHost.endsWith("/") ? remoteHost : `${remoteHost}/`;

package/dist/src/work-discovery/service.js

@@ -801,7 +801,7 @@ var WorkDiscoveryService = class {
 	preserveMemoryRecord(record, patch) {
 		return upsertMemoryRecord({
 			id: record.id,
-			providerId: "local",
+			providerId: record.providerId,
 			kind: record.kind,
 			sourceAgentId: record.provenance.sourceAgentId,
 			workspaceId: record.scope.workspaceId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.187",
+  "version": "0.0.189",
   "description": "Local-first AI system that remembers context, coordinates AI, and sustains long-term progress.",
   "type": "module",
   "main": "dist/src/index.js",
@@ -163,7 +163,10 @@
     "vitepress": "^1.6.4",
     "vitest": "4.1.5",
     "vue": "^3.5.35",
-    "@xopcai/gateway-contract": "0.0.0"
+    "@xopcai/endpoint-tools-protocol": "0.0.0",
+    "@xopcai/gateway-contract": "0.0.0",
+    "@xopcai/realtime-protocol": "0.0.0",
+    "@xopcai/realtime-client": "0.0.0"
   },
   "scripts": {
     "assets:brand": "node scripts/generate-brand-assets.mjs",
@@ -186,7 +189,7 @@
     "mobile:lint": "pnpm -C apps/mobile-expo run lint",
     "mobile:typecheck": "pnpm -C apps/mobile-expo run typecheck",
     "mobile:test": "pnpm -C apps/mobile-expo test",
-    "mobile:test:sse": "pnpm --filter @xopcai/gateway-sse-client test",
+    "mobile:test:stream": "pnpm --filter @xopcai/agent-stream-client test",
     "mobile:release:patch": "bash scripts/apps/mobile-expo/release-patch.sh",
     "dev": "tsx src/cli/bin.ts",
     "dev:init": "sh -c 'mkdir -p \"$HOME/.xopc-dev\" && XOPC_STATE_DIR=\"$HOME/.xopc-dev\" XOPC_CONFIG_PATH=\"$HOME/.xopc-dev/xopc.json\" XOPC_CONFIG=\"$HOME/.xopc-dev/xopc.json\" XOPC_LOG_DIR=\"$HOME/.xopc-dev/logs\" XOPC_LOG_LEVEL=info tsx src/cli/bin.ts init \"$@\"' --",