@downcity/agent 1.1.1

package/bin/shared/utils/cli/CliOutput.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 标准化输出结果。
+ *
+ * 输出策略（中文）
+ * - 默认 JSON（便于脚本解析）。
+ * - `asJson=false` 时输出可读文本。
+ */
+export declare function printResult(params: {
+    asJson?: boolean;
+    success: boolean;
+    title: string;
+    payload: Record<string, unknown>;
+}): void;
+//# sourceMappingURL=CliOutput.d.ts.map

package/bin/shared/utils/cli/CliOutput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CliOutput.d.ts","sourceRoot":"","sources":["../../../../src/shared/utils/cli/CliOutput.ts"],"names":[],"mappings":"AAaA;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,GAAG,IAAI,CAsBP"}

package/bin/shared/utils/cli/CliOutput.js

@@ -0,0 +1,98 @@
+/**
+ * CLI 输出工具。
+ *
+ * 关键点（中文）
+ * - 统一支持 JSON / 文本输出。
+ * - 保持 shell 调用与 AI 调用都可稳定解析。
+ */
+import { printPanel, renderKeyValueLines, } from "../../../shared/utils/cli/PrettyStatus.js";
+/**
+ * 标准化输出结果。
+ *
+ * 输出策略（中文）
+ * - 默认 JSON（便于脚本解析）。
+ * - `asJson=false` 时输出可读文本。
+ */
+export function printResult(params) {
+    const asJson = params.asJson !== false;
+    const payload = {
+        success: params.success,
+        ...params.payload,
+    };
+    if (asJson) {
+        console.log(JSON.stringify(payload, null, 2));
+        return;
+    }
+    const entries = Object.entries(payload).filter(([key, value]) => key !== "success" && value !== undefined);
+    const lines = renderObject(entries, 0);
+    const tone = params.success ? "success" : "error";
+    printPanel({
+        title: params.title,
+        tone,
+        lines: lines.length > 0 ? lines : ["  no details"],
+    });
+}
+function isPlainObject(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function renderScalar(key, value, indent) {
+    return renderKeyValueLines([[key, value === null ? "null" : String(value)]], indent);
+}
+function renderArray(key, value, indent) {
+    const lines = [];
+    const [header] = renderKeyValueLines([[key, value.length === 0 ? "[]" : ""]], indent);
+    if (header)
+        lines.push(header);
+    if (value.length === 0) {
+        return lines;
+    }
+    for (const [index, item] of value.entries()) {
+        if (isPlainObject(item)) {
+            lines.push(`${" ".repeat(indent + 2)}- [${index + 1}]`);
+            lines.push(...renderObject(Object.entries(item), indent + 4));
+            continue;
+        }
+        if (Array.isArray(item)) {
+            lines.push(`${" ".repeat(indent + 2)}- [${index + 1}] (array)`);
+            lines.push(...renderArray("items", item, indent + 4));
+            continue;
+        }
+        lines.push(`${" ".repeat(indent + 2)}- [${index + 1}] ${String(item)}`);
+    }
+    return lines;
+}
+function renderObject(entries, indent) {
+    if (entries.length === 0)
+        return [];
+    const ordered = [...entries].sort((a, b) => {
+        if (a[0] === "error")
+            return 1;
+        if (b[0] === "error")
+            return -1;
+        return a[0].localeCompare(b[0]);
+    });
+    const lines = [];
+    for (const [key, value] of ordered) {
+        if (value === null ||
+            typeof value === "string" ||
+            typeof value === "number" ||
+            typeof value === "boolean") {
+            lines.push(...renderScalar(key, value, indent));
+            continue;
+        }
+        if (Array.isArray(value)) {
+            lines.push(...renderArray(key, value, indent));
+            continue;
+        }
+        if (isPlainObject(value)) {
+            const [header] = renderKeyValueLines([[key, ""]], indent);
+            if (header)
+                lines.push(header);
+            lines.push(...renderObject(Object.entries(value), indent + 2));
+            continue;
+        }
+        lines.push(...renderScalar(key, String(value), indent));
+    }
+    return lines;
+}
+//# sourceMappingURL=CliOutput.js.map

package/bin/shared/utils/cli/CliOutput.js.map

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

package/bin/shared/utils/cli/PrettyStatus.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 终端状态渲染工具。
+ *
+ * 设计目标（中文）
+ * - 为 status 类命令提供统一、可读性更强的“面板化”输出。
+ * - 保持零依赖：不引入第三方库，直接使用 ANSI 转义序列。
+ * - 在非 TTY 或 NO_COLOR 场景自动降级为无色输出。
+ */
+export type StatusTone = "success" | "error" | "warning" | "info" | "neutral";
+export declare function toneTag(tone: StatusTone): string;
+export declare function dim(input: string): string;
+export declare function bold(input: string): string;
+/**
+ * 打印面板。
+ */
+export declare function printPanel(params: {
+    title: string;
+    tone?: StatusTone;
+    lines: string[];
+}): void;
+/**
+ * 渲染对齐字段行。
+ */
+export declare function renderKeyValueLines(entries: Array<[string, string]>, indent?: number): string[];
+//# sourceMappingURL=PrettyStatus.d.ts.map

package/bin/shared/utils/cli/PrettyStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrettyStatus.d.ts","sourceRoot":"","sources":["../../../../src/shared/utils/cli/PrettyStatus.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAsB9E,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAMhD;AAED,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,GAAG,IAAI,CAkBP;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAChC,MAAM,GAAE,MAAU,GACjB,MAAM,EAAE,CAQV"}

package/bin/shared/utils/cli/PrettyStatus.js

@@ -0,0 +1,77 @@
+/**
+ * 终端状态渲染工具。
+ *
+ * 设计目标（中文）
+ * - 为 status 类命令提供统一、可读性更强的“面板化”输出。
+ * - 保持零依赖：不引入第三方库，直接使用 ANSI 转义序列。
+ * - 在非 TTY 或 NO_COLOR 场景自动降级为无色输出。
+ */
+const ANSI = {
+    reset: "\u001b[0m",
+    bold: "\u001b[1m",
+    dim: "\u001b[2m",
+    fgGreen: "\u001b[32m",
+    fgRed: "\u001b[31m",
+    fgYellow: "\u001b[33m",
+    fgCyan: "\u001b[36m",
+    fgGray: "\u001b[90m",
+};
+function colorEnabled() {
+    return Boolean(process.stdout.isTTY) && !process.env.NO_COLOR;
+}
+function paint(input, code) {
+    if (!colorEnabled())
+        return input;
+    return `${code}${input}${ANSI.reset}`;
+}
+export function toneTag(tone) {
+    if (tone === "success")
+        return paint("OK", ANSI.fgGreen);
+    if (tone === "error")
+        return paint("ERR", ANSI.fgRed);
+    if (tone === "warning")
+        return paint("WARN", ANSI.fgYellow);
+    if (tone === "info")
+        return paint("INFO", ANSI.fgCyan);
+    return paint("STATE", ANSI.fgGray);
+}
+export function dim(input) {
+    return paint(input, ANSI.dim);
+}
+export function bold(input) {
+    return paint(input, ANSI.bold);
+}
+/**
+ * 打印面板。
+ */
+export function printPanel(params) {
+    const tone = params.tone || "neutral";
+    const title = `${toneTag(tone)} ${bold(params.title)}`;
+    const contentLines = [title, ...params.lines];
+    const maxLineLength = Math.max(24, ...contentLines.map((line) => stripAnsi(line).length));
+    const border = "─".repeat(maxLineLength + 2);
+    console.log(`┌${border}┐`);
+    for (const line of contentLines) {
+        const plain = stripAnsi(line).length;
+        const pad = " ".repeat(Math.max(0, maxLineLength - plain));
+        console.log(`│ ${line}${pad} │`);
+    }
+    console.log(`└${border}┘`);
+}
+/**
+ * 渲染对齐字段行。
+ */
+export function renderKeyValueLines(entries, indent = 2) {
+    if (entries.length === 0)
+        return [];
+    const keyWidth = Math.max(...entries.map(([key]) => key.length), 8);
+    const pad = " ".repeat(Math.max(0, indent));
+    return entries.map(([key, value]) => {
+        const left = `${pad}${dim(key.padEnd(keyWidth, " "))}`;
+        return `${left} : ${value}`;
+    });
+}
+function stripAnsi(input) {
+    return input.replace(/\u001b\[[0-9;]*m/g, "");
+}
+//# sourceMappingURL=PrettyStatus.js.map

package/bin/shared/utils/cli/PrettyStatus.js.map

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

package/bin/shared/utils/logger/Fetch.d.ts

@@ -0,0 +1,14 @@
+import { type ProviderFetch } from "./Format.js";
+import type { JsonObject } from "../../../shared/types/Json.js";
+export type LlmLogContext = {
+    sessionId?: string;
+};
+export declare function createLlmLoggingFetch(args: {
+    logger: {
+        log(level: string, message: string, data?: JsonObject): Promise<void>;
+    };
+    enabled: boolean;
+    maxChars?: number;
+    getSessionRunScope?: () => LlmLogContext | undefined;
+}): ProviderFetch;
+//# sourceMappingURL=Fetch.d.ts.map

package/bin/shared/utils/logger/Fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Fetch.d.ts","sourceRoot":"","sources":["../../../../src/shared/utils/logger/Fetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,MAAM,EAAE;QACN,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACvE,CAAC;IACF,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,aAAa,GAAG,SAAS,CAAC;CACtD,GAAG,aAAa,CA0EhB"}

package/bin/shared/utils/logger/Fetch.js

@@ -0,0 +1,68 @@
+import { parseFetchRequestForLog, parseFetchResponseForLog, } from "./Format.js";
+export function createLlmLoggingFetch(args) {
+    const baseFetch = globalThis.fetch.bind(globalThis);
+    const maxChars = args.maxChars ?? 99999999;
+    return async (input, init) => {
+        const ctx = args.getSessionRunScope?.();
+        let parsedRequest = null;
+        if (args.enabled) {
+            try {
+                parsedRequest = parseFetchRequestForLog(input, init, {
+                    incrementalKey: ctx?.sessionId,
+                });
+                if (parsedRequest) {
+                    const sessionId = ctx?.sessionId;
+                    const message = String(parsedRequest.requestText || "").trim();
+                    await args.logger.log("info", message.slice(0, maxChars), {
+                        ...parsedRequest.meta,
+                        ...(sessionId ? { sessionId } : {}),
+                    });
+                }
+            }
+            catch {
+                // ignore
+            }
+        }
+        let response;
+        try {
+            response = await baseFetch(input, init);
+        }
+        catch (error) {
+            if (args.enabled) {
+                try {
+                    await args.logger.log("error", "[agent] llm.fetch.error", {
+                        kind: "llm_fetch_error",
+                        error: String(error || "unknown_error"),
+                        ...(parsedRequest?.url ? { url: parsedRequest.url } : {}),
+                        ...(parsedRequest?.method ? { method: parsedRequest.method } : {}),
+                        ...(ctx?.sessionId ? { sessionId: ctx.sessionId } : {}),
+                    });
+                }
+                catch {
+                    // ignore
+                }
+            }
+            throw error;
+        }
+        if (args.enabled) {
+            const responseClone = response.clone();
+            void (async () => {
+                try {
+                    const parsedResponse = await parseFetchResponseForLog(responseClone, {
+                        url: parsedRequest?.url,
+                        method: parsedRequest?.method,
+                    });
+                    await args.logger.log("info", String(parsedResponse.responseText || "").slice(0, maxChars), {
+                        ...parsedResponse.meta,
+                        ...(ctx?.sessionId ? { sessionId: ctx.sessionId } : {}),
+                    });
+                }
+                catch {
+                    // ignore
+                }
+            })();
+        }
+        return response;
+    };
+}
+//# sourceMappingURL=Fetch.js.map

package/bin/shared/utils/logger/Fetch.js.map

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

package/bin/shared/utils/logger/Format.d.ts

@@ -0,0 +1,11 @@
+/**
+ * LLM 请求/响应日志格式化公共入口。
+ *
+ * 关键点（中文）
+ * - 外部模块只从这里导入，内部拆分对调用方透明。
+ * - `ProviderFetch` 仍然保留在 facade，避免影响 `Fetch.ts` 的类型入口。
+ */
+export { parseFetchRequestForLog } from "./FormatRequest.js";
+export { parseFetchResponseForLog } from "./FormatResponse.js";
+export type ProviderFetch = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+//# sourceMappingURL=Format.d.ts.map

package/bin/shared/utils/logger/Format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Format.d.ts","sourceRoot":"","sources":["../../../../src/shared/utils/logger/Format.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,MAAM,MAAM,aAAa,GAAG,CAC1B,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,CAAC,EAAE,WAAW,KACf,OAAO,CAAC,QAAQ,CAAC,CAAC"}

package/bin/shared/utils/logger/Format.js

@@ -0,0 +1,10 @@
+/**
+ * LLM 请求/响应日志格式化公共入口。
+ *
+ * 关键点（中文）
+ * - 外部模块只从这里导入，内部拆分对调用方透明。
+ * - `ProviderFetch` 仍然保留在 facade，避免影响 `Fetch.ts` 的类型入口。
+ */
+export { parseFetchRequestForLog } from "./FormatRequest.js";
+export { parseFetchResponseForLog } from "./FormatResponse.js";
+//# sourceMappingURL=Format.js.map

package/bin/shared/utils/logger/Format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Format.js","sourceRoot":"","sources":["../../../../src/shared/utils/logger/Format.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC"}

package/bin/shared/utils/logger/FormatRequest.d.ts

@@ -0,0 +1,29 @@
+/**
+ * LLM 请求日志格式化。
+ *
+ * 关键点（中文）
+ * - 这里专注把 provider request 规整成易读日志。
+ * - system / messages / tool calls 的展示策略统一收敛在本文件。
+ */
+import type { JsonObject, JsonValue } from "../../../shared/types/Json.js";
+import { type ParsedPayload } from "./FormatShared.js";
+export declare function parseFetchRequestForLog(input: string | URL | Request, init?: RequestInit, opts?: {
+    /**
+     * 增量日志 key，通常使用 sessionId。
+     */
+    incrementalKey?: string;
+}): {
+    url: string;
+    method: string;
+    payload: ParsedPayload | null;
+    includePayload: boolean;
+    maxChars: number;
+    messages: JsonObject[] | null;
+    system: JsonValue | undefined;
+    model?: string;
+    toolsCount: number;
+    systemLength?: number;
+    requestText: string;
+    meta: JsonObject;
+} | null;
+//# sourceMappingURL=FormatRequest.d.ts.map

package/bin/shared/utils/logger/FormatRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormatRequest.d.ts","sourceRoot":"","sources":["../../../../src/shared/utils/logger/FormatRequest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAgBL,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAC;AA8R3B,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,CAAC,EAAE,WAAW,EAClB,IAAI,CAAC,EAAE;IACL;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GACA;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9B,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,UAAU,CAAC;CAClB,GAAG,IAAI,CAwHP"}