@idcloudhost/ai-connect 0.1.0

package/dist/commands/snippet.js

@@ -0,0 +1,91 @@
+import { buildTarget, resolveSource } from '../core/discovery.js';
+import { c, ui } from '../ui.js';
+const LANGS = ['curl', 'node', 'python', 'vercel-ai', 'langchain'];
+/** Copy-pasteable starter code for people wiring the gateway into their own app. */
+export async function snippetCommand(langArg, flags) {
+    const lang = (langArg ?? 'curl').toLowerCase();
+    if (!LANGS.includes(lang))
+        throw new Error(`unknown snippet "${lang}". One of: ${LANGS.join(', ')}`);
+    const source = await resolveSource(flags);
+    const target = await buildTarget(source, { ...flags, offline: true });
+    const model = target.defaultModel ?? 'MODEL_ID';
+    const base = target.apiBase;
+    const body = build(lang, base, model);
+    if (flags.json) {
+        ui.plain(JSON.stringify({ lang, apiBase: base, model, snippet: body }, null, 2));
+        return 0;
+    }
+    ui.plain(body);
+    ui.plain();
+    ui.info(`The key is read from $OPENAI_API_KEY — run \`eval "$(idch-ai env)"\` first, or paste it in.`);
+    if (!target.defaultModel)
+        ui.info(`Replace MODEL_ID with one from ${c.bold('idch-ai models')}.`);
+    return 0;
+}
+function build(lang, base, model) {
+    switch (lang) {
+        case 'curl':
+            return `curl ${base}/chat/completions \\
+  -H "Content-Type: application/json" \\
+  -H "Authorization: Bearer $OPENAI_API_KEY" \\
+  -d '{
+    "model": "${model}",
+    "messages": [{ "role": "user", "content": "Hello!" }]
+  }'`;
+        case 'node':
+            return `import OpenAI from "openai";
+
+const client = new OpenAI({
+  apiKey: process.env.OPENAI_API_KEY,
+  baseURL: "${base}",
+});
+
+const res = await client.chat.completions.create({
+  model: "${model}",
+  messages: [{ role: "user", content: "Hello!" }],
+});
+
+console.log(res.choices[0].message.content);`;
+        case 'python':
+            return `from openai import OpenAI
+
+client = OpenAI(
+    api_key=os.environ["OPENAI_API_KEY"],
+    base_url="${base}",
+)
+
+res = client.chat.completions.create(
+    model="${model}",
+    messages=[{"role": "user", "content": "Hello!"}],
+)
+
+print(res.choices[0].message.content)`;
+        case 'vercel-ai':
+            return `import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
+import { generateText } from "ai";
+
+const idch = createOpenAICompatible({
+  name: "idcloudhost",
+  baseURL: "${base}",
+  apiKey: process.env.OPENAI_API_KEY,
+});
+
+const { text } = await generateText({
+  model: idch("${model}"),
+  prompt: "Hello!",
+});
+
+console.log(text);`;
+        case 'langchain':
+            return `from langchain_openai import ChatOpenAI
+
+llm = ChatOpenAI(
+    model="${model}",
+    base_url="${base}",
+    api_key=os.environ["OPENAI_API_KEY"],
+)
+
+print(llm.invoke("Hello!").content)`;
+    }
+}
+//# sourceMappingURL=snippet.js.map

