@xopcai/xopc 0.0.233 → 0.0.235

package/dist/src/agent/tools/xopc-use-tool.js

@@ -5,16 +5,16 @@ import "../../storage/sqlite/index.js";
 import { ObjectLinkService } from "../../activity/service.js";
 import "../../activity/index.js";
 import { getDefaultAgentId, init_resolve_route } from "../../routing/resolve-route.js";
+import { TaskCommandSchema, TaskContextInputSchema } from "../../../packages/gateway-contract/src/tasks.js";
+import { appendProductDeliveryText } from "../../../packages/gateway-contract/src/product-delivery.js";
+import { CreateAutomationSchema, UpdateAutomationSchema } from "../../automations/domain/validation.js";
+import "../../automations/index.js";
 import { TaskRepository } from "../../tasks/task-repository.js";
 import { enqueueTaskChangedEvent } from "../../tasks/task-change-events.js";
 import { TaskRunRepository } from "../../tasks/task-run-repository.js";
 import { TaskReadModelProjector } from "../../tasks/task-read-model-projector.js";
-import { TaskCommandSchema, TaskContextInputSchema } from "../../../packages/gateway-contract/src/tasks.js";
-import { appendProductDeliveryText } from "../../../packages/gateway-contract/src/product-delivery.js";
 import { isValidProjectAgentId, normalizeProjectAgentId, resolveProjectAgentId } from "../../projects/project-agent.js";
 import "../../projects/index.js";
-import { CreateAutomationSchema, UpdateAutomationSchema } from "../../automations/domain/validation.js";
-import "../../automations/index.js";
 import { TaskContextRepository } from "../../tasks/task-context-repository.js";
 import { TaskDependencyError, TaskDependencyService } from "../../tasks/task-dependency-service.js";
 import { TaskApplicationService } from "../../tasks/task-application-service.js";

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 { shouldRunExtensionBridgeServer } from "../backend-from-config.js";
 import { resolvePackageRoot } from "../../infra/update-check.js";
 import { dirname, join } from "node:path";

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

@@ -1,8 +1,8 @@
 import { buildChannelCatalogForConfig, init_channel_catalog_service } from "../../channels/catalog/channel-catalog-service.js";
 import { init_loader, loadConfig, saveConfig } from "../../config/loader.js";
+import { formatExamples, register } from "../registry.js";
 import { listChannelPairingState } from "../../channels/pairing/pairing-service.js";
 import { approveChannelPairingFromCli } from "../../channels/pairing/approve-cli.js";
-import { formatExamples, register } from "../registry.js";
 import { colors } from "../utils/colors.js";
 import { Command } from "commander";
 //#region src/cli/commands/channels.ts

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

@@ -1,8 +1,8 @@
 import { init_loader, loadConfig, saveConfig } from "../../config/loader.js";
 import { getStoreConnectorInstallPlan, installStoreConnector, listStoreConnectors } from "../../capabilities/store-connector.js";
 import { register } from "../registry.js";
-import { confirm } from "@inquirer/prompts";
 import { Command } from "commander";
