@jskit-ai/connectors-catalog 0.2.11 → 0.2.13

package/CHANGELOG.md

@@ -2,6 +2,7 @@
 
 ## Unreleased
 
+- The browser catalog (`./shared`) no longer bundles the whole AI model snapshot. The AI connector definition now reads only the 13 configurable providers (0.2 MB, in `ai-models.json`). The other 200 providers, which are framework metadata (2.0 MB), moved to `ai-framework-models.json`, which only `./shared/ai` and `./server/ai` load. Exports, the catalogue and every configurable model's choices, hints and credential scopes are unchanged. The definition no longer recognises a framework provider's model key, which its settings schema already rejected.
 - The Resend guide shows local auth's `auth.local.confirmation-sender` next to its recovery sender.
 
 ## 0.2.0 - 2026-10-29

package/docs/ai-upstream-notices.md

@@ -1,6 +1,6 @@
 # AI catalogue upstream notices
 
-The bundled snapshot is derived from models.dev data and OpenCode’s public-access rule. Both are MIT licensed. See `src/shared/ai-models.json` for retrieval date, URLs and source hashes. No upstream code executes at runtime.
+The bundled snapshot is derived from models.dev data and OpenCode’s public-access rule. Both are MIT licensed. See `src/shared/ai-models.json` for retrieval date, URLs and source hashes; the providers that are not configurable are in `src/shared/ai-framework-models.json`. No upstream code executes at runtime.
 
 ## models.dev
 

package/docs/ai.md

@@ -39,6 +39,15 @@ The raw-source hashes and source URLs are in the bundled `ai-models.json`;
 [upstream MIT notices](ai-upstream-notices.md) accompany it. Updates require
 deliberate review and a new package release.
 
+The snapshot is kept in two files. `ai-models.json` holds the extraction's
+details and the 13 configurable providers. `ai-framework-models.json` holds the
+other 200 providers, which are framework metadata. The AI connector definition
+in `@jskit-ai/connectors-catalog/shared` needs only the configurable providers,
+so a browser bundle of the catalog carries about 0.2 MB of model data instead of
+the 2.2 MB snapshot. `./shared/ai` and `./server/ai` load both files and see the
+whole catalogue. When the snapshot is refreshed, keep each provider in the file
+that matches whether it is configurable.
+
 The reviewed catalogue adds the exact `deepseek/deepseek-flash` identity for
 DeepSeek V4.1 Flash. It retains `deepseek/deepseek-v4-flash` and
 `deepseek/deepseek-v4-flash-vision-exp` for saved selections: DeepSeek still

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/connectors-catalog",
-  "version": "0.2.11",
+  "version": "0.2.13",
   "description": "Provider definitions and focused API operations for JSKIT connectors.",
   "type": "module",
   "exports": {
@@ -125,14 +125,14 @@
     "@aws-sdk/client-redshift-data": "3.1128.0",
     "@aws-sdk/client-s3": "3.1128.0",
     "@aws-sdk/s3-request-presigner": "3.1128.0",
-    "@jskit-ai/connectors-core": "0.2.11",
+    "@jskit-ai/connectors-core": "0.2.13",
     "@modelcontextprotocol/sdk": "1.32.1",
     "@smithy/fetch-http-handler": "5.8.0",
     "jose": "^6.1.3",
     "json-rest-schema": "^1.0.17"
   },
   "peerDependencies": {
-    "@jskit-ai/kernel": "0.2.10"
+    "@jskit-ai/kernel": "0.2.12"
   },
   "jskit": {
     "kind": "runtime",
@@ -150,6 +150,6 @@
     }
   },
   "scripts": {
-    "test": "node --test --test-concurrency=1"
+    "test": "jskit test"
   }
 }

package/patterns/aws-storage-queries/example/formats/package.json

@@ -2,7 +2,7 @@
   "name": "s3-native-format-example",
   "private": true,
   "type": "module",
