@gaia-ai/addon-essentials 0.9.2 → 0.11.0

package/README.md

@@ -1,5 +1,5 @@
 # @gaia-ai/addon-essentials
 
-GAIA aggregator plugin: auto-loads the config-free dropsh essentials (markdown + authoritative JSON:API schema).
+GAIA aggregator plugin: auto-loads the dropsh essentials (markdown + authoritative JSON:API schema) and the ambient-workspace filler.
 
 Part of the GAIA CLI. Install the meta package `@gaia-ai/gaia` to get the `gaia` CLI with all addons. Source: https://git.key-tec.de/keytec/gaia (gaia-cli/).

package/dist/src/children.d.ts

@@ -0,0 +1,23 @@
+import type { DropSHPlugin } from 'dropsh/plugin';
+/** Options essentials forwards to the children that take any. */
+export interface EssentialsOptions {
+    /**
+     * GAIA-351: the ambient workspace uuid. It is the connection config's
+     * top-level, REQUIRED `workspace_id`, handed to every preset/descriptor as a
+     * global option by `loadGaiaConfig` — never written under an addon entry.
+     */
+    workspace_id?: string;
+}
+/**
+ * The config-free essentials (markdown renderer, authoritative JSON:API schema
+ * and GAIA-403's name resolver, which lives in its own
+ * `@gaia-ai/addon-name-refs` package) plus GAIA-351's ambient-workspace filler.
+ *
+ * The workspace child is the one that reads an option, and it is appended only
+ * when a uuid is actually present. That guard is not a "configured?" toggle —
+ * `workspace_id` is required at config load, so a missing one means this
+ * discovery bypassed `loadGaiaConfig` entirely (a hand-built context, a test),
+ * where contributing a plugin with no uuid to inject would be worse than
+ * contributing none.
+ */
+export declare function essentialChildren(opts?: EssentialsOptions): DropSHPlugin[];

package/dist/src/children.js

@@ -0,0 +1,34 @@
+// The one place that says which plugins `@gaia-ai/addon-essentials` pulls in.
+//
+// It exists because essentials is reachable through TWO config forms that must
+// not drift: the legacy `plugins: [{ plugin: '@gaia-ai/addon-essentials' }]`
+// descriptor, which constructs this package's DEFAULT EXPORT, and the
+// Storybook-style `addons: ['@gaia-ai/addon-essentials']`, which runs its
+// `./preset`. Both call this function, so a child added here appears on both.
+import { jsonapiSchemaPlugin } from '@dropsh/plugin-jsonapi-schema';
+import { markdownPlugin } from '@dropsh/plugin-markdown';
+import { nameRefsPlugin } from '@gaia-ai/addon-name-refs';
+import { workspacePlugin } from '@gaia-ai/addon-workspace';
+/**
+ * The config-free essentials (markdown renderer, authoritative JSON:API schema
+ * and GAIA-403's name resolver, which lives in its own
+ * `@gaia-ai/addon-name-refs` package) plus GAIA-351's ambient-workspace filler.
+ *
+ * The workspace child is the one that reads an option, and it is appended only
+ * when a uuid is actually present. That guard is not a "configured?" toggle —
+ * `workspace_id` is required at config load, so a missing one means this
+ * discovery bypassed `loadGaiaConfig` entirely (a hand-built context, a test),
+ * where contributing a plugin with no uuid to inject would be worse than
+ * contributing none.
+ */
+export function essentialChildren(opts = {}) {
+    const workspaceId = typeof opts.workspace_id === 'string' ? opts.workspace_id.trim() : '';
+    return [
+        markdownPlugin(),
+        jsonapiSchemaPlugin(),
+        nameRefsPlugin(),
+        ...(workspaceId === ''
+            ? []
+            : [workspacePlugin({ workspace_id: workspaceId })]),
+    ];
+}

package/dist/src/index.d.ts

@@ -1,16 +1,23 @@
+import { type EssentialsOptions } from './children.js';
 /**
- * Aggregator: pull the config-free dropsh essentials in through a single
- * `plugins[]` entry. `composePlugins(...)` returns the flat child list; dropsh
- * (>= 0.5.6) flattens a plugins[] entry that resolves to an array into separate
- * plugin entries, and the conductor's own resolver does the same — so each
- * child stays a distinct, genuine plugin, indistinguishable from listing them
- * one by one. No hand-merged or presence-guarded composite hooks.
+ * Aggregator: pull the essentials in through a single `plugins[]` entry.
+ * `composePlugins(...)` returns the flat child list; dropsh (>= 0.5.6) flattens
+ * a plugins[] entry that resolves to an array into separate plugin entries, and
+ * the conductor's own resolver does the same — so each child stays a distinct,
+ * genuine plugin, indistinguishable from listing them one by one. No hand-merged
+ * or presence-guarded composite hooks.
  *
  * `authProvider`-carrying plugins (oauth2, with per-profile credentials) are
  * deliberately NOT here — they stay explicit in the config (AC-4).
  *
- * Add a new config-free essential = instantiate it here (+ a real dependency in
+ * GAIA-351: `@gaia-ai/addon-workspace` is a child too, so the ambient workspace
+ * is filled on every connection without any config naming it. The uuid reaches
+ * this factory as the descriptor's options, which `loadGaiaConfig` seeds from
+ * the connection config's top-level, required `workspace_id`.
+ *
+ * Add a new essential = add it in `children.ts` (+ a real dependency in
  * package.json). Existing configs naming only this aggregator pick it up (AC-5).
  */
