@downcity/agent 1.1.287 → 1.1.310

package/bin/types/session/SessionQueue.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SessionQueue.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionQueue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AACnF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAE9E,mCAAmC;AACnC,MAAM,WAAW,wBAAwB;IACvC,4BAA4B;IAC5B,IAAI,EAAE,eAAe,CAAC;IACtB,mBAAmB;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,MAAM,EAAE,0BAA0B,CAAC;IACnC,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,yCAAyC;AACzC,MAAM,WAAW,sBAAsB;IACrC,4BAA4B;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,mBAAmB;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAED,8CAA8C;AAC9C,MAAM,WAAW,0BAA0B;IACzC,+BAA+B;IAC/B,IAAI,EAAE,eAAe,CAAC;IACtB,mBAAmB;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,OAAO,EAAE,2BAA2B,CAAC;CACtC;AAED,mBAAmB;AACnB,MAAM,WAAW,0BAA0B;IACzC,uBAAuB;IACvB,IAAI,EAAE,SAAS,CAAC;IAChB,mBAAmB;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,+BAA+B;AAC/B,MAAM,MAAM,mBAAmB,GAC3B,wBAAwB,GACxB,sBAAsB,GACtB,0BAA0B,GAC1B,0BAA0B,CAAC;AAE/B,gDAAgD;AAChD,MAAM,MAAM,mBAAmB,GAAG;IAC9B,mBAAmB;IACnB,IAAI,EAAE,KAAK,CAAC;IACZ,gBAAgB;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B,GACC;IACE,uBAAuB;IACvB,IAAI,EAAE,SAAS,CAAC;IAChB,gBAAgB;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,OAAO,EAAE,2BAA2B,CAAC;CACtC,CAAC;AAEN,wBAAwB;AACxB,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,sBAAsB;IACtB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,oBAAoB;IACpB,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;CAC7B;AAED,mCAAmC;AACnC,MAAM,WAAW,mBAAmB;IAClC,uBAAuB;IACvB,IAAI,EAAE,QAAQ,CAAC;IACf,wBAAwB;IACxB,KAAK,EAAE,uBAAuB,CAAC;IAC/B,0CAA0C;IAC1C,eAAe,EAAE,oBAAoB,CAAC,sBAAsB,CAAC,CAAC;CAC/D;AAED,6BAA6B;AAC7B,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,GAAG,mBAAmB,CAAC"}

package/bin/types/session/SessionQueue.js

@@ -1,7 +0,0 @@
-/**
- * Session 输入队列类型。
- *
- * 队列只保存明确的输入事实，不保存可执行闭包。SessionTurn 是这些输入的唯一解释者。
- */
-export {};
-//# sourceMappingURL=SessionQueue.js.map

package/bin/types/session/SessionQueue.js.map

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

package/bin/types/session/SessionTurn.d.ts

@@ -1,52 +0,0 @@
-/**
- * SessionTurn 构造参数与内部运行态类型。
- *
- * 这些类型描述 Turn 编排所依赖的领域对象，不实现任何调度行为。
- */
-import type { Executor } from "../../executor/Executor.js";
-import type { SessionApprovalBroker } from "../../session/approval/SessionApprovalBroker.js";
-import type { SessionEventHub } from "../../session/runtime/SessionEventHub.js";
-import type { SessionMessages } from "../../session/SessionMessages.js";
-import type { SessionState } from "../../session/SessionState.js";
-import type { AgentSessionTurnResult } from "../../types/sdk/AgentSessionTurn.js";
-import type { SessionQueueCommand } from "../../types/session/SessionQueue.js";
-/** Promise 延迟控制器。 */
-export interface SessionDeferred<T> {
-    /** 等待兑现的 Promise。 */
-    promise: Promise<T>;
-    /** 兑现 Promise 的函数。 */
-    resolve: (value: T) => void;
-}
-/** 当前活跃 Turn 的内存状态。 */
-export interface ActiveSessionTurnState {
-    /** 当前 Turn 的稳定标识。 */
-    turn_id: string;
-    /** 当前 Turn 的最终结果快照。 */
-    result: AgentSessionTurnResult | null;
-    /** 当前 Turn 完成状态的延迟控制器。 */
-    deferred_finished: SessionDeferred<AgentSessionTurnResult>;
-    /** 当前 Turn 的取消控制器。 */
-    abort_controller: AbortController;
-}
-/** SessionTurn 构造参数。 */
-export interface SessionTurnOptions {
-    /** 当前 Session 的稳定标识。 */
-    session_id: string;
-    /** 当前项目的绝对根目录。 */
-    project_root: string;
-    /** 当前 Session 的模型执行器。 */
-    executor: Executor;
-    /** 当前 Session 的配置与 Metadata 状态。 */
-    state: SessionState;
-    /** 当前 Session 的 canonical Message 入口。 */
-    messages: SessionMessages;
-    /** 当前 Session 的 Mutation 总线。 */
-    events: SessionEventHub;
-    /** 当前 Session 的 Tool 审批入口。 */
-    approvals: SessionApprovalBroker;
-    /** 在 Step 检查点提交 Session 或 Agent 状态 Command。 */
-    apply_command: (command: Exclude<SessionQueueCommand, {
-        type: "compact";
-    }>, turn_id: string) => Promise<void>;
-}
-//# sourceMappingURL=SessionTurn.d.ts.map

