@xopcai/xopc 0.0.230 → 0.0.232

package/dist/src/config/schema.js

@@ -1,58 +1,30 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { AgentConfigEntrySchema, CapabilityPresetSchema, DEFAULT_CAPABILITY_PRESET_ID, init_schema as init_schema$1 } from "../agent-manifest/schema.js";
-import { init_preset_chain, linearizePresetIds } from "../agent-manifest/preset-chain.js";
+import { AgentModelsOverrideSchema, AgentsConfigSchema as AgentsConfigSchema$1, DEFAULT_AGENT_MODEL_REF, ImageGenerationRouteSchema, ModelRouteSchema } from "../agent-config/schema.js";
+import { init_agent_config } from "../agent-config/index.js";
 import { checkCacheDir, init_cache_dir_policy } from "../browser/cache-dir-policy.js";
 import { UserContextConfigSchema, init_config } from "../user-context/config.js";
-import { DEFAULT_AGENT_MODELS, init_default_model } from "./default-model.js";
+import { init_default_model } from "./default-model.js";
 import { init_public_url, validatePublicUrl } from "./public-url.js";
 import { TelegramAccountConfigSchema, TelegramConfigSchema, TelegramGroupConfigSchema, TelegramTopicConfigSchema, init_config_schema } from "../../extensions/telegram/src/config-schema.js";
 import { WeixinAccountConfigSchema, WeixinConfigSchema, init_config_schema as init_config_schema$1 } from "../../extensions/weixin/src/config-schema.js";
 import { z } from "zod";
 //#region src/config/schema.ts
 function getAgentDefaultModelRef(config) {
-	const list = Array.isArray(config.agents?.list) ? config.agents.list : [];
-	const defaultId = config.agents?.default?.trim() || list.find((entry) => entry.default === true)?.id?.trim() || list[0]?.id;
-	const agent = list.find((entry) => entry.enabled !== false && entry.id === defaultId) ?? list[0];
-	if (!agent) return void 0;
-	let modelRef;
-	const applyModels = (models) => {
-		const roles = models?.roles ?? {};
-		const defaultRole = models?.defaultRole ?? Object.keys(roles)[0];
-		const next = (defaultRole ? roles[defaultRole] : void 0)?.model.trim();
-		if (next) modelRef = next;
-	};
-	const rootPresetIds = [...config.agents.capabilityPresets[config.agents.defaultPreset] ? [config.agents.defaultPreset] : [], ...(agent.extends ?? []).filter((id) => id !== config.agents.defaultPreset)];
-	for (const presetId of linearizePresetIds(rootPresetIds, config.agents.capabilityPresets)) applyModels(config.agents.capabilityPresets[presetId]?.models);
-	applyModels(agent.models);
-	return modelRef;
+	return config.agents.list.find((entry) => entry.enabled !== false && entry.id === config.agents.default)?.models?.chat?.primary ?? config.agents.defaults.models.chat.primary;
 }
 function getAgentDefaultModelsConfig(config, requestedAgentId) {
-	const list = Array.isArray(config.agents?.list) ? config.agents.list : [];
-	const defaultId = requestedAgentId?.trim() || config.agents?.default?.trim() || list.find((entry) => entry.default === true)?.id?.trim() || list[0]?.id;
-	const agent = list.find((entry) => entry.enabled !== false && entry.id === defaultId) ?? list[0];
-	if (!agent) return void 0;
-	let modelConfig;
-	const applyModels = (models) => {
-		if (!models) return;
-		modelConfig = {
-			...modelConfig,
-			...models,
-			roles: {
-				...modelConfig?.roles ?? {},
-				...models.roles ?? {}
-			}
-		};
-	};
-	const rootPresetIds = [...config.agents.capabilityPresets[config.agents.defaultPreset] ? [config.agents.defaultPreset] : [], ...(agent.extends ?? []).filter((id) => id !== config.agents.defaultPreset)];
-	for (const presetId of linearizePresetIds(rootPresetIds, config.agents.capabilityPresets)) applyModels(config.agents.capabilityPresets[presetId]?.models);
-	applyModels(agent.models);
-	return modelConfig;
+	const id = requestedAgentId?.trim() || config.agents.default;
+	return config.agents.list.find((entry) => entry.enabled !== false && entry.id === id)?.models;
 }
 function getAgentDefaultImageModelConfig(config) {
-	return getAgentDefaultModelsConfig(config)?.imageModel;
+	const models = getAgentDefaultModelsConfig(config);
+	if (models && Object.hasOwn(models, "imageUnderstanding")) return models.imageUnderstanding ?? void 0;
+	return config.agents.defaults.models.imageUnderstanding;
 }
 function getAgentDefaultImageGenerationModelConfig(config, agentId) {
-	return getAgentDefaultModelsConfig(config, agentId)?.imageGenerationModel;
+	const models = getAgentDefaultModelsConfig(config, agentId);
+	if (models && Object.hasOwn(models, "imageGeneration")) return models.imageGeneration ?? void 0;
+	return config.agents.defaults.models.imageGeneration;
 }
 /** `provider/model` or null when invalid. */
 function parseModelRef(ref) {
@@ -64,88 +36,39 @@ function parseModelRef(ref) {
 		model: trimmed.slice(idx + 1).trim()
 	};
 }
