downcity 1.0.417 → 1.0.431

package/README.md

@@ -15,8 +15,8 @@ downcity -v
 ### 1. initialize console
 
 ```bash
-city console init
-city console start
+city init
+city start
 ```
 
 ### 2. initialize agent project
@@ -62,7 +62,7 @@ city agent start --foreground
 
 ```bash
 city agent status
-city console agents
+city agents
 city service list
 ```
 
@@ -131,7 +131,7 @@ Content-Type: application/json
 {"instructions":"Say hi"}
 ```
 
-Use `city agent status` or `city console agents` to inspect the actual agent port.
+Use `city agent status` or `city agents` to inspect the actual agent port.
 
 ## debug
 

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

@@ -0,0 +1 @@
+{"version":3,"file":"AgentContext.d.ts","sourceRoot":"","sources":["../../../src/main/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,CAoBpE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAED;;;GAGG"}

package/bin/main/agent/AgentContext.js

@@ -0,0 +1,149 @@
+/**
+ * AgentContext：agent 能力上下文构造模块。
+ *
+ * 关键点（中文）
+ * - 这里负责从 `AgentRuntime` 派生统一执行上下文，供 service、plugin、session tool 复用。
+ * - `AgentContext` 表达的是“执行期能力面”，不是宿主本体；真正的宿主状态仍由 `AgentRuntime` 持有。
+ * - 该模块把 service invoke、plugin port、chat runtime port 收敛成稳定端口集合。
+ */
+import { runServiceCommand } from "../../main/service/Manager.js";
+import { getPluginManager } from "../../main/plugin/PluginManager.js";
+import { getAgentRuntime } from "../../main/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,
+        auth: input.auth,
+        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/main/agent/AgentContext.js.map

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRuntime.d.ts","sourceRoot":"","sources":["../../../src/main/agent/AgentRuntime.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA0DH,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACxF,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AA+B/D;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAUzC;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,IAAI,OAAO,CAanD;AA8CD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsIjE"}

package/bin/main/agent/AgentRuntime.js

@@ -0,0 +1,275 @@
+/**
+ * AgentRuntime：agent 宿主装配与导出模块。
+ *
+ * 关键点（中文）
+ * - 这里是单 agent 宿主的主装配入口，负责把 config、model、session、service、plugin 串起来。
+ * - 完整运行态类型仍由 `AgentRuntimeState.ts` 维护；本模块只负责装配与对外导出。
+ * - 该模块同时负责热重载提示词系统与导出统一的 `getAgentContext()` 入口。
+ */
+import path from "path";
+import fs from "fs";
+import { logger as defaultLogger } from "../../shared/utils/logger/Logger.js";
+import { Session } from "../../session/Session.js";
+import { LocalSessionExecutor } from "../../session/executors/local/LocalSessionExecutor.js";
+import { createModel } from "../../main/city/model/CreateModel.js";
+import { loadGlobalEnvFromStore, loadAgentEnvSnapshot, loadDowncityConfig, } from "../../main/city/env/Config.js";
+import { getDowncityJsonPath } from "../../main/city/env/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 { AcpSessionExecutor } from "../../session/executors/acp/AcpSessionExecutor.js";
+import { readEnabledSessionAgentConfig, resolveAcpLaunchConfig, } from "../../session/executors/acp/AcpLaunchConfig.js";
+import { ensureRuntimeProjectReady } from "../../main/city/daemon/ProjectSetup.js";
+import { loadStaticSystemPrompts, StaticPromptCatalog, } from "../../session/composer/system/default/StaticPromptCatalog.js";
+import { getAgentContext, } from "../../main/agent/AgentContext.js";
+import { getAgentRuntime, getAgentRuntimeBase, setAgentRuntime, setAgentRuntimeBase, } from "../../main/agent/AgentRuntimeState.js";
+import { createRegisteredServiceInstances } from "../../main/service/ServiceClassRegistry.js";
+import { readProjectPrimaryModelId } from "../../main/agent/project/ProjectExecutionBinding.js";
+import { initializePluginManager, resetPluginManager } from "../../main/plugin/PluginManager.js";
+import { clearPluginRuntimeContextResolver, setPluginRuntimeContextResolver, } from "../../main/city/runtime/PluginRuntime.js";
+import { createAgentAuthRuntime, createAgentPathRuntime, createAgentPluginConfigRuntime, } from "../../main/city/runtime/AgentHostRuntime.js";
+import { updateAgentRuntimeConfig } from "../../main/agent/AgentRuntimeState.js";
+export { getAgentRuntime, getAgentRuntimeBase, setAgentRuntime, setAgentRuntimeBase, requireAgentModel, } from "../../main/agent/AgentRuntimeState.js";
+export { getAgentContext } from "../../main/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),
+            });
+        }
+    });
+}
+/**
+ * 初始化入口。
+ */
+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),
+        auth: createAgentAuthRuntime(),
+        pluginConfig: createAgentPluginConfigRuntime(rootPath),
+    });
+    const systems = loadStaticSystemPrompts(rootPath);
+    setAgentRuntimeBase({
+        cwd: resolvedCwd,
+        rootPath,
+        logger: defaultLogger,
+        config,
+        env: projectEnv,
+        globalEnv,
+        systems,
+        paths: createAgentPathRuntime(rootPath),
+        auth: createAgentAuthRuntime(),
+        pluginConfig: createAgentPluginConfigRuntime(rootPath),
+    });
+    const sessionAgent = readEnabledSessionAgentConfig(config);
+    const primaryModelId = readProjectPrimaryModelId(config);
+    const model = sessionAgent || !primaryModelId
+        ? undefined
+        : await createModel({
+            config,
+            getSessionRunScope: getSessionRunScope,
+        });
+    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 created = new Session({
+            sessionId: key,
+            createHistoryComposer: () => createSessionHistoryComposer(rootPath, key),
+            createExecutor: (historyComposer) => sessionAgent
+                ? new AcpSessionExecutor({
+                    rootPath,
+                    sessionId: key,
+                    logger: defaultLogger,
+                    historyComposer,
+                    systemComposer,
+                    launch: resolveAcpLaunchConfig(sessionAgent),
+                })
+                : new LocalSessionExecutor({
+                    model: model,
+                    logger: defaultLogger,
+                    historyComposer,
+                    compactionComposer,
+                    systemComposer,
+                    getTools: () => shellTools,
+                }),
+        });
+        sessionsById.set(key, created);
+        return created;
+    };
+    const agentState = {
+        cwd: resolvedCwd,
+        rootPath,
+        logger: defaultLogger,
+        config,
+        env: projectEnv,
+        globalEnv,
+        systems,
+        paths: createAgentPathRuntime(rootPath),
+        auth: createAgentAuthRuntime(),
+        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();
+}
+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 } : {}),
+    });
+}
+//# sourceMappingURL=AgentRuntime.js.map

package/bin/main/agent/AgentRuntime.js.map

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

package/bin/main/agent/AgentRuntimeState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRuntimeState.d.ts","sourceRoot":"","sources":["../../../src/main/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;AAMvE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAwDpF;;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/main/agent/AgentRuntimeState.js

@@ -0,0 +1,120 @@
+/**
+ * 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_AUTH = {
+    applyInternalAgentAuthEnv() { },
+};
+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,
+        auth: input.auth || EMPTY_AUTH,
+        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

package/bin/main/agent/AgentRuntimeState.js.map

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

package/bin/main/agent/project/AgentInitializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentInitializer.d.ts","sourceRoot":"","sources":["../../../../src/main/agent/project/AgentInitializer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgCH,OAAO,KAAK,EAEV,+BAA+B,EAC/B,gCAAgC,EACjC,MAAM,gCAAgC,CAAC;AAIxC;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAOD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM/D;AAED;;GAEG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC,CA0B7E;AA6GD;;GAEG;AACH,wBAAsB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAKrF;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,+BAA+B,GACrC,OAAO,CAAC,gCAAgC,CAAC,CA+J3C"}