@downcity/agent 1.1.35 → 1.1.51

package/bin/plugin/builtins/shell/runtime/ShellActionRuntimeSupport.js

@@ -1,312 +0,0 @@
-/**
- * Shell action 运行时辅助能力。
- *
- * 关键点（中文）
- * - 统一承载 ShellActionRuntime 的内部共享逻辑：环境组装、持久化、waiter 协调、session 查找。
- * - 对外暴露给 ShellActionRuntime 的只有纯运行时辅助函数，不直接承担 plugin action 编排。
- */
-import path from "node:path";
-import fs from "fs-extra";
-import { getShellOutputPath, getShellSnapshotPath } from "./Paths.js";
-import { resolveOwnerContextId } from "./ShellRuntimeEnvironment.js";
-export { buildShellEnv, resolveOwnerContextId, resolveShellCwd, } from "./ShellRuntimeEnvironment.js";
-export { buildActionResponse, createOutputChunk, } from "./ShellActionResponse.js";
-const MAX_ACTIVE_SHELLS = 64;
-const SESSION_CLEANUP_DELAY_MS = 10 * 60 * 1000;
-const MAX_IN_MEMORY_OUTPUT_CHARS = 1_000_000;
-const MIN_WAIT_MS = 50;
-const MAX_WAIT_MS = 30_000;
-const OUTPUT_PREVIEW_CHARS = 280;
-/**
- * shell.start 默认内联等待时间。
- */
-export const DEFAULT_INLINE_WAIT_MS = 1_200;
-/**
- * shell.wait 默认等待超时。
- */
-export const DEFAULT_WAIT_TIMEOUT_MS = 10_000;
-/**
- * shell.exec 默认总超时。
- */
-export const DEFAULT_EXEC_TIMEOUT_MS = 60_000;
-/**
- * 创建 shell plugin runtime 初始状态。
- */
-export function createShellPluginState() {
-    return {
-        sessions: new Map(),
-        boundRuntime: null,
-    };
-}
-/**
- * 返回当前毫秒时间戳。
- */
-export function nowMs() {
-    return Date.now();
-}
-/**
- * 归一化 wait/timeout 参数。
- */
-export function clampWaitMs(value, fallback) {
-    const raw = typeof value === "number" && Number.isFinite(value)
-        ? Math.floor(value)
-        : fallback;
-    return Math.min(MAX_WAIT_MS, Math.max(MIN_WAIT_MS, raw));
-}
-function normalizeOutputChunk(raw) {
-    if (!raw)
-        return "";
-    return raw
-        .replace(/\r\n/g, "\n")
-        .replace(/[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F]/g, "");
-}
-function deriveExitStatus(exitCode) {
-    if (exitCode === -9 || exitCode === 137)
-        return "killed";
-    if (typeof exitCode === "number" && exitCode === 0)
-        return "completed";
-    return "failed";
-}
-/**
- * 判断 shell 是否已进入终态。
- */
-export function isTerminalStatus(status) {
-    return (status === "completed" ||
-        status === "failed" ||
-        status === "killed" ||
-        status === "expired");
-}
-function extractExternalRefsFromText(text, current) {
-    const next = [...current];
-    const register = (kind, value, label) => {
-        const normalized = String(value || "").trim();
-        if (!normalized)
-            return;
-        if (next.some((item) => item.kind === kind && item.value === normalized))
-            return;
-        next.push({ kind, value: normalized, ...(label ? { label } : {}) });
-    };
-    const threadIdRegex = /thread_id[:=]\s*([a-zA-Z0-9_-]{6,})/g;
-    for (const match of text.matchAll(threadIdRegex)) {
-        register("thread_id", String(match[1] || ""), "external thread id");
-    }
-    return next;
-}
-/**
- * 持久化 shell snapshot。
- */
-export async function persistSnapshot(session) {
-    await fs.ensureDir(path.dirname(session.snapshotFilePath));
-    await fs.writeJson(session.snapshotFilePath, session.snapshot, { spaces: 2 });
-}
-function enqueuePersistedAppend(session, text) {
-    session.writeChain = session.writeChain.then(async () => {
-        await fs.ensureDir(path.dirname(session.outputFilePath));
-        await fs.appendFile(session.outputFilePath, text, "utf-8");
-    });
-    return session.writeChain;
-}
-function notifyWaiters(session) {
-    for (const waiter of Array.from(session.waiters)) {
-        clearTimeout(waiter.timer);
-        session.waiters.delete(waiter);
-        waiter.resolve();
-    }
-}
-async function emitChatCompletionEvent(context, snapshot) {
-    const ownerContextId = String(snapshot.ownerContextId || "").trim();
-    if (!ownerContextId || snapshot.notificationSent !== false)
-        return;
-    const meta = await context.chat.readMetaBySessionId(ownerContextId);
-    if (!meta)
-        return;
-    const lines = [
-        "[内部 shell 状态通知]",
-        `shell_id: ${snapshot.shellId}`,
-        `status: ${snapshot.status}`,
-        `exit_code: ${typeof snapshot.exitCode === "number" ? snapshot.exitCode : "null"}`,
-        `cmd: ${snapshot.cmd}`,
-    ];
-    if (snapshot.lastOutputPreview) {
-        lines.push(`last_output_preview: ${snapshot.lastOutputPreview}`);
-    }
-    if (snapshot.externalRefs.length > 0) {
-        const refs = snapshot.externalRefs.map((item) => `${item.kind}=${item.value}`);
-        lines.push(`external_refs: ${refs.join(", ")}`);
-    }
-    lines.push("请根据当前 shell 的状态，主动向用户简洁汇报结果或最新进展。");
-    const text = lines.join("\n");
-    context.chat.enqueue({
-        kind: "exec",
-        channel: meta.channel,
-        targetId: meta.chatId,
-        sessionId: ownerContextId,
-        text,
-        ...(meta.targetType ? { targetType: meta.targetType } : {}),
-        ...(typeof meta.threadId === "number" ? { threadId: meta.threadId } : {}),
-        ...(meta.messageId ? { messageId: meta.messageId } : {}),
-        ...(meta.actorId ? { actorId: meta.actorId } : {}),
-        ...(meta.actorName ? { actorName: meta.actorName } : {}),
-        extra: {
-            note: "shell_session_auto_notify",
-            internal: true,
-            shellId: snapshot.shellId,
-            shellStatus: snapshot.status,
-            exitCode: typeof snapshot.exitCode === "number" ? snapshot.exitCode : null,
-        },
-    });
-}
-/**
- * 更新 session snapshot 并唤醒等待者。
- */
-export async function updateSessionSnapshot(session, updater) {
-    const result = updater(session.snapshot);
-    if (result) {
-        session.snapshot = result;
-    }
-    session.snapshot.updatedAt = nowMs();
-    session.snapshot.version += 1;
-    await persistSnapshot(session);
-    notifyWaiters(session);
-}
-/**
- * 追加 shell 输出并同步更新快照。
- */
-export async function appendSessionOutput(session, raw) {
-    const text = normalizeOutputChunk(raw);
-    if (!text)
-        return;
-    session.outputText += text;
-    if (session.outputText.length > MAX_IN_MEMORY_OUTPUT_CHARS) {
-        const overflow = session.outputText.length - MAX_IN_MEMORY_OUTPUT_CHARS;
-        session.outputText = session.outputText.slice(overflow);
-        session.snapshot.droppedChars += overflow;
-    }
-    session.snapshot.outputChars += text.length;
-    session.snapshot.lastOutputAt = nowMs();
-    session.snapshot.lastOutputPreview = session.outputText
-        .slice(-OUTPUT_PREVIEW_CHARS)
-        .trim();
-    session.snapshot.externalRefs = extractExternalRefsFromText(text, session.snapshot.externalRefs);
-    await enqueuePersistedAppend(session, text);
-    await updateSessionSnapshot(session, () => undefined);
-}
-/**
- * 为终态 shell 安排延迟清理。
- */
-export function scheduleCleanup(state, shellId) {
-    const session = state.sessions.get(shellId);
-    if (!session)
-        return;
-    if (session.cleanupTimer)
-        clearTimeout(session.cleanupTimer);
-    session.cleanupTimer = setTimeout(() => {
-        const current = state.sessions.get(shellId);
-        if (!current)
-            return;
-        state.sessions.delete(shellId);
-    }, SESSION_CLEANUP_DELAY_MS);
-    if (typeof session.cleanupTimer.unref === "function") {
-        session.cleanupTimer.unref();
-    }
-}
-/**
- * 控制 in-memory shell session 容量。
- */
-export function ensureCapacity(state) {
-    if (state.sessions.size < MAX_ACTIVE_SHELLS)
-        return;
-    const removable = Array.from(state.sessions.values())
-        .filter((item) => item.snapshot.status !== "running" && item.snapshot.status !== "starting")
-        .sort((a, b) => a.snapshot.updatedAt - b.snapshot.updatedAt);
-    for (const item of removable) {
-        if (state.sessions.size < MAX_ACTIVE_SHELLS)
-            break;
-        state.sessions.delete(item.snapshot.shellId);
-    }
-    if (state.sessions.size >= MAX_ACTIVE_SHELLS) {
-        throw new Error(`Too many active shell sessions (${state.sessions.size}). Please close or wait older sessions first.`);
-    }
-}
-async function loadPersistedSnapshot(context, shellId) {
-    const file = getShellSnapshotPath(context.rootPath, shellId);
-    if (!(await fs.pathExists(file)))
-        return null;
-    const raw = await fs.readJson(file).catch(() => null);
-    if (!raw || typeof raw !== "object" || Array.isArray(raw))
-        return null;
-    const snapshot = raw;
-    return typeof snapshot.shellId === "string" ? snapshot : null;
-}
-async function readPersistedOutput(context, shellId) {
-    const file = getShellOutputPath(context.rootPath, shellId);
-    if (!(await fs.pathExists(file)))
-        return "";
-    return await fs.readFile(file, "utf-8");
-}
-/**
- * 按 shellId 或 ownerContext 解析目标 session。
- */
-export async function resolveSession(state, context, query) {
-    const explicitShellId = String(query.shellId || "").trim();
-    if (explicitShellId) {
-        const inMemory = state.sessions.get(explicitShellId);
-        if (inMemory)
-            return inMemory;
-        const snapshot = await loadPersistedSnapshot(context, explicitShellId);
-        if (!snapshot)
-            return null;
-        return {
-            snapshot,
-            outputText: await readPersistedOutput(context, explicitShellId),
-        };
-    }
-    const ownerContextId = resolveOwnerContextId(query.ownerContextId);
-    const cmd = String(query.cmd || "").trim().toLowerCase();
-    if (!ownerContextId)
-        return null;
-    const includeCompleted = query.includeCompleted === true;
-    const matched = Array.from(state.sessions.values())
-        .filter((item) => {
-        if (item.snapshot.ownerContextId !== ownerContextId)
-            return false;
-        if (!includeCompleted) {
-            if (item.snapshot.status !== "running" &&
-                item.snapshot.status !== "starting") {
-                return false;
-            }
-        }
-        if (!cmd)
-            return true;
-        return item.snapshot.cmd.toLowerCase().includes(cmd);
-    })
-        .sort((a, b) => b.snapshot.updatedAt - a.snapshot.updatedAt);
-    return matched[0] || null;
-}
-/**
- * 判断解析出的 session 是否仍在内存中活动。
- */
-export function isInMemorySession(value) {
-    return "child" in value;
-}
-/**
- * 处理 shell 退出后的状态收口。
- */
-export async function finalizeExit(state, session, exitCode) {
-    await updateSessionSnapshot(session, (snapshot) => {
-        snapshot.status = deriveExitStatus(exitCode);
-        snapshot.exitCode = exitCode;
-        snapshot.endedAt = nowMs();
-        snapshot.pid = session.child.pid ?? snapshot.pid;
-    });
-    session.resolveCompletion();
-    scheduleCleanup(state, session.snapshot.shellId);
-    if (session.snapshot.autoNotifyOnExit &&
-        session.snapshot.notificationSent === false &&
-        state.boundRuntime) {
-        await emitChatCompletionEvent(state.boundRuntime, session.snapshot);
-        session.snapshot.notificationSent = true;
-        await persistSnapshot(session);
-    }
-}
-//# sourceMappingURL=ShellActionRuntimeSupport.js.map

