ycodium-acp-executor 0.2.2488

package/dist/protocol.d.ts

@@ -0,0 +1,8 @@
+export { createAcpConnection } from "./connection.ts";
+export type { AcpConnection, AcpConnectionOptions, AcpIncomingNotification, AcpProtocolLogEvent, } from "./connection.ts";
+export { AcpConnectionClosedError } from "./errors.ts";
+export { decodeSessionUpdate, isSessionUpdateEnvelope } from "./session-update.ts";
+export type { SessionUpdateDecode, SessionUpdateEnvelope } from "./session-update.ts";
+export { AGENT_METHODS, CLIENT_METHODS, PROTOCOL_VERSION, RequestError, methods, ndJsonStream, } from "@agentclientprotocol/sdk";
+export type { AgentRequestMethod, AgentRequestParamsByMethod, AgentRequestResponsesByMethod, CancelNotification, InitializeRequest, InitializeResponse, LoadSessionRequest, LoadSessionResponse, NewSessionRequest, NewSessionResponse, PromptRequest, PromptResponse, SessionNotification, SessionUpdate, } from "@agentclientprotocol/sdk";
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnF,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEtF,OAAO,EACL,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,OAAO,EACP,YAAY,GACb,MAAM,0BAA0B,CAAC;AAElC,YAAY,EACV,kBAAkB,EAClB,0BAA0B,EAC1B,6BAA6B,EAC7B,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,aAAa,GACd,MAAM,0BAA0B,CAAC"}

package/dist/protocol.js

@@ -0,0 +1,6 @@
+// 内部出口：线上分帧与 SDK 再导出。只从 SDK 根入口取，不许深引 SDK 私有模块。
+export { createAcpConnection } from "./connection.js";
+export { AcpConnectionClosedError } from "./errors.js";
+export { decodeSessionUpdate, isSessionUpdateEnvelope } from "./session-update.js";
+export { AGENT_METHODS, CLIENT_METHODS, PROTOCOL_VERSION, RequestError, methods, ndJsonStream, } from "@agentclientprotocol/sdk";
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAOtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAGnF,OAAO,EACL,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,OAAO,EACP,YAAY,GACb,MAAM,0BAA0B,CAAC"}

package/dist/runtime-mode.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 读出这只手自报的审批档，原样交给界面。
+ *
+ * **不翻译成宿主的四档。** 契约里 `ServerProvider.nativeModes` 就是为这件事留的位置
+ * （注释：「缺席 = 该 provider 不报原生模式，界面沿用四档 RuntimeMode 开关」），
+ * `composerNativeMode.ts` 早就会画它——只是服务端从来没人往里填，所以 composer 一直
+ * 退回那四档。把 agent 自己报的原样送上去，用户看到的就是这只手真有的那几档。
+ *
+ * 曾经想过写一张「`default`→逐条确认、`yolo`→全放开」的别名表：那是硬编码，且各家档位
+ * 的语义本来就对不齐（grok 的 `acceptEdits` 实测等同 `default`，照样问）。翻译一次就
+ * 多一处会漂的事实，不如不翻。
+ *
+ * 档位 id 原样发回去，所以也不存在「发了个它没报过的 id 被拒」（kimi 实测 `-32602`）。
+ *
+ * @module runtime-mode
+ */
+/** 宿主的四档。与 `@ycodium-ai/plugin-api` 的 `ExecutorRuntimeMode` 同形，这个包不依赖它。 */
+export type AcpRuntimeMode = "approval-required" | "auto-accept-edits" | "auto" | "full-access";
+/** agent 自报的一档。字段与宿主 `ServerProviderNativeMode` 同形，界面原样画。 */
+export type AcpAvailableMode = {
+    readonly id: string;
+    /** 给人看的名字。agent 没给就退回 id——界面上空着一行比显示 id 更糟。 */
+    readonly name: string;
+    /** agent 给这一档写的说明（claude-agent-acp 每档都有，如「Always ask before making changes」）。 */
+    readonly description?: string;
+    /** `_meta.kind`（`standard` / `plan` / `auto_review` / `full_access`）。原样带上，不据此翻译。 */
+    readonly kind?: string;
+};
+/**
+ * 从 `session/new` 回包里把 agent 自报的档位清单读出来。
+ *
+ * 两处都认：`modes.availableModes`（ACP 的会话模式那一位）与 `configOptions` 里
+ * `category: "mode"` 的那一项——`claude-agent-acp` 两处都报，kimi 报前者。
+ */
+export declare function acpAvailableModes(setup: unknown): readonly AcpAvailableMode[];
+/** `configOptions` 里那一项的 id；走 `session/set_config_option` 时要用它。缺席就该走 `session/set_mode`。 */
+export declare function acpModeConfigId(setup: unknown): string | undefined;
+/**
+ * agent 报的「当前在哪一档」。
+ *
+ * **必须跟档位清单一起报**：座位那段（契约的 `resolveProviderNativeMode`）
+ * 在清单里找不到当前档时**整个返回 null**——只报清单不报当前档，新会话上那一格一个字
+ * 都画不出来，看着跟「这只手没有档位」一模一样。
+ *
+ * 两处都认，与 {@link acpAvailableModes} 同一口径：`modes.currentModeId` 与
+ * `configOptions` 里 `category: "mode"` 那一项的 `currentValue`。
+ */
+export declare function acpCurrentModeId(setup: unknown): string | undefined;
+//# sourceMappingURL=runtime-mode.d.ts.map

