@downcity/agent 1.1.1

package/bin/agent/AgentContext.d.ts

@@ -0,0 +1,23 @@
+/**
+ * AgentContext：agent 能力上下文构造模块。
+ *
+ * 关键点（中文）
+ * - 这里负责从 `AgentRuntime` 派生统一执行上下文，供 service、plugin、session tool 复用。
+ * - `AgentContext` 表达的是“执行期能力面”，不是宿主本体；真正的宿主状态仍由 `AgentRuntime` 持有。
+ * - 该模块把 service invoke、plugin port、chat runtime port 收敛成稳定端口集合。
+ */
+import type { AgentContext } from "../types/agent/AgentContext.js";
+import type { AgentRuntime } from "../types/agent/AgentRuntime.js";
+/**
+ * 从 agent 状态派生统一执行上下文。
+ */
+export declare function createAgentContext(input: AgentRuntime): AgentContext;
+/**
+ * 读取当前 agent 的统一执行上下文。
+ */
+export declare function getAgentContext(): AgentContext;
+/**
+ * 关键点（中文）
+ * - 当前文件内的 service invoke port 既服务于 AgentContext，也可直接注入 shell tool。
+ */
+//# sourceMappingURL=AgentContext.d.ts.map

package/bin/agent/AgentContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentContext.d.ts","sourceRoot":"","sources":["../../src/agent/AgentContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAEV,YAAY,EAGb,MAAM,+BAA+B,CAAC;AAOvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AA6HlE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,CAmBpE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAED;;;GAGG"}

package/bin/agent/AgentContext.js

@@ -0,0 +1,148 @@
+/**
+ * AgentContext：agent 能力上下文构造模块。
+ *
+ * 关键点（中文）
+ * - 这里负责从 `AgentRuntime` 派生统一执行上下文，供 service、plugin、session tool 复用。
+ * - `AgentContext` 表达的是“执行期能力面”，不是宿主本体；真正的宿主状态仍由 `AgentRuntime` 持有。
+ * - 该模块把 service invoke、plugin port、chat runtime port 收敛成稳定端口集合。
+ */
+import { runServiceCommand } from "../service/Manager.js";
+import { getPluginManager } from "../plugin/PluginManager.js";
+import { getAgentRuntime } from "../agent/AgentRuntimeState.js";
+import { appendExecSessionMessage } from "../services/chat/runtime/ChatIngressStore.js";
+import { readChatMetaBySessionId } from "../services/chat/runtime/ChatMetaStore.js";
+import { resolveChatQueueStore } from "../services/chat/runtime/ChatQueue.js";
+/**
+ * service 调用端口实现。
+ */
+const serviceInvokePort = {
+    async invoke(params) {
+        const serviceName = String(params.service || "").trim();
+        const action = String(params.action || "").trim();
+        if (!serviceName) {
+            return {
+                success: false,
+                error: "invoke.service is required",
+            };
+        }
+        if (!action) {
+            return {
+                success: false,
+                error: "invoke.action is required",
+            };
+        }
+        const result = await runServiceCommand({
+            serviceName,
+            command: action,
+            payload: params.payload,
+            context: getAgentContext(),
+        });
+        if (!result.success) {
+            return {
+                success: false,
+                error: result.message || "service invoke failed",
+            };
+        }
+        return {
+            success: true,
+            ...(result.data !== undefined ? { data: result.data } : {}),
+        };
+    },
+};
+/**
+ * 构建 session 端口。
+ */
+function buildSessionPort(input) {
+    return {
+        get: (sessionId) => input.getSession(sessionId),
+        listExecutingSessionIds: () => input.listExecutingSessionIds(),
+        getExecutingSessionCount: () => input.getExecutingSessionCount(),
+        ...(input.model ? { model: input.model } : {}),
+    };
+}
+/**
+ * 构建 plugin 端口。
+ */
+function buildPluginPort(input) {
+    return {
+        list() {
+            return getPluginManager().list();
+        },
+        async availability(pluginName) {
+            return getPluginManager().availability(pluginName);
+        },
+        async runAction(params) {
+            return getPluginManager().runAction(params);
+        },
+        async pipeline(pointName, value) {
+            return getPluginManager().pipeline(pointName, value);
+        },
+        async guard(pointName, value) {
+            return getPluginManager().guard(pointName, value);
+        },
+        async effect(pointName, value) {
+            return getPluginManager().effect(pointName, value);
+        },
+        async resolve(pointName, value) {
+            return getPluginManager().resolve(pointName, value);
+        },
+    };
+}
+/**
+ * 构建 chat 运行时端口。
+ */
+function buildChatPort(getContext) {
+    return {
+        async readMetaBySessionId(sessionId) {
+            return readChatMetaBySessionId({
+                context: getContext(),
+                sessionId,
+            });
+        },
+        async appendExecSessionMessage(params) {
+            await appendExecSessionMessage({
+                context: getContext(),
+                sessionId: params.sessionId,
+                text: params.text,
+                extra: params.extra,
+            });
+        },
+        enqueue(params) {
+            return resolveChatQueueStore(getContext()).enqueue(params);
+        },
+    };
+}
+/**
+ * 从 agent 状态派生统一执行上下文。
+ */
+export function createAgentContext(input) {
+    let context;
+    context = {
+        agent: input,
+        cwd: input.cwd,
+        rootPath: input.rootPath,
+        logger: input.logger,
+        config: input.config,
+        env: input.env,
+        globalEnv: input.globalEnv,
+        systems: input.systems,
+        paths: input.paths,
+        pluginConfig: input.pluginConfig,
+        session: buildSessionPort(input),
+        invoke: serviceInvokePort,
+        chat: buildChatPort(() => context),
+        plugins: buildPluginPort(input),
+    };
+    return context;
+}
+/**
+ * 读取当前 agent 的统一执行上下文。
+ */
+export function getAgentContext() {
+    return createAgentContext(getAgentRuntime());
+}
+/**
+ * 关键点（中文）
+ * - 当前文件内的 service invoke port 既服务于 AgentContext，也可直接注入 shell tool。
+ */
+//# sourceMappingURL=AgentContext.js.map

