@axhub/acp 0.1.0

package/dist/tools/user-choice/ui.mjs

@@ -0,0 +1,396 @@
+"use client";
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { useAui, useAuiState } from "@assistant-ui/react";
+import { CheckCircleIcon, HelpCircleIcon, XCircleIcon } from "lucide-react";
+import { useEffect, useMemo, useRef, useState } from "react";
+import { OptionList } from "../../components/tool-ui/option-list.mjs";
+import { Button } from "../../components/ui/button.mjs";
+import { useAcpUiRuntimeContext } from "../../lib/acp2aisdk/client-context.mjs";
+import { acpApiClient } from "../../lib/api/client.mjs";
+import { cn } from "../../lib/utils.mjs";
+import { ACP_PROVIDER_AGENT_DYNAMIC_TOOL_NAME, parseAcpDynamicToolArgs, } from "../image-generation/shared.mjs";
+import { isRecord, USER_CHOICE_MCP_NAME, USER_CHOICE_MCP_TOOL_TITLE, USER_CHOICE_RESULT_MESSAGE_PREFIX, USER_CHOICE_TOOL_NAME, } from "./shared.mjs";
+const DEV_REVIEW_LOCAL_REQUEST_FLAG = "__acpUiDevReviewLocalRequest";
+const DEV_REVIEW_INITIAL_STEP_INDEX = "__acpUiDevReviewInitialStepIndex";
+function normalizeString(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+function parseResult(value) {
+    if (!isRecord(value))
+        return null;
+    const structured = isRecord(value.structuredContent)
+        ? value.structuredContent
+        : value;
+    if (structured.status === "answered" &&
+        typeof structured.requestId === "string" &&
+        structured.action === "accept" &&
+        isRecord(structured.content)) {
+        return {
+            status: "answered",
+            requestId: structured.requestId,
+            action: "accept",
+            content: structured.content,
+        };
+    }
+    if (structured.status === "cancelled" &&
+        typeof structured.requestId === "string") {
+        return {
+            status: "cancelled",
+            requestId: structured.requestId,
+            action: "cancel",
+        };
+    }
+    if (structured.status === "user_no_response" &&
+        typeof structured.requestId === "string") {
+        return {
+            status: "user_no_response",
+            requestId: structured.requestId,
+            instruction: normalizeString(structured.instruction),
+        };
+    }
+    return null;
+}
+function isMcpUserChoiceToolArgs(value) {
+    return (isRecord(value) &&
+        value.server === USER_CHOICE_MCP_NAME &&
+        value.tool === USER_CHOICE_TOOL_NAME);
+}
+function getDynamicToolArgs(part) {
+    return parseAcpDynamicToolArgs(part.args);
+}
+function getToolInput(part) {
+    var _a;
+    if (part.toolName === USER_CHOICE_MCP_TOOL_TITLE)
+        return part.args;
+    return (_a = getDynamicToolArgs(part)) === null || _a === void 0 ? void 0 : _a.args;
+}
+function isDevReviewLocalRequestInput(value) {
+    if (!isRecord(value))
+        return false;
+    if (value[DEV_REVIEW_LOCAL_REQUEST_FLAG] === true)
+        return true;
+    if (isRecord(value.arguments)) {
+        return isDevReviewLocalRequestInput(value.arguments);
+    }
+    if (isRecord(value.args))
+        return isDevReviewLocalRequestInput(value.args);
+    return false;
+}
+function getDevReviewInitialStepIndex(value) {
+    if (!isRecord(value))
+        return 0;
+    const raw = value[DEV_REVIEW_INITIAL_STEP_INDEX];
+    if (typeof raw === "number" && Number.isFinite(raw)) {
+        return Math.max(0, Math.floor(raw));
+    }
+    if (isRecord(value.arguments)) {
+        return getDevReviewInitialStepIndex(value.arguments);
+    }
+    if (isRecord(value.args))
+        return getDevReviewInitialStepIndex(value.args);
+    return 0;
+}
+export function isUserChoiceToolPart(part) {
+    if (part.toolName === USER_CHOICE_MCP_TOOL_TITLE)
+        return true;
+    const dynamicArgs = getDynamicToolArgs(part);
+    return (part.toolName === ACP_PROVIDER_AGENT_DYNAMIC_TOOL_NAME &&
+        ((dynamicArgs === null || dynamicArgs === void 0 ? void 0 : dynamicArgs.toolName) === USER_CHOICE_TOOL_NAME ||
+            (dynamicArgs === null || dynamicArgs === void 0 ? void 0 : dynamicArgs.toolName) === USER_CHOICE_MCP_TOOL_TITLE ||
+            isMcpUserChoiceToolArgs(dynamicArgs === null || dynamicArgs === void 0 ? void 0 : dynamicArgs.args)));
+}
+function normalizeQuestionFromArgs(value) {
+    if (!isRecord(value))
+        return [];
+    if (Array.isArray(value.questions)) {
+        return normalizeQuestions(value.questions);
+    }
+    if (isRecord(value.question))
+        return normalizeQuestions([value.question]);
+    if (isRecord(value.arguments))
+        return normalizeQuestionFromArgs(value.arguments);
+    if (isRecord(value.args))
+        return normalizeQuestionFromArgs(value.args);
+    return [];
+}
+function normalizeQuestions(value) {
+    return value.flatMap((question) => {
+        if (!isRecord(question))
+            return [];
+        const fieldName = normalizeString(question.fieldName);
+        if (!fieldName)
+            return [];
+        const options = Array.isArray(question.options)
+            ? question.options.flatMap((option) => {
+                if (!isRecord(option))
+                    return [];
+                const id = normalizeString(option.id);
+                if (!id)
+                    return [];
+                return [
+                    Object.assign(Object.assign(Object.assign({ id, label: normalizeString(option.label) ||
+                            normalizeString(option.title) ||
+                            id }, (normalizeString(option.description)
+                        ? { description: normalizeString(option.description) }
+                        : {})), (option.disabled === true ? { disabled: true } : {})), (option.recommended === true ? { recommended: true } : {})),
+                ];
+            })
+            : [];
+        if (options.length === 0)
+            return [];
+        return [
+            Object.assign(Object.assign({ fieldName, fieldTitle: normalizeString(question.fieldTitle) ||
+                    normalizeString(question.title) ||
+                    fieldName }, (normalizeString(question.fieldDescription)
+                ? { fieldDescription: normalizeString(question.fieldDescription) }
+                : {})), { selectionMode: question.selectionMode === "single" ? "single" : "multi", options, defaultValue: Array.isArray(question.defaultValue) ||
+                    typeof question.defaultValue === "string" ||
+                    question.defaultValue === null
+                    ? question.defaultValue
+                    : null, minSelections: typeof question.minSelections === "number"
+                    ? question.minSelections
+                    : undefined, maxSelections: typeof question.maxSelections === "number"
+                    ? question.maxSelections
+                    : undefined, required: question.required !== false, allowCustomInput: question.allowCustomInput !== false, customInputLabel: normalizeString(question.customInputLabel) || "自定义" }),
+        ];
+    });
+}
+function getMessageFromArgs(value) {
+    if (!isRecord(value))
+        return "请选择";
+    return (normalizeString(value.message) ||
+        (isRecord(value.arguments) ? getMessageFromArgs(value.arguments) : "") ||
+        (isRecord(value.args) ? getMessageFromArgs(value.args) : "") ||
+        "请选择");
+}
+function selectedToContentValue(question, value) {
+    var _a;
+    if (question.selectionMode === "multi") {
+        return Array.isArray(value) ? value : value ? [value] : [];
+    }
+    return Array.isArray(value) ? ((_a = value[0]) !== null && _a !== void 0 ? _a : null) : value;
+}
+function formatValue(value) {
+    if (Array.isArray(value))
+        return value.join("、") || "未选择";
+    return value || "未选择";
+}
+function createChoiceResultMessage(result) {
+    const action = "action" in result ? result.action : result.status;
+    return [
+        USER_CHOICE_RESULT_MESSAGE_PREFIX,
+        `requestId: ${result.requestId}`,
+        `action: ${action}`,
+        "content:",
+        JSON.stringify(result, null, 2),
+    ].join("\n");
+}
+function QuestionStep({ request, question, stepIndex, stepCount, onSubmit, }) {
+    var _a, _b, _c;
+    const [value, setValue] = useState((_a = question.defaultValue) !== null && _a !== void 0 ? _a : null);
+    const minSelections = (_b = question.minSelections) !== null && _b !== void 0 ? _b : (question.required === false ? 0 : 1);
+    const maxSelections = question.selectionMode === "single" ? 1 : question.maxSelections;
+    const selectionCount = value === null ? 0 : Array.isArray(value) ? value.length : 1;
+    const canConfirm = selectionCount >= minSelections &&
+        (maxSelections === undefined || selectionCount <= maxSelections);
+    return (_jsxs("div", { children: [stepCount > 1 && (_jsxs("div", { className: "mb-2 text-muted-foreground text-xs", children: [stepIndex + 1, " / ", stepCount] })), _jsxs("div", { className: "mb-2", children: [_jsx("div", { className: "font-medium text-sm", children: question.fieldTitle }), question.fieldDescription && (_jsx("div", { className: "mt-1 text-muted-foreground text-xs", children: question.fieldDescription }))] }), _jsx(OptionList, { id: `${request.requestId}-${question.fieldName}`, options: question.options, selectionMode: question.selectionMode, value: value, defaultValue: question.defaultValue, minSelections: minSelections, maxSelections: maxSelections, allowCustomInput: question.allowCustomInput !== false, customInputLabel: (_c = question.customInputLabel) !== null && _c !== void 0 ? _c : "自定义", className: "my-0 border-0 bg-transparent p-0 shadow-none", actions: [], onChange: setValue }, `${request.requestId}-${question.fieldName}`), _jsx("div", { className: "mt-3 flex justify-end", children: _jsx(Button, { type: "button", size: "sm", disabled: !canConfirm, onClick: () => onSubmit(value), children: "\u786E\u8BA4" }) })] }));
+}
+export function UserChoiceToolCard(part) {
+    var _a;
+    const aui = useAui();
+    const threadId = useAuiState((state) => state.threadListItem.remoteId);
+    const { workspacePath } = useAcpUiRuntimeContext();
+    const result = useMemo(() => parseResult(part.result), [part.result]);
+    const toolInput = useMemo(() => getToolInput(part), [part]);
+    const fallbackQuestions = useMemo(() => normalizeQuestionFromArgs(toolInput), [toolInput]);
+    const fallbackMessage = useMemo(() => getMessageFromArgs(toolInput), [toolInput]);
+    const isLocalReviewRequest = useMemo(() => isDevReviewLocalRequestInput(toolInput), [toolInput]);
+    const initialStepIndex = useMemo(() => Math.min(getDevReviewInitialStepIndex(toolInput), Math.max(fallbackQuestions.length - 1, 0)), [toolInput, fallbackQuestions.length]);
+    const [request, setRequest] = useState(null);
+    const [answers, setAnswers] = useState({});
+    const [stepIndex, setStepIndex] = useState(0);
+    const [submitting, setSubmitting] = useState(false);
+    const [submittedAnswer, setSubmittedAnswer] = useState(null);
+    const lastRequestIdRef = useRef(null);
+    useEffect(() => {
+        if (isLocalReviewRequest && fallbackQuestions.length > 0)
+            return;
+        if (result === null || result === void 0 ? void 0 : result.requestId) {
+            acpApiClient
+                .getUserChoiceRequest({
+                workspacePath,
+                requestId: result.requestId,
+            })
+                .then(({ request }) => setRequest(request))
+                .catch(() => { });
+            return;
+        }
+        const interval = window.setInterval(() => {
+            acpApiClient
+                .getUserChoiceRequest({
+                workspacePath,
+                threadId,
+                toolCallId: part.toolCallId,
+            })
+                .then(({ request }) => {
+                if (request) {
+                    setRequest(request);
+                    window.clearInterval(interval);
+                    return;
+                }
+                return acpApiClient
+                    .getUserChoiceRequest({
+                    workspacePath,
+                    threadId,
+                })
+                    .then(({ request }) => {
+                    if (request) {
+                        setRequest(request);
+                        window.clearInterval(interval);
+                    }
+                });
+            })
+                .catch(() => { });
+        }, 500);
+        return () => window.clearInterval(interval);
+    }, [
+        fallbackQuestions.length,
+        isLocalReviewRequest,
+        part.toolCallId,
+        result === null || result === void 0 ? void 0 : result.requestId,
+        threadId,
+        workspacePath,
+    ]);
+    const localReviewRequest = useMemo(() => {
+        if (!isLocalReviewRequest || fallbackQuestions.length === 0)
+            return null;
+        return {
+            requestId: `dev-review-${part.toolCallId}`,
+            workspacePath: workspacePath !== null && workspacePath !== void 0 ? workspacePath : "",
+            threadId: threadId !== null && threadId !== void 0 ? threadId : null,
+            toolCallId: part.toolCallId,
+            message: fallbackMessage,
+            questions: fallbackQuestions,
+            waitTimeoutMs: 120000,
+            status: "pending",
+            createdAt: "",
+            updatedAt: "",
+            expiresAt: "",
+        };
+    }, [
+        fallbackMessage,
+        fallbackQuestions,
+        isLocalReviewRequest,
+        part.toolCallId,
+        threadId,
+        workspacePath,
+    ]);
+    const activeRequest = request !== null && request !== void 0 ? request : localReviewRequest;
+    const requestId = (_a = activeRequest === null || activeRequest === void 0 ? void 0 : activeRequest.requestId) !== null && _a !== void 0 ? _a : null;
+    useEffect(() => {
+        if (lastRequestIdRef.current === requestId)
+            return;
+        lastRequestIdRef.current = requestId;
+        setSubmittedAnswer(null);
+        setAnswers({});
+        setStepIndex(initialStepIndex);
+    }, [initialStepIndex, requestId]);
+    const effectiveQuestions = (activeRequest === null || activeRequest === void 0 ? void 0 : activeRequest.questions) && activeRequest.questions.length > 0
+        ? activeRequest.questions
+        : fallbackQuestions;
+    const effectiveMessage = (activeRequest === null || activeRequest === void 0 ? void 0 : activeRequest.message) || fallbackMessage;
+    const currentQuestion = effectiveQuestions[stepIndex];
+    const displayResult = (result === null || result === void 0 ? void 0 : result.status) === "user_no_response"
+        ? submittedAnswer
+        : (result !== null && result !== void 0 ? result : submittedAnswer);
+    const visualStatus = result
+        ? (displayResult === null || displayResult === void 0 ? void 0 : displayResult.status) === "answered"
+            ? "answered"
+            : (displayResult === null || displayResult === void 0 ? void 0 : displayResult.status) === "cancelled"
+                ? "cancelled"
+                : activeRequest
+                    ? "pending"
+                    : "expired"
+        : displayResult
+            ? displayResult.status === "answered"
+                ? "answered"
+                : displayResult.status === "cancelled"
+                    ? "cancelled"
+                    : "expired"
+            : activeRequest
+                ? "pending"
+                : "loading";
+    const StatusIcon = visualStatus === "answered"
+        ? CheckCircleIcon
+        : visualStatus === "cancelled" || visualStatus === "expired"
+            ? XCircleIcon
+            : HelpCircleIcon;
+    const submitResult = async (answer) => {
+        setSubmitting(true);
+        try {
+            if (activeRequest === localReviewRequest) {
+                setSubmittedAnswer(answer);
+                return;
+            }
+            await acpApiClient.answerUserChoiceRequest({
+                workspacePath,
+                requestId: answer.requestId,
+                answer,
+            });
+            setSubmittedAnswer(answer);
+            if ((result === null || result === void 0 ? void 0 : result.status) === "user_no_response") {
+                const state = aui.thread().getState();
+                if (state.isRunning)
+                    aui.thread().cancelRun();
+                aui.thread().append({
+                    role: "user",
+                    content: [{ type: "text", text: createChoiceResultMessage(answer) }],
+                    startRun: true,
+                });
+            }
+        }
+        finally {
+            setSubmitting(false);
+        }
+    };
+    const handleStepSubmit = (value) => {
+        if (!currentQuestion || !activeRequest)
+            return;
+        const nextAnswers = Object.assign(Object.assign({}, answers), { [currentQuestion.fieldName]: selectedToContentValue(currentQuestion, value) });
+        setAnswers(nextAnswers);
+        if (stepIndex < effectiveQuestions.length - 1) {
+            setStepIndex((current) => current + 1);
+            return;
+        }
+        void submitResult({
+            status: "answered",
+            requestId: activeRequest.requestId,
+            action: "accept",
+            content: nextAnswers,
+        });
+    };
+    const receipt = (displayResult === null || displayResult === void 0 ? void 0 : displayResult.status) === "answered"
+        ? Object.entries(displayResult.content)
+            .map(([key, value]) => {
+            var _a;
+            const question = effectiveQuestions.find((item) => item.fieldName === key);
+            return `${(_a = question === null || question === void 0 ? void 0 : question.fieldTitle) !== null && _a !== void 0 ? _a : key}: ${formatValue(value)}`;
+        })
+            .join("；")
+        : (displayResult === null || displayResult === void 0 ? void 0 : displayResult.status) === "cancelled"
+            ? "已取消"
+            : "";
+    return (_jsxs("div", { "data-slot": "tool-ui-user-choice", className: "my-2.5 w-full rounded-lg border bg-card p-4 shadow-xs", children: [_jsxs("div", { className: "mb-3 flex items-start gap-3", children: [_jsx(StatusIcon, { className: cn("mt-0.5 size-4 shrink-0", visualStatus === "answered"
+                            ? "text-emerald-600 dark:text-emerald-400"
+                            : visualStatus === "pending"
+                                ? "text-primary"
+                                : "text-muted-foreground") }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("div", { className: "break-words font-medium text-base leading-snug", children: effectiveMessage }), _jsx("div", { className: "mt-1 text-muted-foreground text-xs", children: visualStatus === "loading"
+                                    ? "准备选项"
+                                    : visualStatus === "pending"
+                                        ? "等待选择"
+                                        : receipt })] })] }), displayResult && receipt ? (_jsx("div", { className: "rounded-md border bg-muted/40 px-3 py-2 text-sm", children: receipt })) : currentQuestion && activeRequest ? (_jsx(QuestionStep, { request: activeRequest, question: currentQuestion, stepIndex: stepIndex, stepCount: effectiveQuestions.length, onSubmit: handleStepSubmit }, `${activeRequest.requestId}-${currentQuestion.fieldName}-${stepIndex}`)) : (_jsx("div", { className: "rounded-md border bg-muted/40 px-3 py-2 text-muted-foreground text-sm", children: "\u6B63\u5728\u51C6\u5907\u9009\u9879..." })), activeRequest && !displayResult && (_jsx("div", { className: "mt-3 flex justify-end gap-2", children: _jsx(Button, { type: "button", variant: "outline", size: "sm", disabled: submitting, onClick: () => void submitResult({
+                        status: "cancelled",
+                        requestId: activeRequest.requestId,
+                        action: "cancel",
+                    }), children: "\u53D6\u6D88" }) }))] }));
+}

