@downcity/agent 1.1.1

package/bin/session/tools/shell/ShellToolBridge.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Shell tool 运行时桥接与响应整理。
+ *
+ * 关键点（中文）
+ * - tool 层只负责协议适配，不直接持有 shell service 具体实现。
+ * - runtime 注入、桥接协议解析、输出扁平化都收敛在这里，避免 `Tool.ts` 继续膨胀。
+ */
+import type { JsonObject, JsonValue } from "../../../shared/types/Json.js";
+import type { InvokeServicePort } from "../../../types/agent/AgentContext.js";
+import type { ShellActionResponse } from "../../../services/shell/types/ShellService.js";
+export declare function setShellToolRuntime(next: InvokeServicePort): void;
+/**
+ * 为可能触发桥接协议的命令建立状态缓存。
+ */
+export declare function trackShellCommandBridge(command: string, shellId: string): void;
+/**
+ * 清理指定 shell 的桥接状态。
+ */
+export declare function clearShellCommandBridge(shellId: string): void;
+/**
+ * 将 shell service 响应整理为通用工具输出。
+ */
+export declare function flattenShellActionResponse(params: {
+    /**
+     * service 返回的 shell 响应。
+     */
+    response: ShellActionResponse;
+    /**
+     * tool 调用开始时间。
+     */
+    startedAt: number;
+}): JsonObject;
+/**
+ * 将一次性执行响应整理为简化输出。
+ */
+export declare function flattenShellExecResponse(params: {
+    /**
+     * service 返回的 shell 响应。
+     */
+    response: ShellActionResponse;
+    /**
+     * tool 调用开始时间。
+     */
+    startedAt: number;
+}): JsonObject;
+/**
+ * 尝试解析 shell 输出中的 runtime bridge 指令。
+ */
+export declare function bridgeCommandResponse(params: {
+    /**
+     * shell 唯一标识。
+     */
+    shellId: string;
+    /**
+     * 已经扁平化后的 tool 输出。
+     */
+    response: JsonObject;
+}): Promise<JsonObject>;
+/**
+ * 调用 shell service action。
+ */
+export declare function invokeShellAction<TPayload extends JsonValue = JsonValue>(params: {
+    /**
+     * action 名称。
+     */
+    action: string;
+    /**
+     * action 载荷。
+     */
+    payload: TPayload;
+}): Promise<ShellActionResponse>;
+/**
+ * 统一格式化 tool 错误。
+ */
+export declare function formatToolError(prefix: string, error: unknown): {
+    success: false;
+    error: string;
+};
+//# sourceMappingURL=ShellToolBridge.d.ts.map

package/bin/session/tools/shell/ShellToolBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellToolBridge.d.ts","sourceRoot":"","sources":["../../../../src/session/tools/shell/ShellToolBridge.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EACV,iBAAiB,EAElB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAwBjF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAEjE;AAyID;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAG9E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7D;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD;;OAEG;IACH,QAAQ,EAAE,mBAAmB,CAAC;IAC9B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,UAAU,CA+Bb;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C;;OAEG;IACH,QAAQ,EAAE,mBAAmB,CAAC;IAC9B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,UAAU,CAgBb;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE;IAClD;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,QAAQ,EAAE,UAAU,CAAC;CACtB,GAAG,OAAO,CAAC,UAAU,CAAC,CAoDtB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,SAAS,SAAS,GAAG,SAAS,EAAE,MAAM,EAAE;IACtF;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,OAAO,EAAE,QAAQ,CAAC;CACnB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAmB/B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,GACb;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAKnC"}

package/bin/session/tools/shell/ShellToolBridge.js

