@xopcai/xopc 0.0.156 → 0.0.158

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

@@ -0,0 +1,126 @@
+import { listKnowledgeSourceItems } from "../storage/sqlite/knowledge-repository.js";
+import { createHash } from "node:crypto";
+//#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 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 query = options.query?.trim().toLocaleLowerCase() ?? "";
+	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 || [
+		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);
+	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
+	};
+}
+//#endregion
+export { buildConnectedPeopleGraph };

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

@@ -81,6 +81,8 @@ export interface KnowledgePullResult {
     items: KnowledgeSourceItemInput[];
     nextCursor?: string;
     warnings: string[];
+    /** All active external ids observed during a complete source snapshot. Omit for partial/incremental-only pulls. */
+    snapshotExternalIds?: string[];
 }
 export interface KnowledgeSourceAdapter {
     readonly kind: string;

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

@@ -17,6 +17,7 @@ export declare function listConnectorApprovals(options?: {
 export declare function decideConnectorApproval(id: string, decision: 'approved' | 'denied', now?: Date): ConnectorApprovalRecord | undefined;
 export declare function consumeConnectorApproval(id: string, argumentsHash: string, now?: Date): ConnectorApprovalRecord | undefined;
 export declare function upsertConnectorCatalogEntry(input: CachedConnectorCatalogEntry): CachedConnectorCatalogEntry;
+export declare function replaceConnectorCatalogEntries(provider: string, entries: CachedConnectorCatalogEntry[]): CachedConnectorCatalogEntry[];
 export declare function getCachedConnectorCatalogEntry(connectorId: string): CachedConnectorCatalogEntry | undefined;
 export declare function listCachedConnectorCatalogEntries(provider?: string): CachedConnectorCatalogEntry[];
 export declare function upsertConnectorInstallation(input: Omit<ConnectorInstallationPolicy, 'createdAt' | 'updatedAt'> & Partial<Pick<ConnectorInstallationPolicy, 'createdAt' | 'updatedAt'>>): ConnectorInstallationPolicy;

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

@@ -194,6 +194,17 @@ function upsertConnectorCatalogEntry(input) {
 	});
 	return input;
 }
+function replaceConnectorCatalogEntries(provider, entries) {
+	runSqliteWriteTransaction((db) => {
+		db.prepare("DELETE FROM connector_catalog_entries WHERE provider = ?").run(provider);
+		const insert = db.prepare(`
+      INSERT INTO connector_catalog_entries (connector_id, provider, definition_json, fetched_at, expires_at)
+      VALUES (?, ?, ?, ?, ?)
+    `);
+		for (const entry of entries) insert.run(entry.connectorId, provider, JSON.stringify(entry.definition), entry.fetchedAt, entry.expiresAt ?? null);
+	});
+	return entries;
+}
 function getCachedConnectorCatalogEntry(connectorId) {
 	const row = getSqliteDatabase().prepare("SELECT * FROM connector_catalog_entries WHERE connector_id = ?").get(connectorId);
 	return row ? catalogFromRow(row) : void 0;
@@ -380,4 +391,4 @@ function releaseConnectorWebhookDelivery(id, error) {
 	});
 }
 //#endregion
-export { appendConnectorExecutionAudit, claimConnectorWebhookDelivery, completeConnectorWebhookDelivery, consumeConnectorApproval, createConnectorApproval, decideConnectorApproval, deleteConnectorConnection, deleteConnectorInstallation, getCachedConnectorCatalogEntry, getConnectorApproval, getConnectorConnection, getConnectorInstallation, listCachedConnectorCatalogEntries, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, releaseConnectorWebhookDelivery, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation };
+export { appendConnectorExecutionAudit, claimConnectorWebhookDelivery, completeConnectorWebhookDelivery, consumeConnectorApproval, createConnectorApproval, decideConnectorApproval, deleteConnectorConnection, deleteConnectorInstallation, getCachedConnectorCatalogEntry, getConnectorApproval, getConnectorConnection, getConnectorInstallation, listCachedConnectorCatalogEntries, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation };

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