package/bin/agent/AgentContext.js.map

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

package/bin/agent/AgentRuntime.d.ts

@@ -0,0 +1,32 @@
+/**
+ * AgentRuntime：agent 宿主装配与导出模块。
+ *
+ * 关键点（中文）
+ * - 这里是单 agent 宿主的主装配入口，负责把 config、model、session、service、plugin 串起来。
+ * - 完整运行态类型仍由 `AgentRuntimeState.ts` 维护；本模块只负责装配与对外导出。
+ * - 该模块同时负责热重载提示词系统与导出统一的 `getAgentContext()` 入口。
+ * - 当前只有 `api` 执行模式：从 console 模型池取模型，走 LocalSessionCore。
+ */
+export type { AgentRuntimeBase, AgentRuntime } from "../agent/AgentRuntimeState.js";
+export { getAgentRuntime, getAgentRuntimeBase, setAgentRuntime, setAgentRuntimeBase, requireAgentModel, } from "../agent/AgentRuntimeState.js";
+export { getAgentContext } from "../agent/AgentContext.js";
+/**
+ * 停止 agent 提示词文件热重载监听。
+ */
+export declare function stopAgentHotReload(): void;
+/**
+ * 刷新当前 agent 的项目配置快照。
+ *
+ * 关键点（中文）
+ * - 这里只更新 `AgentRuntime.config`，不尝试重建长期运行对象。
+ * - 适用于 plugin 启用态、prompt 注入、轻量配置读取这类直接依赖 config 的链路。
+ */
+export declare function refreshAgentProjectConfig(): boolean;
+/**
+ * 初始化入口。
+ *
+ * 关键点（中文）
+ * - 只有 api 执行模式：从 console 模型池创建模型 → LocalSessionExecutor → LocalSessionCore。
+ */
+export declare function initAgentRuntime(cwd: string): Promise<void>;
+//# sourceMappingURL=AgentRuntime.d.ts.map

package/bin/agent/AgentRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRuntime.d.ts","sourceRoot":"","sources":["../../src/agent/AgentRuntime.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAqDH,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AA+B1D;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAUzC;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,IAAI,OAAO,CAanD;AAyED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoIjE"}

package/bin/agent/AgentRuntime.js

