@xopcai/xopc 0.0.225 → 0.0.228

package/dist/src/projects/project-skill-service.d.ts

@@ -1,5 +1,6 @@
 import type { Config } from '../config/schema.js';
-import type { SkillDiagnostic, SkillMetadata, SkillToolConditions } from '../agent/skills/types.js';
+import { type WorkspaceSkillSourceStatus } from '../agent/skills/index.js';
+import type { Skill, SkillDiagnostic, SkillMetadata, SkillToolConditions } from '../agent/skills/types.js';
 import type { ProjectService } from './project-service.js';
 export type ProjectSkillErrorCode = 'project_not_found' | 'project_workspace_required' | 'project_workspace_missing' | 'project_workspace_not_writable' | 'skill_not_found' | 'invalid_skill_id';
 export declare class ProjectSkillError extends Error {
@@ -8,33 +9,53 @@ export declare class ProjectSkillError extends Error {
     constructor(code: ProjectSkillErrorCode, status: 400 | 403 | 404 | 409, message: string);
 }
 export interface ProjectSkillSummary {
-    id: string;
+    key: string;
+    directoryId: string;
     name: string;
     description: string;
     category?: string;
+    origin: Skill['origin']['id'];
+    path: string;
+    managed: boolean;
+    writable: boolean;
+    removable: boolean;
+    effective: boolean;
+    shadowedBy?: Skill['origin']['id'];
     disableModelInvocation: boolean;
     metadata: SkillMetadata;
     toolConditions?: SkillToolConditions;
     requiredEnvVarNames?: string[];
 }
+export interface ProjectWorkspaceTrustState {
+    workspacePath: string;
+    required: boolean;
+    decision: boolean | null;
+    trusted: boolean;
+}
 export interface ProjectSkillListResult {
     workspaceRoot: string;
-    skillsRoot: string;
+    sources: WorkspaceSkillSourceStatus[];
+    trust: ProjectWorkspaceTrustState;
     items: ProjectSkillSummary[];
+    inheritedItems: ProjectSkillSummary[];
     diagnostics: SkillDiagnostic[];
 }
 interface ProjectSkillServiceOptions {
     projects: ProjectService;
     getConfig: () => Config;
+    getWorkspaceTrust: (workspaceRoot: string) => ProjectWorkspaceTrustState;
+    setWorkspaceTrust: (workspaceRoot: string, trusted: boolean) => ProjectWorkspaceTrustState;
     refreshSkills: () => void | Promise<void>;
 }
 export declare class ProjectSkillService {
     private readonly options;
     constructor(options: ProjectSkillServiceOptions);
     list(projectId: string): ProjectSkillListResult;
-    getContent(projectId: string, skillId: string): ProjectSkillSummary & {
+    getContent(projectId: string, skillKey: string): ProjectSkillSummary & {
         bodyMarkdown: string;
     };
+    getWorkspaceTrust(projectId: string): ProjectWorkspaceTrustState;
+    setWorkspaceTrust(projectId: string, trusted: boolean): ProjectWorkspaceTrustState;
     installZip(projectId: string, buffer: Buffer, input?: {
         skillId?: string;
         overwrite?: boolean;
@@ -59,9 +80,10 @@ export declare class ProjectSkillService {
         bodyMarkdown: string;
     }>;
     remove(projectId: string, skillId: string): Promise<void>;
-    private findSkill;
     private resolveLocation;
-    private isDirectSkill;
+    private loadCatalog;
+    private skillKey;
+    private encodeSkillKey;
     private toSummary;
 }
 export {};

package/dist/src/projects/project-skill-service.js

@@ -1,5 +1,6 @@
+import { init_paths, resolveBundledSkillsDir } from "../config/paths.js";
 import { resolveWorkspaceSkillsDir, resolveWorkspaceSkillsLockPath } from "../agent/skills/workspace-skills-dir.js";
-import { loadWorkspaceSkills } from "../agent/skills/index.js";
+import { loadSkills, loadWorkspaceSkillInventory } from "../agent/skills/index.js";
 import { removeSkillsLockEntry } from "../agent/skills/hub-lock.js";
 import { deleteManagedSkill, installSkillFromZip, isValidSkillId } from "../agent/skills/managed-store.js";
 import { pullSkillFromSource } from "../agent/skills/hub-pull.js";
@@ -7,6 +8,7 @@ import { downloadFromMarketplace } from "../agent/skills/skills-marketplace.js";
 import { basename, dirname, join, relative, resolve, sep } from "node:path";
 import { accessSync, constants, existsSync, statSync } from "node:fs";
 //#region src/projects/project-skill-service.ts
+init_paths();
 var ProjectSkillError = class extends Error {
 	constructor(code, status, message) {
 		super(message);
@@ -20,21 +22,44 @@ var ProjectSkillService = class {
 		this.options = options;
 	}
 	list(projectId) {
-		const location = this.resolveLocation(projectId, false);
-		const loaded = loadWorkspaceSkills(location.workspaceRoot);
+		const { location, loaded, inherited, trust } = this.loadCatalog(projectId);
 		return {
-			...location,
-			items: loaded.skills.filter((skill) => this.isDirectSkill(skill, location.skillsRoot)).map((skill) => this.toSummary(skill)),
-			diagnostics: loaded.diagnostics
+			workspaceRoot: location.workspaceRoot,
+			sources: loaded.sources,
+			trust,
+			items: loaded.entries.map((entry) => this.toSummary(entry)),
+			inheritedItems: inherited.skills.map((skill) => this.toSummary({
+				skill,
+				effective: true
+			})),
+			diagnostics: inherited.diagnostics
 		};
 	}
-	getContent(projectId, skillId) {
-		const { skill } = this.findSkill(projectId, skillId);
+	getContent(projectId, skillKey) {
+		const { loaded, inherited } = this.loadCatalog(projectId);
+		const entry = loaded.entries.find((candidate) => this.skillKey(candidate.skill) === skillKey);
+		if (entry) return {
+			...this.toSummary(entry),
+			bodyMarkdown: entry.skill.content
+		};
+		const inheritedSkill = inherited.skills.find((candidate) => this.skillKey(candidate) === skillKey);
+		if (!inheritedSkill) throw new ProjectSkillError("skill_not_found", 404, "Project skill not found");
 		return {
-			...this.toSummary(skill),
-			bodyMarkdown: skill.content
+			...this.toSummary({
+				skill: inheritedSkill,
+				effective: true
+			}),
+			bodyMarkdown: inheritedSkill.content
 		};
 	}
+	getWorkspaceTrust(projectId) {
+		const location = this.resolveLocation(projectId, false);
+		return this.options.getWorkspaceTrust(location.workspaceRoot);
+	}
+	setWorkspaceTrust(projectId, trusted) {
+		const location = this.resolveLocation(projectId, false);
+		return this.options.setWorkspaceTrust(location.workspaceRoot, trusted);
+	}
 	async installZip(projectId, buffer, input = {}) {
 		const location = this.resolveLocation(projectId, true);
 		const installed = installSkillFromZip(buffer, {
@@ -44,7 +69,7 @@ var ProjectSkillService = class {
 		});
 		removeSkillsLockEntry(installed.skillId, resolveWorkspaceSkillsLockPath(location.workspaceRoot));
 		await this.options.refreshSkills();
-		return this.getContent(projectId, installed.skillId);
+		return this.getContent(projectId, this.encodeSkillKey("xopc-workspace", installed.skillId));
 	}
 	async installMarketplace(projectId, input) {
 		const downloaded = await downloadFromMarketplace(this.options.getConfig(), input.name, input.version, input.provider);
@@ -64,7 +89,7 @@ var ProjectSkillService = class {
 			lockPath: resolveWorkspaceSkillsLockPath(location.workspaceRoot)
 		});
 		await this.options.refreshSkills();
-		return this.getContent(projectId, installed.skillId);
+		return this.getContent(projectId, this.encodeSkillKey("xopc-workspace", installed.skillId));
 	}
 	async remove(projectId, skillId) {
 		const location = this.resolveLocation(projectId, true);
@@ -74,18 +99,6 @@ var ProjectSkillService = class {
 		removeSkillsLockEntry(skillId, resolveWorkspaceSkillsLockPath(location.workspaceRoot));
 		await this.options.refreshSkills();
 	}
-	findSkill(projectId, skillId) {
-		if (!isValidSkillId(skillId)) throw new ProjectSkillError("invalid_skill_id", 400, "Invalid skill id");
-		const location = this.resolveLocation(projectId, false);
-		const skill = loadWorkspaceSkills(location.workspaceRoot).skills.find((item) => {
-			return !relative(location.skillsRoot, item.baseDir).includes(sep) && basename(item.baseDir) === skillId;
-		});
-		if (!skill) throw new ProjectSkillError("skill_not_found", 404, "Project skill not found");
-		return {
-			skill,
-			skillsRoot: location.skillsRoot
-		};
-	}
 	resolveLocation(projectId, requireWritable) {
 		const project = this.options.projects.get(projectId);
 		if (!project) throw new ProjectSkillError("project_not_found", 404, "Project not found");
@@ -110,16 +123,50 @@ var ProjectSkillService = class {
 			skillsRoot
 		};
 	}
-	isDirectSkill(skill, skillsRoot) {
-		const rel = relative(skillsRoot, skill.baseDir);
-		return Boolean(rel) && !rel.includes(sep) && isValidSkillId(basename(skill.baseDir));
+	loadCatalog(projectId) {
+		const location = this.resolveLocation(projectId, false);
+		const trust = this.options.getWorkspaceTrust(location.workspaceRoot);
+		const loaded = loadWorkspaceSkillInventory(location.workspaceRoot, { workspaceTrust: trust.trusted ? "trusted" : "untrusted" });
+		const all = loadSkills({
+			workspaceDir: location.workspaceRoot,
+			builtinDir: resolveBundledSkillsDir(),
+			workspaceTrust: trust.trusted ? "trusted" : "untrusted"
+		});
+		return {
+			location,
+			loaded,
+			inherited: {
+				skills: all.skills.filter((skill) => skill.origin.scope !== "workspace"),
+				diagnostics: all.diagnostics
+			},
+			trust
+		};
+	}
+	skillKey(skill) {
+		const rel = relative(skill.origin.rootDir, skill.baseDir).split(sep).join("/");
+		return this.encodeSkillKey(skill.origin.id, rel);
+	}
+	encodeSkillKey(origin, relativeDir) {
+		return Buffer.from(`${origin}\0${relativeDir}`, "utf8").toString("base64url");
 	}
-	toSummary(skill) {
+	toSummary(entry) {
+		const { skill } = entry;
+		const id = basename(skill.baseDir);
+		const relativeDir = relative(skill.origin.rootDir, skill.baseDir);
+		const removable = skill.origin.id === "xopc-workspace" && !relativeDir.includes(sep) && isValidSkillId(id);
 		return {
-			id: basename(skill.baseDir),
+			key: this.skillKey(skill),
+			directoryId: id,
 			name: skill.name,
 			description: skill.description,
 			category: skill.category,
+			origin: skill.origin.id,
+			path: skill.baseDir,
+			managed: skill.origin.managed,
+			writable: skill.origin.writable,
+			removable,
+			effective: entry.effective,
+			shadowedBy: entry.shadowedBy,
 			disableModelInvocation: skill.disableModelInvocation,
 			metadata: skill.metadata,
 			toolConditions: skill.toolConditions,

package/dist/src/session/client-history.d.ts

@@ -1,3 +1,4 @@
+import { type TurnOutcome } from '@xopcai/gateway-contract';
 import type { Message } from './types.js';
 import type { TranscriptStoredRow } from './session-context-for-llm.js';
 /** Transcript row for TUI and HTTP clients (flattened from persisted session messages). */
@@ -13,7 +14,7 @@ export interface ClientHistoryMessage {
     timestamp?: number;
     /** Whitelisted display metadata; never includes source snapshot text. */
     metadata?: {
-        sourceContexts: Array<{
+        sourceContexts?: Array<{
             kind: 'note';
             sourceId: string;
             version: string;
@@ -21,6 +22,7 @@ export interface ClientHistoryMessage {
             tokenEstimate?: number;
             truncated?: boolean;
         }>;
+        turnOutcome?: TurnOutcome;
     };
     kind?: 'message' | 'compaction' | 'context' | 'bash' | 'custom' | 'branch';
     tokensBefore?: number;

package/dist/src/session/client-history.js

@@ -1,3 +1,4 @@
+import { parseTurnOutcome } from "../../packages/gateway-contract/src/turn-outcome.js";
 import { stripRuntimeContextFromUserMessage } from "./user-message-display.js";
 import { buildTranscriptOutline } from "./transcript-outline.js";
 //#region src/session/client-history.ts
@@ -286,6 +287,18 @@ function customStateRowToClientHistory(row) {
 	if (r.type !== "custom") return null;
 	const customType = optionalString(r.customType)?.trim();
 	if (!customType) return null;
+	if (customType === "turn_outcome") {
+		const outcome = parseTurnOutcome(r.data);
+		if (!outcome) return null;
+		return {
+			role: "assistant",
+			kind: "message",
+			turnId: outcome.turnId,
+			content: "",
+			timestamp: parseTimestampValue(typeof r.timestamp === "string" || typeof r.timestamp === "number" ? r.timestamp : void 0),
+			metadata: { turnOutcome: outcome }
+		};
+	}
 	return {
 		role: "system",
 		kind: "custom",

package/dist/src/session/index.d.ts

@@ -1,7 +1,7 @@
 export { SessionIndex, type SessionIndexConfig } from './manager.js';
 export { onSessionTranscriptUpdate, emitSessionTranscriptUpdate, type SessionTranscriptUpdate, } from './transcript-events.js';
 export { SessionStore } from './store.js';
-export type { SessionStoreOptions } from './store.js';
+export type { SessionStoreOptions, ForkSessionAtTurnOptions, ForkSessionResult, } from './store.js';
 export { SessionConfigStore, resolveThinkingLevel, resolveReasoningLevel, resolveVerboseLevel } from './config-store.js';
 export { DEFAULT_ACTIVITY_DETAIL_LEVEL, resolveConfiguredActivityDetailDefault, resolveEffectiveThinkingLevel, resolveEffectiveReasoningLevel, } from './thinking-resolve.js';
 export type { SessionAgentConfig } from './config-types.js';

package/dist/src/session/manager.d.ts

@@ -89,6 +89,7 @@ export declare class SessionIndex extends EventEmitter {
         sessionKey: string;
         rowCount: number;
     }>;
+    forkSessionAtTurn(sourceKey: string, options: import('./store.js').ForkSessionAtTurnOptions): Promise<import('./store.js').ForkSessionResult>;
     getStats(): Promise<GlobalSessionStats>;
     archiveOldSessions(olderThanDays: number): Promise<number>;
     onSessionCreated(callback: (metadata: SessionMetadata) => void): void;

package/dist/src/session/manager.js

@@ -171,6 +171,12 @@ var SessionIndex = class extends EventEmitter$1 {
 		if (metadata) this.emit("sessionCreated", metadata);
 		return result;
 	}
+	async forkSessionAtTurn(sourceKey, options) {
+		const result = await this.store.forkSessionAtTurn(sourceKey, options);
+		const metadata = await this.store.getMetadata(result.sessionKey);
+		if (metadata) this.emit("sessionCreated", metadata);
+		return result;
+	}
 	async getStats() {
 		return this.store.getStats();
 	}

package/dist/src/session/store.d.ts

@@ -27,6 +27,16 @@ export interface SessionCompactionHooks {
     }) => Promise<void> | void;
 }
 export type ModelFallbackPreparation = 'prompt' | 'resume' | 'unsafe';
+export interface ForkSessionAtTurnOptions {
+    targetKey: string;
+    lastTurnId: string;
+    targetMetadata: SessionMetadataSeed;
+}
+export interface ForkSessionResult {
+    sessionKey: string;
+    rowCount: number;
+    lastTurnId?: string;
+}
 export declare class SessionStore {
     private options;
     private window;
@@ -182,6 +192,11 @@ export declare class SessionStore {
         sessionKey: string;
         rowCount: number;
     }>;
+    /**
+     * Atomically copy a completed turn prefix into a new session, including the
+     * source session's per-session agent configuration.
+     */
+    forkSessionAtTurn(sourceKey: string, options: ForkSessionAtTurnOptions): Promise<ForkSessionResult>;
     getStats(): Promise<GlobalSessionStats>;
     archiveOld(olderThanDays: number): Promise<number>;
     estimateTokens(messages: AgentMessage[]): number;

package/dist/src/session/store.js

@@ -2,12 +2,14 @@ import { init_paths_state, resolveStateDir } from "../config/paths-state.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { requireXopcDatabase } from "../storage/sqlite/connection.js";
+import { runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
 import { buildSessionContextForLlm, buildSessionDisplayMessages, isRuntimeOnlyTranscriptMessage, isTranscriptCompactionEntry, mergeLlmMessagesPreservingContextRows, transcriptRowsFromJsonArray } from "./session-context-for-llm.js";
 import "./types.js";
 import { init_agent_session_key, resolveAgentIdFromSessionKey } from "../routing/agent-session-key.js";
 import { estimateTokensFromMessages } from "../storage/sqlite/row-mappers.js";
 import { deleteSessionRecord, ensureSessionRecord, findSessionKeyBySessionId, getGlobalSessionStats, getSessionMetadata, listSessionMetadata, listSessionsByAgent, patchSessionMetadata, resetSessionRecord } from "../storage/sqlite/session-repository.js";
 import { appendCompactionBoundaryIfUnchanged, appendTranscriptEntry, listCompactionBoundaries, loadCompactionSourceSnapshot, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRowsForSession, paginateTranscriptMessages, replaceTranscriptRows, restoreBeforeCompactionBoundary, searchSessionTranscript } from "../storage/sqlite/transcript-repository.js";
+import { getSessionConfig, setSessionConfig } from "../storage/sqlite/config-repository.js";
 import "../storage/sqlite/index.js";
 import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { readPostCompactionContext } from "../agent/reply/post-compaction-context.js";
@@ -657,6 +659,62 @@ var SessionStore = class {
 			};
 		});
 	}
+	/**
+	* Atomically copy a completed turn prefix into a new session, including the
+	* source session's per-session agent configuration.
+	*/
+	async forkSessionAtTurn(sourceKey, options) {
+		requireXopcDatabase();
+		const targetKey = options.targetKey.trim();
+		const lastTurnId = options.lastTurnId.trim();
+		if (!targetKey) throw new Error("Target session key is required");
+		if (!lastTurnId) throw new Error("lastTurnId is required");
+		return runSqliteWriteTransaction(() => {
+			const sourceMetadata = getSessionMetadata(sourceKey);
+			if (!sourceMetadata) throw new Error(`Session not found: ${sourceKey}`);
+			if (getSessionMetadata(targetKey)) throw new Error(`Target session already exists: ${targetKey}`);
+			const rows = loadTranscriptHistoryRowsForSession(sourceKey);
+			let lastTurnRow = -1;
+			let hasAssistantOutput = false;
+			for (let index = 0; index < rows.length; index += 1) {
+				const row = rows[index];
+				if (row.turnId !== lastTurnId) continue;
+				lastTurnRow = index;
+				if (row.role === "assistant") hasAssistantOutput = true;
+			}
+			if (lastTurnRow < 0 || !hasAssistantOutput) throw new Error(`Completed turn not found: ${lastTurnId}`);
+			const selectedRows = rows.slice(0, lastTurnRow + 1);
+			const sourceLabel = sourceMetadata.name?.trim() || sourceKey;
+			const forkedAt = (/* @__PURE__ */ new Date()).toISOString();
+			const cwd = sourceMetadata.cwd?.trim() || this.resolveWorkspaceCwd(targetKey);
+			ensureSessionRecord(targetKey, cwd, {
+				...options.targetMetadata,
+				name: `Fork of ${sourceLabel}`,
+				tags: [...new Set([...sourceMetadata.tags ?? [], "fork"])],
+				projectId: sourceMetadata.projectId,
+				parentSessionKey: sourceKey,
+				hiddenFromSessionList: false,
+				customData: {
+					...sourceMetadata.customData ?? {},
+					...options.targetMetadata.customData ?? {},
+					genericNewChatShell: false,
+					forkedFromSessionKey: sourceKey,
+					forkedFromSessionId: sourceMetadata.sessionId,
+					forkedFromSessionName: sourceMetadata.name,
+					forkedFromTurnId: lastTurnId,
+					forkedAt
+				}
+			});
+			replaceTranscriptRows(targetKey, selectedRows);
+			const sourceConfig = getSessionConfig(sourceKey);
+			if (sourceConfig) setSessionConfig(targetKey, sourceConfig, cwd);
+			return {
+				sessionKey: targetKey,
+				rowCount: selectedRows.length,
+				lastTurnId
+			};
+		});
+	}
 	async getStats() {
 		requireXopcDatabase();
 		return getGlobalSessionStats();

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

@@ -10,7 +10,8 @@ export { closeTemporalAssertions, createTemporalAssertion, linkContextObjects, l
 export { finishContextConsolidationRun, getContextConsolidationRun, listContextConsolidationDecisions, listContextConsolidationRuns, recordContextConsolidationDecision, startContextConsolidationRun, type ContextConsolidationDecision, type ContextConsolidationRun, } from './context-consolidation-repository.js';
 export { summarizeUnderstandingFeedback, summarizeUserUnderstandingQuality, type UnderstandingFeedbackSummary, type UserUnderstandingQualityMetrics, } from './user-context-quality-repository.js';
 export { createCollaborationRule, createContextEvidence, createUnderstanding, closeUnderstandingValidity, consumeContextConsent, deleteCollaborationRule, deleteUnderstanding, decideContextConsent, ensureContextConsent, getCollaborationRule, getTurnPersonalization, getUnderstanding, getUserProfile, hasContextConsent, isUnderstandingSuppressed, listCollaborationRules, listUnderstandingEvidence, listUnderstandings, linkUnderstandingEvidence, recordContextFeedback, recordContextRun, rejectUnderstanding, reviseCollaborationRule, reviseUnderstanding, searchActiveUnderstandings, setCollaborationRuleStatus, setUnderstandingStatus, updateUserProfile, type CreateUnderstandingInput, } from './user-context-repository.js';
-export { cancelQueuedSessionInput, claimNextSessionInput, findSessionInput, finishSessionInputRun, getSessionInputState, getSessionInputById, insertSessionInput, mutateQueuedSessionInput, recoverSessionInputState, setSessionInputStatus, type SessionInput, type SessionInputDelivery, type SessionInputState, type SessionInputStatus, } from './session-input-repository.js';
+export { getUserPerson, getUserPeopleIndexState, listUserPeople, mergeUserPeople, replaceUserPeopleIndex, summarizeUserPeople, updateUserPerson, } from './user-people-repository.js';
+export { cancelQueuedSessionInput, claimNextSessionInput, findSessionInput, finishSessionInputRun, getSessionInputState, getSessionInputById, insertSessionInput, listActiveSessionInputRuns, mutateQueuedSessionInput, recoverSessionInputState, setSessionInputStatus, type SessionInput, type SessionInputDelivery, type SessionInputState, type SessionInputStatus, } from './session-input-repository.js';
 export { replaceLatestSessionTurnAndQueueInput, validateLatestSessionTurnTarget, type ReplaceLatestSessionTurnInput, type ReplaceLatestSessionTurnResult, } from './session-turn-replace-repository.js';
 export { acknowledgeHomeAttention, isHomeAttentionAcknowledged, type HomeAttentionSubjectKind, } from './home-attention-repository.js';
 export { claimNextConnectorLearningJob, enqueueConnectorLearningJob, listConnectorLearningJobs, recoverStaleConnectorLearningJobs, setConnectorLearningPaused, updateConnectorLearningJob, type ConnectorLearningJob, type ConnectorLearningMode, type ConnectorLearningPhase, type ConnectorLearningStatus, } from './connector-learning-repository.js';

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

@@ -11,7 +11,8 @@ import { closeTemporalAssertions, createTemporalAssertion, linkContextObjects, l
 import { finishContextConsolidationRun, getContextConsolidationRun, listContextConsolidationDecisions, listContextConsolidationRuns, recordContextConsolidationDecision, startContextConsolidationRun } from "./context-consolidation-repository.js";
 import { summarizeUnderstandingFeedback, summarizeUserUnderstandingQuality } from "./user-context-quality-repository.js";
 import { closeUnderstandingValidity, consumeContextConsent, createCollaborationRule, createContextEvidence, createUnderstanding, decideContextConsent, deleteCollaborationRule, deleteUnderstanding, ensureContextConsent, getCollaborationRule, getTurnPersonalization, getUnderstanding, getUserProfile, hasContextConsent, isUnderstandingSuppressed, linkUnderstandingEvidence, listCollaborationRules, listUnderstandingEvidence, listUnderstandings, recordContextFeedback, recordContextRun, rejectUnderstanding, reviseCollaborationRule, reviseUnderstanding, searchActiveUnderstandings, setCollaborationRuleStatus, setUnderstandingStatus, updateUserProfile } from "./user-context-repository.js";
-import { cancelQueuedSessionInput, claimNextSessionInput, findSessionInput, finishSessionInputRun, getSessionInputById, getSessionInputState, insertSessionInput, mutateQueuedSessionInput, recoverSessionInputState, setSessionInputStatus } from "./session-input-repository.js";
+import { getUserPeopleIndexState, getUserPerson, listUserPeople, mergeUserPeople, replaceUserPeopleIndex, summarizeUserPeople, updateUserPerson } from "./user-people-repository.js";
+import { cancelQueuedSessionInput, claimNextSessionInput, findSessionInput, finishSessionInputRun, getSessionInputById, getSessionInputState, insertSessionInput, listActiveSessionInputRuns, mutateQueuedSessionInput, recoverSessionInputState, setSessionInputStatus } from "./session-input-repository.js";
 import { buildDefaultSessionMetadata } from "./session-metadata.js";
 import { buildGlobalSessionStats, classifyStoredRow, estimateTokensFromMessages, extractFtsContent, metadataToSessionInsert, sessionConfigRowToConfig, sessionRowToMetadata, transcriptEntryRowToStoredRow } from "./row-mappers.js";
 import { replaceLatestSessionTurnAndQueueInput, validateLatestSessionTurnTarget } from "./session-turn-replace-repository.js";
@@ -35,4 +36,4 @@ import { appendConnectorExecutionAudit, claimConnectorWebhookDelivery, completeC
 import { getConnectorAccount, listConnectorAccounts, reconcileConnectorAccount, refreshConnectorAccountCurrent } from "./connector-account-repository.js";
 import { getConnectorSyncPolicy, getConnectorSyncPolicyForConnection, listConnectorSyncPolicies, upsertConnectorSyncPolicy } from "./connector-sync-policy-repository.js";
 import { getUserTrustPolicy, setUserTrustPolicy } from "./user-trust-repository.js";
-export { COMPOSER_INPUT_HISTORY_LIMIT, DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, acknowledgeHomeAttention, appendCompactionBoundaryIfUnchanged, appendComposerInputHistory, appendConnectorExecutionAudit, appendMemorySignal, appendMemoryTraceEvent, appendTranscriptEntry, applyPendingMigrations, attachMemoryEvidence, bindEndpointPrincipal, buildDefaultSessionMetadata, buildGlobalSessionStats, buildRelationshipPrompt, cancelQueuedSessionInput, claimConnectorWebhookDelivery, claimContextExtractionRun, claimKnowledgeSourceItems, claimNextConnectorLearningJob, claimNextSessionInput, classifyStoredRow, clearComposerInputHistory, closeTemporalAssertions, closeUnderstandingValidity, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, consumeConnectorApproval, consumeContextConsent, countKnowledgeSourceItems, countMemoryRecordsBySourceInstanceId, createCollaborationRule, createConnectorApproval, createContextEvidence, createEndpointPrincipal, createObjectLinkRecord, createTemporalAssertion, createUnderstanding, decideConnectorApproval, decideContextConsent, deleteCollaborationRule, deleteConnectorConnection, deleteConnectorInstallation, deleteKnowledgeSourceItems, deleteMemoryEvidenceForRecord, deleteMemoryRecord, deleteMemoryRecordsBySourceInstanceId, deleteNoteAgentContextRecord, deleteNoteRecord, deleteObjectLinkRecord, deleteSessionConfig, deleteSessionRecord, deleteUnderstanding, discoverSqlMigrations, enqueueConnectorLearningJob, ensureContextConsent, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findSessionInput, findSessionKeyBySessionId, finishContextConsolidationRun, finishContextExtractionRun, finishEndpointToolInvocationAudit, finishKnowledgeSyncRun, finishSessionInputRun, getActivityEventRecord, getCachedConnectorCatalogEntry, getCollaborationRule, getConnectorAccount, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getConnectorSyncPolicy, getConnectorSyncPolicyForConnection, getContextConsolidationRun, getContextExtractionRun, getCurrentSessionId, getEndpointPrincipal, getGlobalSessionStats, getInteractionState, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getMemoryProviderState, getMemoryRecord, getMemoryTurnFeedback, getNoteAgentContextRecord, getNoteRecord, getRelationshipSettings, getSessionConfig, getSessionInputById, getSessionInputState, getSessionMetadata, getSessionPersistedLevels, getSessionTaskPlan, getSqliteDatabase, getTurnPersonalization, getUnderstanding, getUserProfile, getUserTrustPolicy, getXopcDatabase, hasContextConsent, hasIndependentExtractionOutput, hasSessionConfig, hasUnresolvedMemoryConflict, incrementSessionStatsOnAppend, insertSessionInput, inspectSchemaMigrationStatus, isHomeAttentionAcknowledged, isProactiveSupportAllowed, isUnderstandingSuppressed, isXopcDatabaseOpen, linkContextObjects, linkUnderstandingEvidence, listActivityRecords, listCachedConnectorCatalogEntries, listCollaborationRules, listCompactionBoundaries, listComposerInputHistory, listConnectorAccounts, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listConnectorLearningJobs, listConnectorSyncPolicies, listContextConsolidationDecisions, listContextConsolidationRuns, listContextExtractionOutputs, listContextExtractionRuns, listContextObjectRelations, listEndpointPrincipals, listEndpointToolInvocationAudits, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, listTemporalAssertions, listUnderstandingEvidence, listUnderstandings, loadCompactionSourceSnapshot, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, markMemoryRecordsConflicted, metadataToSessionInsert, mutateQueuedSessionInput, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, pruneBoundedKnowledgeSourceItems, readSchemaVersion, readSchemaVersionForTest, reconcileConnectorAccount, recordActivityEvent, recordContextConsolidationDecision, recordContextFeedback, recordContextRun, recoverSessionInputState, recoverStaleConnectorLearningJobs, refreshConnectorAccountCurrent, rejectUnderstanding, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, replaceLatestSessionTurnAndQueueInput, replaceTranscriptRows, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreBeforeCompactionBoundary, reviseCollaborationRule, reviseUnderstanding, revokeEndpointPrincipal, runSqliteWriteTransaction, searchActiveUnderstandings, searchMemoryRecords, searchSessionTranscript, sessionConfigRowToConfig, sessionRowToMetadata, setCollaborationRuleStatus, setConnectorLearningPaused, setInteractionState, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setMemoryProviderState, setMemoryRecordStatus, setMemoryTurnFeedback, setSessionConfig, setSessionInputStatus, setSessionTaskPlan, setUnderstandingStatus, setUserTrustPolicy, startContextConsolidationRun, startEndpointToolInvocationAudit, startKnowledgeSyncRun, summarizeMemoryRecallFeedback, summarizeUnderstandingFeedback, summarizeUserUnderstandingQuality, touchEndpointPrincipal, transcriptEntryRowToStoredRow, updateConnectorLearningJob, updateInteractionStateFromMessage, updateRelationshipSettings, updateSessionConfig, updateSessionStats, updateUserProfile, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertConnectorSyncPolicy, upsertKnowledgeSourceItems, upsertMemoryRecord, upsertNoteAgentContextRecord, upsertNoteRecord, validateLatestSessionTurnTarget };
+export { COMPOSER_INPUT_HISTORY_LIMIT, DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, acknowledgeHomeAttention, appendCompactionBoundaryIfUnchanged, appendComposerInputHistory, appendConnectorExecutionAudit, appendMemorySignal, appendMemoryTraceEvent, appendTranscriptEntry, applyPendingMigrations, attachMemoryEvidence, bindEndpointPrincipal, buildDefaultSessionMetadata, buildGlobalSessionStats, buildRelationshipPrompt, cancelQueuedSessionInput, claimConnectorWebhookDelivery, claimContextExtractionRun, claimKnowledgeSourceItems, claimNextConnectorLearningJob, claimNextSessionInput, classifyStoredRow, clearComposerInputHistory, closeTemporalAssertions, closeUnderstandingValidity, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, consumeConnectorApproval, consumeContextConsent, countKnowledgeSourceItems, countMemoryRecordsBySourceInstanceId, createCollaborationRule, createConnectorApproval, createContextEvidence, createEndpointPrincipal, createObjectLinkRecord, createTemporalAssertion, createUnderstanding, decideConnectorApproval, decideContextConsent, deleteCollaborationRule, deleteConnectorConnection, deleteConnectorInstallation, deleteKnowledgeSourceItems, deleteMemoryEvidenceForRecord, deleteMemoryRecord, deleteMemoryRecordsBySourceInstanceId, deleteNoteAgentContextRecord, deleteNoteRecord, deleteObjectLinkRecord, deleteSessionConfig, deleteSessionRecord, deleteUnderstanding, discoverSqlMigrations, enqueueConnectorLearningJob, ensureContextConsent, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findSessionInput, findSessionKeyBySessionId, finishContextConsolidationRun, finishContextExtractionRun, finishEndpointToolInvocationAudit, finishKnowledgeSyncRun, finishSessionInputRun, getActivityEventRecord, getCachedConnectorCatalogEntry, getCollaborationRule, getConnectorAccount, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getConnectorSyncPolicy, getConnectorSyncPolicyForConnection, getContextConsolidationRun, getContextExtractionRun, getCurrentSessionId, getEndpointPrincipal, getGlobalSessionStats, getInteractionState, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getMemoryProviderState, getMemoryRecord, getMemoryTurnFeedback, getNoteAgentContextRecord, getNoteRecord, getRelationshipSettings, getSessionConfig, getSessionInputById, getSessionInputState, getSessionMetadata, getSessionPersistedLevels, getSessionTaskPlan, getSqliteDatabase, getTurnPersonalization, getUnderstanding, getUserPeopleIndexState, getUserPerson, getUserProfile, getUserTrustPolicy, getXopcDatabase, hasContextConsent, hasIndependentExtractionOutput, hasSessionConfig, hasUnresolvedMemoryConflict, incrementSessionStatsOnAppend, insertSessionInput, inspectSchemaMigrationStatus, isHomeAttentionAcknowledged, isProactiveSupportAllowed, isUnderstandingSuppressed, isXopcDatabaseOpen, linkContextObjects, linkUnderstandingEvidence, listActiveSessionInputRuns, listActivityRecords, listCachedConnectorCatalogEntries, listCollaborationRules, listCompactionBoundaries, listComposerInputHistory, listConnectorAccounts, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listConnectorLearningJobs, listConnectorSyncPolicies, listContextConsolidationDecisions, listContextConsolidationRuns, listContextExtractionOutputs, listContextExtractionRuns, listContextObjectRelations, listEndpointPrincipals, listEndpointToolInvocationAudits, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, listTemporalAssertions, listUnderstandingEvidence, listUnderstandings, listUserPeople, loadCompactionSourceSnapshot, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, markMemoryRecordsConflicted, mergeUserPeople, metadataToSessionInsert, mutateQueuedSessionInput, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, pruneBoundedKnowledgeSourceItems, readSchemaVersion, readSchemaVersionForTest, reconcileConnectorAccount, recordActivityEvent, recordContextConsolidationDecision, recordContextFeedback, recordContextRun, recoverSessionInputState, recoverStaleConnectorLearningJobs, refreshConnectorAccountCurrent, rejectUnderstanding, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, replaceLatestSessionTurnAndQueueInput, replaceTranscriptRows, replaceUserPeopleIndex, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreBeforeCompactionBoundary, reviseCollaborationRule, reviseUnderstanding, revokeEndpointPrincipal, runSqliteWriteTransaction, searchActiveUnderstandings, searchMemoryRecords, searchSessionTranscript, sessionConfigRowToConfig, sessionRowToMetadata, setCollaborationRuleStatus, setConnectorLearningPaused, setInteractionState, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setMemoryProviderState, setMemoryRecordStatus, setMemoryTurnFeedback, setSessionConfig, setSessionInputStatus, setSessionTaskPlan, setUnderstandingStatus, setUserTrustPolicy, startContextConsolidationRun, startEndpointToolInvocationAudit, startKnowledgeSyncRun, summarizeMemoryRecallFeedback, summarizeUnderstandingFeedback, summarizeUserPeople, summarizeUserUnderstandingQuality, touchEndpointPrincipal, transcriptEntryRowToStoredRow, updateConnectorLearningJob, updateInteractionStateFromMessage, updateRelationshipSettings, updateSessionConfig, updateSessionStats, updateUserPerson, updateUserProfile, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertConnectorSyncPolicy, upsertKnowledgeSourceItems, upsertMemoryRecord, upsertNoteAgentContextRecord, upsertNoteRecord, validateLatestSessionTurnTarget };

package/dist/src/storage/sqlite/migrations/135_user_people.sql

@@ -0,0 +1,59 @@
+CREATE TABLE user_people (
+  person_id TEXT PRIMARY KEY,
+  principal_id TEXT NOT NULL,
+  display_name TEXT NOT NULL,
+  user_display_name TEXT,
+  inferred_kind TEXT NOT NULL CHECK (inferred_kind IN ('person', 'bot', 'service', 'group', 'unknown')),
+  user_kind TEXT CHECK (user_kind IS NULL OR user_kind IN ('person', 'bot', 'service', 'group', 'unknown')),
+  hidden INTEGER NOT NULL DEFAULT 0 CHECK (hidden IN (0, 1)),
+  merged_into_person_id TEXT REFERENCES user_people(person_id) ON DELETE SET NULL,
+  confidence REAL NOT NULL CHECK (confidence >= 0 AND confidence <= 1),
+  first_observed_at INTEGER NOT NULL,
+  last_observed_at INTEGER NOT NULL,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL
+);
+
+CREATE INDEX idx_user_people_principal_kind
+  ON user_people(principal_id, inferred_kind, last_observed_at DESC);
+CREATE INDEX idx_user_people_merge_target
+  ON user_people(merged_into_person_id);
+
+CREATE TABLE user_person_handles (
+  handle_id TEXT PRIMARY KEY,
+  person_id TEXT NOT NULL REFERENCES user_people(person_id) ON DELETE CASCADE,
+  handle_type TEXT NOT NULL CHECK (handle_type IN ('email', 'provider_user', 'username', 'display_name')),
+  normalized_value TEXT NOT NULL,
+  display_value TEXT NOT NULL,
+  source_instance_id TEXT NOT NULL,
+  verification TEXT NOT NULL CHECK (verification IN ('observed', 'inferred', 'user_confirmed')),
+  first_observed_at INTEGER NOT NULL,
+  last_observed_at INTEGER NOT NULL,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL,
+  UNIQUE(handle_type, normalized_value, source_instance_id)
+);
+
+CREATE INDEX idx_user_person_handles_person ON user_person_handles(person_id);
+CREATE INDEX idx_user_person_handles_lookup ON user_person_handles(handle_type, normalized_value);
+
+CREATE TABLE user_person_source_stats (
+  person_id TEXT NOT NULL REFERENCES user_people(person_id) ON DELETE CASCADE,
+  source_instance_id TEXT NOT NULL,
+  interaction_count INTEGER NOT NULL CHECK (interaction_count >= 0),
+  first_observed_at INTEGER NOT NULL,
+  last_observed_at INTEGER NOT NULL,
+  last_source_item_id TEXT,
+  updated_at INTEGER NOT NULL,
+  PRIMARY KEY(person_id, source_instance_id)
+);
+
+CREATE INDEX idx_user_person_source_stats_source
+  ON user_person_source_stats(source_instance_id, last_observed_at DESC);
+
+CREATE TABLE user_people_index_state (
+  principal_id TEXT PRIMARY KEY,
+  source_change_sequence INTEGER NOT NULL,
+  source_grants_updated_at INTEGER NOT NULL,
+  rebuilt_at INTEGER NOT NULL
+);

package/dist/src/storage/sqlite/migrations/136_product_notifications.sql

@@ -0,0 +1,79 @@
+CREATE TABLE notification_devices (
+  device_id             TEXT PRIMARY KEY,
+  platform              TEXT NOT NULL CHECK (platform IN ('ios', 'android')),
+  push_token            TEXT NOT NULL,
+  push_provider         TEXT NOT NULL DEFAULT 'expo',
+  enabled               INTEGER NOT NULL DEFAULT 1 CHECK (enabled IN (0, 1)),
+  permissions           TEXT NOT NULL DEFAULT 'unknown' CHECK (permissions IN ('granted', 'denied', 'unknown')),
+  preferences_json      TEXT NOT NULL DEFAULT '{}',
+  locale                TEXT NOT NULL DEFAULT 'en' CHECK (locale IN ('en', 'zh')),
+  app_version           TEXT,
+  lease_expires_at      INTEGER NOT NULL,
+  last_seen_at          INTEGER NOT NULL,
+  created_at            INTEGER NOT NULL,
+  updated_at            INTEGER NOT NULL
+);
+
+INSERT INTO notification_devices (
+  device_id, platform, push_token, push_provider, enabled, permissions,
+  preferences_json, locale, app_version, lease_expires_at,
+  last_seen_at, created_at, updated_at
+)
+SELECT
+  device_id, platform, push_token, push_provider, enabled, permissions,
+  preferences_json, 'en', app_version,
+  (unixepoch() * 1000) + 604800000,
+  last_seen_at, created_at, updated_at
+FROM mobile_devices;
+
+CREATE UNIQUE INDEX idx_notification_devices_push_token
+  ON notification_devices(push_provider, push_token);
+CREATE INDEX idx_notification_devices_delivery
+  ON notification_devices(enabled, permissions, lease_expires_at);
+
+CREATE TABLE notification_events (
+  event_id              TEXT PRIMARY KEY,
+  dedupe_key            TEXT NOT NULL UNIQUE,
+  event_type            TEXT NOT NULL,
+  target_json           TEXT NOT NULL,
+  priority              TEXT NOT NULL CHECK (priority IN ('normal', 'high')),
+  title_en              TEXT NOT NULL,
+  title_zh              TEXT NOT NULL,
+  body_en               TEXT,
+  body_zh               TEXT,
+  payload_json          TEXT NOT NULL DEFAULT '{}',
+  created_at            INTEGER NOT NULL
+);
+
+CREATE INDEX idx_notification_events_created
+  ON notification_events(created_at, event_id);
+
+CREATE TABLE notification_deliveries (
+  event_id              TEXT NOT NULL,
+  device_id             TEXT NOT NULL,
+  status                TEXT NOT NULL CHECK (status IN ('pending', 'accepted', 'delivered', 'dead')),
+  attempts              INTEGER NOT NULL DEFAULT 0,
+  next_attempt_at       INTEGER NOT NULL,
+  provider_ticket_id    TEXT,
+  last_error            TEXT,
+  updated_at            INTEGER NOT NULL,
+  PRIMARY KEY (event_id, device_id),
+  FOREIGN KEY (event_id) REFERENCES notification_events(event_id) ON DELETE CASCADE,
+  FOREIGN KEY (device_id) REFERENCES notification_devices(device_id) ON DELETE CASCADE
+);
+
+CREATE INDEX idx_notification_deliveries_due
+  ON notification_deliveries(status, next_attempt_at);
+
+CREATE TABLE notification_acknowledgements (
+  event_id              TEXT NOT NULL,
+  consumer_id           TEXT NOT NULL,
+  surface               TEXT NOT NULL CHECK (surface IN ('web', 'electron', 'mobile')),
+  acknowledged_at       INTEGER NOT NULL,
+  PRIMARY KEY (event_id, consumer_id),
+  FOREIGN KEY (event_id) REFERENCES notification_events(event_id) ON DELETE CASCADE
+);
+
+DROP TABLE mobile_activity_acknowledgements;
+DROP TABLE mobile_activity_events;
+DROP TABLE mobile_devices;

package/dist/src/storage/sqlite/migrations/runner.d.ts

@@ -3,7 +3,7 @@ import type { ApplyMigrationsOptions } from './types.js';
 /** Baseline schema version applied from schema.sql on first open. */
 export declare const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 /** Latest schema version this release supports (increment when adding migrations). */
-export declare const XOPC_DB_SCHEMA_VERSION = 134;
+export declare const XOPC_DB_SCHEMA_VERSION = 136;
 export declare function resolveMigrationsDir(override?: string): string;
 /**
  * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.