@xopcai/xopc 0.0.218 → 0.0.220

package/dist/src/user-context/sources/repository.js

@@ -1,4 +1,5 @@
 import { getSqliteDatabase, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
+import "../domain.js";
 import { randomUUID } from "node:crypto";
 //#region src/user-context/sources/repository.ts
 function record(value) {
@@ -53,19 +54,82 @@ function runFromRow(row) {
 function focusFromRow(row) {
 	return {
 		id: row.focus_id,
+		versionId: row.current_version_id,
+		principalId: row.principal_id,
 		canonicalKey: row.canonical_key,
 		title: row.title,
 		summary: row.summary,
 		horizon: row.horizon,
 		status: row.status,
 		confidence: row.confidence,
-		...row.project_id ? { projectId: row.project_id } : {},
+		scope: {
+			type: row.scope_type,
+			...row.scope_id ? { id: row.scope_id } : {}
+		},
+		explicitness: row.explicitness,
+		sensitivity: row.sensitivity,
+		disclosurePolicy: row.disclosure_policy,
+		...row.valid_from == null ? {} : { validFrom: row.valid_from },
+		...row.valid_to == null ? {} : { validTo: row.valid_to },
+		...row.review_at == null ? {} : { reviewAt: row.review_at },
 		evidenceRefs: strings(row.evidence_refs_json),
 		...row.source_run_id ? { sourceRunId: row.source_run_id } : {},
 		createdAt: row.created_at,
 		updatedAt: row.updated_at
 	};
 }
+function focusSnapshot(row) {
+	return {
+		horizon: row.horizon,
+		status: row.status,
+		confidence: row.confidence,
+		scopeType: row.scope_type,
+		scopeId: row.scope_id,
+		explicitness: row.explicitness,
+		sensitivity: row.sensitivity,
+		disclosurePolicy: row.disclosure_policy,
+		validFrom: row.valid_from,
+		validTo: row.valid_to,
+		reviewAt: row.review_at,
+		evidenceRefs: strings(row.evidence_refs_json)
+	};
+}
+function sameFocusVersion(left, right) {
+	return Boolean(left && left.title === right.title && left.summary === right.summary && JSON.stringify(focusSnapshot(left)) === JSON.stringify(focusSnapshot(right)));
+}
+function linkFocusEvidence(versionId, evidenceRefs, confidence) {
+	if (!evidenceRefs.length) return;
+	const placeholders = evidenceRefs.map(() => "?").join(", ");
+	getSqliteDatabase().prepare(`INSERT OR IGNORE INTO user_focus_evidence_links (
+    version_id, evidence_id, relation, confidence
+  ) SELECT ?, evidence_id, 'supports', ? FROM context_evidence WHERE source_ref IN (${placeholders})`).run(versionId, confidence, ...evidenceRefs);
+}
+function listUserFocusEvidence(focusId) {
+	return getSqliteDatabase().prepare(`SELECT DISTINCT e.* FROM context_evidence e
+    JOIN user_focus_evidence_links l ON l.evidence_id = e.evidence_id
+    JOIN user_focus_versions v ON v.version_id = l.version_id
+    WHERE v.focus_id = ? ORDER BY e.observed_at DESC`).all(focusId).map((row) => ({
+		id: row.evidence_id,
+		sourceType: row.source_type,
+		...row.source_instance_id ? { sourceInstanceId: row.source_instance_id } : {},
+		sourceRef: row.source_ref,
+		...row.source_run_id ? { sourceRunId: row.source_run_id } : {},
+		...row.source_item_id ? { sourceItemId: row.source_item_id } : {},
+		...row.session_id ? { sessionId: row.session_id } : {},
+		...row.turn_id ? { turnId: row.turn_id } : {},
+		...row.message_id ? { messageId: row.message_id } : {},
+		...row.content_hash ? { contentHash: row.content_hash } : {},
+		...row.retention_policy ? { retentionPolicy: row.retention_policy } : {},
+		...row.processing_policy ? { processingPolicy: row.processing_policy } : {},
+		...row.extractor_id ? { extractorId: row.extractor_id } : {},
+		...row.extractor_version ? { extractorVersion: row.extractor_version } : {},
+		...row.redacted_excerpt ? { redactedExcerpt: row.redacted_excerpt } : {},
+		trustLevel: row.trust_level,
+		observedAt: row.observed_at,
+		ingestedAt: row.ingested_at ?? row.created_at,
+		createdAt: row.created_at
+	}));
+}
 function listUnderstandingSourceGrants(options = {}) {
 	return getSqliteDatabase().prepare(`SELECT * FROM understanding_source_grants ${options.includeRevoked ? "" : "WHERE status = 'active'"} ORDER BY updated_at DESC`).all().map(grantFromRow);
 }
@@ -85,8 +149,7 @@ function upsertUnderstandingSourceGrant(input) {
     ) VALUES (?, ?, ?, ?, ?, ?, 'active', ?, ?, ?, ?, ?, ?, ?, ?)
     ON CONFLICT(source_key) DO UPDATE SET
       adapter_id = excluded.adapter_id, category = excluded.category, platform = excluded.platform,
-      display_name = excluded.display_name, status = 'active', access_mode = excluded.access_mode,
-      retention_policy = excluded.retention_policy, processing_policy = excluded.processing_policy,
+      display_name = excluded.display_name, status = 'active',
       config_json = excluded.config_json, checkpoint_json = excluded.checkpoint_json,
       last_collected_at = COALESCE(excluded.last_collected_at, understanding_source_grants.last_collected_at),
       updated_at = excluded.updated_at
@@ -104,6 +167,16 @@ function updateUnderstandingSourceGrantCheckpoint(id, input) {
   `).run(JSON.stringify(input.checkpoint ?? current.checkpoint), input.lastCollectedAt ?? current.lastCollectedAt ?? null, now, id));
 	return getUnderstandingSourceGrant(id);
 }
+function updateUnderstandingSourceGrantPolicies(id, patch) {
+	const current = getUnderstandingSourceGrant(id);
+	if (!current) return null;
+	runSqliteWriteTransaction((db) => db.prepare(`
+    UPDATE understanding_source_grants
+    SET access_mode = ?, retention_policy = ?, processing_policy = ?, updated_at = ?
+    WHERE grant_id = ?
+  `).run(patch.accessMode ?? current.accessMode, patch.retentionPolicy ?? current.retentionPolicy, patch.processingPolicy ?? current.processingPolicy, patch.nowMs ?? Date.now(), id));
+	return getUnderstandingSourceGrant(id);
+}
 function revokeUnderstandingSourceGrant(id, nowMs = Date.now()) {
 	runSqliteWriteTransaction((db) => db.prepare("UPDATE understanding_source_grants SET status = 'revoked', updated_at = ? WHERE grant_id = ?").run(nowMs, id));
 	return getUnderstandingSourceGrant(id);
@@ -138,11 +211,20 @@ function updateUnderstandingSourceRun(id, patch) {
 function upsertUserFocus(input) {
 	const id = randomUUID();
 	const now = input.nowMs ?? Date.now();
-	runSqliteWriteTransaction((db) => db.prepare(`
+	const scope = input.scope ?? { type: "global" };
+	const explicitness = input.explicitness ?? "inferred";
+	const sensitivity = input.sensitivity ?? "normal";
+	const disclosurePolicy = input.disclosurePolicy ?? "referenceable";
+	const existingRow = getSqliteDatabase().prepare("SELECT * FROM user_focuses WHERE canonical_key = ?").get(input.canonicalKey);
+	if (existingRow?.explicitness === "explicit" && explicitness !== "explicit") return focusFromRow(existingRow);
+	let currentVersionId = existingRow?.current_version_id;
+	runSqliteWriteTransaction((db) => {
+		db.prepare(`
     INSERT INTO user_focuses (
-      focus_id, canonical_key, title, summary, horizon, status, confidence, project_id,
-      evidence_refs_json, source_run_id, created_at, updated_at
-    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      focus_id, principal_id, canonical_key, title, summary, horizon, status, confidence,
+      scope_type, scope_id, explicitness, sensitivity, disclosure_policy,
+      valid_from, valid_to, review_at, evidence_refs_json, source_run_id, created_at, updated_at
+    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
     ON CONFLICT(canonical_key) DO UPDATE SET title = excluded.title, summary = excluded.summary,
       horizon = excluded.horizon,
       status = CASE
@@ -151,9 +233,23 @@ function upsertUserFocus(input) {
         ELSE excluded.status
       END,
       confidence = excluded.confidence,
-      project_id = excluded.project_id, evidence_refs_json = excluded.evidence_refs_json,
+      scope_type = excluded.scope_type, scope_id = excluded.scope_id,
+      explicitness = excluded.explicitness, sensitivity = excluded.sensitivity,
+      disclosure_policy = excluded.disclosure_policy, valid_from = excluded.valid_from,
+      valid_to = excluded.valid_to, review_at = excluded.review_at,
+      evidence_refs_json = excluded.evidence_refs_json,
       source_run_id = excluded.source_run_id, updated_at = excluded.updated_at
-  `).run(id, input.canonicalKey, input.title, input.summary, input.horizon, input.status, input.confidence, input.projectId ?? null, JSON.stringify(input.evidenceRefs), input.sourceRunId ?? null, now, now));
+  `).run(id, input.principalId ?? "local-owner", input.canonicalKey, input.title, input.summary, input.horizon, input.status, input.confidence, scope.type, scope.id ?? null, explicitness, sensitivity, disclosurePolicy, input.validFrom ?? null, input.validTo ?? null, input.reviewAt ?? null, JSON.stringify(input.evidenceRefs), input.sourceRunId ?? null, now, now);
+		const nextRow = db.prepare("SELECT * FROM user_focuses WHERE canonical_key = ?").get(input.canonicalKey);
+		if (!sameFocusVersion(existingRow, nextRow)) {
+			currentVersionId = randomUUID();
+			db.prepare(`INSERT INTO user_focus_versions (
+        version_id, focus_id, title, summary, snapshot_json, created_by, change_reason, created_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)`).run(currentVersionId, nextRow.focus_id, nextRow.title, nextRow.summary, JSON.stringify(focusSnapshot(nextRow)), explicitness === "explicit" ? "user" : input.sourceRunId ? "connector" : "runtime", input.changeReason ?? (existingRow ? "Focus updated" : "Focus created"), now);
+			db.prepare("UPDATE user_focuses SET current_version_id = ? WHERE focus_id = ?").run(currentVersionId, nextRow.focus_id);
+		}
+	});
+	if (currentVersionId) linkFocusEvidence(currentVersionId, input.evidenceRefs, input.confidence);
 	return focusFromRow(getSqliteDatabase().prepare("SELECT * FROM user_focuses WHERE canonical_key = ?").get(input.canonicalKey));
 }
 function listUserFocuses(statuses) {
@@ -161,8 +257,22 @@ function listUserFocuses(statuses) {
 	const placeholders = statuses.map(() => "?").join(", ");
 	return getSqliteDatabase().prepare(`SELECT * FROM user_focuses WHERE status IN (${placeholders}) ORDER BY updated_at DESC`).all(...statuses).map(focusFromRow);
 }
-function setUserFocusStatus(id, status, nowMs = Date.now()) {
-	runSqliteWriteTransaction((db) => db.prepare("UPDATE user_focuses SET status = ?, updated_at = ? WHERE focus_id = ?").run(status, nowMs, id));
+function updateUserFocus(id, patch, nowMs = Date.now()) {
+	const currentRow = getSqliteDatabase().prepare("SELECT * FROM user_focuses WHERE focus_id = ?").get(id);
+	if (!currentRow) return null;
+	const current = focusFromRow(currentRow);
+	if ((patch.title ?? current.title) === current.title && (patch.summary ?? current.summary) === current.summary && (patch.status ?? current.status) === current.status) return current;
+	const versionId = randomUUID();
+	runSqliteWriteTransaction((db) => {
+		db.prepare(`UPDATE user_focuses
+      SET title = ?, summary = ?, status = ?, updated_at = ? WHERE focus_id = ?`).run(patch.title ?? current.title, patch.summary ?? current.summary, patch.status ?? current.status, nowMs, id);
+		const nextRow = db.prepare("SELECT * FROM user_focuses WHERE focus_id = ?").get(id);
+		db.prepare(`INSERT INTO user_focus_versions (
+      version_id, focus_id, title, summary, snapshot_json, created_by, change_reason, created_at
+    ) VALUES (?, ?, ?, ?, ?, ?, 'Focus updated', ?)`).run(versionId, id, nextRow.title, nextRow.summary, JSON.stringify(focusSnapshot(nextRow)), current.explicitness === "explicit" ? "user" : "runtime", nowMs);
+		db.prepare("UPDATE user_focuses SET current_version_id = ? WHERE focus_id = ?").run(versionId, id);
+	});
+	linkFocusEvidence(versionId, current.evidenceRefs, current.confidence);
 	const row = getSqliteDatabase().prepare("SELECT * FROM user_focuses WHERE focus_id = ?").get(id);
 	return row ? focusFromRow(row) : null;
 }
@@ -170,4 +280,4 @@ function deleteUserFocus(id) {
 	return Number(getSqliteDatabase().prepare("DELETE FROM user_focuses WHERE focus_id = ?").run(id).changes) > 0;
 }
 //#endregion
-export { createUnderstandingSourceRun, deleteUserFocus, getUnderstandingSourceGrant, getUnderstandingSourceRun, listUnderstandingSourceGrants, listUnderstandingSourceRuns, listUserFocuses, revokeUnderstandingSourceGrant, setUserFocusStatus, updateUnderstandingSourceGrantCheckpoint, updateUnderstandingSourceRun, upsertUnderstandingSourceGrant, upsertUserFocus };
+export { createUnderstandingSourceRun, deleteUserFocus, getUnderstandingSourceGrant, getUnderstandingSourceRun, listUnderstandingSourceGrants, listUnderstandingSourceRuns, listUserFocusEvidence, listUserFocuses, revokeUnderstandingSourceGrant, updateUnderstandingSourceGrantCheckpoint, updateUnderstandingSourceGrantPolicies, updateUnderstandingSourceRun, updateUserFocus, upsertUnderstandingSourceGrant, upsertUserFocus };

package/dist/src/user-context/sources/types.d.ts

@@ -1,3 +1,4 @@
+import type { UserContextScope, UserUnderstanding } from '../domain.js';
 export type UnderstandingSourcePlatform = 'darwin' | 'win32' | 'linux' | 'all';
 export type UnderstandingSourceCategory = 'files' | 'recent_documents' | 'calendar' | 'tasks' | 'notes' | 'mail' | 'messages' | 'code_activity';
 export type UnderstandingSourceAccessMode = 'once' | 'continuous';
@@ -75,13 +76,21 @@ export interface UnderstandingSourceRun {
 }
 export interface UserFocus {
     id: string;
+    versionId: string;
+    principalId: string;
     canonicalKey: string;
     title: string;
     summary: string;
     horizon: 'current' | 'ongoing' | 'long_term';
     status: 'candidate' | 'active' | 'paused' | 'completed' | 'rejected';
     confidence: number;
-    projectId?: string;
+    scope: UserContextScope;
+    explicitness: UserUnderstanding['explicitness'];
+    sensitivity: UserUnderstanding['sensitivity'];
+    disclosurePolicy: UserUnderstanding['disclosurePolicy'];
+    validFrom?: number;
+    validTo?: number;
+    reviewAt?: number;
     evidenceRefs: string[];
     sourceRunId?: string;
     createdAt: number;

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

@@ -8,7 +8,7 @@ function canonicalUnderstandingKey(kind, statement) {
 function isSameUserContextScope(left, right) {
 	return left.type === right.type && left.id === right.id;
 }
-const NEGATION = /\b(?:do not|don't|never|avoid|without)\b|(?:不要|不用|无需|从不|避免|禁止)/i;
+const NEGATION = /\b(?:do not|don't|not|never|avoid|without)\b|(?:不要|不用|无需|从不|避免|禁止)/i;
 function withoutNegation(statement) {
 	return statement.replace(NEGATION, "").replace(/\s+/g, " ").trim();
 }

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

@@ -82,7 +82,7 @@ function validateSuggestion(value, allowedPaths) {
 function validateProfileCandidate(value, allowedRefs) {
 	if (!value || typeof value !== "object") return null;
 	const item = value;
-	const category = item.category === "role" || item.category === "focus" || item.category === "technology" || item.category === "workflow" || item.category === "preference" ? item.category : void 0;
+	const category = item.category === "role" || item.category === "responsibility" || item.category === "preference" || item.category === "routine" ? item.category : void 0;
 	if (!category || typeof item.statement !== "string") return null;
 	const statement = item.statement.trim().slice(0, 500);
 	if (statement.length < 4) return null;
@@ -181,8 +181,9 @@ async function analyzeWorkContext(input) {
 			"You help a user resume real work in one explicitly selected local folder.",
 			"Analyze only the supplied bounded snapshot. Never claim that you ran commands, tests, or inspected anything absent from it.",
 			"Return only one JSON object with projectSummary, currentState, uncertainties, suggestions, profileCandidates, workThreads, conversationStarter, lowConfidence, and contextQuestion.",
-			"profileCandidates contains stable, useful facts about the user inferred from the supplied project evidence. Include every distinct fact with direct support; do not pad the list.",
-			"Each profile candidate has category (role, focus, technology, workflow, or preference), statement, confidence, and evidence.",
+			"profileCandidates contains only user-specific role, responsibility, preference, or routine facts that are directly supported and would remain useful outside this repository snapshot.",
+			"Do not put the project stack, packages, architecture, deployment setup, repository conventions, or current task in profileCandidates. Put project facts in projectSummary/currentState and current work in workThreads.",
+			"Each profile candidate has category (role, responsibility, preference, or routine), statement, confidence, and evidence.",
 			USER_FACING_UNDERSTANDING_WRITING_GUIDANCE,
 			"Do not infer sensitive traits, identity, health, finances, political views, or anything not directly supported by the work evidence.",
 			"workThreads contains every distinct evidence-backed work stream with topicKey, title, summary, horizon, status, confidence, and evidenceRefs. Do not merge unrelated streams to force a fixed count.",
@@ -286,7 +287,8 @@ async function analyzeUnderstandingBatch(input) {
 		"Analyze one bounded batch from a source the user explicitly chose to connect.",
 		"Return only one JSON object with profileCandidates and workThreads.",
 		"Return at most 8 profileCandidates and at most 8 workThreads. Prefer the strongest distinct findings.",
-		"Each profile candidate has category (role, focus, technology, workflow, or preference), statement, confidence, evidence, and evidenceRefs.",
+		"profileCandidates contains only user-specific role, responsibility, preference, or routine facts with direct support. Current tasks belong in workThreads; project technologies, packages, architecture, and repository conventions are not user facts.",
+		"Each profile candidate has category (role, responsibility, preference, or routine), statement, confidence, evidence, and evidenceRefs.",
 		USER_FACING_UNDERSTANDING_WRITING_GUIDANCE,
 		"Each work thread has topicKey, title, summary, status, horizon, confidence, and evidenceRefs.",
 		"Every evidenceRefs value must be one of the supplied refs. Omit anything without direct support.",

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

@@ -8,6 +8,6 @@ import { appendWorkUnderstandingEvidence, createWorkUnderstandingInvestigation,
 import { DEFAULT_WORK_INVESTIGATION_BUDGET, investigateWorkContext } from "./investigator.js";
 import { persistWorkThreadsFromDiscovery } from "./thread-service.js";
 import { getWorkDiscoveryDirectorySource, listWorkDiscoveryDirectorySources, revokeWorkDiscoveryDirectorySource, upsertWorkDiscoveryDirectorySource } from "./source-repository.js";
-import { WorkDiscoveryService } from "./service.js";
+import { WorkDiscoveryService, normalizeUnderstandingSourceItems } from "./service.js";
 import { evaluateQuickUnderstandingCase, evaluateWorkUnderstandingCase, meetsQuickUnderstandingGate } from "./evaluation.js";
-export { DEFAULT_WORK_INVESTIGATION_BUDGET, WORK_DISCOVERY_SCAN_POLICY_VERSION, WorkDiscoveryService, analyzeUnderstandingSources, analyzeWorkContext, appendWorkUnderstandingEvidence, canonicalWorkDiscoveryRoot, createWorkDiscoveryRun, createWorkUnderstandingInvestigation, discoverWorkCandidates, evaluateQuickUnderstandingCase, evaluateWorkUnderstandingCase, findActiveWorkDiscoverySourceRefresh, getWorkDiscoveryDirectorySource, getWorkDiscoveryOnboardingState, getWorkDiscoveryRun, getWorkDiscoveryRunByIdempotencyKey, getWorkUnderstandingInvestigation, getWorkUnderstandingInvestigationForRun, investigateWorkContext, listWorkDiscoveryDirectorySources, listWorkDiscoverySourceRefreshes, listWorkUnderstandingEvidence, meetsQuickUnderstandingGate, persistWorkThreadsFromDiscovery, previewWorkDiscoveryRoot, probeWorkDiscoveryRoot, readWorkDiscoveryTextExcerpt, recordWorkDiscoverySourceRefresh, resetWorkUnderstandingInvestigation, resolvePersonalWorkRoots, revokeWorkDiscoveryDirectorySource, searchWorkDiscoveryText, setWorkDiscoveryFeedback, setWorkDiscoveryOnboardingState, summarizeWorkContextSnapshot, updateWorkDiscoveryRun, updateWorkDiscoverySourceRefreshForRun, updateWorkUnderstandingEvidenceObservation, updateWorkUnderstandingInvestigation, upsertWorkDiscoveryDirectorySource, workDiscoveryFingerprintsEqual, workDiscoveryResultMarkdown };
+export { DEFAULT_WORK_INVESTIGATION_BUDGET, WORK_DISCOVERY_SCAN_POLICY_VERSION, WorkDiscoveryService, analyzeUnderstandingSources, analyzeWorkContext, appendWorkUnderstandingEvidence, canonicalWorkDiscoveryRoot, createWorkDiscoveryRun, createWorkUnderstandingInvestigation, discoverWorkCandidates, evaluateQuickUnderstandingCase, evaluateWorkUnderstandingCase, findActiveWorkDiscoverySourceRefresh, getWorkDiscoveryDirectorySource, getWorkDiscoveryOnboardingState, getWorkDiscoveryRun, getWorkDiscoveryRunByIdempotencyKey, getWorkUnderstandingInvestigation, getWorkUnderstandingInvestigationForRun, investigateWorkContext, listWorkDiscoveryDirectorySources, listWorkDiscoverySourceRefreshes, listWorkUnderstandingEvidence, meetsQuickUnderstandingGate, normalizeUnderstandingSourceItems, persistWorkThreadsFromDiscovery, previewWorkDiscoveryRoot, probeWorkDiscoveryRoot, readWorkDiscoveryTextExcerpt, recordWorkDiscoverySourceRefresh, resetWorkUnderstandingInvestigation, resolvePersonalWorkRoots, revokeWorkDiscoveryDirectorySource, searchWorkDiscoveryText, setWorkDiscoveryFeedback, setWorkDiscoveryOnboardingState, summarizeWorkContextSnapshot, updateWorkDiscoveryRun, updateWorkDiscoverySourceRefreshForRun, updateWorkUnderstandingEvidenceObservation, updateWorkUnderstandingInvestigation, upsertWorkDiscoveryDirectorySource, workDiscoveryFingerprintsEqual, workDiscoveryResultMarkdown };

package/dist/src/work-discovery/service.d.ts

@@ -1,7 +1,11 @@
 import type { Config } from '../config/schema.js';
 import type { ProjectService } from '../projects/project-service.js';
 import type { SessionIndex } from '../session/manager.js';
+import type { UnderstandingSourceItem } from '../user-context/sources/types.js';
 import type { WorkDiscoveryCandidate, WorkDiscoveryOnboardingState, WorkDiscoveryRecognitionDecision, WorkDiscoveryRun, WorkDiscoverySource } from './types.js';
+export type ModelProcessingPolicy = 'local_only' | 'remote_allowed';
+/** Sanitize and round-robin local sources so one verbose source cannot starve the rest. */
+export declare function normalizeUnderstandingSourceItems(rawItems: unknown[]): UnderstandingSourceItem[];
 export interface WorkDiscoveryServiceOptions {
     projects: ProjectService;
     sessions: SessionIndex;
@@ -24,7 +28,11 @@ export declare class WorkDiscoveryService {
     };
     discoverCandidates(signal?: AbortSignal): Promise<WorkDiscoveryCandidate[]>;
     listDirectorySources(): import("./types.js").WorkDiscoveryDirectorySource[];
-    grantDirectorySource(rootPath: string): Promise<import("./types.js").WorkDiscoveryDirectorySource>;
+    getModelProcessingTarget(): {
+        provider: string;
+        remoteModel: boolean;
+    };
+    grantDirectorySource(rootPath: string, processingPolicy: ModelProcessingPolicy): Promise<import("./types.js").WorkDiscoveryDirectorySource>;
     checkDirectorySources(): Promise<any[]>;
     refreshDirectorySourceIfChanged(input: {
         id: string;
@@ -46,7 +54,7 @@ export declare class WorkDiscoveryService {
         reused?: undefined;
     }>;
     revokeDirectorySource(id: string): import("./types.js").WorkDiscoveryDirectorySource;
-    importUnderstandingSources(rawItems: unknown[], signal?: AbortSignal, runId?: string, rawCheckpoints?: Record<string, unknown>): Promise<{
+    importUnderstandingSources(rawItems: unknown[], processingPolicy: ModelProcessingPolicy, signal?: AbortSignal, runId?: string, rawCheckpoints?: Record<string, unknown>): Promise<{
         profileCandidates: any[];
         workThreads: any[];
         focuses: any[];
@@ -59,7 +67,7 @@ export declare class WorkDiscoveryService {
             status: "rejected" | "pending";
             understandingId: string;
             id: string;
-            category: "role" | "focus" | "technology" | "workflow" | "preference";
+            category: "role" | "responsibility" | "preference" | "routine";
             statement: string;
             confidence: "high" | "medium" | "low";
             evidence: string[];
@@ -86,6 +94,7 @@ export declare class WorkDiscoveryService {
     }): Promise<WorkDiscoveryRun>;
     startQuickRun(input: {
         idempotencyKey: string;
+        processingPolicy: ModelProcessingPolicy;
     }): Promise<WorkDiscoveryRun>;
     startRun(input: {
         rootPath: string;