@axhub/acp 0.1.0

package/dist/tools/image-generation/shared.d.ts

@@ -0,0 +1,103 @@
+export declare const IMAGE_GENERATION_TOOL_ID = "image-generation";
+export declare const IMAGE_GENERATION_MCP_NAME = "acp-ui-image-generation";
+export declare const IMAGE_GENERATION_TOOL_NAME = "generate_image";
+export declare const IMAGE_GENERATION_MCP_TOOL_TITLE = "Tool: acp-ui-image-generation/generate_image";
+export declare const ACP_PROVIDER_AGENT_DYNAMIC_TOOL_NAME = "acp.acp_provider_agent_dynamic_tool";
+export type ImageGenerationSourceType = "path" | "url" | "data_url" | "base64";
+export type ImageGenerationInputSource = {
+    type: ImageGenerationSourceType;
+    value: string;
+    mimeType?: string;
+    filename?: string;
+};
+export type ImageGenerationParams = {
+    model?: string;
+    size?: string;
+    quality?: string;
+    outputFormat?: "png" | "jpeg" | "webp";
+    background?: "auto" | "transparent" | "opaque";
+};
+export type ImageGenerationInput = ImageGenerationParams & {
+    prompt: string;
+    images?: ImageGenerationInputSource[];
+    savePath?: string;
+};
+export type ImageGenerationOutputImage = {
+    id: string;
+    fileName: string;
+    mimeType: string;
+    sizeBytes: number;
+    url: string;
+    savedPath?: string;
+    width?: number;
+    height?: number;
+    revisedPrompt?: string;
+    actualParams?: Partial<ImageGenerationParams>;
+};
+export type ImageGenerationConfig = {
+    provider: string;
+    baseUrl: string;
+    apiKey: string;
+    model: string;
+    outputDir: string;
+    savePathPattern?: string;
+    maxInputBytes: number;
+    maxOutputBytes: number;
+    downloadTimeoutMs: number;
+    requestTimeoutMs: number;
+    allowSavePath: boolean;
+    savePathBaseDir: string;
+    preservePrompt: boolean;
+};
+export type ImageGenerationRuntimeSettings = {
+    enabled?: boolean;
+    baseUrl?: string;
+    apiKey?: string;
+    model?: string;
+    savePathPattern?: string;
+    preservePrompt?: boolean;
+};
+export type ImageGenerationRecordSource = "mcp" | "api";
+export type ImageGenerationRecord = {
+    id: string;
+    requestId: string;
+    threadId: string | null;
+    workspacePath: string;
+    source: ImageGenerationRecordSource;
+    status: "completed" | "failed";
+    provider: string;
+    prompt: string;
+    revisedPrompt?: string;
+    requestedParams: ImageGenerationParams;
+    actualParams: Partial<ImageGenerationParams>;
+    images: ImageGenerationOutputImage[];
+    durationMs: number;
+    error?: string;
+    createdAt: string;
+    updatedAt: string;
+};
+export type ImageGenerationOutput = {
+    status: "completed" | "failed";
+    recordId?: string;
+    requestId: string;
+    provider: string;
+    prompt: string;
+    revisedPrompt?: string;
+    requestedParams: ImageGenerationParams;
+    actualParams: Partial<ImageGenerationParams>;
+    images: ImageGenerationOutputImage[];
+    durationMs: number;
+    error?: string;
+    rawResponseSummary?: unknown;
+};
+export type AcpDynamicToolArgs = {
+    toolCallId?: string;
+    toolName?: string;
+    args?: unknown;
+};
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function normalizeImageGenerationRuntimeSettings(value: unknown): ImageGenerationRuntimeSettings | null;
+export declare function mergeImageGenerationRuntimeSettings(current: unknown, patch: unknown): ImageGenerationRuntimeSettings | null;
+export declare function parseAcpDynamicToolArgs(value: unknown): AcpDynamicToolArgs | null;
+export declare function isImageGenerationOutput(value: unknown): value is ImageGenerationOutput;
+export declare function parseImageGenerationOutput(value: unknown): ImageGenerationOutput | null;

package/dist/tools/image-generation/shared.mjs

