@kindgi/capabilities 0.1.8-rc.0 → 0.1.9-rc.0

package/dist/clients-by-key.d.ts

@@ -0,0 +1,20 @@
+/**
+ * An adapter's SDK clients, one per key it was called with. Calls that
+ * take turns with two keys (a run in each of two projects, each project
+ * with a key of its own) each reuse their own client, and whatever it
+ * holds (an auth client, a token), where a single slot would build a client
+ * on every turn. A rotated key builds a new client; the old one goes once
+ * `max` newer keys are used.
+ *
+ * Held by a SHA-256 of the key, never the key itself. At most `max`
+ * clients (default 16), the least recently used dropped first.
+ *
+ * Node only (`node:crypto`): it's the `@kindgi/capabilities/clients-by-key`
+ * entry, apart from the package's runtime-neutral main entry.
+ */
+export interface ClientsByKey<C> {
+    /** The client for `key`: the one built for it before, else `build()`'s, kept. */
+    get(key: string, build: () => C): C;
+}
+export declare function createClientsByKey<C>(max?: number): ClientsByKey<C>;
+//# sourceMappingURL=clients-by-key.d.ts.map

package/dist/clients-by-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients-by-key.d.ts","sourceRoot":"","sources":["../src/clients-by-key.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,iFAAiF;IACjF,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;CACrC;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,GAAG,SAAK,GAAG,YAAY,CAAC,CAAC,CAAC,CAwB/D"}

package/dist/clients-by-key.js

@@ -0,0 +1,30 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+import { createHash } from 'node:crypto';
+export function createClientsByKey(max = 16) {
+    if (!Number.isInteger(max) || max < 1) {
+        throw new RangeError(`createClientsByKey: max must be a whole number, 1 or more, not ${max}`);
+    }
+    // A Map keeps insertion order: an entry set again is the newest.
+    const clients = new Map();
+    return {
+        get(key, build) {
+            const id = createHash('sha256').update(key).digest('base64url');
+            const known = clients.get(id);
+            if (known !== undefined) {
+                clients.delete(id);
+                clients.set(id, known);
+                return known;
+            }
+            const client = build();
+            clients.set(id, client);
+            if (clients.size > max) {
+                const oldest = clients.keys().next();
+                if (oldest.done !== true)
+                    clients.delete(oldest.value);
+            }
+            return client;
+        },
+    };
+}
+//# sourceMappingURL=clients-by-key.js.map

package/dist/clients-by-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients-by-key.js","sourceRoot":"","sources":["../src/clients-by-key.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC;AAEjC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAqBzC,MAAM,UAAU,kBAAkB,CAAI,GAAG,GAAG,EAAE;IAC5C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,UAAU,CAAC,kEAAkE,GAAG,EAAE,CAAC,CAAC;IAChG,CAAC;IACD,iEAAiE;IACjE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAa,CAAC;IACrC,OAAO;QACL,GAAG,CAAC,GAAG,EAAE,KAAK;YACZ,MAAM,EAAE,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YAChE,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC9B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACnB,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;gBACvB,OAAO,KAAK,CAAC;YACf,CAAC;YACD,MAAM,MAAM,GAAG,KAAK,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YACxB,IAAI,OAAO,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC;gBACvB,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;gBACrC,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI;oBAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACzD,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kindgi/capabilities",
-  "version": "0.1.8-rc.0",
+  "version": "0.1.9-rc.0",
   "description": "Capability declarations + provider router for Kindgi™. Agents declare what they need from a model (features such as structured-output or tool-use, context window, cost, region, latency, provider and model allow/deny lists) and what they prefer; the router picks a registered (provider, model) pair that satisfies every hard constraint plus tenant policy, ranked by soft preferences, and reports per requirement which candidates it rejected when none qualify. Also the provider-neutral ModelProvider contract, a tenant-scoped provider registry, and an adapter-factory registry. Capability kinds are open strings matched by equality; llm-inference is the default.",
   "license": "Apache-2.0",
   "repository": {
@@ -26,6 +26,11 @@
       "import": "./dist/attempts.js",
       "default": "./dist/attempts.js"
     },
+    "./clients-by-key": {
+      "types": "./dist/clients-by-key.d.ts",
+      "import": "./dist/clients-by-key.js",
+      "default": "./dist/clients-by-key.js"
+    },
     "./tool-names": {
       "types": "./dist/tool-names.d.ts",
       "import": "./dist/tool-names.js",
@@ -40,12 +45,12 @@
     "type-manifest.json"
   ],
   "dependencies": {
-    "@kindgi/platform": "0.1.8-rc.0",
-    "@kindgi/schema": "0.1.8-rc.0",
-    "@kindgi/types": "0.1.8-rc.0"
+    "@kindgi/platform": "0.1.9-rc.0",
+    "@kindgi/schema": "0.1.9-rc.0",
+    "@kindgi/types": "0.1.9-rc.0"
   },
   "devDependencies": {
-    "@kindgi/specs": "0.1.8-rc.0",
+    "@kindgi/specs": "0.1.9-rc.0",
     "@types/node": "^22.10.5",
     "typescript": "^5.7.3",
     "vitest": "^2.1.8"

package/src/clients-by-key.ts

@@ -0,0 +1,49 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+
+import { createHash } from 'node:crypto';
+
+/**
+ * An adapter's SDK clients, one per key it was called with. Calls that
+ * take turns with two keys (a run in each of two projects, each project
+ * with a key of its own) each reuse their own client, and whatever it
+ * holds (an auth client, a token), where a single slot would build a client
+ * on every turn. A rotated key builds a new client; the old one goes once
+ * `max` newer keys are used.
+ *
+ * Held by a SHA-256 of the key, never the key itself. At most `max`
+ * clients (default 16), the least recently used dropped first.
+ *
+ * Node only (`node:crypto`): it's the `@kindgi/capabilities/clients-by-key`
+ * entry, apart from the package's runtime-neutral main entry.
+ */
+export interface ClientsByKey<C> {
+  /** The client for `key`: the one built for it before, else `build()`'s, kept. */
+  get(key: string, build: () => C): C;
+}
+
+export function createClientsByKey<C>(max = 16): ClientsByKey<C> {
+  if (!Number.isInteger(max) || max < 1) {
+    throw new RangeError(`createClientsByKey: max must be a whole number, 1 or more, not ${max}`);
+  }
+  // A Map keeps insertion order: an entry set again is the newest.
+  const clients = new Map<string, C>();
+  return {
+    get(key, build) {
+      const id = createHash('sha256').update(key).digest('base64url');
+      const known = clients.get(id);
+      if (known !== undefined) {
+        clients.delete(id);
+        clients.set(id, known);
+        return known;
+      }
+      const client = build();
+      clients.set(id, client);
+      if (clients.size > max) {
+        const oldest = clients.keys().next();
+        if (oldest.done !== true) clients.delete(oldest.value);
+      }
+      return client;
+    },
+  };
+}