@makaio/framework 1.0.0-dev-1781022866275 → 1.0.0-dev-1781023871421

package/dist/index-B_zQC98V.d.mts

@@ -0,0 +1,995 @@
+import { z } from "zod";
+import { AdapterFile, ProviderConfigFile } from "@makaio/framework/contracts/config";
+
+//#region services/core/src/adapter-subsystem/schemas.d.ts
+/**
+ * Bus-safe provider config read model.
+ *
+ * Generic reads intentionally exclude credential refs. Runtime assembly goes
+ * through `buildProviderContext` instead.
+ */
+declare const ProviderConfigFileRecordSchema: z.ZodObject<{
+  id: z.ZodString;
+  definitionId: z.ZodString;
+  name: z.ZodString;
+  endpointOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  modelVisibility: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+    enabled: "enabled";
+    disabled: "disabled";
+    visible: "visible";
+  }>>>;
+  modelFilterMode: z.ZodEnum<{
+    allowlist: "allowlist";
+    "show-all": "show-all";
+  }>;
+  isDefault: z.ZodBoolean;
+  enabled: z.ZodBoolean;
+  isSentinel: z.ZodBoolean;
+  hasCredentials: z.ZodBoolean;
+  sourceRef: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/**
+ * Inferred bus-safe provider config read model.
+ */
+type ProviderConfigFileRecord = z.infer<typeof ProviderConfigFileRecordSchema>;
+/**
+ * Binding record as surfaced by the adapter subsystem.
+ */
+declare const BindingRecordSchema: z.ZodObject<{
+  adapterName: z.ZodString;
+  providerConfigId: z.ZodString;
+  isDefault: z.ZodBoolean;
+}, z.core.$strict>;
+/**
+ * Inferred binding record.
+ */
+type BindingRecord = z.infer<typeof BindingRecordSchema>;
+/**
+ * Normalized adapter file-backed read model.
+ */
+declare const AdapterFileConfigSchema: z.ZodObject<{
+  description: z.ZodOptional<z.ZodString>;
+  clientId: z.ZodOptional<z.ZodString>;
+  displayName: z.ZodOptional<z.ZodString>;
+  protocol: z.ZodOptional<z.ZodString>;
+  helpLinks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    label: z.ZodString;
+    url: z.ZodString;
+  }, z.core.$strict>>>;
+  instructions: z.ZodOptional<z.ZodString>;
+  providerDefinitionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  settings: z.ZodOptional<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
+  name: z.ZodString;
+  enabled: z.ZodBoolean;
+  bindings: z.ZodArray<z.ZodObject<{
+    adapterName: z.ZodString;
+    providerConfigId: z.ZodString;
+    isDefault: z.ZodBoolean;
+  }, z.core.$strict>>;
+}, z.core.$strict>;
+/**
+ * Inferred adapter file-backed read model.
+ */
+type AdapterFileConfig = z.infer<typeof AdapterFileConfigSchema>;
+/**
+ * Readiness status for the effective adapter view.
+ */
+declare const AdapterReadinessSchema: z.ZodEnum<{
+  ready: "ready";
+  "needs-setup": "needs-setup";
+}>;
+/**
+ * Inferred readiness status for the effective adapter view.
+ */
+type AdapterReadiness = z.infer<typeof AdapterReadinessSchema>;
+/**
+ * Host-extensible effective adapter view.
+ */
+declare const EffectiveAdapterSchema: z.ZodObject<{
+  name: z.ZodString;
+  displayName: z.ZodString;
+  description: z.ZodOptional<z.ZodString>;
+  enabled: z.ZodBoolean;
+  configCount: z.ZodNumber;
+  readiness: z.ZodEnum<{
+    ready: "ready";
+    "needs-setup": "needs-setup";
+  }>;
+  supportsLogImport: z.ZodBoolean;
+  helpLinks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    label: z.ZodString;
+    url: z.ZodString;
+  }, z.core.$strict>>>;
+  instructions: z.ZodOptional<z.ZodString>;
+  clientId: z.ZodOptional<z.ZodString>;
+  protocol: z.ZodOptional<z.ZodString>;
+  providerDefinitionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+/**
+ * Inferred effective adapter view.
+ */
+type EffectiveAdapter = z.infer<typeof EffectiveAdapterSchema>;
+/**
+ * Adapter-subsystem bus schemas.
+ *
+ * Each key becomes a subject identifier under the `adapterSubsystem.` namespace.
+ */
+declare const AdapterSubsystemSchemas: {
+  /**
+   * Get one adapter config by adapter name.
+   */
+  getAdapterConfig: {
+    request: z.ZodObject<{
+      name: z.ZodString;
+    }, z.core.$strict>;
+    response: z.ZodObject<{
+      config: z.ZodNullable<z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        clientId: z.ZodOptional<z.ZodString>;
+        displayName: z.ZodOptional<z.ZodString>;
+        protocol: z.ZodOptional<z.ZodString>;
+        helpLinks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+          label: z.ZodString;
+          url: z.ZodString;
+        }, z.core.$strict>>>;
+        instructions: z.ZodOptional<z.ZodString>;
+        providerDefinitionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        settings: z.ZodOptional<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
+        name: z.ZodString;
+        enabled: z.ZodBoolean;
+        bindings: z.ZodArray<z.ZodObject<{
+          adapterName: z.ZodString;
+          providerConfigId: z.ZodString;
+          isDefault: z.ZodBoolean;
+        }, z.core.$strict>>;
+      }, z.core.$strict>>;
+    }, z.core.$strict>;
+  };
+  /**
+   * List all adapter configs.
+   */
+  listAdapterConfigs: {
+    request: z.ZodObject<{}, z.core.$strict>;
+    response: z.ZodObject<{
+      configs: z.ZodArray<z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        clientId: z.ZodOptional<z.ZodString>;
+        displayName: z.ZodOptional<z.ZodString>;
+        protocol: z.ZodOptional<z.ZodString>;
+        helpLinks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+          label: z.ZodString;
+          url: z.ZodString;
+        }, z.core.$strict>>>;
+        instructions: z.ZodOptional<z.ZodString>;
+        providerDefinitionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        settings: z.ZodOptional<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
+        name: z.ZodString;
+        enabled: z.ZodBoolean;
+        bindings: z.ZodArray<z.ZodObject<{
+          adapterName: z.ZodString;
+          providerConfigId: z.ZodString;
+          isDefault: z.ZodBoolean;
+        }, z.core.$strict>>;
+      }, z.core.$strict>>;
+    }, z.core.$strict>;
+  };
+  /**
+   * Get one provider config by ID.
+   */
+  getProviderConfig: {
+    request: z.ZodObject<{
+      id: z.ZodString;
+    }, z.core.$strict>;
+    response: z.ZodObject<{
+      config: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        definitionId: z.ZodString;
+        name: z.ZodString;
+        endpointOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        modelVisibility: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+          enabled: "enabled";
+          disabled: "disabled";
+          visible: "visible";
+        }>>>;
+        modelFilterMode: z.ZodEnum<{
+          allowlist: "allowlist";
+          "show-all": "show-all";
+        }>;
+        isDefault: z.ZodBoolean;
+        enabled: z.ZodBoolean;
+        isSentinel: z.ZodBoolean;
+        hasCredentials: z.ZodBoolean;
+        sourceRef: z.ZodOptional<z.ZodString>;
+      }, z.core.$strict>>;
+    }, z.core.$strict>;
+  };
+  /**
+   * List provider configs, optionally filtering by enabled state.
+   */
+  listProviderConfigs: {
+    request: z.ZodObject<{
+      enabled: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>;
+    response: z.ZodObject<{
+      configs: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        definitionId: z.ZodString;
+        name: z.ZodString;
+        endpointOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        modelVisibility: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+          enabled: "enabled";
+          disabled: "disabled";
+          visible: "visible";
+        }>>>;
+        modelFilterMode: z.ZodEnum<{
+          allowlist: "allowlist";
+          "show-all": "show-all";
+        }>;
+        isDefault: z.ZodBoolean;
+        enabled: z.ZodBoolean;
+        isSentinel: z.ZodBoolean;
+        hasCredentials: z.ZodBoolean;
+        sourceRef: z.ZodOptional<z.ZodString>;
+      }, z.core.$strict>>;
+    }, z.core.$strict>;
+  };
+  /**
+   * List provider configs for a given provider definition.
+   */
+  listProviderConfigsByDefinition: {
+    request: z.ZodObject<{
+      definitionId: z.ZodString;
+    }, z.core.$strict>;
+    response: z.ZodObject<{
+      configs: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        definitionId: z.ZodString;
+        name: z.ZodString;
+        endpointOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        modelVisibility: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+          enabled: "enabled";
+          disabled: "disabled";
+          visible: "visible";
+        }>>>;
+        modelFilterMode: z.ZodEnum<{
+          allowlist: "allowlist";
+          "show-all": "show-all";
+        }>;
+        isDefault: z.ZodBoolean;
+        enabled: z.ZodBoolean;
+        isSentinel: z.ZodBoolean;
+        hasCredentials: z.ZodBoolean;
+        sourceRef: z.ZodOptional<z.ZodString>;
+      }, z.core.$strict>>;
+    }, z.core.$strict>;
+  };
+  /**
+   * List bindings for an adapter.
+   */
+  listBindings: {
+    request: z.ZodObject<{
+      adapterName: z.ZodString;
+    }, z.core.$strict>;
+    response: z.ZodObject<{
+      bindings: z.ZodArray<z.ZodObject<{
+        adapterName: z.ZodString;
+        providerConfigId: z.ZodString;
+        isDefault: z.ZodBoolean;
+      }, z.core.$strict>>;
+    }, z.core.$strict>;
+  };
+  /**
+   * List bindings for a provider config.
+   */
+  listBindingsByConfig: {
+    request: z.ZodObject<{
+      providerConfigId: z.ZodString;
+    }, z.core.$strict>;
+    response: z.ZodObject<{
+      bindings: z.ZodArray<z.ZodObject<{
+        adapterName: z.ZodString;
+        providerConfigId: z.ZodString;
+        isDefault: z.ZodBoolean;
+      }, z.core.$strict>>;
+    }, z.core.$strict>;
+  };
+  /**
+   * Get the default binding for an adapter.
+   */
+  getDefaultBinding: {
+    request: z.ZodObject<{
+      adapterName: z.ZodString;
+    }, z.core.$strict>;
+    response: z.ZodObject<{
+      binding: z.ZodNullable<z.ZodObject<{
+        adapterName: z.ZodString;
+        providerConfigId: z.ZodString;
+        isDefault: z.ZodBoolean;
+      }, z.core.$strict>>;
+    }, z.core.$strict>;
+  };
+  /**
+   * Find the provider config bound to a specific adapter for a definition.
+   */
+  findConfigForDefinitionAndAdapter: {
+    request: z.ZodObject<{
+      definitionId: z.ZodString;
+      adapterName: z.ZodString;
+    }, z.core.$strict>;
+    response: z.ZodObject<{
+      config: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        definitionId: z.ZodString;
+        name: z.ZodString;
+        endpointOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        modelVisibility: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+          enabled: "enabled";
+          disabled: "disabled";
+          visible: "visible";
+        }>>>;
+        modelFilterMode: z.ZodEnum<{
+          allowlist: "allowlist";
+          "show-all": "show-all";
+        }>;
+        isDefault: z.ZodBoolean;
+        enabled: z.ZodBoolean;
+        isSentinel: z.ZodBoolean;
+        hasCredentials: z.ZodBoolean;
+        sourceRef: z.ZodOptional<z.ZodString>;
+      }, z.core.$strict>>;
+    }, z.core.$strict>;
+  };
+  /**
+   * Build a provider context from a provider config.
+   */
+  buildProviderContext: {
+    request: z.ZodObject<{
+      providerConfigId: z.ZodString;
+    }, z.core.$strict>;
+    response: z.ZodObject<{
+      context: z.ZodNullable<z.ZodObject<{
+        providerConfigId: z.ZodString;
+        definitionId: z.ZodString;
+        endpointOverrides: z.ZodOptional<z.ZodObject<{
+          anthropic: z.ZodOptional<z.ZodString>;
+          openai: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        credentialRefs: z.ZodRecord<z.ZodString, z.core.$ZodBranded<z.ZodString, "CredentialRef", "out">>;
+        credentialEnvVars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        ambientCredentialEnvVars: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      }, z.core.$strip>>;
+    }, z.core.$strict>;
+  };
+  /**
+   * List effective adapters.
+   */
+  listAdapters: {
+    request: z.ZodObject<{}, z.core.$strict>;
+    response: z.ZodObject<{
+      adapters: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        enabled: z.ZodBoolean;
+        configCount: z.ZodNumber;
+        readiness: z.ZodEnum<{
+          ready: "ready";
+          "needs-setup": "needs-setup";
+        }>;
+        supportsLogImport: z.ZodBoolean;
+        helpLinks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+          label: z.ZodString;
+          url: z.ZodString;
+        }, z.core.$strict>>>;
+        instructions: z.ZodOptional<z.ZodString>;
+        clientId: z.ZodOptional<z.ZodString>;
+        protocol: z.ZodOptional<z.ZodString>;
+        providerDefinitionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      }, z.core.$strict>>;
+    }, z.core.$strict>;
+  };
+  /**
+   * Get provider definitions contributed by a specific adapter.
+   *
+   * Returns the full provider definition array for the named adapter, including
+   * the registry-populated `availableModels` set at boot time.
+   */
+  getProviderDefinitionsByAdapter: {
+    request: z.ZodObject<{
+      adapterName: z.ZodString;
+    }, z.core.$strict>;
+    response: z.ZodObject<{
+      definitions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        endpoints: z.ZodOptional<z.ZodObject<{
+          anthropic: z.ZodOptional<z.ZodString>;
+          openai: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        defaultModel: z.ZodOptional<z.ZodString>;
+        fastModel: z.ZodOptional<z.ZodString>;
+        primaryTestModel: z.ZodOptional<z.ZodString>;
+        secondaryTestModel: z.ZodOptional<z.ZodString>;
+        availableModels: z.ZodDefault<z.ZodArray<z.ZodObject<{
+          name: z.ZodString;
+          friendlyName: z.ZodOptional<z.ZodString>;
+          family: z.ZodOptional<z.ZodString>;
+          contextWindowSize: z.ZodNumber;
+          labId: z.ZodString;
+          supportedReasoningLevels: z.ZodOptional<z.ZodObject<{
+            none: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+            low: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+            medium: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+            high: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+            'extra-high': z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+          }, z.core.$strip>>;
+          metadata: z.ZodOptional<z.ZodObject<{
+            maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+            capabilities: z.ZodOptional<z.ZodObject<{
+              vision: z.ZodOptional<z.ZodBoolean>;
+              toolCalling: z.ZodOptional<z.ZodBoolean>;
+              parallelToolCalls: z.ZodOptional<z.ZodBoolean>;
+              structuredOutput: z.ZodOptional<z.ZodBoolean>;
+              pdfUpload: z.ZodOptional<z.ZodBoolean>;
+              speechToText: z.ZodOptional<z.ZodObject<{
+                modes: z.ZodArray<z.ZodEnum<{
+                  batch: "batch";
+                  streaming: "streaming";
+                }>>;
+                vocabularyBiasing: z.ZodOptional<z.ZodBoolean>;
+              }, z.core.$strip>>;
+              textToSpeech: z.ZodOptional<z.ZodObject<{
+                modes: z.ZodArray<z.ZodEnum<{
+                  streaming: "streaming";
+                  buffered: "buffered";
+                }>>;
+                voiceSelection: z.ZodOptional<z.ZodBoolean>;
+                voiceInstructions: z.ZodOptional<z.ZodBoolean>;
+                outputFormats: z.ZodOptional<z.ZodArray<z.ZodString>>;
+              }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            pricing: z.ZodOptional<z.ZodObject<{
+              token: z.ZodOptional<z.ZodObject<{
+                inputPerMillion: z.ZodNumber;
+                inputCachedPerMillion: z.ZodOptional<z.ZodNumber>;
+                cacheWritePerMillion: z.ZodOptional<z.ZodNumber>;
+                outputPerMillion: z.ZodNumber;
+              }, z.core.$strip>>;
+              request: z.ZodOptional<z.ZodObject<{
+                multiplier: z.ZodNumber;
+              }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            includedInSubscription: z.ZodOptional<z.ZodBoolean>;
+            description: z.ZodOptional<z.ZodString>;
+          }, z.core.$strip>>;
+        }, z.core.$strip>>>;
+        defaultModelFilterMode: z.ZodOptional<z.ZodEnum<{
+          allowlist: "allowlist";
+          "show-all": "show-all";
+        }>>;
+        credentialEnvVars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+      }, z.core.$strip>>;
+    }, z.core.$strict>;
+  };
+  /**
+   * Create a provider config.
+   */
+  createProviderConfig: {
+    request: z.ZodObject<{
+      definitionId: z.ZodString;
+      name: z.ZodOptional<z.ZodString>;
+      credentialRefs: z.ZodOptional<z.ZodRecord<z.ZodString, z.core.$ZodBranded<z.ZodString, "CredentialRef", "out">>>;
+      endpointOverrides: z.ZodOptional<z.ZodObject<{
+        anthropic: z.ZodOptional<z.ZodString>;
+        openai: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>>;
+      modelVisibility: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+        enabled: "enabled";
+        disabled: "disabled";
+        visible: "visible";
+      }>>>;
+      modelFilterMode: z.ZodOptional<z.ZodEnum<{
+        allowlist: "allowlist";
+        "show-all": "show-all";
+      }>>;
+      isSentinel: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>;
+    response: z.ZodObject<{
+      config: z.ZodObject<{
+        id: z.ZodString;
+        definitionId: z.ZodString;
+        name: z.ZodString;
+        endpointOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        modelVisibility: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+          enabled: "enabled";
+          disabled: "disabled";
+          visible: "visible";
+        }>>>;
+        modelFilterMode: z.ZodEnum<{
+          allowlist: "allowlist";
+          "show-all": "show-all";
+        }>;
+        isDefault: z.ZodBoolean;
+        enabled: z.ZodBoolean;
+        isSentinel: z.ZodBoolean;
+        hasCredentials: z.ZodBoolean;
+        sourceRef: z.ZodOptional<z.ZodString>;
+      }, z.core.$strict>;
+    }, z.core.$strict>;
+  };
+  /**
+   * Update a provider config.
+   */
+  updateProviderConfig: {
+    request: z.ZodObject<{
+      id: z.ZodString;
+      patch: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        endpointOverrides: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+          anthropic: z.ZodOptional<z.ZodString>;
+          openai: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        modelVisibility: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+          enabled: "enabled";
+          disabled: "disabled";
+          visible: "visible";
+        }>>>;
+        enabled: z.ZodOptional<z.ZodBoolean>;
+      }, z.core.$strict>;
+    }, z.core.$strict>;
+    response: z.ZodObject<{
+      config: z.ZodObject<{
+        id: z.ZodString;
+        definitionId: z.ZodString;
+        name: z.ZodString;
+        endpointOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        modelVisibility: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+          enabled: "enabled";
+          disabled: "disabled";
+          visible: "visible";
+        }>>>;
+        modelFilterMode: z.ZodEnum<{
+          allowlist: "allowlist";
+          "show-all": "show-all";
+        }>;
+        isDefault: z.ZodBoolean;
+        enabled: z.ZodBoolean;
+        isSentinel: z.ZodBoolean;
+        hasCredentials: z.ZodBoolean;
+        sourceRef: z.ZodOptional<z.ZodString>;
+      }, z.core.$strict>;
+    }, z.core.$strict>;
+  };
+  /**
+   * Replace the canonical credential refs for one provider config.
+   */
+  setProviderConfigCredentialRefs: {
+    request: z.ZodObject<{
+      id: z.ZodString;
+      credentialRefs: z.ZodRecord<z.ZodString, z.core.$ZodBranded<z.ZodString, "CredentialRef", "out">>;
+    }, z.core.$strict>;
+    response: z.ZodObject<{
+      config: z.ZodObject<{
+        id: z.ZodString;
+        definitionId: z.ZodString;
+        name: z.ZodString;
+        endpointOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        modelVisibility: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+          enabled: "enabled";
+          disabled: "disabled";
+          visible: "visible";
+        }>>>;
+        modelFilterMode: z.ZodEnum<{
+          allowlist: "allowlist";
+          "show-all": "show-all";
+        }>;
+        isDefault: z.ZodBoolean;
+        enabled: z.ZodBoolean;
+        isSentinel: z.ZodBoolean;
+        hasCredentials: z.ZodBoolean;
+        sourceRef: z.ZodOptional<z.ZodString>;
+      }, z.core.$strict>;
+    }, z.core.$strict>;
+  };
+  /**
+   * Delete a provider config.
+   */
+  deleteProviderConfig: {
+    request: z.ZodObject<{
+      id: z.ZodString;
+    }, z.core.$strict>;
+    response: z.ZodObject<{
+      deleted: z.ZodBoolean;
+    }, z.core.$strict>;
+  };
+  /**
+   * Set the default provider config for its definition.
+   */
+  setDefaultProviderConfig: {
+    request: z.ZodObject<{
+      id: z.ZodString;
+    }, z.core.$strict>;
+    response: z.ZodObject<{
+      config: z.ZodObject<{
+        id: z.ZodString;
+        definitionId: z.ZodString;
+        name: z.ZodString;
+        endpointOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        modelVisibility: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+          enabled: "enabled";
+          disabled: "disabled";
+          visible: "visible";
+        }>>>;
+        modelFilterMode: z.ZodEnum<{
+          allowlist: "allowlist";
+          "show-all": "show-all";
+        }>;
+        isDefault: z.ZodBoolean;
+        enabled: z.ZodBoolean;
+        isSentinel: z.ZodBoolean;
+        hasCredentials: z.ZodBoolean;
+        sourceRef: z.ZodOptional<z.ZodString>;
+      }, z.core.$strict>;
+    }, z.core.$strict>;
+  };
+  /**
+   * Set the model filter mode for a provider config.
+   */
+  setModelFilterMode: {
+    request: z.ZodObject<{
+      id: z.ZodString;
+      modelFilterMode: z.ZodEnum<{
+        allowlist: "allowlist";
+        "show-all": "show-all";
+      }>;
+      preferredModel: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    response: z.ZodObject<{
+      config: z.ZodObject<{
+        id: z.ZodString;
+        definitionId: z.ZodString;
+        name: z.ZodString;
+        endpointOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        modelVisibility: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+          enabled: "enabled";
+          disabled: "disabled";
+          visible: "visible";
+        }>>>;
+        modelFilterMode: z.ZodEnum<{
+          allowlist: "allowlist";
+          "show-all": "show-all";
+        }>;
+        isDefault: z.ZodBoolean;
+        enabled: z.ZodBoolean;
+        isSentinel: z.ZodBoolean;
+        hasCredentials: z.ZodBoolean;
+        sourceRef: z.ZodOptional<z.ZodString>;
+      }, z.core.$strict>;
+    }, z.core.$strict>;
+  };
+  /**
+   * Set adapter config fields.
+   */
+  setAdapterConfig: {
+    request: z.ZodObject<{
+      name: z.ZodString;
+      patch: z.ZodObject<{
+        displayName: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        helpLinks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+          label: z.ZodString;
+          url: z.ZodString;
+        }, z.core.$strict>>>;
+        instructions: z.ZodOptional<z.ZodString>;
+        clientId: z.ZodOptional<z.ZodString>;
+        protocol: z.ZodOptional<z.ZodString>;
+        providerDefinitionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        settings: z.ZodOptional<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
+        enabled: z.ZodOptional<z.ZodBoolean>;
+      }, z.core.$strict>;
+    }, z.core.$strict>;
+    response: z.ZodObject<{
+      config: z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        clientId: z.ZodOptional<z.ZodString>;
+        displayName: z.ZodOptional<z.ZodString>;
+        protocol: z.ZodOptional<z.ZodString>;
+        helpLinks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+          label: z.ZodString;
+          url: z.ZodString;
+        }, z.core.$strict>>>;
+        instructions: z.ZodOptional<z.ZodString>;
+        providerDefinitionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        settings: z.ZodOptional<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
+        name: z.ZodString;
+        enabled: z.ZodBoolean;
+        bindings: z.ZodArray<z.ZodObject<{
+          adapterName: z.ZodString;
+          providerConfigId: z.ZodString;
+          isDefault: z.ZodBoolean;
+        }, z.core.$strict>>;
+      }, z.core.$strict>;
+    }, z.core.$strict>;
+  };
+  /**
+   * Enable or disable an adapter config.
+   */
+  setAdapterEnabled: {
+    request: z.ZodObject<{
+      name: z.ZodString;
+      enabled: z.ZodBoolean;
+    }, z.core.$strict>;
+    response: z.ZodObject<{
+      success: z.ZodBoolean;
+    }, z.core.$strict>;
+  };
+  /**
+   * Bind a provider config to an adapter.
+   */
+  bind: {
+    request: z.ZodObject<{
+      adapterName: z.ZodString;
+      providerConfigId: z.ZodString;
+    }, z.core.$strict>;
+    response: z.ZodObject<{
+      binding: z.ZodObject<{
+        adapterName: z.ZodString;
+        providerConfigId: z.ZodString;
+        isDefault: z.ZodBoolean;
+      }, z.core.$strict>;
+    }, z.core.$strict>;
+  };
+  /**
+   * Unbind a provider config from an adapter.
+   */
+  unbind: {
+    request: z.ZodObject<{
+      adapterName: z.ZodString;
+      providerConfigId: z.ZodString;
+    }, z.core.$strict>;
+    response: z.ZodObject<{}, z.core.$strict>;
+  };
+  /**
+   * Set the default binding for an adapter.
+   */
+  setDefaultBinding: {
+    request: z.ZodObject<{
+      adapterName: z.ZodString;
+      providerConfigId: z.ZodString;
+    }, z.core.$strict>;
+    response: z.ZodObject<{}, z.core.$strict>;
+  };
+  /**
+   * Ensure the subsystem is ready for grain-constrained consumers.
+   */
+  ensureReady: {
+    request: z.ZodObject<{}, z.core.$strict>;
+    response: z.ZodObject<{
+      ready: z.ZodLiteral<true>;
+    }, z.core.$strict>;
+  };
+  /**
+   * Provider config lifecycle events.
+   */
+  'providerConfig.created': z.ZodObject<{
+    id: z.ZodString;
+    definitionId: z.ZodString;
+    name: z.ZodString;
+    endpointOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    modelVisibility: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+      enabled: "enabled";
+      disabled: "disabled";
+      visible: "visible";
+    }>>>;
+    modelFilterMode: z.ZodEnum<{
+      allowlist: "allowlist";
+      "show-all": "show-all";
+    }>;
+    isDefault: z.ZodBoolean;
+    enabled: z.ZodBoolean;
+    isSentinel: z.ZodBoolean;
+    hasCredentials: z.ZodBoolean;
+    sourceRef: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>;
+  'providerConfig.updated': z.ZodObject<{
+    id: z.ZodString;
+    definitionId: z.ZodString;
+    name: z.ZodString;
+    endpointOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    modelVisibility: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+      enabled: "enabled";
+      disabled: "disabled";
+      visible: "visible";
+    }>>>;
+    modelFilterMode: z.ZodEnum<{
+      allowlist: "allowlist";
+      "show-all": "show-all";
+    }>;
+    isDefault: z.ZodBoolean;
+    enabled: z.ZodBoolean;
+    isSentinel: z.ZodBoolean;
+    hasCredentials: z.ZodBoolean;
+    sourceRef: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>;
+  'providerConfig.deleted': z.ZodObject<{
+    id: z.ZodString;
+  }, z.core.$strict>;
+  'providerConfig.defaultChanged': z.ZodObject<{
+    definitionId: z.ZodString;
+    configId: z.ZodNullable<z.ZodString>;
+  }, z.core.$strict>;
+  /**
+   * Binding lifecycle events.
+   */
+  'binding.created': z.ZodObject<{
+    adapterName: z.ZodString;
+    providerConfigId: z.ZodString;
+    isDefault: z.ZodBoolean;
+  }, z.core.$strict>;
+  'binding.deleted': z.ZodObject<{
+    adapterName: z.ZodString;
+    providerConfigId: z.ZodString;
+  }, z.core.$strict>;
+  'binding.defaultChanged': z.ZodObject<{
+    adapterName: z.ZodString;
+    providerConfigId: z.ZodString;
+  }, z.core.$strict>;
+  /**
+   * Readiness observability event (fire-and-forget, no replay guarantee).
+   *
+   * Listeners registered after the subsystem emits this event will miss it.
+   * Use `ensureReady` (request/response) for reliable coordination.
+   */
+  ready: z.ZodObject<{}, z.core.$strict>;
+  /**
+   * Emitted once per adapter after the adapter-subsystem service processes a
+   * newly-active adapter package.
+   *
+   * Replaces the retired batch `adaptersRegistered` event. The model registry
+   * and other subscribers react per-adapter and debounce refreshes as needed.
+   *
+   * Fire-and-forget; no replay guarantee.
+   */
+  'adapter.registered': z.ZodObject<{
+    adapterName: z.ZodString;
+    displayName: z.ZodString;
+    packageName: z.ZodString;
+    enabled: z.ZodBoolean;
+    initialized: z.ZodBoolean;
+    providerDefinitionIds: z.ZodArray<z.ZodString>;
+  }, z.core.$strict>;
+};
+//#endregion
+//#region services/core/src/adapter-subsystem/types.d.ts
+/**
+ * Loaded adapter file set keyed by adapter name.
+ */
+interface AdapterFileConfigSet {
+  /** Adapter file payloads keyed by canonical adapter name. */
+  configs: Map<string, AdapterFile>;
+}
+/**
+ * Loaded provider config file set keyed by provider config ID.
+ */
+interface ProviderConfigFileSet {
+  /** Provider config file payloads keyed by canonical provider config ID. */
+  configs: Map<string, ProviderConfigFile>;
+}
+/**
+ * Repository interface injected into the adapter subsystem service.
+ */
+interface IAdapterConfigRepository {
+  /**
+   * Load all adapter files from the canonical config store.
+   */
+  loadAdapterConfigs(): Promise<AdapterFileConfigSet>;
+  /**
+   * Load all provider config files from the canonical config store.
+   */
+  loadProviderConfigs(): Promise<ProviderConfigFileSet>;
+  /**
+   * Persist a provider config file at the given canonical ID.
+   * @param id - Canonical provider config ID
+   * @param config - File payload to persist
+   */
+  writeProviderConfig(id: string, config: ProviderConfigFile): Promise<void>;
+  /**
+   * Delete a provider config file by canonical ID.
+   * @param id - Canonical provider config ID
+   * @returns `true` when a file was removed
+   */
+  deleteProviderConfig(id: string): Promise<boolean>;
+  /**
+   * Persist an adapter file at the given canonical name.
+   * @param name - Canonical adapter name
+   * @param config - File payload to persist
+   */
+  writeAdapterFile(name: string, config: AdapterFile): Promise<void>;
+  /**
+   * Delete an adapter file by canonical name.
+   * @param name - Canonical adapter name
+   * @returns `true` when a file was removed
+   */
+  deleteAdapterFile(name: string): Promise<boolean>;
+}
+//#endregion
+//#region services/core/src/adapter-subsystem/write-types.d.ts
+/**
+ * Canonical credential-ref map stored in provider-config files.
+ */
+declare const CanonicalProviderConfigCredentialRefsSchema: z.ZodRecord<z.ZodString, z.core.$ZodBranded<z.ZodString, "CredentialRef", "out">>;
+/**
+ * Canonical create payload for provider configs.
+ *
+ * Canonical subsystem writes are ref-only at rest. Public callers must resolve
+ * any plaintext credentials before using this contract.
+ */
+declare const CreateCanonicalProviderConfigInputSchema: z.ZodObject<{
+  definitionId: z.ZodString;
+  name: z.ZodOptional<z.ZodString>;
+  credentialRefs: z.ZodOptional<z.ZodRecord<z.ZodString, z.core.$ZodBranded<z.ZodString, "CredentialRef", "out">>>;
+  endpointOverrides: z.ZodOptional<z.ZodObject<{
+    anthropic: z.ZodOptional<z.ZodString>;
+    openai: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+  modelVisibility: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+    enabled: "enabled";
+    disabled: "disabled";
+    visible: "visible";
+  }>>>;
+  modelFilterMode: z.ZodOptional<z.ZodEnum<{
+    allowlist: "allowlist";
+    "show-all": "show-all";
+  }>>;
+  isSentinel: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+/**
+ * Canonical patch payload for provider configs.
+ *
+ * Mode changes flow through `setModelFilterMode`. Sentinel state is not part of
+ * the generic patch seam.
+ */
+declare const CanonicalProviderConfigPatchSchema: z.ZodObject<{
+  name: z.ZodOptional<z.ZodString>;
+  endpointOverrides: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    anthropic: z.ZodOptional<z.ZodString>;
+    openai: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>>;
+  modelVisibility: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+    enabled: "enabled";
+    disabled: "disabled";
+    visible: "visible";
+  }>>>;
+  enabled: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+/**
+ * Inferred canonical create payload (post-validation, with branded credential refs).
+ */
+type CreateCanonicalProviderConfigInput = z.infer<typeof CreateCanonicalProviderConfigInputSchema>;
+/**
+ * Bus-layer create payload (pre-validation input type, with unbranded credential refs).
+ *
+ * The bus infrastructure uses `z.input` for request payloads so callers can pass
+ * plain strings that the schema validates and brands. Service handlers receive
+ * this type from the bus context; only the Zod parse step produces the fully
+ * branded {@link CreateCanonicalProviderConfigInput}.
+ */
+type CreateCanonicalProviderConfigInputPayload = z.input<typeof CreateCanonicalProviderConfigInputSchema>;
+/**
+ * Inferred canonical patch payload.
+ */
+type CanonicalProviderConfigPatch = z.infer<typeof CanonicalProviderConfigPatchSchema>;
+/**
+ * Inferred canonical credential-ref map (post-validation, with branded refs).
+ */
+type CanonicalProviderConfigCredentialRefs = z.infer<typeof CanonicalProviderConfigCredentialRefsSchema>;
+/**
+ * Bus-layer credential-ref map payload (pre-validation input type).
+ *
+ * Request handlers receive the schema input shape from the bus context, so
+ * credential refs arrive as plain strings until the schema parse brands them.
+ */
+type CanonicalProviderConfigCredentialRefsPayload = z.input<typeof CanonicalProviderConfigCredentialRefsSchema>;
+//#endregion
+export { ProviderConfigFileRecordSchema as S, BindingRecord as _, CanonicalProviderConfigPatchSchema as a, EffectiveAdapterSchema as b, CreateCanonicalProviderConfigInputSchema as c, ProviderConfigFileSet as d, AdapterFileConfig as f, AdapterSubsystemSchemas as g, AdapterReadinessSchema as h, CanonicalProviderConfigPatch as i, AdapterFileConfigSet as l, AdapterReadiness as m, CanonicalProviderConfigCredentialRefsPayload as n, CreateCanonicalProviderConfigInput as o, AdapterFileConfigSchema as p, CanonicalProviderConfigCredentialRefsSchema as r, CreateCanonicalProviderConfigInputPayload as s, CanonicalProviderConfigCredentialRefs as t, IAdapterConfigRepository as u, BindingRecordSchema as v, ProviderConfigFileRecord as x, EffectiveAdapter as y };