@downcity/plugins 1.0.4

package/bin/shell/runtime/ShellActionRuntimeSupport.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Shell action 运行时辅助能力。
+ *
+ * 关键点（中文）
+ * - 统一承载 ShellActionRuntime 的内部共享逻辑：环境组装、持久化、waiter 协调、session 查找。
+ * - 对外暴露给 ShellActionRuntime 的只有纯运行时辅助函数，不直接承担 plugin action 编排。
+ */
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import type { ShellPluginState, ShellSessionRuntimeState } from "../../shell/ShellRuntimeTypes.js";
+import type { ShellQueryRequest, ShellSessionSnapshot, ShellSessionStatus } from "@downcity/agent/internal/executor/tools/shell/types/ShellPlugin.js";
+export { buildShellEnv, resolveOwnerContextId, resolveShellCwd, } from "./ShellRuntimeEnvironment.js";
+export { buildActionResponse, createOutputChunk, } from "./ShellActionResponse.js";
+/**
+ * shell.start 默认内联等待时间。
+ */
+export declare const DEFAULT_INLINE_WAIT_MS = 1200;
+/**
+ * shell.wait 默认等待超时。
+ */
+export declare const DEFAULT_WAIT_TIMEOUT_MS = 10000;
+/**
+ * shell.exec 默认总超时。
+ */
+export declare const DEFAULT_EXEC_TIMEOUT_MS = 60000;
+/**
+ * 创建 shell plugin runtime 初始状态。
+ */
+export declare function createShellPluginState(): ShellPluginState;
+/**
+ * 返回当前毫秒时间戳。
+ */
+export declare function nowMs(): number;
+/**
+ * 归一化 wait/timeout 参数。
+ */
+export declare function clampWaitMs(value: number | undefined, fallback: number): number;
+/**
+ * 判断 shell 是否已进入终态。
+ */
+export declare function isTerminalStatus(status: ShellSessionStatus): boolean;
+/**
+ * 持久化 shell snapshot。
+ */
+export declare function persistSnapshot(session: ShellSessionRuntimeState): Promise<void>;
+/**
+ * 更新 session snapshot 并唤醒等待者。
+ */
+export declare function updateSessionSnapshot(session: ShellSessionRuntimeState, updater: (snapshot: ShellSessionSnapshot) => void | ShellSessionSnapshot): Promise<void>;
+/**
+ * 追加 shell 输出并同步更新快照。
+ */
+export declare function appendSessionOutput(session: ShellSessionRuntimeState, raw: string): Promise<void>;
+/**
+ * 为终态 shell 安排延迟清理。
+ */
+export declare function scheduleCleanup(state: ShellPluginState, shellId: string): void;
+/**
+ * 控制 in-memory shell session 容量。
+ */
+export declare function ensureCapacity(state: ShellPluginState): void;
+/**
+ * 按 shellId 或 ownerContext 解析目标 session。
+ */
+export declare function resolveSession(state: ShellPluginState, context: AgentContext, query: ShellQueryRequest): Promise<ShellSessionRuntimeState | {
+    snapshot: ShellSessionSnapshot;
+    outputText: string;
+} | null>;
+/**
+ * 判断解析出的 session 是否仍在内存中活动。
+ */
+export declare function isInMemorySession(value: ShellSessionRuntimeState | {
+    snapshot: ShellSessionSnapshot;
+    outputText: string;
+}): value is ShellSessionRuntimeState;
+/**
+ * 处理 shell 退出后的状态收口。
+ */
+export declare function finalizeExit(state: ShellPluginState, session: ShellSessionRuntimeState, exitCode: number): Promise<void>;
+//# sourceMappingURL=ShellActionRuntimeSupport.d.ts.map

