@withbuddi/buddi 0.1.0-pre.41 → 0.1.0-pre.43

package/node_modules/@buddi/gateway/dist/plugins/index.js

@@ -29,4 +29,5 @@ export * from './dev.js';
 export * from './uninstall.js';
 export * from './provenance.js';
 export * from './toggle.js';
+export * from './pages-state.js';
 //# sourceMappingURL=index.js.map

package/node_modules/@buddi/gateway/dist/plugins/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC"}

package/node_modules/@buddi/gateway/dist/plugins/pages-state.d.ts

@@ -0,0 +1,37 @@
+export interface PagesState {
+    pid: number;
+    at: string;
+    /** The plugins whose pages `GET /api/pages` lists now, sorted. */
+    plugins: string[];
+}
+export declare function pagesStateFile(env?: NodeJS.ProcessEnv): string;
+/** The plugin names of every page a registry serves, each once, sorted. */
+export declare function pagePlugins(registry: {
+    pages(): ReadonlyArray<{
+        plugin: string;
+    }>;
+}): string[];
+/** Write what this process serves. Never throws: the doctor then says it could not tell. */
+export declare function writePagesState(env: NodeJS.ProcessEnv, registry: {
+    pages(): ReadonlyArray<{
+        plugin: string;
+    }>;
+}, now?: Date): void;
+/** A file older than this says nothing about the gateway running now. */
+export declare const PAGES_STATE_MAX_AGE_MS: number;
+/** When a process started, from `ps`; undefined when it cannot say. */
+export declare function processStartedAt(pid: number): Date | undefined;
+/**
+ * What the running gateway serves, or undefined when no live gateway wrote it.
+ *
+ * A pid alone is not enough: after a crash and a reboot the number can belong
+ * to any process. So the file is believed only when its writer is alive and
+ * ours, it is less than a day old, and it was written after that process
+ * started — a file from before the process with its pid began is somebody
+ * else's leftover.
+ */
+export declare function readPagesState(env?: NodeJS.ProcessEnv, options?: {
+    now?: Date;
+    startedAt?: (pid: number) => Date | undefined;
+}): PagesState | undefined;
+//# sourceMappingURL=pages-state.d.ts.map

package/node_modules/@buddi/gateway/dist/plugins/pages-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages-state.d.ts","sourceRoot":"","sources":["../../src/plugins/pages-state.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,kEAAkE;IAClE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAE3E;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,QAAQ,EAAE;IAAE,KAAK,IAAI,aAAa,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,GAAG,MAAM,EAAE,CAE9F;AAED,4FAA4F;AAC5F,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,QAAQ,EAAE;IAAE,KAAK,IAAI,aAAa,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,EACxD,GAAG,GAAE,IAAiB,GACrB,IAAI,CAWN;AAED,yEAAyE;AACzE,eAAO,MAAM,sBAAsB,QAAsB,CAAC;AAgB1D,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAQ9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,IAAI,CAAC;IAAC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS,CAAA;CAAO,GAC1E,UAAU,GAAG,SAAS,CAiBxB"}

package/node_modules/@buddi/gateway/dist/plugins/pages-state.js

