@steerable/agent-shell 0.6.48 → 0.6.50

package/dist/host/runtime.js

@@ -208,9 +208,9 @@ export async function createHostRuntime(options) {
                 onLog(`[task] swept ${sweptTasks} stale running task(s)`);
             }
             void localExecutor.init();
-            // Not awaited: sidecar boot (python import) must not delay readiness.
-            // A turn that races the boot falls back for that turn only.
-            void startHostSidecar({
+            // The complete Python sidecar is mandatory. Do not report host
+            // readiness or fall back to an in-process loop when it cannot start.
+            await startHostSidecar({
                 store: defaultStore,
                 toolRouter,
                 resolveProjectRoot: async (chatId) => localBackendRouter.resolveChatWorkspaceRoot(chatId),

package/dist/host-tools.d.ts

@@ -34,7 +34,7 @@ export type ResolvedSettingsChrome = Record<SettingsItemId, boolean>;
  */
 export declare function resolveSettingsChrome(value?: unknown, tools?: ResolvedHostTools): ResolvedSettingsChrome;
 export declare function hasGeneralSettingsChrome(chrome?: ResolvedSettingsChrome): boolean;
-export declare const LOCAL_FS_TOOL_NAMES: readonly ["local_exec_shell", "local_read_file", "view_image", "local_write_file", "local_edit_file", "local_open_path", "local_run_snippet", "local_list_scripts", "local_run_script"];
+export declare const LOCAL_FS_TOOL_NAMES: readonly ["local_exec_shell", "local_read_file", "view_image", "local_write_file", "local_edit_file", "present_files", "local_open_path", "local_run_snippet", "local_list_scripts", "local_run_script"];
 export declare function resolveHostToolSurface(value: boolean | {
     capability?: boolean;
     chrome?: boolean;

package/dist/host-tools.js

@@ -79,6 +79,7 @@ export const LOCAL_FS_TOOL_NAMES = [
     'view_image',
     'local_write_file',
     'local_edit_file',
+    'present_files',
     'local_open_path',
     'local_run_snippet',
     'local_list_scripts',

package/dist/llm/sidecar-provider.d.ts

@@ -2,10 +2,6 @@
  * `LlmProvider` implementation that delegates to the steerable-sidecar's
  * `agent.chat.stream` JSON-RPC method.
  *
- * Activation:
- *   Default-on once the sidecar is supervised (see `llm/index.ts`);
- *   `STEERABLE_USE_SIDECAR=0` opts back out to in-process providers.
- *
  * The sidecar must already be supervised by the main process (see
  * `src/sidecar/supervisor.ts`); this provider just routes calls through the
  * supplied supervisor handle and aggregates streamed chunks back into the

package/dist/llm/sidecar-provider.js

@@ -2,10 +2,6 @@
  * `LlmProvider` implementation that delegates to the steerable-sidecar's
  * `agent.chat.stream` JSON-RPC method.
  *
- * Activation:
- *   Default-on once the sidecar is supervised (see `llm/index.ts`);
- *   `STEERABLE_USE_SIDECAR=0` opts back out to in-process providers.
- *
  * The sidecar must already be supervised by the main process (see
  * `src/sidecar/supervisor.ts`); this provider just routes calls through the
  * supplied supervisor handle and aggregates streamed chunks back into the

package/dist/local-backend/coreloop-stream.d.ts

@@ -9,9 +9,7 @@
  *
  * This is the only chat path (the TS loop was deleted 2026-08-26). If the
  * sidecar failed to start, the router fails loud with a 503 — there is no
- * in-process fallback loop anymore. `STEERABLE_USE_SIDECAR=0` still
- * disables the sidecar process itself (auxiliary LLM calls then fall back
- * to the in-proc providers), but chat requires the sidecar.
+ * in-process fallback loop or sidecar opt-out.
  */
 import type { SidecarChatStreamRequest, SidecarChildEvent, SidecarRawChunk, SidecarSupervisor } from '../sidecar/index.js';
 import type { LlmMessage } from '../llm/types.js';

package/dist/local-backend/coreloop-stream.js

@@ -9,9 +9,7 @@
  *
  * This is the only chat path (the TS loop was deleted 2026-08-26). If the
  * sidecar failed to start, the router fails loud with a 503 — there is no
- * in-process fallback loop anymore. `STEERABLE_USE_SIDECAR=0` still
- * disables the sidecar process itself (auxiliary LLM calls then fall back
- * to the in-proc providers), but chat requires the sidecar.
+ * in-process fallback loop or sidecar opt-out.
  */
 /**
  * Active CoreLoop turns by chatId — lets the main process route a mid-turn

package/dist/local-backend/portable-bundle.d.ts

@@ -0,0 +1,202 @@
+/**
+ * 对话包 / 配置包的文件格式。纯函数：不读库、不写盘。
+ *
+ * 文件是一个 JSON 对象。`kind` 区分配置、单条对话和多条对话，`schemaVersion` 只认 1。
+ * 钥匙（模型 Key、搜索 Key、MCP 环境变量）默认不进包；`includeSecrets`
+ * 为 true 时原样写入，导入方要自己确认。
+ */
+export declare const PORTABLE_SCHEMA_VERSION = 1;
+export declare const PORTABLE_MESSAGE_LIMIT = 1000;
+export declare const PORTABLE_CONFIG_KIND = "steerable-config";
+export declare const PORTABLE_CHAT_KIND = "steerable-chat";
+export declare const PORTABLE_CHATS_KIND = "steerable-chats";
+export declare const SERVER_SECTION_IDS: readonly ["llm", "webSearch", "telemetry", "insights", "mcp", "agents", "skills"];
+export declare const CLIENT_SECTION_IDS: readonly ["appearance", "execPolicy"];
+export type ServerSectionId = (typeof SERVER_SECTION_IDS)[number];
+export type ClientSectionId = (typeof CLIENT_SECTION_IDS)[number];
+export type PortableSectionId = ServerSectionId | ClientSectionId;
+export interface PortablePreviewSection {
+    id: PortableSectionId;
+    label: string;
+    detail: string;
+    clientOnly: boolean;
+    hasSecret: boolean;
+}
+export interface PortableChatSummary {
+    title: string;
+    messageCount: number;
+    attachmentCount: number;
+    omittedAttachmentCount: number;
+    truncated: boolean;
+    /** 多条对话包里的会话数。单条对话包不带这个字段。 */
+    count?: number;
+    /** 单条对话所属项目，或多条包里只有一个项目时的名字。 */
+    projectName?: string;
+    /** 包里出现的项目数。没有项目时不带。 */
+    projectCount?: number;
+}
+/** 项目登记。只含名称和目录位置，不含目录里的文件。 */
+export interface PortableProject {
+    name: string;
+    folderPath: string;
+    sourceFolders: string[];
+    trusted: boolean;
+}
+export interface PortablePreview {
+    kind: typeof PORTABLE_CONFIG_KIND | typeof PORTABLE_CHAT_KIND | typeof PORTABLE_CHATS_KIND;
+    includeSecrets: boolean;
+    sections: PortablePreviewSection[];
+    chat?: PortableChatSummary;
+}
+export interface PortableLlmSection {
+    provider?: string;
+    vendorId?: string;
+    model?: string;
+    baseUrl?: string;
+    temperature?: number;
+    systemPrompt?: string;
+    maxTotalTokens?: number;
+    compat?: unknown;
+    presets?: unknown;
+    execTimeoutSeconds?: number;
+    apiKeyIncluded: boolean;
+    apiKey?: string;
+}
+export interface PortableWebSearchSection {
+    provider?: string;
+    apiKeyIncluded: boolean;
+    apiKey?: string;
+}
+export interface PortableMcpSection {
+    name: string;
+    command: string;
+    args: string[];
+    cwd?: string;
+    enabled: boolean;
+    envIncluded: boolean;
+    env?: Record<string, string>;
+}
+export interface PortableAgentSection {
+    name: string;
+    slug?: string | null;
+    icon?: string | null;
+    color?: string | null;
+    description?: string | null;
+    rolePrompt?: string | null;
+    forbiddenPrompt?: string | null;
+    skillIds?: string[];
+    toolPolicy?: unknown;
+    allowExternalSkills?: boolean;
+    loadAllSkills?: boolean;
+    isArchived?: boolean;
+    sortOrder?: number;
+}
+export interface PortableSkillSection {
+    names: string[];
+}
+export interface PortableInsightsSection {
+    shareBehavior?: boolean;
+    shareConversation?: boolean;
+    shareProfile?: boolean;
+    promptedAt?: string;
+    apiBase?: string;
+    profile?: {
+        displayName?: string;
+        email?: string;
+        company?: string;
+        note?: string;
+    };
+}
+export interface PortableTelemetrySection {
+    endpoint?: string;
+    privacyMode?: string;
+    serviceName?: string;
+}
+export interface PortableAppearanceSection {
+    thinkingDisplay?: string;
+}
+export interface PortableExecPolicySection {
+    policy?: string;
+}
+export interface PortableConfigSections {
+    llm?: PortableLlmSection;
+    webSearch?: PortableWebSearchSection;
+    telemetry?: PortableTelemetrySection;
+    insights?: PortableInsightsSection;
+    mcp?: PortableMcpSection[];
+    agents?: PortableAgentSection[];
+    skills?: PortableSkillSection;
+    appearance?: PortableAppearanceSection;
+    execPolicy?: PortableExecPolicySection;
+}
+export interface PortableConfigDocument {
+    kind: typeof PORTABLE_CONFIG_KIND;
+    schemaVersion: number;
+    exportedAt: string;
+    includeSecrets: boolean;
+    sections: PortableConfigSections;
+}
+export interface PortableChatMessage {
+    role: string;
+    content: string;
+    messageMetadata: string | null;
+    createdAt: string;
+}
+export interface PortableChatAttachment {
+    name: string;
+    size: number;
+    /** base64。过大时缺省，并标 `omitted`。 */
+    data?: string;
+    omitted?: boolean;
+}
+export interface PortableChatDocument {
+    kind: typeof PORTABLE_CHAT_KIND;
+    schemaVersion: number;
+    exportedAt: string;
+    chat: {
+        title: string;
+        agentId: string | null;
+        isPinned: boolean;
+        systemPrompt: string | null;
+        pinnedRefs: unknown;
+    };
+    /** 所属项目。没有项目时缺省。目录里的文件不在这里。 */
+    project?: PortableProject;
+    messages: PortableChatMessage[];
+    truncated: boolean;
+    attachments: PortableChatAttachment[];
+}
+export type PortableDocument = PortableConfigDocument | PortableChatDocument;
+export declare function isServerSectionId(value: string): value is ServerSectionId;
+export declare function isClientSectionId(value: string): value is ClientSectionId;
+/** 读项目登记。缺名字或缺家目录时当作没有项目，不把目录内容读进来。 */
+export declare function readPortableProject(raw: unknown): PortableProject | null;
+export declare function llmSectionFromSettings(settings: Record<string, unknown>, includeSecrets: boolean): PortableLlmSection;
+export declare function webSearchSectionFromSettings(settings: {
+    provider?: string;
+    apiKey?: string | null;
+}, includeSecrets: boolean): PortableWebSearchSection;
+export declare function mcpSectionFromServer(server: {
+    name: string;
+    command: string;
+    args: string[];
+    cwd?: string;
+    enabled: boolean;
+    env: Record<string, string>;
+}, includeSecrets: boolean): PortableMcpSection;
+/**
+ * 把消息正文和 metadata 里的旧附件绝对路径换成新会话里的路径。
+ * 只改 `/attachments/<chatId>/<文件名>` 这一段，文件名必须整段匹配。
+ */
+export declare function rewriteAttachmentRefs(text: string, name: string, newPath: string): string;
+/** 读一份导出文件。版本或 kind 不对时返回错误文案，不抛。 */
+export declare function previewPortable(raw: unknown): PortablePreview | {
+    error: string;
+};
+export declare function readConfigDocument(raw: unknown): PortableConfigDocument | {
+    error: string;
+};
+export declare function readChatDocument(raw: unknown): PortableChatDocument | {
+    error: string;
+};
+export declare function selectedServerSections(sections: PortableConfigSections, selected: readonly string[] | undefined): ServerSectionId[];

package/dist/local-backend/portable-bundle.js

@@ -0,0 +1,318 @@
+/**
+ * 对话包 / 配置包的文件格式。纯函数：不读库、不写盘。
+ *
+ * 文件是一个 JSON 对象。`kind` 区分配置、单条对话和多条对话，`schemaVersion` 只认 1。
+ * 钥匙（模型 Key、搜索 Key、MCP 环境变量）默认不进包；`includeSecrets`
+ * 为 true 时原样写入，导入方要自己确认。
+ */
+export const PORTABLE_SCHEMA_VERSION = 1;
+export const PORTABLE_MESSAGE_LIMIT = 1000;
+export const PORTABLE_CONFIG_KIND = 'steerable-config';
+export const PORTABLE_CHAT_KIND = 'steerable-chat';
+export const PORTABLE_CHATS_KIND = 'steerable-chats';
+export const SERVER_SECTION_IDS = [
+    'llm',
+    'webSearch',
+    'telemetry',
+    'insights',
+    'mcp',
+    'agents',
+    'skills',
+];
+export const CLIENT_SECTION_IDS = ['appearance', 'execPolicy'];
+const SECTION_LABELS = {
+    appearance: '界面',
+    execPolicy: '命令权限',
+    llm: '本地模型',
+    webSearch: '网络搜索',
+    telemetry: '遥测',
+    insights: '帮助改进产品',
+    mcp: 'MCP 服务',
+    agents: '智能体',
+    skills: '技能引用',
+};
+const MESSAGE_ROLES = new Set(['user', 'assistant', 'system', 'tool']);
+export function isServerSectionId(value) {
+    return SERVER_SECTION_IDS.includes(value);
+}
+export function isClientSectionId(value) {
+    return CLIENT_SECTION_IDS.includes(value);
+}
+function isRecord(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+function asString(value) {
+    return typeof value === 'string' ? value : undefined;
+}
+/** 读项目登记。缺名字或缺家目录时当作没有项目，不把目录内容读进来。 */
+export function readPortableProject(raw) {
+    if (!isRecord(raw))
+        return null;
+    const name = asString(raw.name)?.trim() ?? '';
+    const folderPath = asString(raw.folderPath)?.trim() ?? '';
+    if (!name || !folderPath)
+        return null;
+    const sourceFolders = Array.isArray(raw.sourceFolders)
+        ? raw.sourceFolders.filter((item) => typeof item === 'string' && item.trim().length > 0)
+        : [];
+    return {
+        name,
+        folderPath,
+        sourceFolders,
+        trusted: raw.trusted === true,
+    };
+}
+function thinkingLabel(mode) {
+    if (mode === 'hidden')
+        return '隐藏';
+    if (mode === 'full')
+        return '完整显示';
+    if (mode === 'peek')
+        return '显示5行';
+    return '未识别的显示档位';
+}
+function execLabel(policy) {
+    if (policy === 'full')
+        return '完整权限';
+    if (policy === 'workspace')
+        return '工作区';
+    return '未识别的权限';
+}
+export function llmSectionFromSettings(settings, includeSecrets) {
+    const apiKey = asString(settings.apiKey);
+    const includeKey = includeSecrets && Boolean(apiKey);
+    return {
+        provider: asString(settings.provider),
+        vendorId: asString(settings.vendorId),
+        model: asString(settings.model),
+        baseUrl: asString(settings.baseUrl),
+        temperature: typeof settings.temperature === 'number' ? settings.temperature : undefined,
+        systemPrompt: asString(settings.systemPrompt),
+        maxTotalTokens: typeof settings.maxTotalTokens === 'number' ? settings.maxTotalTokens : undefined,
+        compat: settings.compat,
+        presets: settings.presets,
+        execTimeoutSeconds: typeof settings.execTimeoutSeconds === 'number' ? settings.execTimeoutSeconds : undefined,
+        apiKeyIncluded: includeKey,
+        ...(includeKey ? { apiKey } : {}),
+    };
+}
+export function webSearchSectionFromSettings(settings, includeSecrets) {
+    const apiKey = typeof settings.apiKey === 'string' ? settings.apiKey : undefined;
+    const includeKey = includeSecrets && Boolean(apiKey);
+    return {
+        provider: settings.provider,
+        apiKeyIncluded: includeKey,
+        ...(includeKey ? { apiKey } : {}),
+    };
+}
+export function mcpSectionFromServer(server, includeSecrets) {
+    return {
+        name: server.name,
+        command: server.command,
+        args: [...server.args],
+        cwd: server.cwd,
+        enabled: server.enabled,
+        envIncluded: includeSecrets,
+        ...(includeSecrets ? { env: { ...server.env } } : {}),
+    };
+}
+/**
+ * 把消息正文和 metadata 里的旧附件绝对路径换成新会话里的路径。
+ * 只改 `/attachments/<chatId>/<文件名>` 这一段，文件名必须整段匹配。
+ */
+export function rewriteAttachmentRefs(text, name, newPath) {
+    if (!name || !text.includes('/attachments/'))
+        return text;
+    const escaped = name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const boundary = '[^\\s`\'"]';
+    const end = '[\\s`\'"]';
+    return text.replace(new RegExp(`${boundary}*/attachments/${boundary}+/${escaped}(?=${end}|$)`, 'g'), () => newPath);
+}
+function sectionPreview(id, value) {
+    const label = SECTION_LABELS[id];
+    const clientOnly = isClientSectionId(id);
+    if (id === 'llm' && isRecord(value)) {
+        const model = asString(value.model) || '未填模型';
+        const vendor = asString(value.vendorId) || asString(value.provider) || '模型';
+        const hasSecret = value.apiKeyIncluded === true;
+        return {
+            id,
+            label,
+            detail: `${vendor} · ${model}${hasSecret ? ' · 含钥匙' : ''}`,
+            clientOnly,
+            hasSecret,
+        };
+    }
+    if (id === 'webSearch' && isRecord(value)) {
+        const hasSecret = value.apiKeyIncluded === true;
+        return {
+            id,
+            label,
+            detail: `${asString(value.provider) || '搜索'}${hasSecret ? ' · 含钥匙' : ''}`,
+            clientOnly,
+            hasSecret,
+        };
+    }
+    if (id === 'mcp' && Array.isArray(value)) {
+        const hasSecret = value.some((item) => isRecord(item) && item.envIncluded === true);
+        return {
+            id,
+            label,
+            detail: `${value.length} 个服务${hasSecret ? ' · 含环境变量' : ''}`,
+            clientOnly,
+            hasSecret,
+        };
+    }
+    if (id === 'agents' && Array.isArray(value)) {
+        return { id, label, detail: `${value.length} 个自定义智能体`, clientOnly, hasSecret: false };
+    }
+    if (id === 'skills' && isRecord(value) && Array.isArray(value.names)) {
+        return { id, label, detail: `${value.names.length} 个技能名`, clientOnly, hasSecret: false };
+    }
+    if (id === 'telemetry' && isRecord(value)) {
+        return {
+            id,
+            label,
+            detail: asString(value.endpoint) || '未配置端点',
+            clientOnly,
+            hasSecret: false,
+        };
+    }
+    if (id === 'insights' && isRecord(value)) {
+        return { id, label, detail: '同意项与资料', clientOnly, hasSecret: false };
+    }
+    if (id === 'appearance' && isRecord(value)) {
+        return { id, label, detail: thinkingLabel(value.thinkingDisplay), clientOnly, hasSecret: false };
+    }
+    if (id === 'execPolicy' && isRecord(value)) {
+        return { id, label, detail: execLabel(value.policy), clientOnly, hasSecret: false };
+    }
+    return null;
+}
+function previewConfig(doc) {
+    const sections = isRecord(doc.sections) ? doc.sections : null;
+    if (!sections)
+        return { error: '配置包缺少 sections' };
+    const listed = [];
+    for (const id of [...CLIENT_SECTION_IDS, ...SERVER_SECTION_IDS]) {
+        if (!(id in sections))
+            continue;
+        const row = sectionPreview(id, sections[id]);
+        if (row)
+            listed.push(row);
+    }
+    return {
+        kind: PORTABLE_CONFIG_KIND,
+        includeSecrets: doc.includeSecrets === true,
+        sections: listed,
+    };
+}
+function previewChat(doc) {
+    const chat = isRecord(doc.chat) ? doc.chat : null;
+    if (!chat || typeof chat.title !== 'string' || !chat.title.trim()) {
+        return { error: '对话包缺少标题' };
+    }
+    if (!Array.isArray(doc.messages))
+        return { error: '对话包缺少 messages' };
+    const attachments = Array.isArray(doc.attachments) ? doc.attachments : [];
+    const withData = attachments.filter((item) => isRecord(item) && typeof item.data === 'string' && !item.omitted);
+    const omitted = attachments.filter((item) => isRecord(item) && item.omitted === true);
+    const project = readPortableProject(doc.project);
+    return {
+        kind: PORTABLE_CHAT_KIND,
+        includeSecrets: false,
+        sections: [],
+        chat: {
+            title: chat.title.trim(),
+            messageCount: doc.messages.length,
+            attachmentCount: withData.length,
+            omittedAttachmentCount: omitted.length,
+            truncated: doc.truncated === true,
+            ...(project ? { projectName: project.name, projectCount: 1 } : {}),
+        },
+    };
+}
+/** 读一份导出文件。版本或 kind 不对时返回错误文案，不抛。 */
+export function previewPortable(raw) {
+    if (!isRecord(raw))
+        return { error: '文件不是 JSON 对象' };
+    if (raw.schemaVersion !== PORTABLE_SCHEMA_VERSION) {
+        return { error: '无法读取这份文件，需要更新客户端' };
+    }
+    if (raw.kind === PORTABLE_CONFIG_KIND)
+        return previewConfig(raw);
+    if (raw.kind === PORTABLE_CHAT_KIND)
+        return previewChat(raw);
+    if (raw.kind === PORTABLE_CHATS_KIND)
+        return previewChats(raw);
+    return { error: '无法识别的导出文件' };
+}
+function previewChats(doc) {
+    if (!Array.isArray(doc.chats) || doc.chats.length === 0)
+        return { error: '对话包里没有对话' };
+    const titles = [];
+    const projectNames = new Set();
+    let messageCount = 0;
+    let attachmentCount = 0;
+    let omittedAttachmentCount = 0;
+    let truncated = false;
+    for (const item of doc.chats) {
+        if (!isRecord(item))
+            return { error: '对话包里有无法读取的会话' };
+        const one = previewChat(item);
+        if ('error' in one || !one.chat) {
+            return 'error' in one ? one : { error: '对话包里有无法读取的会话' };
+        }
+        titles.push(one.chat.title);
+        if (one.chat.projectName)
+            projectNames.add(one.chat.projectName);
+        messageCount += one.chat.messageCount;
+        attachmentCount += one.chat.attachmentCount;
+        omittedAttachmentCount += one.chat.omittedAttachmentCount;
+        truncated = truncated || one.chat.truncated;
+    }
+    const count = titles.length;
+    const projectCount = projectNames.size;
+    const onlyProject = projectCount === 1 ? [...projectNames][0] : undefined;
+    return {
+        kind: PORTABLE_CHATS_KIND,
+        includeSecrets: false,
+        sections: [],
+        chat: {
+            title: count === 1 ? (titles[0] ?? '未命名') : `${count} 条对话`,
+            messageCount,
+            attachmentCount,
+            omittedAttachmentCount,
+            truncated,
+            count,
+            ...(projectCount > 0 ? { projectCount, ...(onlyProject ? { projectName: onlyProject } : {}) } : {}),
+        },
+    };
+}
+export function readConfigDocument(raw) {
+    const preview = previewPortable(raw);
+    if ('error' in preview)
+        return preview;
+    if (preview.kind !== PORTABLE_CONFIG_KIND)
+        return { error: '这是对话包，不能当作配置导入' };
+    return raw;
+}
+export function readChatDocument(raw) {
+    const preview = previewPortable(raw);
+    if ('error' in preview)
+        return preview;
+    if (preview.kind !== PORTABLE_CHAT_KIND)
+        return { error: '这是配置包，请在设置页导入' };
+    const doc = raw;
+    const messages = doc.messages.filter((message) => message &&
+        MESSAGE_ROLES.has(message.role) &&
+        typeof message.content === 'string');
+    return { ...doc, messages };
+}
+export function selectedServerSections(sections, selected) {
+    const present = SERVER_SECTION_IDS.filter((id) => sections[id] !== undefined);
+    if (!selected)
+        return [...present];
+    const allow = new Set(selected);
+    return present.filter((id) => allow.has(id));
+}

package/dist/local-backend/portable-service.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 对话包 / 配置包的读写。路由只负责在产品开关打开时把请求转进来。
+ */
+import { type PortableChatDocument, type PortableConfigDocument } from './portable-bundle.js';
+import type { ProjectRegistry } from '../project-registry.js';
+import type { McpServerRegistry } from '../mcp-server-registry.js';
+import type { ScopedStore } from '../storage/scoped-store.js';
+export interface PortableResponse {
+    status: number;
+    data: unknown;
+}
+export declare function exportConfigDocument(store: ScopedStore, mcp: McpServerRegistry | null, includeSecrets: boolean): Promise<PortableConfigDocument>;
+export declare function exportChatDocument(store: ScopedStore, chatId: string, projects?: ProjectRegistry | null): Promise<PortableChatDocument | null>;
+export declare function importConfigDocument(store: ScopedStore, mcp: McpServerRegistry | null, raw: unknown, selected: readonly string[] | undefined): Promise<PortableResponse>;
+export declare function handlePortableRequest(input: {
+    method: string;
+    pathname: string;
+    includeSecrets: boolean;
+    body: unknown;
+    store: ScopedStore;
+    mcp: McpServerRegistry | null;
+    projects: ProjectRegistry | null;
+}): Promise<PortableResponse>;