@axhub/acp 0.1.0

package/dist/lib/acp2aisdk/default-capabilities.mjs

@@ -0,0 +1,421 @@
+/* Generated by scripts/refresh-default-capabilities.mjs. Do not edit by hand. */
+import { ACP_PROVIDER_DEFAULT_MODE_IDS } from "./provider-registry.mjs";
+export const ACP_CAPABILITY_CACHE_TTL_MS = 30 * 60 * 1000;
+export const ACP_DEFAULT_CAPABILITY_SNAPSHOTS = {
+    claude: {
+        provider: "claude",
+        sessionId: null,
+        source: "generated-default",
+        updatedAt: "2026-05-27T10:18:02.000Z",
+        ttl: ACP_CAPABILITY_CACHE_TTL_MS,
+        agentVersion: null,
+        capabilities: {
+            model: {
+                key: "model",
+                currentValue: "sonnet",
+                configId: "model",
+                configKey: "model",
+                source: "fallback",
+                options: [
+                    {
+                        value: "sonnet",
+                        label: "Sonnet",
+                        description: "Claude Sonnet 默认模型。",
+                        order: 0,
+                    },
+                    {
+                        value: "opus",
+                        label: "Opus",
+                        description: "Claude Opus 高能力模型。",
+                        order: 1,
+                    },
+                    {
+                        value: "haiku",
+                        label: "Haiku",
+                        description: "Claude Haiku 快速模型。",
+                        order: 2,
+                    },
+                    {
+                        value: "opusplan",
+                        label: "Opus Plan",
+                        description: "Claude Opus 规划模式。",
+                        order: 3,
+                    },
+                    {
+                        value: "sonnet[1m]",
+                        label: "Sonnet [1M]",
+                        description: "Claude Sonnet 长上下文模型。",
+                        order: 4,
+                    },
+                ],
+            },
+            mode: {
+                key: "mode",
+                currentValue: ACP_PROVIDER_DEFAULT_MODE_IDS.claude,
+                configId: "mode",
+                configKey: "mode",
+                source: "fallback",
+                options: [
+                    {
+                        value: "default",
+                        label: "默认",
+                        description: "使用供应商默认权限策略。",
+                        order: 0,
+                    },
+                    {
+                        value: "acceptEdits",
+                        label: "接受编辑",
+                        description: "允许编辑类操作更顺畅地继续。",
+                        order: 1,
+                    },
+                    {
+                        value: "bypassPermissions",
+                        label: "绕过权限",
+                        description: "尽量减少权限确认，适合受信任工作区。",
+                        order: 2,
+                    },
+                    {
+                        value: "plan",
+                        label: "计划",
+                        description: "先规划再执行，适合复杂任务。",
+                        order: 3,
+                    },
+                ],
+            },
+            thought_level: {
+                key: "thought_level",
+                currentValue: "none",
+                configId: "thought_level",
+                configKey: "thought_level",
+                source: "fallback",
+                options: [
+                    {
+                        value: "none",
+                        label: "无",
+                        description: "不额外请求思考深度。",
+                        order: 0,
+                    },
+                    {
+                        value: "think",
+                        label: "Think",
+                        description: "轻量思考。",
+                        order: 1,
+                    },
+                    {
+                        value: "think-hard",
+                        label: "Think Hard",
+                        description: "更深入思考。",
+                        order: 2,
+                    },
+                    {
+                        value: "think-harder",
+                        label: "Think Harder",
+                        description: "高强度思考。",
+                        order: 3,
+                    },
+                    {
+                        value: "ultrathink",
+                        label: "Ultrathink",
+                        description: "最高强度思考。",
+                        order: 4,
+                    },
+                ],
+            },
+        },
+        metadata: {
+            availableCommands: [],
+            tokenUsage: null,
+            rawSession: null,
+        },
+    },
+    codex: {
+        provider: "codex",
+        sessionId: null,
+        source: "generated-default",
+        updatedAt: "2026-05-26T06:24:12.704Z",
+        ttl: ACP_CAPABILITY_CACHE_TTL_MS,
+        agentVersion: null,
+        capabilities: {
+            model: {
+                key: "model",
+                currentValue: "gpt-5.5",
+                configId: "model",
+                configKey: "model",
+                source: "fallback",
+                options: [
+                    {
+                        value: "gpt-5.5",
+                        label: "GPT-5.5",
+                        description: "适合复杂编码、研究和真实工作场景的前沿模型。",
+                        order: 0,
+                    },
+                    {
+                        value: "gpt-5.4",
+                        label: "gpt-5.4",
+                        description: "适合日常编码的强力模型。",
+                        order: 1,
+                    },
+                    {
+                        value: "gpt-5.4-mini",
+                        label: "GPT-5.4-Mini",
+                        description: "适合简单编码任务的小型、快速且高性价比模型。",
+                        order: 2,
+                    },
+                    {
+                        value: "gpt-5.3-codex",
+                        label: "gpt-5.3-codex",
+                        description: "针对编码优化的模型。",
+                        order: 3,
+                    },
+                    {
+                        value: "gpt-5.2",
+                        label: "gpt-5.2",
+                        description: "针对专业工作和长时间运行的 agent 优化。",
+                        order: 4,
+                    },
+                ],
+            },
+            mode: {
+                key: "mode",
+                currentValue: ACP_PROVIDER_DEFAULT_MODE_IDS.codex,
+                configId: "mode",
+                configKey: "mode",
+                source: "fallback",
+                options: [
+                    {
+                        value: "read-only",
+                        label: "只读",
+                        description: "Codex 可以读取当前工作区文件。编辑文件或访问互联网需要审批。",
+                        order: 0,
+                    },
+                    {
+                        value: "auto",
+                        label: "默认",
+                        description: "Codex 可以读取和编辑当前工作区文件，并运行命令。访问互联网或编辑其他文件需要审批。（等同于 Agent 模式）",
+                        order: 1,
+                    },
+                    {
+                        value: "full-access",
+                        label: "完全访问",
+                        description: "Codex 可以编辑工作区外的文件并访问互联网，无需请求审批。使用时请谨慎。",
+                        order: 2,
+                    },
+                ],
+            },
+            thought_level: {
+                key: "thought_level",
+                currentValue: "xhigh",
+                configId: "reasoning_effort",
+                configKey: "reasoning_effort",
+                source: "fallback",
+                options: [
+                    {
+                        value: "low",
+                        label: "低",
+                        description: "更轻量推理，响应更快",
+                        order: 0,
+                    },
+                    {
+                        value: "medium",
+                        label: "中",
+                        description: "在速度和推理深度之间取得平衡，适合日常任务",
+                        order: 1,
+                    },
+                    {
+                        value: "high",
+                        label: "高",
+                        description: "为复杂问题提供更深的推理",
+                        order: 2,
+                    },
+                    {
+                        value: "xhigh",
+                        label: "极高",
+                        description: "为复杂问题提供极高推理深度",
+                        order: 3,
+                    },
+                ],
+            },
+        },
+        metadata: {
+            availableCommands: [],
+            tokenUsage: null,
+            rawSession: null,
+        },
+    },
+    gemini: {
+        provider: "gemini",
+        sessionId: null,
+        source: "generated-default",
+        updatedAt: "2026-05-27T10:18:02.000Z",
+        ttl: ACP_CAPABILITY_CACHE_TTL_MS,
+        agentVersion: null,
+        capabilities: {
+            model: {
+                key: "model",
+                currentValue: "gemini-3-pro-preview",
+                configId: "model",
+                configKey: "model",
+                source: "fallback",
+                options: [
+                    {
+                        value: "gemini-2.5-pro",
+                        label: "Gemini 2.5 Pro",
+                        description: "Gemini Pro 稳定模型。",
+                        order: 0,
+                    },
+                    {
+                        value: "gemini-2.5-flash",
+                        label: "Gemini 2.5 Flash",
+                        description: "Gemini Flash 快速模型。",
+                        order: 1,
+                    },
+                    {
+                        value: "gemini-3-pro-preview",
+                        label: "Gemini 3 Pro Preview",
+                        description: "Gemini 3 Pro 预览模型。",
+                        order: 2,
+                    },
+                    {
+                        value: "gemini-3-flash-preview",
+                        label: "Gemini 3 Flash Preview",
+                        description: "Gemini 3 Flash 预览模型。",
+                        order: 3,
+                    },
+                ],
+            },
+            mode: {
+                key: "mode",
+                currentValue: ACP_PROVIDER_DEFAULT_MODE_IDS.gemini,
+                configId: "mode",
+                configKey: "mode",
+                source: "fallback",
+                options: [
+                    {
+                        value: "default",
+                        label: "默认",
+                        description: "使用供应商默认权限策略。",
+                        order: 0,
+                    },
+                    {
+                        value: "acceptEdits",
+                        label: "接受编辑",
+                        description: "允许编辑类操作更顺畅地继续。",
+                        order: 1,
+                    },
+                    {
+                        value: "bypassPermissions",
+                        label: "绕过权限",
+                        description: "尽量减少权限确认，适合受信任工作区。",
+                        order: 2,
+                    },
+                ],
+            },
+            thought_level: {
+                key: "thought_level",
+                currentValue: "none",
+                configId: "thought_level",
+                configKey: "thought_level",
+                source: "fallback",
+                options: [
+                    {
+                        value: "none",
+                        label: "无",
+                        description: "不额外请求思考深度。",
+                        order: 0,
+                    },
+                ],
+            },
+        },
+        metadata: {
+            availableCommands: [],
+            tokenUsage: null,
+            rawSession: null,
+        },
+    },
+    opencode: {
+        provider: "opencode",
+        sessionId: null,
+        source: "generated-default",
+        updatedAt: "2026-05-27T10:18:02.000Z",
+        ttl: ACP_CAPABILITY_CACHE_TTL_MS,
+        agentVersion: null,
+        capabilities: {
+            model: {
+                key: "model",
+                currentValue: "opencode/big-pickle",
+                configId: "model",
+                configKey: "model",
+                source: "fallback",
+                options: [
+                    {
+                        value: "opencode/big-pickle",
+                        label: "OpenCode Zen/Big Pickle",
+                        description: "OpenCode 默认模型。",
+                        order: 0,
+                    },
+                    {
+                        value: "opencode/nemotron-3-super-free",
+                        label: "OpenCode Zen/Nemotron 3 Super Free",
+                        description: "OpenCode 可用模型。",
+                        order: 1,
+                    },
+                    {
+                        value: "opencode/deepseek-v4-flash-free",
+                        label: "OpenCode Zen/DeepSeek V4 Flash Free",
+                        description: "OpenCode 可用模型。",
+                        order: 2,
+                    },
+                ],
+            },
+            mode: {
+                key: "mode",
+                currentValue: ACP_PROVIDER_DEFAULT_MODE_IDS.opencode,
+                configId: "mode",
+                configKey: "mode",
+                source: "fallback",
+                options: [
+                    {
+                        value: "build",
+                        label: "build",
+                        description: "The default agent. Executes tools based on configured permissions.",
+                        order: 0,
+                    },
+                    {
+                        value: "plan",
+                        label: "plan",
+                        description: "Plan mode. Disallows all edit tools.",
+                        order: 1,
+                    },
+                ],
+            },
+            thought_level: {
+                key: "thought_level",
+                currentValue: "none",
+                configId: "thought_level",
+                configKey: "thought_level",
+                source: "fallback",
+                options: [
+                    {
+                        value: "none",
+                        label: "无",
+                        description: "不额外请求思考深度。",
+                        order: 0,
+                    },
+                ],
+            },
+        },
+        metadata: {
+            availableCommands: [],
+            tokenUsage: null,
+            rawSession: null,
+        },
+    },
+};
+export const CODEX_DEFAULT_CAPABILITY_SNAPSHOT = ACP_DEFAULT_CAPABILITY_SNAPSHOTS.codex;
+export function getDefaultAcpCapabilitySnapshot(provider) {
+    var _a;
+    const providerKey = String(provider !== null && provider !== void 0 ? provider : "")
+        .trim()
+        .toLowerCase();
+    return (_a = ACP_DEFAULT_CAPABILITY_SNAPSHOTS[providerKey]) !== null && _a !== void 0 ? _a : null;
+}

