@k9o/extensions 1.2.0 → 1.3.0

package/README.md

@@ -2,7 +2,11 @@
 
 Typed bindings for Kilimanjaro platform extensions, resolved by slug with `k9o.extension(slug)`.
 
-Kilimanjaro is an AI-native platform on a Governed Database. Its products are Keep (AI Security and Governance), Pulse (Data Intelligence), Gate (Customer Identity and Access Management) and Kibo (Keys and Secrets Management).
+> **This package is a placeholder.** Every method rejects until the platform serves extension calls.
+> If you are writing an extension, use `@k9o/extensions-sdk` instead. It is not on npm yet.
+
+Kilimanjaro is the AI-native foundation for building critical applications. Its products are Keep (AI Security and Governance),
+Pulse (Data Intelligence), Gate (Customer Identity and Access Management) and Kibo (Keys and Secrets Management).
 
 ## Contents
 
@@ -38,26 +42,34 @@ Requires TypeScript 5.6+ for the bundled types. See [Requirements](#requirements
 
 ## Quick start
 
+Resolve a binding by slug. Calling any method rejects, because no request is sent.
+
 ```ts
 import { k9o } from "@k9o/extensions";
 
 const cairn = k9o.extension("cairn");
 
-async function createTasksCollection() {
-  return cairn.collections.create({ name: "tasks", dimension: 3, metric: "cosine" });
+try {
+  await cairn.collections.list();
+} catch (error) {
+  console.log(error instanceof Error ? error.message : error);
 }
 ```
 
+```text
+cairn.collections.list is not available yet: the extension runtime is not implemented in this version of @k9o/extensions.
+```
+
 - The returned object is typed for the slug you pass.
 - An unknown slug is a compile-time error, and it also throws an `Error` at runtime.
-- See [Methods by extension](#methods-by-extension) for what each extension offers.
+- See [Methods by extension](#methods-by-extension) for the typed contract of each extension.
 
 ## Current limitations
 
-- In this release the bindings define the typed contract only.
+- The bindings define the typed contract only. They do not work yet.
 - Calling a method rejects with an `Error` saying the runtime is not implemented.
 - No request is sent to the platform.
-- Until method dispatch is available, call extensions over HTTP.
+- Extension authors should use `@k9o/extensions-sdk`, which is not yet on npm.
 
 ## Using through @k9o/core
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k9o/extensions",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Kilimanjaro extensions consumption SDK — k9o.extension(slug) typed Stack-SDK factory. Sibling of @k9o/gate (Identity-Aware Kernel) and future @k9o/kibo (data/compute pillar) per 3-pillar brand architecture.",
   "type": "module",
   "main": "./dist/index.js",