@xopcai/xopc 0.0.215 → 0.0.218

package/dist/src/agent/image/tool-model-config.js

@@ -1,7 +1,7 @@
 import { getAgentDefaultImageModelConfig, getAgentDefaultModelRef, init_schema, parseModelRef } from "../../config/schema.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../agent-scope.js";
-import { resolveEffectiveAgentManifestForAgent } from "../../config/agent-profile.js";
 import { getDefaultModelSync, getModelsByProvider, init_providers, isProviderConfiguredSync, resolveModel } from "../../providers/index.js";
+import { resolveEffectiveAgentManifestForAgent } from "../../config/agent-profile.js";
 import { resolveAgentModelFallbackValues, resolveAgentModelPrimaryValue } from "../../config/model-input.js";
 import { buildCapabilityPlansForConfig } from "../../capabilities/readiness/from-config.js";
 import "../../capabilities/readiness/index.js";

package/dist/src/agent/ipc/inbox.js

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

package/dist/src/agent/memory/create-memory-manager.js

@@ -1,8 +1,8 @@
+import { buildMemoryRuntime } from "../../agent-runtime/memory-runtime.js";
 import { isMemorySubsystemEnabled } from "./memory-config.js";
 import { BuiltinMemoryProvider } from "./builtin-provider.js";
 import { MemoryManager } from "./manager.js";
 import { loadMemoryPluginProviders } from "./plugin-discovery.js";