+import { confirm } from "@inquirer/prompts";
 //#region src/cli/commands/connectors.ts
 init_loader();
 function parsePairs(values, option) {

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/extension-marketplace.js

@@ -13,8 +13,8 @@ import { existsSync, readFileSync, rmSync, statSync } from "node:fs";
 import { execSync } from "node:child_process";
 import { createHash } from "node:crypto";
 import semver from "semver";
-import { confirm } from "@inquirer/prompts";
 import { Command } from "commander";
+import { confirm } from "@inquirer/prompts";
 //#region src/cli/commands/extension-marketplace.ts
 init_loader();
 init_paths();

package/dist/src/cli/commands/gateway/lifecycle.js

@@ -1,8 +1,8 @@
 import { init_paths, resolveConfigPath } from "../../../config/paths.js";
 import { loadConfig } from "../../../config/loader.js";
 import "../../../config/index.js";
-import { isRestartEnabled } from "../../../config/commands.flags.js";
 import { resolveGatewayService } from "../../../daemon/service.js";
+import { isRestartEnabled } from "../../../config/commands.flags.js";
 import { authorizeGatewaySigusr1Restart, writeGatewayRestartIntentSync } from "../../../infra/restart.js";
 import { findVerifiedGatewayListenerPidsOnPortSync, formatGatewayPidList, signalVerifiedGatewayPidSync } from "../../../infra/gateway-processes.js";
 import { runServiceRestart, runServiceStop } from "./lifecycle-core.js";

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";
@@ -9,8 +9,8 @@ import { prepareUpdateGlobalDefaults } from "../../gateway/global-defaults-admin
 import { disconnectProvider } from "../../providers/provider-disconnect.js";
 import { colors } from "../utils/colors.js";
 import { runCliOAuthLogin } from "../utils/oauth-login.js";
-import { input } from "@inquirer/prompts";
 import { Command } from "commander";
+import { input } from "@inquirer/prompts";
 //#region src/cli/commands/models.ts
 init_credentials();
 init_schema();

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

@@ -10,8 +10,8 @@ import { initWorkspace } from "../utils/init-workspace.js";
 import { setupModel } from "./onboard/model.js";
 import { getChannelConfigurators } from "./onboard/channels/registry.js";
 import { setupChannels } from "./onboard/channels/index.js";
-import { select } from "@inquirer/prompts";
 import { Command } from "commander";
+import { select } from "@inquirer/prompts";
 //#region src/cli/commands/onboard.ts
 init_schema();
 init_paths_state();

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, 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, McpOAuthConfigSchema, 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, resolveEffectiveAgentConfigForAgent, resolveEffectiveAgentConfigForSession, 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, resolveMcpOAuthPath, 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, resolveEffectiveAgentConfigForAgent, resolveEffectiveAgentConfigForSession, 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/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/extensions/sdk/index.js

@@ -7,8 +7,8 @@ import { SlotRegistry, getSlotRegistry, registerSlotType } from "../slots.js";
 import { ExtensionDiagnostics, ExtensionLoaderCacheImpl, getExtensionCache, getExtensionDiagnostics } from "../diagnostics.js";
 import "../loader.js";
 import { ExtensionHookRunner, createHookContext, isHookEvent } from "../hooks.js";
-import { defineChannelPluginEntry } from "./channel-entry.js";
 import { registerExtensionCliProgram } from "./channel-helpers.js";
+import { defineChannelPluginEntry } from "./channel-entry.js";
 import { lazyFunction, lazyModule } from "./lazy.js";
 import { createMockExtensionApi, createTestGateway } from "./testing.js";
 //#region src/extensions/sdk/index.ts

package/dist/src/files/file-service.d.ts

@@ -15,17 +15,25 @@ export declare class FileServiceError extends Error {
     readonly status: 400 | 403 | 404 | 409;
     constructor(status: 400 | 403 | 404 | 409, message: string);
 }
-export declare function fileResourceFromPath(space: ResolvedFileSpace, absolutePath: string): Promise<FileResource>;
+export declare function fileResourceFromPath(space: ResolvedFileSpace, absolutePath: string, displayPath?: string): Promise<FileResource>;
 export declare class FileSpaceService {
     private readonly getConfig;
     private readonly projects;
     private readonly resolveSessionWorkspace;
+    private readonly listSessionWorkspaces;
     private readonly dynamicSpaces;
     private cache;
-    constructor(getConfig: () => Config, projects: ProjectService, resolveSessionWorkspace: (sessionKey: string) => string);
+    constructor(getConfig: () => Config, projects: ProjectService, resolveSessionWorkspace: (sessionKey: string) => string | Promise<string>, listSessionWorkspaces?: () => Array<{
+        sessionKey: string;
+        root: string;
+    }> | Promise<Array<{
+        sessionKey: string;
+        root: string;
+    }>>);
     private createSpace;
     list(): Promise<ResolvedFileSpace[]>;
     forContext(kind: 'agent' | 'project' | 'session', id: string): Promise<ResolvedFileSpace>;
+    defaultSpace(): Promise<ResolvedFileSpace>;
     get(id: string): Promise<ResolvedFileSpace>;
     resource(id: string): Promise<{
         space: ResolvedFileSpace;

package/dist/src/files/file-service.js

@@ -1,4 +1,4 @@
-import { init_agent_scope, listAgentEntries, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
+import { init_agent_scope, listAgentEntries, resolveAgentWorkspaceDir, resolveDefaultAgentId } from "../agent/agent-scope.js";
 import { resolveProjectAgentId } from "../projects/project-agent.js";
 import "../projects/index.js";
 import { basename, dirname, isAbsolute, relative, resolve, sep } from "node:path";
@@ -21,6 +21,7 @@ const TEXT_EXTENSIONS = new Set([
 	"json",
 	"jsx",
 	"md",
+	"markdown",
 	"mjs",
 	"cjs",
 	"svg",
@@ -40,6 +41,7 @@ const MIME_TYPES = {
 	webp: "image/webp",
 	svg: "image/svg+xml",
 	md: "text/markdown",
+	markdown: "text/markdown",
 	txt: "text/plain",
 	json: "application/json",
 	html: "text/html",
@@ -85,7 +87,7 @@ function mimeType(name, directory) {
 	return MIME_TYPES[name.includes(".") ? name.split(".").pop().toLowerCase() : ""] ?? "application/octet-stream";
 }
 function capabilities(name, directory, writable) {
-	if (directory) return writable ? ["upload"] : [];
+	if (directory) return writable ? ["share", "upload"] : ["share"];
 	const extension = name.includes(".") ? name.split(".").pop().toLowerCase() : "";
 	const result = ["download", "share"];
 	if (MIME_TYPES[extension] || TEXT_EXTENSIONS.has(extension)) result.unshift("preview");
@@ -135,11 +137,11 @@ var FileServiceError = class extends Error {
 		this.status = status;
 	}
 };
-async function fileResourceFromPath(space, absolutePath) {
+async function fileResourceFromPath(space, absolutePath, displayPath = absolutePath) {
 	const info = await stat(absolutePath);
 	const revisionInfo = await stat(absolutePath, { bigint: true });
-	const relativePath = relative(await realpath(space.root), absolutePath).split(sep).join("/");
-	const name = basename(absolutePath);
+	const relativePath = relative(await realpath(space.root), displayPath).split(sep).join("/");
+	const name = basename(displayPath);
 	const directory = info.isDirectory();
 	return {
 		id: fileResourceId(space.id, relativePath),
@@ -158,10 +160,11 @@ async function fileResourceFromPath(space, absolutePath) {
 var FileSpaceService = class {
 	dynamicSpaces = /* @__PURE__ */ new Map();
 	cache = null;
-	constructor(getConfig, projects, resolveSessionWorkspace) {
+	constructor(getConfig, projects, resolveSessionWorkspace, listSessionWorkspaces = () => []) {
 		this.getConfig = getConfig;
 		this.projects = projects;
 		this.resolveSessionWorkspace = resolveSessionWorkspace;
+		this.listSessionWorkspaces = listSessionWorkspaces;
 	}
 	async createSpace(root, title, bindings) {
 		const canonicalRoot = await realpath(root).catch(() => null);
@@ -213,6 +216,13 @@ var FileSpaceService = class {
 			offset += page.items.length;
 		}
 		const merged = /* @__PURE__ */ new Map();
+		for (const { sessionKey, root } of await this.listSessionWorkspaces()) {
+			const space = await this.createSpace(root, sessionKey, [{
+				kind: "session",
+				id: sessionKey
+			}]);
+			if (space) spaces.push(space);
+		}
 		for (const space of [...spaces, ...this.dynamicSpaces.values()]) {
 			const existing = merged.get(space.id);
 			if (existing) existing.bindings = [...existing.bindings, ...space.bindings.filter((binding) => !existing.bindings.some((item) => item.kind === binding.kind && item.id === binding.id))];
@@ -245,7 +255,7 @@ var FileSpaceService = class {
 			}
 			title = project?.name ?? id;
 		}
-		if (kind === "session") root = this.resolveSessionWorkspace(id);
+		if (kind === "session") root = await this.resolveSessionWorkspace(id);
 		if (!root) throw new FileServiceError(404, "File space not found");
 		const space = await this.createSpace(root, title, [{
 			kind,
@@ -256,8 +266,16 @@ var FileSpaceService = class {
 		this.cache = null;
 		return space;
 	}
+	defaultSpace() {
+		return this.forContext("agent", resolveDefaultAgentId(this.getConfig()));
+	}
 	async get(id) {
-		const space = (await this.list()).find((item) => item.id === id);
+		const hadCache = this.cache !== null;
+		let space = (await this.list()).find((item) => item.id === id);
+		if (!space && hadCache) {
+			this.cache = null;
+			space = (await this.list()).find((item) => item.id === id);
+		}
 		if (!space) throw new FileServiceError(404, "File space not found");
 		return space;
 	}
@@ -267,7 +285,7 @@ var FileSpaceService = class {
 		const absolutePath = await resolveFilePath(space.root, locator.relativePath);
 		return {
 			space,
-			resource: await fileResourceFromPath(space, absolutePath),
+			resource: await fileResourceFromPath(space, absolutePath, resolve(space.root, locator.relativePath)),
 			absolutePath
 		};
 	}
@@ -280,9 +298,12 @@ var FileSpaceService = class {
 		for await (const entry of dir) {
 			if (SKIPPED_NAMES.has(entry.name)) continue;
 			const target = resolve(directory, entry.name);
-			const linkInfo = await lstat(target).catch(() => null);
-			if (!linkInfo || linkInfo.isSymbolicLink()) continue;
-			entries.push(await fileResourceFromPath(space, target));
+			if (!await lstat(target).catch(() => null)) continue;
+			const canonicalTarget = await resolveFilePath(space.root, target).catch(() => null);
+			if (!canonicalTarget) continue;
+			const info = await stat(canonicalTarget).catch(() => null);
+			if (!info || !info.isFile() && !info.isDirectory()) continue;
+			entries.push(await fileResourceFromPath(space, canonicalTarget, resolve(space.root, path, entry.name)));
 		}
 		return entries.sort((a, b) => a.kind === b.kind ? a.name.localeCompare(b.name) : a.kind === "directory" ? -1 : 1);
 	}

package/dist/src/gateway/agent-builtin-tools.d.ts

@@ -247,4 +247,4 @@ export declare const GATEWAY_BUILTIN_TOOLS: readonly [{
         readonly zh: "使用已验证的参数执行选定的外部工具。";
     };
 }];
-export declare const GATEWAY_BUILTIN_TOOL_IDS: ("automation" | "workflow" | "find" | "todo" | "image" | "clarify" | "dreaming" | "memory_search" | "memory_get" | "web_search" | "web_fetch" | "browser_use" | "grep" | "session_search" | "read_file" | "list_dir" | "write_file" | "apply_patch" | "exec_command" | "update_plan" | "xopc_tool_search" | "xopc_tool_describe" | "xopc_tool_execute" | "web_extract" | "image_generate" | "skills_list" | "skill_view" | "skill_manage" | "skills_marketplace_search" | "send_message" | "send_media" | "read_media" | "create_share" | "session_status" | "tool_manual" | "delegate_task" | "skill_install" | "text_to_speech" | "execute_code" | "create_desktop_pet")[];
+export declare const GATEWAY_BUILTIN_TOOL_IDS: ("automation" | "workflow" | "find" | "todo" | "image" | "clarify" | "dreaming" | "memory_search" | "memory_get" | "web_search" | "web_fetch" | "browser_use" | "grep" | "session_search" | "read_file" | "list_dir" | "write_file" | "apply_patch" | "exec_command" | "update_plan" | "web_extract" | "image_generate" | "skills_list" | "skill_view" | "skill_manage" | "skills_marketplace_search" | "xopc_tool_search" | "xopc_tool_describe" | "xopc_tool_execute" | "send_message" | "send_media" | "read_media" | "create_share" | "session_status" | "tool_manual" | "delegate_task" | "skill_install" | "text_to_speech" | "execute_code" | "create_desktop_pet")[];

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

@@ -1,6 +1,6 @@
 import { init_agent_scope, listAgentEntries, normalizeAgentId, resolveAgentDir, resolveAgentProfileDir, resolveAgentWorkspaceDir, resolveDefaultAgentId, resolveUserPath, validateAgentIdForNewAgent } from "../agent/agent-scope.js";
-import { resolveEffectiveAgentProfile } from "../config/agent-profile.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/chat-stream/mapper.js

@@ -1,3 +1,4 @@
+import { parseTurnOutcome } from "../../../packages/gateway-contract/src/turn-outcome.js";
 import { resolveToolActivity } from "../../../packages/gateway-contract/src/tool-activity.js";
 import { createPetFeedback } from "./pet-feedback.js";
 //#region src/gateway/chat-stream/mapper.ts
@@ -126,6 +127,10 @@ var ChatStreamMapper = class {
 					kind
 				}] : [];
 			}) : [] })];
+			case "turn_outcome": {
+				const outcome = parseTurnOutcome(event.outcome);
+				return outcome ? [this.make("turn_outcome", outcome)] : [];
+			}
 			case "error": return [this.make("error", {
 				code: "AGENT_RUN_ERROR",
 				message: String(event.content ?? event.message ?? "Unknown error"),

package/dist/src/gateway/file-path-classifier.d.ts

@@ -0,0 +1,30 @@
+import type { Config } from '../config/schema.js';
+import type { FileReferenceLocationKind, FileReferenceScope } from './file-reference-registry.js';
+export type { FileReferenceLocationKind };
+export interface FilePathClassifierContext {
+    workspaceRoot: string;
+    profileMarkdownRoot?: string;
+    stateDir: string;
+    skillsDir: string;
+    configFilePath: string;
+    agentsHomeDir: string;
+    agentId: string;
+}
+export declare function buildFilePathClassifierContext(cfg: Config, sessionKeyRaw?: string): FilePathClassifierContext;
+export declare function looksLikeHostAbsolutePath(pathRaw: string): boolean;
+export declare function fileRefSessionKeysMatch(registered?: string, query?: string): boolean;
+export interface ClassifiedFileLocation {
+    scope: FileReferenceScope;
+    locationKind?: FileReferenceLocationKind;
+    manageRoute?: string;
+}
+export declare function classifyFileLocation(absPath: string, ctx: FilePathClassifierContext): ClassifiedFileLocation;
+export interface ResolveFileReferenceCandidateResult {
+    candidate: string | null;
+    invalid: boolean;
+}
+/**
+ * Resolve user path to an absolute candidate (workspace, absolute host, or profile fallback).
+ */
+export declare function resolveFileReferenceCandidate(rawPath: string, workspaceRoot: string, ctx: FilePathClassifierContext): Promise<ResolveFileReferenceCandidateResult>;
+export declare function displayNameForPath(rawPath: string): string;

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

@@ -0,0 +1,105 @@
+import { init_paths_state, resolveStateDir } from "../config/paths-state.js";
+import { init_agent_scope, resolveAgentProfileDir } from "../agent/agent-scope.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";
+import { stat } from "node:fs/promises";
+//#region src/gateway/file-path-classifier.ts
+init_agent_scope();
+init_paths();
+init_paths_state();
+function buildFilePathClassifierContext(cfg, sessionKeyRaw) {
+	const agentId = extractProfileAgentId(sessionKeyRaw, cfg);
+	const stateDir = resolveStateDir();
+	return {
+		workspaceRoot: "",
+		profileMarkdownRoot: resolveAgentProfileDir(cfg, agentId),
+		stateDir,
+		skillsDir: resolveSkillsDir(),
+		configFilePath: resolveConfigPath(),
+		agentsHomeDir: resolve(stateDir, "agents"),
+		agentId
+	};
+}
+function looksLikeHostAbsolutePath(pathRaw) {
+	const p = pathRaw.trim();
+	if (!p) return false;
+	if (/^[a-z][a-z0-9+.-]*:/i.test(p) && !/^[A-Za-z]:[\\/]/.test(p)) return false;
+	return isAbsolute(p) || /^[A-Za-z]:[\\/]/.test(p) || p.startsWith("\\\\");
+}
+function fileRefSessionKeysMatch(registered, query) {
+	return (registered ?? "").trim() === (query ?? "").trim();
+}
+function classifyFileLocation(absPath, ctx) {
+	const p = resolve(absPath);
+	if (isPathUnderWorkspace(resolve(ctx.workspaceRoot), p)) return { scope: "workspace" };
+	if (ctx.profileMarkdownRoot) {
+		if (isPathUnderWorkspace(resolve(ctx.profileMarkdownRoot), p)) return {
+			scope: "agent-profile",
+			locationKind: "agent-profile",
+			manageRoute: `/agents/${encodeURIComponent(ctx.agentId)}`
+		};
+	}
+	if (isPathUnderWorkspace(resolve(ctx.skillsDir), p)) return {
+		scope: "external",
+		locationKind: "xopc-skills",
+		manageRoute: "/skills"
+	};
+	if (isPathUnderWorkspace(resolve(ctx.agentsHomeDir), p)) return {
+		scope: "external",
+		locationKind: "xopc-agents",
+		manageRoute: `/agents/${encodeURIComponent(ctx.agentId)}`
+	};
+	const stateRoot = resolve(ctx.stateDir);
+	if (p === resolve(ctx.configFilePath) || isPathUnderWorkspace(stateRoot, p)) return {
+		scope: "external",
+		locationKind: "xopc-config",
+		manageRoute: "/settings/gateway"
+	};
+	return {
+		scope: "external",
+		locationKind: "host"
+	};
+}
+/**
+* Resolve user path to an absolute candidate (workspace, absolute host, or profile fallback).
+*/
+async function resolveFileReferenceCandidate(rawPath, workspaceRoot, ctx) {
+	const displayRoot = workspaceRoot;
+	ctx = {
+		...ctx,
+		workspaceRoot: displayRoot
+	};
+	if (looksLikeHostAbsolutePath(rawPath)) return {
+		candidate: resolve(rawPath),
+		invalid: false
+	};
+	const wsPath = resolveWorkspaceSafePath(workspaceRoot, rawPath);
+	if (!wsPath) return {
+		candidate: null,
+		invalid: true
+	};
+	try {
+		await stat(wsPath);
+		return {
+			candidate: wsPath,
+			invalid: false
+		};
+	} catch (e) {
+		if (e?.code === "ENOENT" && ctx.profileMarkdownRoot && isBareProfileMarkdownFileName(rawPath)) return {
+			candidate: resolveProfileMarkdownPathIfBareName(rawPath, ctx.profileMarkdownRoot),
+			invalid: false
+		};
+		return {
+			candidate: wsPath,
+			invalid: false
+		};
+	}
+}
+function displayNameForPath(rawPath) {
+	return basename(rawPath.replace(/\\/g, "/")) || rawPath;
+}
+//#endregion
+export { buildFilePathClassifierContext, classifyFileLocation, displayNameForPath, fileRefSessionKeysMatch, looksLikeHostAbsolutePath, resolveFileReferenceCandidate };

package/dist/src/gateway/file-reference-errors.d.ts

@@ -0,0 +1,6 @@
+export type FileReferenceFsError = {
+    code: 'FILE_NOT_FOUND' | 'FILE_ACCESS_DENIED' | 'FILE_ACCESS_FAILED';
+    message: string;
+    status: 404 | 403 | 500;
+};
+export declare function classifyFileReferenceFsError(err: unknown): FileReferenceFsError;

package/dist/src/gateway/file-reference-errors.js

@@ -0,0 +1,21 @@
+//#region src/gateway/file-reference-errors.ts
+function classifyFileReferenceFsError(err) {
+	const code = err?.code;
+	if (code === "ENOENT" || code === "ENOTDIR") return {
+		code: "FILE_NOT_FOUND",
+		message: "File not found",
+		status: 404
+	};
+	if (code === "EACCES" || code === "EPERM") return {
+		code: "FILE_ACCESS_DENIED",
+		message: "Gateway does not have permission to access this file",
+		status: 403
+	};
+	return {
+		code: "FILE_ACCESS_FAILED",
+		message: "Gateway could not access this file",
+		status: 500
+	};
+}
+//#endregion
+export { classifyFileReferenceFsError };

package/dist/src/gateway/file-reference-registry.d.ts

@@ -0,0 +1,34 @@
+export type FileReferenceScope = 'workspace' | 'external' | 'agent-profile' | 'session-artifact' | 'missing' | 'invalid';
+/** Where an off-workspace file lives (UI badge + manage deep link). */
+export type FileReferenceLocationKind = 'agent-profile' | 'xopc-skills' | 'xopc-config' | 'xopc-agents' | 'xopc-sessions' | 'host';
+export type FileReferenceCapability = 'preview' | 'edit' | 'openExternal' | 'revealInFolder' | 'copyPath' | 'importToWorkspace';
+export interface RegisteredFileReference {
+    id: string;
+    absolutePath: string;
+    sessionKey?: string;
+    scope: FileReferenceScope;
+    locationKind?: FileReferenceLocationKind;
+    capabilities: FileReferenceCapability[];
+    expiresAt: number;
+}
+export interface RegisterFileReferenceInput {
+    absolutePath: string;
+    sessionKey?: string;
+    scope: FileReferenceScope;
+    locationKind?: FileReferenceLocationKind;
+    capabilities: FileReferenceCapability[];
+    ttlMs?: number;
+}
+export declare class FileReferenceRegistry {
+    private readonly refs;
+    register(input: RegisterFileReferenceInput): RegisteredFileReference;
+    resolve(id: string): RegisteredFileReference | null;
+    /**
+     * Remove a specific reference (used after a one-shot action like
+     * import-to-workspace completes so the source card can't be re-triggered).
+     * Returns true if the reference existed and was removed.
+     */
+    expireById(id: string): boolean;
+    expire(now?: number): void;
+}
+export declare const fileReferenceRegistry: FileReferenceRegistry;