package/bin/plugin/builtins/shell/runtime/ShellActionRuntimeSupport.js.map

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

package/bin/plugin/builtins/shell/runtime/ShellProcessEvents.d.ts

@@ -1,22 +0,0 @@
-/**
- * Shell 子进程事件绑定辅助。
- *
- * 关键点（中文）
- * - 集中处理 stdout/stderr 追加、process error 与 close 事件。
- * - close 到达时先等待输出写入链 drain，再统一进入终态收口，避免尾部输出丢读。
- */
-import type { ShellPluginState, ShellSessionRuntimeState } from "../../../../plugin/builtins/shell/ShellRuntimeTypes.js";
-/**
- * 绑定 shell 子进程事件。
- */
-export declare function attachShellProcessEventHandlers(params: {
-    /**
-     * 当前 shell plugin runtime 状态。
-     */
-    state: ShellPluginState;
-    /**
-     * 当前 shell runtime session。
-     */
-    session: ShellSessionRuntimeState;
-}): void;
-//# sourceMappingURL=ShellProcessEvents.d.ts.map

package/bin/plugin/builtins/shell/runtime/ShellProcessEvents.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ShellProcessEvents.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/shell/runtime/ShellProcessEvents.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,8CAA8C,CAAC;AAsB/G;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE;IACtD;;OAEG;IACH,KAAK,EAAE,gBAAgB,CAAC;IACxB;;OAEG;IACH,OAAO,EAAE,wBAAwB,CAAC;CACnC,GAAG,IAAI,CAsBP"}