@@ -0,0 +1,80 @@
+export const IMAGE_GENERATION_TOOL_ID = "image-generation";
+export const IMAGE_GENERATION_MCP_NAME = "acp-ui-image-generation";
+export const IMAGE_GENERATION_TOOL_NAME = "generate_image";
+export const IMAGE_GENERATION_MCP_TOOL_TITLE = `Tool: ${IMAGE_GENERATION_MCP_NAME}/${IMAGE_GENERATION_TOOL_NAME}`;
+export const ACP_PROVIDER_AGENT_DYNAMIC_TOOL_NAME = "acp.acp_provider_agent_dynamic_tool";
+export function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function readStringValue(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+export function normalizeImageGenerationRuntimeSettings(value) {
+    var _a;
+    if (!isRecord(value))
+        return null;
+    const settings = {};
+    const baseUrl = (_a = readStringValue(value.baseUrl)) === null || _a === void 0 ? void 0 : _a.replace(/\/+$/u, "");
+    const apiKey = readStringValue(value.apiKey);
+    const model = readStringValue(value.model);
+    const savePathPattern = readStringValue(value.savePathPattern);
+    if (typeof value.enabled === "boolean")
+        settings.enabled = value.enabled;
+    if (baseUrl)
+        settings.baseUrl = baseUrl;
+    if (apiKey)
+        settings.apiKey = apiKey;
+    if (model)
+        settings.model = model;
+    if (savePathPattern)
+        settings.savePathPattern = savePathPattern;
+    if (typeof value.preservePrompt === "boolean") {
+        settings.preservePrompt = value.preservePrompt;
+    }
+    return Object.keys(settings).length > 0 ? settings : null;
+}
+export function mergeImageGenerationRuntimeSettings(current, patch) {
+    const normalizedCurrent = normalizeImageGenerationRuntimeSettings(current);
+    const normalizedPatch = normalizeImageGenerationRuntimeSettings(patch);
+    if (!normalizedCurrent)
+        return normalizedPatch;
+    if (!normalizedPatch)
+        return normalizedCurrent;
+    const merged = Object.assign(Object.assign({}, normalizedCurrent), normalizedPatch);
+    return merged;
+}
+export function parseAcpDynamicToolArgs(value) {
+    if (!isRecord(value))
+        return null;
+    const toolName = typeof value.toolName === "string" ? value.toolName : null;
+    if (!toolName)
+        return null;
+    return {
+        toolCallId: typeof value.toolCallId === "string" ? value.toolCallId : undefined,
+        toolName,
+        args: value.args,
+    };
+}
+export function isImageGenerationOutput(value) {
+    return (isRecord(value) &&
+        (value.status === "completed" || value.status === "failed") &&
+        typeof value.requestId === "string" &&
+        typeof value.prompt === "string" &&
+        Array.isArray(value.images));
+}
+export function parseImageGenerationOutput(value) {
+    if (isImageGenerationOutput(value))
+        return value;
+    if (isRecord(value) && isImageGenerationOutput(value.structuredContent)) {
+        return value.structuredContent;
+    }
+    if (typeof value === "string") {
+        try {
+            return parseImageGenerationOutput(JSON.parse(value));
+        }
+        catch (_a) {
+            return null;
+        }
+    }
+    return null;
+}

package/dist/tools/image-generation/storage.d.ts

@@ -0,0 +1,22 @@
+import { saveGeneratedImage as saveGeneratedImageFromService } from "./service.mjs";
+import type { ImageGenerationConfig, ImageGenerationOutputImage } from "./shared";
+export type StoredImageMetadata = ImageGenerationOutputImage & {
+    createdAt: string;
+    absolutePath: string;
+};
+type SaveGeneratedImageOptions = {
+    config: ImageGenerationConfig;
+    data: Buffer;
+    mimeType: string;
+    revisedPrompt?: string;
+    actualParams?: Awaited<ReturnType<typeof saveGeneratedImageFromService>>["actualParams"];
+    width?: number;
+    height?: number;
+    workspacePath?: string | null;
+    savePath?: string | null;
+};
+export declare function saveGeneratedImage(options: SaveGeneratedImageOptions): Promise<ImageGenerationOutputImage>;
+export declare function getStoredImage(configOrOptions: ImageGenerationConfig | {
+    workspacePath?: string | null;
+}, id: string): Promise<StoredImageMetadata | null>;
+export {};

package/dist/tools/image-generation/storage.mjs

@@ -0,0 +1,8 @@
+import { getStoredImage as getStoredImageFromService, saveGeneratedImage as saveGeneratedImageFromService, } from "./service.mjs";
+export async function saveGeneratedImage(options) {
+    return saveGeneratedImageFromService(options);
+}
+export async function getStoredImage(configOrOptions, id) {
+    const workspacePath = "outputDir" in configOrOptions ? null : configOrOptions.workspacePath;
+    return getStoredImageFromService({ workspacePath }, id);
+}

package/dist/tools/image-generation/ui-detail.d.ts

@@ -0,0 +1,26 @@
+import type { ComponentType } from "react";
+import type { ImageGenerationOutput, ImageGenerationOutputImage } from "./shared";
+type ImageGenerationStatusMeta = {
+    label: string;
+    chip: string;
+    Icon: ComponentType<{
+        className?: string;
+    }>;
+};
+type ImageGenerationDetailDialogProps = {
+    result: ImageGenerationOutput | null;
+    prompt: string;
+    image?: ImageGenerationOutputImage;
+    altText: string;
+    status: ImageGenerationStatusMeta;
+    statusDetail: string;
+    isRunning: boolean;
+};
+export declare function formatBytes(value?: number): string;
+export declare function ToolImagePreview({ image, alt, compact, }: {
+    image?: ImageGenerationOutputImage;
+    alt: string;
+    compact?: boolean;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function ImageGenerationDetailDialog({ result, prompt, image, altText, status, statusDetail, isRunning, }: ImageGenerationDetailDialogProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/tools/image-generation/ui-detail.mjs

@@ -0,0 +1,109 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { CheckIcon, ChevronDownIcon, CopyIcon, DownloadIcon, ImageIcon, LoaderIcon, SlidersHorizontalIcon, XIcon, } from "lucide-react";
+import { useState } from "react";
+import { TooltipIconButton } from "../../components/assistant-ui/tooltip-icon-button.mjs";
+import { Button } from "../../components/ui/button.mjs";
+import { Collapsible, CollapsibleContent, CollapsibleTrigger, } from "../../components/ui/collapsible.mjs";
+import { DialogClose, DialogContent, DialogHeader, DialogTitle, } from "../../components/ui/dialog.mjs";
+import { Separator } from "../../components/ui/separator.mjs";
+import { cn } from "../../lib/utils.mjs";
+const PARAM_LABELS = {
+    model: "模型",
+    size: "尺寸",
+    quality: "质量",
+    outputFormat: "格式",
+    background: "背景",
+};
+export function formatBytes(value) {
+    if (!value)
+        return "";
+    if (value < 1024)
+        return `${value} B`;
+    if (value < 1024 * 1024)
+        return `${(value / 1024).toFixed(1)} KB`;
+    return `${(value / (1024 * 1024)).toFixed(1)} MB`;
+}
+function stringify(value) {
+    if (typeof value === "string")
+        return value;
+    try {
+        return JSON.stringify(value, null, 2);
+    }
+    catch (_a) {
+        return String(value);
+    }
+}
+function copyText(value) {
+    if (!value || typeof navigator === "undefined" || !navigator.clipboard) {
+        return;
+    }
+    navigator.clipboard.writeText(value).catch(() => { });
+}
+function getParamEntries(requested, actual) {
+    const keys = [
+        "model",
+        "size",
+        "quality",
+        "outputFormat",
+        "background",
+    ];
+    return keys
+        .map((key) => {
+        const requestedValue = requested === null || requested === void 0 ? void 0 : requested[key];
+        const actualValue = actual === null || actual === void 0 ? void 0 : actual[key];
+        const value = actualValue !== null && actualValue !== void 0 ? actualValue : requestedValue;
+        return {
+            key,
+            label: PARAM_LABELS[key],
+            value,
+            requested: requestedValue,
+            actual: actualValue,
+            changed: requestedValue !== undefined &&
+                actualValue !== undefined &&
+                requestedValue !== actualValue,
+        };
+    })
+        .filter((entry) => entry.value !== undefined);
+}
+export function ToolImagePreview({ image, alt, compact, }) {
+    const [loaded, setLoaded] = useState(false);
+    if (!(image === null || image === void 0 ? void 0 : image.url)) {
+        return (_jsx("div", { className: cn("flex size-full items-center justify-center text-muted-foreground", !compact && "min-h-24"), children: _jsx(ImageIcon, { className: compact ? "size-5" : "size-8" }) }));
+    }
+    return (_jsxs("div", { className: "relative flex size-full items-center justify-center overflow-hidden", children: [!loaded && (_jsx("div", { className: "absolute inset-0 flex items-center justify-center bg-muted", children: _jsx(LoaderIcon, { className: "size-5 animate-spin text-muted-foreground" }) })), _jsx("img", { src: image.url, alt: alt, className: cn("block object-contain", compact ? "size-full object-cover" : "max-h-full max-w-full", !loaded && "invisible"), onLoad: () => setLoaded(true) })] }));
+}
+export function ImageGenerationDetailDialog({ result, prompt, image, altText, status, statusDetail, isRunning, }) {
+    const StatusIcon = status.Icon;
+    const revisedPrompt = (image === null || image === void 0 ? void 0 : image.revisedPrompt) || (result === null || result === void 0 ? void 0 : result.revisedPrompt);
+    return (_jsxs(DialogContent, { "data-image-generation-detail": true, className: "grid h-[min(88vh,900px)] max-h-[88vh] grid-rows-[auto_minmax(0,1fr)] gap-0 overflow-hidden p-0 sm:max-w-5xl", showCloseButton: false, children: [_jsx(DialogHeader, { className: "border-b px-5 py-4", children: _jsxs("div", { className: "flex min-h-9 items-center justify-between gap-4", children: [_jsx(DialogTitle, { className: "min-w-0 truncate", children: "\u56FE\u7247\u751F\u6210\u8BE6\u60C5" }), _jsxs("div", { className: "flex shrink-0 items-center gap-3", children: [_jsxs("span", { className: cn("inline-flex h-7 shrink-0 items-center gap-1.5 rounded-md border px-2 font-medium text-xs", status.chip), children: [_jsx(StatusIcon, { className: cn("size-3.5", isRunning && "animate-spin") }), status.label] }), _jsx(DialogClose, { asChild: true, children: _jsxs(Button, { type: "button", variant: "ghost", size: "icon-sm", className: "text-muted-foreground hover:text-foreground", children: [_jsx(XIcon, { className: "size-4" }), _jsx("span", { className: "sr-only", children: "\u5173\u95ED" })] }) })] })] }) }), _jsxs("div", { className: "grid min-h-0 overflow-y-auto lg:grid-cols-[minmax(0,1.15fr)_minmax(320px,0.85fr)] lg:overflow-hidden", children: [_jsxs("div", { className: "min-w-0 border-b bg-muted/20 p-4 lg:border-r lg:border-b-0", children: [_jsx("div", { className: "flex h-[min(62vh,720px)] min-h-72 items-center justify-center overflow-hidden rounded-lg border bg-background", children: _jsx(ToolImagePreview, { image: image, alt: altText }) }), image && (_jsxs("div", { className: "mt-3 flex flex-wrap items-center justify-between gap-2 rounded-md border bg-background px-3 py-2", children: [_jsx("p", { className: "min-w-0 flex-1 truncate text-muted-foreground text-xs", children: image.fileName }), _jsx("div", { className: "flex items-center gap-1", children: _jsx(Button, { asChild: true, variant: "outline", size: "sm", className: "h-7 gap-1.5 px-2 text-xs", children: _jsxs("a", { href: image.url, download: image.fileName, children: [_jsx(DownloadIcon, { className: "size-3.5" }), "\u4E0B\u8F7D"] }) }) })] }))] }), _jsxs("div", { className: "min-h-0 min-w-0 space-y-4 p-5 lg:overflow-y-auto", children: [_jsx(PromptPanel, { prompt: prompt, revisedPrompt: revisedPrompt }), _jsx(ParamPanel, { requested: result === null || result === void 0 ? void 0 : result.requestedParams, actual: (image === null || image === void 0 ? void 0 : image.actualParams) || (result === null || result === void 0 ? void 0 : result.actualParams) }), _jsx(StatusPanel, { detail: statusDetail }), (result === null || result === void 0 ? void 0 : result.rawResponseSummary) !== undefined && (_jsx(RawPanel, { value: result.rawResponseSummary }))] })] })] }));
+}
+function PromptPanel({ prompt, revisedPrompt, }) {
+    const showRevised = Boolean(revisedPrompt === null || revisedPrompt === void 0 ? void 0 : revisedPrompt.trim()) && (revisedPrompt === null || revisedPrompt === void 0 ? void 0 : revisedPrompt.trim()) !== prompt.trim();
+    return (_jsxs("section", { className: "space-y-3", children: [_jsx(PromptBlock, { label: "\u63D0\u793A\u8BCD", value: prompt, primary: true }), showRevised && (_jsx(PromptBlock, { label: "API \u6539\u5199\u63D0\u793A\u8BCD", value: revisedPrompt }))] }));
+}
+function PromptBlock({ label, value, primary, }) {
+    const [copied, setCopied] = useState(false);
+    if (!value)
+        return null;
+    return (_jsxs("div", { className: "space-y-1.5", children: [_jsxs("div", { className: "flex items-center justify-between gap-2", children: [_jsx("h3", { className: cn("font-medium text-sm", primary && "text-base"), children: label }), _jsx(TooltipIconButton, { tooltip: copied ? "已复制" : "复制", size: "icon-xs", className: "size-6", onClick: () => {
+                            copyText(value);
+                            setCopied(true);
+                            window.setTimeout(() => setCopied(false), 1200);
+                        }, children: copied ? _jsx(CheckIcon, {}) : _jsx(CopyIcon, {}) })] }), _jsx("pre", { className: cn("max-h-56 overflow-auto whitespace-pre-wrap break-words rounded-md border bg-muted/30 px-3 py-2 font-sans text-xs leading-relaxed", primary && "text-sm"), children: value })] }));
+}
+function ParamPanel({ requested, actual, }) {
+    const entries = getParamEntries(requested, actual);
+    if (entries.length === 0)
+        return null;
+    return (_jsxs("section", { className: "space-y-2", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(SlidersHorizontalIcon, { className: "size-4 text-muted-foreground" }), _jsx("h3", { className: "font-medium text-sm", children: "\u53C2\u6570" })] }), _jsx("div", { className: "flex flex-wrap gap-2", children: entries.map((entry) => (_jsxs("div", { className: "min-w-0 rounded-md border bg-background px-2.5 py-2 text-xs", children: [_jsx("p", { className: "text-muted-foreground", children: entry.label }), _jsx("p", { className: cn("mt-1 max-w-52 truncate font-medium", entry.changed && "text-amber-700 dark:text-amber-400"), children: entry.changed
+                                ? `${String(entry.requested)} -> ${String(entry.actual)}`
+                                : String(entry.value) })] }, entry.key))) })] }));
+}
+function StatusPanel({ detail }) {
+    return (_jsxs("section", { className: "space-y-1.5", children: [_jsx("h3", { className: "font-medium text-sm", children: "\u4EFB\u52A1\u72B6\u6001" }), _jsx("p", { className: "rounded-md border bg-muted/30 px-3 py-2 text-muted-foreground text-sm", children: detail })] }));
+}
+function RawPanel({ value }) {
+    const raw = stringify(value);
+    return (_jsxs(Collapsible, { className: "rounded-md border", children: [_jsx(CollapsibleTrigger, { asChild: true, children: _jsxs(Button, { type: "button", variant: "ghost", className: "h-9 w-full justify-between rounded-md px-3", children: [_jsx("span", { children: "\u539F\u59CB\u54CD\u5E94\u6458\u8981" }), _jsx(ChevronDownIcon, { className: "size-4" })] }) }), _jsxs(CollapsibleContent, { children: [_jsx(Separator, {}), _jsx("div", { className: "flex items-center justify-end px-2 py-1", children: _jsx(TooltipIconButton, { tooltip: "\u590D\u5236", size: "icon-xs", className: "size-6", onClick: () => copyText(raw), children: _jsx(CopyIcon, {}) }) }), _jsx("pre", { className: "max-h-56 overflow-auto whitespace-pre-wrap break-words px-3 pb-3 font-mono text-[11px] text-muted-foreground", children: raw })] })] }));
+}

