@mcoda/agents 0.1.4 → 0.1.8

package/CHANGELOG.md

@@ -3,5 +3,5 @@
 ## Unreleased
 - Initial public packaging for @mcoda/agents.
 
-## 0.1.4
+## 0.1.8
 - Initial release.

package/README.md

@@ -1,9 +1,35 @@
 # @mcoda/agents
 
-Agent registry and capability definitions for mcoda.
+Agent registry, adapter wiring, and invocation helpers for mcoda.
 
-## Usage
-This package is primarily an internal dependency of `mcoda`.
+## Install
+- Requires Node.js >= 20.
+- Install: `npm i @mcoda/agents`
+
+## What it provides
+- AgentService for resolving agents, prompts, capabilities, and secrets.
+- Adapter interfaces (AgentAdapter, InvocationRequest/InvocationResult).
+- Built-in adapters for OpenAI, Codex, Gemini, Ollama, Zhipu, local models, and QA.
+
+## Example
+```ts
+import { AgentService } from "@mcoda/agents";
+
+const service = await AgentService.create();
+const agent = await service.resolveAgent("codex");
+const adapter = await service.getAdapter(agent);
+const result = await adapter.invoke?.({ input: "Summarize this repo." });
+
+if (result) {
+  console.log(result.output);
+}
+
+await service.close();
+```
+
+## Notes
+- Primarily used by the mcoda CLI; APIs may evolve.
+- Set `MCODA_STREAM_IO=1` to emit adapter I/O lines to stderr.
 
 ## License
 MIT - see `LICENSE`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcoda/agents",
-  "version": "0.1.4",
+  "version": "0.1.8",
   "description": "Agent registry and capabilities for mcoda.",
   "type": "module",
   "main": "dist/index.js",
@@ -13,11 +13,6 @@
     "CHANGELOG.md",
     "LICENSE"
   ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "lint": "echo \"lint not configured\"",
-    "test": "pnpm run build && node ../../scripts/run-node-tests.js dist"
-  },
   "engines": {
     "node": ">=20"
   },
@@ -35,7 +30,12 @@
     "access": "public"
   },
   "dependencies": {
-    "@mcoda/shared": "workspace:*",
-    "@mcoda/db": "workspace:*"
+    "@mcoda/db": "0.1.8",
+    "@mcoda/shared": "0.1.8"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "lint": "echo \"lint not configured\"",
+    "test": "pnpm run build && node ../../scripts/run-node-tests.js dist"
   }
-}
+}