package/bin/plugin/builtins/shell/runtime/ShellProcessEvents.js

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

package/bin/plugin/builtins/shell/runtime/ShellProcessEvents.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ShellProcessEvents.js","sourceRoot":"","sources":["../../../../../src/plugin/builtins/shell/runtime/ShellProcessEvents.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,mBAAmB,EACnB,YAAY,GACb,MAAM,gCAAgC,CAAC;AAExC,KAAK,UAAU,4BAA4B,CACzC,KAAuB,EACvB,OAAiC,EACjC,QAAgB;IAEhB,UAAU;IACV,wDAAwD;IACxD,+DAA+D;IAC/D,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAClC,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QACpC,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,UAAU;YAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IACvD,CAAC,CAAC,CAAC;IACH,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAChD,MAAM,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAAC,MAS/C;IACC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAClC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAC1B,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAsB,EAAE,EAAE;QACjD,KAAK,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAsB,EAAE,EAAE;QACjD,KAAK,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE;QACjC,KAAK,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAC7E,GAAG,EAAE,CAAC,SAAS,CAChB,CAAC;QACF,KAAK,4BAA4B,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAmB,EAAE,EAAE;QACxC,KAAK,4BAA4B,CAC/B,KAAK,EACL,OAAO,EACP,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CACrC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/bin/plugin/builtins/shell/runtime/ShellRuntimeEnvironment.d.ts

