@staix/agent-hub 0.2.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,12 @@
+{
+  "name": "agent-hub",
+  "owner": { "name": "Young Joon Lee" },
+  "plugins": [
+    {
+      "name": "agent-hub",
+      "source": "./plugins/agent-hub",
+      "description": "Claude Code channel for the agent-hub multi-agent daemon",
+      "category": "development"
+    }
+  ]
+}

package/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+## 0.2.0
+
+- npm distribution: `@staix/agent-hub`, public publishing with provenance from the tag workflow, tarball content checks, and an actionable Bun requirement when the CLI is invoked with Node or an unsupported Bun version.
+
+- `ahub ask`: answers from the task board, shared memory and the hub log, evidence first; the answer has to cite the ids it rests on.
+
+## 0.1.0
+
+First public release.
+
+- Messaging core: N-peer bus with untrusted framing, hop cap, dedupe, one queue per peer; adapters for Claude Code (channel plugin), Codex (app-server proxy) and Kimi Code (ACP).
+- Coordination: `[IMPORTANT]` / `[STATUS]` / `[FYI]` tiers, digests, `turn/steer` for a busy Codex, queue bounds, pause and resume, session-start recall from claude-mem.
+- `local`: a hub-native worker on a self-hosted model through an OpenAI-compatible gateway, with scoped tools, approvals and a macOS sandbox; optional Switchyard sidecar with fallback; claude-mem capture.
+- Task board with role contracts, routing policy (`routing.toml`), an enforced on-prem path for PII, review handoff and escalation, task briefs and shared notes.
+- Budget relay: quota sources, checkpoint then pause, handoff to `local` first, resume on reset.
+- Packaging: `ahub` CLI (alias `agent-hub`) installable from GitHub, `ahub setup`, one version across CLI, plugin and MCP server, CI on Ubuntu and macOS, tagged releases.
+- Internal inference (optional, fail-open): condensed status digests and task class triage.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 STAIxBWLB
+
+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,54 @@
+# agent-hub
+
+Native multi-agent hub for one developer's machine: Claude Code, Codex, Kimi Code and a
+hub-owned local-LLM worker collaborate as peers in one project directory, with
+task-aware model routing (Switchyard) in front of a self-hosted gateway (OmniRoute).
+
+Status: 0.2.0. All six milestones of the design spec are implemented; the [smoke checklist](docs/smoke.md)
+says what has and has not been verified against real agents.
+
+## Start here
+
+Requires [Bun](https://bun.sh) >=1.3.0 on PATH; Node alone cannot run the CLI.
+The npm package is `@staix/agent-hub`, under the `staix` organization.
+
+Install from npm:
+
+```bash
+bun add -g @staix/agent-hub && ahub setup
+cd <your project> && ahub init && ahub up && ahub tail
+```
+
+Or install the same version from GitHub:
+
+```bash
+bun add -g github:STAIxBWLB/agent-hub#v0.2.0 && ahub setup
+```
+
+The installed commands remain `ahub` and `agent-hub`.
+
+- [Quickstart](docs/quickstart.md): install, first session, the local worker, the commands of a working day
+- [Security notes](docs/security.md): what the hub defends and what it does not
+- [Design spec](docs/specs/2026-09-19-agent-hub-design.md): how it is built and why, with every amendment made along the way
+- [Smoke checklist](docs/smoke.md): the live checks, and what has and has not been verified against real agents
+- [Changelog](CHANGELOG.md), [Contributing](CONTRIBUTING.md)
+
+## Why not agent-bridge
+
+[raysonmeng/agent-bridge](https://github.com/raysonmeng/agent-bridge) proves the
+Claude <-> Codex pairing. Its core is two-party by construction (single Claude seat,
+`source: claude | codex`), and its v3 rooms carry signals only. agent-hub starts from
+an N-peer message bus and attaches each agent through its native control surface.
+
+## Peers and their native surfaces
+
+| Peer | Inbound | Outbound | Busy handling |
+| --- | --- | --- | --- |
+| Claude Code | channel plugin push (`notifications/claude/channel`) | MCP tools | queued by Claude Code, grouped on next turn |
+| Codex | app-server `turn/start` (idle) / `turn/steer` (busy) | proxy intercepts `item/agentMessage` | steer or queue |
+| Kimi Code | ACP `session/prompt` | ACP `session/update` stream | queue (`turn.agent_busy`) |
+| Local worker | hub-native agent loop | hub-native | hub-owned |
+
+## Runtime
+
+Bun + TypeScript. Single daemon per project directory, loopback only.

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@staix/agent-hub",
+  "version": "0.2.0",
+  "description": "Native multi-agent hub: Claude Code, Codex, Kimi Code and a local worker as peers in one project",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "ahub": "src/cli/main.js",
+    "agent-hub": "src/cli/main.js"
+  },
+  "scripts": {
+    "check": "scripts/check.sh",
+    "build": "bun scripts/build.mjs",
+    "test": "bun test"
+  },
+  "engines": {
+    "bun": ">=1.3.0"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@types/bun": "^1.3.0",
+    "typescript": "^5.8.0"
+  },
+  "files": [
+    ".claude-plugin",
+    "src",
+    "plugins",
+    "templates",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/STAIxBWLB/agent-hub.git"
+  },
+  "homepage": "https://github.com/STAIxBWLB/agent-hub",
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/plugins/agent-hub/.claude-plugin/plugin.json

@@ -0,0 +1,11 @@
+{
+  "name": "agent-hub",
+  "version": "0.2.0",
+  "description": "Channel between Claude Code and the agent-hub daemon: peer messages from Codex, Kimi and the local worker arrive as channel events; hub_send replies.",
+  "author": {
+    "name": "Young Joon Lee",
+    "email": "yj.lee@chu.ac.kr"
+  },
+  "repository": "https://github.com/STAIxBWLB/agent-hub",
+  "license": "MIT"
+}

package/plugins/agent-hub/.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "agent-hub": {
+      "command": "bun",
+      "args": ["run", "${CLAUDE_PLUGIN_ROOT}/server.js"]
+    }
+  }
+}