@downcity/plugins 1.0.64 → 1.0.71

package/src/shell/runtime/ShellProcessEvents.ts

@@ -1,65 +0,0 @@
-/**
- * Shell 子进程事件绑定辅助。
- *
- * 关键点（中文）
- * - 集中处理 stdout/stderr 追加、process error 与 close 事件。
- * - close 到达时先等待输出写入链 drain，再统一进入终态收口，避免尾部输出丢读。
- */
-
-import type { ShellPluginState, ShellSessionRuntimeState } from "@/shell/ShellRuntimeTypes.js";
-import {
-  appendSessionOutput,
-  finalizeExit,
-} from "./ShellActionRuntimeSupport.js";
-
-async function finalizeExitAfterOutputDrain(
-  state: ShellPluginState,
-  session: ShellSessionRuntimeState,
-  exitCode: number,
-): Promise<void> {
-  // 关键点（中文）
-  // - `close` 事件到达时，stdout / stderr 的异步 append 链可能刚刚开始收尾。
-  // - 这里先让出一个事件循环 tick，再等待当前 writeChain，可显著降低“终态已到但尾部输出尚未可读”的竞态。
-  await new Promise<void>((resolve) => {
-    const timer = setImmediate(resolve);
-    if (typeof timer.unref === "function") timer.unref();
-  });
-  await session.writeChain.catch(() => undefined);
-  await finalizeExit(state, session, exitCode);
-}
-
-/**
- * 绑定 shell 子进程事件。
- */
-export function attachShellProcessEventHandlers(params: {
-  /**
-   * 当前 shell plugin runtime 状态。
-   */
-  state: ShellPluginState;
-  /**
-   * 当前 shell runtime session。
-   */
-  session: ShellSessionRuntimeState;
-}): void {
-  const { state, session } = params;
-  const { child } = session;
-  child.stdout.on("data", (chunk: string | Buffer) => {
-    void appendSessionOutput(state, session, String(chunk ?? "")).catch(() => undefined);
-  });
-  child.stderr.on("data", (chunk: string | Buffer) => {
-    void appendSessionOutput(state, session, String(chunk ?? "")).catch(() => undefined);
-  });
-  child.on("error", (error: Error) => {
-    void appendSessionOutput(state, session, `\n[process error] ${String(error)}\n`).catch(
-      () => undefined,
-    );
-    void finalizeExitAfterOutputDrain(state, session, -1).catch(() => undefined);
-  });
-  child.on("close", (code: number | null) => {
-    void finalizeExitAfterOutputDrain(
-      state,
-      session,
-      typeof code === "number" ? code : -1,
-    ).catch(() => undefined);
-  });
-}

package/src/shell/runtime/ShellRuntimeEnvironment.ts

@@ -1,71 +0,0 @@
-/**
- * Shell action 运行环境解析辅助。
- *
- * 关键点（中文）
- * - 集中处理 shell 子进程 cwd、env 与 owner context 的解析。
- * - 这里只做输入归一化，不持有 shell session 状态。
- */
-
-import path from "node:path";
-import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
-import { getSessionRunContext } from "@downcity/agent/internal/executor/SessionRunScope.js";
-
-function stripShellSecretEnv(env: NodeJS.ProcessEnv): void {
-  delete env.DC_AUTH_TOKEN;
-  delete env.DC_AGENT_TOKEN;
-}
-
-/**
- * 构造 shell 子进程环境变量。
- */
-export function buildShellEnv(context: AgentContext): NodeJS.ProcessEnv {
-  const env: NodeJS.ProcessEnv = { ...process.env };
-
-  // 关键点（中文）
-  // - AgentContext.env 现在就是宿主已经整理好的最终 env 视图。
-  // - shell 只消费这一份显式上下文，避免再次引入 platform/global env 隐式来源。
-  for (const [key, value] of Object.entries(context.env || {})) {
-    const normalizedKey = String(key || "").trim();
-    const normalizedValue = String(value || "").trim();
-    if (!normalizedKey || !normalizedValue) continue;
-    env[normalizedKey] = normalizedValue;
-  }
-
-  const run_context = getSessionRunContext();
-  const sessionId = String(run_context?.sessionId || "").trim();
-  const agentPath = String(context.rootPath || "").trim();
-  const configuredAgentId = String(context.config?.id || "").trim();
-  const agentId = configuredAgentId || (agentPath ? path.basename(agentPath) : "");
-
-  // 关键点（中文）
-  // - agent 自己在 shell 里执行 `town <service> ...` 时，也需要显式知道“当前 agent 是谁”。
-  // - 否则 service CLI 会退回到当前终端 cwd / registry 猜测，在多 agent 或外部工作目录下
-  //   很容易把请求发到错误项目，最终误报 “Agent runtime 没启动”。
-  if (agentPath) env.DC_AGENT_PATH = agentPath;
-  if (agentId) env.DC_AGENT_ID = agentId;
-  if (sessionId) env.DC_SESSION_ID = sessionId;
-  if (process.env.DC_CITY_HOST) env.DC_CITY_HOST = process.env.DC_CITY_HOST;
-  if (process.env.DC_CITY_PORT) env.DC_CITY_PORT = process.env.DC_CITY_PORT;
-  stripShellSecretEnv(env);
-
-  return env;
-}
-
-/**
- * 解析 shell 执行目录。
- */
-export function resolveShellCwd(context: AgentContext, cwd?: string): string {
-  const raw = String(cwd || "").trim();
-  if (!raw) return context.rootPath;
-  return path.isAbsolute(raw) ? raw : path.resolve(context.rootPath, raw);
-}
-
-/**
- * 推断 shell 所属的 owner context。
- */
-export function resolveOwnerContextId(explicit?: string): string | undefined {
-  const fromInput = String(explicit || "").trim();
-  if (fromInput) return fromInput;
-  const fromRequest = String(getSessionRunContext()?.sessionId || "").trim();
-  return fromRequest || undefined;
-}

