@ycodium-ai/plugin-api 0.2.2998 → 0.2.3002

package/dist/executorEvents.d.ts

@@ -0,0 +1,170 @@
+/**
+ * 执行器事件词汇，以及 task.* 与 tool.progress 的载荷。其余 payload 仍是 unknown。
+ * 公开名字从 executor.ts 再导出。
+ *
+ * @module @ycodium-ai/plugin-api/executorEvents
+ */
+/** `type` 闭集与 contracts 的 `ProviderRuntimeEventType` 相同（含 `tool.denied`），不另造事件词汇。 */
+export type ExecutorEventType = "session.started" | "session.configured" | "session.state.changed" | "session.exited" | "thread.started" | "thread.state.changed" | "thread.metadata.updated" | "thread.token-usage.updated" | "thread.realtime.started" | "thread.realtime.item-added" | "thread.realtime.audio.delta" | "thread.realtime.error" | "thread.realtime.closed" | "turn.started" | "turn.completed" | "turn.aborted" | "turn.plan.updated" | "turn.proposed.delta" | "turn.proposed.completed" | "turn.diff.updated" | "item.started" | "item.updated" | "item.completed" | "content.delta" | "request.opened" | "request.resolved" | "user-input.requested" | "user-input.resolved" | "task.started" | "task.progress" | "task.updated" | "task.completed" | "hook.started" | "hook.progress" | "hook.completed" | "tool.progress" | "tool.summary" | "tool.denied" | "auth.status" | "account.updated" | "account.rate-limits.updated" | "mcp.status.updated" | "mcp.oauth.completed" | "model.rerouted" | "config.warning" | "deprecation.notice" | "files.persisted" | "assistant.attachment.produced" | "assistant.artifact.produced" | "runtime.warning" | "runtime.error";
+export type ExecutorEventProviderRefs = {
+    readonly providerTurnId?: string;
+    readonly providerItemId?: string;
+    readonly providerRequestId?: string;
+};
+export type ExecutorEventRaw = {
+    readonly source: string;
+    readonly method?: string;
+    readonly messageType?: string;
+    readonly payload: unknown;
+};
+export type ExecutorEventBase = {
+    /** 跨服务器重启、跨线程都不能重复：宿主拿它当活动 id 全局落库，重复会覆盖已有的旧活动。 */
+    readonly eventId: string;
+    readonly provider: string;
+    readonly providerInstanceId?: string;
+    readonly threadId: string;
+    readonly createdAt: string;
+    readonly turnId?: string;
+    readonly itemId?: string;
+    /**
+     * 同一线程里跨会话重启也不能重复：宿主按它记「已接受」并在重启后恢复，撞号的新请求会被
+     * 当成答过的旧请求拒掉。协议自带的序号（如每个进程从 0 数起的 JSON-RPC id）要先加会话级前缀。
+     */
+    readonly requestId?: string;
+    readonly providerRefs?: ExecutorEventProviderRefs;
+    readonly raw?: ExecutorEventRaw;
+    readonly originBindingGeneration?: number;
+    readonly originResumeCursor?: unknown;
+};
+/** 结构声明：公共基座 + `type` 判别 + payload。payload 形状以 contracts schema 为准。 */
+export type ExecutorEvent = ExecutorEventBase & {
+    readonly type: ExecutorEventType;
+    readonly payload: unknown;
+};
+/** 与 contracts `RuntimeTaskStatus` 同一闭集。 */
+export type ExecutorTaskStatus = "pending" | "running" | "waiting" | "idle" | "completed" | "failed" | "cancelled" | "interrupted";
+/**
+ * 派生的 agent 是哪一种。只回答「是哪一种 agent」：是不是 agent（还是 shell、监视器
+ * 这类后台任务）由宿主按 `taskType` 判，后台任务不用报这一栏。当前宿主只持久化
+ * 此字段；读取端迁移后才按它区分种类。
+ */
+export type ExecutorTaskRosterKind = "subagent" | "workflow" | "workflow_member";
+/** 与 contracts `RuntimeTaskUsage` 同形。 */
+export type ExecutorTaskUsage = {
+    readonly totalTokens: number;
+    readonly inputTokens?: number | undefined;
+    readonly cachedInputTokens?: number | undefined;
+    readonly outputTokens?: number | undefined;
+    readonly reasoningOutputTokens?: number | undefined;
+    readonly toolUses?: number | undefined;
+    readonly durationMs?: number | undefined;
+};
+/**
+ * 每条 `task.*` 都可带的身份字段，与 contracts 的 `taskAgentLinkageFields` 同名同形。
+ * 每条都重复带上：宿主与客户端不保证还留着 started 那一条。contracts 里多出的
+ * `agentKind` 是宿主按 `taskType` 盖的章，手不报。
+ *
+ * 手对宿主的身份约定（当前宿主与客户端仍按裸 taskId 合并；按「手 + taskId」
+ * 认人须与读取端迁移一起启用）：
+ * - 同一线程内，同一个 agent 的 `taskId` 终生不变；
+ * - 恢复后的会话里仍是同一个 agent，就报同一个 id；
+ * - 重开一轮要明说 `running` / `pending` / `waiting`，不带状态的 progress 不算重开；
+ * - 一轮结束按结果报 `idle`（还能续）或终态。
+ */
+export type ExecutorTaskAgentLinkage = {
+    readonly taskType?: string | undefined;
+    /** 这个任务是在哪个子代理里起的（例如子代理自己的后台 shell）。 */
+    readonly agentId?: string | undefined;
+    readonly title?: string | undefined;
+    readonly role?: string | undefined;
+    readonly model?: string | undefined;
+    readonly effort?: string | undefined;
+    readonly toolUseId?: string | undefined;
+    /** workflow 成员所属协调者的 taskId；与成员同一只手报。 */
+    readonly parentAgentId?: string | undefined;
+    readonly workflowName?: string | undefined;
+    readonly agentIndex?: number | undefined;
+    readonly phaseIndex?: number | undefined;
+    readonly phaseTitle?: string | undefined;
+    readonly phases?: ReadonlyArray<{
+        readonly index: number;
+        readonly title: string;
+    }> | undefined;
+    readonly attempt?: number | undefined;
+    readonly runHandles?: {
+        readonly runId?: string | undefined;
+        readonly scriptPath?: string | undefined;
+        readonly transcriptDir?: string | undefined;
+        /** 只放 http/https 地址。 */
+        readonly sessionUrl?: string | undefined;
+    } | undefined;
+    readonly outputFile?: string | undefined;
+    readonly agentPath?: string | undefined;
+    /** 这条只进 agent 面板，不进父会话的时间线。 */
+    readonly timelineBypass?: boolean | undefined;
+    readonly rosterKind?: ExecutorTaskRosterKind | undefined;
+};
+export type ExecutorTaskStartedPayload = ExecutorTaskAgentLinkage & {
+    readonly taskId: string;
+    readonly description?: string | undefined;
+};
+export type ExecutorTaskProgressPayload = ExecutorTaskAgentLinkage & {
+    readonly taskId: string;
+    readonly description: string;
+    readonly summary?: string | undefined;
+    readonly usage?: unknown;
+    readonly typedUsage?: ExecutorTaskUsage | undefined;
+    readonly lastToolName?: string | undefined;
+    readonly status?: ExecutorTaskStatus | undefined;
+    readonly error?: string | undefined;
+};
+export type ExecutorTaskUpdatedPayload = ExecutorTaskAgentLinkage & {
+    readonly taskId: string;
+    readonly status?: ExecutorTaskStatus | undefined;
+    readonly description?: string | undefined;
+    readonly error?: string | undefined;
+    readonly endedAt?: string | undefined;
+    readonly isBackgrounded?: boolean | undefined;
+};
+export type ExecutorTaskCompletedPayload = ExecutorTaskAgentLinkage & {
+    readonly taskId: string;
+    readonly status: "completed" | "failed" | "stopped";
+    readonly summary?: string | undefined;
+    readonly usage?: unknown;
+    readonly typedUsage?: ExecutorTaskUsage | undefined;
+};
+export type ExecutorToolProgressPayload = {
+    readonly toolUseId?: string | undefined;
+    readonly toolName?: string | undefined;
+    readonly summary?: string | undefined;
+    readonly elapsedSeconds?: number | undefined;
+    /** 工具所属 agent 的 taskId；读取端迁移后与 provider 一起关联。 */
+    readonly taskId?: string | undefined;
+    readonly parentToolUseId?: string | undefined;
+};
+type ExecutorTypedPayloads = {
+    readonly "task.started": ExecutorTaskStartedPayload;
+    readonly "task.progress": ExecutorTaskProgressPayload;
+    readonly "task.updated": ExecutorTaskUpdatedPayload;
+    readonly "task.completed": ExecutorTaskCompletedPayload;
+    readonly "tool.progress": ExecutorToolProgressPayload;
+};
+/** `type` 对应的 payload。`task.*` 与 `tool.progress` 带类型；其余仍是 unknown，形状以 contracts 为准。 */
+export type ExecutorEventPayload<T extends ExecutorEventType> = T extends keyof ExecutorTypedPayloads ? ExecutorTypedPayloads[T] : unknown;
+/**
+ * 某一种事件。发事件的入口用它（或 {@link ExecutorTypedEvent}），写错 `task.*` 的字段
+ * 当场编不过。`type` 要是字面量：传一个宽的 `ExecutorEventType` 变量，payload 就退回 unknown。
+ */
+export type ExecutorEventOf<T extends ExecutorEventType> = ExecutorEventBase & {
+    readonly type: T;
+    readonly payload: ExecutorEventPayload<T>;
+};
+/**
+ * 按 `type` 判别的联合，每个成员都能赋给 {@link ExecutorEvent}。`ExecutorEvent` 本身保持
+ * 宽松，`type` 写成变量的发射点照旧能用。
+ */
+export type ExecutorTypedEvent = {
+    readonly [T in ExecutorEventType]: ExecutorEventOf<T>;
+}[ExecutorEventType];
+export {};
+//# sourceMappingURL=executorEvents.d.ts.map

