@xopcai/xopc 0.0.146 → 0.0.147

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

@@ -4,7 +4,7 @@ export type PreparedUserContextImport = {
     kind: MemoryRecord['kind'];
     sensitivity: NonNullable<MemoryRecord['sensitivity']>;
     durability: MemoryRecord['durability'];
-    canReference: boolean;
+    disclosurePolicy: MemoryRecord['disclosurePolicy'];
 };
 export declare function prepareUserContextImport(candidates: unknown[], existingStatements: Iterable<string>): {
     imports: PreparedUserContextImport[];

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

@@ -29,12 +29,17 @@ function prepareUserContextImport(candidates, existingStatements) {
 			"recurring"
 		].includes(item.durability) ? item.durability : "durable";
 		known.add(normalized);
+		const disclosurePolicy = typeof item.disclosurePolicy === "string" && [
+			"silent",
+			"referenceable",
+			"ask_before_reference"
+		].includes(item.disclosurePolicy) ? item.disclosurePolicy : "referenceable";
 		imports.push({
 			statement,
 			kind,
 			sensitivity,
 			durability,
-			canReference: item.canReference !== false
+			disclosurePolicy
 		});
 	}
 	return {

package/dist/src/user-context/import.js.map

@@ -1 +1 @@
-{"version":3,"file":"import.js","names":[],"sources":["../../../src/user-context/import.ts"],"sourcesContent":["import type { MemoryRecord } from '../agent/memory/types.js';\nimport { isUserContextMemoryKind } from './projection.js';\n\nexport type PreparedUserContextImport = {\n  statement: string;\n  kind: MemoryRecord['kind'];\n  sensitivity: NonNullable<MemoryRecord['sensitivity']>;\n  durability: MemoryRecord['durability'];\n  canReference: boolean;\n};\n\nexport function prepareUserContextImport(\n  candidates: unknown[],\n  existingStatements: Iterable<string>,\n): { imports: PreparedUserContextImport[]; skippedCount: number } {\n  const known = new Set(Array.from(existingStatements, (statement) => statement.trim().toLocaleLowerCase()));\n  const imports: PreparedUserContextImport[] = [];\n  let skippedCount = 0;\n\n  for (const candidate of candidates) {\n    if (!candidate || typeof candidate !== 'object' || Array.isArray(candidate)) {\n      skippedCount += 1;\n      continue;\n    }\n    const item = candidate as Record<string, unknown>;\n    const statement = typeof item.statement === 'string' ? item.statement.trim() : '';\n    const normalized = statement.toLocaleLowerCase();\n    if (\n      !statement\n      || statement.length > 5_000\n      || known.has(normalized)\n      || item.status === 'archived'\n      || item.status === 'rejected'\n    ) {\n      skippedCount += 1;\n      continue;\n    }\n    const kind = isUserContextMemoryKind(item.kind) ? item.kind : 'preference';\n    const sensitivity = typeof item.sensitivity === 'string'\n      && ['normal', 'personal', 'secret', 'regulated'].includes(item.sensitivity)\n      ? item.sensitivity as NonNullable<MemoryRecord['sensitivity']>\n      : 'normal';\n    const durability = typeof item.durability === 'string'\n      && ['ephemeral', 'durable', 'recurring'].includes(item.durability)\n      ? item.durability as MemoryRecord['durability']\n      : 'durable';\n    known.add(normalized);\n    imports.push({ statement, kind, sensitivity, durability, canReference: item.canReference !== false });\n  }\n\n  return { imports, skippedCount };\n}\n"],"mappings":";;AAWA,SAAgB,yBACd,YACA,oBACgE;CAChE,MAAM,QAAQ,IAAI,IAAI,MAAM,KAAK,qBAAqB,cAAc,UAAU,MAAM,CAAC,mBAAmB,CAAC,CAAC;CAC1G,MAAM,UAAuC,EAAE;CAC/C,IAAI,eAAe;AAEnB,MAAK,MAAM,aAAa,YAAY;AAClC,MAAI,CAAC,aAAa,OAAO,cAAc,YAAY,MAAM,QAAQ,UAAU,EAAE;AAC3E,mBAAgB;AAChB;;EAEF,MAAM,OAAO;EACb,MAAM,YAAY,OAAO,KAAK,cAAc,WAAW,KAAK,UAAU,MAAM,GAAG;EAC/E,MAAM,aAAa,UAAU,mBAAmB;AAChD,MACE,CAAC,aACE,UAAU,SAAS,OACnB,MAAM,IAAI,WAAW,IACrB,KAAK,WAAW,cAChB,KAAK,WAAW,YACnB;AACA,mBAAgB;AAChB;;EAEF,MAAM,OAAO,wBAAwB,KAAK,KAAK,GAAG,KAAK,OAAO;EAC9D,MAAM,cAAc,OAAO,KAAK,gBAAgB,YAC3C;GAAC;GAAU;GAAY;GAAU;GAAY,CAAC,SAAS,KAAK,YAAY,GACzE,KAAK,cACL;EACJ,MAAM,aAAa,OAAO,KAAK,eAAe,YACzC;GAAC;GAAa;GAAW;GAAY,CAAC,SAAS,KAAK,WAAW,GAChE,KAAK,aACL;AACJ,QAAM,IAAI,WAAW;AACrB,UAAQ,KAAK;GAAE;GAAW;GAAM;GAAa;GAAY,cAAc,KAAK,iBAAiB;GAAO,CAAC;;AAGvG,QAAO;EAAE;EAAS;EAAc"}
+{"version":3,"file":"import.js","names":[],"sources":["../../../src/user-context/import.ts"],"sourcesContent":["import type { MemoryRecord } from '../agent/memory/types.js';\nimport { isUserContextMemoryKind } from './projection.js';\n\nexport type PreparedUserContextImport = {\n  statement: string;\n  kind: MemoryRecord['kind'];\n  sensitivity: NonNullable<MemoryRecord['sensitivity']>;\n  durability: MemoryRecord['durability'];\n  disclosurePolicy: MemoryRecord['disclosurePolicy'];\n};\n\nexport function prepareUserContextImport(\n  candidates: unknown[],\n  existingStatements: Iterable<string>,\n): { imports: PreparedUserContextImport[]; skippedCount: number } {\n  const known = new Set(Array.from(existingStatements, (statement) => statement.trim().toLocaleLowerCase()));\n  const imports: PreparedUserContextImport[] = [];\n  let skippedCount = 0;\n\n  for (const candidate of candidates) {\n    if (!candidate || typeof candidate !== 'object' || Array.isArray(candidate)) {\n      skippedCount += 1;\n      continue;\n    }\n    const item = candidate as Record<string, unknown>;\n    const statement = typeof item.statement === 'string' ? item.statement.trim() : '';\n    const normalized = statement.toLocaleLowerCase();\n    if (\n      !statement\n      || statement.length > 5_000\n      || known.has(normalized)\n      || item.status === 'archived'\n      || item.status === 'rejected'\n    ) {\n      skippedCount += 1;\n      continue;\n    }\n    const kind = isUserContextMemoryKind(item.kind) ? item.kind : 'preference';\n    const sensitivity = typeof item.sensitivity === 'string'\n      && ['normal', 'personal', 'secret', 'regulated'].includes(item.sensitivity)\n      ? item.sensitivity as NonNullable<MemoryRecord['sensitivity']>\n      : 'normal';\n    const durability = typeof item.durability === 'string'\n      && ['ephemeral', 'durable', 'recurring'].includes(item.durability)\n      ? item.durability as MemoryRecord['durability']\n      : 'durable';\n    known.add(normalized);\n    const disclosurePolicy = typeof item.disclosurePolicy === 'string'\n      && ['silent', 'referenceable', 'ask_before_reference'].includes(item.disclosurePolicy)\n      ? item.disclosurePolicy as MemoryRecord['disclosurePolicy']\n      : 'referenceable';\n    imports.push({ statement, kind, sensitivity, durability, disclosurePolicy });\n  }\n\n  return { imports, skippedCount };\n}\n"],"mappings":";;AAWA,SAAgB,yBACd,YACA,oBACgE;CAChE,MAAM,QAAQ,IAAI,IAAI,MAAM,KAAK,qBAAqB,cAAc,UAAU,MAAM,CAAC,mBAAmB,CAAC,CAAC;CAC1G,MAAM,UAAuC,EAAE;CAC/C,IAAI,eAAe;AAEnB,MAAK,MAAM,aAAa,YAAY;AAClC,MAAI,CAAC,aAAa,OAAO,cAAc,YAAY,MAAM,QAAQ,UAAU,EAAE;AAC3E,mBAAgB;AAChB;;EAEF,MAAM,OAAO;EACb,MAAM,YAAY,OAAO,KAAK,cAAc,WAAW,KAAK,UAAU,MAAM,GAAG;EAC/E,MAAM,aAAa,UAAU,mBAAmB;AAChD,MACE,CAAC,aACE,UAAU,SAAS,OACnB,MAAM,IAAI,WAAW,IACrB,KAAK,WAAW,cAChB,KAAK,WAAW,YACnB;AACA,mBAAgB;AAChB;;EAEF,MAAM,OAAO,wBAAwB,KAAK,KAAK,GAAG,KAAK,OAAO;EAC9D,MAAM,cAAc,OAAO,KAAK,gBAAgB,YAC3C;GAAC;GAAU;GAAY;GAAU;GAAY,CAAC,SAAS,KAAK,YAAY,GACzE,KAAK,cACL;EACJ,MAAM,aAAa,OAAO,KAAK,eAAe,YACzC;GAAC;GAAa;GAAW;GAAY,CAAC,SAAS,KAAK,WAAW,GAChE,KAAK,aACL;AACJ,QAAM,IAAI,WAAW;EACrB,MAAM,mBAAmB,OAAO,KAAK,qBAAqB,YACrD;GAAC;GAAU;GAAiB;GAAuB,CAAC,SAAS,KAAK,iBAAiB,GACpF,KAAK,mBACL;AACJ,UAAQ,KAAK;GAAE;GAAW;GAAM;GAAa;GAAY;GAAkB,CAAC;;AAG9E,QAAO;EAAE;EAAS;EAAc"}

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

@@ -0,0 +1,5 @@
+export declare const LOCAL_USER_ID = "local-owner";
+export interface UserContextOwner {
+    userId: string;
+}
+export declare function resolveLocalUserContextOwner(): UserContextOwner;

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

@@ -0,0 +1,9 @@
+//#region src/user-context/owner.ts
+const LOCAL_USER_ID = "local-owner";
+function resolveLocalUserContextOwner() {
+	return { userId: LOCAL_USER_ID };
+}
+//#endregion
+export { LOCAL_USER_ID, resolveLocalUserContextOwner };
+
+//# sourceMappingURL=owner.js.map

package/dist/src/user-context/owner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"owner.js","names":[],"sources":["../../../src/user-context/owner.ts"],"sourcesContent":["export const LOCAL_USER_ID = 'local-owner';\n\nexport interface UserContextOwner {\n  userId: string;\n}\n\nexport function resolveLocalUserContextOwner(): UserContextOwner {\n  return { userId: LOCAL_USER_ID };\n}\n"],"mappings":";AAAA,MAAa,gBAAgB;AAM7B,SAAgB,+BAAiD;AAC/D,QAAO,EAAE,QAAQ,eAAe"}

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

