@downcity/agent 1.1.8 → 1.1.11

package/bin/runtime/AgentRuntime.js

@@ -0,0 +1,296 @@
+/**
+ * AgentRuntime：agent 宿主装配与导出模块。
+ *
+ * 关键点（中文）
+ * - 这里是单 agent 宿主的主装配入口，负责把 config、model、session、service、plugin 串起来。
+ * - 完整运行态类型仍由 `AgentRuntimeState.ts` 维护；本模块只负责装配与对外导出。
+ * - 该模块同时负责热重载提示词系统与导出统一的 `getAgentContext()` 入口。
+ * - 当前只有 `api` 执行模式：从 console 模型池取模型，走 LocalSessionCore。
+ */
+import path from "path";
+import fs from "fs";
+import { logger as defaultLogger } from "../utils/logger/Logger.js";
+import { LocalSessionExecutor } from "../session/executors/local/LocalSessionExecutor.js";
+import { ensureRuntimeProjectReady } from "../host/daemon/ProjectSetup.js";
+import { createModel } from "../model/CreateModel.js";
+import { loadGlobalEnvFromStore, loadAgentEnvSnapshot, loadDowncityConfig, } from "../config/Config.js";
+import { getDowncityJsonPath } from "../config/Paths.js";
+import { getTaskRunDir, parseTaskRunSessionId, } from "../service/builtins/task/runtime/Paths.js";
+import { setShellToolRuntime, shellTools } from "../session/tools/shell/ShellToolDefinition.js";
+import { getSessionRunScope } from "../session/SessionRunScope.js";
+import { JsonlSessionHistoryComposer } from "../session/composer/history/jsonl/JsonlSessionHistoryComposer.js";
+import { JsonlSessionCompactionComposer } from "../session/composer/compaction/jsonl/JsonlSessionCompactionComposer.js";
+import { DefaultSessionSystemComposer } from "../session/composer/system/default/DefaultSessionSystemComposer.js";
+import { ChatSession } from "../service/builtins/chat/runtime/ChatSession.js";
+import { ChatSessionExecutionComposer } from "../service/builtins/chat/runtime/ChatSessionExecutionComposer.js";
+import { loadStaticSystemPrompts, StaticPromptCatalog, } from "../session/composer/system/default/StaticPromptCatalog.js";
+import { getAgentContext, } from "../runtime/AgentContext.js";
+import { getAgentRuntime, getAgentRuntimeBase, setAgentRuntime, setAgentRuntimeBase, } from "../runtime/AgentRuntimeState.js";
+import { createRegisteredServiceInstances } from "../service/core/ServiceClassRegistry.js";
+import { readProjectPrimaryModelId } from "../project/ProjectExecutionBinding.js";
+import { initializePluginManager, resetPluginManager } from "../plugin/core/PluginManager.js";
+import { clearPluginRuntimeContextResolver, setPluginRuntimeContextResolver, } from "../host/runtime/PluginRuntime.js";
+import { createAgentPathRuntime, createAgentPluginConfigRuntime, } from "../host/runtime/AgentHostRuntime.js";
+import { updateAgentRuntimeConfig } from "../runtime/AgentRuntimeState.js";
+export { getAgentRuntime, getAgentRuntimeBase, setAgentRuntime, setAgentRuntimeBase, requireAgentModel, } from "../runtime/AgentRuntimeState.js";
+export { getAgentContext } from "../runtime/AgentContext.js";
+let staticPromptCatalog = null;
+let configWatchPath = null;
+const EMPTY_RUNTIME_PLATFORM = {
+    getGlobalEnv: () => ({}),
+    getAgentEnv: () => ({}),
+    listModels: () => [],
+    listProviders: async () => [],
+    getModel: () => null,
+    getChannelAccount: () => null,
+    readChatAuthorizationConfig: () => ({ roles: {}, channels: {} }),
+    writeChatAuthorizationConfig: async (_projectRoot, nextConfig) => nextConfig,
+    setChatAuthorizationUserRole: async () => ({ roles: {}, channels: {} }),
+    isPluginEnabled: (pluginName) => pluginName === "auth",
+};
+/**
+ * 原子更新 AgentRuntime.systems（同时覆盖 base + ready）。
+ */
+function applyAgentSystems(nextSystems) {
+    const currentBase = getAgentRuntimeBase();
+    const currentReady = (() => {
+        try {
+            return getAgentRuntime();
+        }
+        catch {
+            return null;
+        }
+    })();
+    setAgentRuntimeBase({
+        ...currentBase,
+        systems: nextSystems,
+    });
+    if (currentReady) {
+        setAgentRuntime({
+            ...currentReady,
+            systems: nextSystems,
+        });
+    }
+}
+/**
+ * 停止 agent 提示词文件热重载监听。
+ */
+export function stopAgentHotReload() {
+    if (staticPromptCatalog) {
+        staticPromptCatalog.stop();
+        staticPromptCatalog = null;
+    }
+    if (configWatchPath) {
+        fs.unwatchFile(configWatchPath);
+        configWatchPath = null;
+    }
+    clearPluginRuntimeContextResolver();
+}
+/**
+ * 刷新当前 agent 的项目配置快照。
+ *
+ * 关键点（中文）
+ * - 这里只更新 `AgentRuntime.config`，不尝试重建长期运行对象。
+ * - 适用于 plugin 启用态、prompt 注入、轻量配置读取这类直接依赖 config 的链路。
+ */
+export function refreshAgentProjectConfig() {
+    const currentBase = getAgentRuntimeBase();
+    const nextConfig = loadDowncityConfig(currentBase.rootPath, {
+        projectEnv: currentBase.env,
+        globalEnv: currentBase.globalEnv,
+    });
+    const prevSerialized = JSON.stringify(currentBase.config);
+    const nextSerialized = JSON.stringify(nextConfig);
+    if (prevSerialized === nextSerialized) {
+        return false;
+    }
+    updateAgentRuntimeConfig(nextConfig);
+    return true;
+}
+/**
+ * 启动 agent 提示词文件热重载监听（PROFILE.md / SOUL.md）。
+ */
+function startAgentHotReload() {
+    stopAgentHotReload();
+    const agent = getAgentRuntime();
+    staticPromptCatalog = new StaticPromptCatalog({
+        rootPath: agent.rootPath,
+        logger: agent.logger,
+        getCurrentSystems: () => getAgentRuntimeBase().systems,
+        applySystems: (nextSystems) => {
+            applyAgentSystems(nextSystems);
+        },
+    });
+    staticPromptCatalog.start();
+    const downcityJsonPath = getDowncityJsonPath(agent.rootPath);
+    configWatchPath = downcityJsonPath;
+    fs.watchFile(downcityJsonPath, {
+        interval: 800,
+        persistent: false,
+    }, () => {
+        try {
+            const changed = refreshAgentProjectConfig();
+            if (changed) {
+                agent.logger.info("Agent config reloaded", {
+                    rootPath: agent.rootPath,
+                    file: downcityJsonPath,
+                });
+            }
+        }
+        catch (error) {
+            agent.logger.warn("Failed to reload agent config", {
+                rootPath: agent.rootPath,
+                file: downcityJsonPath,
+                error: String(error),
+            });
+        }
+    });
+}
+/**
+ * 创建 session history composer。
+ */
+function createSessionHistoryComposer(rootPath, sessionId) {
+    const parsedRun = parseTaskRunSessionId(sessionId);
+    const paths = parsedRun
+        ? (() => {
+            const runDir = getTaskRunDir(rootPath, parsedRun.taskId, parsedRun.timestamp);
+            return {
+                sessionDirPath: runDir,
+            };
+        })()
+        : undefined;
+    return new JsonlSessionHistoryComposer({
+        sessionId,
+        rootPath,
+        ...(paths ? { paths } : {}),
+    });
+}
+/**
+ * 初始化入口。
+ *
+ * 关键点（中文）
+ * - 只有 api 执行模式：从 console 模型池创建模型 → LocalSessionExecutor → LocalSessionCore。
+ */
+export async function initAgentRuntime(cwd, options) {
+    stopAgentHotReload();
+    resetPluginManager();
+    const resolvedCwd = String(cwd || "").trim() || ".";
+    const rootPath = path.resolve(resolvedCwd);
+    defaultLogger.bindProjectRoot(rootPath);
+    ensureRuntimeProjectReady(rootPath);
+    const platform = options?.platform || EMPTY_RUNTIME_PLATFORM;
+    const globalEnv = options?.globalEnv || platform?.getGlobalEnv() || loadGlobalEnvFromStore();
+    const projectEnv = options?.projectEnv ||
+        platform?.getAgentEnv(rootPath) ||
+        loadAgentEnvSnapshot(rootPath);
+    const config = loadDowncityConfig(rootPath, {
+        projectEnv,
+        globalEnv,
+    });
+    process.env.DC_AGENT_PATH = rootPath;
+    process.env.DC_AGENT_NAME = String(config.name || path.basename(rootPath));
+    setAgentRuntimeBase({
+        cwd: resolvedCwd,
+        rootPath,
+        logger: defaultLogger,
+        config,
+        env: projectEnv,
+        globalEnv,
+        systems: [],
+        paths: createAgentPathRuntime(rootPath),
+        pluginConfig: createAgentPluginConfigRuntime(rootPath),
+        platform: platform,
+    });
+    const systems = loadStaticSystemPrompts(rootPath);
+    setAgentRuntimeBase({
+        cwd: resolvedCwd,
+        rootPath,
+        logger: defaultLogger,
+        config,
+        env: projectEnv,
+        globalEnv,
+        systems,
+        paths: createAgentPathRuntime(rootPath),
+        pluginConfig: createAgentPluginConfigRuntime(rootPath),
+        platform: platform,
+    });
+    const primaryModelId = readProjectPrimaryModelId(config);
+    const model = await createModel({
+        config,
+        getSessionRunScope: getSessionRunScope,
+        projectRoot: rootPath,
+        platform,
+    });
+    const compactionComposer = new JsonlSessionCompactionComposer({
+        keepLastMessages: config.context?.messages?.keepLastMessages,
+        maxInputTokensApprox: config.context?.messages?.maxInputTokensApprox,
+        archiveOnCompact: config.context?.messages?.archiveOnCompact,
+        compactRatio: config.context?.messages?.compactRatio,
+    });
+    const systemComposer = new DefaultSessionSystemComposer({
+        projectRoot: rootPath,
+        getStaticSystemPrompts: () => getAgentRuntimeBase().systems,
+        getContext: () => getAgentContext(),
+        profile: "chat",
+    });
+    const sessionsById = new Map();
+    const getSession = (sessionId) => {
+        const key = String(sessionId || "").trim();
+        if (!key) {
+            throw new Error("AgentRuntime.getSession requires a non-empty sessionId");
+        }
+        const existing = sessionsById.get(key);
+        if (existing)
+            return existing;
+        const historyComposer = createSessionHistoryComposer(rootPath, key);
+        const executionComposer = new ChatSessionExecutionComposer({
+            sessionId: key,
+            getTools: () => shellTools,
+            getTurnState: () => created.getTurnState(),
+        });
+        let created;
+        created = new ChatSession({
+            sessionId: key,
+            historyComposer,
+            executionComposer,
+            createExecutor: (sessionHistoryComposer, chatExecutionComposer) => new LocalSessionExecutor({
+                model,
+                logger: defaultLogger,
+                historyComposer: sessionHistoryComposer,
+                compactionComposer,
+                systemComposer,
+                getTools: () => shellTools,
+                executionComposer: chatExecutionComposer,
+            }),
+        });
+        sessionsById.set(key, created);
+        return created;
+    };
+    const agentState = {
+        cwd: resolvedCwd,
+        rootPath,
+        logger: defaultLogger,
+        config,
+        env: projectEnv,
+        globalEnv,
+        systems,
+        paths: createAgentPathRuntime(rootPath),
+        pluginConfig: createAgentPluginConfigRuntime(rootPath),
+        platform: platform,
+        model,
+        getSession,
+        listExecutingSessionIds: () => [...sessionsById.entries()]
+            .filter(([, session]) => session.isExecuting())
+            .map(([sessionId]) => sessionId),
+        getExecutingSessionCount: () => [...sessionsById.values()].filter((session) => session.isExecuting())
+            .length,
+        services: new Map(),
+    };
+    agentState.services = createRegisteredServiceInstances(agentState);
+    setAgentRuntime(agentState);
+    setPluginRuntimeContextResolver(() => getAgentContext());
+    initializePluginManager();
+    setShellToolRuntime(getAgentContext().invoke);
+    startAgentHotReload();
+}
+//# sourceMappingURL=AgentRuntime.js.map