@@ -0,0 +1,288 @@
+/**
+ * Shell tool 运行时桥接与响应整理。
+ *
+ * 关键点（中文）
+ * - tool 层只负责协议适配，不直接持有 shell service 具体实现。
+ * - runtime 注入、桥接协议解析、输出扁平化都收敛在这里，避免 `Tool.ts` 继续膨胀。
+ */
+import { generateId } from "../../../shared/utils/Id.js";
+import { enqueueDeferredPersistedUserMessage, enqueueInjectedUserMessage, getSessionRunScope, } from "../../SessionRunScope.js";
+let shellToolRuntime = null;
+/**
+ * 通用命令桥接状态表（按 shell_id）。
+ */
+const commandBridgeStates = new Map();
+export function setShellToolRuntime(next) {
+    shellToolRuntime = next;
+}
+function requireShellToolRuntime() {
+    if (shellToolRuntime)
+        return shellToolRuntime;
+    throw new Error("Shell tool runtime is not initialized. Ensure runtime startup has completed before using shell tools.");
+}
+function toJsonObject(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return null;
+    return value;
+}
+function tryParseJsonObject(raw) {
+    const text = String(raw || "").trim();
+    if (!text)
+        return null;
+    try {
+        const parsed = JSON.parse(text);
+        return toJsonObject(parsed);
+    }
+    catch {
+        const firstBrace = text.indexOf("{");
+        const lastBrace = text.lastIndexOf("}");
+        if (firstBrace < 0 || lastBrace <= firstBrace)
+            return null;
+        const candidate = text.slice(firstBrace, lastBrace + 1);
+        try {
+            const parsed = JSON.parse(candidate);
+            return toJsonObject(parsed);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+function shouldEnableCommandBridge(command) {
+    const raw = String(command || "").trim();
+    if (!raw)
+        return false;
+    return /(?:^|\s)(?:city|downcity)(?:\s|$)/i.test(raw);
+}
+async function injectUserTextMessage(params) {
+    const store = getSessionRunScope();
+    const sessionId = String(store?.sessionId || "").trim();
+    const text = String(params.text || "").trim();
+    if (!sessionId || !text)
+        return false;
+    const note = String(params.note || "runtime_injected_user_message");
+    enqueueInjectedUserMessage({
+        id: `u:${sessionId}:${generateId()}`,
+        role: "user",
+        metadata: {
+            v: 1,
+            ts: Date.now(),
+            sessionId,
+            source: "ingress",
+            kind: "normal",
+            extra: {
+                note,
+            },
+        },
+        parts: [{ type: "text", text }],
+    });
+    enqueueDeferredPersistedUserMessage(sessionId, {
+        id: `u:${sessionId}:${generateId()}`,
+        role: "user",
+        metadata: {
+            v: 1,
+            ts: Date.now(),
+            sessionId,
+            source: "ingress",
+            kind: "normal",
+            extra: {
+                note,
+                injectedBy: "shell_runtime_bridge",
+            },
+        },
+        parts: [{ type: "text", text }],
+    });
+    return true;
+}
+function extractRuntimeBridgeBlock(payload) {
+    const data = toJsonObject(payload.data);
+    const bridge = toJsonObject((data?.__ship ?? payload.__ship));
+    if (!bridge)
+        return null;
+    const rawMessages = Array.isArray(bridge.injectUserMessages)
+        ? bridge.injectUserMessages
+        : [];
+    const injectUserMessages = [];
+    for (const item of rawMessages) {
+        const obj = toJsonObject(item);
+        if (!obj)
+            continue;
+        const text = typeof obj.text === "string" ? obj.text.trim() : "";
+        if (!text)
+            continue;
+        const note = typeof obj.note === "string" && obj.note.trim() ? obj.note.trim() : undefined;
+        injectUserMessages.push({ text, ...(note ? { note } : {}) });
+    }
+    const suppressToolOutput = bridge.suppressToolOutput !== false;
+    const toolOutputMessage = typeof bridge.toolOutputMessage === "string" && bridge.toolOutputMessage.trim()
+        ? bridge.toolOutputMessage.trim()
+        : "runtime bridge applied";
+    return {
+        injectUserMessages,
+        suppressToolOutput,
+        toolOutputMessage,
+    };
+}
+function sanitizeBridgeMarkers(payload) {
+    const cloned = JSON.parse(JSON.stringify(payload));
+    if ("__ship" in cloned)
+        delete cloned.__ship;
+    const data = toJsonObject(cloned.data);
+    if (data && "__ship" in data) {
+        delete data.__ship;
+    }
+    return cloned;
+}
+/**
+ * 为可能触发桥接协议的命令建立状态缓存。
+ */
+export function trackShellCommandBridge(command, shellId) {
+    if (!shouldEnableCommandBridge(command))
+        return;
+    commandBridgeStates.set(shellId, { bufferedOutput: "" });
+}
+/**
+ * 清理指定 shell 的桥接状态。
+ */
+export function clearShellCommandBridge(shellId) {
+    commandBridgeStates.delete(shellId);
+}
+/**
+ * 将 shell service 响应整理为通用工具输出。
+ */
+export function flattenShellActionResponse(params) {
+    const shell = params.response.shell;
+    const chunk = params.response.chunk;
+    return {
+        success: true,
+        shell_id: shell.shellId,
+        status: shell.status,
+        cmd: shell.cmd,
+        cwd: shell.cwd,
+        pid: typeof shell.pid === "number" ? shell.pid : null,
+        version: shell.version,
+        started_at: shell.startedAt,
+        updated_at: shell.updatedAt,
+        ended_at: typeof shell.endedAt === "number" ? shell.endedAt : null,
+        exit_code: typeof shell.exitCode === "number" ? shell.exitCode : null,
+        output: chunk?.output || "",
+        start_cursor: typeof chunk?.startCursor === "number" ? chunk.startCursor : null,
+        end_cursor: typeof chunk?.endCursor === "number" ? chunk.endCursor : null,
+        original_chars: chunk?.originalChars ?? 0,
+        original_lines: chunk?.originalLines ?? 0,
+        has_more_output: chunk?.hasMoreOutput === true,
+        last_output_preview: shell.lastOutputPreview || "",
+        output_chars: shell.outputChars,
+        dropped_chars: shell.droppedChars,
+        auto_notify_on_exit: shell.autoNotifyOnExit,
+        notification_sent: shell.notificationSent,
+        owner_context_id: shell.ownerContextId || null,
+        external_refs: shell.externalRefs,
+        wall_time_seconds: Math.max(0, (Date.now() - params.startedAt) / 1000),
+        ...(params.response.note ? { note: params.response.note } : {}),
+    };
+}
+/**
+ * 将一次性执行响应整理为简化输出。
+ */
+export function flattenShellExecResponse(params) {
+    const shell = params.response.shell;
+    const chunk = params.response.chunk;
+    return {
+        success: true,
+        status: shell.status,
+        cmd: shell.cmd,
+        cwd: shell.cwd,
+        exit_code: typeof shell.exitCode === "number" ? shell.exitCode : null,
+        output: chunk?.output || "",
+        original_chars: chunk?.originalChars ?? 0,
+        original_lines: chunk?.originalLines ?? 0,
+        external_refs: shell.externalRefs,
+        wall_time_seconds: Math.max(0, (Date.now() - params.startedAt) / 1000),
+        ...(params.response.note ? { note: params.response.note } : {}),
+    };
+}
+/**
+ * 尝试解析 shell 输出中的 runtime bridge 指令。
+ */
+export async function bridgeCommandResponse(params) {
+    const state = commandBridgeStates.get(params.shellId);
+    if (!state)
+        return params.response;
+    const rawOutput = typeof params.response.output === "string" ? params.response.output : "";
+    if (rawOutput) {
+        state.bufferedOutput += rawOutput;
+    }
+    const hasMoreOutput = params.response.has_more_output === true;
+    const exitCode = typeof params.response.exit_code === "number"
+        ? params.response.exit_code
+        : null;
+    const status = String(params.response.status || "").trim();
+    const completed = !hasMoreOutput &&
+        exitCode !== null &&
+        status !== "running" &&
+        status !== "starting";
+    if (!completed)
+        return params.response;
+    commandBridgeStates.delete(params.shellId);
+    const payload = tryParseJsonObject(state.bufferedOutput);
+    if (!payload)
+        return params.response;
+    const bridge = extractRuntimeBridgeBlock(payload);
+    if (!bridge)
+        return params.response;
+    let injectedCount = 0;
+    for (const item of bridge.injectUserMessages) {
+        if (await injectUserTextMessage(item)) {
+            injectedCount += 1;
+        }
+    }
+    if (!bridge.suppressToolOutput) {
+        const sanitized = sanitizeBridgeMarkers(payload);
+        return {
+            ...params.response,
+            output: JSON.stringify(sanitized, null, 2),
+        };
+    }
+    return {
+        ...params.response,
+        output: JSON.stringify({
+            success: true,
+            message: bridge.toolOutputMessage,
+            injected_user_messages: injectedCount,
+        }),
+    };
+}
+/**
+ * 调用 shell service action。
+ */
+export async function invokeShellAction(params) {
+    const runtime = requireShellToolRuntime();
+    const result = await runtime.invoke({
+        service: "shell",
+        action: params.action,
+        payload: params.payload,
+    });
+    if (!result.success) {
+        throw new Error(result.error || `shell.${params.action} failed`);
+    }
+    const data = toJsonObject(result.data);
+    if (!data) {
+        throw new Error(`shell.${params.action} returned invalid data`);
+    }
+    const response = data;
+    if (!response.shell || typeof response.shell.shellId !== "string") {
+        throw new Error(`shell.${params.action} returned invalid shell payload`);
+    }
+    return response;
+}
+/**
+ * 统一格式化 tool 错误。
+ */
+export function formatToolError(prefix, error) {
+    return {
+        success: false,
+        error: `${prefix}: ${String(error)}`,
+    };
+}
+//# sourceMappingURL=ShellToolBridge.js.map

package/bin/session/tools/shell/ShellToolBridge.js.map

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

package/bin/session/tools/shell/ShellToolDefinition.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Shell tools（service 化版本）。
+ *
+ * 设计目标（中文）
+ * - shell 子进程生命周期统一由 `shellService` 承担。
+ * - tool 只负责 Session/tool 协议适配、参数校验与日志语义。
+ * - 复杂桥接和 schema 已拆到旁路模块，当前文件只保留公开 tool 定义。
+ */
+import type { ShellCloseInput, ShellExecInput, ShellStartInput, ShellWaitInput } from "../../../shared/types/Shell.js";
+import type { JsonObject } from "../../../shared/types/Json.js";
+export { setShellToolRuntime } from "./ShellToolBridge.js";
+/**
+ * `shell_start`：启动 shell 会话。
+ */
+export declare const shell_start: import("ai").Tool<ShellStartInput, JsonObject | {
+    success: false;
+    error: string;
+}>;
+/**
+ * `shell_exec`：一次性执行并等待完成。
+ */
+export declare const shell_exec: import("ai").Tool<ShellExecInput, JsonObject | {
+    success: false;
+    error: string;
+}>;
+/**
+ * `shell_status`：查询 shell 当前状态。
+ */
+export declare const shell_status: import("ai").Tool<{
+    cmd?: string | undefined;
+    shell_id?: string | undefined;
+}, JsonObject | {
+    success: false;
+    error: string;
+}>;
+/**
+ * `shell_read`：读取 shell 输出增量。
+ */
+export declare const shell_read: import("ai").Tool<{
+    shell_id: string;
+    max_output_tokens?: number | undefined;
+    from_cursor?: number | undefined;
+}, JsonObject | {
+    success: false;
+    error: string;
+}>;
+/**
+ * `shell_write`：向 shell stdin 写入内容。
+ */
+export declare const shell_write: import("ai").Tool<{
+    shell_id: string;
+    chars: string;
+}, JsonObject | {
+    success: false;
+    error: string;
+}>;
+/**
+ * `shell_wait`：等待 shell 状态或输出变化。
+ */
+export declare const shell_wait: import("ai").Tool<ShellWaitInput, JsonObject | {
+    success: false;
+    error: string;
+}>;
+/**
+ * `shell_close`：关闭 shell 会话。
+ */
+export declare const shell_close: import("ai").Tool<ShellCloseInput, JsonObject | {
+    success: false;
+    error: string;
+}>;
+/**
+ * Shell 工具导出集合。
+ */
+export declare const shellTools: {
+    shell_exec: import("ai").Tool<ShellExecInput, JsonObject | {
+        success: false;
+        error: string;
+    }>;
+    shell_start: import("ai").Tool<ShellStartInput, JsonObject | {
+        success: false;
+        error: string;
+    }>;
+    shell_status: import("ai").Tool<{
+        cmd?: string | undefined;
+        shell_id?: string | undefined;
+    }, JsonObject | {
+        success: false;
+        error: string;
+    }>;
+    shell_read: import("ai").Tool<{
+        shell_id: string;
+        max_output_tokens?: number | undefined;
+        from_cursor?: number | undefined;
+    }, JsonObject | {
+        success: false;
+        error: string;
+    }>;
+    shell_write: import("ai").Tool<{
+        shell_id: string;
+        chars: string;
+    }, JsonObject | {
+        success: false;
+        error: string;
+    }>;
+    shell_wait: import("ai").Tool<ShellWaitInput, JsonObject | {
+        success: false;
+        error: string;
+    }>;
+    shell_close: import("ai").Tool<ShellCloseInput, JsonObject | {
+        success: false;
+        error: string;
+    }>;
+};
+//# sourceMappingURL=ShellToolDefinition.d.ts.map

package/bin/session/tools/shell/ShellToolDefinition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellToolDefinition.d.ts","sourceRoot":"","sources":["../../../../src/session/tools/shell/ShellToolDefinition.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EAEd,eAAe,EAEf,cAAc,EAEf,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAsBzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AA+B3D;;GAEG;AACH,eAAO,MAAM,WAAW;;;EAoFtB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,UAAU;;;EA8ErB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;EAsCvB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;EAsDrB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;EAsCtB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,UAAU;;;EA6DrB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW;;;EAqCtB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAQtB,CAAC"}