-  "scripts": { "test": "node --test --test-concurrency=1 verify-formats.mjs" },
+  "scripts": { "test": "node verify-formats.mjs" },
   "dependencies": {
     "csv-parse": "7.0.2",
     "csv-stringify": "6.8.3",

package/src/shared/ai-definition.js

@@ -0,0 +1,68 @@
+import { createSchema } from "json-rest-schema";
+// The AI connector's definition, from the configurable providers alone: ai-models.json holds the extraction's details
+// and the configurable (direct API-key) providers; the other providers, framework metadata, are in
+// ai-framework-models.json, which only the catalogue (ai.js) loads. So the browser catalog ("./shared") carries this
+// connector without the whole model snapshot.
+import snapshot from "./ai-models.json" with { type: "json" };
+
+// Message keys; render them with the app's text helper (useJskitText().text).
+const aiAccessLabels = Object.freeze({
+  "free-no-setup": "jskit.connectors.ai.access.freeNoSetup",
+  "free-with-connection": "jskit.connectors.ai.access.freeWithConnection",
+  paid: "jskit.connectors.ai.access.paid",
+  unknown: "jskit.connectors.ai.access.unknown"
+});
+const selectedModelHints = Object.freeze({
+  "free-no-setup": "jskit.connectors.ai.fields.model.selectedHint.freeNoSetup",
+  "free-with-connection": "jskit.connectors.ai.fields.model.selectedHint.freeWithConnection",
+  paid: "jskit.connectors.ai.fields.model.selectedHint.paid",
+  unknown: "jskit.connectors.ai.fields.model.selectedHint.unknown"
+});
+const accessOrder = ["free-no-setup", "free-with-connection", "paid", "unknown"];
+const byAccessThenKey = (a, b) => accessOrder.indexOf(a.access) - accessOrder.indexOf(b.access) || a.key.localeCompare(b.key);
+// A provider record with its connection kind and each model's catalogue key.
+const catalogueProvider = (provider, connection) => Object.freeze({
+  ...provider, connection,
+  models: Object.freeze(provider.models.map((model) => Object.freeze({ ...model, key: `${provider.id}/${model.id}`, providerId: provider.id })))
+});
+// These direct API-key routes need no coding subscription or cloud identity exchange.
+const configurableProviders = Object.freeze(snapshot.providers.map((provider) => catalogueProvider(provider, "api-key")));
+const catalogueDateFormat = Object.freeze({ day: "numeric", month: "long", year: "numeric", timeZone: "UTC" });
+const configurableModels = new Map(configurableProviders.flatMap((provider) => provider.models.map((model) => [model.key, model])));
+
+const activeModels = [...configurableModels.values()].filter((model) => model.status !== "deprecated").sort(byAccessThenKey);
+const modelItems = Object.freeze(activeModels.map((model) => Object.freeze({
+  value: model.key, title: `${model.name} (${model.providerId})`, props: { subtitle: aiAccessLabels[model.access] }
+})));
+const aiDefinition = Object.freeze({
+  id: "ai", name: "AI", description: "jskit.connectors.ai.description",
+  accountModes: ["shared", "per-user"], authenticationMethods: ["api-key", "none"], scopes: [],
+  authenticationMethodsForSettings: (settings = {}) => configurableModels.get(settings.model)?.access === "free-no-setup"
+    ? ["none", "api-key"] : ["api-key"],
+  authenticationLabels: { none: "jskit.connectors.ai.authenticationLabels.none", "api-key": "jskit.connectors.ai.authenticationLabels.apiKey" },
+  authenticationHint: "jskit.connectors.ai.authenticationHint",
+  settingsSchema: createSchema({ model: { type: "string", required: true,
+    enum: modelItems.map((item) => item.value) } }),
+  settingsFields: [{ name: "model", label: "jskit.connectors.ai.fields.model.label", searchable: true, items: modelItems,
+    credentialScope: (key) => configurableModels.get(key)?.providerId,
+    // The catalogue date is display text: formatDate (useJskitText's) uses the app's active
+    // locale; without an app language it keeps its fixed English form.
+    hint: (settings = {}, { formatDate } = {}) => {
+      const model = configurableModels.get(settings.model);
+      const date = formatDate ? formatDate(snapshot.extractedAt, catalogueDateFormat)
+        : new Date(snapshot.extractedAt).toLocaleDateString("en-GB", catalogueDateFormat);
+      return model ? { key: selectedModelHints[model.access], params: { model: model.name, date } }
+        : { key: "jskit.connectors.ai.fields.model.hint", params: { date } };
+    } }],
+  apiKeyReferenceHint: "jskit.connectors.ai.apiKeyReferenceHint",
+  setup: {
+    url: "https://opencode.ai/docs/zen/",
+    steps: [
+      "Choose a provider and model; no model is preselected. Create a regular API key in that provider's dashboard. Z.AI's GLM-4.7-Flash uses a regular Z.AI key; its Coding Plan is a different product.",
+      "For a shared account, store the administrator's key in Env. For individual accounts, your application must provide private key entry, storage and disconnect controls for each authenticated user.",
+      "Saving selects configuration; it does not verify a provider account or install an AI library into your application. Follow the AI connection guide for the selected framework."
+    ]
+  }
+});
+
+export { aiAccessLabels, aiDefinition, byAccessThenKey, catalogueProvider, configurableProviders };