package/dist/lib/acp2aisdk/elicitation.d.ts

@@ -0,0 +1,37 @@
+import type { JSONSchema7, UIMessage } from "ai";
+export declare const ACP_ELICITATION_OPTION_LIST_TOOL_NAME = "acp.elicitation.option_list";
+export declare const ACP_ELICITATION_OPTION_LIST_TOOL_PART_TYPE: "tool-acp.elicitation.option_list";
+export type AcpElicitationOptionListSelectionMode = "single" | "multi";
+export type AcpElicitationOptionListOption = {
+    id: string;
+    label: string;
+    description?: string;
+    disabled?: boolean;
+};
+export type AcpElicitationOptionListPayload = {
+    toolCallId: string;
+    message: string;
+    fieldName: string;
+    fieldTitle: string;
+    fieldDescription?: string;
+    selectionMode: AcpElicitationOptionListSelectionMode;
+    options: AcpElicitationOptionListOption[];
+    defaultValue?: string | string[] | null;
+    minSelections: number;
+    maxSelections?: number;
+    required: boolean;
+};
+export type AcpElicitationOptionListToolResult = {
+    action: "accept";
+    content: Record<string, string | number | boolean | string[]>;
+} | {
+    action: "decline" | "cancel";
+};
+export declare const ACP_ELICITATION_OPTION_LIST_TOOL_SCHEMA: JSONSchema7;
+export declare function createElicitationOptionListPayload(request: Record<string, unknown>, toolCallId: string): AcpElicitationOptionListPayload | null;
+export declare function normalizeElicitationOptionListToolResult(request: Record<string, unknown>, result: unknown): AcpElicitationOptionListToolResult;
+export type AcpElicitationOptionListToolOutput = {
+    toolCallId: string;
+    result: AcpElicitationOptionListToolResult;
+};
+export declare function findLatestElicitationOptionListToolOutput(messages: UIMessage[]): AcpElicitationOptionListToolOutput | null;