package/dist/tools/image-generation/ui.d.ts

@@ -0,0 +1,8 @@
+import type { ToolCallMessagePartProps } from "@assistant-ui/react";
+import { type ImageGenerationRecord } from "./shared";
+export declare function isImageGenerationToolPart(part: ToolCallMessagePartProps): boolean;
+export declare function ImageGenerationToolCard(part: ToolCallMessagePartProps): import("react/jsx-runtime").JSX.Element;
+export declare function ImageGenerationRecordCard({ record, compact, }: {
+    record: ImageGenerationRecord;
+    compact?: boolean;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/tools/image-generation/ui.mjs

@@ -0,0 +1,121 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { AlertCircleIcon, CheckIcon, LoaderIcon } from "lucide-react";
+import { useMemo } from "react";
+import { Dialog, DialogTrigger } from "../../components/ui/dialog.mjs";
+import { cn } from "../../lib/utils.mjs";
+import { ACP_PROVIDER_AGENT_DYNAMIC_TOOL_NAME, IMAGE_GENERATION_MCP_NAME, IMAGE_GENERATION_MCP_TOOL_TITLE, IMAGE_GENERATION_TOOL_NAME, isRecord, parseAcpDynamicToolArgs, parseImageGenerationOutput, } from "./shared.mjs";
+import { formatBytes, ImageGenerationDetailDialog, ToolImagePreview, } from "./ui-detail.mjs";
+function getPromptFromArgs(value) {
+    if (!isRecord(value))
+        return "";
+    if (typeof value.prompt === "string")
+        return value.prompt;
+    if (isRecord(value.arguments) && typeof value.arguments.prompt === "string") {
+        return value.arguments.prompt;
+    }
+    if (isRecord(value.args))
+        return getPromptFromArgs(value.args);
+    return "";
+}
+function getDynamicToolArgs(part) {
+    const dynamicArgs = parseAcpDynamicToolArgs(part.args);
+    return dynamicArgs === null || dynamicArgs === void 0 ? void 0 : dynamicArgs.args;
+}
+function isMcpImageGenerationToolArgs(value) {
+    return (isRecord(value) &&
+        value.server === IMAGE_GENERATION_MCP_NAME &&
+        value.tool === IMAGE_GENERATION_TOOL_NAME);
+}
+function getVisualStatus(part, result) {
+    var _a, _b, _c;
+    if (((_a = part.status) === null || _a === void 0 ? void 0 : _a.type) === "running" ||
+        ((_b = part.status) === null || _b === void 0 ? void 0 : _b.type) === "requires-action") {
+        return "running";
+    }
+    if (part.isError || (result === null || result === void 0 ? void 0 : result.status) === "failed")
+        return "failed";
+    if (((_c = part.status) === null || _c === void 0 ? void 0 : _c.type) === "incomplete")
+        return "incomplete";
+    return "completed";
+}
+function getStatusMeta(status) {
+    switch (status) {
+        case "running":
+            return {
+                label: "生成中",
+                tone: "text-muted-foreground",
+                chip: "border-border bg-muted/60 text-muted-foreground",
+                Icon: LoaderIcon,
+            };
+        case "failed":
+            return {
+                label: "失败",
+                tone: "text-destructive",
+                chip: "border-destructive/30 bg-destructive/10 text-destructive",
+                Icon: AlertCircleIcon,
+            };
+        case "incomplete":
+            return {
+                label: "未完成",
+                tone: "text-muted-foreground",
+                chip: "border-border bg-muted/60 text-muted-foreground",
+                Icon: AlertCircleIcon,
+            };
+        default:
+            return {
+                label: "已完成",
+                tone: "text-emerald-700 dark:text-emerald-400",
+                chip: "border-emerald-500/25 bg-emerald-500/10 text-emerald-700 dark:text-emerald-400",
+                Icon: CheckIcon,
+            };
+    }
+}
+function getStatusDetail(part, result) {
+    var _a, _b, _c;
+    if (result === null || result === void 0 ? void 0 : result.error)
+        return result.error;
+    if (((_a = part.status) === null || _a === void 0 ? void 0 : _a.type) === "incomplete") {
+        return `工具调用未完成：${part.status.reason}`;
+    }
+    if (part.isError)
+        return "工具调用返回错误。";
+    if (((_b = part.status) === null || _b === void 0 ? void 0 : _b.type) === "running" ||
+        ((_c = part.status) === null || _c === void 0 ? void 0 : _c.type) === "requires-action") {
+        return "正在等待图片服务返回结果。";
+    }
+    return "图片已生成并保存到本地工具存储。";
+}
+export function isImageGenerationToolPart(part) {
+    if (part.toolName === IMAGE_GENERATION_MCP_TOOL_TITLE)
+        return true;
+    const dynamicArgs = parseAcpDynamicToolArgs(part.args);
+    return (part.toolName === ACP_PROVIDER_AGENT_DYNAMIC_TOOL_NAME &&
+        ((dynamicArgs === null || dynamicArgs === void 0 ? void 0 : dynamicArgs.toolName) === IMAGE_GENERATION_TOOL_NAME ||
+            (dynamicArgs === null || dynamicArgs === void 0 ? void 0 : dynamicArgs.toolName) === IMAGE_GENERATION_MCP_TOOL_TITLE ||
+            isMcpImageGenerationToolArgs(dynamicArgs === null || dynamicArgs === void 0 ? void 0 : dynamicArgs.args)));
+}
+function ImageGenerationOutputCard({ result, prompt, visualStatus, statusDetail, compact, }) {
+    const image = result === null || result === void 0 ? void 0 : result.images[0];
+    const status = getStatusMeta(visualStatus);
+    const StatusIcon = status.Icon;
+    const altText = (result === null || result === void 0 ? void 0 : result.revisedPrompt) || prompt || "Generated image";
+    const isRunning = visualStatus === "running";
+    return (_jsxs(Dialog, { children: [_jsx(DialogTrigger, { asChild: true, children: _jsxs("button", { type: "button", "data-image-generation-card": true, "data-image-generation-card-trigger": true, className: cn("aui-tool-fallback-root group/image-generation-card my-2.5 w-full overflow-hidden rounded-lg border bg-background text-left text-sm transition-colors first:mt-0 last:mb-0 hover:bg-muted/30", compact && "my-0"), children: [_jsxs("div", { className: cn("grid w-full grid-cols-[112px_minmax(0,1fr)] gap-4 p-4 max-sm:grid-cols-[88px_minmax(0,1fr)] max-sm:gap-3", compact && "grid-cols-[72px_minmax(0,1fr)] gap-3 p-3"), children: [_jsx("div", { className: cn("relative aspect-square size-28 shrink-0 overflow-hidden rounded-md border bg-muted text-muted-foreground max-sm:size-22", compact && "size-18 max-sm:size-18"), children: _jsx(ToolImagePreview, { image: image, alt: altText, compact: true }) }), _jsxs("div", { className: cn("flex min-h-28 min-w-0 flex-col max-sm:min-h-22", compact && "min-h-18 max-sm:min-h-18"), children: [_jsxs("div", { className: "flex items-center justify-between gap-2", children: [_jsxs("div", { className: "flex min-w-0 items-center gap-2", children: [_jsx(StatusIcon, { className: cn("size-4 shrink-0", status.tone, isRunning && "animate-spin") }), _jsx("span", { className: "truncate font-medium", children: "\u56FE\u7247\u751F\u6210" })] }), _jsx("span", { className: cn("shrink-0 rounded-md border px-1.5 py-0.5 font-medium text-[11px]", status.chip), children: status.label })] }), _jsx("p", { className: cn("mt-2 line-clamp-2 text-muted-foreground leading-6 max-sm:text-xs", compact && "mt-1 leading-5"), children: prompt || "等待图片生成参数" }), _jsxs("div", { className: cn("mt-auto flex min-w-0 flex-wrap gap-1.5 pt-3 text-muted-foreground text-xs", compact && "pt-2"), children: [_jsx("span", { className: "rounded-md bg-muted px-1.5 py-0.5", children: "\u67E5\u770B\u8BE6\u60C5" }), !compact && (result === null || result === void 0 ? void 0 : result.actualParams.model) && (_jsx("span", { className: "rounded-md bg-muted px-1.5 py-0.5", children: result.actualParams.model })), (result === null || result === void 0 ? void 0 : result.actualParams.size) && (_jsx("span", { className: "rounded-md bg-muted px-1.5 py-0.5", children: result.actualParams.size })), (image === null || image === void 0 ? void 0 : image.sizeBytes) && (_jsx("span", { className: "rounded-md bg-muted px-1.5 py-0.5", children: formatBytes(image.sizeBytes) }))] })] })] }), visualStatus === "failed" && (_jsx("p", { className: "mx-4 mb-4 rounded-md border border-destructive/30 bg-destructive/10 px-3 py-2 text-destructive text-xs", children: statusDetail }))] }) }), _jsx(ImageGenerationDetailDialog, { result: result, prompt: prompt, image: image, altText: altText, status: status, statusDetail: statusDetail, isRunning: isRunning })] }));
+}
+export function ImageGenerationToolCard(part) {
+    const toolArgs = part.toolName === IMAGE_GENERATION_MCP_TOOL_TITLE
+        ? part.args
+        : getDynamicToolArgs(part);
+    const result = useMemo(() => parseImageGenerationOutput(part.result), [part.result]);
+    const prompt = (result === null || result === void 0 ? void 0 : result.prompt) || getPromptFromArgs(toolArgs);
+    const visualStatus = getVisualStatus(part, result);
+    return (_jsx(ImageGenerationOutputCard, { result: result, prompt: prompt, visualStatus: visualStatus, statusDetail: getStatusDetail(part, result) }));
+}
+export function ImageGenerationRecordCard({ record, compact, }) {
+    const result = Object.assign(Object.assign(Object.assign({ status: record.status, recordId: record.id, requestId: record.requestId || record.id, provider: record.provider, prompt: record.prompt }, (record.revisedPrompt ? { revisedPrompt: record.revisedPrompt } : {})), { requestedParams: record.requestedParams, actualParams: record.actualParams, images: record.images, durationMs: record.durationMs }), (record.error ? { error: record.error } : {}));
+    return (_jsx(ImageGenerationOutputCard, { result: result, prompt: record.prompt, visualStatus: record.status, statusDetail: record.error ||
+            (record.status === "failed"
+                ? "图片生成失败。"
+                : "图片已生成并保存到本地工具存储。"), compact: compact }));
+}

package/dist/tools/registry.d.ts

@@ -0,0 +1,32 @@
+import type { AcpBuiltinToolId, AcpMcpServer } from "../lib/acp2aisdk/types";
+export type BuiltinToolRegistration = {
+    id: AcpBuiltinToolId;
+    getMcpServer(options: {
+        workspacePath?: string | null;
+        threadId?: string | null;
+        settings?: unknown;
+    }): AcpMcpServer | null;
+    getRuntimeKey(settings: unknown): unknown;
+    sanitizePersistedSettings(settings: unknown): unknown;
+    mergePersistedSettings(current: unknown, patch: unknown): unknown;
+};
+export declare function getBuiltinToolRegistrations(): BuiltinToolRegistration[];
+export declare function getBuiltinToolRuntimeKey(options: {
+    toolIds?: readonly AcpBuiltinToolId[] | null;
+    builtinToolSettings?: Record<string, unknown> | null;
+}): string;
+export declare function sanitizePersistedBuiltinToolSettingsPatch(settings: unknown): Record<string, unknown> | null;
+export declare function normalizePersistedBuiltinToolSettings(settings: unknown): Record<string, unknown> | null;
+export declare function mergePersistedBuiltinToolSettings(current: unknown, patch: unknown): Record<string, unknown> | null;
+export declare function getBuiltinToolMcpServers(options?: {
+    workspacePath?: string | null;
+    threadId?: string | null;
+    toolIds?: readonly AcpBuiltinToolId[] | null;
+    builtinToolSettings?: Record<string, unknown> | null;
+}): AcpMcpServer[];
+export declare function mergeToolMcpServers(requestedServers: AcpMcpServer[], options?: {
+    workspacePath?: string | null;
+    threadId?: string | null;
+    toolIds?: readonly AcpBuiltinToolId[] | null;
+    builtinToolSettings?: Record<string, unknown> | null;
+}): AcpMcpServer[];