@xopcai/xopc 0.0.217 → 0.0.218

package/dist/src/connectors/learning-coordinator.js

@@ -14,11 +14,14 @@ import { createUnderstandingSourceRun, listUnderstandingSourceRuns, updateUnders
 import { ConnectedUnderstandingPipeline } from "../knowledge/connected-understanding-pipeline.js";
 import "../knowledge/index.js";
 import { ingestComposioConnectedSource } from "./connected-source-ingestion.js";
+import { deriveConnectedSourceUnderstanding } from "./connected-source-understanding.js";
+import { listConnectedContentCandidates, readConnectedContent } from "./content-enrichment.js";
 //#region src/connectors/learning-coordinator.ts
 init_logger();
 const log = createLogger("ConnectorLearning");
 const CONNECTED_ACCOUNT_UNAVAILABLE = "connected_account_unavailable";
 const CONNECTED_SOURCE_SYNC_FAILED = "connected_source_sync_failed";
+const CONNECTED_SOURCE_ANALYSIS_FAILED = "connected_source_analysis_failed";
 function learningFailureCode(error) {
 	const message = error instanceof Error ? error.message : String(error);
 	return message.includes("ToolRouterV2_InvalidConnectedAccountIds") || message.includes("Could not find connected account(s)") || message.includes("missing its provider identity") ? CONNECTED_ACCOUNT_UNAVAILABLE : CONNECTED_SOURCE_SYNC_FAILED;
@@ -178,6 +181,22 @@ function startConnectorLearningCoordinator(options) {
 			itemsSeen += synced.itemsSeen;
 			itemsIndexed += synced.itemsIndexed;
 		}
+		const enrichmentErrors = [];
+		if (plan.toolkit === "googledrive") {
+			const candidates = listConnectedContentCandidates({
+				agentId: job.agentId,
+				sourceInstanceId: job.sourceInstanceId,
+				limit: 5
+			});
+			if (candidates.length) {
+				const enriched = await readConnectedContent({
+					agentId: job.agentId,
+					sourceItemIds: candidates.map((candidate) => candidate.sourceItemId)
+				});
+				enrichmentErrors.push(...enriched.failed.map((failure) => failure.error));
+				itemsIndexed += enriched.completed;
+			}
+		}
 		if (listConnectorLearningJobs({
 			accountId: job.accountId,
 			limit: 100
@@ -199,22 +218,54 @@ function startConnectorLearningCoordinator(options) {
 			evidenceRefs: [`connector-account:${job.accountId}`],
 			sourceRunId: sourceRun.id
 		});
+		let semantic = {
+			created: 0,
+			focusCount: 0,
+			status: "completed"
+		};
+		try {
+			semantic = await deriveConnectedSourceUnderstanding({
+				config: options.getConfig(),
+				agentId: job.agentId,
+				sourceInstanceId: job.sourceInstanceId,
+				sourceRunId: sourceRun.id,
+				memoryManager: options.getMemoryManager()
+			});
+		} catch (error) {
+			const errorMessage = error instanceof Error ? error.message : String(error);
+			semantic = {
+				created: 0,
+				focusCount: 0,
+				status: "failed",
+				error: CONNECTED_SOURCE_ANALYSIS_FAILED
+			};
+			log.warn({
+				err: error,
+				jobId: job.id,
+				connectorId: job.connectorId
+			}, `Connected source semantic analysis failed: ${errorMessage}`);
+		}
+		const candidatesCreated = understanding.created + semantic.created + semantic.focusCount;
+		const incomplete = enrichmentErrors.length > 0 || semantic.status !== "completed";
 		const completed = updateConnectorLearningJob(job.id, {
 			status: "completed",
 			phase: "completed",
-			candidatesCreated: understanding.created,
+			candidatesCreated,
 			nextRunAt: null,
 			finished: true
 		});
 		updateUnderstandingSourceRun(sourceRun.id, {
-			status: "completed",
+			status: incomplete ? "partial" : "completed",
 			itemsSeen,
 			cursorAfter: (/* @__PURE__ */ new Date()).toISOString(),
 			completed: true,
 			metadata: {
 				...sourceRun.metadata,
 				itemsIndexed,
-				candidatesCreated: understanding.created
+				candidatesCreated,
+				semanticStatus: semantic.status,
+				...semantic.error ? { semanticError: semantic.error } : {},
+				...enrichmentErrors.length ? { enrichmentFailureCount: enrichmentErrors.length } : {}
 			}
 		});
 		updateUnderstandingSourceGrantCheckpoint(sourceRun.grantId, {
@@ -258,7 +309,7 @@ function startConnectorLearningCoordinator(options) {
 					const definition = getConnectorDefinition(job.connectorId);
 					if (definition?.runtime.type === "composio" && definition.runtime.role === "toolkit") updateUnderstandingSourceRun(ensureUnderstandingSourceRun(job, definition.runtime.toolkit, definition.displayName).id, {
 						status: "failed",
-						errorMessage,
+						errorMessage: learningFailureCode(err),
 						completed: true
 					});
 					log.warn({

package/dist/src/connectors/learning-recipes.js

@@ -43,8 +43,8 @@ const PLANS = {
 			actionId: "GMAIL_FETCH_EMAILS",
 			kind: "activity",
 			arguments: {
-				max_results: 100,
-				include_payload: false,
+				max_results: 30,
+				include_payload: true,
 				verbose: false,
 				query: "newer_than:30d -in:spam -in:trash"
 			}

package/dist/src/document-understanding/extract.d.ts

@@ -1,7 +1,7 @@
 export type DocumentExtractionResult = {
     ok: true;
     text: string;
-    kind: 'plain' | 'pdf';
+    kind: 'plain' | 'pdf' | 'office';
 } | {
     ok: false;
     reason: string;

package/dist/src/document-understanding/extract.js

@@ -1,6 +1,9 @@
 import { extname } from "node:path";
+import AdmZip from "adm-zip";
 //#region src/document-understanding/extract.ts
 const MAX_EXTRACTED_CHARS = 6e4;
+const MAX_OFFICE_XML_BYTES = 8 * 1024 * 1024;
+const MAX_OFFICE_TOTAL_XML_BYTES = 16 * 1024 * 1024;
 function truncate(text) {
 	return text.length > MAX_EXTRACTED_CHARS ? `${text.slice(0, MAX_EXTRACTED_CHARS)}\n\n[document extraction truncated ${text.length - MAX_EXTRACTED_CHARS} chars]` : text;
 }
@@ -43,11 +46,61 @@ function extractPdfText(buffer) {
 		text: truncate(text)
 	};
 }
+function decodeXmlText(value) {
+	return value.replaceAll("&amp;", "&").replaceAll("&lt;", "<").replaceAll("&gt;", ">").replaceAll("&quot;", "\"").replaceAll("&apos;", "'");
+}
+function officeXmlText(buffer, extension) {
+	let zip;
+	try {
+		zip = new AdmZip(buffer);
+	} catch {
+		return {
+			ok: false,
+			reason: "Office document archive is invalid."
+		};
+	}
+	const prefixes = extension === ".docx" ? ["word/document.xml"] : extension === ".pptx" ? ["ppt/slides/"] : ["xl/sharedStrings.xml", "xl/worksheets/"];
+	const entries = zip.getEntries().filter((entry) => !entry.isDirectory && entry.header.size <= MAX_OFFICE_XML_BYTES && prefixes.some((prefix) => entry.entryName.startsWith(prefix))).sort((left, right) => left.entryName.localeCompare(right.entryName));
+	const parts = [];
+	let extractedBytes = 0;
+	for (const entry of entries) {
+		if (extractedBytes + entry.header.size > MAX_OFFICE_TOTAL_XML_BYTES) break;
+		extractedBytes += entry.header.size;
+		const xml = entry.getData().toString("utf8");
+		for (const match of xml.matchAll(/<(?:w:t|a:t|t)(?:\s[^>]*)?>([\s\S]*?)<\/(?:w:t|a:t|t)>/g)) {
+			const text = decodeXmlText((match[1] ?? "").replace(/<[^>]+>/g, "")).trim();
+			if (text) parts.push(text);
+		}
+	}
+	const text = parts.join("\n").replace(/\n{3,}/g, "\n\n").trim();
+	return text ? {
+		ok: true,
+		kind: "office",
+		text: truncate(text)
+	} : {
+		ok: false,
+		reason: "Office document extraction found no readable text."
+	};
+}
 function extractDocumentText(params) {
 	const ext = extname(params.fileName).toLowerCase();
 	const mime = params.mimeType?.toLowerCase() ?? "";
 	if (mime === "application/pdf" || ext === ".pdf") return extractPdfText(params.buffer);
-	if (mime.startsWith("text/")) return {
+	if ([
+		".docx",
+		".pptx",
+		".xlsx"
+	].includes(ext)) return officeXmlText(params.buffer, ext);
+	if (mime.startsWith("text/") || [
+		".csv",
+		".html",
+		".json",
+		".md",
+		".rtf",
+		".tsv",
+		".txt",
+		".xml"
+	].includes(ext)) return {
 		ok: true,
 		kind: "plain",
 		text: truncate(params.buffer.toString("utf8"))

package/dist/src/extensions/lockfile.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { init_paths, resolveExtensionsDir, resolveExtensionsLockPath } from "../config/paths.js";
 import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
+import { init_paths, resolveExtensionsDir, resolveExtensionsLockPath } from "../config/paths.js";
 import { dirname, join } from "path";
 import { existsSync } from "fs";
 import { mkdir, readFile } from "fs/promises";

package/dist/src/gateway/agents-admin.js

@@ -1,7 +1,7 @@
-import { init_agent_scope, listAgentEntries, normalizeAgentId, resolveAgentDir, resolveAgentProfileDir, resolveAgentWorkspaceDir, resolveDefaultAgentId, resolveUserPath, validateAgentIdForNewAgent } from "../agent/agent-scope.js";
 import { resolveCapabilityPresetLayer, resolveEffectiveAgentManifest } from "../agent-manifest/resolver.js";
-import { resolveEffectiveAgentProfile } from "../config/agent-profile.js";
+import { init_agent_scope, listAgentEntries, normalizeAgentId, resolveAgentDir, resolveAgentProfileDir, resolveAgentWorkspaceDir, resolveDefaultAgentId, resolveUserPath, validateAgentIdForNewAgent } from "../agent/agent-scope.js";
 import { WORKSPACE_FILES, init_paths } from "../config/paths.js";
+import { resolveEffectiveAgentProfile } from "../config/agent-profile.js";
 import { AGENT_PROFILE_MARKDOWN_SYSTEM_FILES, REQUIRED_AGENT_PROFILE_MARKDOWN_FILE_SET } from "../agent/context/workspace.js";
 import { isPathUnderWorkspace, resolveWorkspaceSafePath } from "./workspace-editor-path.js";
 import { seedAgentProfileMarkdownFiles } from "../agent/context/workspace-seed.js";

package/dist/src/gateway/file-path-classifier.js

@@ -1,7 +1,7 @@
 import { init_paths_state, resolveStateDir } from "../config/paths-state.js";
 import { init_agent_scope, resolveAgentProfileDir } from "../agent/agent-scope.js";
-import { extractProfileAgentId } from "../config/agent-profile.js";
 import { init_paths, resolveConfigPath, resolveSkillsDir } from "../config/paths.js";
+import { extractProfileAgentId } from "../config/agent-profile.js";
 import { isBareProfileMarkdownFileName, resolveProfileMarkdownPathIfBareName } from "../agent/tools/tool-paths.js";
 import { isPathUnderWorkspace, resolveWorkspaceSafePath } from "./workspace-editor-path.js";
 import { basename, isAbsolute, resolve } from "node:path";

package/dist/src/gateway/heartbeat/service.js

@@ -1,9 +1,9 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { shouldSilence, stripHeartbeatToken } from "../../heartbeat/tokens.js";
-import { appendCronEventLines } from "../../heartbeat/event-prompt.js";
 import { isWithinActiveHours } from "../../heartbeat/active-hours.js";
 import { isHeartbeatContentEmpty } from "../../heartbeat/content-check.js";
+import { appendCronEventLines } from "../../heartbeat/event-prompt.js";
 import { createHeartbeatWake } from "../../heartbeat/wake.js";
 import { resolveHeartbeatMdPath } from "../workspace-heartbeat-path.js";
 import { readFile } from "fs/promises";

package/dist/src/gateway/hono/lib/config-payload.js

@@ -1,9 +1,9 @@
 import { ContextCompactionPolicySchema, UserContextDreamingSchema, UserContextPrivacySchema, init_config } from "../../../user-context/config.js";
 import { init_agent_scope, listAgentEntries, normalizeAgentId, resolveDefaultAgentId } from "../../../agent/agent-scope.js";
 import { resolveModelsJsonPath } from "../../../config/paths.js";
-import { buildChannelCatalogForConfig, buildChannelCatalogFromSnapshot, getChannelSetupStatus, init_channel_catalog_service } from "../../../channels/catalog/channel-catalog-service.js";
 import { init_models_json, loadModelsJson } from "../../../config/models-json.js";
 import { CredentialResolver, init_credentials } from "../../../auth/credentials.js";
+import { buildChannelCatalogForConfig, buildChannelCatalogFromSnapshot, getChannelSetupStatus, init_channel_catalog_service } from "../../../channels/catalog/channel-catalog-service.js";
 import { getProviderRegistry, init_plugin_registry } from "../../../providers/plugin-registry.js";
 import { getAllProviders, init_providers, isProviderConfigured } from "../../../providers/index.js";
 import { normalizeConfiguredMcpServers } from "../../../config/mcp-config-normalize.js";

package/dist/src/gateway/hono/routes/models.js

@@ -1,5 +1,5 @@
-import { resolveModelsJsonPath } from "../../../config/paths.js";
 import { init_resolve_config_value, testApiKeyResolution } from "../../../config/resolve-config-value.js";
+import { resolveModelsJsonPath } from "../../../config/paths.js";
 import { init_models_json, loadModelsJson, saveModelsJson, validateModelsConfig } from "../../../config/models-json.js";
 import { getModelCatalogStore, init_model_catalog_store } from "../../../providers/model-catalog-store.js";
 import { getModelRegistry } from "../../../providers/model-registry.js";

package/dist/src/gateway/hono/routes/understanding-sources.js

@@ -2,7 +2,7 @@ import { deleteUnderstanding, listUnderstandingEvidence, listUnderstandings } fr
 import { getConnectorAccount } from "../../../storage/sqlite/connector-account-repository.js";
 import "../../../storage/sqlite/index.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../../../agent/agent-scope.js";
-import { deleteUserFocus, getUnderstandingSourceGrant, listUnderstandingSourceGrants, listUserFocuses, revokeUnderstandingSourceGrant, setUserFocusStatus } from "../../../user-context/sources/repository.js";
+import { deleteUserFocus, getUnderstandingSourceGrant, listUnderstandingSourceGrants, listUnderstandingSourceRuns, listUserFocuses, revokeUnderstandingSourceGrant, setUserFocusStatus } from "../../../user-context/sources/repository.js";
 import { listConnectedContentCandidates, readConnectedContent } from "../../../connectors/content-enrichment.js";
 import { getWorkDiscoveryService } from "./work-discovery.js";
 import { listUnderstandingSourceDefinitions } from "../../../user-context/sources/catalog.js";
@@ -38,10 +38,17 @@ function registerUnderstandingSourceRoutes(authenticated, deps) {
 			sources: listUnderstandingSourceDefinitions(platform)
 		});
 	});
-	authenticated.get("/api/understanding/sources/grants", (c) => c.json({
-		ok: true,
-		grants: listUnderstandingSourceGrants({ includeRevoked: c.req.query("includeRevoked") === "true" })
-	}));
+	authenticated.get("/api/understanding/sources/grants", (c) => {
+		const grants = listUnderstandingSourceGrants({ includeRevoked: c.req.query("includeRevoked") === "true" });
+		return c.json({
+			ok: true,
+			grants,
+			latestRuns: Object.fromEntries(grants.flatMap((grant) => {
+				const run = listUnderstandingSourceRuns(grant.id, 1)[0];
+				return run ? [[grant.id, run]] : [];
+			}))
+		});
+	});
 	authenticated.get("/api/understanding/sources/content-candidates", (c) => {
 		const agentId = resolveDefaultAgentId(deps.service.currentConfig);
 		return c.json({
@@ -71,14 +78,25 @@ function registerUnderstandingSourceRoutes(authenticated, deps) {
 	authenticated.delete("/api/understanding/sources/grants/:grantId", limited, (c) => {
 		const current = getUnderstandingSourceGrant(c.req.param("grantId"));
 		const accountId = typeof current?.config.accountId === "string" ? current.config.accountId : void 0;
+		const connectorId = typeof current?.config.connectorId === "string" ? current.config.connectorId : void 0;
+		const sourceInstanceId = accountId && connectorId ? `composio:${connectorId}:${accountId}` : void 0;
 		const connectionId = accountId ? getConnectorAccount(accountId)?.currentConnectionId : void 0;
 		if (connectionId) deps.service.setConnectorLearningPaused(connectionId, true);
 		const grant = revokeUnderstandingSourceGrant(c.req.param("grantId"));
 		if (grant && c.req.query("deleteDerived") === "true") {
 			const activeGrantIds = new Set(listUnderstandingSourceGrants().map((item) => item.id));
+			const activeSourceInstanceIds = new Set(listUnderstandingSourceGrants().flatMap((item) => {
+				const activeAccountId = typeof item.config.accountId === "string" ? item.config.accountId : void 0;
+				const activeConnectorId = typeof item.config.connectorId === "string" ? item.config.connectorId : void 0;
+				return activeAccountId && activeConnectorId ? [`composio:${activeConnectorId}:${activeAccountId}`] : [];
+			}));
 			for (const understanding of listUnderstandings()) {
-				const grantEvidence = listUnderstandingEvidence(understanding.id).map((evidence) => /^understanding-source-grant:([^:]+):/.exec(evidence.sourceRef)?.[1]).filter((id) => Boolean(id));
-				if (grantEvidence.includes(grant.id) && !grantEvidence.some((id) => id !== grant.id && activeGrantIds.has(id))) deleteUnderstanding(understanding.id);
+				const evidence = listUnderstandingEvidence(understanding.id);
+				const grantEvidence = evidence.map((evidence) => /^understanding-source-grant:([^:]+):/.exec(evidence.sourceRef)?.[1]).filter((id) => Boolean(id));
+				const connectorEvidence = evidence.map((item) => item.sourceInstanceId).filter((id) => Boolean(id));
+				const belongsToRevokedSource = grantEvidence.includes(grant.id) || Boolean(sourceInstanceId && connectorEvidence.includes(sourceInstanceId));
+				const hasActiveAlternative = grantEvidence.some((id) => id !== grant.id && activeGrantIds.has(id)) || connectorEvidence.some((id) => id !== sourceInstanceId && activeSourceInstanceIds.has(id));
+				if (belongsToRevokedSource && !hasActiveAlternative) deleteUnderstanding(understanding.id);
 			}
 		}
 		return grant ? c.json({

package/dist/src/gateway/hono/routes/workflows.js

@@ -7,10 +7,10 @@ import { messagesToClientHistory } from "../../../session/client-history.js";
 import "../../../workflows/domain/index.js";
 import { resolveWorkflowRunArtifactsDir } from "../../../workflows/store/paths.js";
 import { WorkflowDraftService } from "../../../workflows/draft/workflow-draft-service.js";
-import { WorkflowDraftConflictError, WorkflowDraftStore } from "../../../workflows/authoring/workflow-draft-store.js";
-import "../../../workflows/authoring/index.js";
 import "../../../workflows/draft/index.js";
 import { ProjectWorkflowPresetRepository } from "../../../workflows/project-presets/project-workflow-preset-repository.js";
+import { WorkflowDraftConflictError, WorkflowDraftStore } from "../../../workflows/authoring/workflow-draft-store.js";
+import "../../../workflows/authoring/index.js";
 import { basename, join } from "node:path";
 import { readFile, stat } from "node:fs/promises";
 //#region src/gateway/hono/routes/workflows.ts

package/dist/src/gateway/rate-limit/buckets.d.ts

@@ -50,7 +50,7 @@ declare class BucketRegistry {
      * config read.
      */
     authFailure(cfg: ResolvedAuthRateLimitConfig): FailureLimiter;
-    /** Sensitive admin / mutation endpoints — 15 req / 60 s per client IP. */
+    /** Authenticated admin / mutation endpoints — 150 req / 60 s per client IP. */
     strictApi(): RateLimiter;
     /** Interactive chat actions — 180 req / 60 s per client IP. */
     chatApi(): RateLimiter;

package/dist/src/gateway/rate-limit/buckets.js

@@ -75,10 +75,10 @@ var BucketRegistry = class {
 		}
 		return this.authFailureLimiter;
 	}
-	/** Sensitive admin / mutation endpoints — 15 req / 60 s per client IP. */
+	/** Authenticated admin / mutation endpoints — 150 req / 60 s per client IP. */
 	strictApi() {
 		if (!this.strictApiLimiter) this.strictApiLimiter = new RateLimiter({
-			maxRequests: 15,
+			maxRequests: 150,
 			windowMs: 6e4
 		});
 		return this.strictApiLimiter;

package/dist/src/gateway/service/config-coordinator.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { loadConfig, saveConfig } from "../../config/loader.js";
 import { getModelRegistry } from "../../providers/model-registry.js";
+import { loadConfig, saveConfig } from "../../config/loader.js";
 import { init_providers } from "../../providers/index.js";
 import { disposeAllSessionMcpRuntimes } from "../../agent/mcp/bundle-mcp-runtime.js";
 import { reloadImageGenerationProviders } from "../../agent/image/generation/provider-registry.js";

package/dist/src/gateway/service.js

@@ -9,14 +9,14 @@ import { closeXopcDatabase, openXopcDatabase } from "../storage/sqlite/connectio
 import "../storage/sqlite/index.js";
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
 import { init_agent_scope, listAgentEntries, normalizeAgentId, resolveDefaultAgentId } from "../agent/agent-scope.js";
-import { buildSessionKey, init_session_key, sanitizeSegment } from "../routing/session-key.js";
-import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 import { init_paths, resolveAgentDir, resolveConfigPath, resolveExtensionsDir } from "../config/paths.js";
+import { prewarmModelRegistry } from "../providers/model-registry.js";
 import { areExtensionsGloballyDisabled } from "../extensions/discover-extensions.js";
 import { buildExtensionMetadataSnapshot } from "../extensions/extension-metadata-snapshot.js";
 import { buildChannelCatalogForConfig, buildChannelCatalogFromSnapshot, init_channel_catalog_service } from "../channels/catalog/channel-catalog-service.js";
 import { loadConfig, saveConfig } from "../config/loader.js";
-import { prewarmModelRegistry } from "../providers/model-registry.js";
+import { buildSessionKey, init_session_key, sanitizeSegment } from "../routing/session-key.js";
+import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 import { init_providers, providers_exports } from "../providers/index.js";
 import { TaskRepository } from "../tasks/task-repository.js";
 import { TaskConversationRepository } from "../tasks/task-conversation-repository.js";
@@ -50,18 +50,18 @@ import { registerClarifyBridge } from "./clarify-runtime.js";
 import { ChannelManager } from "../channels/manager.js";
 import { getWorkspacePath } from "../config/workspace-path-helpers.js";
 import "../config/index.js";
-import { ManagedComposioEventPoller } from "../connectors/composio-managed-events.js";
-import { startConnectedKnowledgeCoordinator } from "../knowledge/coordinator.js";
-import "../knowledge/index.js";
-import { startConnectorLearningCoordinator } from "../connectors/learning-coordinator.js";
-import { ConnectedSourceChangePublisher } from "../connectors/source-change-publisher.js";
-import { startConnectorSupervisor } from "../connectors/supervisor.js";
 import { DiscussionService } from "../discussions/service.js";
 import { DiscussionOrganizer } from "../discussions/organizer.js";
 import { DiscussionLiveWorker } from "../discussions/live-worker.js";
 import { DiscussionOrganizerWorker } from "../discussions/organizer-worker.js";
 import { DiscussionSealer } from "../discussions/sealer.js";
 import "../discussions/index.js";
+import { ManagedComposioEventPoller } from "../connectors/composio-managed-events.js";
+import { startConnectedKnowledgeCoordinator } from "../knowledge/coordinator.js";
+import "../knowledge/index.js";
+import { startConnectorLearningCoordinator } from "../connectors/learning-coordinator.js";
+import { ConnectedSourceChangePublisher } from "../connectors/source-change-publisher.js";
+import { startConnectorSupervisor } from "../connectors/supervisor.js";
 import { EndpointToolRuntime } from "../endpoint-tools/runtime.js";
 import "../endpoint-tools/index.js";
 import { assertGatewayAuthConfigured, extractToken, resolveGatewayAuth, validateToken } from "./auth.js";

package/dist/src/heartbeat/index.js

@@ -1,6 +1,6 @@
 import { DEFAULT_ACK_MAX_CHARS, HEARTBEAT_OK, NO_REPLY, shouldSilence, stripHeartbeatToken } from "./tokens.js";
-import { appendCronEventLines } from "./event-prompt.js";
 import { isWithinActiveHours } from "./active-hours.js";
 import { isHeartbeatContentEmpty } from "./content-check.js";
+import { appendCronEventLines } from "./event-prompt.js";
 import { createHeartbeatWake } from "./wake.js";
 export { DEFAULT_ACK_MAX_CHARS, HEARTBEAT_OK, NO_REPLY, appendCronEventLines, createHeartbeatWake, isHeartbeatContentEmpty, isWithinActiveHours, shouldSilence, stripHeartbeatToken };

package/dist/src/providers/auth-runtime/resolve-auth.js

@@ -1,5 +1,5 @@
-import { init_sync_provider_auth, resolveProviderApiKeyForAgentSync } from "../../auth/sync-provider-auth.js";
 import { getApiKeyFromEnv, init_env_keys } from "../env-keys.js";
+import { init_sync_provider_auth, resolveProviderApiKeyForAgentSync } from "../../auth/sync-provider-auth.js";
 import { getDefaultAuthProfileStore } from "./auth-profile-store.js";
 //#region src/providers/auth-runtime/resolve-auth.ts
 init_env_keys();

package/dist/src/providers/index.js

@@ -1,11 +1,11 @@
 import { __esmMin, __exportAll } from "../../_virtual/_rolldown/runtime.js";
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
-import { getOAuthProviderIds, init_registry } from "../auth/oauth/registry.js";
-import { hasProviderAuthOnDiskSync, init_sync_provider_auth } from "../auth/sync-provider-auth.js";
 import { PROVIDER_ENV_MAP, getApiKeyFromEnv, init_env_keys } from "./env-keys.js";
 import { init_model_ref, splitProviderModelRef } from "./model-ref.js";
 import { ModelRegistry, getModelRegistry, init_model_registry, prewarmModelRegistry, resetModelRegistry } from "./model-registry.js";
+import { getOAuthProviderIds, init_registry } from "../auth/oauth/registry.js";
 import { CredentialResolver, hasCredentials, init_credentials } from "../auth/credentials.js";
+import { hasProviderAuthOnDiskSync, init_sync_provider_auth } from "../auth/sync-provider-auth.js";
 import { EXTENSION_PROVIDER_BASE_URL, init_constants } from "./constants.js";
 import { applyOfficialModelMetadataCorrections, getSupplementalModels, init_model_supplements } from "./model-supplements.js";
 import { getProviderRegistry, init_plugin_registry } from "./plugin-registry.js";

package/dist/src/providers/model-registry.js

@@ -1,8 +1,8 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { resolveModelsJsonPath } from "../config/paths.js";
 import { init_resolve_config_value, resolveConfigValue, resolveHeaders } from "../config/resolve-config-value.js";
+import { resolveModelsJsonPath } from "../config/paths.js";
 import { getDefaultModelValues, init_models_json, validateModelsConfig } from "../config/models-json.js";
 import { getApiKeyFromEnv, init_env_keys } from "./env-keys.js";
 import { getModelCatalogStore, init_model_catalog_store } from "./model-catalog-store.js";

package/dist/src/providers/register-runtime-providers.js

@@ -1,6 +1,6 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { getOAuthProviderDefinition, init_registry } from "../auth/oauth/registry.js";
 import { getModelCatalogStore, init_model_catalog_store } from "./model-catalog-store.js";
+import { getOAuthProviderDefinition, init_registry } from "../auth/oauth/registry.js";
 import { XOPC_CLOUD_PROVIDER_ID, init_xopc_cloud_config, resolveXopcModelRouterUrl } from "./xopc-cloud-config.js";
 //#region src/providers/register-runtime-providers.ts
 function registerRuntimeProvider(modelRuntime, source) {

package/dist/src/tui/tui-startup-resources.js

@@ -1,6 +1,6 @@
 import { resolveStateDir } from "../config/paths-state.js";
-import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { init_paths, resolveAgentProfileDir, resolveBundledSkillsDir } from "../config/paths.js";
+import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { resolveBootstrapFilesSync } from "../agent/bootstrap/bootstrap-files.js";
 import { createSkillConfigManager, isSkillEnabled } from "../agent/skills/config.js";
 import { loadSkills } from "../agent/skills/index.js";

package/dist/src/tui/tui.js

@@ -2,10 +2,10 @@ import { version } from "../../package.js";
 import { resolveStateDir, resolveXopcDatabasePath } from "../config/paths-state.js";
 import { parseAgentSessionKey } from "../routing/session-key-utils.js";
 import { init_agent_session_key, normalizeAgentId } from "../routing/agent-session-key.js";
-import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { init_paths } from "../config/paths.js";
 import { loadConfig } from "../config/loader.js";
 import { getAllModels, getAllProviders, getApiKey, init_providers, isProviderConfiguredSync } from "../providers/index.js";
+import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { ProjectTrustStore, hasTrustRequiringProjectResources } from "../project-trust/trust-store.js";
 import { renderWorkflowFinalSummary, renderWorkflowPanel } from "../agent/workflow/snapshot.js";
 import { ensureStarterAgentsInitialized } from "../agent/starter-agents.js";

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

@@ -18,7 +18,7 @@ const COMMON = [
 		category: "recent_documents",
 		platform: "all",
 		displayName: "Recent files",
-		description: "Read-only metadata for recent documents on Desktop, Documents, and Downloads.",
+		description: "Bounded text from recent readable documents on Desktop, Documents, and Downloads.",
 		availability: "available",
 		permission: "not_requested",
 		defaultAccessMode: "once",
@@ -114,6 +114,13 @@ const PLATFORM = {
 			"Recent unlocked notes selected through macOS Automation",
 			true
 		],
+		[
+			"apple-mail",
+			"mail",
+			"Apple Mail",
+			"Recent inbox and sent-message content selected through macOS Automation",
+			true
+		],
 		[
 			"apple-calendar",
 			"calendar",
@@ -138,7 +145,7 @@ const PLATFORM = {
 		permission: "not_requested",
 		defaultAccessMode: "once",
 		supportedAccessModes: ["once"],
-		recommended: category !== "notes",
+		recommended: category !== "notes" && category !== "mail",
 		sensitive: Boolean(sensitive)
 	})),
 	win32: [{

package/dist/src/user-context/sources/local-source-contract.d.ts

@@ -1,3 +1,3 @@
-export declare const LOCAL_UNDERSTANDING_SOURCE_IDS: readonly ["local-recent-files", "chromium-bookmarks", "apple-notes", "apple-calendar", "apple-reminders", "windows-recent-documents", "linux-recent-documents"];
+export declare const LOCAL_UNDERSTANDING_SOURCE_IDS: readonly ["local-recent-files", "chromium-bookmarks", "apple-notes", "apple-mail", "apple-calendar", "apple-reminders", "windows-recent-documents", "linux-recent-documents"];
 export type LocalUnderstandingSourceId = typeof LOCAL_UNDERSTANDING_SOURCE_IDS[number];
 export declare function isLocalUnderstandingSourceId(value: string): value is LocalUnderstandingSourceId;

package/dist/src/user-context/sources/local-source-contract.js

@@ -3,6 +3,7 @@ const LOCAL_UNDERSTANDING_SOURCE_IDS = [
 	"local-recent-files",
 	"chromium-bookmarks",
 	"apple-notes",
+	"apple-mail",
 	"apple-calendar",
 	"apple-reminders",
 	"windows-recent-documents",

package/dist/src/user-context/understanding-writing.d.ts

@@ -0,0 +1 @@
+export declare const USER_FACING_UNDERSTANDING_WRITING_GUIDANCE = "Write each understanding as concise, neutral profile copy that can be shown directly to the person described, not as an internal note about \"the user\". Prefer a subject-omitted predicate or noun phrase. For example, write \u201C\u503E\u5411\u4F7F\u7528 pnpm \u4F5C\u4E3A\u5305\u7BA1\u7406\u5668\u201D or \u201Cxopc \u9879\u76EE\u7684\u6838\u5FC3\u5F00\u53D1\u8005\u201D, not \u201C\u7528\u6237\u503E\u5411\u4E8E\u4F7F\u7528 pnpm\u201D or \u201C\u7528\u6237\u662F xopc \u9879\u76EE\u7684\u5F00\u53D1\u8005\u201D; write \u201CPrefers pnpm as the package manager\u201D or \u201CCore maintainer of xopc\u201D, not \u201CThe user prefers pnpm\u201D or \u201CThe user is a maintainer of xopc\u201D. Do not begin with generic subject labels or pronouns such as \u201C\u7528\u6237\u201D, \u201C\u8BE5\u7528\u6237\u201D, \u201C\u6B64\u7528\u6237\u201D, \u201C\u4F60\u201D, \u201C\u6211\u201D, \u201Cthe user\u201D, \u201Cuser\u201D, \u201Cyou\u201D, or \u201CI\u201D.";

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

@@ -0,0 +1,4 @@
+//#region src/user-context/understanding-writing.ts
+const USER_FACING_UNDERSTANDING_WRITING_GUIDANCE = `Write each understanding as concise, neutral profile copy that can be shown directly to the person described, not as an internal note about "the user". Prefer a subject-omitted predicate or noun phrase. For example, write “倾向使用 pnpm 作为包管理器” or “xopc 项目的核心开发者”, not “用户倾向于使用 pnpm” or “用户是 xopc 项目的开发者”; write “Prefers pnpm as the package manager” or “Core maintainer of xopc”, not “The user prefers pnpm” or “The user is a maintainer of xopc”. Do not begin with generic subject labels or pronouns such as “用户”, “该用户”, “此用户”, “你”, “我”, “the user”, “user”, “you”, or “I”.`;
+//#endregion
+export { USER_FACING_UNDERSTANDING_WRITING_GUIDANCE };

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

@@ -10,6 +10,11 @@ export declare function analyzeWorkContext(input: {
     modelRef: string;
     result: WorkDiscoveryResult;
 }>;
+export type UnderstandingSourceAnalysisStatus = {
+    sourceId: string;
+    status: 'completed' | 'partial' | 'failed';
+    error?: string;
+};
 export declare function analyzeUnderstandingSources(input: {
     config: Config;
     items: UnderstandingSourceItem[];
@@ -19,5 +24,6 @@ export declare function analyzeUnderstandingSources(input: {
     modelRef: string;
     profileCandidates: WorkDiscoveryProfileCandidate[];
     workThreadCandidates: WorkUnderstandingThreadCandidate[];
+    sourceStatuses: UnderstandingSourceAnalysisStatus[];
 }>;
 export declare function workDiscoveryResultMarkdown(result: WorkDiscoveryResult): string;