package/dist/runtime-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-mode.d.ts","sourceRoot":"","sources":["../src/runtime-mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,2EAA2E;AAC3E,MAAM,MAAM,cAAc,GAAG,mBAAmB,GAAG,mBAAmB,GAAG,MAAM,GAAG,aAAa,CAAC;AAEhG,6DAA6D;AAC7D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iFAAiF;IACjF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,oFAAoF;IACpF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAUF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,gBAAgB,EAAE,CAoC7E;AAED,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAWlE;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAiBnE"}

package/dist/runtime-mode.js

@@ -0,0 +1,123 @@
+/**
+ * 读出这只手自报的审批档，原样交给界面。
+ *
+ * **不翻译成宿主的四档。** 契约里 `ServerProvider.nativeModes` 就是为这件事留的位置
+ * （注释：「缺席 = 该 provider 不报原生模式，界面沿用四档 RuntimeMode 开关」），
+ * `composerNativeMode.ts` 早就会画它——只是服务端从来没人往里填，所以 composer 一直
+ * 退回那四档。把 agent 自己报的原样送上去，用户看到的就是这只手真有的那几档。
+ *
+ * 曾经想过写一张「`default`→逐条确认、`yolo`→全放开」的别名表：那是硬编码，且各家档位
+ * 的语义本来就对不齐（grok 的 `acceptEdits` 实测等同 `default`，照样问）。翻译一次就
+ * 多一处会漂的事实，不如不翻。
+ *
+ * 档位 id 原样发回去，所以也不存在「发了个它没报过的 id 被拒」（kimi 实测 `-32602`）。
+ *
+ * @module runtime-mode
+ */
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function asString(value) {
+    return typeof value === "string" ? value : undefined;
+}
+/**
+ * 从 `session/new` 回包里把 agent 自报的档位清单读出来。
+ *
+ * 两处都认：`modes.availableModes`（ACP 的会话模式那一位）与 `configOptions` 里
+ * `category: "mode"` 的那一项——`claude-agent-acp` 两处都报，kimi 报前者。
+ */
+export function acpAvailableModes(setup) {
+    if (!isRecord(setup))
+        return [];
+    const out = [];
+    const seen = new Set();
+    const push = (entry) => {
+        if (!isRecord(entry))
+            return;
+        const id = (asString(entry["id"]) ?? asString(entry["value"]))?.trim();
+        if (!id || seen.has(id))
+            return;
+        seen.add(id);
+        const meta = entry["_meta"];
+        const kind = isRecord(meta) ? asString(meta["kind"])?.trim().toLowerCase() : undefined;
+        const name = asString(entry["name"])?.trim();
+        const description = asString(entry["description"])?.trim();
+        out.push({
+            id,
+            name: name || id,
+            ...(description ? { description } : {}),
+            ...(kind ? { kind } : {}),
+        });
+    };
+    const modes = setup["modes"];
+    if (isRecord(modes) && Array.isArray(modes["availableModes"])) {
+        for (const entry of modes["availableModes"])
+            push(entry);
+    }
+    const configOptions = setup["configOptions"];
+    if (Array.isArray(configOptions)) {
+        for (const option of configOptions) {
+            if (!isRecord(option))
+                continue;
+            if (asString(option["category"])?.trim().toLowerCase() !== "mode")
+                continue;
+            if (!Array.isArray(option["options"]))
+                continue;
+            for (const entry of option["options"])
+                push(entry);
+        }
+    }
+    return out;
+}
+/** `configOptions` 里那一项的 id；走 `session/set_config_option` 时要用它。缺席就该走 `session/set_mode`。 */
+export function acpModeConfigId(setup) {
+    if (!isRecord(setup))
+        return undefined;
+    const configOptions = setup["configOptions"];
+    if (!Array.isArray(configOptions))
+        return undefined;
+    for (const option of configOptions) {
+        if (!isRecord(option))
+            continue;
+        if (asString(option["category"])?.trim().toLowerCase() !== "mode")
+            continue;
+        const id = asString(option["id"])?.trim();
+        if (id)
+            return id;
+    }
+    return undefined;
+}
+/**
+ * agent 报的「当前在哪一档」。
+ *
+ * **必须跟档位清单一起报**：座位那段（契约的 `resolveProviderNativeMode`）
+ * 在清单里找不到当前档时**整个返回 null**——只报清单不报当前档，新会话上那一格一个字
+ * 都画不出来，看着跟「这只手没有档位」一模一样。
+ *
+ * 两处都认，与 {@link acpAvailableModes} 同一口径：`modes.currentModeId` 与
+ * `configOptions` 里 `category: "mode"` 那一项的 `currentValue`。
+ */
+export function acpCurrentModeId(setup) {
+    if (!isRecord(setup))
+        return undefined;
+    const modes = setup["modes"];
+    if (isRecord(modes)) {
+        const current = asString(modes["currentModeId"])?.trim();
+        if (current)
+            return current;
+    }
+    const configOptions = setup["configOptions"];
+    if (Array.isArray(configOptions)) {
+        for (const option of configOptions) {
+            if (!isRecord(option))
+                continue;
+            if (asString(option["category"])?.trim().toLowerCase() !== "mode")
+                continue;
+            const current = asString(option["currentValue"])?.trim();
+            if (current)
+                return current;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=runtime-mode.js.map

package/dist/runtime-mode.js.map

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

package/dist/runtime-model.d.ts

@@ -0,0 +1,157 @@
+/**
+ * 从 `AcpRuntimeModel.ts` 搬来的解析函数。`waitForSessionLoadReplayIdle` 绑 Effect，这一刀不搬。
+ */
+import type { SessionNotification } from "./protocol.ts";
+export interface AcpSessionMode {
+    readonly id: string;
+    readonly name: string;
+    readonly description?: string;
+}
+export interface AcpSessionModeState {
+    readonly currentModeId: string;
+    readonly availableModes: ReadonlyArray<AcpSessionMode>;
+}
+export interface AcpAvailableCommand {
+    readonly name: string;
+    readonly description?: string;
+    readonly inputHint?: string;
+}
+export interface AcpToolCallState {
+    readonly toolCallId: string;
+    readonly kind?: string;
+    readonly title?: string;
+    readonly status?: "pending" | "inProgress" | "completed" | "failed";
+    readonly command?: string;
+    readonly detail?: string;
+    readonly data: Record<string, unknown>;
+}
+export interface AcpPlanUpdate {
+    readonly explanation?: string | null;
+    readonly plan: ReadonlyArray<{
+        readonly step: string;
+        readonly status: "pending" | "inProgress" | "completed";
+    }>;
+}
+export interface AcpPermissionRequest {
+    readonly kind: string | "unknown";
+    readonly detail?: string;
+    readonly toolCall?: AcpToolCallState;
+}
+export type AcpParsedSessionEvent = {
+    readonly _tag: "ModeChanged";
+    readonly modeId: string;
+} | {
+    readonly _tag: "AssistantItemStarted";
+    readonly itemId: string;
+} | {
+    readonly _tag: "AssistantItemCompleted";
+    readonly itemId: string;
+} | {
+    readonly _tag: "PlanUpdated";
+    readonly payload: AcpPlanUpdate;
+    readonly rawPayload: unknown;
+} | {
+    readonly _tag: "ToolCallUpdated";
+    readonly toolCall: AcpToolCallState;
+    readonly rawPayload: unknown;
+} | {
+    readonly _tag: "ContentDelta";
+    readonly itemId?: string;
+    readonly text: string;
+    /** 缺省当正式回答。思考块必须标 `reasoning_text`，否则会混进 assistant 段。 */
+    readonly streamKind: "assistant_text" | "reasoning_text";
+    readonly rawPayload: unknown;
+} | {
+    readonly _tag: "AssistantContentBlock";
+    readonly content: Record<string, unknown>;
+    readonly rawPayload: unknown;
+};
+export type AcpSessionSetupResponse = {
+    readonly sessionId?: string;
+    readonly modes?: {
+        readonly currentModeId: string;
+        readonly availableModes: ReadonlyArray<{
+            readonly id: string;
+            readonly name: string;
+            readonly description?: string | null;
+        }>;
+    } | null;
+    readonly configOptions?: ReadonlyArray<AcpSessionConfigOption> | null;
+    readonly models?: unknown;
+};
+export type AcpSessionConfigOption = {
+    readonly id: string;
+    readonly category?: string | null;
+    readonly type?: string;
+    readonly currentValue?: unknown;
+    readonly options?: ReadonlyArray<{
+        readonly value: string;
+    } | {
+        readonly options: ReadonlyArray<{
+            readonly value: string;
+        }>;
+    }>;
+};
+export declare function extractModelConfigId(sessionResponse: AcpSessionSetupResponse): string | undefined;
+export declare function findSessionConfigOption(configOptions: ReadonlyArray<AcpSessionConfigOption> | null | undefined, configId: string): AcpSessionConfigOption | undefined;
+export declare function collectSessionConfigOptionValues(configOption: AcpSessionConfigOption): ReadonlyArray<string>;
+/** `models`（UNSTABLE）里报的型号 id，即 `session/set_model` 肯收的那些值。 */
+export declare function collectSessionModelIds(models: unknown): ReadonlyArray<string>;
+/**
+ * 请求的型号在手报的目录里对应哪一个取值；对不上返回 undefined，调用方据此不设型号。
+ *
+ * 规则的正本是 `@ycodium-ai/plugin-api/executor` 的 `matchCatalogModel`，理由写在那里：
+ * 先精确匹配，再按最后一段唯一匹配，两个取值最后一段相同就不猜。纯库不许依赖宿主包
+ * （ADR-0030 §3.2，`index.test.ts` 钉着），所以 ACP 这边带一份；两份在
+ * `plugins/agent-acp/src/catalogModelParity.test.ts` 按同一张表对拍，只改一边会红。
+ */
+export declare function matchAdvertisedModelValue(requestedModelId: string, advertisedValues: ReadonlyArray<string>): string | undefined;
+export declare function parseSessionModeState(sessionResponse: AcpSessionSetupResponse): AcpSessionModeState | undefined;
+export declare function parseAvailableCommandsUpdate(params: SessionNotification | {
+    readonly update: Record<string, unknown>;
+}): ReadonlyArray<AcpAvailableCommand> | undefined;
+export declare function mergeToolCallState(previous: AcpToolCallState | undefined, next: AcpToolCallState): AcpToolCallState;
+export interface AcpToolCallEmitDecisionInput {
+    readonly previous: AcpToolCallState | undefined;
+    readonly next: AcpToolCallState;
+    readonly lastEmittedDetailLength: number | undefined;
+    readonly skippedSinceEmit: number;
+}
+export interface AcpToolCallEmitDecision {
+    readonly emit: boolean;
+    readonly skippedSinceEmit: number;
+}
+export declare function decideToolCallUpdateEmission(input: AcpToolCallEmitDecisionInput): AcpToolCallEmitDecision;
+export declare function parsePermissionRequest(params: {
+    readonly sessionId?: string;
+    readonly toolCall: {
+        readonly toolCallId: string;
+        readonly title?: string | null;
+        readonly kind?: string | null;
+        readonly status?: string | null;
+        readonly rawInput?: unknown;
+        readonly rawOutput?: unknown;
+        readonly content?: unknown;
+        readonly locations?: unknown;
+    };
+}): AcpPermissionRequest;
+export declare function sessionUpdateIsReplay(params: {
+    readonly _meta?: unknown;
+}): boolean;
+export declare function syntheticLoadSessionResponseFromInitialize(initializeResult: {
+    readonly _meta?: unknown;
+}): AcpSessionSetupResponse;
+export declare function parseSessionUpdateEvent(params: SessionNotification): {
+    readonly modeId?: string;
+    readonly events: ReadonlyArray<AcpParsedSessionEvent>;
+};
+export declare function updateModeState(modeState: AcpSessionModeState, nextModeId: string): AcpSessionModeState;
+export declare function filterMcpServersByAgentCapabilities<T extends {
+    readonly type?: string;
+}>(mcpServers: ReadonlyArray<T>, agentCapabilities: {
+    readonly mcpCapabilities?: {
+        readonly http?: boolean;
+        readonly sse?: boolean;
+    };
+} | null | undefined): ReadonlyArray<T>;
+//# sourceMappingURL=runtime-model.d.ts.map

package/dist/runtime-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-model.d.ts","sourceRoot":"","sources":["../src/runtime-model.ts"],"names":[],"mappings":"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"}