anypick 1.0.0 → 1.1.0

package/dist/clients/codex.d.ts

@@ -1,181 +0,0 @@
-import type { ClientAdapter, ModelCatalogDescriptor } from '../types.js';
-/**
- * Live-config block: the single active AnyPick route, published into the user's
- * base ~/.codex/config.toml so plain `codex` (and the desktop app, where it
- * honors config) routes through the proxy/gateway without a `--profile` flag.
- * Distinct from the legacy per-install managed block so reset() can strip them
- * separately.
- *
- * Split into two markers because TOML scopes keys by position: a bare key after
- * a `[table]` header belongs to that table. Root keys must therefore be written
- * above the first table header, while the provider table goes at EOF.
- *
- * When a proxy/gateway is active the live root block *takes over* top-level
- * `model_provider` (and `model` when known). The user's previous values are
- * stashed beside the catalog and restored on native account / reset / clear.
- */
-export declare const LIVE_BEGIN = "# >>> anypick:live";
-export declare const LIVE_END = "# <<< anypick:live";
-export declare const LIVE_PROVIDER_BEGIN = "# >>> anypick:provider";
-export declare const LIVE_PROVIDER_END = "# <<< anypick:provider";
-/** Top-level keys AnyPick takes over while a routed source is active. */
-export declare const LIVE_TAKEOVER_KEYS: readonly ['model', 'model_provider'];
-export type LiveTakeoverKey = (typeof LIVE_TAKEOVER_KEYS)[number];
-export interface CodexCatalogModel extends Omit<ModelCatalogDescriptor, 'id'> {
-    slug: string;
-}
-export declare function configTomlPath(home?: string): string;
-export declare function codexLiveCatalogPath(home?: string): string;
-/** Sidecar: user's top-level model/model_provider before AnyPick takeover. */
-export declare function codexUserDefaultsStashPath(home?: string): string;
-/**
- * Whether Codex live config is in routed (proxy/gateway/hub) or native mode.
- * Proxy lifecycle re-sync must not re-publish while the user is on a native
- * Codex account.
- */
-export declare function codexLiveModePath(home?: string): string;
-/**
- * Last explicitly published live route (gateway, or a sticky override). Used
- * when no hub route / running proxy is available but mode is still routed.
- */
-export declare function codexLiveRoutePath(home?: string): string;
-export type CodexLiveMode = 'routed' | 'native';
-export interface CodexUserDefaultsStash {
-    version: 1;
-    /** Absent key → user had no top-level entry (restore must not invent one). */
-    model?: string;
-    model_provider?: string;
-    /** True when the key existed; false/omitted when it did not. */
-    had_model: boolean;
-    had_model_provider: boolean;
-}
-export interface StoredLiveRoute {
-    version: 1;
-    source: string;
-    endpoint: string;
-    token: string;
-    defaultModel?: string;
-}
-/**
- * Codex custom providers are global within one config layer. Derive a stable,
- * source-specific ID so a Grok proxy, Gemini proxy, and arbitrary gateway can
- * coexist without taking over one another's provider configuration.
- */
-export declare function codexProfileName(sourceName: string): string;
-/**
- * Codex CLI client adapter (API runtime, not ChatGPT auth files).
- *
- * Persistent: one source-specific Codex profile + source-specific environment
- * file. Ephemeral: isolated CODEX_HOME / HOME with the same profile selected.
- */
-export declare function createCodexClient(home?: string): ClientAdapter;
-/**
- * Build the subset of Codex's model catalog schema needed for custom gateway
- * models. Required client-side fields use conservative values. Provider
- * capabilities and limits are only enabled when an authoritative descriptor
- * supplied them.
- *
- * `provider` must match the `model_providers.<id>` key: Desktop and recent CLI
- * builds bind catalog entries to a provider, and without it custom models are
- * filtered out of the picker (only stock GPT ids remain visible).
- */
-export declare function buildCodexModelCatalog(models: readonly CodexCatalogModel[], opts?: {
-    provider?: string;
-}): Record<string, unknown>;
-/** A single active route to publish into the user's base Codex config. */
-export interface LiveCodexProvider {
-    /** Human label, e.g. the Proxy Hub name or `proxy:<provider>/<account>`. */
-    source: string;
-    endpoint: string;
-    /** Per-instance Proxy Hub route / proxy secret (ADR 0006). */
-    token: string;
-    defaultModel?: string;
-}
-/**
- * Render the live managed blocks for the ONE active AnyPick provider. Codex
- * routes globally (top-level `model_provider`), so exactly one provider table
- * is published — pointing at the Proxy Hub / proxy / gateway, which dispatches
- * each model to its own upstream.
- *
- * The root block *takes over* top-level `model_provider` (and `model` when a
- * default is known) so plain `codex` and the desktop app route through AnyPick
- * without `--profile`. Callers must stash the user's previous top-level values
- * via {@link extractUserTopLevelDefaults} before the first takeover and restore
- * them with {@link restoreUserTopLevelDefaults} on native/reset.
- *
- * Returns the root-scope block and the provider table separately: TOML binds a
- * bare key to whatever `[table]` precedes it, so root keys have to be placed
- * above the user's first table header rather than appended at EOF.
- */
-export declare function renderLiveManagedBlock(provider: LiveCodexProvider, catalogPath: string, opts?: {
-    includeCatalog?: boolean;
-}): {
-    root: string;
-    providerTable: string;
-};
-/**
- * Codex treats a model-provider `base_url` as a prefix and appends `/responses`.
- * The Proxy Hub and the per-provider proxies serve the canonical `/v1/*` paths,
- * so the published URL must carry the `/v1` suffix or every request 404s.
- */
-export declare function codexProviderBaseUrl(endpoint: string): string;
-/**
- * Replace both managed blocks with `root` (above the user's first table header)
- * and `providerTable` (at EOF), leaving the rest of the config untouched.
- */
-export declare function upsertLiveBlock(content: string, block: {
-    root: string;
-    providerTable: string;
-}): string;
-/** Remove both live blocks, preserving the rest of the config. */
-export declare function stripLiveBlock(content: string): string;
-/**
- * Read a bare top-level TOML string assignment outside managed blocks.
- * Returns the unquoted string value, or `undefined` if the key is absent.
- */
-export declare function readTopLevelStringKey(content: string, key: string): string | undefined;
-/** Snapshot the user's top-level model / model_provider before takeover. */
-export declare function extractUserTopLevelDefaults(content: string): CodexUserDefaultsStash;
-/**
- * Strip live blocks and remove top-level takeover keys so the managed block can
- * own `model` / `model_provider` without duplicating user assignments.
- */
-export declare function prepareConfigForLiveTakeover(content: string): string;
-/**
- * Strip live blocks and put stashed user defaults back at root scope.
- * Keys the user never had are left absent. Without a stash, only the managed
- * blocks are removed — user top-level keys outside them stay put.
- */
-export declare function restoreUserTopLevelDefaults(content: string, stash: CodexUserDefaultsStash | null | undefined): string;
-/** Remove bare root-scope assignments for the given keys (outside tables). */
-export declare function removeTopLevelKeys(content: string, keys: readonly string[]): string;
-/** Insert bare root-scope string keys above the first table header. */
-export declare function insertTopLevelKeys(content: string, entries: ReadonlyArray<readonly [string, string]>): string;
-/**
- * Catalog for live publishing: the active route's models only, tagged with the
- * live provider id so Codex binds them to the Hub/proxy provider table.
- *
- * Deliberately does **not** merge stock OpenAI GPT entries. With top-level
- * `model_provider` pointing at the AnyPick route, GPT ids would be sent to the
- * Hub and 404 — and they drowned out real Hub models in some pickers.
- */
-export declare function buildLiveCatalog(routeModels: readonly CodexCatalogModel[], opts: {
-    provider: string;
-} | string): Record<string, unknown>;
-/**
- * Discover the catalog the live route serves. Loopback hubs/proxies expose a
- * live /v1/models; fall back to a deterministic default when unavailable.
- */
-export declare function liveRouteCatalogModels(opts: {
-    endpoint: string;
-    token: string;
-    defaultModel?: string;
-}): Promise<CodexCatalogModel[]>;
-/**
- * True when the given key exists at ROOT scope outside the managed blocks.
- * Keys under a `[table]` header are a different setting entirely and must not
- * suppress the managed `model_catalog_json`.
- */
-export declare function hasTopLevelKeyOutsideLiveBlock(content: string, key: string): boolean;
-export declare const codexClient: ClientAdapter;
-//# sourceMappingURL=codex.d.ts.map

package/dist/clients/codex.d.ts.map

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