@@ -0,0 +1,277 @@
+/**
+ * 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 "../shared/utils/logger/Logger.js";
+import { LocalSessionExecutor } from "../session/executors/local/LocalSessionExecutor.js";
+import { ensureRuntimeProjectReady } from "../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 "../services/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 "../services/chat/runtime/ChatSession.js";
+import { ChatSessionExecutionComposer } from "../services/chat/runtime/ChatSessionExecutionComposer.js";
+import { loadStaticSystemPrompts, StaticPromptCatalog, } from "../session/composer/system/default/StaticPromptCatalog.js";
+import { getAgentContext, } from "../agent/AgentContext.js";
+import { getAgentRuntime, getAgentRuntimeBase, setAgentRuntime, setAgentRuntimeBase, } from "../agent/AgentRuntimeState.js";
+import { createRegisteredServiceInstances } from "../service/ServiceClassRegistry.js";
+import { readProjectPrimaryModelId } from "../agent/project/ProjectExecutionBinding.js";
+import { initializePluginManager, resetPluginManager } from "../plugin/PluginManager.js";
+import { clearPluginRuntimeContextResolver, setPluginRuntimeContextResolver, } from "../runtime/PluginRuntime.js";
+import { createAgentPathRuntime, createAgentPluginConfigRuntime, } from "../runtime/AgentHostRuntime.js";
+import { updateAgentRuntimeConfig } from "../agent/AgentRuntimeState.js";
+export { getAgentRuntime, getAgentRuntimeBase, setAgentRuntime, setAgentRuntimeBase, requireAgentModel, } from "../agent/AgentRuntimeState.js";
+export { getAgentContext } from "../agent/AgentContext.js";
+let staticPromptCatalog = null;
+let configWatchPath = null;
+/**
+ * 原子更新 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) {
+    stopAgentHotReload();
+    resetPluginManager();
+    const resolvedCwd = String(cwd || "").trim() || ".";
+    const rootPath = path.resolve(resolvedCwd);
+    defaultLogger.bindProjectRoot(rootPath);
+    ensureRuntimeProjectReady(rootPath);
+    const globalEnv = loadGlobalEnvFromStore();
+    const projectEnv = 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),
+    });
+    const systems = loadStaticSystemPrompts(rootPath);
+    setAgentRuntimeBase({
+        cwd: resolvedCwd,
+        rootPath,
+        logger: defaultLogger,
+        config,
+        env: projectEnv,
+        globalEnv,
+        systems,
+        paths: createAgentPathRuntime(rootPath),
+        pluginConfig: createAgentPluginConfigRuntime(rootPath),
+    });
+    const primaryModelId = readProjectPrimaryModelId(config);
+    const model = await createModel({
+        config,
+        getSessionRunScope: getSessionRunScope,
+        projectRoot: rootPath,
+    });
+    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),
+        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/agent/AgentRuntime.js.map

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

package/bin/agent/AgentRuntimeState.d.ts

@@ -0,0 +1,42 @@
+/**
+ * AgentRuntime 进程级状态读写模块。
+ *
+ * 关键点（中文）
+ * - 这里统一维护当前进程中的 base / ready 两阶段状态。
+ * - `AgentRuntimeBase` 只表示启动早期已经可用的基础配置；`AgentRuntime` 才表示完整运行态。
+ * - 该模块只负责状态持有与读写，不负责装配具体依赖对象。
+ */
+import type { LanguageModel } from "ai";
+import type { AgentRuntime, AgentRuntimeBase } from "../types/agent/AgentRuntime.js";
+import type { DowncityConfig } from "../shared/types/DowncityConfig.js";
+export type { AgentRuntime, AgentRuntimeBase } from "../types/agent/AgentRuntime.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/agent/AgentRuntimeState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRuntimeState.d.ts","sourceRoot":"","sources":["../../src/agent/AgentRuntimeState.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxC,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EACjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAKvE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAmDpF;;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/agent/AgentRuntimeState.js

@@ -0,0 +1,116 @@
+/**
+ * AgentRuntime 进程级状态读写模块。
+ *
+ * 关键点（中文）
+ * - 这里统一维护当前进程中的 base / ready 两阶段状态。
+ * - `AgentRuntimeBase` 只表示启动早期已经可用的基础配置；`AgentRuntime` 才表示完整运行态。
+ * - 该模块只负责状态持有与读写，不负责装配具体依赖对象。
+ */
+let baseState = null;
+let readyState = null;
+const EMPTY_PATHS = {
+    projectRoot: ".",
+    getDowncityDirPath: () => ".downcity",
+    getCacheDirPath: () => ".downcity/.cache",
+    getDowncityChannelDirPath: () => ".downcity/channel",
+    getDowncityChannelMetaPath: () => ".downcity/channel/meta.json",
+    getDowncityChatHistoryPath: (sessionId) => `.downcity/chat/${sessionId}/history.jsonl`,
+    getDowncityMemoryIndexPath: () => ".downcity/memory/index.sqlite",
+    getDowncityMemoryLongTermPath: () => ".downcity/memory/MEMORY.md",
+    getDowncityMemoryDailyDirPath: () => ".downcity/memory/daily",
+    getDowncityMemoryDailyPath: (date) => `.downcity/memory/daily/${date}.md`,
+    getDowncitySessionRootDirPath: () => ".downcity/session",
+    getDowncitySessionDirPath: (sessionId) => `.downcity/session/${sessionId}`,
+};
+const EMPTY_PLUGIN_CONFIG = {
+    async persistProjectPlugins() {
+        return "";
+    },
+};
+function normalizeReadyState(input) {
+    if (typeof input.getSession !== "function") {
+        throw new Error("AgentRuntime requires getSession");
+    }
+    return {
+        cwd: input.cwd,
+        rootPath: input.rootPath,
+        logger: input.logger,
+        config: input.config,
+        env: input.env,
+        globalEnv: input.globalEnv,
+        systems: input.systems,
+        paths: input.paths || EMPTY_PATHS,
+        pluginConfig: input.pluginConfig || EMPTY_PLUGIN_CONFIG,
+        model: input.model,
+        getSession: input.getSession,
+        listExecutingSessionIds: input.listExecutingSessionIds || (() => []),
+        getExecutingSessionCount: input.getExecutingSessionCount || (() => 0),
+        services: input.services || new Map(),
+    };
+}
+/**
+ * 设置 agent 基础状态。
+ */
+export function setAgentRuntimeBase(next) {
+    baseState = next;
+    readyState = null;
+}
+/**
+ * 设置完整 agent 状态。
+ */
+export function setAgentRuntime(next) {
+    const normalized = normalizeReadyState(next);
+    baseState = normalized;
+    readyState = normalized;
+}
+/**
+ * 仅更新当前 agent 的项目配置快照。
+ *
+ * 关键点（中文）
+ * - 运行中 agent 可能在不重启进程的情况下收到 downcity.json 变更。
+ * - 这里仅替换 `config`，不重建 model / service / session 等长期对象。
+ * - 目标是让 plugin 启用态、system 注入等直接依赖配置快照的能力及时生效。
+ */
+export function updateAgentRuntimeConfig(nextConfig) {
+    if (!baseState) {
+        throw new Error("Agent state is not initialized. Call initAgentRuntime() during startup.");
+    }
+    baseState = {
+        ...baseState,
+        config: nextConfig,
+    };
+    if (readyState) {
+        readyState = {
+            ...readyState,
+            config: nextConfig,
+        };
+    }
+}
+/**
+ * 获取 agent 基础状态。
+ */
+export function getAgentRuntimeBase() {
+    if (baseState)
+        return baseState;
+    throw new Error("Agent state (base) is not initialized. Call initAgentRuntime() during startup.");
+}
+/**
+ * 获取完整 agent 状态。
+ */
+export function getAgentRuntime() {
+    if (readyState)
+        return readyState;
+    if (!baseState) {
+        throw new Error("Agent state is not initialized. Call initAgentRuntime() during startup.");
+    }
+    throw new Error("Agent state is not ready yet. Ensure session is initialized before access.");
+}
+/**
+ * 读取当前 agent 模型实例（必填）。
+ */
+export function requireAgentModel() {
+    if (readyState?.model)
+        return readyState.model;
+    throw new Error("Agent model is not initialized. Ensure initAgentRuntime() completed successfully.");
+}
+//# sourceMappingURL=AgentRuntimeState.js.map