@cuylabs/agent-capability-pack 0.13.0

package/docs/mcp-bridge.md

@@ -0,0 +1,49 @@
+# MCP Skill Bridge
+
+`MCPSkillBridge` makes MCP prompts visible through the skill system.
+
+## Behavior
+
+After `mcpManager.connect()`:
+
+1. `listPrompts()` discovers prompts from connected servers.
+2. Each prompt becomes a skill named `<server>:<prompt>`.
+3. **Static prompts** (no required arguments) are rendered immediately with `getPrompt()` and cached as full L2 skill content.
+4. **Parameterized prompts** (with arguments) get a metadata-backed skill body that lists supported arguments — usable without a live render.
+
+This means:
+
+- MCP prompts become visible in the skill summary (L1)
+- the `skill` tool can load them without filesystem-backed `SKILL.md` files
+- prompts with arguments still load meaningfully instead of failing outright
+
+## Example
+
+```ts
+import { MCPSkillBridge } from "@cuylabs/agent-capability-pack";
+
+await mcpManager.connect();
+
+const bridge = new MCPSkillBridge(mcpManager, skillRegistry);
+const result = await bridge.bridge();
+
+// Number of prompts newly registered (or updated) as skills.
+// Does not count prompts that were displaced by a higher-scope skill.
+console.log(result.bridgedCount);
+
+// Both hard failures AND non-fatal warnings (e.g. getPrompt() failed
+// but a metadata fallback was used instead).
+for (const e of result.errors) {
+  console.warn(`[${e.server}] ${e.error}`);
+}
+```
+
+See [examples/03-mcp-bridge.ts](../examples/03-mcp-bridge.ts) for a full runnable example.
+
+## Important Boundary
+
+The bridge is an adapter, not the source of truth for MCP itself.
+
+- MCP remains owned by `@cuylabs/agent-core/mcp`
+- the bridge only projects MCP prompts into the skill surface
+- MCP tools/resources/prompts still exist natively through `MCPManager`

package/docs/sources.md

@@ -0,0 +1,52 @@
+# Pack Sources
+
+Every source resolves to the same `CapabilityPack` shape.
+
+## Inline
+
+```ts
+inlinePack(myPack)
+```
+
+- no I/O
+- best for application-owned packs
+
+## Local
+
+```ts
+localPack("./packs/company-tools")
+```
+
+- reads `pack.json`
+- discovers `skills/`
+- supports a local plugin entry via `pack.json -> plugin`
+
+## npm
+
+```ts
+npmPack("@company/agent-pack")
+```
+
+- imports an installed package
+- default export or named export may provide the pack
+- best for reusable published packs
+
+## URL
+
+```ts
+urlPack("https://example.com/packs/company-tools.json")
+```
+
+- HTTPS only
+- JSON only
+- plugin code is blocked for security
+
+## Git
+
+```ts
+gitPack("https://github.com/company/agent-pack.git", "main")
+```
+
+- clones into a local cache under `~/.cache/cuylabs/packs/git/`
+- then resolves like a local pack
+- supports `pack.json -> plugin` because it reuses the local resolver

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "@cuylabs/agent-capability-pack",
+  "version": "0.13.0",
+  "description": "Capability packs for @cuylabs/agent-core — distributable bundles of skills, MCP servers, and plugin contributions",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./pack": {
+      "types": "./dist/pack/index.d.ts",
+      "import": "./dist/pack/index.js",
+      "default": "./dist/pack/index.js"
+    },
+    "./sources": {
+      "types": "./dist/sources/index.d.ts",
+      "import": "./dist/sources/index.js",
+      "default": "./dist/sources/index.js"
+    },
+    "./bridge": {
+      "types": "./dist/bridge/index.d.ts",
+      "import": "./dist/bridge/index.js",
+      "default": "./dist/bridge/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "docs",
+    "README.md"
+  ],
+  "dependencies": {
+    "@cuylabs/agent-core": "^0.13.0"
+  },
+  "devDependencies": {
+    "@ai-sdk/openai": "^3.0.0",
+    "@types/node": "^22.0.0",
+    "dotenv": "^17.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "peerDependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@modelcontextprotocol/sdk": {
+      "optional": true
+    }
+  },
+  "keywords": [
+    "agent",
+    "ai",
+    "capability",
+    "pack",
+    "skills",
+    "mcp",
+    "plugin"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cuylabs-ai/agents-ts.git",
+    "directory": "packages/agent-capability-pack"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup --config tsup.config.ts",
+    "dev": "tsup --config tsup.config.ts --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  }
+}