anypick 1.0.0

package/dist/clients/codex.d.ts

@@ -0,0 +1,181 @@
+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

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