@inkdropapp/ai 0.1.2 → 0.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkdropapp/ai",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "AI integration common module",
   "type": "module",
   "main": "src/index.ts",
@@ -8,9 +8,9 @@
   "scripts": {
     "lint": "eslint src __tests__",
     "test": "node --experimental-vm-modules --no-warnings=ExperimentalWarning node_modules/jest/bin/jest.js --config jest.config.cjs --runInBand",
-    "gen": "tsc --declaration --emitDeclarationOnly",
+    "build": "tsc --declaration --emitDeclarationOnly",
     "format": "prettier --write .",
-    "prepublishOnly": "npm-run-all lint test gen"
+    "prepublishOnly": "npm-run-all lint test build"
   },
   "keywords": [
     "ai",
@@ -25,7 +25,8 @@
     "@ai-sdk/provider": "4.0.0-beta.14",
     "@inkdropapp/ai-catalog": "^0.1.0",
     "@napi-rs/keyring": "^1.2.0",
-    "ai": "7.0.0-beta.116"
+    "ai": "7.0.0-beta.116",
+    "npm-run-all2": "^8.0.4"
   },
   "devDependencies": {
     "@types/jest": "^30.0.0",
@@ -33,7 +34,6 @@
     "eslint": "^10.3.0",
     "eslint-config-prettier": "^10.1.8",
     "jest": "^30.4.2",
-    "npm-run-all": "^4.1.5",
     "prettier": "^3.8.3",
     "ts-jest": "^29.4.9",
     "typescript": "^6.0.3",

package/types/index.d.ts

@@ -7,4 +7,4 @@ export { KeyStore, type KeyStoreOptions } from './key-store.js';
 export { normalizeBaseURL } from './url.js';
 export { AnthropicProvider } from './providers/anthropic.js';
 export { OpenAICompatibleProvider, deriveEnvVarName } from './providers/openai-compatible.js';
-export { Registry, type RegistryOptions, type ResolvedSlot } from './registry.js';
+export { AIRegistry, type AIRegistryOptions, type ResolvedSlot } from './registry.js';

package/types/provider.d.ts

@@ -45,7 +45,10 @@ export interface AIModel {
  * OpenAI-compatible providers (OpenRouter, Together, Ollama, …) are modelled.
  */
 export interface AIProvider {
-    /** Stable provider id; appears in `AISettings.slots[*].providerId`. */
+    /**
+     * Stable provider id; appears in both `AISettings.providerId` and
+     * `AISettings.slots[*].providerId`.
+     */
     readonly id: string;
     /** Human-readable label. */
     readonly name: string;

package/types/registry.d.ts

@@ -8,13 +8,13 @@ export type ResolvedSlot = {
     provider: AIProvider;
     model: AIModel;
 };
-export type RegistryOptions = {
+export type AIRegistryOptions = {
     settings: AISettings;
     /**
      * Optional server-distributed catalogue of supported models per provider.
      * When omitted, each provider uses its compiled-in defaults (e.g. `ANTHROPIC_MODELS`).
      * The host typically fetches this from an API and either passes it at
-     * construction time or swaps it in later via {@link Registry.updateCatalog}.
+     * construction time or swaps it in later via {@link AIRegistry.updateCatalog}.
      */
     catalog?: AIModelCatalog;
     /** Pass an existing `KeyStore` to share its in-memory cache across registries. */
@@ -26,25 +26,25 @@ export type RegistryOptions = {
  * Owns one instance of every configured provider, resolves task slots with
  * fallback, and is the only place feature code calls to start a completion.
  *
- * The `Registry` is stateless beyond its provider list — it doesn't observe
- * settings on its own. Call {@link Registry.updateSettings} when settings
+ * The `AIRegistry` is stateless beyond its provider list — it doesn't observe
+ * settings on its own. Call {@link AIRegistry.updateSettings} when settings
  * change to rebuild providers.
  *
  * @example
  * ```ts
- * const registry = new Registry({ settings })
+ * const registry = new AIRegistry({ settings })
  * const events = await registry.streamCompletion('default', { messages })
  * for await (const event of events) {
  *   if (event.kind === 'text-delta') process.stdout.write(event.delta)
  * }
  * ```
  */
-export declare class Registry {
+export declare class AIRegistry {
     readonly keyStore: KeyStore;
     private providers;
     private settings;
     private catalog;
-    constructor(options: RegistryOptions);
+    constructor(options: AIRegistryOptions);
     /** All configured providers, sorted alphabetically by id. */
     listProviders(): AIProvider[];
     getProvider(id: string): AIProvider | undefined;
@@ -59,12 +59,17 @@ export declare class Registry {
      * Order:
      *   1. Explicit binding `settings.slots[slot]`, if both provider and model resolve.
      *   2. For `'fast'` only: fall back to `settings.slots.default`.
-     *   3. First authenticated provider in alphabetical id order, taking that
+     *   3. Preferred provider `settings.providerId`, if that provider is configured,
+     *      taking its `defaultModel()` (or `defaultFastModel()` for the fast slot).
+     *      Authentication is not gated here — the user explicitly picked this
+     *      provider; auth errors surface at stream time rather than silently
+     *      swapping providers.
+     *   4. First authenticated provider in alphabetical id order, taking that
      *      provider's `defaultModel()` (or `defaultFastModel()` for the fast slot).
      *      Mirrors Zed's `available_fallback_model` without the Zed-Cloud preference.
-     *   4. `undefined` if no provider can satisfy the slot.
+     *   5. `undefined` if no provider can satisfy the slot.
      *
-     * Async because the third step calls `provider.isAuthenticated()`, which may
+     * Async because the fourth step calls `provider.isAuthenticated()`, which may
      * touch the keyring.
      */
     resolveSlot(slot: SlotName): Promise<ResolvedSlot | undefined>;
@@ -72,7 +77,7 @@ export declare class Registry {
     /**
      * Streams a completion for a task slot.
      *
-     * Resolves the slot via {@link Registry.resolveSlot}; throws {@link NoApiKey}
+     * Resolves the slot via {@link AIRegistry.resolveSlot}; throws {@link NoApiKey}
      * if no provider can satisfy it (no slot binding, and no authenticated
      * provider available for the implicit fallback). Otherwise returns the
      * model's stream — note that *upstream* errors (auth, rate limit, etc.)

package/types/settings.d.ts

@@ -77,7 +77,7 @@ export type AnthropicProviderConfig = CommonProviderConfig & {
 };
 /**
  * Top-level AI configuration. The host (Inkdrop main process) constructs this
- * from whichever persistence layer it uses and passes it to `Registry`.
+ * from whichever persistence layer it uses and passes it to `AIRegistry`.
  *
  * The library never reads or writes settings to disk itself.
  */
@@ -87,8 +87,17 @@ export type AISettings = {
         openaiCompatible?: OpenAICompatibleProviderConfig[];
     };
     /**
-     * Per-slot model overrides. Unset slots fall back to the first registered
-     * provider's `defaultModel` / `defaultFastModel`.
+     * Preferred provider for every task slot. When set (and the per-slot
+     * `slots[slot]` override isn't), each slot resolves to this provider's
+     * `defaultModel` / `defaultFastModel`. This is the simple UI knob — bind it
+     * to a single "AI provider" dropdown.
+     */
+    providerId?: string;
+    /**
+     * Per-slot `(provider, model)` overrides. Wins over `providerId` when set.
+     * Useful for advanced configurations that pin a specific model per slot or
+     * mix providers across slots (e.g. Claude for `default`, a local model for
+     * `fast`).
      */
     slots?: Partial<Record<SlotName, SlotConfig>>;
 };