package/dist/commands/snippet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snippet.js","sourceRoot":"","sources":["../../src/commands/snippet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAGjC,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,CAAU,CAAC;AAG5E,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAA2B,EAAE,KAAkB;IAClF,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC,WAAW,EAAiB,CAAC;IAC9D,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,cAAc,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAErG,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACtE,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,IAAI,UAAU,CAAC;IAChD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC;IAE5B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IACtC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACjF,OAAO,CAAC,CAAC;IACX,CAAC;IACD,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACf,EAAE,CAAC,KAAK,EAAE,CAAC;IACX,EAAE,CAAC,IAAI,CAAC,6FAA6F,CAAC,CAAC;IACvG,IAAI,CAAC,MAAM,CAAC,YAAY;QAAE,EAAE,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACjG,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,KAAK,CAAC,IAAiB,EAAE,IAAY,EAAE,KAAa;IAC3D,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM;YACT,OAAO,QAAQ,IAAI;;;;gBAIT,KAAK;;KAEhB,CAAC;QAEF,KAAK,MAAM;YACT,OAAO;;;;cAIC,IAAI;;;;YAIN,KAAK;;;;6CAI4B,CAAC;QAE1C,KAAK,QAAQ;YACX,OAAO;;;;gBAIG,IAAI;;;;aAIP,KAAK;;;;sCAIoB,CAAC;QAEnC,KAAK,WAAW;YACd,OAAO;;;;;cAKC,IAAI;;;;;iBAKD,KAAK;;;;mBAIH,CAAC;QAEhB,KAAK,WAAW;YACd,OAAO;;;aAGA,KAAK;gBACF,IAAI;;;;oCAIgB,CAAC;IACnC,CAAC;AACH,CAAC"}

package/dist/core/detect.d.ts

@@ -0,0 +1,12 @@
+import type { DetectResult } from '../types.js';
+/** Locate an executable on PATH without shelling out to `which`. */
+export declare function whichBin(name: string): Promise<string | null>;
+/** Best-effort `<bin> --version`. Never throws; agents that hang are given 3s. */
+export declare function binVersion(bin: string, args?: string[]): Promise<string | undefined>;
+/**
+ * An agent counts as installed when its binary is on PATH *or* it has already
+ * left a config behind — a user may have it installed via an IDE extension or a
+ * shell alias we cannot see.
+ */
+export declare function detectByBinOrConfig(bins: string[], configPaths: string[]): Promise<DetectResult>;
+//# sourceMappingURL=detect.d.ts.map

package/dist/core/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/core/detect.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,oEAAoE;AACpE,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgBnE;AAED,kFAAkF;AAClF,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,WAAgB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAQ/F;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CActG"}

package/dist/core/detect.js