package/bin/types/session/SessionTurn.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SessionTurn.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionTurn.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AACzF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAE3E,qBAAqB;AACrB,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,sBAAsB;IACtB,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;CAC7B;AAED,uBAAuB;AACvB,MAAM,WAAW,sBAAsB;IACrC,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACtC,0BAA0B;IAC1B,iBAAiB,EAAE,eAAe,CAAC,sBAAsB,CAAC,CAAC;IAC3D,sBAAsB;IACtB,gBAAgB,EAAE,eAAe,CAAC;CACnC;AAED,wBAAwB;AACxB,MAAM,WAAW,kBAAkB;IACjC,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,QAAQ,EAAE,QAAQ,CAAC;IACnB,mCAAmC;IACnC,KAAK,EAAE,YAAY,CAAC;IACpB,yCAAyC;IACzC,QAAQ,EAAE,eAAe,CAAC;IAC1B,gCAAgC;IAChC,MAAM,EAAE,eAAe,CAAC;IACxB,8BAA8B;IAC9B,SAAS,EAAE,qBAAqB,CAAC;IACjC,+CAA+C;IAC/C,aAAa,EAAE,CACb,OAAO,EAAE,OAAO,CAAC,mBAAmB,EAAE;QAAE,IAAI,EAAE,SAAS,CAAA;KAAE,CAAC,EAC1D,OAAO,EAAE,MAAM,KACZ,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB"}

package/bin/types/session/SessionTurn.js.map

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

package/scripts/assistant-file-resource.test.mjs