package/bin/runtime/AgentRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRuntime.js","sourceRoot":"","sources":["../../src/runtime/AgentRuntime.ts"],"names":[],"mappings":"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"}

package/bin/runtime/AgentRuntimeState.d.ts

@@ -0,0 +1,42 @@
+/**
+ * AgentRuntime 进程级状态读写模块。
+ *
+ * 关键点（中文）
+ * - 这里统一维护当前进程中的 base / ready 两阶段状态。
+ * - `AgentRuntimeBase` 只表示启动早期已经可用的基础配置；`AgentRuntime` 才表示完整运行态。
+ * - 该模块只负责状态持有与读写，不负责装配具体依赖对象。
+ */
+import type { LanguageModel } from "ai";
+import type { AgentRuntime, AgentRuntimeBase } from "../runtime/AgentRuntimeTypes.js";
+import type { DowncityConfig } from "../types/config/DowncityConfig.js";
+export type { AgentRuntime, AgentRuntimeBase } from "../runtime/AgentRuntimeTypes.js";
+/**
+ * 设置 agent 基础状态。
+ */
+export declare function setAgentRuntimeBase(next: AgentRuntimeBase): void;
+/**
+ * 设置完整 agent 状态。
+ */
+export declare function setAgentRuntime(next: AgentRuntime): void;
+/**
+ * 仅更新当前 agent 的项目配置快照。
+ *
+ * 关键点（中文）
+ * - 运行中 agent 可能在不重启进程的情况下收到 downcity.json 变更。
+ * - 这里仅替换 `config`，不重建 model / service / session 等长期对象。
+ * - 目标是让 plugin 启用态、system 注入等直接依赖配置快照的能力及时生效。
+ */
+export declare function updateAgentRuntimeConfig(nextConfig: DowncityConfig): void;
+/**
+ * 获取 agent 基础状态。
+ */
+export declare function getAgentRuntimeBase(): AgentRuntimeBase;
+/**
+ * 获取完整 agent 状态。
+ */
+export declare function getAgentRuntime(): AgentRuntime;
+/**
+ * 读取当前 agent 模型实例（必填）。
+ */
+export declare function requireAgentModel(): LanguageModel;
+//# sourceMappingURL=AgentRuntimeState.d.ts.map

