agent-shim 11.25.0 → 11.26.0

package/dist/types/index.d.ts

@@ -449,6 +449,21 @@ declare const PickerModelSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 type PickerModel = z.infer<typeof PickerModelSchema>;
+/**
+ * Opt-in listing of the models an `http` provider's own catalogue endpoint reports in `/model`. The door refreshes the catalogue in the background and a launch lists what it last fetched. `tier` is the Claude tier whose handling every listed model borrows, since the catalogue says nothing about it. `include` and `exclude` are glob patterns over model ids (`exclude` wins), because a large catalogue would bury the picker. `url` replaces the endpoint, which otherwise is the provider's `/v1/models` under its base URL, then under its host.
+ */
+declare const ProviderCatalogueSchema: z.ZodObject<{
+    tier: z.ZodEnum<{
+        fable: "fable";
+        opus: "opus";
+        sonnet: "sonnet";
+        haiku: "haiku";
+    }>;
+    include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    url: z.ZodOptional<z.ZodURL>;
+}, z.core.$strict>;
+type ProviderCatalogue = z.infer<typeof ProviderCatalogueSchema>;
 /** All kinds of provider; see `HttpProviderSchema` for the shared fields. */
 declare const ProviderSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     $schema: z.ZodOptional<z.ZodString>;
@@ -502,6 +517,17 @@ declare const ProviderSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         label: z.ZodOptional<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>>;
+    catalogue: z.ZodOptional<z.ZodObject<{
+        tier: z.ZodEnum<{
+            fable: "fable";
+            opus: "opus";
+            sonnet: "sonnet";
+            haiku: "haiku";
+        }>;
+        include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        url: z.ZodOptional<z.ZodURL>;
+    }, z.core.$strict>>;
     routes: z.ZodOptional<z.ZodArray<z.ZodObject<{
         when: z.ZodUnion<readonly [z.ZodObject<{
             newerThan: z.ZodOptional<z.ZodString>;
@@ -1913,6 +1939,8 @@ interface LayoutPaths {
     readonly usageLogDir: string;
     /** Directory of the latest-state snapshots, one `<identity>.json` per identity: the stable file other tools read. */
     readonly usageSnapshotsDir: string;
+    /** One file per provider holding the model catalogue the door last fetched from it. */
+    readonly catalogueDir: string;
     /** Path to the file recording what the person has allowed the MCP server's agents to do (`agent-shim mcp permissions`), mode 0600 and written only by that command: the running server re-reads it on every request, so a change needs no restart. */
     readonly mcpPermissionsFile: string;
     /** The last identity picked from a pool for each directory, so a conversation stays on the account whose prompt cache is warm. */
@@ -13448,8 +13476,8 @@ interface ProviderListEntry {
     readonly name: string;
     readonly provider: Provider;
 }
-/** Lists every provider under `providersDir` that has a valid `<name>.json`. A file that fails validation is skipped here; `provider list` is the place a broken definition gets surfaced, not a launch. */
-declare function listProviders(paths: LayoutPaths): readonly ProviderListEntry[];
+/** Lists every provider under `providersDir` that has a valid `<name>.json`. A file that fails validation is skipped here and reported through `onInvalid` (standard error by default); `provider list` is the place a broken definition gets surfaced, not a launch. */
+declare function listProviders(paths: LayoutPaths, onInvalid?: (name: string, message: string) => void): readonly ProviderListEntry[];
 /** The credential targets a provider may use. */
 type ProviderCredentialTarget = (typeof PROVIDER_CREDENTIAL_TARGETS)[number];
 /** The kinds of provider. */
@@ -13466,6 +13494,8 @@ interface AddProviderInput {
     readonly env?: Readonly<Record<string, string>>;
     /** Extra models `/model` lists beside the ones the tier settings name; applies to every provider kind. */
     readonly pickerModels?: readonly PickerModel[];
+    /** Opt an http provider into listing its own model catalogue in `/model`. */
+    readonly catalogue?: ProviderCatalogue;
     readonly codex?: CodexProviderConfig;
     readonly antigravity?: AntigravityProviderConfig;
 }
@@ -13493,6 +13523,8 @@ interface UpdateProviderInput {
     readonly pickerModels?: readonly PickerModel[];
     /** Models whose picker entries are removed. */
     readonly unsetPickerModels?: readonly string[];
+    /** The provider's whole new catalogue setting, or false to remove it; undefined leaves the existing one. Applies only to an http provider. */
+    readonly catalogue?: ProviderCatalogue | false;
     /** Merged over a codex provider's existing settings: a field given here replaces that field, and `models` entries merge per tier. */
     readonly codex?: CodexProviderConfig;
     /** Merged over an antigravity provider's existing settings: a field given here replaces that field, and `models` entries merge per tier. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-shim",
-  "version": "11.25.0",
+  "version": "11.26.0",
   "description": "A profile manager and launcher for Claude Code that lets one person run multiple logins from one machine while controlling what gets shared between them.",
   "license": "MIT",
   "author": "Joseph Mearman <joseph@mearman.co.uk>",