package/src/shell/types/ShellPluginOptions.ts

@@ -1,122 +0,0 @@
-/**
- * ShellPlugin constructor 参数类型。
- *
- * 关键点（中文）
- * - 所有字段都是可选 runtime 调参。
- * - 不传参数时保持 ShellPlugin 既有硬编码默认行为。
- * - 这些参数只影响 shell plugin runtime，不改变 sandbox 权限模型。
- */
-
-/**
- * ShellPlugin 可选运行参数。
- */
-export interface ShellPluginOptions {
-  /**
-   * 最大 in-memory shell session 数量。
-   *
-   * 超过该数量时，runtime 会优先清理已经结束的旧 session；如果仍然超限则拒绝启动新 shell。
-   */
-  maxActiveShells?: number;
-
-  /**
-   * 终态 shell session 在内存中保留多久后自动清理，单位毫秒。
-   */
-  cleanupDelayMs?: number;
-
-  /**
-   * 单个 shell session 在内存中保留的最大输出字符数。
-   *
-   * 超出的历史输出仍会写入持久化输出文件，但内存快照只保留尾部内容。
-   */
-  maxInMemoryOutputChars?: number;
-
-  /**
-   * shell 输出预览保留的最大字符数。
-   */
-  outputPreviewChars?: number;
-
-  /**
-   * wait/timeout 参数允许的最小毫秒数。
-   */
-  minWaitMs?: number;
-
-  /**
-   * wait/timeout 参数允许的最大毫秒数。
-   */
-  maxWaitMs?: number;
-
-  /**
-   * `shell.start` 默认内联等待时间，单位毫秒。
-   */
-  defaultInlineWaitMs?: number;
-
-  /**
-   * `shell.wait` 默认等待超时，单位毫秒。
-   */
-  defaultWaitTimeoutMs?: number;
-
-  /**
-   * `shell.exec` 默认总超时，单位毫秒。
-   */
-  defaultExecTimeoutMs?: number;
-
-  /**
-   * unrestricted sandbox 审批默认超时时间，单位毫秒。
-   */
-  defaultApprovalTimeoutMs?: number;
-}
-
-/**
- * ShellPlugin 归一化后的运行参数。
- */
-export interface ResolvedShellPluginOptions {
-  /**
-   * 最大 in-memory shell session 数量。
-   */
-  maxActiveShells: number;
-
-  /**
-   * 终态 shell session 在内存中保留多久后自动清理，单位毫秒。
-   */
-  cleanupDelayMs: number;
-
-  /**
-   * 单个 shell session 在内存中保留的最大输出字符数。
-   */
-  maxInMemoryOutputChars: number;
-
-  /**
-   * shell 输出预览保留的最大字符数。
-   */
-  outputPreviewChars: number;
-
-  /**
-   * wait/timeout 参数允许的最小毫秒数。
-   */
-  minWaitMs: number;
-
-  /**
-   * wait/timeout 参数允许的最大毫秒数。
-   */
-  maxWaitMs: number;
-
-  /**
-   * `shell.start` 默认内联等待时间，单位毫秒。
-   */
-  defaultInlineWaitMs: number;
-
-  /**
-   * `shell.wait` 默认等待超时，单位毫秒。
-   */
-  defaultWaitTimeoutMs: number;
-
-  /**
-   * `shell.exec` 默认总超时，单位毫秒。
-   */
-  defaultExecTimeoutMs: number;
-
-  /**
-   * unrestricted sandbox 审批默认超时时间，单位毫秒。
-   */
-  defaultApprovalTimeoutMs: number;
-}