@xopcai/xopc 0.0.315 → 0.0.317

package/dist/src/connectors/learning-coordinator.js

@@ -15,7 +15,7 @@ import "../knowledge/index.js";
 import { ingestComposioConnectedSource } from "./connected-source-ingestion.js";
 import { deriveConnectedSourceUnderstanding } from "./connected-source-understanding.js";
 import { listConnectedContentCandidates, readConnectedContent } from "./content-enrichment.js";
-import { createUnderstandingSourceRun, getUnderstandingSourceGrant, listUnderstandingSourceGrants, listUnderstandingSourceRuns, updateUnderstandingSourceGrantCheckpoint, updateUnderstandingSourceRun, upsertUnderstandingSourceGrant } from "../user-context/sources/repository.js";
+import { getConnectorUnderstandingSourceRun, getOrCreateConnectorUnderstandingSourceRun, getUnderstandingSourceGrant, listUnderstandingSourceGrants, updateUnderstandingSourceGrantCheckpoint, updateUnderstandingSourceRun, upsertUnderstandingSourceGrant } from "../user-context/sources/repository.js";
 //#region src/connectors/learning-coordinator.ts
 init_logger();
 const log = createLogger("ConnectorLearning");
@@ -35,29 +35,26 @@ function connectorSourceCategory(toolkit) {
 function ensureUnderstandingSourceRun(job, toolkit, displayName) {
 	const existing = listUnderstandingSourceGrants({ includeRevoked: true }).find((grant) => grant.sourceKey === `connector-account:${job.accountId}`);
 	if (existing?.status === "revoked") throw new Error("Source authorization was revoked.");
-	const grant = existing ?? upsertUnderstandingSourceGrant({
-		sourceKey: `connector-account:${job.accountId}`,
-		adapterId: `connector:${job.connectorId}`,
-		category: connectorSourceCategory(toolkit),
-		platform: "all",
-		displayName,
-		accessMode: "continuous",
-		retentionPolicy: "bounded_raw",
-		processingPolicy: "remote_allowed",
-		config: {
-			connectorId: job.connectorId,
-			accountId: job.accountId,
-			readOnly: true
-		}
-	});
-	return listUnderstandingSourceRuns(grant.id, 100).find((run) => run.metadata.connectorLearningJobId === job.id) ?? createUnderstandingSourceRun({
-		grantId: grant.id,
+	return getOrCreateConnectorUnderstandingSourceRun({
+		grantId: (existing ?? upsertUnderstandingSourceGrant({
+			sourceKey: `connector-account:${job.accountId}`,
+			adapterId: `connector:${job.connectorId}`,
+			category: connectorSourceCategory(toolkit),
+			platform: "all",
+			displayName,
+			accessMode: "continuous",
+			retentionPolicy: "bounded_raw",
+			processingPolicy: "remote_allowed",
+			config: {
+				connectorId: job.connectorId,
+				accountId: job.accountId,
+				readOnly: true
+			}
+		})).id,
+		connectorLearningJobId: job.id,
 		kind: job.mode,
 		status: "queued",
-		metadata: {
-			connectorLearningJobId: job.id,
-			connectorId: job.connectorId
-		}
+		metadata: { connectorId: job.connectorId }
 	});
 }
 function learningEnabled(config) {
@@ -177,6 +174,7 @@ function startConnectorLearningCoordinator(options) {
 		}
 		let itemsSeen = 0;
 		let itemsIndexed = 0;
+		const changedSourceItemIds = /* @__PURE__ */ new Set();
 		for (const stream of plan.streams) {
 			const synced = await ingestComposioConnectedSource({
 				config: options.getConfig(),
@@ -191,6 +189,7 @@ function startConnectorLearningCoordinator(options) {
 			});
 			itemsSeen += synced.itemsSeen;
 			itemsIndexed += synced.itemsIndexed;
+			for (const sourceItemId of synced.sourceItemIds) changedSourceItemIds.add(sourceItemId);
 		}
 		const enrichmentErrors = [];
 		if (plan.toolkit === "googledrive") {
@@ -206,6 +205,7 @@ function startConnectorLearningCoordinator(options) {
 				});
 				enrichmentErrors.push(...enriched.failed.map((failure) => failure.error));
 				itemsIndexed += enriched.completed;
+				for (const sourceItemId of enriched.sourceItemIds) changedSourceItemIds.add(sourceItemId);
 			}
 		}
 		if (listConnectorLearningJobs({
@@ -229,6 +229,7 @@ function startConnectorLearningCoordinator(options) {
 				config: options.getConfig(),
 				agentId: job.agentId,
 				sourceInstanceId: job.sourceInstanceId,
+				sourceItemIds: [...changedSourceItemIds],
 				sourceRunId: sourceRun.id,
 				processingPolicy: getUnderstandingSourceGrant(sourceRun.grantId)?.processingPolicy ?? "local_only",
 				assertAuthorized: () => {
@@ -324,8 +325,7 @@ function startConnectorLearningCoordinator(options) {
 					}));
 					const definition = getConnectorDefinition(job.connectorId);
 					if (definition?.runtime.type === "composio" && definition.runtime.role === "toolkit") {
-						const grant = listUnderstandingSourceGrants({ includeRevoked: true }).find((item) => item.sourceKey === `connector-account:${job.accountId}`);
-						const sourceRun = grant && listUnderstandingSourceRuns(grant.id, 100).find((item) => item.metadata.connectorLearningJobId === job.id);
+						const sourceRun = listUnderstandingSourceGrants({ includeRevoked: true }).find((item) => item.sourceKey === `connector-account:${job.accountId}`) && getConnectorUnderstandingSourceRun(job.id);
 						if (sourceRun) updateUnderstandingSourceRun(sourceRun.id, {
 							status: "failed",
 							errorMessage: learningFailureCode(err),

package/dist/src/gateway/chat-stream/mapper.js

@@ -168,7 +168,8 @@ var ChatStreamMapper = class {
 		if (delta?.type === "text_delta" && typeof delta.delta === "string" && delta.delta) {
 			events.push(this.make("assistant_delta", {
 				messageId,
-				delta: delta.delta
+				delta: delta.delta,
+				offset: this.currentAssistantText.length
 			}));
 			this.currentAssistantText += delta.delta;
 		}
@@ -182,7 +183,8 @@ var ChatStreamMapper = class {
 			if (suffix) {
 				events.push(this.make("assistant_delta", {
 					messageId,
-					delta: suffix
+					delta: suffix,
+					offset: this.currentAssistantText.length
 				}));
 				this.currentAssistantText = text || `${this.currentAssistantText}${suffix}`;
 			}
@@ -204,10 +206,12 @@ var ChatStreamMapper = class {
 		const text = extractTextFromMessage(message);
 		const suffix = appendSuffix(this.currentAssistantText, text);
 		if (!suffix) return [];
+		const offset = this.currentAssistantText.length;
 		this.currentAssistantText = text || `${this.currentAssistantText}${suffix}`;
 		return [this.make("assistant_delta", {
 			messageId,
-			delta: suffix
+			delta: suffix,
+			offset
 		})];
 	}
 	mapMessageEnd(raw) {
@@ -227,7 +231,8 @@ var ChatStreamMapper = class {
 		const suffix = appendSuffix(this.currentAssistantText, text);
 		if (suffix) events.push(this.make("assistant_delta", {
 			messageId,
-			delta: suffix
+			delta: suffix,
+			offset: this.currentAssistantText.length
 		}));
 		this.currentAssistantText = text || this.currentAssistantText;
 		events.push(this.make("thinking_end", { messageId }));

package/dist/src/gateway/chat-stream/protocol.d.ts

@@ -44,7 +44,8 @@ export type AssistantMessageStartEvent = ChatStreamEnvelope<'assistant_message_s
 }>;
 export type AssistantDeltaEvent = ChatStreamEnvelope<'assistant_delta', {
     messageId: string;
-    delta: string;
+    delta: string; /** UTF-16 offset before this delta. */
+    offset?: number;
 }>;
 export type ThinkingDeltaEvent = ChatStreamEnvelope<'thinking_delta', {
     messageId: string;

package/dist/src/gateway/hono/lib/config-payload.d.ts

@@ -28,7 +28,7 @@ export declare function buildSafeWebConfigPayload(service: GatewayService, optio
                     primary: string;
                     fallbacks: string[];
                 };
-                intents?: Partial<Record<"review" | "coding" | "understanding" | "fast" | "reasoning" | "vision", {
+                intents?: Partial<Record<"review" | "coding" | "fast" | "reasoning" | "vision" | "understanding", {
                     primary: string;
                     fallbacks: string[];
                 }>>;
@@ -72,7 +72,7 @@ export declare function buildSafeWebConfigPayload(service: GatewayService, optio
                     primary: string;
                     fallbacks: string[];
                 };
-                intents: Partial<Record<"review" | "coding" | "understanding" | "fast" | "reasoning" | "vision", {
+                intents: Partial<Record<"review" | "coding" | "fast" | "reasoning" | "vision" | "understanding", {
                     primary: string;
                     fallbacks: string[];
                 }>>;

package/dist/src/gateway/hono/routes/user-model-refresh.js

@@ -2,7 +2,7 @@ import { listConnectorLearningJobs } from "../../../storage/sqlite/connector-lea
 import { getConnectorAccount } from "../../../storage/sqlite/connector-account-repository.js";
 import "../../../storage/sqlite/index.js";
 import { getWorkDiscoveryRun } from "../../../work-discovery/repository.js";
-import { listUnderstandingSourceRuns } from "../../../user-context/sources/repository.js";
+import { getConnectorUnderstandingSourceRun } from "../../../user-context/sources/repository.js";
 import { isLocalUnderstandingSourceId } from "../../../user-context/sources/local-source-contract.js";
 import { normalizeUnderstandingSourceItems } from "../../../work-discovery/service.js";
 import { UnderstandingRefreshService } from "../../../user-context/sources/refresh-service.js";
@@ -63,7 +63,7 @@ function createUnderstandingRefreshService(deps) {
 					phase: "completed",
 					error: "Connector update is no longer available."
 				};
-				const sourceRun = listUnderstandingSourceRuns(run.grantId, 100).find((item) => item.id !== run.id && item.metadata.connectorLearningJobId === job.id);
+				const sourceRun = getConnectorUnderstandingSourceRun(job.id);
 				if (job.status === "completed") return {
 					status: sourceRun?.status === "partial" ? "partial" : "completed",
 					phase: "completed",

package/dist/src/gateway/hono/routes/voice.js

@@ -21,8 +21,8 @@ import { VoiceSessionCreationError, resolveStreamingStt, resolveStreamingTts } f
 import { getGatewayPrincipal } from "../../security/gateway-principal.js";
 import { createGatewayRouteLogger } from "../lib/route-logger.js";
 import { selectPlatformVoice, voiceSettingsCatalog } from "../../../voice/platform-settings.js";
-import { listTtsProvidersForApi } from "../../../voice/tts/list-providers.js";
 import { listLocalVoiceModelStatuses, removeLocalVoiceModel, startLocalVoiceModelInstall } from "../../../voice/local/model-manager.js";
+import { listTtsProvidersForApi } from "../../../voice/tts/list-providers.js";
 import { z } from "zod";
 //#region src/gateway/hono/routes/voice.ts
 init_voice();

package/dist/src/gateway/service.js

@@ -66,18 +66,18 @@ import { registerClarificationChannelRuntime } from "./clarify-runtime.js";
 import { ChannelManager } from "../channels/manager.js";
 import { getWorkspacePath } from "../config/workspace-path-helpers.js";
 import "../config/index.js";
-import { ManagedComposioEventPoller } from "../connectors/composio-managed-events.js";
-import { startConnectedKnowledgeCoordinator } from "../knowledge/coordinator.js";
-import "../knowledge/index.js";
-import { ConnectionRecoveryService } from "../connectors/connection-recovery-service.js";
-import { startConnectorLearningCoordinator } from "../connectors/learning-coordinator.js";
-import { startConnectorSupervisor } from "../connectors/supervisor.js";
 import { DiscussionService } from "../discussions/service.js";
 import { DiscussionOrganizer } from "../discussions/organizer.js";
 import { DiscussionLiveWorker } from "../discussions/live-worker.js";
 import { DiscussionOrganizerWorker } from "../discussions/organizer-worker.js";
 import { DiscussionSealer } from "../discussions/sealer.js";
 import "../discussions/index.js";
+import { ManagedComposioEventPoller } from "../connectors/composio-managed-events.js";
+import { startConnectedKnowledgeCoordinator } from "../knowledge/coordinator.js";
+import "../knowledge/index.js";
+import { ConnectionRecoveryService } from "../connectors/connection-recovery-service.js";
+import { startConnectorLearningCoordinator } from "../connectors/learning-coordinator.js";
+import { startConnectorSupervisor } from "../connectors/supervisor.js";
 import { EndpointToolRuntime } from "../endpoint-tools/runtime.js";
 import "../endpoint-tools/index.js";
 import { assertGatewayAuthConfigured, extractToken, resolveGatewayAuth, validateToken } from "./auth.js";

package/dist/src/knowledge/ingestion-service.d.ts

@@ -1,4 +1,7 @@
 import type { KnowledgeSourceAdapter, KnowledgeSourceItemInput, KnowledgeSyncRun } from './types.js';
+export type KnowledgeIngestionResult = KnowledgeSyncRun & {
+    changedItemIds: string[];
+};
 export interface KnowledgeSourceStateStore {
     getCursor(instanceId: string, collectionScope: string): string | undefined;
     setCursor(instanceId: string, collectionScope: string, cursor: string | undefined): void;
@@ -17,12 +20,12 @@ export declare class KnowledgeIngestionService {
         items: KnowledgeSourceItemInput[];
         cursorAfter?: string;
         warnings?: string[];
-    }): KnowledgeSyncRun;
+    }): KnowledgeIngestionResult;
     sync(params: {
         adapterKind: string;
         instanceId: string;
         collectionScope: string;
         windowStart?: string;
         signal?: AbortSignal;
-    }): Promise<KnowledgeSyncRun>;
+    }): Promise<KnowledgeIngestionResult>;
 }

package/dist/src/knowledge/ingestion-service.js

@@ -64,15 +64,18 @@ var KnowledgeIngestionService = class {
 		try {
 			const stored = upsertKnowledgeSourceItems(params.items);
 			this.state.setCursor(params.instanceId, params.collectionScope, params.cursorAfter);
-			return finishKnowledgeSyncRun({
-				runId: run.id,
-				status: params.warnings?.length ? "partial" : "succeeded",
-				cursorAfter: params.cursorAfter,
-				itemsSeen: params.items.length,
-				itemsCreated: stored.created,
-				itemsUpdated: stored.updated,
-				warnings: params.warnings
-			});
+			return {
+				...finishKnowledgeSyncRun({
+					runId: run.id,
+					status: params.warnings?.length ? "partial" : "succeeded",
+					cursorAfter: params.cursorAfter,
+					itemsSeen: params.items.length,
+					itemsCreated: stored.created,
+					itemsUpdated: stored.updated,
+					warnings: params.warnings
+				}),
+				changedItemIds: stored.changedItemIds
+			};
 		} catch (err) {
 			const errorMessage = err instanceof Error ? err.message : String(err);
 			finishKnowledgeSyncRun({
@@ -139,7 +142,10 @@ var KnowledgeIngestionService = class {
 				itemsUpdated: stored.updated,
 				itemsDeleted: tombstones.length
 			}, "Knowledge source sync completed");
-			return completed;
+			return {
+				...completed,
+				changedItemIds: stored.changedItemIds
+			};
 		} catch (err) {
 			const errorMessage = err instanceof Error ? err.message : String(err);
 			const status = signal.aborted ? "cancelled" : "failed";
@@ -148,11 +154,14 @@ var KnowledgeIngestionService = class {
 				runId: run.id,
 				sourceInstanceId: params.instanceId
 			}, `Knowledge source sync ${status}: ${errorMessage}`);
-			return finishKnowledgeSyncRun({
-				runId: run.id,
-				status,
-				error: errorMessage
-			});
+			return {
+				...finishKnowledgeSyncRun({
+					runId: run.id,
+					status,
+					error: errorMessage
+				}),
+				changedItemIds: []
+			};
 		}
 	}
 };

package/dist/src/knowledge-memory/domain.d.ts

@@ -1,5 +1,5 @@
 import type { UserModelScope } from '../user-model/domain.js';
-export type KnowledgeKind = 'project_fact' | 'workspace_fact' | 'decision' | 'task_lesson' | 'commitment' | 'open_question' | 'episode' | 'note';
+export type KnowledgeKind = 'work_thread' | 'project_fact' | 'workspace_fact' | 'decision' | 'task_lesson' | 'commitment' | 'open_question' | 'episode' | 'note';
 export type KnowledgeStatus = 'candidate' | 'active' | 'needs_review' | 'stale' | 'archived' | 'rejected';
 export type KnowledgeReviewAction = 'approve' | 'edit_and_approve' | 'reject' | 'archive';
 export type KnowledgeStatusActor = 'user' | 'agent' | 'runtime' | 'maintenance' | 'migration';

package/dist/src/platform/client.d.ts

@@ -33,10 +33,10 @@ export declare const RuntimeCommandSchema: z.ZodObject<{
                 intents: z.ZodArray<z.ZodEnum<{
                     review: "review";
                     coding: "coding";
-                    understanding: "understanding";
                     fast: "fast";
                     reasoning: "reasoning";
                     vision: "vision";
+                    understanding: "understanding";
                 }>>;
                 allow: z.ZodArray<z.ZodString>;
             }, z.core.$strict>;

package/dist/src/platform/contracts.d.ts

@@ -119,10 +119,10 @@ export declare const AgentManifestSchema: z.ZodObject<{
         intents: z.ZodArray<z.ZodEnum<{
             review: "review";
             coding: "coding";
-            understanding: "understanding";
             fast: "fast";
             reasoning: "reasoning";
             vision: "vision";
+            understanding: "understanding";
         }>>;
         allow: z.ZodArray<z.ZodString>;
     }, z.core.$strict>;

package/dist/src/providers/extension-stream-bridge.js

@@ -4,7 +4,7 @@ import "./constants.js";
 import { getProviderRegistry, init_plugin_registry } from "./plugin-registry.js";
 import { init_providers } from "./index.js";
 import { stripPromptCacheBoundary } from "../agent/prompt/cache-boundary.js";
-import { createAssistantMessageEventStream, streamSimple } from "@earendil-works/pi-ai/compat";
+import { createAssistantMessageEventStream, getCurrentSystemPrompt, getCurrentTools, streamSimple } from "@earendil-works/pi-ai/compat";
 //#region src/providers/extension-stream-bridge.ts
 init_plugin_registry();
 init_providers();
@@ -78,11 +78,13 @@ function createExtensionAwareStreamFn() {
 			modelId: model.id
 		}, "Streaming via extension provider");
 		const stream = createAssistantMessageEventStream();
+		const systemPrompt = getCurrentSystemPrompt(context.messages);
+		const tools = getCurrentTools(context.messages);
 		const params = {
 			model: model.id,
-			systemPrompt: context.systemPrompt ? stripPromptCacheBoundary(context.systemPrompt) : void 0,
-			messages: context.messages,
-			tools: context.tools,
+			systemPrompt: systemPrompt ? stripPromptCacheBoundary(systemPrompt) : void 0,
+			messages: context.messages.filter((message) => message.role !== "system"),
+			tools,
 			temperature: options?.temperature,
 			maxTokens: options?.maxTokens,
 			apiKey: options?.apiKey,

package/dist/src/providers/model-call.js

@@ -1,7 +1,7 @@
 import { init_constants } from "./constants.js";
 import { getApiKey, init_providers } from "./index.js";
 import { createExtensionAwareStreamFn } from "./extension-stream-bridge.js";
-import { completeSimple } from "@earendil-works/pi-ai/compat";
+import { completeSimple, normalizeContext } from "@earendil-works/pi-ai/compat";
 //#region src/providers/model-call.ts
 init_constants();
 init_providers();
@@ -42,7 +42,7 @@ async function resolveModelCallOptions(model, options = {}, credentialOptions) {
 */
 async function completeWithResolvedCredentials(model, context, options = {}, credentialOptions) {
 	const resolvedOptions = await resolveModelCallOptions(model, options, credentialOptions);
-	if (model.baseUrl === "extension://provider-plugin") return await (await createExtensionAwareStreamFn()(model, context, resolvedOptions)).result();
+	if (model.baseUrl === "extension://provider-plugin") return await (await createExtensionAwareStreamFn()(model, normalizeContext(context), resolvedOptions)).result();
 	return await completeSimple(model, context, resolvedOptions);
 }
 /**
@@ -52,7 +52,7 @@ async function completeWithResolvedCredentials(model, context, options = {}, cre
 */
 async function createResolvedModelStream(model, context, options = {}, credentialOptions) {
 	const resolvedOptions = await resolveModelCallOptions(model, options, credentialOptions);
-	return await createExtensionAwareStreamFn()(model, context, resolvedOptions);
+	return await createExtensionAwareStreamFn()(model, normalizeContext(context), resolvedOptions);
 }
 //#endregion
 export { completeWithResolvedCredentials, createResolvedModelStream, isLocalModelBaseUrl, resolveModelCallApiKey, resolveModelCallOptions, supportsModelTemperature };

package/dist/src/providers/presentation.js

@@ -207,9 +207,10 @@ const RECOMMENDED_MODEL_PATTERNS = {
 	"zhipu-cn": [/^glm-5\.2$/i],
 	zai: [/^glm-5\.2$/i],
 	"zai-coding-cn": [
-		/^glm-5\.2$/i,
-		/^glm-5\.1$/i,
-		/^glm-5-turbo$/i
+		/^glm-5\.3$/i,
+		/^glm-5\.3-highspeed$/i,
+		/^glm-5\.3-flash$/i,
+		/^glm-4\.6v$/i
 	],
 	"zai-coding-global": [/^glm-5\.2$/i],
 	"zhipu-coding-cn": [/^glm-5\.2$/i],

package/dist/src/storage/sqlite/context-extraction-repository.d.ts

@@ -1,5 +1,5 @@
 export type ContextExtractionStatus = 'running' | 'completed' | 'skipped' | 'failed';
-export type ContextObjectType = 'profile' | 'rule' | 'focus' | 'understanding';
+export type ContextObjectType = 'assertion' | 'rule' | 'goal' | 'knowledge';
 export type ContextExtractionRun = {
     id: string;
     principalId: string;
@@ -54,4 +54,3 @@ export declare function listContextExtractionRuns(filter?: {
 }): ContextExtractionRun[];
 export declare function getContextExtractionRun(id: string): ContextExtractionRun | null;
 export declare function listContextExtractionOutputs(runId: string): ContextExtractionOutput[];
-export declare function hasIndependentExtractionOutput(runIds: string[], objectType: ContextObjectType, objectId: string): boolean;

package/dist/src/storage/sqlite/context-extraction-repository.js

@@ -108,13 +108,5 @@ function listContextExtractionOutputs(runId) {
 	return getSqliteDatabase().prepare(`SELECT * FROM context_extraction_outputs
     WHERE extraction_run_id = ? ORDER BY ordinal`).all(runId).map(outputFromRow);
 }
-function hasIndependentExtractionOutput(runIds, objectType, objectId) {
-	if (!runIds.length) return false;
-	const placeholders = runIds.map(() => "?").join(", ");
-	return Boolean(getSqliteDatabase().prepare(`SELECT 1 FROM context_extraction_outputs o
-    JOIN context_extraction_runs r ON r.extraction_run_id = o.extraction_run_id
-    WHERE o.extraction_run_id NOT IN (${placeholders}) AND o.object_type = ? AND o.object_id = ?
-      AND r.status = 'completed' LIMIT 1`).get(...runIds, objectType, objectId));
-}
 //#endregion
-export { claimContextExtractionRun, finishContextExtractionRun, getContextExtractionRun, hasIndependentExtractionOutput, listContextExtractionOutputs, listContextExtractionRuns };
+export { claimContextExtractionRun, finishContextExtractionRun, getContextExtractionRun, listContextExtractionOutputs, listContextExtractionRuns };

package/dist/src/storage/sqlite/index.d.ts

@@ -10,8 +10,7 @@ export { deleteBrowserTabBinding, deleteBrowserTabBindingsByEndpoint, deleteBrow
 export { authenticateDeviceAccessToken, buildRefreshProofMessage, createDevice, getDevice, issueDeviceTokenPair, listDevices, revokeDevice, rotateDeviceRefreshToken, type DeviceAccessIdentity, type DevicePlatform, type DevicePublicKeyJwk, type DeviceRecord, type DeviceTokenPair, } from './device-access-repository.js';
 export { clearGatewayIdentityForTest, getOrCreateGatewayIdentity, signGatewayPayload, type GatewayIdentity, } from './gateway-identity-repository.js';
 export { createDevicePairingSetup, isDevicePairingSetupActive, type DevicePairingSetup, type DeviceRoute, } from './device-pairing-repository.js';
-export { claimContextExtractionRun, finishContextExtractionRun, getContextExtractionRun, hasIndependentExtractionOutput, listContextExtractionOutputs, listContextExtractionRuns, type ContextExtractionOutput, type ContextExtractionRun, type ContextExtractionStatus, type ContextObjectType, } from './context-extraction-repository.js';
-export { closeTemporalAssertions, createTemporalAssertion, linkContextObjects, listContextObjectRelations, listTemporalAssertions, type ContextObjectRelation, type ContextTemporalAssertion, } from './context-relation-repository.js';
+export { claimContextExtractionRun, finishContextExtractionRun, getContextExtractionRun, listContextExtractionOutputs, listContextExtractionRuns, type ContextExtractionOutput, type ContextExtractionRun, type ContextExtractionStatus, type ContextObjectType, } from './context-extraction-repository.js';
 export { createCollaborationRule, getCollaborationRule, listCollaborationRules, setCollaborationRuleStatus, type CollaborationRule, } from './collaboration-rule-repository.js';
 export { createContextEvidence, type ContextEvidence } from './context-evidence-repository.js';
 export { getUserPerson, getUserPeopleIndexState, listUserPeople, mergeUserPeople, replaceUserPeopleIndex, summarizeUserPeople, updateUserPerson, } from './user-people-repository.js';

package/dist/src/storage/sqlite/index.js

@@ -12,8 +12,7 @@ import { deleteBrowserTabBinding, deleteBrowserTabBindingsByEndpoint, deleteBrow
 import { authenticateDeviceAccessToken, buildRefreshProofMessage, createDevice, getDevice, issueDeviceTokenPair, listDevices, revokeDevice, rotateDeviceRefreshToken } from "./device-access-repository.js";
 import { clearGatewayIdentityForTest, getOrCreateGatewayIdentity, signGatewayPayload } from "./gateway-identity-repository.js";
 import { createDevicePairingSetup, isDevicePairingSetupActive } from "./device-pairing-repository.js";
-import { claimContextExtractionRun, finishContextExtractionRun, getContextExtractionRun, hasIndependentExtractionOutput, listContextExtractionOutputs, listContextExtractionRuns } from "./context-extraction-repository.js";
-import { closeTemporalAssertions, createTemporalAssertion, linkContextObjects, listContextObjectRelations, listTemporalAssertions } from "./context-relation-repository.js";
+import { claimContextExtractionRun, finishContextExtractionRun, getContextExtractionRun, listContextExtractionOutputs, listContextExtractionRuns } from "./context-extraction-repository.js";
 import { createCollaborationRule, getCollaborationRule, listCollaborationRules, setCollaborationRuleStatus } from "./collaboration-rule-repository.js";
 import { createContextEvidence } from "./context-evidence-repository.js";
 import { getUserPeopleIndexState, getUserPerson, listUserPeople, mergeUserPeople, replaceUserPeopleIndex, summarizeUserPeople, updateUserPerson } from "./user-people-repository.js";
@@ -58,4 +57,4 @@ init_session_repository();
 init_connector_repository();
 init_connector_account_repository();
 //#endregion
-export { COMPOSER_INPUT_HISTORY_LIMIT, DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, DatabaseSchemaTooOldError, SCHEMA_META_SCHEMA_VERSION_KEY, SidebarLayoutConflictError, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, acknowledgeHomeAttention, appendCompactionBoundaryIfUnchanged, appendComposerInputHistory, appendConnectorExecutionAudit, appendMediaToAssistantTranscriptEntry, appendTranscriptEntry, applyPendingMigrations, authenticateDeviceAccessToken, bindEndpointPrincipal, buildDefaultSessionMetadata, buildGlobalSessionStats, buildRefreshProofMessage, buildRelationshipPrompt, cancelQueuedSessionInput, claimConnectorWebhookDelivery, claimContextExtractionRun, claimKnowledgeSourceItems, claimNextConnectorLearningJob, claimNextSessionInput, classifyStoredRow, clearComposerInputHistory, clearGatewayIdentityForTest, closeTemporalAssertions, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, consumeClarificationApproval, consumeClarificationResume, consumeConnectorApproval, countKnowledgeSourceItems, createClarificationWait, createCollaborationRule, createConnectorApproval, createContextEvidence, createDevice, createDevicePairingSetup, createEndpointPrincipal, createObjectLinkRecord, createTemporalAssertion, decideConnectorApproval, deleteBrowserTabBinding, deleteBrowserTabBindingsByEndpoint, deleteBrowserTabBindingsByPrincipal, deleteConnectorConnection, deleteConnectorInstallation, deleteEndpointSessionBinding, deleteEndpointSessionBindingsByPrincipal, deleteKnowledgeSourceItems, deleteNoteAgentContextRecord, deleteNoteRecord, deleteObjectLinkRecord, deleteSessionConfig, deleteSessionRecord, discoverSqlMigrations, enqueueConnectorLearningJob, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findConversationIdByTranscriptId, findLatestAssistantTranscriptEntryId, findSessionInput, finishContextExtractionRun, finishEndpointToolInvocationAudit, finishKnowledgeSyncRun, finishSessionInputRun, getActiveClarification, getActivityEventRecord, getBrowserTabBinding, getBrowserTabBindingById, getCachedConnectorCatalogEntry, getClarification, getClarificationResumeInput, getClarificationSnapshot, getCollaborationRule, getConnectorAccount, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getConnectorSyncPolicy, getConnectorSyncPolicyForConnection, getContextExtractionRun, getCurrentTranscriptId, getDevice, getEndpointPrincipal, getEndpointSessionBinding, getGlobalSessionStats, getInteractionState, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getNoteAgentContextRecord, getNoteRecord, getOrCreateGatewayIdentity, getRelationshipSettings, getSessionConfig, getSessionInputById, getSessionInputState, getSessionMetadata, getSessionPersistedLevels, getSessionTaskPlan, getSidebarLayout, getSqliteDatabase, getUserPeopleIndexState, getUserPerson, getUserTrustPolicy, getXopcDatabase, hasIndependentExtractionOutput, hasSessionConfig, incrementSessionStatsOnAppend, insertSessionInput, inspectSchemaMigrationStatus, isClarificationSuspended, isDevicePairingSetupActive, isHomeAttentionAcknowledged, isProactiveSupportAllowed, isXopcDatabaseOpen, issueDeviceTokenPair, linkContextObjects, listActiveSessionInputRuns, listActivityRecords, listCachedConnectorCatalogEntries, listCollaborationRules, listCompactionBoundaries, listComposerInputHistory, listConnectorAccounts, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listConnectorLearningJobs, listConnectorSyncPolicies, listContextExtractionOutputs, listContextExtractionRuns, listContextObjectRelations, listDevices, listEndpointPrincipals, listEndpointToolInvocationAuditPage, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, listTemporalAssertions, listUserPeople, loadCompactionSourceSnapshot, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, mergeUserPeople, metadataToSessionInsert, mutateQueuedSessionInput, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, pruneBoundedKnowledgeSourceItems, readSchemaVersion, readSchemaVersionForTest, reconcileConnectorAccount, recordActivityEvent, recoverSessionInputState, recoverStaleConnectorLearningJobs, refreshConnectorAccountCurrent, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, replaceLatestSessionTurnAndQueueInput, replaceSidebarLayout, replaceTranscriptRows, replaceUserPeopleIndex, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveClarification, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreBeforeCompactionBoundary, revokeDevice, revokeEndpointPrincipal, rotateDeviceRefreshToken, runSqliteWriteTransaction, searchSessionTranscript, sessionConfigRowToConfig, sessionRowToMetadata, setBrowserTabBinding, setCollaborationRuleStatus, setConnectorLearningPaused, setEndpointSessionBinding, setInteractionState, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setSessionConfig, setSessionInputStatus, setSessionTaskPlan, setUserTrustPolicy, signGatewayPayload, sortBySidebarLayout, startEndpointToolInvocationAudit, startKnowledgeSyncRun, summarizeUserPeople, supersedeActiveClarification, touchEndpointPrincipal, transcriptEntryRowToStoredRow, updateConnectorLearningJob, updateInteractionStateFromMessage, updateRelationshipSettings, updateSessionConfig, updateSessionStats, updateUserPerson, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertConnectorSyncPolicy, upsertKnowledgeSourceItems, upsertNoteAgentContextRecord, upsertNoteRecord, validateLatestSessionTurnTarget };
+export { COMPOSER_INPUT_HISTORY_LIMIT, DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, DatabaseSchemaTooOldError, SCHEMA_META_SCHEMA_VERSION_KEY, SidebarLayoutConflictError, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, acknowledgeHomeAttention, appendCompactionBoundaryIfUnchanged, appendComposerInputHistory, appendConnectorExecutionAudit, appendMediaToAssistantTranscriptEntry, appendTranscriptEntry, applyPendingMigrations, authenticateDeviceAccessToken, bindEndpointPrincipal, buildDefaultSessionMetadata, buildGlobalSessionStats, buildRefreshProofMessage, buildRelationshipPrompt, cancelQueuedSessionInput, claimConnectorWebhookDelivery, claimContextExtractionRun, claimKnowledgeSourceItems, claimNextConnectorLearningJob, claimNextSessionInput, classifyStoredRow, clearComposerInputHistory, clearGatewayIdentityForTest, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, consumeClarificationApproval, consumeClarificationResume, consumeConnectorApproval, countKnowledgeSourceItems, createClarificationWait, createCollaborationRule, createConnectorApproval, createContextEvidence, createDevice, createDevicePairingSetup, createEndpointPrincipal, createObjectLinkRecord, decideConnectorApproval, deleteBrowserTabBinding, deleteBrowserTabBindingsByEndpoint, deleteBrowserTabBindingsByPrincipal, deleteConnectorConnection, deleteConnectorInstallation, deleteEndpointSessionBinding, deleteEndpointSessionBindingsByPrincipal, deleteKnowledgeSourceItems, deleteNoteAgentContextRecord, deleteNoteRecord, deleteObjectLinkRecord, deleteSessionConfig, deleteSessionRecord, discoverSqlMigrations, enqueueConnectorLearningJob, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findConversationIdByTranscriptId, findLatestAssistantTranscriptEntryId, findSessionInput, finishContextExtractionRun, finishEndpointToolInvocationAudit, finishKnowledgeSyncRun, finishSessionInputRun, getActiveClarification, getActivityEventRecord, getBrowserTabBinding, getBrowserTabBindingById, getCachedConnectorCatalogEntry, getClarification, getClarificationResumeInput, getClarificationSnapshot, getCollaborationRule, getConnectorAccount, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getConnectorSyncPolicy, getConnectorSyncPolicyForConnection, getContextExtractionRun, getCurrentTranscriptId, getDevice, getEndpointPrincipal, getEndpointSessionBinding, getGlobalSessionStats, getInteractionState, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getNoteAgentContextRecord, getNoteRecord, getOrCreateGatewayIdentity, getRelationshipSettings, getSessionConfig, getSessionInputById, getSessionInputState, getSessionMetadata, getSessionPersistedLevels, getSessionTaskPlan, getSidebarLayout, getSqliteDatabase, getUserPeopleIndexState, getUserPerson, getUserTrustPolicy, getXopcDatabase, hasSessionConfig, incrementSessionStatsOnAppend, insertSessionInput, inspectSchemaMigrationStatus, isClarificationSuspended, isDevicePairingSetupActive, isHomeAttentionAcknowledged, isProactiveSupportAllowed, isXopcDatabaseOpen, issueDeviceTokenPair, listActiveSessionInputRuns, listActivityRecords, listCachedConnectorCatalogEntries, listCollaborationRules, listCompactionBoundaries, listComposerInputHistory, listConnectorAccounts, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listConnectorLearningJobs, listConnectorSyncPolicies, listContextExtractionOutputs, listContextExtractionRuns, listDevices, listEndpointPrincipals, listEndpointToolInvocationAuditPage, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, listUserPeople, loadCompactionSourceSnapshot, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, mergeUserPeople, metadataToSessionInsert, mutateQueuedSessionInput, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, pruneBoundedKnowledgeSourceItems, readSchemaVersion, readSchemaVersionForTest, reconcileConnectorAccount, recordActivityEvent, recoverSessionInputState, recoverStaleConnectorLearningJobs, refreshConnectorAccountCurrent, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, replaceLatestSessionTurnAndQueueInput, replaceSidebarLayout, replaceTranscriptRows, replaceUserPeopleIndex, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveClarification, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreBeforeCompactionBoundary, revokeDevice, revokeEndpointPrincipal, rotateDeviceRefreshToken, runSqliteWriteTransaction, searchSessionTranscript, sessionConfigRowToConfig, sessionRowToMetadata, setBrowserTabBinding, setCollaborationRuleStatus, setConnectorLearningPaused, setEndpointSessionBinding, setInteractionState, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setSessionConfig, setSessionInputStatus, setSessionTaskPlan, setUserTrustPolicy, signGatewayPayload, sortBySidebarLayout, startEndpointToolInvocationAudit, startKnowledgeSyncRun, summarizeUserPeople, supersedeActiveClarification, touchEndpointPrincipal, transcriptEntryRowToStoredRow, updateConnectorLearningJob, updateInteractionStateFromMessage, updateRelationshipSettings, updateSessionConfig, updateSessionStats, updateUserPerson, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertConnectorSyncPolicy, upsertKnowledgeSourceItems, upsertNoteAgentContextRecord, upsertNoteRecord, validateLatestSessionTurnTarget };

package/dist/src/storage/sqlite/knowledge-repository.d.ts

@@ -25,6 +25,7 @@ export declare function getKnowledgeSourceCursor(sourceInstanceId: string, colle
 export declare function setKnowledgeSourceCursor(sourceInstanceId: string, collectionScope: string, cursor: string | undefined): void;
 export declare function upsertKnowledgeSourceItems(inputs: KnowledgeSourceItemInput[], nowMs?: number): {
     items: KnowledgeSourceItem[];
+    changedItemIds: string[];
     created: number;
     updated: number;
     unchanged: number;

package/dist/src/storage/sqlite/knowledge-repository.js

@@ -144,6 +144,7 @@ function setKnowledgeSourceCursor(sourceInstanceId, collectionScope, cursor) {
 function upsertKnowledgeSourceItems(inputs, nowMs = Date.now()) {
 	return runSqliteWriteTransaction((db) => {
 		const items = [];
+		const changedItemIds = [];
 		let created = 0;
 		let updated = 0;
 		let unchanged = 0;
@@ -184,6 +185,7 @@ function upsertKnowledgeSourceItems(inputs, nowMs = Date.now()) {
           updated_at = excluded.updated_at`).run(id, input.sourceInstanceId, input.collectionScope, input.externalId, input.itemType, input.authorRole ?? null, parseTimestamp(input.occurredAt), parseTimestamp(input.sourceUpdatedAt), input.contentHash, input.normalizedText ?? null, input.payloadRef ?? null, JSON.stringify(input.metadata ?? {}), input.sensitivity ?? "normal", input.retentionClass ?? "bounded", input.synthesisPipeline ?? "user_understanding", input.synthesisStatus ?? "pending", parseTimestamp(input.deletedAt), existing?.created_at ?? nowMs, nowMs);
 			const row = db.prepare(`SELECT * FROM knowledge_source_items WHERE item_id = ?`).get(id);
 			items.push(sourceItemFromRow(row));
+			changedItemIds.push(id);
 			const changeKind = input.deletedAt ? "deleted" : existing ? "modified" : "added";
 			db.prepare(`INSERT INTO knowledge_source_changes (
           change_id, source_instance_id, source_item_id, change_kind,
@@ -194,6 +196,7 @@ function upsertKnowledgeSourceItems(inputs, nowMs = Date.now()) {
 		}
 		return {
 			items,
+			changedItemIds,
 			created,
 			updated,
 			unchanged

package/dist/src/storage/sqlite/migrations/200_connected_work_threads.sql

@@ -0,0 +1,92 @@
+ALTER TABLE knowledge_item_status_events RENAME TO knowledge_item_status_events_v199;
+ALTER TABLE knowledge_items RENAME TO knowledge_items_v199;
+
+CREATE TABLE knowledge_items (
+  knowledge_id TEXT PRIMARY KEY,
+  principal_id TEXT NOT NULL,
+  kind TEXT NOT NULL CHECK(kind IN (
+    'work_thread', 'project_fact', 'workspace_fact', 'decision', 'task_lesson',
+    'commitment', 'open_question', 'episode', 'note'
+  )),
+  scope_type TEXT NOT NULL CHECK(scope_type IN ('global', 'agent', 'workspace', 'project', 'session')),
+  scope_id TEXT,
+  content TEXT NOT NULL,
+  canonical_key TEXT NOT NULL,
+  status TEXT NOT NULL CHECK(status IN ('candidate', 'active', 'needs_review', 'stale', 'archived', 'rejected')),
+  confidence REAL NOT NULL CHECK(confidence >= 0 AND confidence <= 1),
+  importance REAL NOT NULL CHECK(importance >= 0 AND importance <= 1),
+  valid_from INTEGER,
+  valid_to INTEGER,
+  expires_at INTEGER,
+  review_at INTEGER,
+  origin_class TEXT NOT NULL CHECK(origin_class IN ('owner', 'agent', 'system', 'untrusted')),
+  source_agent_id TEXT,
+  source_conversation_id TEXT,
+  source_turn_id TEXT,
+  derived_from_recalled_context INTEGER NOT NULL DEFAULT 0 CHECK(derived_from_recalled_context IN (0, 1)),
+  source_json TEXT NOT NULL DEFAULT '{}' CHECK(json_valid(source_json)),
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL,
+  record_class TEXT NOT NULL DEFAULT 'memory' CHECK(record_class IN ('memory', 'source_index')),
+  CHECK(valid_to IS NULL OR valid_from IS NULL OR valid_to >= valid_from)
+);
+
+INSERT INTO knowledge_items (
+  knowledge_id, principal_id, kind, scope_type, scope_id, content, canonical_key,
+  status, confidence, importance, valid_from, valid_to, expires_at, review_at,
+  origin_class, source_agent_id, source_conversation_id, source_turn_id,
+  derived_from_recalled_context, source_json, created_at, updated_at, record_class
+)
+SELECT
+  knowledge_id,
+  principal_id,
+  CASE
+    WHEN record_class = 'memory' AND canonical_key LIKE 'connected-thread:%'
+      THEN 'work_thread'
+    ELSE kind
+  END,
+  CASE
+    WHEN record_class = 'memory' AND canonical_key LIKE 'connected-thread:%'
+      THEN 'global'
+    ELSE scope_type
+  END,
+  CASE
+    WHEN record_class = 'memory' AND canonical_key LIKE 'connected-thread:%'
+      THEN NULL
+    ELSE scope_id
+  END,
+  content, canonical_key, status, confidence, importance, valid_from, valid_to,
+  expires_at, review_at, origin_class, source_agent_id, source_conversation_id,
+  source_turn_id, derived_from_recalled_context, source_json, created_at, updated_at,
+  record_class
+FROM knowledge_items_v199;
+
+CREATE TABLE knowledge_item_status_events (
+  event_id TEXT PRIMARY KEY,
+  knowledge_id TEXT NOT NULL REFERENCES knowledge_items(knowledge_id) ON DELETE CASCADE,
+  from_status TEXT,
+  to_status TEXT NOT NULL,
+  actor_type TEXT NOT NULL CHECK(actor_type IN ('user', 'agent', 'runtime', 'maintenance', 'migration')),
+  reason TEXT NOT NULL,
+  created_at INTEGER NOT NULL
+);
+
+INSERT INTO knowledge_item_status_events
+SELECT * FROM knowledge_item_status_events_v199;
+
+DROP TABLE knowledge_item_status_events_v199;
+DROP TABLE knowledge_items_v199;
+
+CREATE INDEX idx_knowledge_items_status
+  ON knowledge_items(principal_id, status, updated_at DESC);
+CREATE INDEX idx_knowledge_items_scope
+  ON knowledge_items(principal_id, scope_type, scope_id, status);
+CREATE INDEX idx_knowledge_items_lifecycle
+  ON knowledge_items(status, expires_at, review_at);
+CREATE INDEX idx_knowledge_items_class_status
+  ON knowledge_items(principal_id, record_class, status, updated_at DESC);
+CREATE UNIQUE INDEX idx_knowledge_items_canonical
+  ON knowledge_items(principal_id, canonical_key, scope_type, COALESCE(scope_id, ''))
+  WHERE status IN ('candidate', 'active', 'needs_review', 'stale');
+CREATE INDEX idx_knowledge_item_status_events_item
+  ON knowledge_item_status_events(knowledge_id, created_at DESC);