@cotal-ai/connector-jcode 0.108.1 → 0.109.0

package/dist/host.js

@@ -45082,6 +45082,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
@@ -45168,13 +45170,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);
@@ -65882,10 +65918,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/dist/mcp.js

@@ -57541,6 +57541,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
@@ -57627,13 +57629,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);
@@ -58085,10 +58121,10 @@ async function submitFeedback(input, options = {}) {
 import { execFileSync } from "node:child_process";
 
 // ../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,7 +1,7 @@
 {
   "name": "@cotal-ai/connector-jcode",
   "description": "Cotal connector for Jcode: a host-mode mesh peer driven through Jcode's Harness API bridge.",
-  "version": "0.108.1",
+  "version": "0.109.0",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -26,8 +26,8 @@
     "smol-toml": "^1.8.0"
   },
   "devDependencies": {
-    "@cotal-ai/connector-core": "0.108.1",
-    "@cotal-ai/core": "0.108.1",
+    "@cotal-ai/connector-core": "0.109.0",
+    "@cotal-ai/core": "0.109.0",
     "@cotal-ai/smoke-kit": "0.0.0",
     "esbuild": "^0.28.0",
     "tsx": "^4.22.4",