package/bin/runtime/AgentRuntimeState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRuntimeState.d.ts","sourceRoot":"","sources":["../../src/runtime/AgentRuntimeState.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxC,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EACjB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAOvE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAiHrF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAGhE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAIxD;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI,CAkBzE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,CAKtD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAU9C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,aAAa,CAKjD"}

package/bin/runtime/AgentRuntimeState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRuntimeState.js","sourceRoot":"","sources":["../../src/runtime/AgentRuntimeState.ts"],"names":[],"mappings":"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"}

package/bin/runtime/AgentRuntimeTypes.d.ts

@@ -0,0 +1,85 @@
+/**
+ * AgentRuntime 类型定义。
+ *
+ * 关键点（中文）
+ * - 这里表达的是“当前 agent 进程的长期运行状态”。
+ * - 它不是抽象 host，也不是一次执行上下文。
+ * - Session / Service / Plugin 这些长期对象都应从这里挂出。
+ */
+import type { LanguageModel } from "ai";
+import type { Logger } from "../utils/logger/Logger.js";
+import type { DowncityConfig } from "../types/config/DowncityConfig.js";
+import type { AgentPathRuntime, AgentPlatformRuntime, AgentPluginConfigRuntime } from "../types/host/AgentHost.js";
+import type { BaseService } from "../service/builtins/BaseService.js";
+import type { Session } from "../session/Session.js";
+/**
+ * AgentRuntime 启动早期的基础状态。
+ */
+export interface AgentRuntimeBase {
+    /**
+     * 当前命令工作目录。
+     */
+    cwd: string;
+    /**
+     * 当前 agent 项目根目录。
+     */
+    rootPath: string;
+    /**
+     * 当前统一日志器。
+     */
+    logger: Logger;
+    /**
+     * 当前解析后的项目配置。
+     */
+    config: DowncityConfig;
+    /**
+     * 当前 agent 局部环境变量快照。
+     */
+    env: Record<string, string>;
+    /**
+     * 当前平台级全局环境变量快照。
+     */
+    globalEnv: Record<string, string>;
+    /**
+     * 当前生效的静态 system 文本集合。
+     */
+    systems: string[];
+    /**
+     * 当前 agent 可见的路径能力集合。
+     */
+    paths: AgentPathRuntime;
+    /**
+     * 当前 agent 可见的 plugin 配置持久化能力集合。
+     */
+    pluginConfig: AgentPluginConfigRuntime;
+    /**
+     * 当前 agent 可见的平台能力集合。
+     */
+    platform: AgentPlatformRuntime;
+}
+/**
+ * Agent 进程完整运行状态。
+ */
+export interface AgentRuntime extends AgentRuntimeBase {
+    /**
+     * 当前统一执行模型实例。
+     */
+    model?: LanguageModel;
+    /**
+     * 读取指定 sessionId 对应的 Session 实例。
+     */
+    getSession(sessionId: string): Session;
+    /**
+     * 返回当前执行中的 sessionId 列表。
+     */
+    listExecutingSessionIds(): string[];
+    /**
+     * 返回当前执行中的 session 数量。
+     */
+    getExecutingSessionCount(): number;
+    /**
+     * 当前 agent 持有的 service instances。
+     */
+    services: Map<string, BaseService>;
+}
+//# sourceMappingURL=AgentRuntimeTypes.d.ts.map