package/dist/executorEvents.d.ts.map

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

package/dist/executorEvents.js

@@ -0,0 +1,8 @@
+/**
+ * 执行器事件词汇，以及 task.* 与 tool.progress 的载荷。其余 payload 仍是 unknown。
+ * 公开名字从 executor.ts 再导出。
+ *
+ * @module @ycodium-ai/plugin-api/executorEvents
+ */
+export {};
+//# sourceMappingURL=executorEvents.js.map

package/dist/executorEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executorEvents.js","sourceRoot":"","sources":["../src/executorEvents.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/executorSession.d.ts

@@ -0,0 +1,301 @@
+/**
+ * 执行器的会话、探测与清单类型：开会话、发一轮、报型号和技能、导入原生会话。
+ * 公开名字从 executor.ts 再导出。
+ *
+ * @module @ycodium-ai/plugin-api/executorSession
+ */
+import type { ExecutorRuntimeMode, ExecutorSessionSkills } from "./executorCapabilities.ts";
+/**
+ * 宿主这一轮要挂给 CLI 的 MCP server。谁该挂由宿主决定（内置编排那台加插件中心里
+ * 对这双手开着的条目），怎么告诉自己的 CLI 由手决定——各家格式差太远，宿主翻不了。
+ */
+export type ExecutorMcpServer = {
+    readonly name: string;
+    readonly transport: {
+        readonly type: "stdio";
+        readonly command: string;
+        readonly args?: ReadonlyArray<string> | undefined;
+        readonly env?: Readonly<Record<string, string>> | undefined;
+    } | {
+        readonly type: "http" | "sse";
+        readonly url: string;
+        readonly headers?: Readonly<Record<string, string>> | undefined;
+    };
+};
+export type ExecutorSessionStartInput = {
+    readonly threadId: string;
+    readonly cwd?: string;
+    readonly title?: string;
+    /** 同 {@link ExecutorSendTurnInput.modelSelection}。 */
+    readonly modelSelection?: unknown;
+    readonly bindingGeneration?: number;
+    readonly resumeCursor?: unknown;
+    readonly discardResumeCursor?: boolean;
+    readonly approvalPolicy?: unknown;
+    readonly sandboxMode?: unknown;
+    readonly runtimeMode: ExecutorRuntimeMode;
+    /**
+     * 这一轮按这只手的哪一档跑，宿主已经解好（输入区座位画的就是它）。报了
+     * `nativeModes` 的手总会收到它，照发给 CLI；缺席只发生在手没报档（或首探还没回来）时，
+     * 那时座位画的是四档，手按 `runtimeMode` 跑。
+     */
+    readonly nativeModeId?: string;
+    /**
+     * 这次会话要挂的 MCP server，内置编排那一条排第一（宿主 `resolveMcpLaunchList` 的
+     * 输出原样搬过来）。缺席或空数组就是不挂——手据此决定要不要传自己 SDK 的那一栏。
+     */
+    readonly mcpServers?: ReadonlyArray<ExecutorMcpServer>;
+    /**
+     * 宿主已决定允许读取的目录（绝对路径，只读）。目前是用户附件所在的目录：
+     * 附件落在 cwd 之外，不放行的话 CLI 每读一次都要弹授权。
+     *
+     * 只表达"可读"，不含写：手必须把它翻成自家 CLI 的语汇，并保证这些目录里的写入
+     * 在非 bypass 档仍然被拦或要批准。缺席或空数组就是不额外放行。读本来就不受限的
+     * 手可以忽略这一栏。
+     */
+    readonly readOnlyDirectories?: ReadonlyArray<string>;
+    /** 宿主已按 preset 与 driver 过滤、物化好的 Ycodium 技能，见 {@link ExecutorSessionSkills}。 */
+    readonly skills?: ExecutorSessionSkills;
+};
+/** 一轮交给 CLI 的文字最多这么多字符，含手自己再展开的部分；与宿主给 `input` 的上限同一个数。 */
+export declare const EXECUTOR_SEND_TURN_MAX_INPUT_CHARS = 120000;
+export type ExecutorSendTurnInput = {
+    readonly threadId: string;
+    readonly expectedTurnId?: string;
+    readonly input?: string;
+    /** 宿主放在 `input` 前面的材料；只发给声明 `handlesSkillInvocations` 的手，其余的 `input` 已含这段。 */
+    readonly inputPreamble?: string;
+    readonly attachments?: ReadonlyArray<unknown>;
+    /** 输入区选的型号与档位。型号递给 CLI 之前过 {@link matchCatalogModel}，对不上就不设型号、不报错。 */
+    readonly modelSelection?: unknown;
+    readonly interactionMode?: unknown;
+};
+export type ExecutorTurnStartResult = {
+    readonly threadId: string;
+    readonly turnId: string;
+    readonly resumeCursor?: unknown;
+};
+export type ExecutorSession = {
+    readonly provider: string;
+    readonly providerInstanceId?: string;
+    readonly status: string;
+    readonly runtimeMode: ExecutorRuntimeMode;
+    readonly nativeModeId?: string;
+    readonly cwd?: string;
+    readonly model?: string;
+    readonly threadId: string;
+    readonly resumeCursor?: unknown;
+    readonly bindingGeneration?: number;
+    readonly activeTurnId?: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly lastError?: string;
+};
+export type ExecutorThreadSnapshot = {
+    readonly threadId: string;
+    readonly turns: ReadonlyArray<{
+        readonly id: string;
+        readonly items: ReadonlyArray<unknown>;
+    }>;
+};
+export type ExecutorProbeResult = {
+    readonly installed: boolean;
+    readonly version: string | null;
+    /**
+     * 探测结论。`not-installed` 只在**程序起不来**时报：找不到程序（没配路径、不在 PATH 上）、
+     * 配置的路径不存在或不可执行。起得来之后的失败（握手超时、版本太旧、没登录之外的说不清的错）
+     * 仍是 `error`——宿主据 `not-installed` 给「未安装」徽标与安装命令，误报会让用户去重装一个
+     * 其实装着的程序。报 `not-installed` 时 `installed` 同为 false。
+     *
+     * 起进程失败的归类见 {@link describeExecutorSpawnFailure}。
+     */
+    readonly readiness: "ready" | "unchecked" | "checking" | "not-installed" | "error";
+    readonly auth: {
+        readonly status: "authenticated" | "unauthenticated" | "unknown";
+        readonly type?: string;
+        readonly label?: string;
+        readonly email?: string;
+    };
+    readonly detail?: string;
+    /**
+     * 这个账户目录能跑哪些模型，以及每个模型接受哪些档位。
+     *
+     * 这是 CLI 自己账户的目录：型号、思考档位、服务档都写在用户那份账户里，只有这只 CLI
+     * 够得着，宿主没有别的路问得到，所以由手报。
+     *
+     * 只有真问过 CLI 的探测才填，填不出就**缺席**；空数组是「问过了，一个都没有」，
+     * 两者对调用方不是一回事。
+     */
+    readonly models?: ReadonlyArray<ExecutorProbeModel>;
+    /**
+     * 这只手自报的审批档。缺席 = 不报，界面沿用宿主四档开关（`ServerProvider.nativeModes`
+     * 的注释就是这个口径）。**空数组与缺席不是一回事**：空数组等于说「这只手一档都没有」。
+     */
+    readonly nativeModes?: ReadonlyArray<ExecutorProbeNativeMode>;
+    /**
+     * 这只手当前在哪一档。**报了 {@link nativeModes} 就必须报它**：界面在清单里找不到
+     * 当前档时整个不画那一格，只报清单等于没报。没选过档、又不报
+     * {@link nativeModeByRuntimeMode} 的线程就按这一档跑。
+     */
+    readonly currentNativeModeId?: string;
+    /**
+     * 没选过档的线程，宿主四档各自落在这只手的哪一档（值是 {@link nativeModes} 里的 id）。
+     *
+     * 「这一轮按哪一档跑」只由宿主解一次（`resolveProviderNativeMode`）：座位画它，
+     * 开会话时把解出的 id 放进 `nativeModeId` 交给手。手收到 `nativeModeId` 就照发，
+     * 不再拿 `runtimeMode` 另推一遍——两处各推一次，座位就会画一档、CLI 跑另一档。
+     *
+     * 缺席 = 四档不影响这只手，没选过档就按 {@link currentNativeModeId} 跑。
+     */
+    readonly nativeModeByRuntimeMode?: {
+        readonly [Mode in ExecutorRuntimeMode]: string;
+    };
+    /**
+     * 这只手能用的技能：输入区的 `$` 菜单和回复里的技能标记都读它。
+     *
+     * **缺席即不支持**：这只手说不出自己有哪些技能。空数组是「问过了，一个都没有」。
+     */
+    readonly skills?: ReadonlyArray<ExecutorProbeSkill>;
+};
+/**
+ * 探测报上来的一个技能。字段与宿主 `ServerProviderSkill` 逐字对齐，宿主原样落进快照。
+ *
+ * `path` 必填：界面按技能文件所在的位置分来源（插件带的、个人的、项目的），同名技能也靠它
+ * 区分。报不出位置的技能就不报。
+ */
+export type ExecutorProbeSkill = {
+    readonly name: string;
+    readonly description?: string;
+    readonly path: string;
+    readonly scope?: string;
+    readonly enabled: boolean;
+    readonly displayName?: string;
+    readonly shortDescription?: string;
+    /** 技能对 agent 自己的技能工具隐藏，只有用户能起（Claude 的 `disable-model-invocation`）。 */
+    readonly userInvocationOnly?: boolean;
+    /** 上一条的镜像：`false` = 只有 agent 能起，用户从输入区选了也不会执行（Claude 的 `user-invocable: false`）。 */
+    readonly userInvocable?: boolean;
+};
+/**
+ * 一条斜杠命令。字段与宿主 `ServerProviderSlashCommand` 逐字对齐，宿主原样落进列表：
+ * `name` 不带前导斜杠，`input.hint` 是参数提示（如 `<file>`）。
+ */
+export type ExecutorSlashCommand = {
+    readonly name: string;
+    readonly description?: string;
+    readonly input?: {
+        readonly hint: string;
+    };
+};
+/**
+ * 某个项目目录下这只手能用的斜杠命令与技能（{@link ExecutorInstance.workspaceInventory}）。
+ *
+ * 要答的是「在这个目录里开会话，用户输入 `/` 能看到什么」：用户级与项目级的都算，不是只有项目级的
+ * 增量。宿主拿它**整份替换**探测快照里整机的那份，所以两个字段缺席才表示「这一类我答不了，沿用
+ * 探测的」；给了空数组是「问过了，一个都没有」。
+ */
+export type ExecutorWorkspaceInventory = {
+    readonly slashCommands?: ReadonlyArray<ExecutorSlashCommand>;
+    readonly skills?: ReadonlyArray<ExecutorProbeSkill>;
+    /**
+     * 这份答案依赖的文件与目录（绝对路径，含「现在不存在、出现了就会改变答案」的目录）。宿主缓存这份
+     * 答案，再次被问时按它们的修改时间判断要不要重查，不必每次打 `/` 都重新读盘或起 CLI。
+     * 缺席就只按宿主的存活期缓存。
+     */
+    readonly watchPaths?: ReadonlyArray<string>;
+};
+/**
+ * agent 启动后自己报上来的命令与技能（{@link ExecutorHost.reportSessionInventory}），按会话记。
+ * 每个字段给了就**整份替换**这个会话上一次报的那份，缺席的字段保持不变。
+ */
+export type ExecutorSessionInventoryReport = {
+    readonly threadId: string;
+    readonly slashCommands?: ReadonlyArray<ExecutorSlashCommand>;
+    readonly skills?: ReadonlyArray<ExecutorProbeSkill>;
+};
+/**
+ * 探测报上来的一档「原生模式」——这只手自己的审批档，不是宿主那四档。
+ *
+ * 字段与宿主 `ServerProviderNativeMode` 同形：宿主原样落进 provider 快照的 `nativeModes`，
+ * composer 直接画。**不要在任何一段把它翻译成 `ExecutorRuntimeMode` 的四档**：各家语义
+ * 本来就对不齐（grok 的 `acceptEdits` 实测等同 `default`，照样问），翻一次就多一处会漂的
+ * 事实。反方向（四档落到哪一档）只由手在 `nativeModeByRuntimeMode` 里声明一次。
+ * 缺席 = 这只手不报原生档，界面沿用四档开关。
+ */
+export type ExecutorProbeNativeMode = {
+    readonly id: string;
+    readonly name: string;
+    readonly description?: string;
+};
+/**
+ * 探测报上来的一个模型。
+ *
+ * 字段名与宿主快照的 `ServerProviderModel` 逐字对齐（`packages/contracts/src/server.ts`），
+ * 不另起同义名字：宿主拿到之后原样落进快照，中间没有翻译层，改名就是两边各自漂移。
+ */
+export type ExecutorProbeModel = {
+    readonly slug: string;
+    readonly name?: string;
+    readonly isDefault?: boolean;
+    /** CLI 自己就把它藏起来了（codex 的 `hidden`）。宿主照样收，由客户端决定显不显。 */
+    readonly hidden?: boolean;
+    /** 这个模型接受的档位。`null` 与缺席都表示「这只手说不出」，宿主据此不画那一格；给了空的 `optionDescriptors` 同理。 */
+    readonly capabilities?: ExecutorModelCapabilities | null;
+    /**
+     * 上下文窗口 token 数。**多数 CLI 报不出这个**（codex 的 `model/list` 就没有这一栏），
+     * 报不出就缺席，界面显示「未知」；别在这里填一个猜的数。用户手填的窗口由宿主叠在上面。
+     */
+    readonly contextWindow?: number;
+};
+/** 与宿主 `ModelCapabilities` 同形（`packages/contracts/src/model.ts`）。 */
+export type ExecutorModelCapabilities = {
+    readonly optionDescriptors?: ReadonlyArray<ExecutorModelOptionDescriptor>;
+};
+/** 与宿主 `ProviderOptionChoice` 同形。`id` 是写回 CLI 的那个值，`label` 只给人看。 */
+export type ExecutorModelOptionChoice = {
+    readonly id: string;
+    readonly label: string;
+    readonly description?: string;
+    readonly isDefault?: boolean;
+};
+/**
+ * 与宿主 `ProviderOptionDescriptor` 同形：`select` 与 `boolean` 两种。
+ * codex 的 `reasoningEffort` / `serviceTier` 都是 `select`。
+ */
+export type ExecutorModelOptionDescriptor = {
+    readonly id: string;
+    readonly label: string;
+    readonly description?: string;
+    readonly type: "select";
+    readonly options: ReadonlyArray<ExecutorModelOptionChoice>;
+    readonly currentValue?: string;
+} | {
+    readonly id: string;
+    readonly label: string;
+    readonly description?: string;
+    readonly type: "boolean";
+    readonly currentValue?: boolean;
+};
+export type ExecutorSessionCandidate = {
+    readonly nativeSessionId: string;
+    readonly title: string | null;
+    readonly preview: string | null;
+    readonly model: string | null;
+    readonly turnCount: number;
+    readonly updatedAt: number;
+    readonly cwd: string;
+    readonly availability: "importable" | "alreadyImported";
+    readonly openElsewhere: boolean;
+    readonly importedThreadId?: string;
+};
+export type ExecutorSessionRecord = {
+    readonly nativeSessionId: string;
+    readonly messages: ReadonlyArray<{
+        readonly role: "user" | "assistant" | "system";
+        readonly text: string;
+        readonly createdAt?: number;
+    }>;
+    readonly resumeCursor: unknown;
+    readonly model?: string | null;
+};
+//# sourceMappingURL=executorSession.d.ts.map

