@cotal-ai/pi 0.108.1 → 0.109.0

package/dist/index.js

@@ -27449,10 +27449,10 @@ import { isConcreteChannel as isConcreteChannel3, channelInAllow as channelInAll
 import { parsePrincipalKey as parsePrincipalKey2, peerLabel as peerLabel3 } from "@cotal-ai/core";
 
 // ../connector-core/dist/docs-bundle.generated.js
-var DOCS_VERSION = "0.108.1";
+var DOCS_VERSION = "0.109.0";
 function loadDocsBundle() {
   return {
-    "version": "0.108.1",
+    "version": "0.109.0",
     "generatedFrom": "docs/*.md + SPEC.md + spec/cotal-lang.md + spec/cotal.schema.json",
     "pages": [
       {

package/dist/standalone.js

@@ -45114,6 +45114,8 @@ function claims(ext) {
 }
 var Registry = class {
   #byKey = /* @__PURE__ */ new Map();
+  /** `kind:name` → the declared provider that registers it, and its import once one has started. */
+  #providers = /* @__PURE__ */ new Map();
   /** `kind:alias` → the claiming extension's `kind:name` key, for committed extensions. */
   #aliases = /* @__PURE__ */ new Map();
   /** While a stage is active in the CURRENT async context, {@link register} writes there instead of
@@ -45200,13 +45202,47 @@ var Registry = class {
     return this.#aliases.get(key) ?? key;
   }
   /** Resolve one extension by kind + name or alias. Unknown throws. Staged (uncommitted) registrations are
-   *  invisible here; only committed ones resolve. */
+   *  invisible here; only committed ones resolve. A key whose declared provider has not loaded throws
+   *  too, naming that: {@link load} resolves it. */
   resolve(kind, name) {
     const ext = this.#byKey.get(this.#canonical(kind, name));
-    if (!ext)
+    if (!ext) {
+      if (this.#providers.has(`${kind}:${name}`))
+        throw new Error(`${kind} "${name}" is declared by a provider this process has not loaded`);
       throw new Error(`no ${kind} registered for "${name}"`);
+    }
     return ext;
   }
+  /** Declare a provider: a module that registers `provides` when it is imported. Nothing is imported
+   *  here. A key that another provider already declares is refused, so a key has one provider. */
+  provide(provider) {
+    const keys = provider.provides.map((ref) => `${ref.kind}:${ref.name}`);
+    for (const key of keys)
+      if (this.#providers.has(key))
+        throw new Error(`extension provider already declared: ${key}`);
+    const entry = { provider };
+    for (const key of keys)
+      this.#providers.set(key, entry);
+  }
+  /** Whether a provider was declared for exactly this kind + name, loaded or not. A boolean probe
+   *  that never throws and imports nothing. */
+  provides(kind, name) {
+    return this.#providers.has(`${kind}:${name}`);
+  }
+  /** Resolve kind + name, first importing the provider declared for it unless that import has run.
+   *  Concurrent calls share one import. A key no provider declares resolves as {@link resolve} does.
+   *  A provider that loads without registering the key it declared throws: the declaration is wrong,
+   *  and no other extension stands in for it. */
+  async load(kind, name) {
+    const entry = this.#providers.get(`${kind}:${name}`);
+    if (entry) {
+      entry.loading ??= entry.provider.load();
+      await entry.loading;
+      if (!this.#byKey.has(this.#canonical(kind, name)))
+        throw new Error(`the provider declared for ${kind} "${name}" loaded without registering it`);
+    }
+    return this.resolve(kind, name);
+  }
   all(kind) {
     const values = [...this.#byKey.values()];
     return kind === void 0 ? values : values.filter((e) => e.kind === kind);
@@ -65891,10 +65927,10 @@ function date4(params) {
 config(en_default());
 
 // ../connector-core/dist/docs-bundle.generated.js
-var DOCS_VERSION = "0.108.1";
+var DOCS_VERSION = "0.109.0";
 function loadDocsBundle() {
   return {
-    "version": "0.108.1",
+    "version": "0.109.0",
     "generatedFrom": "docs/*.md + SPEC.md + spec/cotal-lang.md + spec/cotal.schema.json",
     "pages": [
       {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cotal-ai/pi",
-  "version": "0.108.1",
+  "version": "0.109.0",
   "license": "Apache-2.0",
   "keywords": [
     "cotal",
@@ -34,8 +34,8 @@
     "@earendil-works/pi-tui": ">=0.79.10"
   },
   "devDependencies": {
-    "@cotal-ai/core": "0.108.1",
-    "@cotal-ai/connector-core": "0.108.1",
+    "@cotal-ai/core": "0.109.0",
+    "@cotal-ai/connector-core": "0.109.0",
     "@cotal-ai/smoke-kit": "0.0.0",
     "@earendil-works/pi-ai": "0.79.10",
     "@earendil-works/pi-coding-agent": "0.79.10",