@ycodium-ai/plugin-api 0.2.3000 → 0.2.3002

package/dist/executorSpawn.js

@@ -0,0 +1,87 @@
+/**
+ * 起进程失败：实例进程满额时的拒绝，以及按 errno 把启动错误折成探测结论。
+ * 公开名字从 executor.ts 再导出。
+ *
+ * @module @ycodium-ai/plugin-api/executorSpawn
+ */
+/**
+ * 宿主拒绝起进程：这个实例同时活着的子进程已到上限（名片 `maxConcurrentProcesses`，缺省 8），
+ * 超出当场拒绝，不排队。
+ *
+ * 与「程序起不来」是两件事：程序这次没被执行，装没装、跑不跑得起来都答不了。所以探测遇到它
+ * 必须原样抛出，不许折成没装、`error` 或 `unchecked`；宿主刷新快照时认出它，保留上一份快照。
+ * `--version` 这类可有可无的辅助进程被拒，只让那一项缺席。
+ *
+ * 只按类型认，不看 message。插件构建须把本包留作 external：运行时由宿主解析到它自己那一份，
+ * 插件与宿主拿到的才是同一个类；打进插件包的副本认不出宿主抛的这一个。
+ */
+export class ExecutorSpawnRefusedError extends Error {
+    name = "ExecutorSpawnRefusedError";
+    /** 拒绝那一刻的上限。 */
+    maxProcesses;
+    constructor(input) {
+        super(`executor '${input.driverKind}' refused spawn: ${String(input.maxProcesses)} live processes`);
+        this.maxProcesses = input.maxProcesses;
+    }
+}
+const SPAWN_NOT_FOUND_CODES = new Set(["ENOENT", "ENOTDIR"]);
+const SPAWN_NOT_EXECUTABLE_CODES = new Set([
+    "EACCES",
+    "EPERM",
+    "ENOEXEC",
+    "EFTYPE",
+]);
+/** 沿 `cause` 链往下找的深度上限；环或畸形链不会拖死探测。 */
+const SPAWN_ERROR_CHAIN_DEPTH = 6;
+const spawnErrorChain = (error) => {
+    const chain = [];
+    let current = error;
+    while (chain.length < SPAWN_ERROR_CHAIN_DEPTH &&
+        typeof current === "object" &&
+        current !== null &&
+        !chain.includes(current)) {
+        chain.push(current);
+        current = current.cause;
+    }
+    return chain;
+};
+const spawnErrorCode = (error) => {
+    for (const link of spawnErrorChain(error)) {
+        const code = link["code"];
+        if (typeof code === "string")
+            return code;
+    }
+    return undefined;
+};
+/**
+ * 这个错误是不是「起进程失败」：错误链上带 Node 的 errno `code`，或是宿主起进程那层的
+ * `ProcessSpawnError` 标签。宿主据此把没接住的起进程失败折成快照，别的错照旧是缺陷。
+ * 按属性认，不用 instanceof：插件各自打包，类不是宿主那一份。
+ */
+export const isExecutorSpawnFailure = (error) => spawnErrorCode(error) !== undefined ||
+    spawnErrorChain(error).some((link) => link["_tag"] === "ProcessSpawnError");
+/**
+ * 把 `host.process.spawn` 抛出的失败折成探测结论：ENOENT / ENOTDIR（找不到）与
+ * EACCES 一类（不可执行）是 `not-installed`，其余启动失败是 `error`。
+ *
+ * 调用点已知这是起进程失败时用它；宿主进程满额拒绝（{@link ExecutorSpawnRefusedError}）
+ * 不是起不来，调用方要先把它原样抛出，不要交给这里。
+ */
+export const describeExecutorSpawnFailure = (error) => {
+    const chain = spawnErrorChain(error);
+    const code = spawnErrorCode(error);
+    const messages = chain.flatMap((link) => {
+        const message = link["message"];
+        return typeof message === "string" && message.trim().length > 0 ? [message.trim()] : [];
+    });
+    const root = messages.at(-1) ?? (typeof error === "string" ? error.trim() : "");
+    if (code !== undefined &&
+        (SPAWN_NOT_FOUND_CODES.has(code) || SPAWN_NOT_EXECUTABLE_CODES.has(code))) {
+        return { readiness: "not-installed", detail: root.length > 0 ? root : code };
+    }
+    return {
+        readiness: "error",
+        detail: `The program could not be started${root.length > 0 ? `: ${root}` : "."}`,
+    };
+};
+//# sourceMappingURL=executorSpawn.js.map

package/dist/executorSpawn.js.map

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