@humain/terminal 0.1.0 → 0.2.1

package/dist/humain/mcp-adapter/vendor/utils.ts

@@ -1,9 +1,50 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { spawnSync } from "node:child_process";
+import { existsSync, realpathSync } from "node:fs";
 import { homedir, platform } from "node:os";
-import { extname, isAbsolute, join } from "node:path";
+import { dirname, extname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import stripJsonComments from "strip-json-comments";
 import type { McpConfig, ServerEntry } from "./types.ts";
 
+export function parseJsonWithComments(raw: string): unknown {
+  return JSON.parse(stripJsonComments(raw, { trailingCommas: true }));
+}
+
+/** Resolve a candidate only when its real path stays within the real root. */
+export function resolveRealContainedPath(root: string, candidate: string, allowMissing = false): string | null {
+  const contained = resolveContainedPath(root, candidate);
+  if (!contained) return null;
+  const canonical = (path: string): string => {
+    let existing = path;
+    while (allowMissing && !existsSync(existing)) {
+      const parent = dirname(existing);
+      if (parent === existing) throw new Error("No existing path ancestor");
+      existing = parent;
+    }
+    return resolve(realpathSync(existing), relative(existing, path));
+  };
+  try {
+    return resolveContainedPath(canonical(root), canonical(contained));
+  } catch {
+    return null;
+  }
+}
+
+export function resolveContainedPath(root: string, candidate: string): string | null {
+  const resolved = resolve(root, candidate);
+  const rel = relative(root, resolved);
+  return rel === "" || (!rel.startsWith("..") && !rel.startsWith(sep) && !isAbsolute(rel)) ? resolved : null;
+}
+
+export function stableStringify(value: unknown): string {
+  if (value === null || typeof value !== "object") return JSON.stringify(value) ?? "undefined";
+  if (Array.isArray(value)) {
+    return `[${value.map(item => stableStringify(item)).join(",")}]`;
+  }
+  const object = value as Record<string, unknown>;
+  return `{${Object.keys(object).sort().map(key => `${JSON.stringify(key)}:${stableStringify(object[key])}`).join(",")}}`;
+}
+
 async function execOpen(pi: ExtensionAPI, target: string, browser?: string, signal?: AbortSignal) {
   const os = platform();
 
@@ -64,11 +105,28 @@ export async function parallelLimit<T, R>(
 }
 
 export function getConfigPathFromArgv(): string | undefined {
-  const idx = process.argv.indexOf("--mcp-config");
-  if (idx >= 0 && idx + 1 < process.argv.length) {
-    return process.argv[idx + 1];
+  let configPath: string | undefined;
+  for (let index = 2; index < process.argv.length; index++) {
+    const arg = process.argv[index];
+    if (arg === undefined) continue;
+    if (arg === "--") break;
+
+    if (arg === "--mcp-config") {
+      const value = process.argv[index + 1];
+      if (value !== undefined && !value.startsWith("-") && !value.startsWith("@")) {
+        configPath = value;
+        index++;
+      } else {
+        configPath = undefined;
+      }
+      continue;
+    }
+
+    if (arg.startsWith("--mcp-config=")) {
+      configPath = arg.slice("--mcp-config=".length);
+    }
   }
-  return undefined;
+  return configPath;
 }
 
 export function interpolateEnvVars(value: string): string;
@@ -80,7 +138,7 @@ export function interpolateEnvVars(value: string, environment: NodeJS.ProcessEnv
     .replace(/\{env:(\w+)\}/g, (_, name) => environment[name] ?? "");
 }
 
-function getMissingEnvVars(value: string, environment: NodeJS.ProcessEnv): string[] {
+export function getMissingEnvVars(value: string, environment: NodeJS.ProcessEnv = process.env): string[] {
   const missing = new Set<string>();
   for (const match of value.matchAll(/\$\{(\w+)\}|\$env:(\w+)|\{env:(\w+)\}/g)) {
     const name = match[1] ?? match[2] ?? match[3];

package/dist/humain/node-http.d.ts

@@ -0,0 +1,3 @@
+import { type ProviderStreams } from "@earendil-works/pi-ai";
+export declare function withHumainNodeHttp(api: ProviderStreams): ProviderStreams;
+//# sourceMappingURL=node-http.d.ts.map

package/dist/humain/node-http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-http.d.ts","sourceRoot":"","sources":["../../src/humain/node-http.ts"],"names":[],"mappings":"AAAA,OAAO,EAMN,KAAK,eAAe,EAEpB,MAAM,uBAAuB,CAAC;AAU/B,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,eAAe,GAAG,eAAe,CAgHxE"}

package/dist/humain/node-http.js

@@ -0,0 +1,119 @@
+import { lazyStream, } from "@earendil-works/pi-ai";
+const PERMANENT_LIMIT_CODES = new Set([
+    "weekly_cap_exceeded",
+    "quota_exceeded",
+    "partner_credit_limit_exceeded",
+    "insufficient_quota",
+    "billing_hard_limit_reached",
+]);
+export function withHumainNodeHttp(api) {
+    const run = (model, context, options, simple) => lazyStream(model, async () => {
+        let httpError;
+        let requestId = null;
+        let retryAfter = null;
+        const key = options?.apiKey;
+        const redact = (value) => (key ? value.replaceAll(key, "[redacted]") : value);
+        const fetcher = options?.fetch ?? globalThis.fetch;
+        const requestOptions = {
+            ...options,
+            // The Anthropic adapter must not interpret a gateway key as an OAuth token.
+            apiKey: model.api === "anthropic-messages" ? "humain-node" : key,
+            fetch: async (input, init) => {
+                const headers = new Headers(init?.headers ?? (input instanceof Request ? input.headers : undefined));
+                if (key)
+                    headers.set("Authorization", `Bearer ${key}`);
+                headers.delete("x-api-key");
+                if (model.api === "anthropic-messages") {
+                    // The SDK appends /v1/messages?beta=true; Node exposes <configured base>/messages.
+                    const url = `${model.baseUrl.replace(/\/+$/u, "")}/messages`;
+                    input = input instanceof Request ? new Request(url, input) : url;
+                    headers.delete("anthropic-beta");
+                }
+                requestId = null;
+                retryAfter = null;
+                httpError = undefined;
+                const response = await fetcher(input, { ...init, headers, redirect: "error" });
+                requestId = response.headers.get("x-request-id");
+                retryAfter = response.headers.get("retry-after");
+                if (response.ok)
+                    return response;
+                const payload = await response
+                    .clone()
+                    .json()
+                    .catch(() => undefined);
+                const error = typeof payload === "object" && payload !== null && "error" in payload ? payload.error : undefined;
+                const code = typeof error === "object" && error !== null
+                    ? "code" in error && typeof error.code === "string"
+                        ? error.code
+                        : "type" in error && typeof error.type === "string"
+                            ? error.type
+                            : undefined
+                    : undefined;
+                let retryable = !PERMANENT_LIMIT_CODES.has(code ?? "") &&
+                    response.headers.get("x-should-retry") !== "false" &&
+                    ([408, 409, 429].includes(response.status) || response.status >= 500);
+                httpError = { status: response.status, code: code && redact(code), retryable };
+                if (retryAfter) {
+                    const retryAt = /^\d+(?:\.\d+)?$/u.test(retryAfter)
+                        ? Date.now() + Number(retryAfter) * 1000
+                        : Date.parse(retryAfter);
+                    if (Number.isFinite(retryAt)) {
+                        const delay = retryAt - Date.now();
+                        const maxDelay = options?.maxRetryDelayMs ?? 60_000;
+                        // Fail instead of shortening a server delay or overflowing the JS timer.
+                        if (delay > 2_147_483_647 || (maxDelay > 0 && delay > maxDelay)) {
+                            retryable = false;
+                            httpError.retryable = false;
+                        }
+                        else {
+                            httpError.retryAt = retryAt;
+                        }
+                    }
+                }
+                if (!retryable) {
+                    const responseHeaders = new Headers(response.headers);
+                    responseHeaders.set("x-should-retry", "false");
+                    return new Response(response.body, {
+                        status: response.status,
+                        statusText: response.statusText,
+                        headers: responseHeaders,
+                    });
+                }
+                return response;
+            },
+        };
+        const source = simple
+            ? api.streamSimple(model, context, requestOptions)
+            : api.stream(model, context, requestOptions);
+        return (async function* () {
+            for await (const event of source) {
+                if (event.type === "error") {
+                    event.error.errorMessage = redact([
+                        event.error.errorMessage ?? "HUMAIN Node request failed",
+                        httpError?.code && `code: ${httpError.code}`,
+                        httpError?.status === 401 && "Run /login humain-node to replace the API key.",
+                        httpError?.status === 404 &&
+                            httpError.code === "model_not_found" &&
+                            "Use /model to refresh the catalog and choose an available model (or restart with --list-models).",
+                        retryAfter && `Retry-After: ${retryAfter}`,
+                        requestId && `X-Request-ID: ${requestId}`,
+                    ]
+                        .filter(Boolean)
+                        .join("; "));
+                    if (httpError) {
+                        event.error.diagnostics = [
+                            ...(event.error.diagnostics ?? []),
+                            { type: "provider_http_error", timestamp: Date.now(), details: httpError },
+                        ];
+                    }
+                }
+                yield event;
+            }
+        })();
+    });
+    return {
+        stream: (model, context, options) => run(model, context, options, false),
+        streamSimple: (model, context, options) => run(model, context, options, true),
+    };
+}
+//# sourceMappingURL=node-http.js.map

package/dist/humain/node-http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-http.js","sourceRoot":"","sources":["../../src/humain/node-http.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\ttype Api,\n\ttype AssistantMessageEvent,\n\ttype Context,\n\tlazyStream,\n\ttype Model,\n\ttype ProviderStreams,\n\ttype SimpleStreamOptions,\n} from \"@earendil-works/pi-ai\";\n\nconst PERMANENT_LIMIT_CODES = new Set([\n\t\"weekly_cap_exceeded\",\n\t\"quota_exceeded\",\n\t\"partner_credit_limit_exceeded\",\n\t\"insufficient_quota\",\n\t\"billing_hard_limit_reached\",\n]);\n\nexport function withHumainNodeHttp(api: ProviderStreams): ProviderStreams {\n\tconst run = (model: Model<Api>, context: Context, options: SimpleStreamOptions | undefined, simple: boolean) =>\n\t\tlazyStream(model, async () => {\n\t\t\tlet httpError: Record<string, unknown> | undefined;\n\t\t\tlet requestId: string | null = null;\n\t\t\tlet retryAfter: string | null = null;\n\t\t\tconst key = options?.apiKey;\n\t\t\tconst redact = (value: string): string => (key ? value.replaceAll(key, \"[redacted]\") : value);\n\t\t\tconst fetcher = options?.fetch ?? globalThis.fetch;\n\t\t\tconst requestOptions = {\n\t\t\t\t...options,\n\t\t\t\t// The Anthropic adapter must not interpret a gateway key as an OAuth token.\n\t\t\t\tapiKey: model.api === \"anthropic-messages\" ? \"humain-node\" : key,\n\t\t\t\tfetch: async (input: Parameters<typeof fetch>[0], init?: RequestInit): Promise<Response> => {\n\t\t\t\t\tconst headers = new Headers(init?.headers ?? (input instanceof Request ? input.headers : undefined));\n\t\t\t\t\tif (key) headers.set(\"Authorization\", `Bearer ${key}`);\n\t\t\t\t\theaders.delete(\"x-api-key\");\n\t\t\t\t\tif (model.api === \"anthropic-messages\") {\n\t\t\t\t\t\t// The SDK appends /v1/messages?beta=true; Node exposes <configured base>/messages.\n\t\t\t\t\t\tconst url = `${model.baseUrl.replace(/\\/+$/u, \"\")}/messages`;\n\t\t\t\t\t\tinput = input instanceof Request ? new Request(url, input) : url;\n\t\t\t\t\t\theaders.delete(\"anthropic-beta\");\n\t\t\t\t\t}\n\t\t\t\t\trequestId = null;\n\t\t\t\t\tretryAfter = null;\n\t\t\t\t\thttpError = undefined;\n\t\t\t\t\tconst response = await fetcher(input, { ...init, headers, redirect: \"error\" });\n\t\t\t\t\trequestId = response.headers.get(\"x-request-id\");\n\t\t\t\t\tretryAfter = response.headers.get(\"retry-after\");\n\t\t\t\t\tif (response.ok) return response;\n\t\t\t\t\tconst payload: unknown = await response\n\t\t\t\t\t\t.clone()\n\t\t\t\t\t\t.json()\n\t\t\t\t\t\t.catch(() => undefined);\n\t\t\t\t\tconst error =\n\t\t\t\t\t\ttypeof payload === \"object\" && payload !== null && \"error\" in payload ? payload.error : undefined;\n\t\t\t\t\tconst code =\n\t\t\t\t\t\ttypeof error === \"object\" && error !== null\n\t\t\t\t\t\t\t? \"code\" in error && typeof error.code === \"string\"\n\t\t\t\t\t\t\t\t? error.code\n\t\t\t\t\t\t\t\t: \"type\" in error && typeof error.type === \"string\"\n\t\t\t\t\t\t\t\t\t? error.type\n\t\t\t\t\t\t\t\t\t: undefined\n\t\t\t\t\t\t\t: undefined;\n\t\t\t\t\tlet retryable =\n\t\t\t\t\t\t!PERMANENT_LIMIT_CODES.has(code ?? \"\") &&\n\t\t\t\t\t\tresponse.headers.get(\"x-should-retry\") !== \"false\" &&\n\t\t\t\t\t\t([408, 409, 429].includes(response.status) || response.status >= 500);\n\t\t\t\t\thttpError = { status: response.status, code: code && redact(code), retryable };\n\t\t\t\t\tif (retryAfter) {\n\t\t\t\t\t\tconst retryAt = /^\\d+(?:\\.\\d+)?$/u.test(retryAfter)\n\t\t\t\t\t\t\t? Date.now() + Number(retryAfter) * 1000\n\t\t\t\t\t\t\t: Date.parse(retryAfter);\n\t\t\t\t\t\tif (Number.isFinite(retryAt)) {\n\t\t\t\t\t\t\tconst delay = retryAt - Date.now();\n\t\t\t\t\t\t\tconst maxDelay = options?.maxRetryDelayMs ?? 60_000;\n\t\t\t\t\t\t\t// Fail instead of shortening a server delay or overflowing the JS timer.\n\t\t\t\t\t\t\tif (delay > 2_147_483_647 || (maxDelay > 0 && delay > maxDelay)) {\n\t\t\t\t\t\t\t\tretryable = false;\n\t\t\t\t\t\t\t\thttpError.retryable = false;\n\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\thttpError.retryAt = retryAt;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tif (!retryable) {\n\t\t\t\t\t\tconst responseHeaders = new Headers(response.headers);\n\t\t\t\t\t\tresponseHeaders.set(\"x-should-retry\", \"false\");\n\t\t\t\t\t\treturn new Response(response.body, {\n\t\t\t\t\t\t\tstatus: response.status,\n\t\t\t\t\t\t\tstatusText: response.statusText,\n\t\t\t\t\t\t\theaders: responseHeaders,\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\t\t\t\t\treturn response;\n\t\t\t\t},\n\t\t\t};\n\t\t\tconst source = simple\n\t\t\t\t? api.streamSimple(model, context, requestOptions)\n\t\t\t\t: api.stream(model, context, requestOptions);\n\t\t\treturn (async function* (): AsyncGenerator<AssistantMessageEvent> {\n\t\t\t\tfor await (const event of source) {\n\t\t\t\t\tif (event.type === \"error\") {\n\t\t\t\t\t\tevent.error.errorMessage = redact(\n\t\t\t\t\t\t\t[\n\t\t\t\t\t\t\t\tevent.error.errorMessage ?? \"HUMAIN Node request failed\",\n\t\t\t\t\t\t\t\thttpError?.code && `code: ${httpError.code}`,\n\t\t\t\t\t\t\t\thttpError?.status === 401 && \"Run /login humain-node to replace the API key.\",\n\t\t\t\t\t\t\t\thttpError?.status === 404 &&\n\t\t\t\t\t\t\t\t\thttpError.code === \"model_not_found\" &&\n\t\t\t\t\t\t\t\t\t\"Use /model to refresh the catalog and choose an available model (or restart with --list-models).\",\n\t\t\t\t\t\t\t\tretryAfter && `Retry-After: ${retryAfter}`,\n\t\t\t\t\t\t\t\trequestId && `X-Request-ID: ${requestId}`,\n\t\t\t\t\t\t\t]\n\t\t\t\t\t\t\t\t.filter(Boolean)\n\t\t\t\t\t\t\t\t.join(\"; \"),\n\t\t\t\t\t\t);\n\t\t\t\t\t\tif (httpError) {\n\t\t\t\t\t\t\tevent.error.diagnostics = [\n\t\t\t\t\t\t\t\t...(event.error.diagnostics ?? []),\n\t\t\t\t\t\t\t\t{ type: \"provider_http_error\", timestamp: Date.now(), details: httpError },\n\t\t\t\t\t\t\t];\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tyield event;\n\t\t\t\t}\n\t\t\t})();\n\t\t});\n\treturn {\n\t\tstream: (model, context, options) => run(model, context, options, false),\n\t\tstreamSimple: (model, context, options) => run(model, context, options, true),\n\t};\n}\n"]}

package/dist/humain/node-provider.d.ts

@@ -0,0 +1,4 @@
+import { type Provider } from "@earendil-works/pi-ai";
+export declare const HUMAIN_NODE_PROVIDER = "humain-node";
+export declare function createHumainNodeProvider(env?: NodeJS.ProcessEnv): Provider;
+//# sourceMappingURL=node-provider.d.ts.map

package/dist/humain/node-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-provider.d.ts","sourceRoot":"","sources":["../../src/humain/node-provider.ts"],"names":[],"mappings":"AACA,OAAO,EAQN,KAAK,QAAQ,EAEb,MAAM,uBAAuB,CAAC;AAM/B,eAAO,MAAM,oBAAoB,gBAAgB,CAAC;AAwRlD,wBAAgB,wBAAwB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,QAAQ,CAgGvF"}

package/dist/humain/node-provider.js

@@ -0,0 +1,359 @@
+import { setTimeout as delay } from "node:timers/promises";
+import { createProvider, } from "@earendil-works/pi-ai";
+import { anthropicMessagesApi } from "@earendil-works/pi-ai/api/anthropic-messages.lazy";
+import { openAICompletionsApi } from "@earendil-works/pi-ai/api/openai-completions.lazy";
+import { openAIResponsesApi } from "@earendil-works/pi-ai/api/openai-responses.lazy";
+import { withHumainNodeHttp } from "./node-http.js";
+export const HUMAIN_NODE_PROVIDER = "humain-node";
+const DEFAULT_BASE_URL = "https://api.node.humain.com/v1";
+const API_KEY_ENV = "HUMAIN_NODE_API_KEY";
+const BASE_URL_ENV = "HUMAIN_NODE_BASE_URL";
+const RETRYABLE_STATUS_CODES = new Set([408, 425, 429, 500, 502, 503, 504]);
+const PERMANENT_LIMIT_CODES = new Set([
+    "billing_hard_limit_reached",
+    "insufficient_quota",
+    "partner_credit_limit_exceeded",
+    "quota_exceeded",
+    "weekly_cap_exceeded",
+]);
+const REQUEST_TIMEOUT_MS = 5_000;
+const MAX_RETRIES = 2;
+const MAX_RETRY_DELAY_MS = 2_000;
+const ZERO_COST = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 };
+function normalizeBaseUrl(value) {
+    let url;
+    try {
+        url = new URL(value.trim());
+    }
+    catch {
+        throw new Error("Invalid HUMAIN Node base URL");
+    }
+    const local = url.hostname === "localhost" || url.hostname === "127.0.0.1" || url.hostname === "[::1]";
+    if (url.protocol !== "https:" && !(local && url.protocol === "http:")) {
+        throw new Error("HUMAIN Node base URL must use HTTPS (HTTP is allowed only for localhost)");
+    }
+    if (url.username || url.password || url.search || url.hash) {
+        throw new Error("HUMAIN Node base URL must not contain credentials, a query, or a fragment");
+    }
+    url.pathname = url.pathname.replace(/\/+$/u, "") || "/";
+    return url.toString().replace(/\/$/u, "");
+}
+function credentialBaseUrl(credential) {
+    const value = credential?.env?.[BASE_URL_ENV];
+    return typeof value === "string" && value.trim() ? normalizeBaseUrl(value) : undefined;
+}
+async function resolveBaseUrl(ctx, credential) {
+    return credentialBaseUrl(credential) ?? normalizeBaseUrl((await ctx.env(BASE_URL_ENV)) ?? DEFAULT_BASE_URL);
+}
+function endpointApi(value) {
+    const normalized = value
+        .trim()
+        .toLowerCase()
+        .replace(/^https?:\/\/[^/]+/u, "")
+        .replace(/\/+$/u, "");
+    switch (normalized) {
+        case "responses":
+        case "/responses":
+        case "openai-responses":
+        case "openai_responses":
+            return "openai-responses";
+        case "chat/completions":
+        case "/chat/completions":
+        case "chat-completions":
+        case "chat_completions":
+        case "openai-completions":
+        case "openai_chat_completions":
+            return "openai-completions";
+        case "messages":
+        case "/messages":
+        case "anthropic-messages":
+        case "anthropic_messages":
+            return "anthropic-messages";
+        default:
+            return undefined;
+    }
+}
+function modelApi(id, node) {
+    if (typeof node.api_interface === "string") {
+        const primary = endpointApi(node.api_interface);
+        if (primary)
+            return primary;
+    }
+    const supported = Array.isArray(node.supported_formats)
+        ? node.supported_formats.flatMap((value) => (typeof value === "string" ? (endpointApi(value) ?? []) : []))
+        : [];
+    for (const preferred of ["openai-responses", "openai-completions", "anthropic-messages"]) {
+        if (supported.includes(preferred))
+            return preferred;
+    }
+    const primary = typeof node.api_interface === "string" ? node.api_interface : "missing";
+    throw new Error(`HUMAIN Node model "${id}" has an unsupported API interface: ${primary}`);
+}
+function positiveInteger(value, field, id) {
+    if (typeof value !== "number" || !Number.isSafeInteger(value) || value <= 0) {
+        throw new Error(`HUMAIN Node model "${id}" has invalid ${field}`);
+    }
+    return value;
+}
+function toModel(value, baseUrl) {
+    if (typeof value !== "object" || value === null || !("id" in value)) {
+        throw new Error("HUMAIN Node returned a malformed model entry");
+    }
+    const raw = value;
+    if (raw.active === false)
+        return undefined;
+    const node = typeof raw.node === "object" && raw.node !== null ? raw.node : raw;
+    const payload = { ...raw, node };
+    if (typeof payload.id !== "string" || !payload.id.trim()) {
+        throw new Error("HUMAIN Node returned a malformed model entry");
+    }
+    const id = payload.id.trim();
+    if (typeof payload.node.supports_streaming !== "boolean") {
+        throw new Error(`HUMAIN Node model "${id}" has invalid supports_streaming`);
+    }
+    if (typeof payload.node.supports_function_calling !== "boolean") {
+        throw new Error(`HUMAIN Node model "${id}" has invalid supports_function_calling`);
+    }
+    if (payload.node.supports_streaming === false || payload.node.supports_function_calling === false)
+        return undefined;
+    let api;
+    try {
+        api = modelApi(id, payload.node);
+    }
+    catch (error) {
+        if (payload.node.api_interface === "image_generations" || payload.node.api_interface === "realtime")
+            return undefined;
+        throw error;
+    }
+    const contextWindow = payload.node.max_context_tokens;
+    const maxTokens = payload.node.max_output_tokens;
+    if (contextWindow === null || maxTokens === null || contextWindow === 0 || maxTokens === 0)
+        return undefined;
+    return {
+        id,
+        name: typeof payload.display_name === "string" && payload.display_name.trim()
+            ? payload.display_name.trim()
+            : typeof payload.name === "string" && payload.name.trim()
+                ? payload.name.trim()
+                : id,
+        api,
+        provider: HUMAIN_NODE_PROVIDER,
+        baseUrl,
+        reasoning: false,
+        input: payload.node.supports_images === true ? ["text", "image"] : ["text"],
+        cost: ZERO_COST,
+        contextWindow: positiveInteger(contextWindow, "max_context_tokens", id),
+        maxTokens: positiveInteger(maxTokens, "max_output_tokens", id),
+        ...(api === "openai-completions"
+            ? {
+                compat: {
+                    supportsStore: false,
+                    supportsDeveloperRole: false,
+                    supportsReasoningEffort: false,
+                    supportsUsageInStreaming: true,
+                    supportsStrictMode: false,
+                    supportsLongCacheRetention: false,
+                    maxTokensField: "max_tokens",
+                },
+            }
+            : {}),
+    };
+}
+function retryDelay(response, attempt) {
+    const retryAfter = response.headers.get("retry-after");
+    if (retryAfter) {
+        const seconds = Number(retryAfter);
+        const delay = Number.isFinite(seconds) ? seconds * 1_000 : Date.parse(retryAfter) - Date.now();
+        if (Number.isFinite(delay)) {
+            const bounded = Math.max(0, delay);
+            return bounded <= MAX_RETRY_DELAY_MS ? bounded : undefined;
+        }
+    }
+    return 100 * 2 ** attempt;
+}
+function errorDetails(response, payload) {
+    const error = payload.error;
+    const code = typeof error?.code === "string" ? error.code : undefined;
+    const type = typeof error?.type === "string" ? error.type : undefined;
+    const detail = typeof error?.message === "string" ? error.message : undefined;
+    const retryAfter = response.headers.get("retry-after");
+    const requestId = response.headers.get("x-request-id");
+    return {
+        code,
+        message: [
+            `HUMAIN Node model discovery failed: ${response.status}`,
+            code && `code=${code}`,
+            type && `type=${type}`,
+            detail,
+            retryAfter && `Retry-After: ${retryAfter}`,
+            requestId && `X-Request-ID: ${requestId}`,
+        ]
+            .filter(Boolean)
+            .join("; "),
+    };
+}
+async function fetchModelsUnredacted(baseUrl, apiKey, signal) {
+    for (let attempt = 0;; attempt++) {
+        signal.throwIfAborted();
+        const attemptSignal = AbortSignal.any([signal, AbortSignal.timeout(REQUEST_TIMEOUT_MS)]);
+        let response;
+        try {
+            response = await fetch(new URL(`${baseUrl}/models`), {
+                signal: attemptSignal,
+                redirect: "error",
+                headers: { Accept: "application/json", Authorization: `Bearer ${apiKey}` },
+            });
+        }
+        catch (error) {
+            if (signal.aborted || attempt >= MAX_RETRIES)
+                throw error;
+            await delay(100 * 2 ** attempt, undefined, { signal });
+            continue;
+        }
+        const payload = await response.json().catch(() => ({}));
+        if (!response.ok) {
+            const details = errorDetails(response, typeof payload === "object" && payload !== null ? payload : {});
+            const retryMs = retryDelay(response, attempt);
+            if (attempt < MAX_RETRIES &&
+                RETRYABLE_STATUS_CODES.has(response.status) &&
+                !PERMANENT_LIMIT_CODES.has(details.code ?? "") &&
+                retryMs !== undefined) {
+                await delay(retryMs, undefined, { signal });
+                continue;
+            }
+            throw new Error(details.message);
+        }
+        if (typeof payload !== "object" || payload === null) {
+            throw new Error("HUMAIN Node returned a malformed model catalog");
+        }
+        const entries = "data" in payload && Array.isArray(payload.data)
+            ? payload.data
+            : "items" in payload && Array.isArray(payload.items)
+                ? payload.items
+                : undefined;
+        if (!entries)
+            throw new Error("HUMAIN Node returned a malformed model catalog");
+        const ids = new Set();
+        for (const entry of entries) {
+            if (typeof entry !== "object" || entry === null || !("id" in entry) || typeof entry.id !== "string")
+                continue;
+            const id = entry.id.trim();
+            if (ids.has(id))
+                throw new Error(`HUMAIN Node returned duplicate model id "${id}"`);
+            ids.add(id);
+        }
+        return entries.flatMap((entry) => toModel(entry, baseUrl) ?? []);
+    }
+}
+async function fetchModels(baseUrl, apiKey, signal) {
+    try {
+        return await fetchModelsUnredacted(baseUrl, apiKey, signal);
+    }
+    catch (error) {
+        if (signal.aborted)
+            throw signal.reason;
+        const message = (error instanceof Error ? error.message : String(error)).replaceAll(apiKey, "[redacted]");
+        const redacted = new Error(message);
+        if (error instanceof Error)
+            redacted.name = error.name;
+        throw redacted;
+    }
+}
+export function createHumainNodeProvider(env = process.env) {
+    let models = [];
+    let activeScope;
+    const apiKeyAuth = {
+        name: "HUMAIN Node API key",
+        login: async (interaction) => {
+            if (!env[API_KEY_ENV]?.trim()) {
+                interaction.notify({
+                    type: "info",
+                    message: "Create a HUMAIN Node API key in Node Users, then paste it below.",
+                });
+            }
+            const enteredKey = (await interaction.prompt({
+                type: "secret",
+                message: "Enter HUMAIN Node API key (leave blank to use HUMAIN_NODE_API_KEY)",
+            })).trim();
+            const key = enteredKey || env[API_KEY_ENV]?.trim();
+            if (!key)
+                throw new Error("HUMAIN Node API key is required");
+            const enteredUrl = await interaction.prompt({
+                type: "text",
+                message: "HUMAIN Node base URL",
+                placeholder: env[BASE_URL_ENV] ?? DEFAULT_BASE_URL,
+            });
+            const baseUrl = normalizeBaseUrl(enteredUrl.trim() || env[BASE_URL_ENV] || DEFAULT_BASE_URL);
+            await fetchModels(baseUrl, key, interaction.signal);
+            return {
+                type: "api_key",
+                key: enteredKey.replaceAll("$", () => "$$").replace(/^!/u, () => "$!") || undefined,
+                env: { [BASE_URL_ENV]: baseUrl },
+            };
+        },
+        check: async ({ ctx, credential, signal }) => {
+            signal.throwIfAborted();
+            const key = credential?.key ?? (await ctx.env(API_KEY_ENV));
+            return key
+                ? { type: "api_key", source: credential?.key ? "stored credential" : API_KEY_ENV }
+                : undefined;
+        },
+        resolve: async ({ ctx, credential, signal }) => {
+            signal.throwIfAborted();
+            const key = credential?.key ?? (await ctx.env(API_KEY_ENV));
+            if (!key)
+                return undefined;
+            const baseUrl = await resolveBaseUrl(ctx, credential);
+            return {
+                auth: { apiKey: key, baseUrl },
+                env: { ...credential?.env, [BASE_URL_ENV]: baseUrl },
+                source: credential?.key ? "stored credential" : API_KEY_ENV,
+            };
+        },
+    };
+    const base = createProvider({
+        id: HUMAIN_NODE_PROVIDER,
+        name: "HUMAIN Node",
+        baseUrl: DEFAULT_BASE_URL,
+        auth: { apiKey: apiKeyAuth },
+        models: [],
+        api: {
+            "anthropic-messages": withHumainNodeHttp(anthropicMessagesApi()),
+            "openai-completions": withHumainNodeHttp(openAICompletionsApi()),
+            "openai-responses": withHumainNodeHttp(openAIResponsesApi()),
+        },
+    });
+    return {
+        ...base,
+        getModels: () => models,
+        refreshModels: async (context) => {
+            const credential = context.credential?.type === "api_key" ? context.credential : undefined;
+            const key = credential?.key;
+            const baseUrl = credential ? (credentialBaseUrl(credential) ?? DEFAULT_BASE_URL) : undefined;
+            const scope = key && baseUrl ? `${baseUrl}\0${key}` : undefined;
+            if (scope !== activeScope) {
+                if (!(await context.publish({
+                    persist: null,
+                    update: () => {
+                        models = [];
+                        activeScope = scope;
+                    },
+                })))
+                    return;
+            }
+            if (!context.allowNetwork || context.signal.aborted || !key || !baseUrl)
+                return;
+            const refreshed = await fetchModels(baseUrl, key, context.signal);
+            if (context.signal.aborted)
+                return;
+            await context.publish({
+                persist: null,
+                update: () => {
+                    models = refreshed;
+                    activeScope = scope;
+                },
+            });
+        },
+    };
+}
+//# sourceMappingURL=node-provider.js.map