@@ -1,21 +0,0 @@
-/**
- * Shell action 运行环境解析辅助。
- *
- * 关键点（中文）
- * - 集中处理 shell 子进程 cwd、env 与 owner context 的解析。
- * - 这里只做输入归一化，不持有 shell session 状态。
- */
-import type { AgentContext } from "../../../../core/AgentContextTypes.js";
-/**
- * 构造 shell 子进程环境变量。
- */
-export declare function buildShellEnv(context: AgentContext): NodeJS.ProcessEnv;
-/**
- * 解析 shell 执行目录。
- */
-export declare function resolveShellCwd(context: AgentContext, cwd?: string): string;
-/**
- * 推断 shell 所属的 owner context。
- */
-export declare function resolveOwnerContextId(explicit?: string): string | undefined;
-//# sourceMappingURL=ShellRuntimeEnvironment.d.ts.map

package/bin/plugin/builtins/shell/runtime/ShellRuntimeEnvironment.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ShellRuntimeEnvironment.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/shell/runtime/ShellRuntimeEnvironment.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAIhE;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAAC,UAAU,CAuCtE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAI3E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK3E"}

package/bin/plugin/builtins/shell/runtime/ShellRuntimeEnvironment.js

@@ -1,75 +0,0 @@
-/**
- * Shell action 运行环境解析辅助。
- *
- * 关键点（中文）
- * - 集中处理 shell 子进程 cwd、env 与 owner context 的解析。
- * - 这里只做输入归一化，不持有 shell session 状态。
- */
-import path from "node:path";
-import { stripInvocationAuthEnv } from "../../../../runtime/server/http/auth/AuthEnv.js";
-import { getSessionRunScope } from "../../../../executor/SessionRunScope.js";
-/**
- * 构造 shell 子进程环境变量。
- */
-export function buildShellEnv(context) {
-    const env = { ...process.env };
-    // 关键点（中文）
-    // - shell 子进程需要继承平台级 global env。
-    // - 这里显式从 store 读取，避免把 AgentContext.env 语义扩大成“全局+agent 混合态”。
-    // - 冲突时仍由后续 agent 私有 env 覆盖，保持文档声明的优先级。
-    for (const [key, value] of Object.entries(context.globalEnv || {})) {
-        const normalizedKey = String(key || "").trim();
-        const normalizedValue = String(value || "").trim();
-        if (!normalizedKey || !normalizedValue)
-            continue;
-        env[normalizedKey] = normalizedValue;
-    }
-    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 request = getSessionRunScope();
-    const sessionId = String(request?.sessionId || "").trim();
-    const agentPath = String(context.rootPath || "").trim();
-    const configuredAgentName = String(context.config?.name || "").trim();
-    const agentName = configuredAgentName || (agentPath ? path.basename(agentPath) : "");
-    // 关键点（中文）
-    // - agent 自己在 shell 里执行 `city <service> ...` 时，也需要显式知道“当前 agent 是谁”。
-    // - 否则 service CLI 会退回到当前终端 cwd / registry 猜测，在多 agent 或外部工作目录下
-    //   很容易把请求发到错误项目，最终误报 “Agent server 没启动”。
-    if (agentPath)
-        env.DC_AGENT_PATH = agentPath;
-    if (agentName)
-        env.DC_AGENT_NAME = agentName;
-    if (sessionId)
-        env.DC_SESSION_ID = sessionId;
-    if (process.env.DC_SERVER_HOST)
-        env.DC_CTX_SERVER_HOST = process.env.DC_SERVER_HOST;
-    if (process.env.DC_SERVER_PORT)
-        env.DC_CTX_SERVER_PORT = process.env.DC_SERVER_PORT;
-    stripInvocationAuthEnv(env);
-    return env;
-}
-/**
- * 解析 shell 执行目录。
- */
-export function resolveShellCwd(context, cwd) {
-    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) {
-    const fromInput = String(explicit || "").trim();
-    if (fromInput)
-        return fromInput;
-    const fromRequest = String(getSessionRunScope()?.sessionId || "").trim();
-    return fromRequest || undefined;
-}
-//# sourceMappingURL=ShellRuntimeEnvironment.js.map