@@ -0,0 +1,59 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { pathExists, shortenHome } from '../fsutil/edit.js';
+const exec = promisify(execFile);
+/** Locate an executable on PATH without shelling out to `which`. */
+export async function whichBin(name) {
+    const isWin = process.platform === 'win32';
+    const dirs = (process.env.PATH ?? '').split(isWin ? ';' : ':').filter(Boolean);
+    const exts = isWin ? (process.env.PATHEXT ?? '.EXE;.CMD;.BAT').split(';') : [''];
+    for (const dir of dirs) {
+        for (const ext of exts) {
+            const candidate = path.join(dir, name + ext.toLowerCase());
+            try {
+                await fs.access(candidate, isWin ? fs.constants.F_OK : fs.constants.X_OK);
+                return candidate;
+            }
+            catch {
+                /* keep looking */
+            }
+        }
+    }
+    return null;
+}
+/** Best-effort `<bin> --version`. Never throws; agents that hang are given 3s. */
+export async function binVersion(bin, args = ['--version']) {
+    try {
+        const { stdout } = await exec(bin, args, { timeout: 3000, windowsHide: true });
+        const first = stdout.trim().split('\n')[0]?.trim();
+        return first || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * An agent counts as installed when its binary is on PATH *or* it has already
+ * left a config behind — a user may have it installed via an IDE extension or a
+ * shell alias we cannot see.
+ */
+export async function detectByBinOrConfig(bins, configPaths) {
+    for (const bin of bins) {
+        const found = await whichBin(bin);
+        if (found) {
+            const version = await binVersion(found);
+            const result = { installed: true, evidence: `binary: ${shortenHome(found)}` };
+            if (version)
+                result.version = version;
+            return result;
+        }
+    }
+    for (const file of configPaths) {
+        if (await pathExists(file))
+            return { installed: true, evidence: `config: ${shortenHome(file)}` };
+    }
+    return { installed: false };
+}
+//# sourceMappingURL=detect.js.map

package/dist/core/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../src/core/detect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE5D,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAEjC,oEAAoE;AACpE,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAY;IACzC,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;IAC3C,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/E,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,gBAAgB,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACjF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;YAC3D,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBAC1E,OAAO,SAAS,CAAC;YACnB,CAAC;YAAC,MAAM,CAAC;gBACP,kBAAkB;YACpB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW,EAAE,IAAI,GAAG,CAAC,WAAW,CAAC;IAChE,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/E,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QACnD,OAAO,KAAK,IAAI,SAAS,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAc,EAAE,WAAqB;IAC7E,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC;YACxC,MAAM,MAAM,GAAiB,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,WAAW,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;YAC5F,IAAI,OAAO;gBAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;YACtC,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;IACnG,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AAC9B,CAAC"}

package/dist/core/discovery.d.ts

@@ -0,0 +1,46 @@
+import type { ConnectionTarget, GatewayModel } from '../types.js';
+import { type Discrimination } from './gateway.js';
+export interface ResolveInput {
+    baseUrl?: string;
+    apiKey?: string;
+    /** Discover the gateway URL through the dashboard API instead. */
+    dashboardUrl?: string;
+    token?: string;
+    org?: string;
+    profile?: string;
+    providerId?: string;
+    providerLabel?: string;
+    /** Restrict which models get registered. Empty means all chat-capable models. */
+    onlyModels?: string[];
+    defaultModel?: string;
+    /** Skip the live /models call. Adapters then register only --model. */
+    offline?: boolean;
+}
+export interface ResolvedSource {
+    baseUrl: string;
+    apiKey: string;
+    /** Where each value came from, for the CLI to report honestly. */
+    from: {
+        baseUrl: string;
+        apiKey: string;
+    };
+}
+/**
+ * Work out the gateway URL and key from, in order: explicit flags, environment,
+ * a saved profile, then the dashboard API. Nothing is hard-coded — the gateway
+ * URL is per-environment and is published by the dashboard at runtime.
+ */
+export declare function resolveSource(input: ResolveInput): Promise<ResolvedSource>;
+/** Turn a resolved source into the full target adapters consume. */
+export declare function buildTarget(source: ResolvedSource, input: ResolveInput): Promise<ConnectionTarget>;
+/**
+ * Two different failures hide behind "we could not resolve the base URL", and
+ * they need different fixes — so say which one happened.
+ */
+export declare function explainUnresolvedBase(baseUrl: string, discrimination: Discrimination): string;
+/**
+ * Pick a sensible default: the largest-context model, preferring one that can
+ * call tools, because every agent in our matrix needs tool calling to be useful.
+ */
+export declare function pickDefaultModel(models: GatewayModel[]): string | undefined;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/core/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/core/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAA0C,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAI3F,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CAoDhF;AAED,oEAAoE;AACpE,wBAAsB,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAsCxG;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,GAAG,MAAM,CAmB7F;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,GAAG,SAAS,CAI3E"}

package/dist/core/discovery.js

@@ -0,0 +1,124 @@
+import { chatModels, listModels, resolveApiBase } from './gateway.js';
+import { ManagementClient, explainManagementError } from './management.js';
+import { getProfile } from './store.js';
+/**
+ * Work out the gateway URL and key from, in order: explicit flags, environment,
+ * a saved profile, then the dashboard API. Nothing is hard-coded — the gateway
+ * URL is per-environment and is published by the dashboard at runtime.
+ */
+export async function resolveSource(input) {
+    let baseUrl = input.baseUrl?.trim();
+    let apiKey = input.apiKey?.trim();
+    const from = { baseUrl: 'flag --base-url', apiKey: 'flag --api-key' };
+    if (!baseUrl && process.env.IDCH_AI_BASE_URL) {
+        baseUrl = process.env.IDCH_AI_BASE_URL.trim();
+        from.baseUrl = 'env IDCH_AI_BASE_URL';
+    }
+    if (!apiKey && process.env.IDCH_AI_API_KEY) {
+        apiKey = process.env.IDCH_AI_API_KEY.trim();
+        from.apiKey = 'env IDCH_AI_API_KEY';
+    }
+    if ((!baseUrl || !apiKey) && !input.dashboardUrl) {
+        const saved = await getProfile(input.profile);
+        if (saved) {
+            if (!baseUrl) {
+                baseUrl = saved.profile.apiBase;
+                from.baseUrl = `profile "${saved.name}"`;
+            }
+            if (!apiKey) {
+                apiKey = saved.profile.apiKey;
+                from.apiKey = `profile "${saved.name}"`;
+            }
+        }
+    }
+    if (!baseUrl && input.dashboardUrl && input.token && input.org) {
+        const client = new ManagementClient(input.dashboardUrl, input.token, input.org);
+        try {
+            const status = await client.status();
+            if (!status.integration_available) {
+                throw new Error('the AI gateway is not configured on this environment');
+            }
+            if (!status.enabled) {
+                throw new Error('AI is not enabled for this organization yet — an admin must enable it in the dashboard first');
+            }
+            if (!status.public_base_url) {
+                throw new Error('the dashboard did not publish a gateway URL for this organization');
+            }
+            baseUrl = status.public_base_url;
+            from.baseUrl = 'dashboard GET /ai/status';
+        }
+        catch (err) {
+            throw new Error(`could not discover the gateway from the dashboard: ${explainManagementError(err)}`);
+        }
+    }
+    if (!baseUrl)
+        throw new Error('no gateway URL. Pass --base-url, set IDCH_AI_BASE_URL, or run `idch-ai login`.');
+    if (!apiKey)
+        throw new Error('no API key. Pass --api-key, set IDCH_AI_API_KEY, or run `idch-ai login`.');
+    return { baseUrl, apiKey, from };
+}
+/** Turn a resolved source into the full target adapters consume. */
+export async function buildTarget(source, input) {
+    const { apiBase, origin, basePath, probed, discrimination } = await resolveApiBase(source.baseUrl, source.apiKey);
+    let models = [];
+    if (!input.offline) {
+        if (!probed)
+            throw new Error(explainUnresolvedBase(source.baseUrl, discrimination));
+        models = chatModels(await listModels(apiBase, source.apiKey));
+    }
+    if (input.onlyModels?.length) {
+        const wanted = new Set(input.onlyModels);
+        const missing = input.onlyModels.filter((m) => models.length > 0 && !models.some((x) => x.id === m));
+        if (missing.length && !input.offline) {
+            throw new Error(`these models are not available to your key: ${missing.join(', ')}. ` +
+                `Run \`idch-ai models\` to see what is. An organization admin controls the allowlist.`);
+        }
+        const filtered = models.filter((m) => wanted.has(m.id));
+        // Offline, or a model the catalog did not describe: register it bare.
+        models = filtered.length ? filtered : input.onlyModels.map((id) => ({ id, label: id }));
+    }
+    if (!models.length && input.defaultModel)
+        models = [{ id: input.defaultModel, label: input.defaultModel }];
+    const defaultModel = input.defaultModel ?? pickDefaultModel(models);
+    const target = {
+        apiBase,
+        origin,
+        basePath,
+        apiKey: source.apiKey,
+        providerId: input.providerId ?? 'idcloudhost',
+        providerLabel: input.providerLabel ?? 'IDCloudHost AI',
+        models,
+    };
+    if (defaultModel)
+        target.defaultModel = defaultModel;
+    return target;
+}
+/**
+ * Two different failures hide behind "we could not resolve the base URL", and
+ * they need different fixes — so say which one happened.
+ */
+export function explainUnresolvedBase(baseUrl, discrimination) {
+    if (discrimination === 'collapsed') {
+        return (`could not verify ${baseUrl}: this host answers the same way for paths that do not exist, ` +
+            `so an auth error proves nothing about whether the OpenAI routes are there. ` +
+            `Something is likely replying before routing (a proxy, WAF, or login page). ` +
+            `Check the URL and that the key reaches the gateway itself, or pass --offline to write configs anyway.`);
+    }
+    if (discrimination === 'unknown') {
+        return (`could not verify ${baseUrl}: it answered, but the check that would confirm the answer is meaningful ` +
+            `could not be completed. Re-run, or pass --offline to write configs without contacting the gateway.`);
+    }
+    return (`nothing answered at ${baseUrl} (tried it with and without a /v1 suffix). ` +
+        `Check the URL, or pass --offline to write configs without contacting the gateway.`);
+}
+/**
+ * Pick a sensible default: the largest-context model, preferring one that can
+ * call tools, because every agent in our matrix needs tool calling to be useful.
+ */
+export function pickDefaultModel(models) {
+    if (!models.length)
+        return undefined;
+    const score = (m) => (m.supportsTools === false ? 0 : 1) * 1e12 + (m.contextWindow ?? 0);
+    return [...models].sort((a, b) => score(b) - score(a))[0].id;
+}
+//# sourceMappingURL=discovery.js.map

package/dist/core/discovery.js.map

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

package/dist/core/gateway.d.ts

@@ -0,0 +1,59 @@
+import type { GatewayModel, CapabilityCheck, CapabilityReport } from '../types.js';
+/** Split a base URL into an origin and the path prefix the OpenAI routes hang off. */
+export declare function splitBase(apiBase: string): {
+    origin: string;
+    basePath: string;
+    apiBase: string;
+};
+/**
+ * Work out which URL actually serves the OpenAI routes.
+ *
+ * Our gateway URL is configured per environment (LITELLM_PUBLIC_BASE_URL) and may
+ * or may not already carry the `/v1` suffix, so we probe instead of assuming.
+ * Ordered by likelihood; the first candidate whose `/models` answers wins.
+ */
+/** Why a probe reached its verdict, so callers can report honestly. */
+export type Discrimination = 
+/** A 200 settled it; no inference from status codes was needed. */
+'not-needed'
+/** A control path 404'd, so an auth error really does mean "route exists". */
+ | 'live'
+/** Something answers every path identically — we cannot tell routes apart. */
+ | 'collapsed'
+/** The control request itself failed, so the signal could not be checked. */
+ | 'unknown';
+export interface ResolvedBase {
+    apiBase: string;
+    origin: string;
+    basePath: string;
+    probed: boolean;
+    discrimination: Discrimination;
+}
+export declare function resolveApiBase(input: string, apiKey: string | undefined, opts?: {
+    timeoutMs?: number;
+}): Promise<ResolvedBase>;
+export declare function normalizeUrl(input: string): string;
+/**
+ * List the models this key may use.
+ *
+ * `/models` is the OpenAI-standard, always-present source of truth for ids.
+ * `/model/info` is a LiteLLM extension that adds context windows, pricing and
+ * capability flags — nice to have, so a failure there is not fatal.
+ */
+export declare function listModels(apiBase: string, apiKey: string, opts?: {
+    timeoutMs?: number;
+}): Promise<GatewayModel[]>;
+/** Models that make sense to register with a coding agent. */
+export declare function chatModels(models: GatewayModel[]): GatewayModel[];
+/**
+ * Ask the running gateway what it actually supports rather than trusting a
+ * static compatibility table. Every adapter's README section is generated from
+ * this, so users never get told a feature works when it does not.
+ */
+export declare function probeCapabilities(apiBase: string, apiKey: string, model: string, opts?: {
+    timeoutMs?: number;
+    include?: CapabilityCheck['id'][];
+}): Promise<CapabilityReport>;
+/** Single non-streaming chat call. Used by `connect --verify` and `doctor`. */
+export declare function testChat(apiBase: string, apiKey: string, model: string, prompt?: string): Promise<string>;
+//# sourceMappingURL=gateway.d.ts.map

package/dist/core/gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../src/core/gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGnF,sFAAsF;AACtF,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAKhG;AAMD;;;;;;GAMG;AACH,uEAAuE;AACvE,MAAM,MAAM,cAAc;AACxB,mEAAmE;AACjE,YAAY;AACd,8EAA8E;GAC5E,MAAM;AACR,8EAA8E;GAC5E,WAAW;AACb,6EAA6E;GAC3E,SAAS,CAAC;AAEd,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,cAAc,CAAC;CAChC;AAED,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAChC,OAAO,CAAC,YAAY,CAAC,CAiDvB;AAqBD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMlD;AAoBD;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAChC,OAAO,CAAC,YAAY,EAAE,CAAC,CAkBzB;AAkED,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAEjE;AAMD;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,eAAe,CAAC,IAAI,CAAC,EAAE,CAAA;CAAO,GACnE,OAAO,CAAC,gBAAgB,CAAC,CAmM3B;AAOD,+EAA+E;AAC/E,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,SAAmC,GACxC,OAAO,CAAC,MAAM,CAAC,CAWjB"}