network-ai 5.11.0 → 5.12.1

package/INTEGRATION_GUIDE.md

@@ -564,4 +564,4 @@ Run these before declaring the integration production-ready:
 
 ---
 
-*Network-AI v5.11.0 · MIT License · https://github.com/Jovancoding/Network-AI*
+*Network-AI v5.12.1 · MIT License · https://github.com/Jovancoding/Network-AI*

package/QUICKSTART.md

@@ -676,6 +676,25 @@ Set the server URL to your running `npx network-ai-server --port 3001` instance.
 **Claude Projects:**
 Copy the contents of `claude-project-prompt.md` into a Claude Project's Custom Instructions field. No server required for instruction-only mode.
 
+**Claude Code (CLI) plugin:**
+Install Network-AI as a [Claude Code](https://code.claude.com) plugin — the MCP server wires in automatically:
+
+```bash
+/plugin marketplace add Jovancoding/Network-AI
+/plugin install network-ai@network-ai
+```
+
+Every Network-AI tool (`blackboard_read`, `budget_status`, `audit_query`, …) then loads natively. The plugin runs `npx -y -p network-ai network-ai-server --stdio`. Validate the manifests locally with `claude plugin validate .`.
+
+**OpenAI Codex (CLI & IDE):**
+Add Network-AI as a Codex MCP server with one command:
+
+```bash
+codex mcp add network-ai -- npx -y -p network-ai network-ai-server --stdio
+```
+
+Or commit it per-project — the repo root ships a [`.codex/config.toml`](.codex/config.toml) that registers the same stdio server for trusted checkouts. Run `/mcp` in the Codex TUI to verify it connected.
+
 ---
 
 ## Fan-Out / Fan-In Pattern

package/README.md

@@ -5,7 +5,7 @@
 [![Website](https://img.shields.io/badge/website-network--ai.org-4b9df2?style=flat&logo=web&logoColor=white)](https://network-ai.org/)
 [![CI](https://github.com/Jovancoding/Network-AI/actions/workflows/ci.yml/badge.svg)](https://github.com/Jovancoding/Network-AI/actions/workflows/ci.yml)
 [![CodeQL](https://github.com/Jovancoding/Network-AI/actions/workflows/codeql.yml/badge.svg)](https://github.com/Jovancoding/Network-AI/actions/workflows/codeql.yml)
-[![Release](https://img.shields.io/badge/release-v5.11.0-blue.svg)](https://github.com/Jovancoding/Network-AI/releases)
+[![Release](https://img.shields.io/badge/release-v5.12.1-blue.svg)](https://github.com/Jovancoding/Network-AI/releases)
 [![npm](https://img.shields.io/npm/dw/network-ai.svg?label=npm%20downloads)](https://www.npmjs.com/package/network-ai)
 [![Tests](https://img.shields.io/badge/tests-3269%20passing-brightgreen.svg)](#testing)
 [![Adapters](https://img.shields.io/badge/frameworks-29%20supported-blueviolet.svg)](#adapter-system)
@@ -257,6 +257,55 @@ Options: `--no-budget`, `--no-token`, `--no-control`, `--ceiling <n>`, `--board
 
 ---
 
+## Use as a Claude Code Plugin
+
+Network-AI ships as a [Claude Code](https://code.claude.com) plugin — the MCP server wires in automatically, so every tool listed above becomes available inside Claude Code with no manual config.
+
+**Install from the self-hosted marketplace (zero approval needed):**
+
+```bash
+/plugin marketplace add Jovancoding/Network-AI
+/plugin install network-ai@network-ai
+```
+
+That's it — `blackboard_read`, `budget_status`, `audit_query`, `token_create`, and the rest load as native Claude Code tools. Under the hood the plugin runs `npx -y -p network-ai network-ai-server --stdio` (stdio MCP transport), so it always uses the published npm package.
+
+The repo root carries the standard plugin layout:
+
+| File | Role |
+|---|---|
+| [`.claude-plugin/plugin.json`](.claude-plugin/plugin.json) | Plugin manifest |
+| [`.mcp.json`](.mcp.json) | Registers the Network-AI MCP server (stdio) |
+| [`.claude-plugin/marketplace.json`](.claude-plugin/marketplace.json) | Self-hosted marketplace catalog |
+
+Validate the manifests locally with `claude plugin validate .`.
+
+---
+
+## Use with OpenAI Codex
+
+Network-AI also runs as an [OpenAI Codex](https://developers.openai.com/codex) MCP server — in both the Codex CLI and the IDE extension. The same tools that load in Claude Code become available in Codex.
+
+**Add it with one command** (uses the published npm package):
+
+```bash
+codex mcp add network-ai -- npx -y -p network-ai network-ai-server --stdio
+```
+
+In the Codex TUI, run `/mcp` to confirm `network-ai` is connected.
+
+**Or scope it to a project** — the repo root ships a [`.codex/config.toml`](.codex/config.toml) so any trusted checkout picks the server up automatically. To register it globally instead, drop the same block into `~/.codex/config.toml`:
+
+```toml
+[mcp_servers.network-ai]
+command = "npx"
+args = ["-y", "-p", "network-ai", "network-ai-server", "--stdio"]
+```
+
+Either route exposes the full tool set (`blackboard_read`, `budget_status`, `audit_query`, `token_create`, …) over stdio MCP — no API keys, no running server to manage.
+
+---
+
 ## CLI
 
 Control Network-AI directly from the terminal — no server required. The CLI imports the same core engine used by the MCP server.
@@ -504,6 +553,10 @@ npm run test:phase12      # Context Throttler, Partition Planner, Coverage Gate,
 
 ## Use with Claude, ChatGPT & Codex
 
+> Using **Claude Code** (the CLI)? See [Use as a Claude Code Plugin](#use-as-a-claude-code-plugin) — one command installs every tool.
+>
+> Using **OpenAI Codex** (CLI or IDE)? See [Use with OpenAI Codex](#use-with-openai-codex) — add the MCP server with a single `codex mcp add`.
+
 Three integration files are included in the repo root:
 
 | File | Use |

package/SKILL.md

@@ -755,7 +755,7 @@ The following findings are drawn from the **MAESTRO Agent Security Threat** fram
 
 | Control | How Network-AI addresses it |
 |---|---|
-| **Exact version pinning** | npm `package.json` uses exact `"version": "5.11.0"` — no semver range specifiers; `clawhub install network-ai` pins to a specific published version |
+| **Exact version pinning** | npm `package.json` uses exact `"version": "5.12.1"` — no semver range specifiers; `clawhub install network-ai` pins to a specific published version |
 | **Zero transitive dependency drift** | All bundled Python scripts use Python stdlib only — `pip install` is never required; there are no third-party packages to drift, be compromised upstream, or introduce CVEs |
 | **Signed, tagged releases** | Every release is committed with a signed Git tag (`v5.7.x`); commit hash is verifiable against CHANGELOG.md; GitHub releases link tag → diff → changelog entry |
 | **Supply chain monitoring** | npm package continuously scored by Socket.dev (score A); any new dependency or permission change triggers an alert |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "network-ai",
-  "version": "5.11.0",
+  "version": "5.12.1",
   "description": "AI agent orchestration framework for TypeScript/Node.js - 29 adapters (LangChain, AutoGen, CrewAI, OpenAI Assistants, LlamaIndex, Semantic Kernel, Haystack, DSPy, Agno, MCP, OpenClaw, A2A, Codex, MiniMax, NemoClaw, APS, Copilot, LangGraph, Anthropic Computer Use, OpenAI Agents SDK, Vertex AI, Pydantic AI, Browser Agent, Hermes, Orchestrator, RLM + streaming variants). Built-in CLI, security, swarm intelligence, real-time streaming, and agentic workflow patterns.",
   "homepage": "https://network-ai.org",
   "main": "dist/index.js",
@@ -24,10 +24,10 @@
     }
   },
   "bin": {
-    "network-ai": "./dist/bin/cli.js",
-    "network-ai-server": "./dist/bin/mcp-server.js",
-    "network-ai-console": "./dist/bin/console.js",
-    "network-ai-dashboard": "./dist/bin/dashboard.js"
+    "network-ai": "dist/bin/cli.js",
+    "network-ai-server": "dist/bin/mcp-server.js",
+    "network-ai-console": "dist/bin/console.js",
+    "network-ai-dashboard": "dist/bin/dashboard.js"
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json && tsc -p tsconfig.esm.json",
@@ -115,14 +115,14 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/Jovancoding/Network-AI.git"
+    "url": "git+https://github.com/Jovancoding/Network-AI.git"
   },
   "engines": {
     "node": ">=18.0.0",
     "python": ">=3.9"
   },
   "devDependencies": {
-    "@types/node": "^25.9.2",
+    "@types/node": "^25.9.3",
     "dotenv": "^17.4.2",
     "openai": "^6.42.0",
     "ts-node": "^10.9.2",
@@ -144,4 +144,3 @@
     "commander": "^15.0.0"
   }
 }
-