@mono-agent/agent-app 0.20.11 → 0.21.0

package/dist/provider-auth-status.js

@@ -0,0 +1,235 @@
+import { checkPiProviderAuth, describePiProviderAuth, } from "@mono-agent/agent-runtime/ai";
+import { modelReferenceKey, parseMonoRuntimeModelReference, } from "@mono-agent/runtime-adapter";
+import { inspectPiAuthStore } from "./pi-auth-store-inspection.js";
+import { configuredRuntimeModels } from "./runtime-routes.js";
+export async function collectUsedProviderReferences(config, drivers, input) {
+    const refs = configuredRuntimeModels(config.runtime).map((ref, index) => ({
+        ref,
+        usage: {
+            kind: index === 0 ? "primary" : "fallback",
+            model: modelReferenceKey(ref),
+            label: index === 0 ? "Primary model" : `Fallback ${index}`,
+        },
+    }));
+    if (config.memory?.llm?.provider === "agent-host") {
+        try {
+            const ref = parseMonoRuntimeModelReference(config.memory.llm.model);
+            refs.push({ ref, usage: { kind: "memory_llm", model: modelReferenceKey(ref), label: "Memory LLM" } });
+        }
+        catch {
+            // The existing memory validation owns malformed model-reference errors.
+        }
+    }
+    for (const driver of drivers) {
+        if (driver.id !== "cron" && driver.id !== "webhook")
+            continue;
+        let loaded;
+        try {
+            loaded = await driver.loadConfig(input);
+        }
+        catch {
+            continue;
+        }
+        if (!record(loaded) || (driver.id === "webhook" && loaded.enabled === false))
+            continue;
+        const entries = driver.id === "cron" ? loaded.jobs : loaded.endpoints;
+        if (!Array.isArray(entries))
+            continue;
+        for (let index = 0; index < entries.length; index += 1) {
+            const entry = entries[index];
+            if (!record(entry) || entry.enabled === false || typeof entry.model !== "string")
+                continue;
+            try {
+                const ref = parseMonoRuntimeModelReference(entry.model);
+                refs.push({
+                    ref,
+                    usage: {
+                        kind: driver.id,
+                        model: modelReferenceKey(ref),
+                        label: `${driver.id}.${driver.id === "cron" ? "jobs" : "endpoints"}[${index}]`,
+                    },
+                });
+            }
+            catch {
+                // The channel config validation owns malformed model-reference errors.
+            }
+        }
+    }
+    const seen = new Set();
+    return refs.filter(({ usage }) => {
+        const key = `${usage.kind}\0${usage.label}\0${usage.model}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+export async function providerAuthStatusSnapshot(options) {
+    const used = await collectUsedProviderReferences(options.config, options.drivers, options.input);
+    const byProvider = new Map();
+    for (const item of used) {
+        const providerId = item.ref.provider;
+        const current = byProvider.get(providerId) ?? { refs: [], usages: [] };
+        current.refs.push(item.ref);
+        current.usages.push(item.usage);
+        byProvider.set(providerId, current);
+    }
+    options.observations.retainProviders([...byProvider.keys()]);
+    const authPath = options.config.providers?.piAuthPath;
+    const inspection = authPath === undefined ? { status: "missing" } : await inspectPiAuthStore(authPath);
+    const localById = new Map((options.config.providers?.local ?? []).map((provider) => [provider.id, provider]));
+    const providers = [];
+    for (const [providerId, group] of byProvider) {
+        const observation = options.observations.get(providerId);
+        const local = localById.get(providerId);
+        if (local !== undefined) {
+            const keyInEnv = local.apiKeyEnv !== undefined && nonEmpty(options.env[local.apiKeyEnv]);
+            const hasKey = keyInEnv || nonEmpty(local.apiKey);
+            const keyless = local.apiKeyEnv === undefined && local.apiKey === undefined;
+            const state = keyless ? "not_applicable" : hasKey ? "present" : "missing";
+            const verifiedAt = state === "present" ? observation?.verifiedAt : undefined;
+            providers.push({
+                providerId,
+                label: providerId,
+                usages: group.usages,
+                state,
+                ...(keyless ? {} : { credentialType: "api_key" }),
+                ...(hasKey ? { source: keyInEnv ? "environment" : "config" } : {}),
+                verification: keyless ? "not_applicable" : verifiedAt === undefined ? "not_verified" : "verified_by_live_request",
+                ...(verifiedAt === undefined ? {} : { verifiedAt }),
+                methods: [],
+                ...(local.enabled === false
+                    ? { unavailableReason: "Provider is disabled in providers.local." }
+                    : keyless ? { unavailableReason: "Keyless local provider." }
+                        : !hasKey ? { unavailableReason: `Set ${local.apiKeyEnv ?? "the configured API key"} in agent configuration.` } : {}),
+                ...(observation?.failure === undefined ? {} : { lastFailure: observation.failure }),
+            });
+            continue;
+        }
+        const description = describePiProviderAuth(providerId);
+        const entry = inspection.status === "ok" ? inspection.auth[providerId] : undefined;
+        let state = "missing";
+        let credentialType;
+        let source;
+        let expiresAt;
+        let unavailableReason;
+        if (description === undefined || description.methods.length === 0) {
+            state = "not_applicable";
+            unavailableReason = "This provider does not expose an authentication method through Pi.";
+        }
+        else {
+            const storedType = record(entry) && (entry.type === "oauth" || entry.type === "api_key")
+                ? entry.type : undefined;
+            const hasStoredEntry = inspection.status === "ok" && entry !== undefined;
+            if (inspection.status === "unsafe") {
+                unavailableReason = `Pi auth store is unsafe (${inspection.reason}).`;
+            }
+            else if (hasStoredEntry && storedType === undefined) {
+                unavailableReason = "Stored credential type is not supported by this provider.";
+            }
+            else if (storedType !== undefined && !description.methods.some((method) => method.type === storedType)) {
+                state = "missing";
+                credentialType = storedType;
+                unavailableReason = "Stored credential type is not supported by this provider.";
+            }
+            else if (record(entry) && entry.type === "oauth") {
+                credentialType = "oauth";
+                source = "stored";
+                if (!nonEmpty(entry.access) && !nonEmpty(entry.refresh)) {
+                    state = "missing";
+                    unavailableReason = "Stored OAuth credential is unusable.";
+                }
+                else if (entry.expires !== undefined && isoFromEpochMillis(entry.expires) === undefined) {
+                    state = "missing";
+                    unavailableReason = "Stored OAuth credential has an invalid expiry.";
+                }
+                else if (typeof entry.expires === "number") {
+                    expiresAt = isoFromEpochMillis(entry.expires);
+                    state = entry.expires < Date.now() && !nonEmpty(entry.refresh) ? "expired" : "present";
+                }
+                else {
+                    state = "present";
+                }
+            }
+            else {
+                const checked = await checkPiProviderAuth(providerId, inspection.status === "ok" ? entry : undefined, options.env).catch(() => undefined);
+                if (checked !== undefined && checked.source !== "ambient") {
+                    credentialType = checked.type;
+                    source = checked.source;
+                    state = "present";
+                }
+                else if (checked?.source === "ambient") {
+                    unavailableReason = "Ambient credential evidence cannot establish a usable credential.";
+                }
+                else if (record(entry) && entry.type === "api_key") {
+                    state = "missing";
+                    credentialType = "api_key";
+                    unavailableReason = "Stored API-key credential is unusable.";
+                }
+            }
+            if (record(entry) && entry.type === "api_key" && state === "missing" && unavailableReason === undefined) {
+                credentialType = "api_key";
+                unavailableReason = "Stored API-key credential is unusable.";
+            }
+        }
+        const verifiedAt = state === "present" ? observation?.verifiedAt : undefined;
+        providers.push({
+            providerId,
+            label: description?.label ?? providerId,
+            usages: group.usages,
+            state,
+            ...(credentialType === undefined ? {} : { credentialType }),
+            ...(source === undefined ? {} : { source }),
+            ...(expiresAt === undefined ? {} : { expiresAt }),
+            verification: state === "not_applicable" ? "not_applicable"
+                : verifiedAt === undefined ? "not_verified" : "verified_by_live_request",
+            ...(verifiedAt === undefined ? {} : { verifiedAt }),
+            methods: description === undefined ? [] : methodsFor(providerId, description.methods),
+            ...(unavailableReason === undefined ? {} : { unavailableReason }),
+            ...(observation?.failure === undefined ? {} : { lastFailure: observation.failure }),
+        });
+    }
+    return {
+        schema: "mono-agent.provider-auth.v1",
+        generatedAt: new Date().toISOString(),
+        providers,
+    };
+}
+function methodsFor(providerId, methods) {
+    const result = [];
+    for (const method of methods) {
+        if (method.type === "api_key") {
+            result.push({ authType: method.type, strategy: "api_key_prompt", label: method.label, recommended: methods.length === 1 });
+        }
+        else if (providerId === "openai-codex") {
+            result.push({ authType: method.type, strategy: "device_code", label: `${method.label} (device code)`, recommended: true }, { authType: method.type, strategy: "paste_back", label: `${method.label} (paste redirect)`, recommended: false });
+        }
+        else if (providerId === "github-copilot") {
+            result.push({ authType: method.type, strategy: "device_code", label: method.label, recommended: true });
+        }
+        else if (providerId === "anthropic") {
+            result.push({ authType: method.type, strategy: "paste_back", label: method.label, recommended: true });
+        }
+        else {
+            result.push({ authType: method.type, strategy: "provider_prompt", label: method.label, recommended: methods.length === 1 });
+        }
+    }
+    return result;
+}
+function record(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function nonEmpty(value) {
+    return typeof value === "string" && value.trim().length > 0 && value.length <= 65_536 && !value.includes("\0");
+}
+function isoFromEpochMillis(value) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return undefined;
+    try {
+        return new Date(value).toISOString();
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=provider-auth-status.js.map

package/dist/provider-auth-status.js.map

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

package/dist/provider-model-catalog.d.ts

@@ -0,0 +1,95 @@
+import type { TuiCatalogModel, TuiModelOption, TuiProviderInfo } from "@mono-agent/operator-adapter";
+import { type PiBuiltinModelSnapshot } from "@mono-agent/agent-runtime";
+import type { DiscoveredLocalModel, LocalProviderDefinition, ProviderDefinition, RuntimeModelReference } from "@mono-agent/runtime-adapter";
+export declare const DEFAULT_PAGE_SIZE = 100;
+export declare const MAX_PAGE_SIZE = 200;
+/**
+ * Producer-side length bounds for the CATALOG's own projections
+ * (`listProviders`/`listModels`/`searchModels`). Provider ids, model
+ * ids and display names are not length-bounded by config validation, and both
+ * `/v1/info` and a `/v1/models` page have a body cap to respect: an over-cap
+ * `/v1/models` page 500s instead of serving, and an over-cap `/v1/info` body
+ * costs the console a whole field at `sendBoundedInfo`'s fence. Oversized
+ * entries are skipped rather than truncated, because a truncated id would not
+ * resolve anyway.
+ *
+ * These are display/paging bounds, NOT validity bounds, and that distinction is
+ * the whole reason they are safe to keep. The runtime reference parser bounds a
+ * reference's CONTENT (no control or formatting code points) and deliberately
+ * not its length — what a model may be called is decided by providers, and two
+ * attempts at a ceiling each refused a model that really exists. So an id past
+ * `MAX_CATALOG_ID_BYTES` is something a local `/v1/models` can genuinely report
+ * and this filter genuinely cuts. Cutting it HERE costs a page one row; cutting
+ * it at the parser would have cost an operator a route that runs.
+ *
+ * `/v1/info.models` deliberately does not inherit them (see the `/v1/info`
+ * budget note in `channel-drivers/tui.ts`) — reusing them there deleted runnable
+ * models from schema-1 clients at a wire schema that cannot be bumped. The TUI
+ * has no `/v1/models` call site at all, so a model this filter drops is still
+ * selectable in the picker; `tui-channel.test.ts` pins that divergence.
+ *
+ * PROVIDER ids and labels are bounded by the shared wire contract instead
+ * (`MAX_INFO_PROVIDER_ID_BYTES`/`..._LABEL_BYTES` in `@mono-agent/agent-contracts`),
+ * because `/v1/info.providers` has a consumer that enforces its own copy of the
+ * same numbers. A local bound here and a local bound there is how a 129-byte
+ * provider id came to be published by this catalog and discarded by the
+ * console. Model ids have no such second enforcer and keep the local bound.
+ */
+export declare const MAX_CATALOG_ID_BYTES = 256;
+export declare const MAX_CATALOG_LABEL_BYTES = 256;
+export declare const DEFAULT_MAX_ADVERTISED_PER_PROVIDER = 100;
+export declare const MAX_SEARCH_RESULTS = 100;
+export interface ProviderModelCatalogInput {
+    /** Configured provider definitions (the canonical `providers.entries` map). */
+    readonly providers?: readonly ProviderDefinition[];
+    /** Local-provider projection used for precise effort/context resolution. */
+    readonly localProviders?: readonly LocalProviderDefinition[];
+    /** Configured runtime routes (primary + fallbacks). */
+    readonly configuredRoutes?: readonly RuntimeModelReference[];
+    /** Live-discovered local models (TUI path only; Slack/Telegram pass none). */
+    readonly discoveredModels?: readonly DiscoveredLocalModel[];
+    /** Test seam: replaces the Pi built-in model listing call. */
+    readonly listBuiltinModels?: (providerId: string) => readonly PiBuiltinModelSnapshot[];
+}
+export interface ProviderModelCatalog {
+    /** Whether native local metadata proves this route cannot generate chat. */
+    isEmbeddingOnly(ref: RuntimeModelReference): boolean;
+    /** Eager, frozen, deterministic provider list. Never throws. */
+    listProviders(): readonly TuiProviderInfo[];
+    listModels(providerId: string, options?: {
+        readonly cursor?: string;
+        readonly limit?: number;
+    }): {
+        readonly models: readonly TuiCatalogModel[];
+        readonly nextCursor?: string;
+        readonly truncated: boolean;
+    };
+    searchModels(query: string, limit?: number): readonly TuiCatalogModel[];
+    /** Effort/context/provider metadata for the configured-route shortlist. */
+    describe(refs: readonly RuntimeModelReference[]): Record<string, TuiModelOption>;
+}
+export interface ProviderAuthCheckModelSelection {
+    readonly kind: "selected";
+    readonly model: RuntimeModelReference;
+    readonly selectionBasis: "catalog_pricing" | "subscription_zero_price" | "sole_candidate_unknown_price";
+}
+export interface ProviderAuthCheckModelUnavailable {
+    readonly kind: "unavailable";
+    readonly code: "provider_unsupported" | "no_eligible_model" | "pricing_unavailable";
+    readonly message: string;
+}
+/**
+ * Select one cheapest text-generation model without network discovery. Missing
+ * prices are deliberately incomparable unless there is exactly one candidate.
+ */
+export declare function selectProviderAuthCheckModel(providerId: string, input?: Pick<ProviderModelCatalogInput, "providers" | "configuredRoutes" | "listBuiltinModels">): ProviderAuthCheckModelSelection | ProviderAuthCheckModelUnavailable;
+/**
+ * Build the provider-widened model catalog once at channel start. The catalog
+ * is total by construction: an unknown provider yields an empty page, a
+ * built-in listing that throws degrades to zero models, and no code path
+ * propagates. Everything is precomputed here so `/v1/info` reads memory only
+ * and never awaits network I/O, and the lazy `/v1/models` endpoint only slices
+ * already-frozen pages.
+ */
+export declare function buildProviderModelCatalog(input?: ProviderModelCatalogInput): ProviderModelCatalog;
+//# sourceMappingURL=provider-model-catalog.d.ts.map

package/dist/provider-model-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-model-catalog.d.ts","sourceRoot":"","sources":["../src/provider-model-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,eAAe,EAChB,MAAM,8BAA8B,CAAC;AAKtC,OAAO,EAIL,KAAK,sBAAsB,EAC5B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EACV,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,6BAA6B,CAAC;AAOrC,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,aAAa,MAAM,CAAC;AACjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAqB3C,eAAO,MAAM,mCAAmC,MAAM,CAAC;AACvD,eAAO,MAAM,kBAAkB,MAAM,CAAC;AA+BtC,MAAM,WAAW,yBAAyB;IACxC,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACnD,4EAA4E;IAC5E,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC7D,uDAAuD;IACvD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC7D,8EAA8E;IAC9E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC5D,8DAA8D;IAC9D,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,SAAS,sBAAsB,EAAE,CAAC;CACxF;AAED,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,eAAe,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC;IACrD,gEAAgE;IAChE,aAAa,IAAI,SAAS,eAAe,EAAE,CAAC;IAC5C,UAAU,CACR,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9D;QACD,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;QAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;KAC7B,CAAC;IACF,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,eAAe,EAAE,CAAC;IACxE,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,SAAS,qBAAqB,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAClF;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;IACtC,QAAQ,CAAC,cAAc,EAAE,iBAAiB,GAAG,yBAAyB,GAAG,8BAA8B,CAAC;CACzG;AAED,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,sBAAsB,GAAG,mBAAmB,GAAG,qBAAqB,CAAC;IACpF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,EAClB,KAAK,GAAE,IAAI,CAAC,yBAAyB,EAAE,WAAW,GAAG,kBAAkB,GAAG,mBAAmB,CAAM,GAClG,+BAA+B,GAAG,iCAAiC,CA2ErE;AA8BD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,GAAE,yBAA8B,GACpC,oBAAoB,CA0WtB"}