@@ -0,0 +1,98 @@
+/**
+ * Which plugins have pages in the running gateway, written where `buddi
+ * doctor` can read it.
+ *
+ * The doctor runs in its own process: it can import what is installed, but
+ * only the gateway knows what it actually registered. A plugin installed while
+ * buddi runs (first run's chapter 3, the catalogue) is loaded live or waits for
+ * a restart, and "installed" and "its page is in the rail" are two answers the
+ * owner needs side by side. So the gateway writes the names whose pages it
+ * serves at start and whenever its registry changes; the doctor reads the file
+ * when the process that wrote it is still alive, and the file is that process's.
+ */
+import { execFileSync } from 'node:child_process';
+import { mkdirSync, readFileSync, renameSync, statSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { dataDir } from '../web/config.js';
+export function pagesStateFile(env = process.env) {
+    return path.join(dataDir(env), 'run', 'pages.json');
+}
+/** The plugin names of every page a registry serves, each once, sorted. */
+export function pagePlugins(registry) {
+    return [...new Set(registry.pages().map((p) => p.plugin))].sort();
+}
+/** Write what this process serves. Never throws: the doctor then says it could not tell. */
+export function writePagesState(env, registry, now = new Date()) {
+    try {
+        const file = pagesStateFile(env);
+        mkdirSync(path.dirname(file), { recursive: true });
+        const state = { pid: process.pid, at: now.toISOString(), plugins: pagePlugins(registry) };
+        const temp = `${file}.${process.pid}.tmp`;
+        writeFileSync(temp, `${JSON.stringify(state)}\n`, { mode: 0o600 });
+        renameSync(temp, file);
+    }
+    catch {
+        /* Not worth a start or a log line. */
+    }
+}
+/** A file older than this says nothing about the gateway running now. */
+export const PAGES_STATE_MAX_AGE_MS = 24 * 60 * 60 * 1000;
+/**
+ * Whether the pid is a live process this user owns. EPERM means a process of
+ * somebody else's holds the number now — never our gateway, which runs as the
+ * owner — so a reused pid is not taken for a live buddi.
+ */
+function alive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** When a process started, from `ps`; undefined when it cannot say. */
+export function processStartedAt(pid) {
+    try {
+        const out = execFileSync('ps', ['-o', 'lstart=', '-p', String(pid)], { encoding: 'utf8', timeout: 3_000, stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+        const at = out ? new Date(out) : undefined;
+        return at && Number.isFinite(at.getTime()) ? at : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * What the running gateway serves, or undefined when no live gateway wrote it.
+ *
+ * A pid alone is not enough: after a crash and a reboot the number can belong
+ * to any process. So the file is believed only when its writer is alive and
+ * ours, it is less than a day old, and it was written after that process
+ * started — a file from before the process with its pid began is somebody
+ * else's leftover.
+ */
+export function readPagesState(env = process.env, options = {}) {
+    try {
+        const file = pagesStateFile(env);
+        const parsed = JSON.parse(readFileSync(file, 'utf8'));
+        if (typeof parsed.pid !== 'number' || !Array.isArray(parsed.plugins) || typeof parsed.at !== 'string')
+            return undefined;
+        const now = (options.now ?? new Date()).getTime();
+        const at = Date.parse(parsed.at);
+        if (!Number.isFinite(at))
+            return undefined;
+        if (now - at > PAGES_STATE_MAX_AGE_MS || now - statSync(file).mtimeMs > PAGES_STATE_MAX_AGE_MS)
+            return undefined;
+        if (!alive(parsed.pid))
+            return undefined;
+        const started = (options.startedAt ?? processStartedAt)(parsed.pid);
+        // `ps` says when to the second; a file written in the same second counts.
+        if (started && at < started.getTime() - 1_000)
+            return undefined;
+        return { pid: parsed.pid, at: parsed.at, plugins: parsed.plugins.filter((p) => typeof p === 'string') };
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=pages-state.js.map

package/node_modules/@buddi/gateway/dist/plugins/pages-state.js.map

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

package/node_modules/@buddi/gateway/dist/provider-accounts.d.ts

@@ -1,5 +1,5 @@
 import { type AgentCatalog, type LoadAgentCatalogOptions, type ProviderAccountsAccess, type ProviderRef, type ResolvedProvider, type Vault } from '@buddi/core';
-import { listProviderModels, type AccountModels, type OllamaConnectProtocol, type RuntimeProvider } from '@buddi/runtime';
+import { listProviderModels, type AccountModels, type CompletionResponse, type OllamaConnectProtocol, type RuntimeProvider } from '@buddi/runtime';
 import type { Pool } from 'pg';
 import { type ProviderDiagnostic } from './provider-diagnostics.js';
 import { type AccountRateLimit } from './account-limits.js';
@@ -12,9 +12,22 @@ type Binding = {
     accountId: string;
     model: string;
 };
+/**
+ * One connection test: the sentence the owner reads, and what it was made of.
+ * `detail` is the provider's own words on a failure, scrubbed of the key and
+ * every stored secret — read only under Details, never as the sentence.
+ */
 type TestResult = ProviderDiagnostic & {
     checkedAt: string;
+    model?: string;
+    reply?: string;
+    elapsedMs?: number;
+    tokens?: number;
+    billing?: 'key' | 'plan' | null;
+    detail?: string | null;
 };
+/** The one prompt a connection test sends: short, fixed, no conversation, no tools. */
+export declare const READY_PROMPT = "Reply with the single word: ready";
 declare const legacy: readonly [{
     readonly id: "legacy-openai-api";
     readonly name: "OPENAI_API_KEY";
@@ -48,7 +61,8 @@ export declare class ProviderAccounts {
         catalog: () => AgentCatalog;
         reload: () => void;
         vault?: Vault;
-        test?: (resolved: ResolvedProvider) => Promise<void>;
+        /** Replaces the one ready prompt in tests: a recorded answer, or a recorded refusal thrown. */
+        test?: (resolved: ResolvedProvider) => Promise<CompletionResponse | void>;
         listModels?: typeof listProviderModels;
         /** mlxh's read-only probe, replaceable in tests. */
         probeMlxh?: typeof probeMlxh;
@@ -71,7 +85,8 @@ export declare class ProviderAccounts {
         catalog: () => AgentCatalog;
         reload: () => void;
         vault?: Vault;
-        test?: (resolved: ResolvedProvider) => Promise<void>;
+        /** Replaces the one ready prompt in tests: a recorded answer, or a recorded refusal thrown. */
+        test?: (resolved: ResolvedProvider) => Promise<CompletionResponse | void>;
         listModels?: typeof listProviderModels;
         /** mlxh's read-only probe, replaceable in tests. */
         probeMlxh?: typeof probeMlxh;
@@ -157,7 +172,15 @@ export declare class ProviderAccounts {
     rateLimit(id: string): AccountRateLimit | null;
     /** Pins account identity/model for a run; disabling stops its next model call. */
     provider(ref: ProviderRef): RuntimeProvider;
-    test(id: string): Promise<TestResult>;
+    /**
+     * Test an account. `reuseWithinMs` is the route's cooldown: a result this
+     * recent, for the account as it stands, is answered again rather than
+     * spending another call on the provider.
+     */
+    test(id: string, options?: {
+        reuseWithinMs?: number;
+        now?: number;
+    }): Promise<TestResult>;
     /**
      * What a plugin sees (`CoreToolContext.providerAccounts`): the listing, an HTTP
      * account resolved as a run resolves it, and a Codex account's profile
@@ -214,5 +237,11 @@ export declare class ProviderAccounts {
         cancelled?: undefined;
     }>;
 }
+/**
+ * The sentence for a test that got an answer: what was asked, what came back,
+ * how long it took and roughly what it cost. A reasoning model may spend its
+ * five tokens thinking and say nothing; the account still works.
+ */
+export declare function readyAnswer(model: string, answer: CompletionResponse | undefined, elapsedMs: number, billing: 'key' | 'plan' | null, secret?: string | null): Omit<TestResult, 'checkedAt'>;
 export {};
 //# sourceMappingURL=provider-accounts.d.ts.map

package/node_modules/@buddi/gateway/dist/provider-accounts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider-accounts.d.ts","sourceRoot":"","sources":["../src/provider-accounts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"provider-accounts.d.ts","sourceRoot":"","sources":["../src/provider-accounts.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAAwB,KAAK,sBAAsB,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,KAAK,EACrI,MAAM,aAAa,CAAC;AACrB,OAAO,EAA6D,kBAAkB,EAAwC,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAE,KAAK,qBAAqB,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACpP,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAE/B,OAAO,EAA8C,KAAK,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAChH,OAAO,EAAiF,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC3I,OAAO,EAAE,aAAa,EAA2B,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAgC,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE3G,OAAO,EAA2B,SAAS,EAAE,MAAM,WAAW,CAAC;AAsB/D,KAAK,OAAO,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AACrE;;;;GAIG;AACH,KAAK,UAAU,GAAG,kBAAkB,GAAG;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,CAAC;AACF,uFAAuF;AACvF,eAAO,MAAM,YAAY,sCAAsC,CAAC;AA0BhE,QAAA,MAAM,MAAM;;;;;;EAEF,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,aAAa,EAAE,CAErF;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CACrD;AAED,qFAAqF;AACrF,qBAAa,gBAAgB;;IAsBf,QAAQ,CAAC,IAAI,EAAE;QACzB,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;QAC9D,OAAO,EAAE,MAAM,YAAY,CAAC;QAAC,MAAM,EAAE,MAAM,IAAI,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAC;QAC/D,+FAA+F;QAC/F,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;QAC1E,UAAU,CAAC,EAAE,OAAO,kBAAkB,CAAC;QACvC,oDAAoD;QACpD,SAAS,CAAC,EAAE,OAAO,SAAS,CAAC;QAC7B,+EAA+E;QAC/E,MAAM,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,qBAAqB,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC;YAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;SAAE,CAAC;KAC9F;IA/BD,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CAAC;IAgB5C,0FAA0F;IAC1F,QAAQ,CAAC,YAAY,EAAE,KAAK,GAAG,SAAS,CAAC;gBACpB,IAAI,EAAE;QACzB,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;QAC9D,OAAO,EAAE,MAAM,YAAY,CAAC;QAAC,MAAM,EAAE,MAAM,IAAI,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAC;QAC/D,+FAA+F;QAC/F,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;QAC1E,UAAU,CAAC,EAAE,OAAO,kBAAkB,CAAC;QACvC,oDAAoD;QACpD,SAAS,CAAC,EAAE,OAAO,SAAS,CAAC;QAC7B,+EAA+E;QAC/E,MAAM,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,qBAAqB,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC;YAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;SAAE,CAAC;KAC9F;IAyBD,IAAI,qBAAqB,YAA4E;IAE/F,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAiD3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmC3B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAUxB,SAAS,EAAE,WAAW,CAAC,uBAAuB,CAAC,mBAAmB,CAAC,CAAC,CAelE;IAEF,IAAI,CAAC,YAAY,CAAC,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yCAkB8D,UAAU,GAAG,OAAO,GAAG,MAAM;;;;;;;;;;;;;;;;IAwB/G,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,UAAQ,GAAG,OAAO,CAAC,aAAa,CAAC;IAkFjE;;;;;;;OAOG;IACG,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC;IAgBxD,IAAI,CAAC,IAAI,EAAE,OAAO;;;;IA6ElB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;;;;IAkBrC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;;;IAiCnC,wEAAwE;IACxE,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAwB9C,kFAAkF;IAClF,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,eAAe;IAqC3C;;;;OAIG;IACG,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAkCnG;;;;OAIG;IACH,YAAY,IAAI,sBAAsB;IA0HtC,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,gBAAgB,GAAG,cAAc,GAAG,QAAQ,EAAE,IAAI,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,KAAK,EAAE,MAAM;;;;;;;;IA2B5K;;;;;OAKG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,YAAY,EAAE,IAAI,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,KAAK,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;IAgFpI,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,cAAc,GAAG,QAAQ,EAAE,QAAQ,EAAE,OAAO;;;;;;;CA+BvF;AAqBD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,EAAE,MAAM,GAAE,MAAM,GAAG,IAAW,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAcjM"}

package/node_modules/@buddi/gateway/dist/provider-accounts.js

@@ -1,6 +1,6 @@
 import { randomUUID } from 'node:crypto';
 import { setTimeout as delay } from 'node:timers/promises';
-import { GEMINI_BASE_URL, GEMINI_KEY_URL, MLXH_DEFAULT_MAX_PROMPT_TOKENS, OLLAMA_CLOUD_ACCOUNT_URL, isMlxhAccount, accountBaseUrl, accountModelProblem, accountProtocol, createVault, providerFromEnv, putOwnerSecret, registerSecretDestination, resolveProviderAccount, useOwnerSecret, vaultState, } from '@buddi/core';
+import { GEMINI_BASE_URL, GEMINI_KEY_URL, MLXH_DEFAULT_MAX_PROMPT_TOKENS, OLLAMA_CLOUD_ACCOUNT_URL, isMlxhAccount, accountBaseUrl, accountModelProblem, accountProtocol, createVault, providerFromEnv, putOwnerSecret, registerSecretDestination, scrubText, scrubValueFrom, resolveProviderAccount, useOwnerSecret, vaultState, } from '@buddi/core';
 import { contextWindowTokens, createProvider, providerCapabilities, listProviderModels, readAnthropicTokens, readCodexTokens } from '@buddi/runtime';
 import { z } from 'zod';
 import { providerDiagnostic } from './provider-diagnostics.js';
@@ -26,6 +26,8 @@ function reportedWindow(map, model) {
     const tokens = map && Object.hasOwn(map, model) ? map[model] : undefined;
     return typeof tokens === 'number' && Number.isInteger(tokens) && tokens >= 8_000 && tokens <= 2_000_000 ? tokens : undefined;
 }
+/** The one prompt a connection test sends: short, fixed, no conversation, no tools. */
+export const READY_PROMPT = 'Reply with the single word: ready';
 const columns = `id, label, kind, auth, base_url as "baseUrl", default_model as "defaultModel",
   context_window_tokens as "contextWindowTokens", reported_context_windows as "reportedContextWindows",
   enabled, deleting, revision, secret_ref as "secretRef", legacy_env as "legacyEnv"`;
@@ -88,6 +90,8 @@ export class ProviderAccounts {
     #bindings = new Map();
     #configured = new Map();
     #tests = new Map();
+    /** The account revision each kept test result was made against. */
+    #testedRevision = new Map();
     #testing = new Set();
     /** Limits a provider set on an account, as of the last load or call. */
     #limits = new Map();
@@ -325,6 +329,7 @@ export class ProviderAccounts {
                 const current = await this.#row(id);
                 if (current.revision !== row.revision || !current.enabled || current.deleting)
                     throw new ProviderAccountError(409, 'Account changed. Refresh models again.');
+                value = { ...value, fetchedAt: new Date().toISOString() };
                 this.#modelLists.set(id, { revision: row.revision, until: Date.now() + 60_000, value });
                 await this.#rememberWindows(current, value).catch(() => { });
                 return value;
@@ -680,38 +685,50 @@ export class ProviderAccounts {
             },
         };
     }
-    async test(id) {
+    /**
+     * Test an account. `reuseWithinMs` is the route's cooldown: a result this
+     * recent, for the account as it stands, is answered again rather than
+     * spending another call on the provider.
+     */
+    async test(id, options = {}) {
         if (this.#testing.has(id))
             throw new ProviderAccountError(409, 'A connection test is already running for this account.');
         this.#testing.add(id);
         try {
             const row = await this.#row(id);
+            const recent = this.#tests.get(id);
+            if (recent && options.reuseWithinMs && this.#testedRevision.get(id) === row.revision
+                && (options.now ?? Date.now()) - Date.parse(recent.checkedAt) < options.reuseWithinMs)
+                return recent;
             if (row.kind === 'codex')
                 throw new ProviderAccountError(400, 'A ChatGPT subscription has no output-token cap for a connection test. Connect and send a test chat instead.');
-            let diagnostic = { state: 'connected', message: 'Connection succeeded.', httpStatus: null, retryAt: null };
+            let result;
+            let secret = null;
+            const billing = testBilling(row);
             try {
-                const resolved = resolveProviderAccount(row, row.defaultModel, await this.#usableSecret(row));
-                if (this.deps.test)
-                    await this.deps.test(resolved);
-                else
-                    await createProvider(resolved, { maxTokens: 32, maxStatusRetries: 0 }).complete({
-                        system: 'Reply with OK.', messages: [{ role: 'user', content: [{ type: 'text', text: 'Connection test. Reply OK.' }] }],
-                        // A model on this computer loads on its first request, which can take
-                        // a minute for a large one; a hosted provider answers in seconds or not at all.
-                        tools: [], signal: AbortSignal.timeout(isLocalAccount(row) ? 120_000 : 15_000),
-                    });
+                secret = await this.#usableSecret(row);
+                const resolved = resolveProviderAccount(row, row.defaultModel, secret);
+                const started = performance.now();
+                const answer = this.deps.test ? await this.deps.test(resolved) : await createProvider(resolved, { maxTokens: 5, maxStatusRetries: 0 }).complete({
+                    system: 'You are checking that a connection works.', messages: [{ role: 'user', content: [{ type: 'text', text: READY_PROMPT }] }],
+                    // A model on this computer loads on its first request, which can take
+                    // a minute for a large one; a hosted provider answers in seconds or not at all.
+                    tools: [], signal: AbortSignal.timeout(isLocalAccount(row) ? 120_000 : 15_000),
+                });
+                result = readyAnswer(row.defaultModel, answer ?? undefined, Math.round(performance.now() - started), billing, secret);
             }
             catch (error) {
-                diagnostic = providerDiagnostic(error, { ...diagnosticContext(row), model: row.defaultModel });
+                result = { ...providerDiagnostic(error, { ...diagnosticContext(row), model: row.defaultModel }), model: row.defaultModel, detail: errorDetail(error, secret) };
                 await this.#noteLimit(id, error);
             }
-            if (diagnostic.state === 'connected')
+            if (result.state === 'connected')
                 await this.#noteLimit(id, null);
             if ((await this.#row(id)).revision !== row.revision)
                 throw new ProviderAccountError(409, 'Account changed during the test. Test it again.');
-            const result = { ...diagnostic, checkedAt: new Date().toISOString() };
-            this.#tests.set(id, result);
-            return result;
+            const tested = { ...result, checkedAt: new Date().toISOString() };
+            this.#tests.set(id, tested);
+            this.#testedRevision.set(id, row.revision);
+            return tested;
         }
         finally {
             this.#testing.delete(id);
@@ -1095,6 +1112,52 @@ export class ProviderAccounts {
 function logRetry(notice) {
     console.error(`provider: ${notice.kind} attempt ${notice.attempt} failed, retrying in ${notice.delayMs}ms — ${notice.detail}`);
 }
+/** Who pays for a test call, when buddi knows: a key bills itself, a sign-in uses the plan. */
+function testBilling(row) {
+    if (row.auth === 'anthropic-oauth' || row.auth === 'device-key' || row.auth === 'chatgpt')
+        return 'plan';
+    if (row.auth === 'api-key' && !isLocalAccount(row))
+        return 'key';
+    return null;
+}
+/** "1.4 s": one decimal under ten seconds, whole seconds after. */
+function seconds(ms) {
+    const s = ms / 1000;
+    return s < 10 ? `${s.toFixed(1)} s` : `${Math.round(s)} s`;
+}
+/**
+ * The sentence for a test that got an answer: what was asked, what came back,
+ * how long it took and roughly what it cost. A reasoning model may spend its
+ * five tokens thinking and say nothing; the account still works.
+ */
+export function readyAnswer(model, answer, elapsedMs, billing, secret = null) {
+    // Scrubbed whole, before it is cut: a credential echoed across the cut would
+    // otherwise leave its first characters on the screen.
+    const raw = (answer?.content ?? []).map((b) => (b.type === 'text' ? b.text : '')).join('');
+    const text = scrubbed(raw, secret).replace(/\s+/g, ' ').trim().slice(0, 40);
+    const u = answer?.usage;
+    const tokens = u ? u.input + u.output + (u.cacheRead ?? 0) + (u.cacheWrite ?? 0) : undefined;
+    const said = text ? `it said ‘${text}’ in ${seconds(elapsedMs)}` : `it answered in ${seconds(elapsedMs)}, with no words inside the five-token limit`;
+    const cost = tokens ? ` · about ${tokens} tokens` : '';
+    const who = billing === 'key' ? ', billed to this key' : billing === 'plan' ? ', on your plan' : '';
+    return {
+        state: 'connected', message: `Asked ${model} to say ready → ${said}${cost}${tokens ? who : ''}.`,
+        httpStatus: null, retryAt: null, model, reply: text, elapsedMs, ...(tokens !== undefined ? { tokens } : {}), billing,
+    };
+}
+/** The provider's own words for Details: the key and every stored secret scrubbed out, kept short. */
+function errorDetail(error, secret) {
+    const raw = error instanceof Error ? error.message : typeof error === 'string' ? error : '';
+    if (!raw)
+        return null;
+    const text = scrubbed(raw, secret).replace(/\s+/g, ' ').trim();
+    return text.length > 300 ? `${text.slice(0, 299)}…` : text;
+}
+/** A provider's text with the account's credential, every stored secret and anything key-shaped taken out. */
+function scrubbed(raw, secret) {
+    const text = secret ? scrubValueFrom(secret, 'key', raw).text : raw;
+    return scrubText(text).replace(/\b(sk|sk-ant|AIza|ghp|xox[abp])[-_A-Za-z0-9]{12,}/g, '‹key›');
+}
 function isLocalAccount(row) {
     if (row.kind !== 'openai-compatible' || !row.baseUrl)
         return false;