@gaia-ai/addon-dropsh 0.6.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 keytec GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# @gaia-ai/addon-dropsh
+
+GAIA dropsh command plugin: the `gaia dropsh` JSON:API shell bound to the split connection config.
+
+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/index.d.ts

@@ -0,0 +1,6 @@
+import { type GaiaCommandPlugin } from '@gaia-ai/core';
+/** Actionable hint when a `gaia dropsh` command runs with no loadable connection. */
+export declare function dropshConfigHint(resolvedPath?: string): string;
+/** The `dropsh` command plugin the host mounts (`gaia dropsh …`). */
+declare const dropshCommandPlugin: GaiaCommandPlugin;
+export default dropshCommandPlugin;

package/dist/src/index.js

@@ -0,0 +1,75 @@
+import { loadGaiaConfig, } from '@gaia-ai/core';
+import { buildProgram as buildDropshProgram } from 'dropsh';
+// GAIA-201: the `gaia dropsh` command PLUGIN. It builds the inherited dropsh
+// JSON:API shell from the CONNECTION config (`loadGaiaConfig`) — NEVER
+// `loadConductorConfig`. That is the deepest AC-2 fix: the old `gaia dropsh`
+// went through `loadConductorConfig`, which eagerly constructed the whole engine
+// plugin farm (remote/executor/agent/workspace) just to read the auth `plugins`.
+// This package has no `@gaia-ai/conductor` edge and imports no engine plugin, so
+// a `gaia dropsh read …` instantiates nothing but the dropsh auth plugins.
+//
+// Connection precedence (AC-4, resolved in core `resolveGaiaConfigPath`):
+// explicit `--config` / `$DROPSH_CONFIG` → project `./.gaia/gaia.config.js`
+// walk-up (legacy `conductor.config.js` accepted) → home `~/.gaia/gaia.config.js`
+// → shipped fallback. `$DROPSH_CONFIG` is set to the resolved path so dropsh's
+// own subcommands (`auth login`) reload the same connection.
+/** Actionable hint when a `gaia dropsh` command runs with no loadable connection. */
+export function dropshConfigHint(resolvedPath) {
+    const where = resolvedPath ? ` (looked at ${resolvedPath})` : '';
+    return (`gaia dropsh: no connection config could be loaded${where}.\n` +
+        'Point at one with --config <path>, set $DROPSH_CONFIG, run from a directory ' +
+        'containing .gaia/gaia.config.js, or onboard this machine with ' +
+        '`gaia conductor init --base-url <url>` (home fallback).');
+}
+/**
+ * Build the `dropsh` command from a resolved connection. Sets `$DROPSH_CONFIG`
+ * to the connection path (unless already set) so dropsh's own subcommands reload
+ * the same site + plugins.
+ */
+async function buildDropshCommand(host) {
+    let connection;
+    try {
+        connection = await loadGaiaConfig(host, {});
+    }
+    catch {
+        connection = undefined;
+    }
+    const dropsh = buildDropshProgram({
+        plugins: connection?.plugins ?? [],
+    });
+    if (connection && !process.env.DROPSH_CONFIG) {
+        process.env.DROPSH_CONFIG = connection.config_path;
+    }
+    if (!connection) {
+        // Registration is unconditional; a config problem must surface WHEN a dropsh
+        // command runs, not make the command vanish. The hook fires only on a real
+        // subcommand dispatch — never for `--help` — so discoverability holds. It
+        // honours a late `--config` (AC-4 explicit leg).
+        dropsh.hook('preSubcommand', async (thisCommand) => {
+            const override = thisCommand.opts().config ??
+                process.env.DROPSH_CONFIG;
+            let resolvedPath;
+            try {
+                const c = await loadGaiaConfig(host, { explicit: override });
+                resolvedPath = c.config_path;
+            }
+            catch {
+                throw new Error(dropshConfigHint(override));
+            }
+            if (!process.env.DROPSH_CONFIG) {
+                process.env.DROPSH_CONFIG = resolvedPath;
+            }
+        });
+    }
+    return dropsh;
+}
+/** The `dropsh` command plugin the host mounts (`gaia dropsh …`). */
+const dropshCommandPlugin = {
+    kind: 'command',
+    name: 'dropsh',
+    describe: 'JSON:API shell (dropsh) bound to the GAIA connection config',
+    async register(program, host) {
+        program.addCommand(await buildDropshCommand(host));
+    },
+};
+export default dropshCommandPlugin;

package/dist/src/preset.d.ts

@@ -0,0 +1,2 @@
+import type { GaiaPreset } from '@gaia-ai/core';
+export declare const commands: GaiaPreset['commands'];

package/dist/src/preset.js

@@ -0,0 +1,8 @@
+export const commands = (acc) => [
+    ...acc,
+    {
+        name: 'dropsh',
+        plugin: '@gaia-ai/addon-dropsh',
+        describe: 'JSON:API shell (dropsh) bound to the GAIA connection config',
+    },
+];

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@gaia-ai/addon-dropsh",
+  "version": "0.6.1",
+  "description": "GAIA dropsh command plugin: the `gaia dropsh` JSON:API shell bound to the split connection config.",
+  "type": "module",
+  "license": "MIT",
+  "exports": {
+    ".": "./dist/src/index.js",
+    "./preset": "./dist/src/preset.js"
+  },
+  "files": [
+    "dist/src"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://git.key-tec.de/keytec/gaia.git",
+    "directory": "gaia-cli/addons/dropsh"
+  },
+  "dependencies": {
+    "@dropsh/plugin-jsonapi-schema": "^0.5.8",
+    "@dropsh/plugin-oauth2": "^0.5.7",
+    "commander": "^12.1.0",
+    "dropsh": "^0.5.8"
+  },
+  "peerDependencies": {
+    "@gaia-ai/core": "^0.6.1"
+  }
+}