-declare const _default: () => import("dropsh/plugin").DropSHPlugin[];
+declare const _default: (opts?: EssentialsOptions) => import("dropsh/plugin").DropSHPlugin[];
 export default _default;
+export { type EssentialsOptions, essentialChildren } from './children.js';

package/dist/src/index.js

@@ -1,18 +1,23 @@
-import { jsonapiSchemaPlugin } from '@dropsh/plugin-jsonapi-schema';
-import { markdownPlugin } from '@dropsh/plugin-markdown';
 import { composePlugins } from 'dropsh/plugin';
+import { essentialChildren } from './children.js';
 /**
- * Aggregator: pull the config-free dropsh essentials in through a single
- * `plugins[]` entry. `composePlugins(...)` returns the flat child list; dropsh
- * (>= 0.5.6) flattens a plugins[] entry that resolves to an array into separate
- * plugin entries, and the conductor's own resolver does the same — so each
- * child stays a distinct, genuine plugin, indistinguishable from listing them
- * one by one. No hand-merged or presence-guarded composite hooks.
+ * Aggregator: pull the essentials in through a single `plugins[]` entry.
+ * `composePlugins(...)` returns the flat child list; dropsh (>= 0.5.6) flattens
+ * a plugins[] entry that resolves to an array into separate plugin entries, and
+ * the conductor's own resolver does the same — so each child stays a distinct,
+ * genuine plugin, indistinguishable from listing them one by one. No hand-merged
+ * or presence-guarded composite hooks.
  *
  * `authProvider`-carrying plugins (oauth2, with per-profile credentials) are
  * deliberately NOT here — they stay explicit in the config (AC-4).
  *
- * Add a new config-free essential = instantiate it here (+ a real dependency in
+ * GAIA-351: `@gaia-ai/addon-workspace` is a child too, so the ambient workspace
+ * is filled on every connection without any config naming it. The uuid reaches
+ * this factory as the descriptor's options, which `loadGaiaConfig` seeds from
+ * the connection config's top-level, required `workspace_id`.
+ *
+ * Add a new essential = add it in `children.ts` (+ a real dependency in
  * package.json). Existing configs naming only this aggregator pick it up (AC-5).
  */
-export default () => composePlugins(markdownPlugin(), jsonapiSchemaPlugin());
+export default (opts = {}) => composePlugins(...essentialChildren(opts));
+export { essentialChildren } from './children.js';

package/dist/src/preset.d.ts

@@ -1,2 +1,3 @@
 import type { GaiaPreset } from '@gaia-ai/core';
-export declare const connectionPlugins: GaiaPreset['connectionPlugins'];
+import { type EssentialsOptions } from './children.js';
+export declare const connectionPlugins: GaiaPreset<EssentialsOptions>['connectionPlugins'];

package/dist/src/preset.js

@@ -1,14 +1,16 @@
 // GAIA-215: the essentials meta-addon self-declares its connection contributions
-// via `./preset`. It pulls the config-free dropsh essentials (markdown renderer +
-// authoritative JSON:API schema) into the connection surface through a single
-// entry — `composePlugins(...)` returns the flat child list, exactly as the old
-// default-export aggregator did, so each child stays a distinct plugin. The
-// children are essentials' OWN deps (imported here, resolved from this package's
+// via `./preset`. It pulls the essentials into the connection surface through a
+// single entry — the children are returned flat, exactly as the default-export
+// aggregator does, so each child stays a distinct plugin. The children are
+// essentials' OWN deps (imported in `children.ts`, resolved from this package's
 // node_modules), so no fragile transitive resolution from the config's bases.
-import { jsonapiSchemaPlugin } from '@dropsh/plugin-jsonapi-schema';
-import { markdownPlugin } from '@dropsh/plugin-markdown';
-import { composePlugins } from 'dropsh/plugin';
-export const connectionPlugins = (acc) => [
+//
+// GAIA-351: one of those children is `@gaia-ai/addon-workspace`, and it is the
+// only one that reads an option. `opts` here is not an addon entry's `with` —
+// no config writes one — but the GLOBAL options `loadGaiaConfig` hands every
+// preset, seeded from the connection config's top-level, required `workspace_id`.
+import { essentialChildren } from './children.js';
+export const connectionPlugins = (acc, opts) => [
     ...acc,
-    ...composePlugins(markdownPlugin(), jsonapiSchemaPlugin()),
+    ...essentialChildren((opts ?? {})),
 ];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gaia-ai/addon-essentials",
-  "version": "0.9.2",
-  "description": "GAIA aggregator plugin: auto-loads the config-free dropsh essentials (markdown + authoritative JSON:API schema).",
+  "version": "0.11.0",
+  "description": "GAIA aggregator plugin: auto-loads the dropsh essentials (markdown + authoritative JSON:API schema) and the ambient-workspace filler.",
   "type": "module",
   "license": "MIT",
   "exports": {
@@ -20,11 +20,13 @@
     "directory": "gaia-cli/addons/essentials"
   },
   "dependencies": {
-    "@dropsh/plugin-markdown": "^0.5.8",
-    "@dropsh/plugin-jsonapi-schema": "^0.5.8",
-    "dropsh": "^0.5.8"
+    "@dropsh/plugin-markdown": "^0.6.1",
+    "@dropsh/plugin-jsonapi-schema": "^0.6.1",
+    "@gaia-ai/addon-name-refs": "^0.11.0",
+    "@gaia-ai/addon-workspace": "^0.11.0",
+    "dropsh": "^0.6.1"
   },
   "peerDependencies": {
-    "@gaia-ai/core": "^0.9.2"
+    "@gaia-ai/core": "^0.11.0"
   }
 }