package/dist/lib/acp2aisdk/elicitation.mjs

@@ -0,0 +1,193 @@
+import { coerceElicitationFormContent } from "./hitl.mjs";
+export const ACP_ELICITATION_OPTION_LIST_TOOL_NAME = "acp.elicitation.option_list";
+export const ACP_ELICITATION_OPTION_LIST_TOOL_PART_TYPE = `tool-${ACP_ELICITATION_OPTION_LIST_TOOL_NAME}`;
+export const ACP_ELICITATION_OPTION_LIST_TOOL_SCHEMA = {
+    type: "object",
+    additionalProperties: false,
+    required: [
+        "toolCallId",
+        "message",
+        "fieldName",
+        "fieldTitle",
+        "selectionMode",
+        "options",
+        "minSelections",
+        "required",
+    ],
+    properties: {
+        toolCallId: { type: "string" },
+        message: { type: "string" },
+        fieldName: { type: "string" },
+        fieldTitle: { type: "string" },
+        fieldDescription: { type: "string" },
+        selectionMode: { type: "string", enum: ["single", "multi"] },
+        options: {
+            type: "array",
+            items: {
+                type: "object",
+                additionalProperties: false,
+                required: ["id", "label"],
+                properties: {
+                    id: { type: "string" },
+                    label: { type: "string" },
+                    description: { type: "string" },
+                    disabled: { type: "boolean" },
+                },
+            },
+        },
+        defaultValue: {
+            anyOf: [
+                { type: "string" },
+                { type: "array", items: { type: "string" } },
+                { type: "null" },
+            ],
+        },
+        minSelections: { type: "number" },
+        maxSelections: { type: "number" },
+        required: { type: "boolean" },
+    },
+};
+function isRecord(value) {
+    return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+function normalizeString(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+function normalizeStringArray(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.map(normalizeString).filter(Boolean);
+}
+function readPositiveInteger(value) {
+    if (typeof value !== "number" || !Number.isInteger(value) || value < 0) {
+        return undefined;
+    }
+    return value;
+}
+function normalizeEnumOptions(schema) {
+    const enumValues = normalizeStringArray(schema.enum);
+    if (enumValues.length > 0) {
+        return enumValues.map((id) => ({ id, label: id }));
+    }
+    const oneOf = Array.isArray(schema.oneOf)
+        ? schema.oneOf
+        : Array.isArray(schema.anyOf)
+            ? schema.anyOf
+            : [];
+    return oneOf.flatMap((option) => {
+        var _a, _b, _c;
+        if (!isRecord(option))
+            return [];
+        const id = normalizeString((_b = (_a = option.const) !== null && _a !== void 0 ? _a : option.value) !== null && _b !== void 0 ? _b : option.id);
+        if (!id)
+            return [];
+        return [
+            Object.assign({ id, label: normalizeString((_c = option.title) !== null && _c !== void 0 ? _c : option.label) || id }, (normalizeString(option.description)
+                ? { description: normalizeString(option.description) }
+                : {})),
+        ];
+    });
+}
+function normalizeArrayOptions(schema) {
+    const items = isRecord(schema.items) ? schema.items : {};
+    const fromItems = normalizeEnumOptions(items);
+    return fromItems.length > 0 ? fromItems : normalizeEnumOptions(schema);
+}
+function getSingleProperty(request) {
+    const rootSchema = isRecord(request.requestedSchema)
+        ? request.requestedSchema
+        : {};
+    const properties = isRecord(rootSchema.properties)
+        ? rootSchema.properties
+        : {};
+    const entries = Object.entries(properties).filter((entry) => isRecord(entry[1]));
+    if (entries.length !== 1)
+        return null;
+    const required = new Set(normalizeStringArray(rootSchema.required));
+    const [fieldName, fieldSchema] = entries[0];
+    return [fieldName, fieldSchema, required.has(fieldName)];
+}
+function normalizeDefaultValue(fieldSchema, mode, options) {
+    const optionIds = new Set(options.map((option) => option.id));
+    if (mode === "multi") {
+        const values = normalizeStringArray(fieldSchema.default).filter((value) => optionIds.has(value));
+        return values.length > 0 ? values : null;
+    }
+    const value = normalizeString(fieldSchema.default);
+    return value && optionIds.has(value) ? value : null;
+}
+export function createElicitationOptionListPayload(request, toolCallId) {
+    var _a;
+    if (request.mode !== "form")
+        return null;
+    const property = getSingleProperty(request);
+    if (!property)
+        return null;
+    const [fieldName, fieldSchema, required] = property;
+    const fieldType = fieldSchema.type;
+    const selectionMode = fieldType === "array" ? "multi" : "single";
+    if (fieldType !== "array" && fieldType !== "string")
+        return null;
+    const options = selectionMode === "multi"
+        ? normalizeArrayOptions(fieldSchema)
+        : normalizeEnumOptions(fieldSchema);
+    if (options.length === 0)
+        return null;
+    const minSelections = (_a = readPositiveInteger(fieldSchema.minItems)) !== null && _a !== void 0 ? _a : (required ? 1 : 0);
+    const maxSelections = selectionMode === "single" ? 1 : readPositiveInteger(fieldSchema.maxItems);
+    return Object.assign(Object.assign(Object.assign(Object.assign({ toolCallId, message: normalizeString(request.message) ||
+            normalizeString(fieldSchema.description) ||
+            "Choose an option", fieldName, fieldTitle: normalizeString(fieldSchema.title) || fieldName }, (normalizeString(fieldSchema.description)
+        ? { fieldDescription: normalizeString(fieldSchema.description) }
+        : {})), { selectionMode,
+        options, defaultValue: normalizeDefaultValue(fieldSchema, selectionMode, options), minSelections }), (maxSelections !== undefined ? { maxSelections } : {})), { required });
+}
+export function normalizeElicitationOptionListToolResult(request, result) {
+    if (!isRecord(result))
+        return { action: "cancel" };
+    if (result.action === "cancel" || result.action === "decline") {
+        return { action: result.action };
+    }
+    if (result.action !== "accept" || !isRecord(result.content)) {
+        return { action: "cancel" };
+    }
+    return {
+        action: "accept",
+        content: coerceElicitationFormContent(request, result.content),
+    };
+}
+export function findLatestElicitationOptionListToolOutput(messages) {
+    const message = messages.at(-1);
+    if ((message === null || message === void 0 ? void 0 : message.role) !== "assistant")
+        return null;
+    for (let partIndex = message.parts.length - 1; partIndex >= 0; partIndex--) {
+        const part = message.parts[partIndex];
+        if (!isRecord(part))
+            continue;
+        const isElicitationPart = part.type === ACP_ELICITATION_OPTION_LIST_TOOL_PART_TYPE ||
+            (part.type === "dynamic-tool" &&
+                normalizeString(part.toolName) ===
+                    ACP_ELICITATION_OPTION_LIST_TOOL_NAME);
+        if (!isElicitationPart) {
+            continue;
+        }
+        const toolCallId = normalizeString(part.toolCallId);
+        if (!toolCallId)
+            continue;
+        if (part.state === "output-available") {
+            return {
+                toolCallId,
+                result: isRecord(part.output)
+                    ? part.output
+                    : { action: "cancel" },
+            };
+        }
+        if (part.state === "output-denied") {
+            return { toolCallId, result: { action: "decline" } };
+        }
+        if (part.state === "output-error") {
+            return { toolCallId, result: { action: "cancel" } };
+        }
+    }
+    return null;
+}

package/dist/lib/acp2aisdk/hitl.d.ts

@@ -0,0 +1,25 @@
+type ElicitationFieldType = "string" | "number" | "integer" | "boolean" | "enum" | "array";
+export type NormalizedElicitationField = {
+    name: string;
+    type: ElicitationFieldType;
+    title: string;
+    description: string;
+    required: boolean;
+    options: string[];
+};
+export declare function selectPermissionOptionId(request: Record<string, unknown>, preferredOptionId?: string): string;
+export declare function createPermissionBypassResponse(request: Record<string, unknown>): {
+    outcome: {
+        outcome: string;
+        optionId: string;
+    };
+};
+export declare function createElicitationFallbackResponse(request: Record<string, unknown>): {
+    action: string;
+    _meta: {
+        reason: string;
+    };
+};
+export declare function normalizeElicitationFormSchema(request: Record<string, unknown>): NormalizedElicitationField[];
+export declare function coerceElicitationFormContent(request: Record<string, unknown>, rawContent: Record<string, unknown>): Record<string, string | number | boolean | string[]>;
+export {};