@@ -1,5 +1,5 @@
 import type { MemoryKind, MemoryRecord } from '../agent/memory/types.js';
-import type { ConnectorDefinition, ConnectorInstance } from '../connectors/types.js';
+import type { ConnectorConnection, ConnectorDefinition, ConnectorInstance } from '../connectors/types.js';
 import type { KnowledgeSourceItem, KnowledgeSyncRun } from '../knowledge/types.js';
 export type UserContextFacet = 'basics' | 'collaboration' | 'boundaries' | 'priorities' | 'people' | 'current';
 export type UserContextOrigin = 'told_by_you' | 'observed' | 'inferred' | 'connected_source';
@@ -19,7 +19,7 @@ export declare function projectUserContextRecord(record: MemoryRecord): {
     sensitivity: import("../agent/memory/types.js").MemorySensitivity;
     explicitness: import("../agent/memory/types.js").MemoryExplicitness;
     durability: import("../agent/memory/types.js").MemoryDurability;
-    canReference: boolean;
+    disclosurePolicy: import("../agent/memory/types.js").MemoryDisclosurePolicy;
     stability: import("../agent/memory/lifecycle.js").MemoryStabilityBand;
     stabilityScore: number;
     reviewAt: string;
@@ -29,10 +29,11 @@ export declare function projectUserContextRecord(record: MemoryRecord): {
     latestEvidenceAt: string;
 };
 export declare function isPersonalContextConnector(definition: ConnectorDefinition): boolean;
-export declare function recordsDerivedFromPersonalContextSource(records: MemoryRecord[], agentId: string, connectorId: string): MemoryRecord[];
+export declare function recordsDerivedFromPersonalContextSource(records: MemoryRecord[], sourceInstanceId: string): MemoryRecord[];
 export declare function projectPersonalContextSources(definitions: ConnectorDefinition[], instances: ConnectorInstance[], records?: MemoryRecord[], knowledge?: {
     sourceItems?: KnowledgeSourceItem[];
     syncRuns?: KnowledgeSyncRun[];
+    connections?: ConnectorConnection[];
 }): {
     category: import("../connectors/types.js").ConnectorCategory;
     capabilities: ("context" | "tools" | "events" | "memory_source")[];
@@ -44,12 +45,12 @@ export declare function projectPersonalContextSources(definitions: ConnectorDefi
     };
     permissionDetails: string[];
     installed: boolean;
-    enabled: boolean;
-    status: string;
-    instanceId: string;
-    lastConnectedAt: string;
-    lastHealthCheckAt: string;
-    lastHealthStatus: import("../connectors/types.js").ConnectorHealthStatus;
+    enabled: any;
+    status: any;
+    instanceId: any;
+    lastConnectedAt: any;
+    lastHealthCheckAt: any;
+    lastHealthStatus: any;
     lastActivityAt: string;
     derivedUnderstandingCount: number;
     knowledgeItemCount: number;
@@ -58,6 +59,7 @@ export declare function projectPersonalContextSources(definitions: ConnectorDefi
     lastSyncError: string;
     branding?: import("../connectors/types.js").ConnectorBranding;
     id: string;
+    accountLabel: any;
     displayName: string;
     description: string;
 }[];

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

@@ -54,7 +54,7 @@ function projectUserContextRecord(record) {
 		sensitivity: record.sensitivity ?? "normal",
 		explicitness: record.explicitness,
 		durability: record.durability,
-		canReference: record.disclosurePolicy !== "silent",
+		disclosurePolicy: record.disclosurePolicy,
 		stability: lifecycle.band,
 		stabilityScore: lifecycle.score,
 		reviewAt: lifecycle.reviewAt,
@@ -67,8 +67,8 @@ function projectUserContextRecord(record) {
 function isPersonalContextConnector(definition) {
 	return definition.capabilities.includes("context") || definition.capabilities.includes("memory_source");
 }
-function recordsDerivedFromPersonalContextSource(records, agentId, connectorId) {
-	return records.filter((record) => record.scope.agentId === agentId && record.source.provider === connectorId && isUserContextRecord(record));
+function recordsDerivedFromPersonalContextSource(records, sourceInstanceId) {
+	return records.filter((record) => record.source.sourceInstanceId === sourceInstanceId && isUserContextRecord(record));
 }
 function projectPersonalContextSources(definitions, instances, records = [], knowledge = {}) {
 	const instanceByConnector = /* @__PURE__ */ new Map();
@@ -77,51 +77,78 @@ function projectPersonalContextSources(definitions, instances, records = [], kno
 		current.push(instance);
 		instanceByConnector.set(instance.connectorId, current);
 	}
-	return definitions.filter(isPersonalContextConnector).map((definition) => {
+	return definitions.filter(isPersonalContextConnector).flatMap((definition) => {
 		const connected = instanceByConnector.get(definition.id) ?? [];
-		const relatedRecords = records.filter((record) => record.source.provider === definition.id);
-		const sourceItems = (knowledge.sourceItems ?? []).filter((item) => item.metadata.connectorId === definition.id);
-		const sourceInstanceIds = new Set(sourceItems.map((item) => item.sourceInstanceId));
-		const latestSync = (knowledge.syncRuns ?? []).filter((run) => sourceInstanceIds.has(run.sourceInstanceId) || run.sourceInstanceId.startsWith(`composio:${definition.id}:`) || run.sourceInstanceId.startsWith(`${definition.id}:`)).sort((left, right) => Date.parse(right.startedAt) - Date.parse(left.startedAt))[0];
-		const latestHealth = connected.filter((instance) => instance.usage.lastHealthCheckAt && instance.usage.lastHealthStatus).sort((left, right) => Date.parse(right.usage.lastHealthCheckAt) - Date.parse(left.usage.lastHealthCheckAt))[0]?.usage;
-		const permissionDetails = definition.permissions?.data ?? [];
-		const canWrite = permissionDetails.some((permission) => /(?:^|[.:/_-])(write|create|update|delete|manage|send|admin)(?:$|[.:/_-])/i.test(permission));
-		return {
-			id: definition.id,
-			displayName: definition.displayName,
-			description: definition.description,
-			...definition.branding ? { branding: definition.branding } : {},
-			category: definition.category,
-			capabilities: definition.capabilities.filter((capability) => capability === "context" || capability === "memory_source" || capability === "tools" || capability === "events"),
-			access: {
-				context: definition.capabilities.includes("context"),
-				memory: definition.capabilities.includes("memory_source"),
-				read: definition.capabilities.includes("context") || definition.capabilities.includes("resources") || definition.capabilities.includes("tools"),
-				write: canWrite
-			},
-			permissionDetails,
-			installed: connected.length > 0,
-			enabled: connected.some((instance) => instance.enabled),
-			status: connected[0]?.status ?? "not_installed",
-			instanceId: connected[0]?.instanceId,
-			lastConnectedAt: connected.map((instance) => instance.lastConnectedAt).filter((value) => Boolean(value)).sort().at(-1),
-			lastHealthCheckAt: latestHealth?.lastHealthCheckAt,
-			lastHealthStatus: latestHealth?.lastHealthStatus,
-			lastActivityAt: [
-				...connected.flatMap((instance) => [
-					instance.lastConnectedAt,
-					instance.usage.lastHealthCheckAt,
-					...instance.audit.map((entry) => entry.at)
-				]),
-				latestSync?.finishedAt,
-				latestSync?.startedAt
-			].filter((value) => Boolean(value)).sort().at(-1),
-			derivedUnderstandingCount: relatedRecords.length,
-			knowledgeItemCount: sourceItems.filter((item) => !item.deletedAt).length,
-			lastSyncAt: latestSync?.finishedAt ?? latestSync?.startedAt,
-			lastSyncStatus: latestSync?.status,
-			lastSyncError: latestSync?.error
-		};
+		const accounts = (knowledge.connections ?? []).filter((connection) => connection.provider === "composio" && connection.connectorId === definition.id && connection.status !== "revoked");
+		return (accounts.length > 0 ? accounts.map((connection) => ({
+			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),
+			enabled: connection.status === "active",
+			status: connection.status,
+			lastConnectedAt: connection.connectedAt,
+			instances: connected
+		})) : connected.length > 0 ? connected.map((instance) => ({
+			instanceId: instance.instanceId,
+			sourceInstanceId: instance.instanceId,
+			accountLabel: void 0,
+			enabled: instance.enabled,
+			status: instance.status,
+			lastConnectedAt: instance.lastConnectedAt,
+			instances: [instance]
+		})) : [{
+			instanceId: void 0,
+			sourceInstanceId: void 0,
+			accountLabel: void 0,
+			enabled: false,
+			status: "not_installed",
+			lastConnectedAt: void 0,
+			instances: []
+		}]).map((row) => {
+			const relatedRecords = row.sourceInstanceId ? records.filter((record) => record.source.sourceInstanceId === row.sourceInstanceId) : [];
+			const sourceItems = row.sourceInstanceId ? (knowledge.sourceItems ?? []).filter((item) => item.sourceInstanceId === row.sourceInstanceId) : [];
+			const latestSync = (knowledge.syncRuns ?? []).filter((run) => run.sourceInstanceId === row.sourceInstanceId).sort((left, right) => Date.parse(right.startedAt) - Date.parse(left.startedAt))[0];
+			const latestHealth = row.instances.filter((instance) => instance.usage.lastHealthCheckAt && instance.usage.lastHealthStatus).sort((left, right) => Date.parse(right.usage.lastHealthCheckAt) - Date.parse(left.usage.lastHealthCheckAt))[0]?.usage;
+			const permissionDetails = definition.permissions?.data ?? [];
+			const canWrite = permissionDetails.some((permission) => /(?:^|[.:/_-])(write|create|update|delete|manage|send|admin)(?:$|[.:/_-])/i.test(permission));
+			return {
+				id: definition.id,
+				accountLabel: row.accountLabel,
+				displayName: definition.displayName,
+				description: definition.description,
+				...definition.branding ? { branding: definition.branding } : {},
+				category: definition.category,
+				capabilities: definition.capabilities.filter((capability) => capability === "context" || capability === "memory_source" || capability === "tools" || capability === "events"),
+				access: {
+					context: definition.capabilities.includes("context"),
+					memory: definition.capabilities.includes("memory_source"),
+					read: definition.capabilities.includes("context") || definition.capabilities.includes("resources") || definition.capabilities.includes("tools"),
+					write: canWrite
+				},
+				permissionDetails,
+				installed: row.instanceId !== void 0,
+				enabled: row.enabled,
+				status: row.status,
+				instanceId: row.instanceId,
+				lastConnectedAt: row.lastConnectedAt,
+				lastHealthCheckAt: latestHealth?.lastHealthCheckAt,
+				lastHealthStatus: latestHealth?.lastHealthStatus,
+				lastActivityAt: [
+					...row.instances.flatMap((instance) => [
+						instance.lastConnectedAt,
+						instance.usage.lastHealthCheckAt,
+						...instance.audit.map((entry) => entry.at)
+					]),
+					latestSync?.finishedAt,
+					latestSync?.startedAt
+				].filter((value) => Boolean(value)).sort().at(-1),
+				derivedUnderstandingCount: relatedRecords.length,
+				knowledgeItemCount: sourceItems.filter((item) => !item.deletedAt).length,
+				lastSyncAt: latestSync?.finishedAt ?? latestSync?.startedAt,
+				lastSyncStatus: latestSync?.status,
+				lastSyncError: latestSync?.error
+			};
+		});
 	}).sort((left, right) => {
 		if (left.installed !== right.installed) return left.installed ? -1 : 1;
 		return left.displayName.localeCompare(right.displayName);

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

@@ -1 +1 @@
-{"version":3,"file":"projection.js","names":[],"sources":["../../../src/user-context/projection.ts"],"sourcesContent":["import type { MemoryKind, MemoryRecord } from '../agent/memory/types.js';\nimport { effectiveMemoryStatus, resolveMemoryStability } from '../agent/memory/lifecycle.js';\nimport { classifyMemoryContextOrigin } from '../agent/memory/source-origin.js';\nimport type { ConnectorDefinition, ConnectorInstance } from '../connectors/types.js';\nimport type { KnowledgeSourceItem, KnowledgeSyncRun } from '../knowledge/types.js';\n\nexport type UserContextFacet =\n  | 'basics'\n  | 'collaboration'\n  | 'boundaries'\n  | 'priorities'\n  | 'people'\n  | 'current';\n\nexport type UserContextOrigin = 'told_by_you' | 'observed' | 'inferred' | 'connected_source';\n\nconst ALWAYS_PERSONAL_KINDS = new Set<MemoryKind>([\n  'user_profile',\n  'preference',\n  'boundary',\n  'relationship',\n  'commitment',\n  'routine',\n  'personal_logistics',\n  'current_state',\n  'tool_preference',\n  'long_term_goal',\n]);\n\nconst CONTEXTUAL_USER_KINDS = new Set<MemoryKind>([\n  'project_context',\n  'open_question',\n  'milestone',\n  'derived_insight',\n  'task_lesson',\n]);\n\nexport function isUserContextRecord(record: MemoryRecord): boolean {\n  if (ALWAYS_PERSONAL_KINDS.has(record.kind)) return true;\n  return CONTEXTUAL_USER_KINDS.has(record.kind) && record.tags?.includes('user-understanding') === true;\n}\n\nexport function isUserContextMemoryKind(value: unknown): value is MemoryKind {\n  return typeof value === 'string'\n    && (ALWAYS_PERSONAL_KINDS.has(value as MemoryKind) || CONTEXTUAL_USER_KINDS.has(value as MemoryKind));\n}\n\nexport function facetForMemoryKind(kind: MemoryKind): UserContextFacet {\n  if (kind === 'user_profile' || kind === 'personal_logistics') return 'basics';\n  if (kind === 'preference' || kind === 'routine' || kind === 'tool_preference' || kind === 'task_lesson') {\n    return 'collaboration';\n  }\n  if (kind === 'boundary') return 'boundaries';\n  if (kind === 'relationship') return 'people';\n  if (kind === 'current_state' || kind === 'open_question') return 'current';\n  return 'priorities';\n}\n\nexport function originForMemoryRecord(record: MemoryRecord): UserContextOrigin {\n  const origin = classifyMemoryContextOrigin(record);\n  return origin === 'told_by_user' ? 'told_by_you' : origin;\n}\n\nexport function projectUserContextRecord(record: MemoryRecord) {\n  const lifecycle = resolveMemoryStability(record);\n  const latestEvidenceAt = record.evidence\n    ?.map((evidence) => evidence.observedAt)\n    .filter((value): value is string => Boolean(value))\n    .sort()\n    .at(-1);\n  return {\n    id: record.id,\n    statement: record.content,\n    facet: facetForMemoryKind(record.kind),\n    kind: record.kind,\n    status: effectiveMemoryStatus(record),\n    origin: originForMemoryRecord(record),\n    sourceName: record.source.provider ?? 'local',\n    updatedAt: record.updatedAt,\n    sensitivity: record.sensitivity ?? 'normal',\n    explicitness: record.explicitness,\n    durability: record.durability,\n    canReference: record.disclosurePolicy !== 'silent',\n    stability: lifecycle.band,\n    stabilityScore: lifecycle.score,\n    reviewAt: lifecycle.reviewAt,\n    reviewDue: lifecycle.reviewDue,\n    evidenceCount: record.evidence?.length ?? 0,\n    sourcePath: record.source.path,\n    latestEvidenceAt,\n  };\n}\n\nexport function isPersonalContextConnector(definition: ConnectorDefinition): boolean {\n  return definition.capabilities.includes('context') || definition.capabilities.includes('memory_source');\n}\n\nexport function recordsDerivedFromPersonalContextSource(\n  records: MemoryRecord[],\n  agentId: string,\n  connectorId: string,\n): MemoryRecord[] {\n  return records.filter((record) => (\n    record.scope.agentId === agentId\n    && record.source.provider === connectorId\n    && isUserContextRecord(record)\n  ));\n}\n\nexport function projectPersonalContextSources(\n  definitions: ConnectorDefinition[],\n  instances: ConnectorInstance[],\n  records: MemoryRecord[] = [],\n  knowledge: { sourceItems?: KnowledgeSourceItem[]; syncRuns?: KnowledgeSyncRun[] } = {},\n) {\n  const instanceByConnector = new Map<string, ConnectorInstance[]>();\n  for (const instance of instances) {\n    const current = instanceByConnector.get(instance.connectorId) ?? [];\n    current.push(instance);\n    instanceByConnector.set(instance.connectorId, current);\n  }\n  return definitions\n    .filter(isPersonalContextConnector)\n    .map((definition) => {\n      const connected = instanceByConnector.get(definition.id) ?? [];\n      const relatedRecords = records.filter((record) => record.source.provider === definition.id);\n      const sourceItems = (knowledge.sourceItems ?? []).filter((item) => item.metadata.connectorId === definition.id);\n      const sourceInstanceIds = new Set(sourceItems.map((item) => item.sourceInstanceId));\n      const latestSync = (knowledge.syncRuns ?? [])\n        .filter((run) => (\n          sourceInstanceIds.has(run.sourceInstanceId)\n          || run.sourceInstanceId.startsWith(`composio:${definition.id}:`)\n          || run.sourceInstanceId.startsWith(`${definition.id}:`)\n        ))\n        .sort((left, right) => Date.parse(right.startedAt) - Date.parse(left.startedAt))[0];\n      const latestHealth = connected\n        .filter((instance) => instance.usage.lastHealthCheckAt && instance.usage.lastHealthStatus)\n        .sort((left, right) => (\n          Date.parse(right.usage.lastHealthCheckAt!) - Date.parse(left.usage.lastHealthCheckAt!)\n        ))[0]?.usage;\n      const permissionDetails = definition.permissions?.data ?? [];\n      const canWrite = permissionDetails.some((permission) => (\n        /(?:^|[.:/_-])(write|create|update|delete|manage|send|admin)(?:$|[.:/_-])/i.test(permission)\n      ));\n      return {\n        id: definition.id,\n        displayName: definition.displayName,\n        description: definition.description,\n        ...(definition.branding ? { branding: definition.branding } : {}),\n        category: definition.category,\n        capabilities: definition.capabilities.filter((capability) => (\n          capability === 'context' || capability === 'memory_source' || capability === 'tools' || capability === 'events'\n        )),\n        access: {\n          context: definition.capabilities.includes('context'),\n          memory: definition.capabilities.includes('memory_source'),\n          read: definition.capabilities.includes('context')\n            || definition.capabilities.includes('resources')\n            || definition.capabilities.includes('tools'),\n          write: canWrite,\n        },\n        permissionDetails,\n        installed: connected.length > 0,\n        enabled: connected.some((instance) => instance.enabled),\n        status: connected[0]?.status ?? 'not_installed',\n        instanceId: connected[0]?.instanceId,\n        lastConnectedAt: connected\n          .map((instance) => instance.lastConnectedAt)\n          .filter((value): value is string => Boolean(value))\n          .sort()\n          .at(-1),\n        lastHealthCheckAt: latestHealth?.lastHealthCheckAt,\n        lastHealthStatus: latestHealth?.lastHealthStatus,\n        lastActivityAt: [\n          ...connected.flatMap((instance) => [\n            instance.lastConnectedAt,\n            instance.usage.lastHealthCheckAt,\n            ...instance.audit.map((entry) => entry.at),\n          ]),\n          latestSync?.finishedAt,\n          latestSync?.startedAt,\n        ]\n          .filter((value): value is string => Boolean(value))\n          .sort()\n          .at(-1),\n        derivedUnderstandingCount: relatedRecords.length,\n        knowledgeItemCount: sourceItems.filter((item) => !item.deletedAt).length,\n        lastSyncAt: latestSync?.finishedAt ?? latestSync?.startedAt,\n        lastSyncStatus: latestSync?.status,\n        lastSyncError: latestSync?.error,\n      };\n    })\n    .sort((left, right) => {\n      if (left.installed !== right.installed) return left.installed ? -1 : 1;\n      return left.displayName.localeCompare(right.displayName);\n    });\n}\n"],"mappings":"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"}
+{"version":3,"file":"projection.js","names":[],"sources":["../../../src/user-context/projection.ts"],"sourcesContent":["import type { MemoryKind, MemoryRecord } from '../agent/memory/types.js';\nimport { effectiveMemoryStatus, resolveMemoryStability } from '../agent/memory/lifecycle.js';\nimport { classifyMemoryContextOrigin } from '../agent/memory/source-origin.js';\nimport type { ConnectorConnection, ConnectorDefinition, ConnectorInstance } from '../connectors/types.js';\nimport type { KnowledgeSourceItem, KnowledgeSyncRun } from '../knowledge/types.js';\n\nexport type UserContextFacet =\n  | 'basics'\n  | 'collaboration'\n  | 'boundaries'\n  | 'priorities'\n  | 'people'\n  | 'current';\n\nexport type UserContextOrigin = 'told_by_you' | 'observed' | 'inferred' | 'connected_source';\n\nconst ALWAYS_PERSONAL_KINDS = new Set<MemoryKind>([\n  'user_profile',\n  'preference',\n  'boundary',\n  'relationship',\n  'commitment',\n  'routine',\n  'personal_logistics',\n  'current_state',\n  'tool_preference',\n  'long_term_goal',\n]);\n\nconst CONTEXTUAL_USER_KINDS = new Set<MemoryKind>([\n  'project_context',\n  'open_question',\n  'milestone',\n  'derived_insight',\n  'task_lesson',\n]);\n\nexport function isUserContextRecord(record: MemoryRecord): boolean {\n  if (ALWAYS_PERSONAL_KINDS.has(record.kind)) return true;\n  return CONTEXTUAL_USER_KINDS.has(record.kind) && record.tags?.includes('user-understanding') === true;\n}\n\nexport function isUserContextMemoryKind(value: unknown): value is MemoryKind {\n  return typeof value === 'string'\n    && (ALWAYS_PERSONAL_KINDS.has(value as MemoryKind) || CONTEXTUAL_USER_KINDS.has(value as MemoryKind));\n}\n\nexport function facetForMemoryKind(kind: MemoryKind): UserContextFacet {\n  if (kind === 'user_profile' || kind === 'personal_logistics') return 'basics';\n  if (kind === 'preference' || kind === 'routine' || kind === 'tool_preference' || kind === 'task_lesson') {\n    return 'collaboration';\n  }\n  if (kind === 'boundary') return 'boundaries';\n  if (kind === 'relationship') return 'people';\n  if (kind === 'current_state' || kind === 'open_question') return 'current';\n  return 'priorities';\n}\n\nexport function originForMemoryRecord(record: MemoryRecord): UserContextOrigin {\n  const origin = classifyMemoryContextOrigin(record);\n  return origin === 'told_by_user' ? 'told_by_you' : origin;\n}\n\nexport function projectUserContextRecord(record: MemoryRecord) {\n  const lifecycle = resolveMemoryStability(record);\n  const latestEvidenceAt = record.evidence\n    ?.map((evidence) => evidence.observedAt)\n    .filter((value): value is string => Boolean(value))\n    .sort()\n    .at(-1);\n  return {\n    id: record.id,\n    statement: record.content,\n    facet: facetForMemoryKind(record.kind),\n    kind: record.kind,\n    status: effectiveMemoryStatus(record),\n    origin: originForMemoryRecord(record),\n    sourceName: record.source.provider ?? 'local',\n    updatedAt: record.updatedAt,\n    sensitivity: record.sensitivity ?? 'normal',\n    explicitness: record.explicitness,\n    durability: record.durability,\n    disclosurePolicy: record.disclosurePolicy,\n    stability: lifecycle.band,\n    stabilityScore: lifecycle.score,\n    reviewAt: lifecycle.reviewAt,\n    reviewDue: lifecycle.reviewDue,\n    evidenceCount: record.evidence?.length ?? 0,\n    sourcePath: record.source.path,\n    latestEvidenceAt,\n  };\n}\n\nexport function isPersonalContextConnector(definition: ConnectorDefinition): boolean {\n  return definition.capabilities.includes('context') || definition.capabilities.includes('memory_source');\n}\n\nexport function recordsDerivedFromPersonalContextSource(\n  records: MemoryRecord[],\n  sourceInstanceId: string,\n): MemoryRecord[] {\n  return records.filter((record) => (\n    record.source.sourceInstanceId === sourceInstanceId\n    && isUserContextRecord(record)\n  ));\n}\n\nexport function projectPersonalContextSources(\n  definitions: ConnectorDefinition[],\n  instances: ConnectorInstance[],\n  records: MemoryRecord[] = [],\n  knowledge: {\n    sourceItems?: KnowledgeSourceItem[];\n    syncRuns?: KnowledgeSyncRun[];\n    connections?: ConnectorConnection[];\n  } = {},\n) {\n  const instanceByConnector = new Map<string, ConnectorInstance[]>();\n  for (const instance of instances) {\n    const current = instanceByConnector.get(instance.connectorId) ?? [];\n    current.push(instance);\n    instanceByConnector.set(instance.connectorId, current);\n  }\n  return definitions\n    .filter(isPersonalContextConnector)\n    .flatMap((definition) => {\n      const connected = instanceByConnector.get(definition.id) ?? [];\n      const accounts = (knowledge.connections ?? []).filter((connection) => (\n        connection.provider === 'composio'\n        && connection.connectorId === definition.id\n        && connection.status !== 'revoked'\n      ));\n      const rows = accounts.length > 0\n        ? accounts.map((connection) => ({\n            instanceId: connection.id,\n            sourceInstanceId: `composio:${definition.id}:${connection.id}`,\n            accountLabel: connection.alias\n              ?? (typeof connection.identity.email === 'string' ? connection.identity.email : undefined)\n              ?? (typeof connection.identity.username === 'string' ? connection.identity.username : undefined),\n            enabled: connection.status === 'active',\n            status: connection.status,\n            lastConnectedAt: connection.connectedAt,\n            instances: connected,\n          }))\n        : connected.length > 0\n          ? connected.map((instance) => ({\n              instanceId: instance.instanceId,\n              sourceInstanceId: instance.instanceId,\n              accountLabel: undefined,\n              enabled: instance.enabled,\n              status: instance.status,\n              lastConnectedAt: instance.lastConnectedAt,\n              instances: [instance],\n            }))\n          : [{\n              instanceId: undefined,\n              sourceInstanceId: undefined,\n              accountLabel: undefined,\n              enabled: false,\n              status: 'not_installed',\n              lastConnectedAt: undefined,\n              instances: [] as ConnectorInstance[],\n            }];\n      return rows.map((row) => {\n      const relatedRecords = row.sourceInstanceId\n        ? records.filter((record) => record.source.sourceInstanceId === row.sourceInstanceId)\n        : [];\n      const sourceItems = row.sourceInstanceId\n        ? (knowledge.sourceItems ?? []).filter((item) => item.sourceInstanceId === row.sourceInstanceId)\n        : [];\n      const latestSync = (knowledge.syncRuns ?? [])\n        .filter((run) => run.sourceInstanceId === row.sourceInstanceId)\n        .sort((left, right) => Date.parse(right.startedAt) - Date.parse(left.startedAt))[0];\n      const latestHealth = row.instances\n        .filter((instance) => instance.usage.lastHealthCheckAt && instance.usage.lastHealthStatus)\n        .sort((left, right) => (\n          Date.parse(right.usage.lastHealthCheckAt!) - Date.parse(left.usage.lastHealthCheckAt!)\n        ))[0]?.usage;\n      const permissionDetails = definition.permissions?.data ?? [];\n      const canWrite = permissionDetails.some((permission) => (\n        /(?:^|[.:/_-])(write|create|update|delete|manage|send|admin)(?:$|[.:/_-])/i.test(permission)\n      ));\n      return {\n        id: definition.id,\n        accountLabel: row.accountLabel,\n        displayName: definition.displayName,\n        description: definition.description,\n        ...(definition.branding ? { branding: definition.branding } : {}),\n        category: definition.category,\n        capabilities: definition.capabilities.filter((capability) => (\n          capability === 'context' || capability === 'memory_source' || capability === 'tools' || capability === 'events'\n        )),\n        access: {\n          context: definition.capabilities.includes('context'),\n          memory: definition.capabilities.includes('memory_source'),\n          read: definition.capabilities.includes('context')\n            || definition.capabilities.includes('resources')\n            || definition.capabilities.includes('tools'),\n          write: canWrite,\n        },\n        permissionDetails,\n        installed: row.instanceId !== undefined,\n        enabled: row.enabled,\n        status: row.status,\n        instanceId: row.instanceId,\n        lastConnectedAt: row.lastConnectedAt,\n        lastHealthCheckAt: latestHealth?.lastHealthCheckAt,\n        lastHealthStatus: latestHealth?.lastHealthStatus,\n        lastActivityAt: [\n          ...row.instances.flatMap((instance) => [\n            instance.lastConnectedAt,\n            instance.usage.lastHealthCheckAt,\n            ...instance.audit.map((entry) => entry.at),\n          ]),\n          latestSync?.finishedAt,\n          latestSync?.startedAt,\n        ]\n          .filter((value): value is string => Boolean(value))\n          .sort()\n          .at(-1),\n        derivedUnderstandingCount: relatedRecords.length,\n        knowledgeItemCount: sourceItems.filter((item) => !item.deletedAt).length,\n        lastSyncAt: latestSync?.finishedAt ?? latestSync?.startedAt,\n        lastSyncStatus: latestSync?.status,\n        lastSyncError: latestSync?.error,\n      };\n      });\n    })\n    .sort((left, right) => {\n      if (left.installed !== right.installed) return left.installed ? -1 : 1;\n      return left.displayName.localeCompare(right.displayName);\n    });\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,13 @@
+import type { Config } from '../config/schema.js';
+import { BuiltinMemoryStore } from '../agent/memory/builtin-memory-store.js';
+import type { MemoryManager } from '../agent/memory/manager.js';
+export interface UserContextRuntime {
+    builtinMemoryStore: BuiltinMemoryStore;
+    memoryManager: MemoryManager;
+}
+/** Owns the process-wide user context runtime shared by every agent and workspace. */
+export declare class UserContextRuntimeRegistry {
+    private runtime?;
+    getOrCreate(config: Config): UserContextRuntime;
+    clear(): Promise<void>;
+}

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

@@ -0,0 +1,36 @@
+import { createLogger } from "../utils/logger/index.js";
+import { init_logger } from "../utils/logger.js";
+import { init_paths, resolveUserDir } from "../config/paths.js";
+import { resolveBuiltinMemoryStoreConfig } from "../agent/memory/memory-config.js";
+import { BuiltinMemoryStore } from "../agent/memory/builtin-memory-store.js";
+import { createMemoryManagerFromConfig } from "../agent/memory/create-memory-manager.js";
+//#region src/user-context/runtime.ts
+init_paths();
+init_logger();
+const log = createLogger("UserContextRuntimeRegistry");
+/** Owns the process-wide user context runtime shared by every agent and workspace. */
+var UserContextRuntimeRegistry = class {
+	runtime;
+	getOrCreate(config) {
+		if (this.runtime) return this.runtime;
+		const userContextRoot = resolveUserDir();
+		const builtinMemoryStore = new BuiltinMemoryStore(resolveBuiltinMemoryStoreConfig(userContextRoot, config));
+		this.runtime = {
+			builtinMemoryStore,
+			memoryManager: createMemoryManagerFromConfig(userContextRoot, builtinMemoryStore, config)
+		};
+		return this.runtime;
+	}
+	async clear() {
+		const runtime = this.runtime;
+		this.runtime = void 0;
+		if (!runtime) return;
+		await runtime.memoryManager.shutdownAll().catch((err) => {
+			log.warn({ err }, "Shared memory manager shutdown failed");
+		});
+	}
+};
+//#endregion
+export { UserContextRuntimeRegistry };
+
+//# sourceMappingURL=runtime.js.map

package/dist/src/user-context/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","names":[],"sources":["../../../src/user-context/runtime.ts"],"sourcesContent":["import type { Config } from '../config/schema.js';\nimport { resolveUserDir } from '../config/paths.js';\nimport { BuiltinMemoryStore } from '../agent/memory/builtin-memory-store.js';\nimport { createMemoryManagerFromConfig } from '../agent/memory/create-memory-manager.js';\nimport { resolveBuiltinMemoryStoreConfig } from '../agent/memory/memory-config.js';\nimport type { MemoryManager } from '../agent/memory/manager.js';\nimport { createLogger } from '../utils/logger.js';\n\nconst log = createLogger('UserContextRuntimeRegistry');\n\nexport interface UserContextRuntime {\n  builtinMemoryStore: BuiltinMemoryStore;\n  memoryManager: MemoryManager;\n}\n\n/** Owns the process-wide user context runtime shared by every agent and workspace. */\nexport class UserContextRuntimeRegistry {\n  private runtime?: UserContextRuntime;\n\n  getOrCreate(config: Config): UserContextRuntime {\n    if (this.runtime) return this.runtime;\n    const userContextRoot = resolveUserDir();\n    const builtinMemoryStore = new BuiltinMemoryStore(\n      resolveBuiltinMemoryStoreConfig(userContextRoot, config),\n    );\n    this.runtime = {\n      builtinMemoryStore,\n      memoryManager: createMemoryManagerFromConfig(userContextRoot, builtinMemoryStore, config),\n    };\n    return this.runtime;\n  }\n\n  async clear(): Promise<void> {\n    const runtime = this.runtime;\n    this.runtime = undefined;\n    if (!runtime) return;\n    await runtime.memoryManager.shutdownAll().catch((err) => {\n      log.warn({ err }, 'Shared memory manager shutdown failed');\n    });\n  }\n}\n"],"mappings":";;;;;;;YACoD;aAKF;AAElD,MAAM,MAAM,aAAa,6BAA6B;;AAQtD,IAAa,6BAAb,MAAwC;CACtC;CAEA,YAAY,QAAoC;AAC9C,MAAI,KAAK,QAAS,QAAO,KAAK;EAC9B,MAAM,kBAAkB,gBAAgB;EACxC,MAAM,qBAAqB,IAAI,mBAC7B,gCAAgC,iBAAiB,OAAO,CACzD;AACD,OAAK,UAAU;GACb;GACA,eAAe,8BAA8B,iBAAiB,oBAAoB,OAAO;GAC1F;AACD,SAAO,KAAK;;CAGd,MAAM,QAAuB;EAC3B,MAAM,UAAU,KAAK;AACrB,OAAK,UAAU,KAAA;AACf,MAAI,CAAC,QAAS;AACd,QAAM,QAAQ,cAAc,aAAa,CAAC,OAAO,QAAQ;AACvD,OAAI,KAAK,EAAE,KAAK,EAAE,wCAAwC;IAC1D"}

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

@@ -0,0 +1,11 @@
+import type { Config } from '../config/schema.js';
+import type { WorkContextSnapshot, WorkDiscoveryResult } from './types.js';
+export declare function analyzeWorkContext(input: {
+    config: Config;
+    snapshot: WorkContextSnapshot;
+    signal?: AbortSignal;
+}): Promise<{
+    modelRef: string;
+    result: WorkDiscoveryResult;
+}>;
+export declare function workDiscoveryResultMarkdown(result: WorkDiscoveryResult): string;

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

@@ -0,0 +1,171 @@
+import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
+import { init_providers, resolveModel } from "../providers/index.js";
+import { completeWithResolvedCredentials } from "../providers/model-call.js";
+import { randomUUID } from "node:crypto";
+//#region src/work-discovery/analyzer.ts
+init_schema();
+init_providers();
+const MAX_MODEL_CONTEXT_CHARS = 12e4;
+function extractText(content) {
+	if (typeof content === "string") return content;
+	if (!Array.isArray(content)) return "";
+	return content.map((part) => {
+		if (!part || typeof part !== "object") return "";
+		const value = part;
+		return value.type === "text" && typeof value.text === "string" ? value.text : "";
+	}).join("");
+}
+function parseJson(raw) {
+	const fenced = /```(?:json)?\s*([\s\S]*?)```/i.exec(raw)?.[1];
+	const start = raw.indexOf("{");
+	const end = raw.lastIndexOf("}");
+	const candidate = fenced ?? (start >= 0 && end > start ? raw.slice(start, end + 1) : raw);
+	try {
+		const value = JSON.parse(candidate);
+		return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+	} catch {
+		return null;
+	}
+}
+function strings(value, max) {
+	return Array.isArray(value) ? value.filter((item) => typeof item === "string" && item.trim().length > 0).slice(0, max).map((item) => item.trim()) : [];
+}
+function validateSuggestion(value, allowedPaths) {
+	if (!value || typeof value !== "object") return null;
+	const item = value;
+	if (typeof item.title !== "string" || !item.title.trim()) return null;
+	if (typeof item.rationale !== "string" || !item.rationale.trim()) return null;
+	if (typeof item.actionPrompt !== "string" || !item.actionPrompt.trim()) return null;
+	const confidence = item.confidence === "high" || item.confidence === "medium" || item.confidence === "low" ? item.confidence : "medium";
+	const evidence = Array.isArray(item.evidence) ? item.evidence.flatMap((raw) => {
+		if (!raw || typeof raw !== "object") return [];
+		const candidate = raw;
+		if (typeof candidate.observation !== "string" || !candidate.observation.trim()) return [];
+		const path = typeof candidate.path === "string" && allowedPaths.has(candidate.path) ? candidate.path : void 0;
+		return [{
+			...path ? { path } : {},
+			observation: candidate.observation.trim().slice(0, 500)
+		}];
+	}).slice(0, 4) : [];
+	if (evidence.length === 0) return null;
+	return {
+		id: randomUUID(),
+		title: item.title.trim().slice(0, 120),
+		rationale: item.rationale.trim().slice(0, 600),
+		evidence,
+		actionPrompt: item.actionPrompt.trim().slice(0, 2e3),
+		confidence
+	};
+}
+function snapshotForModel(snapshot) {
+	let remaining = MAX_MODEL_CONTEXT_CHARS;
+	return {
+		...snapshot,
+		structure: {
+			...snapshot.structure,
+			sampledPaths: snapshot.structure.sampledPaths.slice(0, 200),
+			metadataOnlyFiles: snapshot.structure.metadataOnlyFiles.slice(0, 200)
+		},
+		documents: snapshot.documents.flatMap((document) => {
+			if (remaining <= 0) return [];
+			const excerpt = document.excerpt.slice(0, remaining);
+			remaining -= excerpt.length;
+			return [{
+				...document,
+				excerpt,
+				truncated: document.truncated || excerpt.length < document.excerpt.length
+			}];
+		})
+	};
+}
+function lowConfidenceResult(snapshot, question) {
+	return {
+		projectSummary: snapshot.root.projectKind === "coding" ? `${snapshot.root.displayName} appears to be a software project.` : `${snapshot.root.displayName} is a local work folder.`,
+		currentState: snapshot.git?.changedPaths.length ? `${snapshot.git.changedPaths.length} changed paths were detected, but there was not enough reliable context to recommend work.` : "There was not enough recent, readable context to determine the current objective.",
+		uncertainties: ["The current objective is not explicit in the selected files."],
+		suggestions: [],
+		lowConfidence: true,
+		contextQuestion: question ?? "What are you trying to move forward in this folder?"
+	};
+}
+async function analyzeWorkContext(input) {
+	const modelRef = getAgentDefaultModelRef(input.config);
+	if (!modelRef) throw new Error("No default model configured");
+	if (input.snapshot.documents.length === 0 && !input.snapshot.git?.changedPaths.length) return {
+		modelRef,
+		result: lowConfidenceResult(input.snapshot)
+	};
+	const model = resolveModel(modelRef);
+	const compactSnapshot = snapshotForModel(input.snapshot);
+	const parsed = parseJson(extractText((await completeWithResolvedCredentials(model, { messages: [{
+		role: "user",
+		content: [
+			"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, lowConfidence, and contextQuestion.",
+			"For a normal result, suggestions must contain exactly 3 materially different next steps.",
+			"Each suggestion must include title, rationale, evidence, actionPrompt, and confidence (high, medium, or low).",
+			"Each evidence item contains an optional exact relative path from the snapshot and one concrete observation.",
+			"actionPrompt asks the assistant to investigate or continue the step; it does not silently authorize file changes.",
+			"If the current objective is unclear or fewer than three credible suggestions exist, set lowConfidence=true, return suggestions=[], and ask one concise contextQuestion.",
+			"Use Simplified Chinese for every user-facing string when the visible snapshot documents are mainly Chinese; otherwise use English.",
+			"",
+			JSON.stringify(compactSnapshot)
+		].join("\n"),
+		timestamp: Date.now()
+	}] }, {
+		maxTokens: 2500,
+		temperature: .1,
+		signal: input.signal
+	})).content));
+	if (!parsed) throw new Error("Analysis did not return valid JSON");
+	if (parsed.lowConfidence === true) return {
+		modelRef,
+		result: lowConfidenceResult(input.snapshot, typeof parsed.contextQuestion === "string" ? parsed.contextQuestion.trim().slice(0, 500) : void 0)
+	};
+	const allowedPaths = new Set([
+		...input.snapshot.structure.sampledPaths,
+		...input.snapshot.documents.map((document) => document.relativePath),
+		...input.snapshot.git?.changedPaths ?? []
+	]);
+	const suggestions = Array.isArray(parsed.suggestions) ? parsed.suggestions.map((value) => validateSuggestion(value, allowedPaths)).filter((value) => Boolean(value)) : [];
+	if (suggestions.length !== 3) return {
+		modelRef,
+		result: lowConfidenceResult(input.snapshot)
+	};
+	const projectSummary = typeof parsed.projectSummary === "string" ? parsed.projectSummary.trim() : "";
+	const currentState = typeof parsed.currentState === "string" ? parsed.currentState.trim() : "";
+	if (!projectSummary || !currentState) throw new Error("Analysis result is missing its summary");
+	return {
+		modelRef,
+		result: {
+			projectSummary: projectSummary.slice(0, 1200),
+			currentState: currentState.slice(0, 1200),
+			uncertainties: strings(parsed.uncertainties, 6).map((value) => value.slice(0, 500)),
+			suggestions
+		}
+	};
+}
+function workDiscoveryResultMarkdown(result) {
+	const lines = [
+		`## What I found`,
+		"",
+		result.projectSummary,
+		"",
+		result.currentState
+	];
+	if (result.lowConfidence) {
+		if (result.contextQuestion) lines.push("", `**${result.contextQuestion}**`);
+		return lines.join("\n");
+	}
+	lines.push("", "## Suggested next steps");
+	for (const [index, suggestion] of result.suggestions.entries()) {
+		lines.push("", `### ${index + 1}. ${suggestion.title}`, "", suggestion.rationale, "");
+		for (const evidence of suggestion.evidence) lines.push(`- ${evidence.path ? `\`${evidence.path}\`: ` : ""}${evidence.observation}`);
+	}
+	return lines.join("\n");
+}
+//#endregion
+export { analyzeWorkContext, workDiscoveryResultMarkdown };
+
+//# sourceMappingURL=analyzer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.js","names":[],"sources":["../../../src/work-discovery/analyzer.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport type { UserMessage } from '@earendil-works/pi-ai/compat';\n\nimport type { Config } from '../config/schema.js';\nimport { getAgentDefaultModelRef } from '../config/schema.js';\nimport { completeWithResolvedCredentials } from '../providers/model-call.js';\nimport { resolveModel } from '../providers/index.js';\n\nimport type {\n  WorkContextSnapshot,\n  WorkDiscoveryResult,\n  WorkDiscoverySuggestion,\n} from './types.js';\n\nconst MAX_MODEL_CONTEXT_CHARS = 120_000;\n\nfunction extractText(content: unknown): string {\n  if (typeof content === 'string') return content;\n  if (!Array.isArray(content)) return '';\n  return content.map((part) => {\n    if (!part || typeof part !== 'object') return '';\n    const value = part as { type?: unknown; text?: unknown };\n    return value.type === 'text' && typeof value.text === 'string' ? value.text : '';\n  }).join('');\n}\n\nfunction parseJson(raw: string): Record<string, unknown> | null {\n  const fenced = /```(?:json)?\\s*([\\s\\S]*?)```/i.exec(raw)?.[1];\n  const start = raw.indexOf('{');\n  const end = raw.lastIndexOf('}');\n  const candidate = fenced ?? (start >= 0 && end > start ? raw.slice(start, end + 1) : raw);\n  try {\n    const value = JSON.parse(candidate) as unknown;\n    return value && typeof value === 'object' && !Array.isArray(value)\n      ? value as Record<string, unknown>\n      : null;\n  } catch {\n    return null;\n  }\n}\n\nfunction strings(value: unknown, max: number): string[] {\n  return Array.isArray(value)\n    ? value.filter((item): item is string => typeof item === 'string' && item.trim().length > 0)\n      .slice(0, max)\n      .map((item) => item.trim())\n    : [];\n}\n\nfunction validateSuggestion(value: unknown, allowedPaths: Set<string>): WorkDiscoverySuggestion | null {\n  if (!value || typeof value !== 'object') return null;\n  const item = value as Record<string, unknown>;\n  if (typeof item.title !== 'string' || !item.title.trim()) return null;\n  if (typeof item.rationale !== 'string' || !item.rationale.trim()) return null;\n  if (typeof item.actionPrompt !== 'string' || !item.actionPrompt.trim()) return null;\n  const confidence = item.confidence === 'high' || item.confidence === 'medium' || item.confidence === 'low'\n    ? item.confidence\n    : 'medium';\n  const evidence = Array.isArray(item.evidence)\n    ? item.evidence.flatMap((raw) => {\n      if (!raw || typeof raw !== 'object') return [];\n      const candidate = raw as Record<string, unknown>;\n      if (typeof candidate.observation !== 'string' || !candidate.observation.trim()) return [];\n      const path = typeof candidate.path === 'string' && allowedPaths.has(candidate.path)\n        ? candidate.path\n        : undefined;\n      return [{ ...(path ? { path } : {}), observation: candidate.observation.trim().slice(0, 500) }];\n    }).slice(0, 4)\n    : [];\n  if (evidence.length === 0) return null;\n  return {\n    id: randomUUID(),\n    title: item.title.trim().slice(0, 120),\n    rationale: item.rationale.trim().slice(0, 600),\n    evidence,\n    actionPrompt: item.actionPrompt.trim().slice(0, 2_000),\n    confidence,\n  };\n}\n\nfunction snapshotForModel(snapshot: WorkContextSnapshot): WorkContextSnapshot {\n  let remaining = MAX_MODEL_CONTEXT_CHARS;\n  return {\n    ...snapshot,\n    structure: {\n      ...snapshot.structure,\n      sampledPaths: snapshot.structure.sampledPaths.slice(0, 200),\n      metadataOnlyFiles: snapshot.structure.metadataOnlyFiles.slice(0, 200),\n    },\n    documents: snapshot.documents.flatMap((document) => {\n      if (remaining <= 0) return [];\n      const excerpt = document.excerpt.slice(0, remaining);\n      remaining -= excerpt.length;\n      return [{ ...document, excerpt, truncated: document.truncated || excerpt.length < document.excerpt.length }];\n    }),\n  };\n}\n\nfunction lowConfidenceResult(snapshot: WorkContextSnapshot, question?: string): WorkDiscoveryResult {\n  return {\n    projectSummary: snapshot.root.projectKind === 'coding'\n      ? `${snapshot.root.displayName} appears to be a software project.`\n      : `${snapshot.root.displayName} is a local work folder.`,\n    currentState: snapshot.git?.changedPaths.length\n      ? `${snapshot.git.changedPaths.length} changed paths were detected, but there was not enough reliable context to recommend work.`\n      : 'There was not enough recent, readable context to determine the current objective.',\n    uncertainties: ['The current objective is not explicit in the selected files.'],\n    suggestions: [],\n    lowConfidence: true,\n    contextQuestion: question ?? 'What are you trying to move forward in this folder?',\n  };\n}\n\nexport async function analyzeWorkContext(input: {\n  config: Config;\n  snapshot: WorkContextSnapshot;\n  signal?: AbortSignal;\n}): Promise<{ modelRef: string; result: WorkDiscoveryResult }> {\n  const modelRef = getAgentDefaultModelRef(input.config);\n  if (!modelRef) throw new Error('No default model configured');\n  if (input.snapshot.documents.length === 0 && !input.snapshot.git?.changedPaths.length) {\n    return { modelRef, result: lowConfidenceResult(input.snapshot) };\n  }\n\n  const model = resolveModel(modelRef);\n  const compactSnapshot = snapshotForModel(input.snapshot);\n  const prompt = [\n    'You help a user resume real work in one explicitly selected local folder.',\n    'Analyze only the supplied bounded snapshot. Never claim that you ran commands, tests, or inspected anything absent from it.',\n    'Return only one JSON object with projectSummary, currentState, uncertainties, suggestions, lowConfidence, and contextQuestion.',\n    'For a normal result, suggestions must contain exactly 3 materially different next steps.',\n    'Each suggestion must include title, rationale, evidence, actionPrompt, and confidence (high, medium, or low).',\n    'Each evidence item contains an optional exact relative path from the snapshot and one concrete observation.',\n    'actionPrompt asks the assistant to investigate or continue the step; it does not silently authorize file changes.',\n    'If the current objective is unclear or fewer than three credible suggestions exist, set lowConfidence=true, return suggestions=[], and ask one concise contextQuestion.',\n    'Use Simplified Chinese for every user-facing string when the visible snapshot documents are mainly Chinese; otherwise use English.',\n    '',\n    JSON.stringify(compactSnapshot),\n  ].join('\\n');\n  const message: UserMessage = { role: 'user', content: prompt, timestamp: Date.now() };\n  const response = await completeWithResolvedCredentials(model, { messages: [message] }, {\n    maxTokens: 2_500,\n    temperature: 0.1,\n    signal: input.signal,\n  });\n  const parsed = parseJson(extractText(response.content));\n  if (!parsed) throw new Error('Analysis did not return valid JSON');\n\n  const lowConfidence = parsed.lowConfidence === true;\n  if (lowConfidence) {\n    return {\n      modelRef,\n      result: lowConfidenceResult(\n        input.snapshot,\n        typeof parsed.contextQuestion === 'string' ? parsed.contextQuestion.trim().slice(0, 500) : undefined,\n      ),\n    };\n  }\n\n  const allowedPaths = new Set([\n    ...input.snapshot.structure.sampledPaths,\n    ...input.snapshot.documents.map((document) => document.relativePath),\n    ...(input.snapshot.git?.changedPaths ?? []),\n  ]);\n  const suggestions = Array.isArray(parsed.suggestions)\n    ? parsed.suggestions.map((value) => validateSuggestion(value, allowedPaths)).filter((value): value is WorkDiscoverySuggestion => Boolean(value))\n    : [];\n  if (suggestions.length !== 3) return { modelRef, result: lowConfidenceResult(input.snapshot) };\n  const projectSummary = typeof parsed.projectSummary === 'string' ? parsed.projectSummary.trim() : '';\n  const currentState = typeof parsed.currentState === 'string' ? parsed.currentState.trim() : '';\n  if (!projectSummary || !currentState) throw new Error('Analysis result is missing its summary');\n  return {\n    modelRef,\n    result: {\n      projectSummary: projectSummary.slice(0, 1_200),\n      currentState: currentState.slice(0, 1_200),\n      uncertainties: strings(parsed.uncertainties, 6).map((value) => value.slice(0, 500)),\n      suggestions,\n    },\n  };\n}\n\nexport function workDiscoveryResultMarkdown(result: WorkDiscoveryResult): string {\n  const lines = [`## What I found`, '', result.projectSummary, '', result.currentState];\n  if (result.lowConfidence) {\n    if (result.contextQuestion) lines.push('', `**${result.contextQuestion}**`);\n    return lines.join('\\n');\n  }\n  lines.push('', '## Suggested next steps');\n  for (const [index, suggestion] of result.suggestions.entries()) {\n    lines.push('', `### ${index + 1}. ${suggestion.title}`, '', suggestion.rationale, '');\n    for (const evidence of suggestion.evidence) {\n      lines.push(`- ${evidence.path ? `\\`${evidence.path}\\`: ` : ''}${evidence.observation}`);\n    }\n  }\n  return lines.join('\\n');\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,5 @@
+export * from './types.js';
+export * from './repository.js';
+export * from './probe.js';
+export * from './analyzer.js';
+export * from './service.js';

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

@@ -0,0 +1,5 @@
+import { WORK_DISCOVERY_SCAN_POLICY_VERSION, canonicalWorkDiscoveryRoot, previewWorkDiscoveryRoot, probeWorkDiscoveryRoot, summarizeWorkContextSnapshot } from "./probe.js";
+import { analyzeWorkContext, workDiscoveryResultMarkdown } from "./analyzer.js";
+import { createWorkDiscoveryRun, getWorkDiscoveryOnboardingState, getWorkDiscoveryRun, getWorkDiscoveryRunByIdempotencyKey, setWorkDiscoveryOnboardingState, updateWorkDiscoveryRun } from "./repository.js";
+import { WorkDiscoveryService } from "./service.js";
+export { WORK_DISCOVERY_SCAN_POLICY_VERSION, WorkDiscoveryService, analyzeWorkContext, canonicalWorkDiscoveryRoot, createWorkDiscoveryRun, getWorkDiscoveryOnboardingState, getWorkDiscoveryRun, getWorkDiscoveryRunByIdempotencyKey, previewWorkDiscoveryRoot, probeWorkDiscoveryRoot, setWorkDiscoveryOnboardingState, summarizeWorkContextSnapshot, updateWorkDiscoveryRun, workDiscoveryResultMarkdown };