@@ -16,7 +16,7 @@ export { appendMemorySignal, appendMemoryTraceEvent, deleteMemoryRecord, findLat
 export { attachMemoryEvidence, claimKnowledgeSourceItems, completeKnowledgeSourceItemSynthesis, deleteMemoryEvidenceForRecord, finishKnowledgeSyncRun, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, listKnowledgeSourceItems, listKnowledgeSourceChanges, listKnowledgeSyncRuns, listMemoryEvidence, 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, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, type CachedConnectorCatalogEntry, } from './connector-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';
 export { getUserTrustPolicy, setUserTrustPolicy, } from './user-trust-repository.js';
 export { consumeMemoryReferenceConsent, decideMemoryReferenceConsent, ensureMemoryReferenceConsentRequest, hasMemoryReferenceConsent, listMemoryReferenceConsents, revokeMemoryReferenceConsent, type MemoryReferenceConsent, type MemoryReferenceGrantScope, } from './memory-reference-consent-repository.js';
 export { getUserProfilePromptState, setUserProfilePromptState, } from './user-profile-setup-repository.js';

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

@@ -17,8 +17,8 @@ import { USER_UNDERSTANDING_REMEDIATION_POLICY, appendMemorySignal, appendMemory
 import { attachMemoryEvidence, claimKnowledgeSourceItems, completeKnowledgeSourceItemSynthesis, deleteMemoryEvidenceForRecord, finishKnowledgeSyncRun, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, 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, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation } from "./connector-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 { DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, SCHEMA_META_SCHEMA_VERSION_KEY, USER_UNDERSTANDING_REMEDIATION_POLICY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, appendConnectorExecutionAudit, appendMemorySignal, appendMemoryTraceEvent, appendTranscriptEntry, applyPendingMigrations, attachMemoryEvidence, buildDefaultSessionMetadata, buildGlobalSessionStats, captureCompactionCheckpoint, claimConnectorWebhookDelivery, claimKnowledgeSourceItems, classifyStoredRow, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, consumeConnectorApproval, consumeMemoryReferenceConsent, createConnectorApproval, createObjectLinkRecord, decideConnectorApproval, decideMemoryReferenceConsent, deleteConnectorConnection, deleteConnectorInstallation, deleteMemoryEvidenceForRecord, deleteMemoryRecord, deleteNoteAgentContextRecord, deleteNoteRecord, deleteSessionConfig, deleteSessionRecord, discoverSqlMigrations, ensureMemoryReferenceConsentRequest, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findLatestMemoryInjectTrace, findSessionKeyBySessionId, finishKnowledgeSyncRun, getActivityEventRecord, getCachedConnectorCatalogEntry, getCompactionCheckpointDetail, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getCurrentSessionId, getGlobalSessionStats, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getMemoryProviderState, getMemoryRecord, getNoteAgentContextRecord, getNoteRecord, getSessionConfig, getSessionMetadata, getSessionPersistedLevels, getSqliteDatabase, getUserProfilePromptState, getUserTrustPolicy, getXopcDatabase, hasMemoryReferenceConsent, hasSessionConfig, hasUnresolvedMemoryConflict, incrementSessionStatsOnAppend, inspectSchemaMigrationStatus, isXopcDatabaseOpen, listActivityRecords, listCachedConnectorCatalogEntries, listCompactionCheckpoints, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, listMemoryRecords, listMemoryReferenceConsents, listMemorySignals, listMemoryTraceEvents, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, loadCheckpointRows, loadLlmMessagesForSession, loadTranscriptRows, loadTranscriptRowsForSession, markMemoryRecordsConflicted, metadataToSessionInsert, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, readSchemaVersion, readSchemaVersionForTest, recordActivityEvent, releaseConnectorWebhookDelivery, replaceTranscriptRows, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreCompactionCheckpoint, revokeMemoryReferenceConsent, runSqliteWriteTransaction, searchMemoryIndex, searchMemoryRecords, sessionConfigRowToConfig, sessionRowToMetadata, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setLatestMemoryInjectFeedback, setMemoryProviderState, setMemoryTraceFeedback, setSessionConfig, setUserProfilePromptState, setUserTrustPolicy, startKnowledgeSyncRun, summarizeMemoryRecallFeedback, summarizeUserUnderstandingQuality, syncMemoryIndex, transcriptEntryRowToStoredRow, updateSessionConfig, updateSessionStats, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertKnowledgeSourceItems, upsertMemoryRecord, upsertNoteAgentContextRecord, upsertNoteRecord };
+export { DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, SCHEMA_META_SCHEMA_VERSION_KEY, USER_UNDERSTANDING_REMEDIATION_POLICY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, appendConnectorExecutionAudit, appendMemorySignal, appendMemoryTraceEvent, appendTranscriptEntry, applyPendingMigrations, attachMemoryEvidence, buildDefaultSessionMetadata, buildGlobalSessionStats, captureCompactionCheckpoint, claimConnectorWebhookDelivery, claimKnowledgeSourceItems, classifyStoredRow, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, consumeConnectorApproval, consumeMemoryReferenceConsent, createConnectorApproval, createObjectLinkRecord, decideConnectorApproval, decideMemoryReferenceConsent, deleteConnectorConnection, deleteConnectorInstallation, deleteMemoryEvidenceForRecord, deleteMemoryRecord, deleteNoteAgentContextRecord, deleteNoteRecord, deleteSessionConfig, deleteSessionRecord, discoverSqlMigrations, ensureMemoryReferenceConsentRequest, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findLatestMemoryInjectTrace, findSessionKeyBySessionId, finishKnowledgeSyncRun, getActivityEventRecord, getCachedConnectorCatalogEntry, getCompactionCheckpointDetail, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getCurrentSessionId, getGlobalSessionStats, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getMemoryProviderState, getMemoryRecord, getNoteAgentContextRecord, getNoteRecord, getSessionConfig, getSessionMetadata, getSessionPersistedLevels, getSqliteDatabase, getUserProfilePromptState, getUserTrustPolicy, getXopcDatabase, hasMemoryReferenceConsent, hasSessionConfig, hasUnresolvedMemoryConflict, incrementSessionStatsOnAppend, inspectSchemaMigrationStatus, isXopcDatabaseOpen, listActivityRecords, listCachedConnectorCatalogEntries, listCompactionCheckpoints, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, listMemoryRecords, listMemoryReferenceConsents, listMemorySignals, listMemoryTraceEvents, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, loadCheckpointRows, loadLlmMessagesForSession, loadTranscriptRows, loadTranscriptRowsForSession, markMemoryRecordsConflicted, metadataToSessionInsert, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, readSchemaVersion, readSchemaVersionForTest, recordActivityEvent, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, replaceTranscriptRows, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreCompactionCheckpoint, revokeMemoryReferenceConsent, runSqliteWriteTransaction, searchMemoryIndex, searchMemoryRecords, sessionConfigRowToConfig, sessionRowToMetadata, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setLatestMemoryInjectFeedback, setMemoryProviderState, setMemoryTraceFeedback, setSessionConfig, setUserProfilePromptState, setUserTrustPolicy, startKnowledgeSyncRun, summarizeMemoryRecallFeedback, summarizeUserUnderstandingQuality, syncMemoryIndex, transcriptEntryRowToStoredRow, updateSessionConfig, updateSessionStats, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertKnowledgeSourceItems, upsertMemoryRecord, upsertNoteAgentContextRecord, upsertNoteRecord };

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

@@ -60,6 +60,8 @@ export declare function projectPersonalContextSources(definitions: ConnectorDefi
     branding?: import("../connectors/types.js").ConnectorBranding;
     id: string;
     accountLabel: any;
+    accountOrdinal: any;
+    accountCount: any;
     displayName: string;
     description: string;
 }[];

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

@@ -79,11 +79,15 @@ function projectPersonalContextSources(definitions, instances, records = [], kno
 	}
 	return definitions.filter(isPersonalContextConnector).flatMap((definition) => {
 		const connected = instanceByConnector.get(definition.id) ?? [];
-		const accounts = (knowledge.connections ?? []).filter((connection) => connection.provider === "composio" && connection.connectorId === definition.id && connection.status !== "revoked");
-		return (accounts.length > 0 ? accounts.map((connection) => ({
+		const accounts = (knowledge.connections ?? []).filter((connection) => connection.provider === "composio" && connection.connectorId === definition.id && connection.status !== "revoked").sort((left, right) => {
+			return (left.connectedAt ?? left.createdAt).localeCompare(right.connectedAt ?? right.createdAt) || left.id.localeCompare(right.id);
+		});
+		return (accounts.length > 0 ? accounts.map((connection, index) => ({
 			instanceId: connection.id,
 			sourceInstanceId: `composio:${definition.id}:${connection.id}`,
 			accountLabel: connection.alias ?? (typeof connection.identity.email === "string" ? connection.identity.email : void 0) ?? (typeof connection.identity.username === "string" ? connection.identity.username : void 0),
+			accountOrdinal: index + 1,
+			accountCount: accounts.length,
 			enabled: connection.status === "active",
 			status: connection.status,
 			lastConnectedAt: connection.connectedAt,
@@ -92,6 +96,8 @@ function projectPersonalContextSources(definitions, instances, records = [], kno
 			instanceId: instance.instanceId,
 			sourceInstanceId: instance.instanceId,
 			accountLabel: void 0,
+			accountOrdinal: void 0,
+			accountCount: void 0,
 			enabled: instance.enabled,
 			status: instance.status,
 			lastConnectedAt: instance.lastConnectedAt,
@@ -100,6 +106,8 @@ function projectPersonalContextSources(definitions, instances, records = [], kno
 			instanceId: void 0,
 			sourceInstanceId: void 0,
 			accountLabel: void 0,
+			accountOrdinal: void 0,
+			accountCount: void 0,
 			enabled: false,
 			status: "not_installed",
 			lastConnectedAt: void 0,
@@ -114,6 +122,8 @@ function projectPersonalContextSources(definitions, instances, records = [], kno
 			return {
 				id: definition.id,
 				accountLabel: row.accountLabel,
+				accountOrdinal: row.accountOrdinal,
+				accountCount: row.accountCount,
 				displayName: definition.displayName,
 				description: definition.description,
 				...definition.branding ? { branding: definition.branding } : {},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.156",
+  "version": "0.0.158",
   "description": "Local-first AI system that remembers context, coordinates AI, and sustains long-term progress.",
   "type": "module",
   "main": "dist/src/index.js",
@@ -106,7 +106,7 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@composio/core": "0.14.0",
+    "@composio/core": "0.14.1",
     "@composio/experimental": "0.2.0",
     "@huggingface/transformers": "3.8.1",
     "@larksuiteoapi/node-sdk": "^1.66.0",
@@ -134,7 +134,7 @@
     }
   },
   "devDependencies": {
-    "@composio/core": "0.14.0",
+    "@composio/core": "0.14.1",
     "@composio/experimental": "0.2.0",
     "@huggingface/transformers": "3.8.1",
     "@larksuiteoapi/node-sdk": "^1.66.0",