@xopcai/xopc 0.0.171 → 0.0.172

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

@@ -4,7 +4,7 @@ import { finishKnowledgeSyncRun, getKnowledgeSourceCursor, listKnowledgeSourceIt
 //#region src/knowledge/ingestion-service.ts
 init_logger();
 const log = createLogger("KnowledgeIngestion");
-function deletionInputs(instanceId, snapshotExternalIds) {
+function deletionInputs(instanceId, collectionScope, snapshotExternalIds) {
 	if (!snapshotExternalIds) return [];
 	const seen = new Set(snapshotExternalIds);
 	const deletedAt = (/* @__PURE__ */ new Date()).toISOString();
@@ -12,6 +12,7 @@ function deletionInputs(instanceId, snapshotExternalIds) {
 	for (let offset = 0;; offset += 500) {
 		const page = listKnowledgeSourceItems({
 			sourceInstanceId: instanceId,
+			collectionScope,
 			limit: 500,
 			offset
 		});
@@ -20,6 +21,7 @@ function deletionInputs(instanceId, snapshotExternalIds) {
 			missing.push({
 				id: item.id,
 				sourceInstanceId: item.sourceInstanceId,
+				collectionScope: item.collectionScope,
 				externalId: item.externalId,
 				itemType: item.itemType,
 				authorRole: item.authorRole,
@@ -40,11 +42,11 @@ function deletionInputs(instanceId, snapshotExternalIds) {
 	return missing;
 }
 var SqliteKnowledgeSourceStateStore = class {
-	getCursor(instanceId) {
-		return getKnowledgeSourceCursor(instanceId);
+	getCursor(instanceId, collectionScope) {
+		return getKnowledgeSourceCursor(instanceId, collectionScope);
 	}
-	setCursor(instanceId, cursor) {
-		setKnowledgeSourceCursor(instanceId, cursor);
+	setCursor(instanceId, collectionScope, cursor) {
+		setKnowledgeSourceCursor(instanceId, collectionScope, cursor);
 	}
 };
 var KnowledgeIngestionService = class {
@@ -53,14 +55,14 @@ var KnowledgeIngestionService = class {
 		this.state = state;
 	}
 	ingest(params) {
-		const cursorBefore = this.state.getCursor(params.instanceId);
+		const cursorBefore = this.state.getCursor(params.instanceId, params.collectionScope);
 		const run = startKnowledgeSyncRun({
 			sourceInstanceId: params.instanceId,
 			cursorBefore
 		});
 		try {
 			const stored = upsertKnowledgeSourceItems(params.items);
-			this.state.setCursor(params.instanceId, params.cursorAfter);
+			this.state.setCursor(params.instanceId, params.collectionScope, params.cursorAfter);
 			return finishKnowledgeSyncRun({
 				runId: run.id,
 				status: params.warnings?.length ? "partial" : "succeeded",
@@ -83,7 +85,7 @@ var KnowledgeIngestionService = class {
 	async sync(params) {
 		const adapter = this.adapters.get(params.adapterKind);
 		if (!adapter) throw new Error(`Knowledge source adapter not found: ${params.adapterKind}`);
-		const cursorBefore = this.state.getCursor(params.instanceId);
+		const cursorBefore = this.state.getCursor(params.instanceId, params.collectionScope);
 		const run = startKnowledgeSyncRun({
 			sourceInstanceId: params.instanceId,
 			cursorBefore
@@ -93,13 +95,14 @@ var KnowledgeIngestionService = class {
 		try {
 			const pulled = await adapter.pull({
 				instanceId: params.instanceId,
+				collectionScope: params.collectionScope,
 				cursor: cursorBefore,
 				windowStart: params.windowStart,
 				signal
 			});
-			const tombstones = deletionInputs(params.instanceId, pulled.snapshotExternalIds);
+			const tombstones = deletionInputs(params.instanceId, params.collectionScope, pulled.snapshotExternalIds);
 			const stored = upsertKnowledgeSourceItems([...pulled.items, ...tombstones]);
-			this.state.setCursor(params.instanceId, pulled.nextCursor);
+			this.state.setCursor(params.instanceId, params.collectionScope, pulled.nextCursor);
 			const completed = finishKnowledgeSyncRun({
 				runId: run.id,
 				status: pulled.warnings.length > 0 ? "partial" : "succeeded",

package/dist/src/knowledge/local-folder-adapter.js

@@ -59,6 +59,7 @@ var LocalFolderKnowledgeSourceAdapter = class {
 			const externalId = relative(root, canonicalPath).split(sep).join("/");
 			items.push({
 				sourceInstanceId: input.instanceId,
+				collectionScope: "files",
 				externalId,
 				itemType: "local_file",
 				authorRole: "user",

package/dist/src/knowledge/people-graph.js

@@ -1,125 +1,58 @@
-import { listKnowledgeSourceItems } from "../storage/sqlite/knowledge-repository.js";
-import { createHash } from "node:crypto";
+import { listUserPeopleGraphRows } from "../storage/sqlite/user-claims-repository.js";
+import "../storage/sqlite/index.js";
 //#region src/knowledge/people-graph.ts
-function nonEmpty(value) {
-	return typeof value === "string" && value.trim() ? value.trim() : void 0;
-}
-function signalsFor(item) {
-	const structured = item.metadata.personEntities;
-	if (Array.isArray(structured)) {
-		const signals = structured.flatMap((value) => {
-			if (!value || typeof value !== "object" || Array.isArray(value)) return [];
-			const record = value;
-			const signal = {
-				role: nonEmpty(record.role),
-				name: nonEmpty(record.name),
-				email: nonEmpty(record.email),
-				username: nonEmpty(record.username)
-			};
-			return signal.name || signal.email || signal.username ? [signal] : [];
-		});
-		if (signals.length > 0) return signals;
-	}
-	return Array.isArray(item.metadata.people) ? item.metadata.people.flatMap((value) => {
-		const text = nonEmpty(value);
-		if (!text) return [];
-		return text.includes("@") ? [{ email: text }] : [{ name: text }];
-	}) : [];
-}
-function identityFor(signal) {
-	if (signal.email) return `email:${signal.email.toLowerCase()}`;
-	if (signal.username) return `username:${signal.username.toLowerCase().replace(/^@/, "")}`;
-	if (signal.name) return `name:${signal.name.toLocaleLowerCase()}`;
-}
-function personId(identity) {
-	return `person_${createHash("sha256").update(identity).digest("hex").slice(0, 24)}`;
-}
-function latest(left, right) {
-	return Date.parse(left) >= Date.parse(right) ? left : right;
+function sourceMetadata(sourceInstanceId) {
+	const parts = sourceInstanceId.split(":");
+	if (parts[0] !== "composio" || !parts[1]) return {};
+	return {
+		connectorId: parts[1],
+		toolkit: parts[1].replace(/^composio-/, "")
+	};
 }
 function buildConnectedPeopleGraph(options = {}) {
-	const maxItems = 5e3;
-	const items = [];
-	for (let offset = 0; offset < maxItems; offset += 500) {
-		const page = listKnowledgeSourceItems({
-			limit: 500,
-			offset
-		});
-		items.push(...page);
-		if (page.length < 500) break;
-	}
-	const nodeByIdentity = /* @__PURE__ */ new Map();
-	const edgeByKey = /* @__PURE__ */ new Map();
-	for (const item of items) {
-		const observedAt = item.occurredAt ?? item.sourceUpdatedAt ?? item.updatedAt;
-		const observedIdentities = /* @__PURE__ */ new Set();
-		for (const signal of signalsFor(item)) {
-			const identity = identityFor(signal);
-			if (!identity) continue;
-			let aggregate = nodeByIdentity.get(identity);
-			if (!aggregate) {
-				aggregate = {
-					node: {
-						id: personId(identity),
-						label: signal.name ?? signal.email ?? signal.username ?? identity,
-						names: [],
-						emails: [],
-						usernames: [],
-						roles: [],
-						mentionCount: 0,
-						lastObservedAt: observedAt
-					},
-					names: /* @__PURE__ */ new Set(),
-					emails: /* @__PURE__ */ new Set(),
-					usernames: /* @__PURE__ */ new Set(),
-					roles: /* @__PURE__ */ new Set()
-				};
-				nodeByIdentity.set(identity, aggregate);
-			}
-			if (signal.name) aggregate.names.add(signal.name);
-			if (signal.email) aggregate.emails.add(signal.email.toLowerCase());
-			if (signal.username) aggregate.usernames.add(signal.username.replace(/^@/, ""));
-			if (signal.role) aggregate.roles.add(signal.role);
-			if (observedIdentities.has(identity)) continue;
-			observedIdentities.add(identity);
-			aggregate.node.mentionCount += 1;
-			aggregate.node.lastObservedAt = latest(aggregate.node.lastObservedAt, observedAt);
-			const edgeKey = `${aggregate.node.id}\u0000${item.sourceInstanceId}`;
-			const existingEdge = edgeByKey.get(edgeKey);
-			if (existingEdge) {
-				existingEdge.mentionCount += 1;
-				existingEdge.lastObservedAt = latest(existingEdge.lastObservedAt, observedAt);
-			} else edgeByKey.set(edgeKey, {
-				personId: aggregate.node.id,
-				sourceInstanceId: item.sourceInstanceId,
-				connectorId: nonEmpty(item.metadata.connectorId),
-				toolkit: nonEmpty(item.metadata.toolkit),
-				mentionCount: 1,
-				lastObservedAt: observedAt
-			});
-		}
+	const graph = listUserPeopleGraphRows();
+	const edgesByPerson = /* @__PURE__ */ new Map();
+	for (const edge of graph.edges) {
+		const values = edgesByPerson.get(edge.entityId) ?? [];
+		values.push(edge);
+		edgesByPerson.set(edge.entityId, values);
 	}
-	const query = options.query?.trim().toLocaleLowerCase() ?? "";
+	const query = options.query?.trim().toLowerCase() ?? "";
 	const limit = Math.max(1, Math.min(options.limit ?? 100, 500));
-	const matchingPeople = [...nodeByIdentity.values()].map((aggregate) => ({
-		...aggregate.node,
-		names: [...aggregate.names].toSorted(),
-		emails: [...aggregate.emails].toSorted(),
-		usernames: [...aggregate.usernames].toSorted(),
-		roles: [...aggregate.roles].toSorted()
-	})).filter((person) => !query || [
+	const matching = graph.people.map((entity) => {
+		const edges = edgesByPerson.get(entity.id) ?? [];
+		const names = [...entity.canonicalLabel.includes("@") ? [] : [entity.canonicalLabel], ...entity.handles.filter((handle) => handle.type === "display_name").map((handle) => handle.value)].filter((value, index, values) => values.findIndex((candidate) => candidate.toLowerCase() === value.toLowerCase()) === index).toSorted();
+		const emails = entity.handles.filter((handle) => handle.type === "email").map((handle) => handle.value).toSorted();
+		const usernames = entity.handles.filter((handle) => handle.type === "provider_user").map((handle) => handle.value).toSorted();
+		return {
+			id: entity.id,
+			label: entity.canonicalLabel,
+			names,
+			emails,
+			usernames,
+			roles: [],
+			mentionCount: edges.reduce((sum, edge) => sum + edge.mentionCount, 0),
+			lastObservedAt: edges.reduce((latest, edge) => !latest || edge.lastObservedAt > latest ? edge.lastObservedAt : latest, "") || entity.updatedAt
+		};
+	}).filter((person) => !query || [
 		person.label,
 		...person.names,
 		...person.emails,
 		...person.usernames
-	].some((value) => value.toLocaleLowerCase().includes(query))).toSorted((left, right) => right.mentionCount - left.mentionCount || right.lastObservedAt.localeCompare(left.lastObservedAt));
-	const people = matchingPeople.slice(0, limit);
+	].some((value) => value.toLowerCase().includes(query))).toSorted((left, right) => right.mentionCount - left.mentionCount || right.lastObservedAt.localeCompare(left.lastObservedAt));
+	const people = matching.slice(0, limit);
 	const included = new Set(people.map((person) => person.id));
 	return {
 		people,
-		sourceEdges: [...edgeByKey.values()].filter((edge) => included.has(edge.personId)),
-		scannedItems: items.length,
-		truncated: items.length >= maxItems || matchingPeople.length > limit
+		sourceEdges: graph.edges.filter((edge) => included.has(edge.entityId)).map((edge) => ({
+			personId: edge.entityId,
+			sourceInstanceId: edge.sourceInstanceId,
+			...sourceMetadata(edge.sourceInstanceId),
+			mentionCount: edge.mentionCount,
+			lastObservedAt: edge.lastObservedAt
+		})),
+		scannedItems: graph.evidenceCount,
+		truncated: matching.length > limit
 	};
 }
 //#endregion

package/dist/src/knowledge/types.d.ts

@@ -8,6 +8,7 @@ export type KnowledgeChangeKind = 'added' | 'modified' | 'deleted';
 export interface KnowledgeSourceItem {
     id: string;
     sourceInstanceId: string;
+    collectionScope: string;
     externalId: string;
     itemType: string;
     authorRole?: KnowledgeAuthorRole;
@@ -42,6 +43,7 @@ export interface KnowledgeSourceChange {
 export interface KnowledgeSourceItemInput {
     id?: string;
     sourceInstanceId: string;
+    collectionScope: string;
     externalId: string;
     itemType: string;
     authorRole?: KnowledgeAuthorRole;
@@ -73,6 +75,7 @@ export interface KnowledgeSyncRun {
 }
 export interface KnowledgePullInput {
     instanceId: string;
+    collectionScope: string;
     cursor?: string;
     windowStart?: string;
     signal: AbortSignal;

package/dist/src/providers/xopc-cloud-account-service.d.ts

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+import { type CredentialResolver } from '../auth/credentials.js';
+declare const accountSummarySchema: z.ZodObject<{
+    balance: z.ZodObject<{
+        credits: z.ZodNumber;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>;
+    usage: z.ZodObject<{
+        days: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<7>, z.ZodLiteral<30>]>;
+        requests: z.ZodNumber;
+        inputTokens: z.ZodNumber;
+        outputTokens: z.ZodNumber;
+        totalTokens: z.ZodNumber;
+        errors: z.ZodNumber;
+        averageLatencyMs: z.ZodNumber;
+        chargedCredits: z.ZodNumber;
+    }, z.core.$strip>;
+    links: z.ZodObject<{
+        details: z.ZodString;
+        purchase: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type XopcCloudAccountSummary = z.infer<typeof accountSummarySchema>;
+export declare class XopcCloudAccountError extends Error {
+    readonly status: number;
+    readonly code?: string;
+    constructor(message: string, status: number, code?: string);
+}
+export declare class XopcCloudAccountService {
+    private readonly fetchImpl;
+    private readonly routerUrl;
+    private readonly credentials;
+    constructor(options?: {
+        fetchImpl?: typeof fetch;
+        routerUrl?: string;
+        credentials?: Pick<CredentialResolver, 'resolveApiKey'>;
+    });
+    getSummary(days?: 1 | 7 | 30): Promise<XopcCloudAccountSummary | null>;
+}
+export {};

package/dist/src/providers/xopc-cloud-account-service.js

@@ -0,0 +1,65 @@
+import { getCredentialResolver, init_credentials } from "../auth/credentials.js";
+import { z } from "zod";
+//#region src/providers/xopc-cloud-account-service.ts
+init_credentials();
+const DEFAULT_ROUTER_URL = "https://router.xopc.ai/v1";
+const accountSummarySchema = z.object({
+	balance: z.object({
+		credits: z.number().int().nonnegative(),
+		updatedAt: z.string().datetime()
+	}),
+	usage: z.object({
+		days: z.union([
+			z.literal(1),
+			z.literal(7),
+			z.literal(30)
+		]),
+		requests: z.number().int().nonnegative(),
+		inputTokens: z.number().int().nonnegative(),
+		outputTokens: z.number().int().nonnegative(),
+		totalTokens: z.number().int().nonnegative(),
+		errors: z.number().int().nonnegative(),
+		averageLatencyMs: z.number().nonnegative(),
+		chargedCredits: z.number().int().nonnegative()
+	}),
+	links: z.object({
+		details: z.string().url(),
+		purchase: z.string().url()
+	})
+});
+var XopcCloudAccountError = class extends Error {
+	constructor(message, status, code) {
+		super(message);
+		this.status = status;
+		this.code = code;
+		this.name = "XopcCloudAccountError";
+	}
+};
+var XopcCloudAccountService = class {
+	fetchImpl;
+	routerUrl;
+	credentials;
+	constructor(options = {}) {
+		this.fetchImpl = options.fetchImpl ?? fetch;
+		this.routerUrl = (options.routerUrl ?? process.env.XOPC_MODEL_ROUTER_URL ?? DEFAULT_ROUTER_URL).replace(/\/+$/, "");
+		this.credentials = options.credentials ?? getCredentialResolver();
+	}
+	async getSummary(days = 7) {
+		const accessToken = await this.credentials.resolveApiKey("xopc-cloud");
+		if (!accessToken) return null;
+		const response = await this.fetchImpl(`${this.routerUrl}/account/summary?days=${days}`, {
+			headers: {
+				authorization: `Bearer ${accessToken}`,
+				accept: "application/json"
+			},
+			signal: AbortSignal.timeout(3e4)
+		});
+		const body = await response.json().catch(() => null);
+		if (!response.ok) throw new XopcCloudAccountError(typeof body?.error?.message === "string" ? body.error.message : `XOPC account summary failed (${response.status})`, response.status, typeof body?.error?.code === "string" ? body.error.code : void 0);
+		const parsed = accountSummarySchema.safeParse(body);
+		if (!parsed.success) throw new XopcCloudAccountError("XOPC account summary returned an invalid response", response.status, "invalid_response");
+		return parsed.data;
+	}
+};
+//#endregion
+export { XopcCloudAccountError, XopcCloudAccountService };

package/dist/src/storage/sqlite/connector-learning-repository.d.ts

@@ -0,0 +1,47 @@
+export type ConnectorLearningMode = 'bootstrap' | 'incremental';
+export type ConnectorLearningStatus = 'queued' | 'running' | 'completed' | 'failed' | 'paused';
+export type ConnectorLearningPhase = 'queued' | 'fetching' | 'indexing' | 'deriving' | 'completed';
+export type ConnectorLearningJob = {
+    id: string;
+    idempotencyKey: string;
+    connectorId: string;
+    connectionId: string;
+    sourceInstanceId: string;
+    agentId: string;
+    mode: ConnectorLearningMode;
+    status: ConnectorLearningStatus;
+    phase: ConnectorLearningPhase;
+    itemsDiscovered: number;
+    itemsIndexed: number;
+    candidatesCreated: number;
+    attemptCount: number;
+    error?: string;
+    nextRunAt?: string;
+    startedAt?: string;
+    finishedAt?: string;
+    createdAt: string;
+    updatedAt: string;
+};
+export declare function enqueueConnectorLearningJob(input: {
+    connectorId: string;
+    connectionId: string;
+    sourceInstanceId: string;
+    agentId: string;
+    mode: ConnectorLearningMode;
+    idempotencyKey: string;
+    nextRunAt?: number;
+    nowMs?: number;
+}): ConnectorLearningJob;
+export declare function claimNextConnectorLearningJob(nowMs?: number): ConnectorLearningJob | null;
+export declare function recoverStaleConnectorLearningJobs(staleBeforeMs: number, nowMs?: number): number;
+export declare function setConnectorLearningPaused(connectionId: string, paused: boolean, nowMs?: number): number;
+export declare function updateConnectorLearningJob(id: string, patch: Partial<Pick<ConnectorLearningJob, 'status' | 'phase' | 'itemsDiscovered' | 'itemsIndexed' | 'candidatesCreated' | 'error'>> & {
+    nextRunAt?: number | null;
+    finished?: boolean;
+    nowMs?: number;
+}): ConnectorLearningJob;
+export declare function listConnectorLearningJobs(options?: {
+    sourceInstanceId?: string;
+    connectionId?: string;
+    limit?: number;
+}): ConnectorLearningJob[];

package/dist/src/storage/sqlite/connector-learning-repository.js

@@ -0,0 +1,110 @@
+import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import { randomUUID } from "node:crypto";
+//#region src/storage/sqlite/connector-learning-repository.ts
+function iso(value) {
+	return value == null ? void 0 : new Date(value).toISOString();
+}
+function fromRow(row) {
+	return {
+		id: row.job_id,
+		idempotencyKey: row.idempotency_key,
+		connectorId: row.connector_id,
+		connectionId: row.connection_id,
+		sourceInstanceId: row.source_instance_id,
+		agentId: row.agent_id,
+		mode: row.mode,
+		status: row.status,
+		phase: row.phase,
+		itemsDiscovered: row.items_discovered,
+		itemsIndexed: row.items_indexed,
+		candidatesCreated: row.candidates_created,
+		attemptCount: row.attempt_count,
+		...row.error ? { error: row.error } : {},
+		...iso(row.next_run_at) ? { nextRunAt: iso(row.next_run_at) } : {},
+		...iso(row.started_at) ? { startedAt: iso(row.started_at) } : {},
+		...iso(row.finished_at) ? { finishedAt: iso(row.finished_at) } : {},
+		createdAt: new Date(row.created_at).toISOString(),
+		updatedAt: new Date(row.updated_at).toISOString()
+	};
+}
+function enqueueConnectorLearningJob(input) {
+	const now = input.nowMs ?? Date.now();
+	runSqliteWriteTransaction((db) => {
+		db.prepare(`INSERT INTO connector_learning_jobs (
+        job_id, idempotency_key, connector_id, connection_id, source_instance_id,
+        agent_id, mode, status, phase, next_run_at, created_at, updated_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, 'queued', 'queued', ?, ?, ?)
+      ON CONFLICT(idempotency_key) DO NOTHING`).run(randomUUID(), input.idempotencyKey, input.connectorId, input.connectionId, input.sourceInstanceId, input.agentId, input.mode, input.nextRunAt ?? now, now, now);
+	});
+	return fromRow(getSqliteDatabase().prepare("SELECT * FROM connector_learning_jobs WHERE idempotency_key = ?").get(input.idempotencyKey));
+}
+function claimNextConnectorLearningJob(nowMs = Date.now()) {
+	return runSqliteWriteTransaction((db) => {
+		const row = db.prepare(`SELECT * FROM connector_learning_jobs
+       WHERE status IN ('queued', 'failed') AND attempt_count < 5 AND COALESCE(next_run_at, 0) <= ?
+       ORDER BY next_run_at ASC, created_at ASC LIMIT 1`).get(nowMs);
+		if (!row) return null;
+		if (db.prepare(`UPDATE connector_learning_jobs SET
+        status = 'running', phase = 'fetching', attempt_count = attempt_count + 1,
+        error = NULL, started_at = COALESCE(started_at, ?), updated_at = ?
+       WHERE job_id = ? AND status IN ('queued', 'failed')`).run(nowMs, nowMs, row.job_id).changes !== 1) return null;
+		return fromRow(db.prepare("SELECT * FROM connector_learning_jobs WHERE job_id = ?").get(row.job_id));
+	});
+}
+function recoverStaleConnectorLearningJobs(staleBeforeMs, nowMs = Date.now()) {
+	return runSqliteWriteTransaction((db) => Number(db.prepare(`UPDATE connector_learning_jobs SET
+      status = CASE WHEN attempt_count >= 5 THEN 'paused' ELSE 'failed' END,
+      error = 'Interrupted while learning; queued for recovery.',
+      next_run_at = CASE WHEN attempt_count >= 5 THEN NULL ELSE ? END,
+      finished_at = ?, updated_at = ?
+     WHERE status = 'running' AND updated_at < ?`).run(nowMs, nowMs, nowMs, staleBeforeMs).changes));
+}
+function setConnectorLearningPaused(connectionId, paused, nowMs = Date.now()) {
+	return runSqliteWriteTransaction((db) => Number(db.prepare(paused ? `UPDATE connector_learning_jobs SET status = 'paused', next_run_at = NULL, updated_at = ?
+         WHERE connection_id = ? AND status IN ('queued', 'failed', 'running')` : `UPDATE connector_learning_jobs SET status = 'queued', next_run_at = ?, updated_at = ?
+         WHERE connection_id = ? AND status = 'paused'`).run(...paused ? [nowMs, connectionId] : [
+		nowMs,
+		nowMs,
+		connectionId
+	]).changes));
+}
+function updateConnectorLearningJob(id, patch) {
+	const now = patch.nowMs ?? Date.now();
+	const fields = ["updated_at = ?"];
+	const values = [now];
+	const add = (column, value) => {
+		if (value === void 0) return;
+		fields.push(`${column} = ?`);
+		values.push(value);
+	};
+	add("status", patch.status);
+	add("phase", patch.phase);
+	add("items_discovered", patch.itemsDiscovered);
+	add("items_indexed", patch.itemsIndexed);
+	add("candidates_created", patch.candidatesCreated);
+	add("error", patch.error);
+	add("next_run_at", patch.nextRunAt);
+	if (patch.finished) add("finished_at", now);
+	values.push(id);
+	getSqliteDatabase().prepare(`UPDATE connector_learning_jobs SET ${fields.join(", ")} WHERE job_id = ?`).run(...values);
+	const row = getSqliteDatabase().prepare("SELECT * FROM connector_learning_jobs WHERE job_id = ?").get(id);
+	if (!row) throw new Error(`Connector learning job not found: ${id}`);
+	return fromRow(row);
+}
+function listConnectorLearningJobs(options = {}) {
+	const clauses = [];
+	const values = [];
+	if (options.sourceInstanceId) {
+		clauses.push("source_instance_id = ?");
+		values.push(options.sourceInstanceId);
+	}
+	if (options.connectionId) {
+		clauses.push("connection_id = ?");
+		values.push(options.connectionId);
+	}
+	const limit = Math.max(1, Math.min(options.limit ?? 100, 500));
+	return getSqliteDatabase().prepare(`SELECT * FROM connector_learning_jobs ${clauses.length ? `WHERE ${clauses.join(" AND ")}` : ""}
+     ORDER BY created_at DESC LIMIT ?`).all(...values, limit).map(fromRow);
+}
+//#endregion
+export { claimNextConnectorLearningJob, enqueueConnectorLearningJob, listConnectorLearningJobs, recoverStaleConnectorLearningJobs, setConnectorLearningPaused, updateConnectorLearningJob };

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

@@ -5,6 +5,8 @@ export { DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, } from './m
 export { discoverSqlMigrations, listRegisteredMigrationTargets } from './migrations/discover.js';
 export { closeXopcDatabase, getXopcDatabase, isXopcDatabaseOpen, openXopcDatabase, requireXopcDatabase, resetXopcDatabaseSingletonForTest, type OpenXopcDatabaseOptions, type XopcDatabase, } from './connection.js';
 export { getSqliteDatabase, runSqliteWriteTransaction } from './transaction.js';
+export { getUserClaim, linkUserClaimMemoryRecord, listUserClaimEvidence, listUserClaimStatsBySource, listUserClaims, listUserPeopleGraphRows, removeUserClaimEvidenceForSource, reinforceUserClaim, resolveUserEntity, setUserClaimDecision, type UserClaim, type UserClaimClass, type UserClaimState, type UserEntity, } from './user-claims-repository.js';
+export { claimNextConnectorLearningJob, enqueueConnectorLearningJob, listConnectorLearningJobs, recoverStaleConnectorLearningJobs, setConnectorLearningPaused, updateConnectorLearningJob, type ConnectorLearningJob, type ConnectorLearningMode, type ConnectorLearningPhase, type ConnectorLearningStatus, } from './connector-learning-repository.js';
 export { appendComposerInputHistory, clearComposerInputHistory, listComposerInputHistory, COMPOSER_INPUT_HISTORY_LIMIT, type ComposerInputHistoryItem, } from './composer-input-history-repository.js';
 export { getInteractionState, setInteractionState, updateInteractionStateFromMessage, type InteractionState, } from './interaction-state-repository.js';
 export { buildRelationshipPrompt, getRelationshipSettings, isProactiveSupportAllowed, updateRelationshipSettings, type RelationshipSettings, type SupportMode, } from './relationship-settings-repository.js';
@@ -17,7 +19,7 @@ export { deleteNoteRecord, getNoteRecord, listNoteRecords, upsertNoteRecord, } f
 export { deleteNoteAgentContextRecord, getNoteAgentContextRecord, upsertNoteAgentContextRecord, type NoteAgentContextRecord, } from './note-agent-context-repository.js';
 export { searchMemoryIndex, syncMemoryIndex, type MemorySearchHit, } from './memory-index-repository.js';
 export { appendMemorySignal, appendMemoryTraceEvent, deleteMemoryRecord, findLatestMemoryInjectTrace, getMemoryProviderState, getMemoryRecord, hasUnresolvedMemoryConflict, listMemorySignals, listMemoryTraceEvents, listMemoryRecords, markMemoryRecordsConflicted, searchMemoryRecords, setMemoryProviderState, setMemoryTraceFeedback, setLatestMemoryInjectFeedback, summarizeMemoryRecallFeedback, summarizeUserUnderstandingQuality, USER_UNDERSTANDING_REMEDIATION_POLICY, upsertMemoryRecord, type AppendMemorySignalInput, type AppendMemoryTraceEventInput, type FindLatestMemoryInjectTraceInput, type ListMemoryRecordsOptions, type MemoryRecallFeedbackSummary, type MemoryFeedbackRemediationResult, type MemorySignalRowPayload, type MemoryTraceFeedback, type MemoryTraceEventPayload, type UserUnderstandingQualityMetrics, type SearchMemoryRecordsOptions, type SetMemoryTraceFeedbackInput, type SetLatestMemoryInjectFeedbackInput, type UpsertMemoryRecordInput, } from './memory-records-repository.js';
-export { attachMemoryEvidence, claimKnowledgeSourceItems, completeKnowledgeSourceItemSynthesis, deleteMemoryEvidenceForRecord, finishKnowledgeSyncRun, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, listKnowledgeSourceItems, listKnowledgeSourceChanges, listKnowledgeSyncRuns, listMemoryEvidence, setKnowledgeSourceItemSynthesisStatus, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, startKnowledgeSyncRun, upsertKnowledgeSourceItems, } from './knowledge-repository.js';
+export { attachMemoryEvidence, claimKnowledgeSourceItems, completeKnowledgeSourceItemSynthesis, deleteMemoryEvidenceForRecord, finishKnowledgeSyncRun, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, listKnowledgeSourceItems, listKnowledgeSourceChanges, listKnowledgeSyncRuns, listMemoryEvidence, pruneBoundedKnowledgeSourceItems, setKnowledgeSourceItemSynthesisStatus, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, startKnowledgeSyncRun, upsertKnowledgeSourceItems, } from './knowledge-repository.js';
 export { deleteSessionConfig, getSessionConfig, hasSessionConfig, setSessionConfig, updateSessionConfig, } from './config-repository.js';
 export { createObjectLinkRecord, getActivityEventRecord, listActivityRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, recordActivityEvent, } from './activity-repository.js';
 export { appendConnectorExecutionAudit, claimConnectorWebhookDelivery, completeConnectorWebhookDelivery, consumeConnectorApproval, createConnectorApproval, decideConnectorApproval, deleteConnectorConnection, deleteConnectorInstallation, getConnectorConnection, getConnectorApproval, getConnectorInstallation, getCachedConnectorCatalogEntry, listCachedConnectorCatalogEntries, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, type CachedConnectorCatalogEntry, } from './connector-repository.js';

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

@@ -6,6 +6,8 @@ import { XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_SCHEMA_VERSION, applyPendingMi
 import { ensureXopcDatabaseSchema } from "./schema.js";
 import { closeXopcDatabase, getXopcDatabase, isXopcDatabaseOpen, openXopcDatabase, requireXopcDatabase, resetXopcDatabaseSingletonForTest } from "./connection.js";
 import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import { getUserClaim, linkUserClaimMemoryRecord, listUserClaimEvidence, listUserClaimStatsBySource, listUserClaims, listUserPeopleGraphRows, reinforceUserClaim, removeUserClaimEvidenceForSource, resolveUserEntity, setUserClaimDecision } from "./user-claims-repository.js";
+import { claimNextConnectorLearningJob, enqueueConnectorLearningJob, listConnectorLearningJobs, recoverStaleConnectorLearningJobs, setConnectorLearningPaused, updateConnectorLearningJob } from "./connector-learning-repository.js";
 import { COMPOSER_INPUT_HISTORY_LIMIT, appendComposerInputHistory, clearComposerInputHistory, listComposerInputHistory } from "./composer-input-history-repository.js";
 import { getInteractionState, setInteractionState, updateInteractionStateFromMessage } from "./interaction-state-repository.js";
 import { buildRelationshipPrompt, getRelationshipSettings, isProactiveSupportAllowed, updateRelationshipSettings } from "./relationship-settings-repository.js";
@@ -18,11 +20,11 @@ import { deleteNoteRecord, getNoteRecord, listNoteRecords, upsertNoteRecord } fr
 import { deleteNoteAgentContextRecord, getNoteAgentContextRecord, upsertNoteAgentContextRecord } from "./note-agent-context-repository.js";
 import { searchMemoryIndex, syncMemoryIndex } from "./memory-index-repository.js";
 import { USER_UNDERSTANDING_REMEDIATION_POLICY, appendMemorySignal, appendMemoryTraceEvent, deleteMemoryRecord, findLatestMemoryInjectTrace, getMemoryProviderState, getMemoryRecord, hasUnresolvedMemoryConflict, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, markMemoryRecordsConflicted, searchMemoryRecords, setLatestMemoryInjectFeedback, setMemoryProviderState, setMemoryTraceFeedback, summarizeMemoryRecallFeedback, summarizeUserUnderstandingQuality, upsertMemoryRecord } from "./memory-records-repository.js";
-import { attachMemoryEvidence, claimKnowledgeSourceItems, completeKnowledgeSourceItemSynthesis, deleteMemoryEvidenceForRecord, finishKnowledgeSyncRun, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, startKnowledgeSyncRun, upsertKnowledgeSourceItems } from "./knowledge-repository.js";
+import { attachMemoryEvidence, claimKnowledgeSourceItems, completeKnowledgeSourceItemSynthesis, deleteMemoryEvidenceForRecord, finishKnowledgeSyncRun, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, pruneBoundedKnowledgeSourceItems, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, startKnowledgeSyncRun, upsertKnowledgeSourceItems } from "./knowledge-repository.js";
 import { deleteSessionConfig, getSessionConfig, hasSessionConfig, setSessionConfig, updateSessionConfig } from "./config-repository.js";
 import { createObjectLinkRecord, getActivityEventRecord, listActivityRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, recordActivityEvent } from "./activity-repository.js";
 import { appendConnectorExecutionAudit, claimConnectorWebhookDelivery, completeConnectorWebhookDelivery, consumeConnectorApproval, createConnectorApproval, decideConnectorApproval, deleteConnectorConnection, deleteConnectorInstallation, getCachedConnectorCatalogEntry, getConnectorApproval, getConnectorConnection, getConnectorInstallation, listCachedConnectorCatalogEntries, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation } from "./connector-repository.js";
 import { getUserTrustPolicy, setUserTrustPolicy } from "./user-trust-repository.js";
 import { consumeMemoryReferenceConsent, decideMemoryReferenceConsent, ensureMemoryReferenceConsentRequest, hasMemoryReferenceConsent, listMemoryReferenceConsents, revokeMemoryReferenceConsent } from "./memory-reference-consent-repository.js";
 import { getUserProfilePromptState, setUserProfilePromptState } from "./user-profile-setup-repository.js";
-export { COMPOSER_INPUT_HISTORY_LIMIT, DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, SCHEMA_META_SCHEMA_VERSION_KEY, USER_UNDERSTANDING_REMEDIATION_POLICY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, appendCompactionBoundary, appendComposerInputHistory, appendConnectorExecutionAudit, appendMemorySignal, appendMemoryTraceEvent, appendTranscriptEntry, applyPendingMigrations, attachMemoryEvidence, buildDefaultSessionMetadata, buildGlobalSessionStats, buildRelationshipPrompt, claimConnectorWebhookDelivery, claimKnowledgeSourceItems, classifyStoredRow, clearComposerInputHistory, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, completeTaskOutcome, consumeConnectorApproval, consumeMemoryReferenceConsent, createConnectorApproval, createObjectLinkRecord, decideConnectorApproval, decideMemoryReferenceConsent, deleteConnectorConnection, deleteConnectorInstallation, deleteMemoryEvidenceForRecord, deleteMemoryRecord, deleteNoteAgentContextRecord, deleteNoteRecord, deleteSessionConfig, deleteSessionRecord, discoverSqlMigrations, ensureMemoryReferenceConsentRequest, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findLatestMemoryInjectTrace, findSessionKeyBySessionId, findTaskOutcomeForAssistant, finishKnowledgeSyncRun, getActivityEventRecord, getCachedConnectorCatalogEntry, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getCurrentSessionId, getGlobalSessionStats, getInteractionState, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getMemoryProviderState, getMemoryRecord, getNoteAgentContextRecord, getNoteRecord, getRelationshipSettings, getSessionConfig, getSessionMetadata, getSessionPersistedLevels, getSqliteDatabase, getTaskOutcome, getUserProfilePromptState, getUserTrustPolicy, getXopcDatabase, hasMemoryReferenceConsent, hasSessionConfig, hasUnresolvedMemoryConflict, incrementSessionStatsOnAppend, inspectSchemaMigrationStatus, isProactiveSupportAllowed, isXopcDatabaseOpen, listActivityRecords, listCachedConnectorCatalogEntries, listCompactionBoundaries, listComposerInputHistory, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, listMemoryRecords, listMemoryReferenceConsents, listMemorySignals, listMemoryTraceEvents, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, listTaskOutcomes, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, markMemoryRecordsConflicted, metadataToSessionInsert, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, readSchemaVersion, readSchemaVersionForTest, recordActivityEvent, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, replaceTranscriptRows, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreBeforeCompactionBoundary, revokeMemoryReferenceConsent, runSqliteWriteTransaction, searchMemoryIndex, searchMemoryRecords, sessionConfigRowToConfig, sessionRowToMetadata, setInteractionState, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setLatestMemoryInjectFeedback, setMemoryProviderState, setMemoryTraceFeedback, setSessionConfig, setTaskOutcomeFeedback, setUserProfilePromptState, setUserTrustPolicy, startKnowledgeSyncRun, startTaskOutcome, summarizeMemoryRecallFeedback, summarizeTaskOutcomes, summarizeUserUnderstandingQuality, syncMemoryIndex, transcriptEntryRowToStoredRow, updateInteractionStateFromMessage, updateRelationshipSettings, updateSessionConfig, updateSessionStats, updateTaskOutcome, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertKnowledgeSourceItems, upsertMemoryRecord, upsertNoteAgentContextRecord, upsertNoteRecord };
+export { COMPOSER_INPUT_HISTORY_LIMIT, DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, SCHEMA_META_SCHEMA_VERSION_KEY, USER_UNDERSTANDING_REMEDIATION_POLICY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, appendCompactionBoundary, appendComposerInputHistory, appendConnectorExecutionAudit, appendMemorySignal, appendMemoryTraceEvent, appendTranscriptEntry, applyPendingMigrations, attachMemoryEvidence, buildDefaultSessionMetadata, buildGlobalSessionStats, buildRelationshipPrompt, claimConnectorWebhookDelivery, claimKnowledgeSourceItems, claimNextConnectorLearningJob, classifyStoredRow, clearComposerInputHistory, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, completeTaskOutcome, consumeConnectorApproval, consumeMemoryReferenceConsent, createConnectorApproval, createObjectLinkRecord, decideConnectorApproval, decideMemoryReferenceConsent, deleteConnectorConnection, deleteConnectorInstallation, deleteMemoryEvidenceForRecord, deleteMemoryRecord, deleteNoteAgentContextRecord, deleteNoteRecord, deleteSessionConfig, deleteSessionRecord, discoverSqlMigrations, enqueueConnectorLearningJob, ensureMemoryReferenceConsentRequest, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findLatestMemoryInjectTrace, findSessionKeyBySessionId, findTaskOutcomeForAssistant, finishKnowledgeSyncRun, getActivityEventRecord, getCachedConnectorCatalogEntry, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getCurrentSessionId, getGlobalSessionStats, getInteractionState, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getMemoryProviderState, getMemoryRecord, getNoteAgentContextRecord, getNoteRecord, getRelationshipSettings, getSessionConfig, getSessionMetadata, getSessionPersistedLevels, getSqliteDatabase, getTaskOutcome, getUserClaim, getUserProfilePromptState, getUserTrustPolicy, getXopcDatabase, hasMemoryReferenceConsent, hasSessionConfig, hasUnresolvedMemoryConflict, incrementSessionStatsOnAppend, inspectSchemaMigrationStatus, isProactiveSupportAllowed, isXopcDatabaseOpen, linkUserClaimMemoryRecord, listActivityRecords, listCachedConnectorCatalogEntries, listCompactionBoundaries, listComposerInputHistory, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listConnectorLearningJobs, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, listMemoryRecords, listMemoryReferenceConsents, listMemorySignals, listMemoryTraceEvents, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, listTaskOutcomes, listUserClaimEvidence, listUserClaimStatsBySource, listUserClaims, listUserPeopleGraphRows, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, markMemoryRecordsConflicted, metadataToSessionInsert, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, pruneBoundedKnowledgeSourceItems, readSchemaVersion, readSchemaVersionForTest, recordActivityEvent, recoverStaleConnectorLearningJobs, reinforceUserClaim, releaseConnectorWebhookDelivery, removeUserClaimEvidenceForSource, replaceConnectorCatalogEntries, replaceTranscriptRows, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveMigrationsDir, resolveSessionAgentId, resolveUserEntity, resolveXopcDatabasePath, restoreBeforeCompactionBoundary, revokeMemoryReferenceConsent, runSqliteWriteTransaction, searchMemoryIndex, searchMemoryRecords, sessionConfigRowToConfig, sessionRowToMetadata, setConnectorLearningPaused, setInteractionState, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setLatestMemoryInjectFeedback, setMemoryProviderState, setMemoryTraceFeedback, setSessionConfig, setTaskOutcomeFeedback, setUserClaimDecision, setUserProfilePromptState, setUserTrustPolicy, startKnowledgeSyncRun, startTaskOutcome, summarizeMemoryRecallFeedback, summarizeTaskOutcomes, summarizeUserUnderstandingQuality, syncMemoryIndex, transcriptEntryRowToStoredRow, updateConnectorLearningJob, updateInteractionStateFromMessage, updateRelationshipSettings, updateSessionConfig, updateSessionStats, updateTaskOutcome, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertKnowledgeSourceItems, upsertMemoryRecord, upsertNoteAgentContextRecord, upsertNoteRecord };

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

@@ -21,8 +21,8 @@ export declare function listKnowledgeSyncRuns(options?: {
     status?: KnowledgeSyncRunStatus;
     limit?: number;
 }): KnowledgeSyncRun[];
-export declare function getKnowledgeSourceCursor(sourceInstanceId: string): string | undefined;
-export declare function setKnowledgeSourceCursor(sourceInstanceId: string, cursor: string | undefined): void;
+export declare function getKnowledgeSourceCursor(sourceInstanceId: string, collectionScope: string): string | undefined;
+export declare function setKnowledgeSourceCursor(sourceInstanceId: string, collectionScope: string, cursor: string | undefined): void;
 export declare function upsertKnowledgeSourceItems(inputs: KnowledgeSourceItemInput[], nowMs?: number): {
     items: KnowledgeSourceItem[];
     created: number;
@@ -39,12 +39,14 @@ export declare function getKnowledgeConsumerWatermark(consumerId: string, source
 export declare function setKnowledgeConsumerWatermark(consumerId: string, sourceInstanceId: string, sequence: number, nowMs?: number): void;
 export declare function listKnowledgeSourceItems(options?: {
     sourceInstanceId?: string;
+    collectionScope?: string;
     itemType?: string;
     synthesisStatus?: KnowledgeSynthesisStatus;
     includeDeleted?: boolean;
     limit?: number;
     offset?: number;
 }): KnowledgeSourceItem[];
+export declare function pruneBoundedKnowledgeSourceItems(sourceInstanceId: string, olderThanMs: number): number;
 export declare function setKnowledgeSourceItemSynthesisStatus(itemIds: string[], status: KnowledgeSynthesisStatus, nowMs?: number): number;
 export declare function claimKnowledgeSourceItems(options: {
     workerId: string;