package/bin/runtime/AgentRuntimeTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRuntimeTypes.d.ts","sourceRoot":"","sources":["../../src/runtime/AgentRuntimeTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,MAAM,EAAE,cAAc,CAAC;IACvB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;OAEG;IACH,KAAK,EAAE,gBAAgB,CAAC;IACxB;;OAEG;IACH,YAAY,EAAE,wBAAwB,CAAC;IACvC;;OAEG;IACH,QAAQ,EAAE,oBAAoB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD;;OAEG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IACvC;;OAEG;IACH,uBAAuB,IAAI,MAAM,EAAE,CAAC;IACpC;;OAEG;IACH,wBAAwB,IAAI,MAAM,CAAC;IACnC;;OAEG;IACH,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACpC"}

package/bin/runtime/AgentRuntimeTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRuntimeTypes.js","sourceRoot":"","sources":["../../src/runtime/AgentRuntimeTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/bin/sandbox/MacOsSeatbeltSandbox.d.ts

@@ -6,7 +6,7 @@
  * - 目标不是抽象完整 provider 体系，而是先把 shell 命令从“宿主机直跑”收敛成“带边界执行”。
  * - 边界只保留四类：路径、环境变量、网络、隔离后的 HOME/TMPDIR。
  */
-import type { SandboxSpawnParams, SandboxSpawnResult } from "../types/sandbox/SandboxRuntime.js";
+import type { SandboxSpawnParams, SandboxSpawnResult } from "../sandbox/types/SandboxRuntime.js";
 /**
  * 在 macOS seatbelt sandbox 中启动 shell 子进程。
  */

