@clinebot/llms 0.0.21 → 0.0.23

package/README.md

@@ -6,10 +6,9 @@ LLM backends.
 
 ## What You Get
 
-- `providers` for creating runtime handlers and working with provider settings
-- `models` for browsing generated model catalogs
-- `defineLlmsConfig(...)` for declarative SDK config
-- `createLlmsSdk(...)` for higher-level provider/model workflows
+- `@clinebot/llms/runtime` for declarative config and runtime registry creation
+- `@clinebot/llms/providers` for handler creation and provider settings/types
+- `@clinebot/llms/models` for model catalogs and query helpers
 
 ## Installation
 
@@ -20,7 +19,7 @@ npm install @clinebot/llms zod
 ## Quick Start
 
 ```ts
-import { LlmsProviders } from "@clinebot/llms";
+import * as LlmsProviders from "@clinebot/llms/providers";
 
 const handler = LlmsProviders.createHandler({
 	provider: "anthropic",
@@ -40,9 +39,24 @@ for await (const chunk of stream) {
 
 ## Main APIs
 
+### Runtime
+
+Use `createLlmsRuntime(...)` when you want a small registry around:
+
+- configured providers and their default models
+- builtin provider discovery via `getBuiltInProviders()`
+- custom provider registration via `registerBuiltinProvider(...)`
+- handler creation for builtin or custom providers
+
+Preferred import:
+
+```ts
+import { createLlmsRuntime, defineLlmsConfig } from "@clinebot/llms/runtime";
+```
+
 ### Providers
 
-Use the `providers` namespace for:
+Use `@clinebot/llms/providers` for:
 
 - `createHandler(...)` and `createHandlerAsync(...)`
 - `ProviderSettings` and `ProviderSettingsSchema`
@@ -51,14 +65,17 @@ Use the `providers` namespace for:
 
 ### Models
 
-Use the `models` namespace when you need generated provider/model metadata for
+Use `@clinebot/llms/models` when you need generated provider/model metadata for
 selection UIs, defaults, or validation.
 
 ## Entry Points
 
-- `@clinebot/llms`: default package entrypoint
+- `@clinebot/llms`: runtime-focused convenience entrypoint
 - `@clinebot/llms/node`: explicit Node/runtime entrypoint
 - `@clinebot/llms/browser`: browser-safe bundle
+- `@clinebot/llms/runtime`: focused runtime entrypoint
+- `@clinebot/llms/models`: model catalog/query entrypoint
+- `@clinebot/llms/providers`: provider handler/settings entrypoint
 
 ## Related Packages
 

package/dist/index.browser.d.ts

@@ -1,5 +1,4 @@
 export { defineLlmsConfig, loadLlmsConfigFromFile } from "./config-browser";
-export * as LlmsModels from "./models/index";
-export * as LlmsProviders from "./providers/public.browser";
-export type { CustomProviderConfig, LlmsConfig, LlmsSdk, ProviderSelectionConfig, } from "./types";
+export { createLlmsRuntime } from "./runtime";
+export type { BuiltInProviderSummary, CustomProviderConfig, LlmsConfig, LlmsSdk, ProviderSelectionConfig, RegisterBuiltinProviderInput, } from "./types";
 //# sourceMappingURL=index.browser.d.ts.map

package/dist/index.browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.browser.d.ts","sourceRoot":"","sources":["../src/index.browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,KAAK,UAAU,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,aAAa,MAAM,4BAA4B,CAAC;AAC5D,YAAY,EACX,oBAAoB,EACpB,UAAU,EACV,OAAO,EACP,uBAAuB,GACvB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.browser.d.ts","sourceRoot":"","sources":["../src/index.browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,YAAY,EACX,sBAAsB,EACtB,oBAAoB,EACpB,UAAU,EACV,OAAO,EACP,uBAAuB,EACvB,4BAA4B,GAC5B,MAAM,SAAS,CAAC"}