@@ -1,344 +0,0 @@
-/**
- * @file 验证 assistant file part 会把资源落盘为 Agent 根目录相对路径。
- *
- * 关键点（中文）
- * - 历史消息不应长期保存图片 base64。
- * - 送模型前可以从 Agent 根目录相对路径临时 hydrate 回 data URL。
- */
-
-import test from "node:test";
-import assert from "node:assert/strict";
-import os from "node:os";
-import path from "node:path";
-import fs from "node:fs/promises";
-import http from "node:http";
-import { pathToFileURL } from "node:url";
-
-import { materializeAssistantFileParts } from "../bin/executor/messages/AssistantFileResource.js";
-import {
-  hydrateUserPromptFileParts,
-  hydrateFileUrlPartsForModel,
-  injectFilePartsFromAttachments,
-} from "../bin/executor/messages/SessionAttachmentMapper.js";
-
-function resource_path_from_relative_path(project_root, relative_path) {
-  return path.join(project_root, String(relative_path || ""));
-}
-
-test("materializeAssistantFileParts stores data URL images under .downcity/resources", async () => {
-  const project_root = await fs.mkdtemp(
-    path.join(os.tmpdir(), "downcity-agent-assistant-resource-"),
-  );
-  const bytes = Buffer.from("png-bytes-for-test", "utf8");
-  const data_url = `data:image/png;base64,${bytes.toString("base64")}`;
-
-  const parts = await materializeAssistantFileParts({
-    projectRoot: project_root,
-    parts: [
-      {
-        type: "file",
-        mediaType: "image/png",
-        filename: "image-1.png",
-        url: data_url,
-      },
-    ],
-  });
-
-  assert.equal(parts.length, 1);
-  assert.equal(parts[0].type, "file");
-  assert.equal(parts[0].mediaType, "image/png");
-  assert.equal(parts[0].filename, "image-1.png");
-  assert.match(parts[0].url, /^\.downcity\/resources\//);
-  assert.equal(parts[0].url.includes("base64"), false);
-
-  const resource_path = resource_path_from_relative_path(project_root, parts[0].url);
-  assert.equal(
-    path.dirname(resource_path),
-    path.join(project_root, ".downcity", "resources"),
-  );
-  assert.deepEqual(await fs.readFile(resource_path), bytes);
-});
-
-test("materializeAssistantFileParts downloads remote file URLs into resources", async () => {
-  const project_root = await fs.mkdtemp(
-    path.join(os.tmpdir(), "downcity-agent-assistant-remote-resource-"),
-  );
-  const bytes = Buffer.from("remote-png-bytes-for-test", "utf8");
-  const server = http.createServer((_, response) => {
-    response.writeHead(200, { "content-type": "image/png" });
-    response.end(bytes);
-  });
-
-  await new Promise((resolve) => server.listen(0, "127.0.0.1", resolve));
-  try {
-    const address = server.address();
-    assert.equal(typeof address, "object");
-    assert.ok(address);
-    const remote_url = `http://127.0.0.1:${address.port}/image.png`;
-
-    const parts = await materializeAssistantFileParts({
-      projectRoot: project_root,
-      parts: [
-        {
-          type: "file",
-          mediaType: "image/png",
-          filename: "remote.png",
-          url: remote_url,
-        },
-      ],
-    });
-
-    assert.match(parts[0].url, /^\.downcity\/resources\//);
-    assert.equal(parts[0].url.startsWith("http://"), false);
-    assert.deepEqual(
-      await fs.readFile(resource_path_from_relative_path(project_root, parts[0].url)),
-      bytes,
-    );
-  } finally {
-    await new Promise((resolve, reject) =>
-      server.close((error) => (error ? reject(error) : resolve())),
-    );
-  }
-});
-
-test("materializeAssistantFileParts rejects oversized remote resources before download", async () => {
-  const project_root = await fs.mkdtemp(
-    path.join(os.tmpdir(), "downcity-agent-assistant-large-resource-"),
-  );
-  const server = http.createServer((_, response) => {
-    response.writeHead(200, {
-      "content-type": "application/octet-stream",
-      "content-length": String(26 * 1024 * 1024),
-    });
-    response.end("oversized");
-  });
-
-  await new Promise((resolve) => server.listen(0, "127.0.0.1", resolve));
-  try {
-    const address = server.address();
-    assert.equal(typeof address, "object");
-    assert.ok(address);
-    const remote_url = `http://127.0.0.1:${address.port}/large.bin`;
-    const parts = await materializeAssistantFileParts({
-      projectRoot: project_root,
-      parts: [
-        {
-          type: "file",
-          mediaType: "application/octet-stream",
-          url: remote_url,
-        },
-      ],
-    });
-
-    assert.equal(parts[0].url, remote_url);
-    const resources_path = path.join(project_root, ".downcity", "resources");
-    await assert.rejects(fs.access(resources_path));
-  } finally {
-    await new Promise((resolve, reject) =>
-      server.close((error) => (error ? reject(error) : resolve())),
-    );
-  }
-});
-
-test("materializeAssistantFileParts resolves relative local file URLs from agent project root", async () => {
-  const project_root = await fs.mkdtemp(
-    path.join(os.tmpdir(), "downcity-agent-assistant-relative-resource-"),
-  );
-  const bytes = Buffer.from("relative-local-png-bytes", "utf8");
-  await fs.writeFile(path.join(project_root, "input.png"), bytes);
-
-  const parts = await materializeAssistantFileParts({
-    projectRoot: project_root,
-    parts: [
-      {
-        type: "file",
-        mediaType: "image/png",
-        filename: "input.png",
-        url: "./input.png",
-      },
-    ],
-  });
-
-  assert.match(parts[0].url, /^\.downcity\/resources\//);
-  assert.deepEqual(
-    await fs.readFile(resource_path_from_relative_path(project_root, parts[0].url)),
-    bytes,
-  );
-});
-
-test("hydrateFileUrlPartsForModel converts relative resource paths back to data URLs in memory", async () => {
-  const project_root = await fs.mkdtemp(
-    path.join(os.tmpdir(), "downcity-agent-assistant-hydrate-"),
-  );
-  const bytes = Buffer.from("hydrate-bytes-for-test", "utf8");
-  const materialized = await materializeAssistantFileParts({
-    projectRoot: project_root,
-    parts: [
-      {
-        type: "file",
-        mediaType: "image/png",
-        filename: "image-1.png",
-        url: `data:image/png;base64,${bytes.toString("base64")}`,
-      },
-    ],
-  });
-
-  const messages = await hydrateFileUrlPartsForModel(
-    [
-      {
-        id: "a:test:1",
-        role: "assistant",
-        metadata: {
-          v: 1,
-          ts: Date.now(),
-          sessionId: "session_test",
-        },
-        parts: materialized,
-      },
-    ],
-    project_root,
-  );
-
-  const hydrated_part = messages[0]?.parts[0];
-  assert.equal(hydrated_part?.type, "file");
-  assert.equal(hydrated_part?.mediaType, "image/png");
-  assert.equal(
-    hydrated_part?.url,
-    `data:image/png;base64,${bytes.toString("base64")}`,
-  );
-  assert.match(materialized[0].url, /^\.downcity\/resources\//);
-});
-
-test("hydrateUserPromptFileParts converts local image paths to data URLs before persistence", async () => {
-  const project_root = await fs.mkdtemp(
-    path.join(os.tmpdir(), "downcity-agent-user-prompt-image-"),
-  );
-  const bytes = Buffer.from("user-prompt-image-bytes", "utf8");
-  const image_path = path.join(project_root, "image.png");
-  await fs.writeFile(image_path, bytes);
-
-  const parts = await hydrateUserPromptFileParts(
-    [
-      {
-        type: "text",
-        text: "这张图写了啥",
-      },
-      {
-        type: "file",
-        mediaType: "image/png",
-        filename: "image.png",
-        url: image_path,
-      },
-    ],
-    project_root,
-  );
-
-  assert.equal(parts[0]?.type, "text");
-  assert.equal(parts[1]?.type, "file");
-  assert.equal(parts[1]?.mediaType, "image/png");
-  assert.equal(
-    parts[1]?.url,
-    `data:image/png;base64,${bytes.toString("base64")}`,
-  );
-});
-
-test("hydrateUserPromptFileParts keeps existing data URLs and non-image files unchanged", async () => {
-  const data_url = "data:image/png;base64,already-base64";
-  const pdf_url = "/tmp/input.pdf";
-  const parts = await hydrateUserPromptFileParts(
-    [
-      {
-        type: "file",
-        mediaType: "image/png",
-        filename: "image.png",
-        url: data_url,
-      },
-      {
-        type: "file",
-        mediaType: "application/pdf",
-        filename: "input.pdf",
-        url: pdf_url,
-      },
-    ],
-    process.cwd(),
-  );
-
-  assert.equal(parts[0]?.url, data_url);
-  assert.equal(parts[1]?.url, pdf_url);
-});
-
-test("hydrateFileUrlPartsForModel keeps old file URLs compatible", async () => {
-  const project_root = await fs.mkdtemp(
-    path.join(os.tmpdir(), "downcity-agent-assistant-file-url-"),
-  );
-  const bytes = Buffer.from("legacy-file-url-bytes", "utf8");
-  const file_path = path.join(project_root, "legacy.png");
-  await fs.writeFile(file_path, bytes);
-
-  const messages = await hydrateFileUrlPartsForModel(
-    [
-      {
-        id: "a:test:legacy",
-        role: "assistant",
-        metadata: {
-          v: 1,
-          ts: Date.now(),
-          sessionId: "session_test",
-        },
-        parts: [
-          {
-            type: "file",
-            mediaType: "image/png",
-            filename: "legacy.png",
-            url: pathToFileURL(file_path).href,
-          },
-        ],
-      },
-    ],
-    project_root,
-  );
-
-  const hydrated_part = messages[0]?.parts[0];
-  assert.equal(hydrated_part?.type, "file");
-  assert.equal(
-    hydrated_part?.url,
-    `data:image/png;base64,${bytes.toString("base64")}`,
-  );
-});
-
-test("injectFilePartsFromAttachments resolves relative file tags from agent project root", async () => {
-  const project_root = await fs.mkdtemp(
-    path.join(os.tmpdir(), "downcity-agent-attachment-relative-"),
-  );
-  const bytes = Buffer.from("attachment-relative-png-bytes", "utf8");
-  await fs.writeFile(path.join(project_root, "input.png"), bytes);
-
-  const messages = await injectFilePartsFromAttachments(
-    [
-      {
-        id: "u:test:attachment",
-        role: "user",
-        metadata: {
-          v: 1,
-          ts: Date.now(),
-          sessionId: "session_test",
-        },
-        parts: [
-          {
-            type: "text",
-            text: '<file type="photo">./input.png</file>',
-          },
-        ],
-      },
-    ],
-    project_root,
-  );
-
-  const injected_part = messages[0]?.parts[1];
-  assert.equal(injected_part?.type, "file");
-  assert.equal(injected_part?.mediaType, "image/png");
-  assert.equal(
-    injected_part?.url,
-    `data:image/png;base64,${bytes.toString("base64")}`,
-  );
-});

package/scripts/read-image-tool-bridge.test.mjs

@@ -1,71 +0,0 @@
-/**
- * @file 验证 read 图片结果会作为临时 UserMessage file part 注入模型输入。
- *
- * 关键点（中文）
- * - data URL 只进入注入消息，不保留在普通 tool result。
- * - 注入消息包含非空文本 part，能够通过 step 合并消息筛选。
- */
-
-import test from "node:test";
-import assert from "node:assert/strict";
-
-import { inject_read_image_user_message } from "../bin/executor/tools/file/ReadImageToolBridge.js";
-import {
-  pickMergedUserMessages,
-  toModelMessages,
-} from "../bin/executor/messages/SessionMessageCodec.js";
-
-test("read image data is injected as a user file part", async () => {
-  const data_url = "data:image/png;base64,iVBORw0KGgo=";
-  const run_context = {
-    sessionId: "session-1",
-    turnId: "turn-1",
-    injectedUserMessages: [],
-    deferredPersistedUserMessages: [],
-    pendingAssistantFileParts: [],
-  };
-  const output = inject_read_image_user_message({
-    tool_name: "read",
-    output: {
-      success: true,
-      type: "image",
-      file_path: "/project/input.png",
-      mime_type: "image/png",
-      data_url,
-    },
-    run_context,
-  });
-
-  assert.equal(output.data_url, undefined);
-  assert.equal(output.image_attached, true);
-  assert.equal(run_context.injectedUserMessages.length, 1);
-  const message = run_context.injectedUserMessages[0];
-  assert.equal(message.role, "user");
-  assert.equal(message.parts[0].type, "text");
-  assert.equal(message.parts[1].type, "file");
-  assert.equal(message.parts[1].url, data_url);
-  assert.equal(message.parts[1].mediaType, "image/png");
-  assert.equal(pickMergedUserMessages([message]).length, 1);
-
-  const model_messages = await toModelMessages([message], {});
-  assert.equal(model_messages.length, 1);
-  assert.equal(model_messages[0].role, "user");
-  assert.match(JSON.stringify(model_messages[0]), /iVBORw0KGgo=/);
-});
-
-test("non-image tool results are unchanged", () => {
-  const output = { success: true, type: "text", content: "hello" };
-  const run_context = {
-    sessionId: "session-1",
-    injectedUserMessages: [],
-    deferredPersistedUserMessages: [],
-    pendingAssistantFileParts: [],
-  };
-  const result = inject_read_image_user_message({
-    tool_name: "read",
-    output,
-    run_context,
-  });
-  assert.equal(result, output);
-  assert.deepEqual(run_context.injectedUserMessages, []);
-});

package/src/agent/AgentContext.ts

@@ -1,98 +0,0 @@
-/**
- * AgentContext：本地 Agent 的统一执行上下文。
- *
- * 职责说明（中文）
- * - 同一 Agent 实例全程共享同一个 Context。
- * - 向 Plugin、Session 与宿主投影当前 Agent 的稳定运行时能力。
- * - Context 不复制 Agent 状态，env 与 systems 始终从唯一状态源读取。
- */
-
-import type { AgentSessions } from "@/agent/AgentSessions.js";
-import type { AgentPlugins } from "@/types/plugin/PluginRuntime.js";
-import type { Logger } from "@/utils/logger/Logger.js";
-import type { Shell } from "@downcity/shell";
-
-/**
- * AgentContext 构造参数。
- */
-interface AgentContextOptions {
-  /** 当前 Agent 显式挂载的 Shell；未启用时为空。 */
-  shell?: Shell;
-  /** 当前 Agent 稳定标识。 */
-  agent_id: string;
-
-  /** 当前项目根目录。 */
-  rootPath: string;
-
-  /** 当前 Agent 统一日志器。 */
-  logger: Logger;
-
-  /** 读取当前 Agent configured env。 */
-  get_env: () => Readonly<Record<string, string>>;
-
-  /** 读取当前 Agent configured systems。 */
-  get_systems: () => readonly string[];
-
-  /** 当前 Agent 直接持有的 Session 集合。 */
-  sessions: AgentSessions;
-
-  /** 当前 Agent 唯一的 Plugin 调用入口。 */
-  plugins: AgentPlugins;
-}
-
-/**
- * 本地 Agent 的统一执行上下文。
- */
-export class AgentContext {
-  /** 当前 Agent 显式挂载的 Shell；plugin 可复用其已注入的平台 adapter。 */
-  readonly shell?: Shell;
-  /** 当前 Agent 稳定标识。 */
-  readonly agent_id: string;
-
-  /** 当前项目根目录。 */
-  readonly rootPath: string;
-
-  /** 当前 Agent 统一日志器。 */
-  readonly logger: Logger;
-
-  /** 当前 Agent configured env 读取器。 */
-  private readonly get_env: AgentContextOptions["get_env"];
-
-  /** 当前 Agent configured systems 读取器。 */
-  private readonly get_systems: AgentContextOptions["get_systems"];
-
-  /** 当前 Agent 直接持有的 Session 集合。 */
-  readonly sessions: AgentSessions;
-
-  /** 当前 Agent 唯一的 Plugin 调用入口。 */
-  readonly plugins: AgentPlugins;
-
-  constructor(options: AgentContextOptions) {
-    this.shell = options.shell;
-    this.agent_id = options.agent_id;
-    this.rootPath = options.rootPath;
-    this.logger = options.logger;
-    this.get_env = options.get_env;
-    this.get_systems = options.get_systems;
-    this.sessions = options.sessions;
-    this.plugins = options.plugins;
-  }
-
-  /**
-   * 读取 Agent 已配置的 env。
-   *
-   * 关键点（中文）
-   * - Session step 的 effective env 由 Plugin action 参数 `run_context.agentEnv` 显式提供。
-   * - 该 getter 不根据异步调用链隐式切换结果。
-   */
-  get env(): Readonly<Record<string, string>> {
-    return this.get_env();
-  }
-
-  /**
-   * 读取 Agent 已配置的 instruction。
-   */
-  get systems(): readonly string[] {
-    return this.get_systems();
-  }
-}

package/src/config/AgentEnv.ts

@@ -1,49 +0,0 @@
-/**
- * Agent 项目环境变量装配模块。
- *
- * 关键点（中文）
- * - 只读取当前项目根目录的 `.env`，不读取任何全局配置文件。
- * - 合并优先级固定为：宿主环境 < 项目 `.env`。
- * - 返回独立快照，不修改 `process.env`。
- */
-import dotenv from "dotenv";
-import fs from "fs-extra";
-import path from "node:path";
-
-/**
- * 读取项目 `.env` 快照。
- */
-export function load_project_dotenv(project_root: string): Record<string, string> {
-  const project_env_path = path.join(project_root, ".env");
-  if (!fs.existsSync(project_env_path)) return {};
-
-  try {
-    const parsed = dotenv.parse(fs.readFileSync(project_env_path, "utf-8"));
-    const result: Record<string, string> = {};
-    for (const [key, value] of Object.entries(parsed)) {
-      const normalized_key = String(key || "").trim();
-      if (!normalized_key) continue;
-      result[normalized_key] = String(value || "").trim();
-    }
-    return result;
-  } catch {
-    return {};
-  }
-}
-
-/**
- * 解析 Agent 最终环境变量。
- */
-export function resolve_agent_env(
-  project_root: string,
-  host_env?: NodeJS.ProcessEnv | Record<string, string | undefined>,
-): Record<string, string> {
-  const normalized_host_env: Record<string, string> = {};
-  for (const [key, value] of Object.entries(host_env || {})) {
-    if (typeof value === "string") normalized_host_env[key] = value;
-  }
-  return {
-    ...normalized_host_env,
-    ...load_project_dotenv(project_root),
-  };
-}