@gaia-ai/gaia 0.0.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,63 @@
+# @gaia-ai/gaia
+
+The GAIA conductor + client CLI, published as a single self-contained npm
+package. Install it globally and run `gaia` anywhere — no repo clone, no local
+build (no `pnpm`, no `tsc`).
+
+## Install
+
+```bash
+npm install -g @gaia-ai/gaia
+```
+
+> The unscoped name `gaia` is taken on npm, so the package is scoped `@gaia-ai/gaia`.
+> The executable stays `gaia` (via the `bin` entry), so every command is just
+> `gaia …`.
+
+```bash
+gaia --help
+```
+
+## What it does
+
+`gaia` is the conductor node and client for a GAIA network: it registers with a
+Drupal control plane, claims tickets over JSON:API, and runs agents through
+spawn plugins (Claude, Codex, herdr, and a deterministic fake for tests). Point
+it at a control plane with a `conductor.config.js` (scaffold one with
+`gaia init`).
+
+## Plugins
+
+The four spawn plugins ship **inside** this package — nothing extra to install.
+Import them from the `@gaia-ai/gaia/plugins` entry in your `conductor.config.js`:
+
+```js
+import {
+  drupalRemote,
+  herdrWorkspace,
+  claudeAgent,
+  herdrExecutor,
+} from '@gaia-ai/gaia/plugins';
+```
+
+Plugin authors can build against the API surface at `@gaia-ai/gaia/plugin`.
+
+## Releasing (maintainers)
+
+Publishing is automated: push a git tag matching `v*.*.*` on `main` and CI runs
+the `publish` job (`npm publish --access public`). The published version is the
+tag. Requirements:
+
+- an `NPM_TOKEN` masked CI/CD variable with publish rights to the `@gaia-ai` scope;
+- the `@gaia-ai` npm org/scope claimed (fallback `@keytec/gaia`).
+
+To reproduce the published artifact locally:
+
+```bash
+pnpm run prepare:publish   # stage conductor/publish/ + each plugins/*/publish/
+pnpm run verify:package    # pack the staged set, install it in a temp dir, smoke-test
+```
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/bin/gaia

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import('@gaia-ai/conductor').then((m) => m.main(process.argv));

package/dist/src/plugins-barrel.d.ts

@@ -0,0 +1 @@
+export * from '@gaia-ai/core/plugins';

package/dist/src/plugins-barrel.js

@@ -0,0 +1 @@
+export * from '@gaia-ai/core/plugins';

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@gaia-ai/gaia",
+  "version": "0.0.1",
+  "description": "GAIA meta package: installs the conductor CLI + all runtime plugins. Global install target.",
+  "type": "module",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.19"
+  },
+  "bin": {
+    "gaia": "./bin/gaia"
+  },
+  "exports": {
+    "./plugins": "./dist/src/plugins-barrel.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "bin",
+    "dist/src",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://git.key-tec.de/keytec/gaia.git",
+    "directory": "conductor/packages/gaia"
+  },
+  "keywords": [
+    "gaia",
+    "conductor",
+    "cli",
+    "agent",
+    "drupal",
+    "jsonapi"
+  ],
+  "dependencies": {
+    "@gaia-ai/conductor": "^0.0.1",
+    "@gaia-ai/core": "^0.0.1",
+    "@gaia-ai/plugin-claude": "^0.0.1",
+    "@gaia-ai/plugin-codex": "^0.0.1",
+    "@gaia-ai/plugin-essentials": "^0.0.1",
+    "@gaia-ai/plugin-herdr": "^0.0.1",
+    "@gaia-ai/plugin-herdr-workspace": "^0.0.1"
+  }
+}