@gaia-ai/core 0.9.2 → 0.10.0

package/dist/src/cli/load-gaia-config.d.ts

@@ -16,6 +16,16 @@ export interface GaiaConnectionConfig {
     source: GaiaConfigSource;
     /** true when the loaded file is a legacy `conductor.config.js` connection. */
     legacy: boolean;
+    /**
+     * GAIA-373: UI extension entry modules discovered from `addons[]`, as
+     * RESOLVED `file://` URLs (see `resolveUiEntries` for why resolution happens
+     * here rather than at the import).
+     *
+     * Nothing is imported — `gaia dropsh` loads this same connection and never
+     * renders a TUI, so the cost of a UI contribution must not be paid until
+     * `gaia ui`'s kernel actually boots (spec F2/D3).
+     */
+    ui_entries: string[];
 }
 /**
  * Load the connection config for `gaia ui` / `gaia dropsh` / conductor-auth.

package/dist/src/cli/load-gaia-config.js

@@ -115,5 +115,35 @@ export async function loadGaiaConfig(host, opts = {}) {
         fallback: resolution.fallback,
         source: resolution.source,
         legacy: resolution.legacy,
+        ui_entries: discovered ? resolveUiEntries(discovered.uiEntries, bases) : [],
     };
 }
+/**
+ * Resolve each UI entry specifier to an importable file URL — GAIA-373.
+ *
+ * Resolution belongs HERE, against the very bases that found the addon's
+ * `./preset`, and not in the renderer that eventually imports them. A preset
+ * names a package specifier (`@gaia-ai/addon-x/ui`) because that is what its
+ * author can honestly write; but the module that imports it is the TUI kernel,
+ * inside `@gaia-ai/addon-gaia-ui`, and a bare specifier there resolves against
+ * THAT package's dependencies. A contribution addon is its SIBLING, never its
+ * dependency — the layered DAG forbids the backwards edge — so the bare import
+ * fails, and it fails at cockpit boot rather than at config load.
+ *
+ * Measured, not reasoned: `gaia ui GAIA-373` with the addon listed reported
+ * `Cannot find module '@gaia-ai/addon-gaia-ui-artifacts/ui' from
+ * .../addons/gaia-ui/dist/src/Extension/load.js`.
+ *
+ * Still NOTHING IS IMPORTED here (F2): a resolve is a path lookup, and the
+ * megabytes behind the specifier stay unloaded until a TUI actually boots.
+ */
+function resolveUiEntries(entries, bases) {
+    return entries.map((entry) => {
+        const resolved = resolveModuleEslintStyle(entry, bases);
+        if (resolved === undefined) {
+            throw new Error(`gaia.config.js cannot resolve UI entry '${entry}' — the addon that ` +
+                'contributes it must be installed where the config can see it');
+        }
+        return pathToFileURL(resolved).href;
+    });
+}

package/dist/src/plugins/preset.d.ts

@@ -60,6 +60,18 @@ export interface DiscoveredContributions {
     /** Opaque: `AgentCandidate[]` on the conductor surface. */
     agents: unknown[];
     connectionPlugins: DropSHPlugin[];
+    /**
+     * GAIA-373: UI extension entry MODULES — specifiers, never constructed
+     * contributions.
+     *
+     * Storybook's `managerEntries` model, and load-bearing for a measured reason:
+     * `discoverAddons` runs on every connection load (`gaia dropsh` included), and
+     * `@opentui/core` is megabytes of native code that a preset returning objects
+     * would pull onto that path — the very import GAIA-326 had to make dynamic.
+     * Concretely typed rather than opaque: a specifier is a string, so the kernel
+     * needs no foreign type for it and stays surface-agnostic all the same.
+     */
+    uiEntries: string[];
 }
 /**
  * An OPAQUE per-surface accumulator. The kernel threads it without knowing its
@@ -87,6 +99,7 @@ export interface GaiaPreset<O = unknown> {
     workspaces?: OpaqueAccumulator<O>;
     agents?: OpaqueAccumulator<O>;
     connectionPlugins?: (acc: DropSHPlugin[], opts: O) => DropSHPlugin[] | Promise<DropSHPlugin[]>;
+    uiEntries?: (acc: string[], opts: O) => string[] | Promise<string[]>;
 }
 /** The preset function keys, for shape-detection during discovery. */
 export declare const PRESET_FUNCTION_KEYS: Array<keyof DiscoveredContributions>;

package/dist/src/plugins/preset.js

@@ -28,7 +28,7 @@
 export const SURFACE_KEYS = {
     command: ['commands'],
     conductor: ['remotes', 'executors', 'workspaces', 'agents'],
-    connection: ['connectionPlugins'],
+    connection: ['connectionPlugins', 'uiEntries'],
 };
 /** The preset function keys, for shape-detection during discovery. */
 export const PRESET_FUNCTION_KEYS = [
@@ -38,6 +38,7 @@ export const PRESET_FUNCTION_KEYS = [
     'workspaces',
     'agents',
     'connectionPlugins',
+    'uiEntries',
 ];
 /** An empty contributions accumulator. */
 export function emptyContributions() {
@@ -48,5 +49,6 @@ export function emptyContributions() {
         workspaces: [],
         agents: [],
         connectionPlugins: [],
+        uiEntries: [],
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gaia-ai/core",
-  "version": "0.9.2",
+  "version": "0.10.0",
   "description": "GAIA surface-agnostic kernel: host contract, split-config helpers, addon preset/discovery machinery, shared primitives.",
   "type": "module",
   "license": "MIT",