package/bin/shell/runtime/ShellActionRuntimeSupport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellActionRuntimeSupport.d.ts","sourceRoot":"","sources":["../../../src/shell/runtime/ShellActionRuntimeSupport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,KAAK,EACV,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,oEAAoE,CAAC;AAK5E,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,eAAe,GAChB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AASlC;;GAEG;AACH,eAAO,MAAM,sBAAsB,OAAQ,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAE9C;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAKzD;AAED;;GAEG;AACH,wBAAgB,KAAK,IAAI,MAAM,CAE9B;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM/E;AAeD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAOpE;AAqBD;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGtF;AAsED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,wBAAwB,EACjC,OAAO,EAAE,CAAC,QAAQ,EAAE,oBAAoB,KAAK,IAAI,GAAG,oBAAoB,GACvE,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,wBAAwB,EACjC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAY9E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAc5D;AAuBD;;GAEG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,wBAAwB,GAAG;IAAE,QAAQ,EAAE,oBAAoB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAiCnG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,wBAAwB,GAAG;IAAE,QAAQ,EAAE,oBAAoB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACvF,KAAK,IAAI,wBAAwB,CAEnC;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,wBAAwB,EACjC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/bin/shell/runtime/ShellActionRuntimeSupport.js

@@ -0,0 +1,314 @@
+/**
+ * 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 { readChatMetaBySessionId } from "../../chat/runtime/ChatMetaStore.js";
+import { resolveChatQueueStore } from "../../chat/runtime/ChatQueueStore.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 readChatMetaBySessionId({ context, sessionId: 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");
+    resolveChatQueueStore(context).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/shell/runtime/ShellActionRuntimeSupport.js.map

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

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

@@ -0,0 +1,22 @@
+/**
+ * Shell 子进程事件绑定辅助。
+ *
+ * 关键点（中文）
+ * - 集中处理 stdout/stderr 追加、process error 与 close 事件。
+ * - close 到达时先等待输出写入链 drain，再统一进入终态收口，避免尾部输出丢读。
+ */
+import type { ShellPluginState, ShellSessionRuntimeState } from "../../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/shell/runtime/ShellProcessEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellProcessEvents.d.ts","sourceRoot":"","sources":["../../../src/shell/runtime/ShellProcessEvents.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAsB/F;;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/shell/runtime/ShellProcessEvents.js

@@ -0,0 +1,41 @@
+/**
+ * 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/shell/runtime/ShellProcessEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellProcessEvents.js","sourceRoot":"","sources":["../../../src/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/shell/runtime/ShellRuntimeEnvironment.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Shell action 运行环境解析辅助。
+ *
+ * 关键点（中文）
+ * - 集中处理 shell 子进程 cwd、env 与 owner context 的解析。
+ * - 这里只做输入归一化，不持有 shell session 状态。
+ */
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.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/shell/runtime/ShellRuntimeEnvironment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellRuntimeEnvironment.d.ts","sourceRoot":"","sources":["../../../src/shell/runtime/ShellRuntimeEnvironment.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AAIjG;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAAC,UAAU,CA+BtE;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/shell/runtime/ShellRuntimeEnvironment.js

@@ -0,0 +1,67 @@
+/**
+ * Shell action 运行环境解析辅助。
+ *
+ * 关键点（中文）
+ * - 集中处理 shell 子进程 cwd、env 与 owner context 的解析。
+ * - 这里只做输入归一化，不持有 shell session 状态。
+ */
+import path from "node:path";
+import { stripInvocationAuthEnv } from "@downcity/agent/internal/runtime/server/http/auth/AuthEnv.js";
+import { getSessionRunScope } from "@downcity/agent/internal/executor/SessionRunScope.js";
+/**
+ * 构造 shell 子进程环境变量。
+ */
+export function buildShellEnv(context) {
+    const env = { ...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 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/shell/runtime/ShellRuntimeEnvironment.js.map

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

package/bin/skill/Action.d.ts

@@ -0,0 +1,34 @@
+/**
+ * skill plugin action helper。
+ *
+ * 关键点（中文）
+ * - 与 runtime tool 解耦：CLI / plugin action / server 都可统一复用。
+ * - `lookup` 采用无状态实现：直接返回 `SKILL.md` 内容，不做 pin 持久化。
+ */
+import type { SkillListResponse, SkillLookupRequest, SkillLookupResponse, SkillSummary } from "../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/skill/Action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Action.d.ts","sourceRoot":"","sources":["../../src/skill/Action.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACb,MAAM,+BAA+B,CAAC;AAqDvC;;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"}