package/dist/executorSession.d.ts.map

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

package/dist/executorSession.js

@@ -0,0 +1,3 @@
+/** 一轮交给 CLI 的文字最多这么多字符，含手自己再展开的部分；与宿主给 `input` 的上限同一个数。 */
+export const EXECUTOR_SEND_TURN_MAX_INPUT_CHARS = 120_000;
+//# sourceMappingURL=executorSession.js.map

package/dist/executorSession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executorSession.js","sourceRoot":"","sources":["../src/executorSession.ts"],"names":[],"mappings":"AAgEA,2DAA2D;AAC3D,MAAM,CAAC,MAAM,kCAAkC,GAAG,OAAO,CAAC"}

package/dist/executorSpawn.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 起进程失败：实例进程满额时的拒绝，以及按 errno 把启动错误折成探测结论。
+ * 公开名字从 executor.ts 再导出。
+ *
+ * @module @ycodium-ai/plugin-api/executorSpawn
+ */
+/**
+ * 宿主拒绝起进程：这个实例同时活着的子进程已到上限（名片 `maxConcurrentProcesses`，缺省 8），
+ * 超出当场拒绝，不排队。
+ *
+ * 与「程序起不来」是两件事：程序这次没被执行，装没装、跑不跑得起来都答不了。所以探测遇到它
+ * 必须原样抛出，不许折成没装、`error` 或 `unchecked`；宿主刷新快照时认出它，保留上一份快照。
+ * `--version` 这类可有可无的辅助进程被拒，只让那一项缺席。
+ *
+ * 只按类型认，不看 message。插件构建须把本包留作 external：运行时由宿主解析到它自己那一份，
+ * 插件与宿主拿到的才是同一个类；打进插件包的副本认不出宿主抛的这一个。
+ */
+export declare class ExecutorSpawnRefusedError extends Error {
+    readonly name = "ExecutorSpawnRefusedError";
+    /** 拒绝那一刻的上限。 */
+    readonly maxProcesses: number;
+    constructor(input: {
+        readonly driverKind: string;
+        readonly maxProcesses: number;
+    });
+}
+/** 起进程失败的探测结论。见 {@link describeExecutorSpawnFailure}。 */
+export type ExecutorSpawnFailure = {
+    /** 程序找不到、路径不存在或不可执行是 `not-installed`，其它启动失败是 `error`。 */
+    readonly readiness: "not-installed" | "error";
+    /** 一句话原因，取错误链最深一层的原话；`error` 前面带一句人话。 */
+    readonly detail: string;
+};
+/**
+ * 这个错误是不是「起进程失败」：错误链上带 Node 的 errno `code`，或是宿主起进程那层的
+ * `ProcessSpawnError` 标签。宿主据此把没接住的起进程失败折成快照，别的错照旧是缺陷。
+ * 按属性认，不用 instanceof：插件各自打包，类不是宿主那一份。
+ */
+export declare const isExecutorSpawnFailure: (error: unknown) => boolean;
+/**
+ * 把 `host.process.spawn` 抛出的失败折成探测结论：ENOENT / ENOTDIR（找不到）与
+ * EACCES 一类（不可执行）是 `not-installed`，其余启动失败是 `error`。
+ *
+ * 调用点已知这是起进程失败时用它；宿主进程满额拒绝（{@link ExecutorSpawnRefusedError}）
+ * 不是起不来，调用方要先把它原样抛出，不要交给这里。
+ */
+export declare const describeExecutorSpawnFailure: (error: unknown) => ExecutorSpawnFailure;
+//# sourceMappingURL=executorSpawn.d.ts.map

package/dist/executorSpawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executorSpawn.d.ts","sourceRoot":"","sources":["../src/executorSpawn.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;GAUG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,SAAkB,IAAI,+BAA+B;IACrD,gBAAgB;IAChB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAElB,KAAK,EAAE;QAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;KAAE;CAMlF;AAED,yDAAyD;AACzD,MAAM,MAAM,oBAAoB,GAAG;IACjC,yDAAyD;IACzD,QAAQ,CAAC,SAAS,EAAE,eAAe,GAAG,OAAO,CAAC;IAC9C,yCAAyC;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAmCF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,OAAO,KAAG,OAEqB,CAAC;AAE9E;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,GAAI,OAAO,OAAO,KAAG,oBAkB7D,CAAC"}