-import { buildMemoryRuntime } from "../../agent-runtime/memory-runtime.js";
 //#region src/agent/memory/create-memory-manager.ts
 function createMemoryManagerFromConfig(config) {
 	const routing = resolveMemoryManagerOptions(config);

package/dist/src/agent/service.js

@@ -3,10 +3,10 @@ import { init_logger } from "../utils/logger.js";
 import { getUserProfile } from "../storage/sqlite/user-context-repository.js";
 import { parseNoteAttachmentTarget } from "../notes/attachment-ref.js";
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
-import { applyConfigOverrides } from "../config/runtime-overrides.js";
 import { init_agent_scope, resolveAgentHomeDir, resolveDefaultAgentId } from "./agent-scope.js";
-import { extractProfileAgentId } from "../config/agent-profile.js";
 import { init_providers, resolveModel } from "../providers/index.js";
+import { applyConfigOverrides } from "../config/runtime-overrides.js";
+import { extractProfileAgentId } from "../config/agent-profile.js";
 import { extractTextContent } from "./context/workspace.js";
 import { effectiveWorkspacePathForSession } from "../session/session-workspace.js";
 import { getProjectForSession } from "../projects/workspace.js";

package/dist/src/agent/session/session-inspector.js

@@ -1,8 +1,8 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { init_workspace_defaults, resolveDefaultAgentWorkspaceDir } from "../../config/workspace-defaults.js";
-import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { init_providers, resolveModel } from "../../providers/index.js";
+import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { effectiveWorkspacePathForSession, projectWorkspacePath } from "../../session/session-workspace.js";
 import { getProjectForSession } from "../../projects/workspace.js";
 import { resolveCompactionPolicy } from "../memory/compaction-policy.js";

package/dist/src/agent/skills/hub-lock.js

@@ -1,5 +1,5 @@
-import { init_paths, resolveSkillsLockPath } from "../../config/paths.js";
 import { init_write_file_atomic, writeTextAtomicSync } from "../../infra/write-file-atomic.js";
+import { init_paths, resolveSkillsLockPath } from "../../config/paths.js";
 import { existsSync, readFileSync } from "node:fs";
 //#region src/agent/skills/hub-lock.ts
 /**

package/dist/src/agent/tasks/task-judge-service.js

@@ -1,14 +1,14 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { extractAssistantText, getAssistantMessageErrorReason, stripCodeFences } from "../../providers/model-response.js";
 import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
-import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { getApiKey, init_providers, resolveModel } from "../../providers/index.js";
+import { completeWithResolvedCredentials } from "../../providers/model-call.js";
+import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { TaskRepository } from "../../tasks/task-repository.js";
 import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
 import { TaskRunRepository } from "../../tasks/task-run-repository.js";
-import { completeWithResolvedCredentials } from "../../providers/model-call.js";
 import { TaskApplicationService } from "../../tasks/task-application-service.js";
-import { extractAssistantText, getAssistantMessageErrorReason, stripCodeFences } from "../../providers/model-response.js";
 //#region src/agent/tasks/task-judge-service.ts
 init_schema();
 init_providers();

package/dist/src/agent-runtime/index.js

@@ -1,7 +1,7 @@
-import { buildMemoryRuntime } from "./memory-runtime.js";
 import { checkBoundary } from "./boundary-guard.js";
 import { resolveModelRole } from "./model-router.js";
 import { buildRuntimeToolRegistry } from "./tool-registry.js";
+import { buildMemoryRuntime } from "./memory-runtime.js";
 import { resolveWorkflow, validateWorkflowForRuntime } from "./workflow-runtime.js";
 import { buildAgentRuntimeProfile } from "./runtime-profile.js";
 import { appendAgentRunEvent, createAgentRunTrace, finishAgentRunTrace, hashEffectiveManifest } from "./run-trace.js";

package/dist/src/agent-runtime/runtime-profile.js

@@ -1,9 +1,9 @@
 import { buildAgentManifestPromptSection } from "../agent-manifest/prompt.js";
 import "../agent-manifest/index.js";
-import { buildMemoryRuntime } from "./memory-runtime.js";
 import { checkBoundary } from "./boundary-guard.js";
 import { resolveModelRole } from "./model-router.js";
 import { buildRuntimeToolRegistry } from "./tool-registry.js";
+import { buildMemoryRuntime } from "./memory-runtime.js";
 import { resolveWorkflow, validateWorkflowForRuntime } from "./workflow-runtime.js";
 //#region src/agent-runtime/runtime-profile.ts
 function buildAgentRuntimeProfile(params) {

package/dist/src/ai-assist/text-assist.js

@@ -1,9 +1,9 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { getAssistantMessageErrorReason, stripCodeFences } from "../providers/model-response.js";
 import { getDefaultModelSync, init_providers, resolveModel } from "../providers/index.js";
 import { createExtensionAwareStreamFn } from "../providers/extension-stream-bridge.js";
 import { isLocalModelBaseUrl, resolveModelCallApiKey, resolveModelCallOptions } from "../providers/model-call.js";
-import { getAssistantMessageErrorReason, stripCodeFences } from "../providers/model-response.js";
 //#region src/ai-assist/text-assist.ts
 init_providers();
 init_logger();

package/dist/src/auth/credentials.js

@@ -1,10 +1,10 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { init_paths, resolveAgentAuthProfilesPath, resolveAuthProfilesPath, resolveCredentialsDir, resolveOAuthPath } from "../config/paths.js";
 import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
-import { getOAuthProviderDefinition, init_registry } from "./oauth/registry.js";
+import { init_paths, resolveAgentAuthProfilesPath, resolveAuthProfilesPath, resolveCredentialsDir, resolveOAuthPath } from "../config/paths.js";
 import { getApiKeyFromEnv, init_env_keys } from "../providers/env-keys.js";
+import { getOAuthProviderDefinition, init_registry } from "./oauth/registry.js";
 import { init_oauth_provider_lock, withOAuthProviderLock } from "./oauth-provider-lock.js";
 import { dirname, join } from "path";
 import { mkdir, readFile, readdir, rm } from "fs/promises";

package/dist/src/auth/profiles/store.js

@@ -1,5 +1,5 @@
-import { init_paths, resolveCredentialsDir } from "../../config/paths.js";
 import { init_write_file_atomic, writeTextAtomicSync } from "../../infra/write-file-atomic.js";
+import { init_paths, resolveCredentialsDir } from "../../config/paths.js";
 import path from "node:path";
 import { chmodSync, existsSync, mkdirSync, readFileSync } from "node:fs";
 //#region src/auth/profiles/store.ts

package/dist/src/auth/sync-provider-auth.js

@@ -1,8 +1,8 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 import { init_paths, resolveAgentAuthProfilesPath, resolveAuthProfilesPath, resolveOAuthPath } from "../config/paths.js";
-import { init_loader, loadConfig } from "../config/loader.js";
 import { init_registry, isOAuthOnlyProvider } from "./oauth/registry.js";
+import { init_loader, loadConfig } from "../config/loader.js";
+import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 import { existsSync, readFileSync } from "node:fs";
 //#region src/auth/sync-provider-auth.ts
 /**

package/dist/src/browser/providers/browser-ext-install.js

@@ -2,8 +2,8 @@ import { PACKAGE_VERSION, init_package_version } from "../../package-version.js"
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { assertCacheDir, init_cache_dir_policy } from "../cache-dir-policy.js";
-import { init_paths, resolveBinDir } from "../../config/paths.js";
 import { init_write_file_atomic, writeTextAtomic } from "../../infra/write-file-atomic.js";
+import { init_paths, resolveBinDir } from "../../config/paths.js";
 import { resolvePackageRoot } from "../../infra/update-check.js";
 import { dirname, join } from "node:path";
 import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";

package/dist/src/cli/commands/doctor/checks/provider-auth.js

@@ -1,6 +1,6 @@
 import { getAgentDefaultModelRef, init_schema, parseModelRef } from "../../../../config/schema.js";
-import { init_loader, loadConfig } from "../../../../config/loader.js";
 import { PROVIDER_ENV_MAP, getApiKeyFromEnv, init_env_keys } from "../../../../providers/env-keys.js";
+import { init_loader, loadConfig } from "../../../../config/loader.js";
 import { existsSync } from "node:fs";
 //#region src/cli/commands/doctor/checks/provider-auth.ts
 init_loader();

package/dist/src/cli/commands/models.js

@@ -1,6 +1,6 @@
 import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
-import { loadConfig, saveConfig } from "../../config/loader.js";
 import { CredentialResolver, init_credentials } from "../../auth/credentials.js";
+import { loadConfig, saveConfig } from "../../config/loader.js";
 import { getAllModels, getAvailableModels, getConfiguredProviders, getProviderAuthState, getProviderDisplayName, init_providers, isProviderConfigured, providerSupportsApiKey, providerSupportsOAuth, resolveModel } from "../../providers/index.js";
 import { formatExamples, register } from "../registry.js";
 import { getContextWithOpts } from "../context.js";

package/dist/src/config/agent-profile.js

@@ -1,6 +1,6 @@
-import { init_agent_scope, normalizeAgentId, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
 import { resolveEffectiveAgentManifest } from "../agent-manifest/resolver.js";
 import "../agent-manifest/index.js";
+import { init_agent_scope, normalizeAgentId, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
 import { init_session_key, parseSessionKey } from "../routing/session-key.js";
 import { agentExists, getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 //#region src/config/agent-profile.ts

package/dist/src/config/index.js

@@ -2,15 +2,15 @@ import { ENV_VARS, XOPC_DB_FILENAME, resolveHomeDir, resolveStateDir, resolveXop
 import { TelegramAccountConfigSchema, TelegramConfigSchema, TelegramGroupConfigSchema, TelegramTopicConfigSchema } from "../../extensions/telegram/src/config-schema.js";
 import { WeixinAccountConfigSchema, WeixinConfigSchema } from "../../extensions/weixin/src/config-schema.js";
 import { AgentImageGenerationModelSchema, AgentModelRefSchema, AgentModelsSchema, AgentTypedModelRoleSchema, AgentsConfigSchema, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, BrowserConfigSchema, ChannelsConfigSchema, CommandsConfigSchema, ConfigSchema, ConnectorsConfigSchema, ExperimentalConfigSchema, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, GatewayAuthRateLimitSchema, GatewayAuthSchema, GatewayBindModeSchema, GatewayChannelConnectDeferModeSchema, GatewayConfigSchema, GatewayModeSchema, GatewayRemoteSchema, GatewaySecuritySchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayTlsSchema, GatewayTrustedProxySchema, GatewayWebchatConfigSchema, HeartbeatConfigSchema, McpConfigSchema, McpServerSchema, MediaUnderstandingCapabilitiesSchema, MediaUnderstandingModelSchema, MessagesConfigSchema, ModelCatalogConfigSchema, ModelsDevConfigSchema, ProviderAuthConfigSchema, ProviderAzureConfigSchema, ProviderRequestOverridesSchema, ProvidersConfigSchema, RuntimeToolsConfigSchema, STTConfigSchema, STTFallbackConfigSchema, STTProviderConfigSchema, SearchProviderEntrySchema, SessionConfigSchema, SessionDmScopeSchema, SessionResetByTypeSchema, SessionResetConfigSchema, SessionResetModeSchema, SessionScopeSchema, SessionStorageConfigSchema, TTSConfigSchema, TTSEdgeConfigSchema, TTSFallbackConfigSchema, TTSModelOverridesConfigSchema, TTSProviderConfigSchema, TTSSummarizationConfigSchema, ToolsConfigSchema, ToolsMediaAudioConfigSchema, ToolsMediaConfigSchema, TuiConfigSchema, TunnelConfigSchema, TunnelConsentSchema, UpdateAutoConfigSchema, UpdateConfigSchema, VoiceConfigSchema, VoiceRefinementConfigSchema, WebSearchConfigSchema, WebToolsConfigSchema, WebsiteBlocklistSchema, WorkspaceConfigSchema, WorkspaceImportConfigSchema, getAgentDefaultImageGenerationModelConfig, getAgentDefaultImageModelConfig, getAgentDefaultModelRef, init_schema, parseModelRef } from "./schema.js";
-import { applyConfigOverrides, getConfigOverrides, resetConfigOverrides, setConfigOverride, unsetConfigOverride } from "./runtime-overrides.js";
+import { clearConfigValueCache, getAllowedCommands, getCacheStats, init_resolve_config_value, resolveConfigValue, resolveHeaders, testApiKeyResolution } from "./resolve-config-value.js";
 import { expandWorkspacePathString, init_workspace_path, normalizeWorkspaceDir, resolveWorkspaceRoot } from "./workspace-path.js";
 import { resolveDefaultAgentWorkspaceDir } from "./workspace-defaults.js";
 import { resolveAgentDir as resolveAgentDir$1, resolveAgentHomeDir as resolveAgentHomeDir$1, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
-import { extractProfileAgentId, resolveEffectiveAgentManifestForAgent, resolveEffectiveAgentManifestForSession, resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession } from "./agent-profile.js";
 import { FILENAMES, WORKSPACE_FILES, existsSync, hasBundledExtensionManifest, init_paths, resolveAgentAuthProfilesPath, resolveAgentDir, resolveAgentHomeDir, resolveAgentProfileDir, resolveAgentProfileMarkdownPath, resolveAuthProfilesPath, resolveBinDir, resolveBundledExtensionsDir, resolveBundledSkillsDir, resolveConfigPath, resolveCredentialsDir, resolveExtensionSdkPath, resolveExtensionsDir, resolveExtensionsLockPath, resolveInboxDir, resolveInboxMessagePath, resolveInboxPendingDir, resolveInboxProcessedDir, resolveLogPath, resolveLogsDir, resolveModelsJsonPath, resolveNodeBinDir, resolveNodeBinPath, resolveNodeToolsDir, resolveNpmBinPath, resolveOAuthPath, resolvePidPath, resolveSkillPath, resolveSkillsCachePath, resolveSkillsDir, resolveSkillsLockPath, resolveSocketPath, resolveStatusPath, resolveToolsDir, resolveWorkspaceExtensionsDir, resolveWorkspaceFile, resolveWorkspaceStateDir, resolveWorkspaceStatePath, resolveXopcBinPath } from "./paths.js";
-import { init_loader, loadConfig, saveConfig } from "./loader.js";
-import { clearConfigValueCache, getAllowedCommands, getCacheStats, init_resolve_config_value, resolveConfigValue, resolveHeaders, testApiKeyResolution } from "./resolve-config-value.js";
 import { CustomModelSchema, ImageGenerationCapabilitiesSchema, ImageGenerationModelSchema, ImageGenerationProviderSchema, ModelOverrideSchema, ModelsJsonSchema, OpenAICompatSchema, OpenAICompletionsCompatSchema, OpenAIResponsesCompatSchema, OpenRouterRoutingSchema, ProviderConfigSchema, VercelGatewayRoutingSchema, getDefaultModelValues, init_models_json, loadModelsJson, modelsJsonExists, saveModelsJson, validateModelsConfig } from "./models-json.js";
+import { init_loader, loadConfig, saveConfig } from "./loader.js";
+import { applyConfigOverrides, getConfigOverrides, resetConfigOverrides, setConfigOverride, unsetConfigOverride } from "./runtime-overrides.js";
+import { extractProfileAgentId, resolveEffectiveAgentManifestForAgent, resolveEffectiveAgentManifestForSession, resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession } from "./agent-profile.js";
 import { canonicalizeConfiguredMcpServer, isKnownCliMcpTypeAlias, normalizeConfiguredMcpServers, resolveXopcMcpTransportAlias } from "./mcp-config-normalize.js";
 import { formatThinkingLevels, listThinkingLevels, normalizeElevatedMode, normalizeReasoningLevel, normalizeThinkLevel, normalizeVerboseLevel, thinkLevelToNumber } from "../agent/transcript/thinking-types.js";
 import { getWorkspacePath } from "./workspace-path-helpers.js";

package/dist/src/config/loader.js

@@ -2,8 +2,8 @@ import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { ConfigSchema, init_schema } from "./schema.js";
-import { init_paths, resolveConfigPath } from "./paths.js";
 import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
+import { init_paths, resolveConfigPath } from "./paths.js";
 import { assertChannelPluginConfigs, init_validate_channel_configs } from "./validate-channel-configs.js";
 import { dirname } from "path";
 import { existsSync, mkdirSync, promises, readFileSync } from "fs";

package/dist/src/config/models-json.js

@@ -1,6 +1,6 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { init_paths, resolveModelsJsonPath } from "./paths.js";
 import { init_write_file_atomic, writeTextAtomicSync } from "../infra/write-file-atomic.js";
+import { init_paths, resolveModelsJsonPath } from "./paths.js";
 import { existsSync, readFileSync } from "fs";
 import { z } from "zod";
 //#region src/config/models-json.ts

package/dist/src/connectors/connected-source-ingestion.js

@@ -31,6 +31,9 @@ function asRecord(value) {
 function boundedPersonValue(value, maxLength = 320) {
 	return typeof value === "string" ? value.trim().slice(0, maxLength) : "";
 }
+function normalizedEmail(value) {
+	return /<([^<>\s]+@[^<>\s]+)>/.exec(value)?.[1]?.toLowerCase() ?? value.toLowerCase();
+}
 function personEntities(record) {
 	if (!record) return [];
 	const extractPerson = (value, role) => {
@@ -39,7 +42,7 @@ function personEntities(record) {
 			if (!normalized) return [];
 			return normalized.includes("@") ? [{
 				role,
-				email: normalized
+				email: normalizedEmail(normalized)
 			}] : [{
 				role,
 				name: normalized
@@ -91,6 +94,20 @@ function peopleSignals(entities) {
 function connectionIdentities(identity) {
 	return [...new Set(Object.values(identity).filter((value) => typeof value === "string").map((value) => value.trim().toLowerCase()).filter(Boolean))];
 }
+function hasOwnerAttribution(toolkit, people, ownerIdentities) {
+	const attributableRoles = toolkit === "gmail" ? new Set(["sender", "from"]) : toolkit === "googlecalendar" ? new Set(["organizer"]) : new Set([
+		"author",
+		"user",
+		"username",
+		"owner",
+		"owners"
+	]);
+	return people.filter((person) => attributableRoles.has(person.role)).flatMap((person) => [
+		person.email,
+		person.username,
+		person.name
+	]).filter((value) => Boolean(value)).some((value) => ownerIdentities.includes(value.trim().toLowerCase()));
+}
 function resultPayload(value) {
 	const root = asRecord(value) ?? {};
 	return asRecord(root.data) ?? root;
@@ -119,10 +136,10 @@ function resultToSourceItems(input) {
 		const record = entity.value;
 		const people = personEntities(record);
 		const ownerIdentities = connectionIdentities(input.connectionIdentity);
-		const observedIdentities = peopleSignals(people).map((value) => value.toLowerCase());
-		const actorAttributed = entity.metadata.actorAttributed === true || input.toolkit === "gmail" || input.toolkit === "googlecalendar" || ["github", "googledrive"].includes(input.toolkit) && observedIdentities.some((value) => ownerIdentities.includes(value));
+		const actorAttributed = entity.metadata.actorAttributed === true || hasOwnerAttribution(input.toolkit, people, ownerIdentities);
 		const serialized = JSON.stringify(sanitizeConnectedSourceValue(entity.value), null, 2);
-		const normalizedText = serialized.length > 8e3 ? `${serialized.slice(0, 8e3)}\n…` : serialized;
+		const contentChars = typeof entity.value.content === "string" ? 24e3 : 8e3;
+		const normalizedText = serialized.length > contentChars ? `${serialized.slice(0, contentChars)}\n…` : serialized;
 		const contentHash = createHash("sha256").update(serialized).digest("hex");
 		return {
 			sourceInstanceId: input.sourceInstanceId,

package/dist/src/connectors/connected-source-normalizers.js

@@ -32,11 +32,57 @@ function rows(data, ...keys) {
 function compact(value) {
 	return Object.fromEntries(Object.entries(value).filter(([, item]) => item !== void 0 && item !== null && item !== ""));
 }
+const MAX_EMAIL_CONTENT_CHARS = 24e3;
+function gmailHeaders(message) {
+	const messagePayload = record(message.payload);
+	const values = Array.isArray(messagePayload?.headers) ? messagePayload.headers : [];
+	const headers = /* @__PURE__ */ new Map();
+	for (const value of values) {
+		const header = record(value);
+		const name = text(header, "name")?.toLowerCase();
+		const headerValue = text(header, "value");
+		if (name && headerValue) headers.set(name, headerValue);
+	}
+	return headers;
+}
+function decodeGmailBody(value) {
+	if (typeof value !== "string" || !value.trim() || value.length > 256e3) return void 0;
+	try {
+		return Buffer.from(value.replace(/-/g, "+").replace(/_/g, "/"), "base64").toString("utf8").trim() || void 0;
+	} catch {
+		return;
+	}
+}
+function stripHtml(value) {
+	return value.replace(/<script\b[^>]*>[\s\S]*?<\/script>/gi, " ").replace(/<style\b[^>]*>[\s\S]*?<\/style>/gi, " ").replace(/<[^>]+>/g, " ").replace(/&nbsp;/gi, " ").replace(/&amp;/gi, "&").replace(/&lt;/gi, "<").replace(/&gt;/gi, ">").replace(/\s+/g, " ").trim();
+}
+function gmailContent(message) {
+	const direct = text(message, "plainText", "plain_text", "text", "content", "body");
+	if (direct) return direct.slice(0, MAX_EMAIL_CONTENT_CHARS);
+	const plain = [];
+	const html = [];
+	const visit = (value, depth = 0) => {
+		if (depth > 10 || plain.join("").length >= MAX_EMAIL_CONTENT_CHARS) return;
+		const part = record(value);
+		if (!part) return;
+		const mimeType = text(part, "mimeType", "mime_type")?.toLowerCase();
+		const decoded = decodeGmailBody(record(part.body)?.data);
+		if (decoded) {
+			if (mimeType === "text/html") html.push(stripHtml(decoded));
+			else if (!mimeType || mimeType === "text/plain") plain.push(decoded);
+		}
+		if (Array.isArray(part.parts)) for (const nested of part.parts) visit(nested, depth + 1);
+	};
+	visit(message.payload);
+	const content = (plain.length ? plain : html).filter(Boolean).join("\n\n").trim();
+	return content ? content.slice(0, MAX_EMAIL_CONTENT_CHARS) : void 0;
+}
 function normalizeGmail(result) {
 	return rows(payload(result), "messages").flatMap((message) => {
 		const externalId = text(message, "id", "messageId", "message_id");
 		if (!externalId) return [];
 		const occurredAt = time(message.internalDate ?? message.internal_date ?? message.date ?? message.timestamp);
+		const headers = gmailHeaders(message);
 		return [{
 			externalId,
 			itemType: "email",
@@ -45,12 +91,13 @@ function normalizeGmail(result) {
 			value: compact({
 				id: externalId,
 				threadId: text(message, "threadId", "thread_id"),
-				subject: text(message, "subject"),
-				sender: message.sender ?? message.from,
-				recipients: message.recipients ?? message.to,
+				subject: text(message, "subject") ?? headers.get("subject"),
+				sender: message.sender ?? message.from ?? headers.get("from"),
+				recipients: message.recipients ?? message.to ?? headers.get("to"),
 				date: occurredAt,
 				labels: message.labelIds ?? message.label_ids ?? message.labels,
-				snippet: text(message, "snippet", "preview")
+				snippet: text(message, "snippet", "preview"),
+				content: gmailContent(message)
 			}),
 			metadata: {
 				observationKind: "message",

package/dist/src/connectors/connected-source-understanding.d.ts

@@ -0,0 +1,19 @@
+import type { MemoryManager } from '../agent/memory/manager.js';
+import type { Config } from '../config/schema.js';
+import type { KnowledgeSourceItem } from '../knowledge/types.js';
+import type { UnderstandingSourceItem } from '../user-context/sources/types.js';
+import { analyzeUnderstandingSources } from '../work-discovery/analyzer.js';
+export declare function connectedItemsForUnderstanding(items: KnowledgeSourceItem[]): UnderstandingSourceItem[];
+export declare function deriveConnectedSourceUnderstanding(input: {
+    config: Config;
+    agentId: string;
+    sourceInstanceId: string;
+    sourceRunId: string;
+    memoryManager: MemoryManager;
+    analyze?: typeof analyzeUnderstandingSources;
+}): Promise<{
+    created: number;
+    focusCount: number;
+    status: 'completed' | 'partial' | 'failed';
+    error?: string;
+}>;

package/dist/src/connectors/connected-source-understanding.js

@@ -0,0 +1,132 @@
+import { listKnowledgeSourceItems } from "../storage/sqlite/knowledge-repository.js";
+import "../storage/sqlite/index.js";
+import { upsertUserFocus } from "../user-context/sources/repository.js";
+import { analyzeUnderstandingSources } from "../work-discovery/analyzer.js";
+import { createHash } from "node:crypto";
+//#region src/connectors/connected-source-understanding.ts
+const MAX_CONNECTED_ITEMS = 150;
+function normalizedValue(item) {
+	if (!item.normalizedText) return {};
+	try {
+		const value = JSON.parse(item.normalizedText);
+		return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+	} catch {
+		return {};
+	}
+}
+function text(value) {
+	return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+function itemType(itemType) {
+	if (itemType === "email") return "mail";
+	if (itemType === "calendar_event") return "calendar_event";
+	if (itemType === "external_task") return "task";
+	if (itemType === "development_activity" || itemType === "repository") return "code_activity";
+	return "document";
+}
+function timestamp(value) {
+	if (!value) return void 0;
+	const parsed = Date.parse(value);
+	return Number.isFinite(parsed) ? parsed : void 0;
+}
+function contentPriority(item) {
+	const value = normalizedValue(item);
+	if (item.itemType === "connected_content") return 3;
+	if (text(value.content)) return 2;
+	return 1;
+}
+function connectedItemsForUnderstanding(items) {
+	return [...items].sort((left, right) => contentPriority(right) - contentPriority(left)).slice(0, MAX_CONNECTED_ITEMS).flatMap((item) => {
+		const value = normalizedValue(item);
+		const title = text(value.title) ?? text(value.subject) ?? text(value.fullName) ?? text(value.repository) ?? `${text(item.metadata.toolkit) ?? "Connected source"} ${item.itemType}`;
+		const normalizedText = item.normalizedText?.trim();
+		if (!title && !normalizedText) return [];
+		return [{
+			id: item.id,
+			sourceId: "connected-work",
+			type: itemType(item.itemType),
+			title,
+			...normalizedText ? { text: normalizedText.slice(0, 24e3) } : {},
+			...text(item.metadata.toolkit) ? { group: text(item.metadata.toolkit) } : {},
+			...timestamp(item.occurredAt) ? { occurredAt: timestamp(item.occurredAt) } : {},
+			...timestamp(item.sourceUpdatedAt) ? { modifiedAt: timestamp(item.sourceUpdatedAt) } : {},
+			ownerAttribution: item.metadata.actorAttributed === true ? "user" : "shared",
+			sensitivity: item.sensitivity,
+			evidenceRef: `knowledge-source://${item.id}`
+		}];
+	});
+}
+function understandingKind(category) {
+	if (category === "preference") return "preference";
+	if (category === "workflow") return "routine";
+	if (category === "focus") return "current_state";
+	return "project_context";
+}
+function understandingCandidate(candidate) {
+	const normalized = candidate.statement.toLocaleLowerCase().replace(/[^\p{L}\p{N}]+/gu, " ").trim();
+	return {
+		kind: understandingKind(candidate.category),
+		content: candidate.statement,
+		canonicalKey: `connected-semantic:${candidate.category}:${createHash("sha256").update(normalized).digest("hex").slice(0, 20)}`,
+		confidence: candidate.confidence === "high" ? .9 : candidate.confidence === "medium" ? .72 : .55,
+		importance: candidate.category === "focus" ? .8 : .68,
+		explicitness: "inferred",
+		durability: candidate.category === "focus" ? "ephemeral" : candidate.category === "workflow" ? "recurring" : "durable",
+		sensitivity: "personal",
+		disclosurePolicy: "referenceable"
+	};
+}
+function hasLongVerbatimOverlap(value, sourceTexts, minimumLength = 32) {
+	const normalized = value.replace(/\s+/g, " ").trim();
+	if (normalized.length < minimumLength) return false;
+	return sourceTexts.some((source) => source.replace(/\s+/g, " ").includes(normalized));
+}
+async function deriveConnectedSourceUnderstanding(input) {
+	const items = connectedItemsForUnderstanding(listKnowledgeSourceItems({
+		agentId: input.agentId,
+		sourceInstanceId: input.sourceInstanceId,
+		includeDeleted: false,
+		limit: MAX_CONNECTED_ITEMS
+	}));
+	if (!items.length) return {
+		created: 0,
+		focusCount: 0,
+		status: "completed"
+	};
+	const analysis = await (input.analyze ?? analyzeUnderstandingSources)({
+		config: input.config,
+		items
+	});
+	const rawTexts = items.flatMap((item) => item.text ? [item.text] : []);
+	const profileCandidates = analysis.profileCandidates.filter((candidate) => !hasLongVerbatimOverlap(candidate.statement, rawTexts));
+	const sourceItemIds = [...new Set([...profileCandidates.flatMap((candidate) => candidate.evidenceRefs ?? []), ...analysis.workThreadCandidates.flatMap((candidate) => candidate.evidenceRefs)].map((ref) => ref.startsWith("knowledge-source://") ? ref.slice(19) : ""))].filter(Boolean).slice(0, 20);
+	const reviewed = profileCandidates.length ? await input.memoryManager.applyUnderstandingCandidates(profileCandidates.map(understandingCandidate), {
+		agentId: input.agentId,
+		sourceItemIds,
+		sourceText: "Bounded semantic synthesis from explicitly connected work sources.",
+		source: {
+			provider: "connected-sources",
+			sourceInstanceId: input.sourceInstanceId
+		},
+		reviewSource: "background"
+	}) : { created: 0 };
+	const focuses = analysis.workThreadCandidates.filter((candidate) => !hasLongVerbatimOverlap(candidate.title, rawTexts) && !hasLongVerbatimOverlap(candidate.summary, rawTexts)).map((candidate) => upsertUserFocus({
+		canonicalKey: `connected-focus:${candidate.topicKey}`,
+		title: candidate.title,
+		summary: candidate.summary,
+		horizon: candidate.horizon,
+		status: "candidate",
+		confidence: candidate.confidence === "high" ? .9 : candidate.confidence === "medium" ? .72 : .55,
+		evidenceRefs: candidate.evidenceRefs,
+		sourceRunId: input.sourceRunId
+	}));
+	const sourceStatus = analysis.sourceStatuses.find((item) => item.sourceId === "connected-work");
+	return {
+		created: reviewed.created,
+		focusCount: focuses.length,
+		status: sourceStatus?.status ?? "failed",
+		...sourceStatus?.error ? { error: sourceStatus.error } : {}
+	};
+}
+//#endregion
+export { connectedItemsForUnderstanding, deriveConnectedSourceUnderstanding };

package/dist/src/connectors/content-enrichment.d.ts

@@ -19,6 +19,7 @@ export type ConnectedContentReadResult = {
 };
 export declare function listConnectedContentCandidates(options: {
     agentId: string;
+    sourceInstanceId?: string;
     limit?: number;
 }): ConnectedContentCandidate[];
 export declare function readConnectedContent(input: {

package/dist/src/connectors/content-enrichment.js

@@ -43,13 +43,16 @@ function candidateFor(item) {
 	const value = normalizedRecord(item);
 	const title = text(value.title) ?? text(value.subject);
 	if (!title) return void 0;
-	if (toolkit === "gmail" && item.itemType === "email") return {
-		sourceItemId: item.id,
-		sourceInstanceId: item.sourceInstanceId,
-		toolkit,
-		title,
-		occurredAt: item.occurredAt
-	};
+	if (toolkit === "gmail" && item.itemType === "email") {
+		if (text(value.content)) return void 0;
+		return {
+			sourceItemId: item.id,
+			sourceInstanceId: item.sourceInstanceId,
+			toolkit,
+			title,
+			occurredAt: item.occurredAt
+		};
+	}
 	const mimeType = text(item.metadata.mimeType) ?? text(value.mimeType);
 	if (toolkit === "googledrive" && item.itemType === "cloud_document" && mimeType && (mimeType === GOOGLE_DOCUMENT_MIME || DOWNLOADABLE_TEXT_MIMES.has(mimeType))) return {
 		sourceItemId: item.id,
@@ -64,6 +67,7 @@ function listConnectedContentCandidates(options) {
 	const limit = Math.max(1, Math.min(20, options.limit ?? 10));
 	const items = listKnowledgeSourceItems({
 		agentId: options.agentId,
+		...options.sourceInstanceId ? { sourceInstanceId: options.sourceInstanceId } : {},
 		includeDeleted: false,
 		limit: 500
 	});