-var AgentModelRefSchema, AgentImageGenerationModelSchema, AgentTypedModelRoleSchema, AgentTypedModelRolesSchema, AgentModelsSchema, AgentsConfigSchema, BrowserCloudConfigSchema, BrowserExtensionConfigSchema, BrowserCloakConfigSchema, BrowserConfigSchema, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, SessionDmScopeSchema, SessionStorageConfigSchema, SessionResetModeSchema, SessionResetConfigSchema, SessionResetByTypeSchema, SessionScopeSchema, SessionConfigSchema, ChannelsConfigSchema, SearchProviderEntrySchema, WebSearchConfigSchema, WebsiteBlocklistSchema, WebToolsConfigSchema, ToolsConfigSchema, RuntimePreferenceSchema, RuntimeProvisionSchema, LanguageRuntimeSchema, DEFAULT_RUNTIME_TOOLS_CONFIG, RuntimeToolsConfigSchema, GatewayAuthRateLimitSchema, GatewaySecuritySchema, GatewayTrustedProxySchema, GatewayAuthSchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayRemoteSchema, GatewayTlsSchema, GatewayModeSchema, HeartbeatConfigSchema, GatewayChannelConnectDeferModeSchema, TunnelConsentSchema, TunnelConfigSchema, WorkspaceImportConfigSchema, WorkspaceConfigSchema, GatewayBindModeSchema, GatewayWebchatConfigSchema, GatewayConfigSchema, ModelsDevConfigSchema, ModelCatalogConfigSchema, SttProviderConfigCatchallSchema, STTProviderConfigSchema, STTFallbackConfigSchema, MediaUnderstandingCapabilitiesSchema, MediaUnderstandingModelSchema, STTConfigSchema, TtsProviderConfigCatchallSchema, TTSProviderConfigSchema, TTSFallbackConfigSchema, TTSModelOverridesConfigSchema, TTSEdgeConfigSchema, TTSSummarizationConfigSchema, TTSConfigSchema, VoiceRefinementConfigSchema, VoiceConfigSchema, MessagesConfigSchema, ToolsMediaAudioConfigSchema, ToolsMediaConfigSchema, ProviderAzureConfigSchema, ProviderRequestOverridesSchema, ProviderAuthConfigSchema, ProvidersConfigSchema, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, UpdateAutoConfigSchema, UpdateConfigSchema, CommandsConfigSchema, TuiConfigSchema, McpHttpUrlSchema, ConnectorSecretReferenceSchema, McpConfigScalarSchema, McpOAuthConfigSchema, McpServerSchema, McpConfigSchema, ConnectorsConfigSchema, ExperimentalConfigSchema, ConfigSchema;
+var AgentModelRefSchema, AgentImageGenerationModelSchema, AgentModelsSchema, AgentsConfigSchema, BrowserCloudConfigSchema, BrowserExtensionConfigSchema, BrowserCloakConfigSchema, BrowserConfigSchema, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, SessionDmScopeSchema, SessionStorageConfigSchema, SessionResetModeSchema, SessionResetConfigSchema, SessionResetByTypeSchema, SessionScopeSchema, SessionConfigSchema, ChannelsConfigSchema, SearchProviderEntrySchema, WebSearchConfigSchema, WebsiteBlocklistSchema, WebToolsConfigSchema, ToolsConfigSchema, RuntimePreferenceSchema, RuntimeProvisionSchema, LanguageRuntimeSchema, DEFAULT_RUNTIME_TOOLS_CONFIG, RuntimeToolsConfigSchema, GatewayAuthRateLimitSchema, GatewaySecuritySchema, GatewayTrustedProxySchema, GatewayAuthSchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayRemoteSchema, GatewayTlsSchema, GatewayModeSchema, HeartbeatConfigSchema, GatewayChannelConnectDeferModeSchema, TunnelConsentSchema, TunnelConfigSchema, WorkspaceImportConfigSchema, WorkspaceConfigSchema, GatewayBindModeSchema, GatewayWebchatConfigSchema, GatewayConfigSchema, ModelsDevConfigSchema, ModelCatalogConfigSchema, SttProviderConfigCatchallSchema, STTProviderConfigSchema, STTFallbackConfigSchema, MediaUnderstandingCapabilitiesSchema, MediaUnderstandingModelSchema, STTConfigSchema, TtsProviderConfigCatchallSchema, TTSProviderConfigSchema, TTSFallbackConfigSchema, TTSModelOverridesConfigSchema, TTSEdgeConfigSchema, TTSSummarizationConfigSchema, TTSConfigSchema, VoiceRefinementConfigSchema, VoiceConfigSchema, MessagesConfigSchema, ToolsMediaAudioConfigSchema, ToolsMediaConfigSchema, ProviderAzureConfigSchema, ProviderRequestOverridesSchema, ProviderAuthConfigSchema, ProvidersConfigSchema, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, UpdateAutoConfigSchema, UpdateConfigSchema, CommandsConfigSchema, TuiConfigSchema, McpHttpUrlSchema, ConnectorSecretReferenceSchema, McpConfigScalarSchema, McpOAuthConfigSchema, McpServerSchema, McpConfigSchema, ConnectorsConfigSchema, ExperimentalConfigSchema, ConfigSchema;
 var init_schema = __esmMin((() => {
-	init_schema$1();
-	init_preset_chain();
+	init_agent_config();
 	init_cache_dir_policy();
 	init_config();
 	init_default_model();
 	init_public_url();
 	init_config_schema();
 	init_config_schema$1();
-	AgentModelRefSchema = z.object({
-		primary: z.string().min(1),
-		fallbacks: z.array(z.string()).optional()
-	}).strict();
-	AgentImageGenerationModelSchema = z.object({
-		primary: z.string().min(1),
-		fallbacks: z.array(z.string()).optional(),
-		/** Hard cap for the whole generation attempt (ms). */
-		timeoutMs: z.number().int().positive().optional(),
-		/**
-		* When all `primary + fallbacks` candidates fail, sweep every other
-		* configured provider before giving up.
-		*/
-		autoProviderFallback: z.boolean().optional()
-	}).strict();
-	AgentTypedModelRoleSchema = z.object({
-		description: z.string().max(500).optional(),
-		model: z.string().min(1),
-		fallbacks: z.array(z.string().min(1)).optional()
-	}).strict().superRefine((entry, ctx) => {
-		const validateRef = (ref) => {
-			const trimmed = ref.trim();
-			const idx = trimmed.indexOf("/");
-			return idx > 0 && idx < trimmed.length - 1;
-		};
-		if (!validateRef(entry.model)) ctx.addIssue({
-			code: "custom",
-			message: `model must be provider/model format (got '${entry.model}')`,
-			path: ["model"]
-		});
-		for (const [index, fallback] of (entry.fallbacks ?? []).entries()) if (!validateRef(fallback)) ctx.addIssue({
-			code: "custom",
-			message: `fallback must be provider/model format (got '${fallback}')`,
-			path: ["fallbacks", index]
-		});
-	});
-	AgentTypedModelRolesSchema = z.record(z.string().regex(/^[a-z][a-z0-9_-]{0,63}$/), AgentTypedModelRoleSchema).optional();
-	AgentModelsSchema = z.object({
-		defaultRole: z.string().regex(/^[a-z][a-z0-9_-]{0,63}$/).optional(),
-		roles: AgentTypedModelRolesSchema,
-		imageModel: AgentModelRefSchema.optional(),
-		imageGenerationModel: AgentImageGenerationModelSchema.optional()
-	}).strict().optional();
-	AgentsConfigSchema = z.object({
-		/** Default agent id when not specified (routing / session creation). */
-		default: z.string().optional(),
-		/** Protected global defaults preset applied before each agent's own presets. */
-		defaultPreset: z.string().default(DEFAULT_CAPABILITY_PRESET_ID),
-		capabilityPresets: z.record(z.string(), CapabilityPresetSchema).default({}),
-		list: z.array(AgentConfigEntrySchema).default([])
-	}).strict().default({
+	AgentModelRefSchema = ModelRouteSchema;
+	AgentImageGenerationModelSchema = ImageGenerationRouteSchema;
+	AgentModelsSchema = AgentModelsOverrideSchema;
+	AgentsConfigSchema = AgentsConfigSchema$1.default({
 		default: "main",
-		defaultPreset: DEFAULT_CAPABILITY_PRESET_ID,
-		capabilityPresets: { [DEFAULT_CAPABILITY_PRESET_ID]: {
-			id: DEFAULT_CAPABILITY_PRESET_ID,
-			name: "Global defaults",
-			description: "Default capabilities inherited by every agent.",
-			version: 1,
-			models: DEFAULT_AGENT_MODELS
-		} },
+		defaults: {
+			models: {
+				chat: {
+					primary: DEFAULT_AGENT_MODEL_REF,
+					fallbacks: []
+				},
+				intents: {}
+			},
+			skills: {
+				mode: "all-enabled",
+				exclude: []
+			},
+			tools: {},
+			workflows: {},
+			runtime: {}
+		},
 		list: [{
 			id: "main",
-			enabled: true,
-			identity: {
-				name: "Smart Assistant",
-				description: "General-purpose personal assistant.",
-				role: "General assistant",
-				language: "en",
-				tone: "direct"
-			},
-			responsibilities: { primary: ["Help the user complete tasks"] },
-			workspace: { root: "~/.xopc/workspace/main" }
+			enabled: true
 		}]
 	});
 	BrowserCloudConfigSchema = z.object({
@@ -1080,26 +1003,25 @@ workDiscoveryOnboarding: z.boolean().default(true) }).strict().default({ workDis
 		},
 		agents: {
 			default: "main",
-			defaultPreset: DEFAULT_CAPABILITY_PRESET_ID,
-			capabilityPresets: { [DEFAULT_CAPABILITY_PRESET_ID]: {
-				id: DEFAULT_CAPABILITY_PRESET_ID,
-				name: "Global defaults",
-				description: "Default capabilities inherited by every agent.",
-				version: 1,
-				models: DEFAULT_AGENT_MODELS
-			} },
+			defaults: {
+				models: {
+					chat: {
+						primary: DEFAULT_AGENT_MODEL_REF,
+						fallbacks: []
+					},
+					intents: {}
+				},
+				skills: {
+					mode: "all-enabled",
+					exclude: []
+				},
+				tools: {},
+				workflows: {},
+				runtime: {}
+			},
 			list: [{
 				id: "main",
-				enabled: true,
-				identity: {
-					name: "Smart Assistant",
-					description: "General-purpose personal assistant.",
-					role: "General assistant",
-					language: "en",
-					tone: "direct"
-				},
-				responsibilities: { primary: ["Help the user complete tasks"] },
-				workspace: { root: "~/.xopc/workspace/main" }
+				enabled: true
 			}]
 		},
 		bindings: [],
@@ -1173,4 +1095,4 @@ workDiscoveryOnboarding: z.boolean().default(true) }).strict().default({ workDis
 }));
 //#endregion
 init_schema();
-export { 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, 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, TelegramAccountConfigSchema, TelegramConfigSchema, TelegramGroupConfigSchema, TelegramTopicConfigSchema, ToolsConfigSchema, ToolsMediaAudioConfigSchema, ToolsMediaConfigSchema, TuiConfigSchema, TunnelConfigSchema, TunnelConsentSchema, UpdateAutoConfigSchema, UpdateConfigSchema, VoiceConfigSchema, VoiceRefinementConfigSchema, WebSearchConfigSchema, WebToolsConfigSchema, WebsiteBlocklistSchema, WeixinAccountConfigSchema, WeixinConfigSchema, WorkspaceConfigSchema, WorkspaceImportConfigSchema, getAgentDefaultImageGenerationModelConfig, getAgentDefaultImageModelConfig, getAgentDefaultModelRef, init_schema, parseModelRef };
+export { 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, TelegramAccountConfigSchema, TelegramConfigSchema, TelegramGroupConfigSchema, TelegramTopicConfigSchema, ToolsConfigSchema, ToolsMediaAudioConfigSchema, ToolsMediaConfigSchema, TuiConfigSchema, TunnelConfigSchema, TunnelConsentSchema, UpdateAutoConfigSchema, UpdateConfigSchema, VoiceConfigSchema, VoiceRefinementConfigSchema, WebSearchConfigSchema, WebToolsConfigSchema, WebsiteBlocklistSchema, WeixinAccountConfigSchema, WeixinConfigSchema, WorkspaceConfigSchema, WorkspaceImportConfigSchema, getAgentDefaultImageGenerationModelConfig, getAgentDefaultImageModelConfig, getAgentDefaultModelRef, init_schema, parseModelRef };

package/dist/src/extensions/activation-context.js

@@ -96,17 +96,13 @@ function defaultModelId(config) {
 	if (!Array.isArray(list)) return void 0;
 	const defaultId = typeof agents.default === "string" ? agents.default : void 0;
 	const entry = list.find((candidate) => isRecord(candidate) && candidate.id === defaultId) ?? list.find((candidate) => isRecord(candidate) && candidate.enabled !== false);
-	if (!isRecord(entry)) return void 0;
-	const models = entry.models;
-	if (!isRecord(models)) return void 0;
-	const defaultRole = typeof models.defaultRole === "string" ? models.defaultRole : void 0;
-	const roles = models.roles;
-	if (!defaultRole || !isRecord(roles)) return void 0;
-	const role = roles[defaultRole];
-	if (isRecord(role)) {
-		const model = role.model;
-		if (typeof model === "string" && model.trim().length > 0) return model;
-	}
+	const overrideModels = isRecord(entry) && isRecord(entry.models) ? entry.models : void 0;
+	const overrideChat = overrideModels && isRecord(overrideModels.chat) ? overrideModels.chat : void 0;
+	if (typeof overrideChat?.primary === "string" && overrideChat.primary.trim()) return overrideChat.primary;
+	const defaults = isRecord(agents.defaults) ? agents.defaults : void 0;
+	const models = defaults && isRecord(defaults.models) ? defaults.models : void 0;
+	const chat = models && isRecord(models.chat) ? models.chat : void 0;
+	return typeof chat?.primary === "string" && chat.primary.trim() ? chat.primary : void 0;
 }
 /**
 * Merge partial activation context over values inferred from loaded app config.

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

@@ -0,0 +1,36 @@
+import type { FileResource, FileSpace } from '@xopcai/gateway-contract';
+import type { Config } from '../config/schema.js';
+import { type ProjectService } from '../projects/index.js';
+export type ResolvedFileSpace = FileSpace & {
+    root: string;
+};
+export declare function fileSpaceId(root: string): string;
+export declare function fileResourceId(spaceId: string, relativePath: string): string;
+export declare function parseFileResourceId(id: string): {
+    spaceId: string;
+    relativePath: string;
+};
+export declare function resolveFilePath(root: string, path: string, mustExist?: boolean): Promise<string>;
+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 class FileSpaceService {
+    private readonly getConfig;
+    private readonly projects;
+    private readonly resolveSessionWorkspace;
+    private readonly dynamicSpaces;
+    private cache;
+    constructor(getConfig: () => Config, projects: ProjectService, resolveSessionWorkspace: (sessionKey: string) => string);
+    private createSpace;
+    list(): Promise<ResolvedFileSpace[]>;
+    forContext(kind: 'agent' | 'project' | 'session', id: string): Promise<ResolvedFileSpace>;
+    get(id: string): Promise<ResolvedFileSpace>;
+    resource(id: string): Promise<{
+        space: ResolvedFileSpace;
+        resource: FileResource;
+        absolutePath: string;
+    }>;
+    children(spaceId: string, path?: string): Promise<FileResource[]>;
+}

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

@@ -0,0 +1,282 @@
+import { init_agent_scope, listAgentEntries, resolveAgentWorkspaceDir } 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";
+import { constants } from "node:fs";
+import { createHash } from "node:crypto";
+import { access, lstat, opendir, realpath, stat } from "node:fs/promises";
+//#region src/files/file-service.ts
+init_agent_scope();
+const SKIPPED_NAMES = new Set([
+	".DS_Store",
+	".git",
+	"node_modules"
+]);
+const TEXT_EXTENSIONS = new Set([
+	"css",
+	"csv",
+	"html",
+	"htm",
+	"js",
+	"json",
+	"jsx",
+	"md",
+	"mjs",
+	"cjs",
+	"svg",
+	"ts",
+	"tsx",
+	"txt",
+	"xml",
+	"yaml",
+	"yml"
+]);
+const MIME_TYPES = {
+	png: "image/png",
+	jpg: "image/jpeg",
+	jpeg: "image/jpeg",
+	gif: "image/gif",
+	webp: "image/webp",
+	svg: "image/svg+xml",
+	md: "text/markdown",
+	txt: "text/plain",
+	json: "application/json",
+	html: "text/html",
+	htm: "text/html",
+	css: "text/css",
+	js: "text/javascript",
+	mjs: "text/javascript",
+	cjs: "text/javascript",
+	ts: "text/typescript",
+	tsx: "text/typescript",
+	csv: "text/csv",
+	xml: "application/xml",
+	yaml: "application/yaml",
+	yml: "application/yaml",
+	pdf: "application/pdf",
+	mp3: "audio/mpeg",
+	wav: "audio/wav",
+	ogg: "audio/ogg",
+	m4a: "audio/mp4",
+	mp4: "video/mp4",
+	mov: "video/quicktime",
+	webm: "video/webm"
+};
+function isWithin(root, target) {
+	const rel = relative(root, target);
+	return rel === "" || !rel.startsWith(`..${sep}`) && rel !== ".." && !isAbsolute(rel);
+}
+function normalizeRelativePath(input) {
+	const normalized = input.replace(/\\/g, "/").replace(/^\/+/, "").replace(/\/+$/, "");
+	if (normalized.includes("\0") || normalized.split("/").some((part) => part === "..")) throw new FileServiceError(400, "Invalid file path");
+	return normalized.split("/").filter((part) => part && part !== ".").join("/");
+}
+function mimeType(name, directory) {
+	if (directory) return "inode/directory";
+	return MIME_TYPES[name.includes(".") ? name.split(".").pop().toLowerCase() : ""] ?? "application/octet-stream";
+}
+function capabilities(name, directory, writable) {
+	if (directory) return writable ? ["upload"] : [];
+	const extension = name.includes(".") ? name.split(".").pop().toLowerCase() : "";
+	const result = ["download", "share"];
+	if (MIME_TYPES[extension] || TEXT_EXTENSIONS.has(extension)) result.unshift("preview");
+	if (writable && TEXT_EXTENSIONS.has(extension)) result.push("edit");
+	return result;
+}
+function fileSpaceId(root) {
+	return createHash("sha256").update(root).digest("base64url").slice(0, 24);
+}
+function fileResourceId(spaceId, relativePath) {
+	return `${spaceId}.${Buffer.from(normalizeRelativePath(relativePath)).toString("base64url")}`;
+}
+function parseFileResourceId(id) {
+	const separator = id.indexOf(".");
+	if (separator <= 0) throw new FileServiceError(400, "Invalid file id");
+	try {
+		return {
+			spaceId: id.slice(0, separator),
+			relativePath: normalizeRelativePath(Buffer.from(id.slice(separator + 1), "base64url").toString("utf8"))
+		};
+	} catch (error) {
+		if (error instanceof FileServiceError) throw error;
+		throw new FileServiceError(400, "Invalid file id");
+	}
+}
+async function resolveFilePath(root, path, mustExist = true) {
+	const canonicalRoot = await realpath(root).catch(() => {
+		throw new FileServiceError(404, "File space is unavailable");
+	});
+	const candidate = resolve(canonicalRoot, normalizeRelativePath(path));
+	if (!isWithin(canonicalRoot, candidate)) throw new FileServiceError(400, "Invalid file path");
+	if (!mustExist) {
+		if (!isWithin(canonicalRoot, await realpath(dirname(candidate)).catch(() => {
+			throw new FileServiceError(404, "Parent directory not found");
+		}))) throw new FileServiceError(400, "Invalid file path");
+		return candidate;
+	}
+	const canonicalTarget = await realpath(candidate).catch(() => {
+		throw new FileServiceError(404, "File not found");
+	});
+	if (!isWithin(canonicalRoot, canonicalTarget)) throw new FileServiceError(400, "File is outside its space");
+	return canonicalTarget;
+}
+var FileServiceError = class extends Error {
+	constructor(status, message) {
+		super(message);
+		this.status = status;
+	}
+};
+async function fileResourceFromPath(space, 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 directory = info.isDirectory();
+	return {
+		id: fileResourceId(space.id, relativePath),
+		spaceId: space.id,
+		name,
+		relativePath,
+		parentPath: dirname(relativePath).split(sep).join("/").replace(/^\.$/, ""),
+		kind: directory ? "directory" : "file",
+		mimeType: mimeType(name, directory),
+		size: info.size,
+		modifiedAt: Math.max(0, Math.round(info.mtimeMs)),
+		revision: `${revisionInfo.mtimeNs}:${revisionInfo.ctimeNs}:${revisionInfo.ino}:${revisionInfo.size}`,
+		capabilities: capabilities(name, directory, space.writable)
+	};
+}
+var FileSpaceService = class {
+	dynamicSpaces = /* @__PURE__ */ new Map();
+	cache = null;
+	constructor(getConfig, projects, resolveSessionWorkspace) {
+		this.getConfig = getConfig;
+		this.projects = projects;
+		this.resolveSessionWorkspace = resolveSessionWorkspace;
+	}
+	async createSpace(root, title, bindings) {
+		const canonicalRoot = await realpath(root).catch(() => null);
+		if (!canonicalRoot) return null;
+		const rootStat = await stat(canonicalRoot).catch(() => null);
+		if (!rootStat?.isDirectory()) return null;
+		const writable = await access(canonicalRoot, constants.W_OK).then(() => true).catch(() => false);
+		return {
+			id: fileSpaceId(canonicalRoot),
+			title,
+			kind: "workspace",
+			bindings,
+			writable,
+			root: canonicalRoot,
+			lastActivityAt: Math.max(0, Math.round(rootStat.mtimeMs))
+		};
+	}
+	async list() {
+		if (this.cache && Date.now() - this.cache.at < 5e3) return this.cache.spaces;
+		const config = this.getConfig();
+		const spaces = [];
+		for (const agent of listAgentEntries(config)) {
+			const space = await this.createSpace(resolveAgentWorkspaceDir(config, agent.id), agent.id, [{
+				kind: "agent",
+				id: agent.id
+			}]);
+			if (space) spaces.push(space);
+		}
+		let offset = 0;
+		while (true) {
+			const page = this.projects.list({
+				limit: 500,
+				offset
+			});
+			for (const project of page.items) {
+				const agentId = resolveProjectAgentId({
+					config,
+					projects: this.projects,
+					projectId: project.id
+				});
+				const root = project.workspaceRoot ?? resolveAgentWorkspaceDir(config, agentId);
+				const space = await this.createSpace(root, project.name, [{
+					kind: "project",
+					id: project.id
+				}]);
+				if (space) spaces.push(space);
+			}
+			if (!page.hasMore || page.items.length === 0) break;
+			offset += page.items.length;
+		}
+		const merged = /* @__PURE__ */ new Map();
+		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))];
+			else merged.set(space.id, {
+				...space,
+				bindings: [...space.bindings]
+			});
+		}
+		const result = [...merged.values()].sort((a, b) => (b.lastActivityAt ?? 0) - (a.lastActivityAt ?? 0));
+		this.cache = {
+			at: Date.now(),
+			spaces: result
+		};
+		return result;
+	}
+	async forContext(kind, id) {
+		let root;
+		let title = id;
+		if (kind === "agent") root = resolveAgentWorkspaceDir(this.getConfig(), id);
+		if (kind === "project") {
+			const project = this.projects.get(id);
+			if (project) {
+				const config = this.getConfig();
+				const agentId = resolveProjectAgentId({
+					config,
+					projects: this.projects,
+					projectId: id
+				});
+				root = project.workspaceRoot ?? resolveAgentWorkspaceDir(config, agentId);
+			}
+			title = project?.name ?? id;
+		}
+		if (kind === "session") root = this.resolveSessionWorkspace(id);
+		if (!root) throw new FileServiceError(404, "File space not found");
+		const space = await this.createSpace(root, title, [{
+			kind,
+			id
+		}]);
+		if (!space) throw new FileServiceError(404, "File space is unavailable");
+		this.dynamicSpaces.set(space.id, space);
+		this.cache = null;
+		return space;
+	}
+	async get(id) {
+		const space = (await this.list()).find((item) => item.id === id);
+		if (!space) throw new FileServiceError(404, "File space not found");
+		return space;
+	}
+	async resource(id) {
+		const locator = parseFileResourceId(id);
+		const space = await this.get(locator.spaceId);
+		const absolutePath = await resolveFilePath(space.root, locator.relativePath);
+		return {
+			space,
+			resource: await fileResourceFromPath(space, absolutePath),
+			absolutePath
+		};
+	}
+	async children(spaceId, path = "") {
+		const space = await this.get(spaceId);
+		const directory = await resolveFilePath(space.root, path);
+		if (!(await stat(directory)).isDirectory()) throw new FileServiceError(400, "Path is not a directory");
+		const entries = [];
+		const dir = await opendir(directory);
+		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));
+		}
+		return entries.sort((a, b) => a.kind === b.kind ? a.name.localeCompare(b.name) : a.kind === "directory" ? -1 : 1);
+	}
+};
+//#endregion
+export { FileServiceError, FileSpaceService, fileResourceFromPath, fileResourceId, fileSpaceId, parseFileResourceId, resolveFilePath };