package/package.json

@@ -0,0 +1,118 @@
+{
+	"name": "@axhub/acp",
+	"version": "0.1.0",
+	"private": false,
+	"engines": {
+		"node": ">=20.9.0"
+	},
+	"bin": {
+		"acp": "bin/acp.mjs"
+	},
+	"exports": {
+		".": {
+			"default": "./bin/acp.mjs"
+		},
+		"./ui": {
+			"types": "./dist/public-api/ui.d.ts",
+			"default": "./dist/public-api/ui.mjs"
+		},
+		"./runtime": {
+			"types": "./dist/public-api/runtime.d.ts",
+			"default": "./dist/public-api/runtime.mjs"
+		},
+		"./server": {
+			"types": "./dist/public-api/server.d.ts",
+			"default": "./dist/public-api/server.mjs"
+		},
+		"./react": {
+			"types": "./dist/public-api/react.d.ts",
+			"default": "./dist/public-api/react.mjs"
+		},
+		"./react/styles.css": "./dist/public-api/styles.css"
+	},
+	"files": [
+		".next/BUILD_ID",
+		".next/*.json",
+		".next/*.js",
+		".next/server",
+		".next/static",
+		"bin",
+		"dist",
+		"README.md",
+		"THIRD_PARTY_NOTICES.md",
+		"!**/*.map"
+	],
+	"scripts": {
+		"dev": "node scripts/dev-server.mjs",
+		"dev:host": "node scripts/dev-server.mjs --hostname 0.0.0.0 --cors-origin http://localhost:53817,http://127.0.0.1:53817",
+		"build": "next build",
+		"build:public-api": "node scripts/build-public-api.mjs",
+		"build:sanitize": "node scripts/sanitize-next-build.mjs",
+		"start": "node bin/acp.mjs",
+		"pack:npm": "node scripts/release-npm.mjs pack stable",
+		"pack:npm:beta": "node scripts/release-npm.mjs pack beta",
+		"release:npm": "node scripts/release-npm.mjs publish stable",
+		"release:npm:beta": "node scripts/release-npm.mjs publish beta",
+		"refresh:default-capabilities": "node scripts/refresh-default-capabilities.mjs",
+		"refresh:codex-defaults": "node scripts/refresh-codex-default-capabilities.mjs",
+		"regression": "node scripts/regression/run-acp-regression.mjs",
+		"regression:cli": "node scripts/regression/cli-env.mjs",
+		"regression:conversations": "node scripts/regression/conversation-history.mjs",
+		"regression:acp:upgrade": "node scripts/regression/acp-upgrade-followup.mjs",
+		"regression:providers:registry": "node scripts/regression/provider-registry.mjs",
+		"regression:providers:official": "node scripts/regression/provider-official-smoke.mjs",
+		"regression:providers:smoke": "node scripts/regression/provider-smoke.mjs",
+		"regression:image-generation:real": "node scripts/regression/image-generation-real.mjs",
+		"regression:codex:p0": "node scripts/regression/codex-p0.mjs",
+		"test:frontend:midscene": "node scripts/regression/run-midscene-frontend.mjs",
+		"test:frontend:midscene:matrix": "node scripts/regression/run-midscene-frontend-matrix.mjs",
+		"test:frontend:midscene:config": "node scripts/regression/run-midscene-frontend.mjs --print-config",
+		"test:public-api-package": "node scripts/verify-public-api-package.mjs",
+		"format": "biome format .",
+		"format:fix": "biome format --write .",
+		"lint": "biome check .",
+		"lint:fix": "biome check --write ."
+	},
+	"dependencies": {
+		"@agentclientprotocol/sdk": "^0.23.0",
+		"@assistant-ui/react": "^0.14.7",
+		"@assistant-ui/react-ai-sdk": "^1.3.26",
+		"@assistant-ui/react-markdown": "^0.14.0",
+		"@modelcontextprotocol/sdk": "^1.29.0",
+		"@radix-ui/react-avatar": "^1.1.11",
+		"@radix-ui/react-collapsible": "^1.1.12",
+		"@radix-ui/react-dialog": "^1.1.15",
+		"@radix-ui/react-slot": "^1.2.4",
+		"@radix-ui/react-tooltip": "^1.2.8",
+		"@zed-industries/codex-acp": "^0.15.0",
+		"ai": "^6.0.188",
+		"class-variance-authority": "^0.7.1",
+		"clsx": "^2.1.1",
+		"lucide-react": "^1.16.0",
+		"next": "^16.2.6",
+		"radix-ui": "^1.4.3",
+		"react": "^19.2.6",
+		"react-dom": "^19.2.6",
+		"remark-gfm": "^4.0.1",
+		"tailwind-merge": "^3.6.0",
+		"tw-animate-css": "^1.4.0",
+		"tw-shimmer": "^0.4.11",
+		"zustand": "^5.0.13",
+		"zod": "^4.1.13"
+	},
+	"peerDependencies": {
+		"@assistant-ui/react": "^0.14.7",
+		"@assistant-ui/react-ai-sdk": "^1.3.26",
+		"react": ">=18.2.0 <20",
+		"react-dom": ">=18.2.0 <20"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^2.4.15",
+		"@tailwindcss/postcss": "^4.3.0",
+		"@types/node": "^25.9.1",
+		"@types/react": "^19.2.15",
+		"@types/react-dom": "^19.2.3",
+		"tailwindcss": "^4.3.0",
+		"typescript": "^6.0.3"
+	}
+}