package/bin/sandbox/SandboxConfigResolver.d.ts

@@ -6,8 +6,8 @@
  * - 当前版本只服务 shell / CLI 这条命令执行链，不引入审批、profile 绑定或用户权限系统。
  * - 解析结果只回答一个问题：这次命令执行的 sandbox 边界是什么。
  */
-import type { AgentContext } from "../agent/AgentContextTypes.js";
-import type { ResolvedSandboxConfig } from "../types/sandbox/SandboxRuntime.js";
+import type { AgentContext } from "../runtime/AgentContextTypes.js";
+import type { ResolvedSandboxConfig } from "../sandbox/types/SandboxRuntime.js";
 /**
  * 判断目标路径是否位于根目录内，或与根目录本身相同。
  */

package/bin/sandbox/SandboxConfigResolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SandboxConfigResolver.d.ts","sourceRoot":"","sources":["../../src/sandbox/SandboxConfigResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AA0B/E;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAM9E;AAwCD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,qBAAqB,CAqBjF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,YAAY,CAAC;CACvB,GAAG,MAAM,CAUT"}
+{"version":3,"file":"SandboxConfigResolver.d.ts","sourceRoot":"","sources":["../../src/sandbox/SandboxConfigResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AA0B/E;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAM9E;AAwCD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,qBAAqB,CAqBjF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,YAAY,CAAC;CACvB,GAAG,MAAM,CAUT"}

package/bin/sandbox/SandboxRunner.d.ts

@@ -6,8 +6,8 @@
  * - 当前版本只接入 macOS seatbelt backend。
  * - shell 命令不再允许回退到宿主机普通子进程执行。
  */
-import type { AgentContext } from "../agent/AgentContextTypes.js";
-import type { SandboxSpawnResult } from "../types/sandbox/SandboxRuntime.js";
+import type { AgentContext } from "../runtime/AgentContextTypes.js";
+import type { SandboxSpawnResult } from "../sandbox/types/SandboxRuntime.js";
 /**
  * 启动 shell 子进程。
  */

package/bin/sandbox/SandboxRunner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SandboxRunner.d.ts","sourceRoot":"","sources":["../../src/sandbox/SandboxRunner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAI5E;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC;CAC5B,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAkB9B;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC;CAC5B,GAAG,OAAO,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,kBAAkB,CAAC;CAC3B,CAAC,CAiCD"}
+{"version":3,"file":"SandboxRunner.d.ts","sourceRoot":"","sources":["../../src/sandbox/SandboxRunner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAI5E;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC;CAC5B,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAkB9B;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC;CAC5B,GAAG,OAAO,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,kBAAkB,CAAC;CAC3B,CAAC,CAiCD"}

package/bin/sandbox/types/Sandbox.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Sandbox 共享类型定义。
+ *
+ * 关键点（中文）
+ * - 这里放的是 console 模块与 agent 执行层都会使用的最小 sandbox 协议。
+ * - 当前版本不引入复杂 profile / binding / permission 模型，只表达“命令执行边界”。
+ * - 运行时句柄与状态化 session 类型放在 `src/sandbox/types/`。
+ */
+/**
+ * Sandbox 网络模式。
+ *
+ * 说明（中文）
+ * - `off`：完全禁止网络访问。
+ * - `restricted`：允许受限网络访问（后续实现白名单时再细化）。
+ * - `full`：允许完整网络访问。
+ */
+export type SandboxNetworkMode = "off" | "restricted" | "full";
+/**
+ * Sandbox 路径访问模式。
+ *
+ * 说明（中文）
+ * - `ro`：只读。
+ * - `rw`：可读写。
+ */
+export type SandboxPathAccessMode = "ro" | "rw";
+/**
+ * 单条路径边界规则。
+ */
+export interface SandboxPathRule {
+    /**
+     * 宿主机上的绝对路径。
+     */
+    path: string;
+    /**
+     * 当前路径在 sandbox 中的访问模式。
+     */
+    access: SandboxPathAccessMode;
+    /**
+     * 当前规则的说明文本。
+     */
+    reason?: string;
+}
+/**
+ * sandbox 最小配置。
+ *
+ * 说明（中文）
+ * - 当前只表达命令执行边界，不表达 chat 用户授权与审批流。
+ * - `rootPath` 是默认工作根目录。
+ * - `writablePaths` 决定哪些路径允许写入。
+ * - `envAllowlist` 决定哪些环境变量允许导出到 sandbox。
+ */
+export interface SandboxConfig {
+    /**
+     * 当前 sandbox 的默认根目录。
+     */
+    rootPath: string;
+    /**
+     * 允许导出的环境变量名集合。
+     *
+     * 说明（中文）
+     * - 这里仅声明允许导出的 key，不在共享配置层直接保存明文值。
+     */
+    envAllowlist: string[];
+    /**
+     * 允许写入的路径集合。
+     *
+     * 说明（中文）
+     * - 路径可以是绝对路径，也可以是相对 `rootPath` 的相对路径。
+     * - 运行时会统一解析为绝对路径，并限制在 `rootPath` 范围内。
+     */
+    writablePaths: string[];
+    /**
+     * 当前 sandbox 的网络模式。
+     */
+    networkMode: SandboxNetworkMode;
+}
+/**
+ * 项目级 sandbox 配置。
+ *
+ * 说明（中文）
+ * - 这是 `downcity.json` 中面向用户暴露的最小配置。
+ * - 当前版本只服务 CLI / shell 执行边界，不扩展到审批或用户权限系统。
+ */
+export interface SandboxProjectConfig {
+    /**
+     * 允许导出的环境变量名集合。
+     *
+     * 说明（中文）
+     * - 这里只声明允许导出的 key，不直接保存变量值。
+     * - 运行时仍会注入少量必需变量，例如隔离后的 `HOME`、`TMPDIR`。
+     */
+    envAllowlist?: string[];
+    /**
+     * 允许写入的路径集合。
+     *
+     * 说明（中文）
+     * - 路径可以是绝对路径，也可以是相对 `rootPath` 的相对路径。
+     * - 当前版本会把越出 `rootPath` 的路径裁掉，避免把宿主文件系统重新暴露回去。
+     */
+    writablePaths?: string[];
+    /**
+     * 当前 sandbox 的网络模式。
+     *
+     * 说明（中文）
+     * - 默认建议使用 `off`。
+     * - `restricted` 先保留为受限网络语义占位，当前实现会按保守策略处理。
+     */
+    networkMode?: SandboxNetworkMode;
+}
+/**
+ * console 模块中保存的 agent sandbox 配置记录。
+ */
+export interface AgentSandboxConfigRecord {
+    /**
+     * 当前 agent 的稳定标识。
+     *
+     * 说明（中文）
+     * - 当前建议直接使用 agent 项目根目录绝对路径。
+     */
+    agentId: string;
+    /**
+     * 当前 agent 使用的 sandbox 配置。
+     */
+    config: SandboxConfig;
+    /**
+     * 最近更新时间（ISO8601）。
+     */
+    updatedAt: string;
+}
+//# sourceMappingURL=Sandbox.d.ts.map

package/bin/sandbox/types/Sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sandbox.d.ts","sourceRoot":"","sources":["../../../src/sandbox/types/Sandbox.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,YAAY,GAAG,MAAM,CAAC;AAE/D;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG,IAAI,GAAG,IAAI,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,MAAM,EAAE,qBAAqB,CAAC;IAE9B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;IAEvB;;;;;;OAMG;IACH,aAAa,EAAE,MAAM,EAAE,CAAC;IAExB;;OAEG;IACH,WAAW,EAAE,kBAAkB,CAAC;CACjC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;;OAKG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,MAAM,EAAE,aAAa,CAAC;IAEtB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/bin/sandbox/types/Sandbox.js

@@ -0,0 +1,10 @@
+/**
+ * Sandbox 共享类型定义。
+ *
+ * 关键点（中文）
+ * - 这里放的是 console 模块与 agent 执行层都会使用的最小 sandbox 协议。
+ * - 当前版本不引入复杂 profile / binding / permission 模型，只表达“命令执行边界”。
+ * - 运行时句柄与状态化 session 类型放在 `src/sandbox/types/`。
+ */
+export {};
+//# sourceMappingURL=Sandbox.js.map

package/bin/sandbox/types/Sandbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sandbox.js","sourceRoot":"","sources":["../../../src/sandbox/types/Sandbox.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}