package/bin/plugin/builtins/shell/runtime/ShellRuntimeEnvironment.js.map

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

package/bin/plugin/builtins/shell/types/Shell.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Shell.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/shell/types/Shell.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,gBAAgB;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qBAAqB;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sBAAsB;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sBAAsB;IACtB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,gBAAgB;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC"}

package/bin/plugin/builtins/shell/types/Shell.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Shell.js","sourceRoot":"","sources":["../../../../../src/plugin/builtins/shell/types/Shell.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/bin/plugin/builtins/shell/types/ShellPlugin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ShellPlugin.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/shell/types/ShellPlugin.ts"],"names":[],"mappings":"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"}

package/bin/plugin/builtins/shell/types/ShellPlugin.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ShellPlugin.js","sourceRoot":"","sources":["../../../../../src/plugin/builtins/shell/types/ShellPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/bin/plugin/builtins/skill/Action.d.ts

@@ -1,34 +0,0 @@
-/**
- * skill plugin action helper。
- *
- * 关键点（中文）
- * - 与 runtime tool 解耦：CLI / plugin action / server 都可统一复用。
- * - `lookup` 采用无状态实现：直接返回 `SKILL.md` 内容，不做 pin 持久化。
- */
-import type { SkillListResponse, SkillLookupRequest, SkillLookupResponse, SkillSummary } from "../../../plugin/builtins/skill/types/SkillCommand.js";
-/**
- * 在“已学会（本地可发现）”技能里做精确匹配。
- */
-export declare function findLearnedSkillExact(projectRoot: string, query: string): SkillSummary | null;
-/**
- * 在“已学会（本地可发现）”技能里做模糊搜索。
- */
-export declare function searchLearnedSkills(projectRoot: string, query: string, limit?: number): SkillSummary[];
-/**
- * 列出当前项目下可发现的全部 skill。
- */
-export declare function listSkills(projectRoot: string): SkillListResponse;
-/**
- * 读取指定 skill 的正文内容。
- */
-export declare function lookupSkill(params: {
-    /**
-     * 项目根目录。
-     */
-    projectRoot: string;
-    /**
-     * skill lookup 请求。
-     */
-    request: SkillLookupRequest;
-}): Promise<SkillLookupResponse>;
-//# sourceMappingURL=Action.d.ts.map

package/bin/plugin/builtins/skill/Action.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Action.d.ts","sourceRoot":"","sources":["../../../../src/plugin/builtins/skill/Action.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACb,MAAM,+CAA+C,CAAC;AAqDvD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACZ,YAAY,GAAG,IAAI,CAIrB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAW,GACjB,YAAY,EAAE,CAahB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,CAMjE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE;IACxC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,OAAO,EAAE,kBAAkB,CAAC;CAC7B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA6B/B"}