open-multi-agent-kit 0.80.2 → 0.80.3

package/examples/sdk/README.md

@@ -0,0 +1,144 @@
+# SDK Examples
+
+Programmatic usage of pi-coding-agent via `createAgentSession()` and `createAgentSessionRuntime()`.
+
+The runtime example shows how to build a recreate function that closes over process-global fixed inputs and recreates cwd-bound services and sessions as the active session cwd changes.
+
+## Examples
+
+| File | Description |
+|------|-------------|
+| `01-minimal.ts` | Simplest usage with all defaults |
+| `02-custom-model.ts` | Select model and thinking level |
+| `03-custom-prompt.ts` | Replace or modify system prompt |
+| `04-skills.ts` | Discover, filter, or replace skills |
+| `05-tools.ts` | Built-in tool allowlists |
+| `06-extensions.ts` | Logging, blocking, result modification |
+| `07-context-files.ts` | AGENTS.md context files |
+| `08-slash-commands.ts` | File-based slash commands |
+| `09-api-keys-and-oauth.ts` | API key resolution, OAuth config |
+| `10-settings.ts` | Override compaction, retry, terminal settings |
+| `11-sessions.ts` | In-memory, persistent, continue, list sessions |
+| `12-full-control.ts` | Replace everything, no discovery |
+| `13-session-runtime.ts` | Manage runtime-backed session replacement |
+
+## Running
+
+```bash
+cd packages/coding-agent
+npx tsx examples/sdk/01-minimal.ts
+```
+
+## Quick Reference
+
+```typescript
+import { getModel } from "@earendil-works/omk-ai";
+import {
+  AuthStorage,
+  createAgentSession,
+  DefaultResourceLoader,
+  ModelRegistry,
+  SessionManager,
+  SettingsManager,
+} from "open-multi-agent-kit";
+
+// Auth and models setup
+const authStorage = AuthStorage.create();
+const modelRegistry = ModelRegistry.create(authStorage);
+
+// Minimal
+const { session } = await createAgentSession({ authStorage, modelRegistry });
+
+// Custom model
+const model = getModel("anthropic", "claude-opus-4-5");
+const { session } = await createAgentSession({ model, thinkingLevel: "high", authStorage, modelRegistry });
+
+// Modify prompt
+const loader = new DefaultResourceLoader({
+  systemPromptOverride: (base) => `${base}\n\nBe concise.`,
+});
+await loader.reload();
+const { session } = await createAgentSession({ resourceLoader: loader, authStorage, modelRegistry });
+
+// Read-only
+const { session } = await createAgentSession({ tools: ["read", "grep", "find", "ls"], authStorage, modelRegistry });
+
+// In-memory
+const { session } = await createAgentSession({
+  sessionManager: SessionManager.inMemory(),
+  authStorage,
+  modelRegistry,
+});
+
+// Full control
+const customAuth = AuthStorage.create("/my/app/auth.json");
+customAuth.setRuntimeApiKey("anthropic", process.env.MY_KEY!);
+const customRegistry = ModelRegistry.create(customAuth);
+
+const resourceLoader = new DefaultResourceLoader({
+  systemPromptOverride: () => "You are helpful.",
+  extensionFactories: [myExtension],
+  skillsOverride: () => ({ skills: [], diagnostics: [] }),
+  agentsFilesOverride: () => ({ agentsFiles: [] }),
+  promptsOverride: () => ({ prompts: [], diagnostics: [] }),
+});
+await resourceLoader.reload();
+
+const { session } = await createAgentSession({
+  model,
+  authStorage: customAuth,
+  modelRegistry: customRegistry,
+  resourceLoader,
+  tools: ["read", "bash", "my_tool"],
+  customTools: [myTool],
+  sessionManager: SessionManager.inMemory(),
+  settingsManager: SettingsManager.inMemory(),
+});
+
+// Run prompts
+session.subscribe((event) => {
+  if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
+    process.stdout.write(event.assistantMessageEvent.delta);
+  }
+});
+await session.prompt("Hello");
+```
+
+## Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `authStorage` | `AuthStorage.create()` | Credential storage |
+| `modelRegistry` | `ModelRegistry.create(authStorage)` | Model registry |
+| `cwd` | `process.cwd()` | Working directory |
+| `agentDir` | `~/.pi/agent` | Config directory |
+| `model` | From settings/first available | Model to use |
+| `thinkingLevel` | From settings/"off" | off, low, medium, high |
+| `tools` | `["read", "bash", "edit", "write"]` built-ins | Allowlist tool names across built-in, extension, and custom tools |
+| `customTools` | `[]` | Additional tool definitions |
+| `resourceLoader` | DefaultResourceLoader | Resource loader for extensions, skills, prompts, themes |
+| `sessionManager` | `SessionManager.create(cwd)` | Persistence |
+| `settingsManager` | `SettingsManager.create(cwd, agentDir)` | Settings overrides |
+
+## Events
+
+```typescript
+session.subscribe((event) => {
+  switch (event.type) {
+    case "message_update":
+      if (event.assistantMessageEvent.type === "text_delta") {
+        process.stdout.write(event.assistantMessageEvent.delta);
+      }
+      break;
+    case "tool_execution_start":
+      console.log(`Tool: ${event.toolName}`);
+      break;
+    case "tool_execution_end":
+      console.log(`Result: ${event.result}`);
+      break;
+    case "agent_end":
+      console.log("Done");
+      break;
+  }
+});
+```

package/package.json

@@ -1,202 +1,106 @@
 {
-  "name": "open-multi-agent-kit",
-  "version": "0.80.2",
-  "description": "Provider-neutral multi-agent control plane for coding workflows: route agents, verify evidence, orchestrate MCP-aware DAGs, and control the loop from the omk CLI.",
-  "type": "module",
-  "bin": {
-    "omk": "dist/cli.js",
-    "omk-project-mcp": "dist/mcp/omk-project-server.js",
-    "omk-acp": "dist/mcp/acp-server.js",
-    "omk-mcp-host": "dist/mcp/host.js"
-  },
-  "scripts": {
-    "clean:dist": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
-    "build": "tsc && node scripts/chmod-dist.mjs",
-    "build:clean": "npm run clean:dist && npm run build",
-    "dev": "tsx src/cli.ts",
-    "lint": "node node_modules/eslint/bin/eslint.js --max-warnings=0 src/",
-    "check": "tsc --noEmit",
-    "test": "node scripts/run-tests.mjs",
-    "secret:scan": "node scripts/secret-scan.mjs",
-    "secret:scan:runtime": "node scripts/secret-scan.mjs --runtime",
-    "verify": "npm run yaml:check && npm run lint && npm run secret:scan && npm run secret:scan:runtime && npm run legacy-identity:check && npm run check && npm run build:clean && npm run test",
-    "pack:dry": "node scripts/pack-dry.mjs",
-    "audit:package": "node scripts/package-audit.mjs",
-    "smoke": "node scripts/smoke-test.mjs",
-    "smoke:execution": "node scripts/smoke-execution.mjs",
-    "authority:smoke": "npm run build:clean && node scripts/authority-smoke.mjs",
-    "prompt:privacy:check": "node scripts/prompt-privacy-audit.mjs",
-    "release:gate-core": "npm run verify:no-kimi && npm run verify:no-persona && npm run contract:check && npm run schema:check && npm run version:check && npm run proof:check && npm run authority:smoke && npm run prompt:privacy:check && npm run smoke:execution && npm run pack:dry && npm run audit:package && npm run smoke:pack && OMK_RELEASE_DEMO=1 node scripts/release-gate.mjs",
-    "smoke:pack": "node scripts/pack-smoke.mjs",
-    "prepare": "npm run build",
-    "yaml:check": "node scripts/validate-yaml.mjs",
-    "schema:check": "node scripts/validate-json-contracts.mjs",
-    "theme:check": "node scripts/theme-check.mjs --out proof/theme-check",
-    "theme:sync": "node scripts/sync-themes.mjs",
-    "assets:build": "node scripts/assets-build.mjs",
-    "assets:check": "node scripts/assets-check.mjs",
-    "color:gate": "node scripts/color-literal-gate.mjs",
-    "file-size:check": "node scripts/check-file-size.mjs",
-    "provenance:ratio": "node scripts/provenance-ratio.mjs",
-    "proof:index": "node scripts/build-proof-index.mjs",
-    "proof:check": "node scripts/proof-check.mjs",
-    "version:check": "node scripts/check-version-consistency.mjs",
-    "contract:check": "npm run build:clean && npm run schema:check && node scripts/check-json-stdout.mjs",
-    "verify:contracts": "npm run contract:check",
-    "verify:no-persona": "node scripts/verify-no-persona.mjs",
-    "release:check": "npm run release:gate-core",
-    "release:full": "npm run verify && npm run release:gate-core",
-    "regression:matrix": "node scripts/regression-proof-matrix.mjs",
-    "release:rc": "npm run verify && npm run release:gate-core",
-    "smoke:no-kimi:chat": "OMK_MCP_PREFLIGHT=off OMK_PROJECT_ROOT=\"$PWD\" node dist/cli.js chat --provider auto --mode agent --execution ask --layout plain --mcp-scope none --smoke --json",
-    "smoke:no-kimi:codex": "OMK_MCP_PREFLIGHT=off OMK_PROJECT_ROOT=\"$PWD\" node dist/cli.js chat --provider codex --mode agent --execution ask --layout plain --mcp-scope none --smoke --json",
-    "smoke:no-kimi:doctor": "OMK_PROJECT_ROOT=\"$PWD\" node dist/cli.js doctor --json",
-    "verify:no-kimi": "npm run build:clean && npm run smoke:no-kimi:doctor && npm run smoke:no-kimi:chat && npm run smoke:no-kimi:codex && npm run no-kimi:default-surface && npm run test:no-kimi:runtime-routing",
-    "no-kimi:default-surface": "node scripts/no-kimi-default-surface.mjs",
-    "test:no-kimi:runtime-routing": "node --test --test-timeout=300000 test/provider-router.test.mjs test/runtime-router.test.mjs && node --test --test-timeout=300000 --test-name-pattern='authority provider write-risk routes|configured non-Kimi authority|implicit default authority|unavailable DeepSeek|external direct fallback|Super OMK config|scoreProviders includes|computeProviderRouteScore|runtime fallback' test/provider-routing.test.mjs && node --test test/no-kimi-cli-hud-surface.test.mjs test/v2-regression.test.mjs",
-    "legacy-identity:check": "node scripts/no-legacy-identity-surface.mjs",
-    "benchmark:shadow": "node scripts/run-benchmark.mjs --shadow",
-    "benchmark:live": "node scripts/run-benchmark.mjs --live",
-    "benchmark:ci": "node scripts/run-benchmark.mjs --shadow --summary-json proof/benchmarks/ci-run.json"
-  },
-  "keywords": [
-    "agent-runtime",
-    "provider-neutral",
-    "coding-agents",
-    "dag-runtime",
-    "evidence-gates",
-    "multi-agent-orchestration",
-    "agent-supervisor",
-    "open-multiagent-kit",
-    "open-multi-agent-kit",
-    "omk",
-    "omk-control",
-    "agent",
-    "agent-ensemble",
-    "agent-orchestration",
-    "agentic-coding",
-    "ai",
-    "ai-agent",
-    "ai-agents",
-    "ai-coding",
-    "ai-devtools",
-    "autonomous-agents",
-    "cli",
-    "cli-tool",
-    "code-assistant",
-    "code-generation",
-    "code-review-automation",
-    "coding",
-    "coding-agent",
-    "dag",
-    "design-md",
-    "developer-experience",
-    "developer-tools",
-    "ensemble",
-    "git-worktree",
-    "graph-memory",
-    "multi-provider",
-    "agent-supervisor",
-    "codex",
-    "claude-code",
-    "openrouter",
-    "qwen",
-    "deepseek",
-    "language-server-protocol",
-    "large-language-model",
-    "llm",
-    "local-first",
-    "lsp",
-    "mcp",
-    "mcp-native",
-    "model-context-protocol",
-    "agent-control-plane",
-    "multi-agent",
-    "multi-agent-orchestration",
-    "nodejs",
-    "orchestration",
-    "parallel-execution",
-    "quality-gates",
-    "scheduler",
-    "task-graph",
-    "task-scheduler",
-    "tmux",
-    "typescript",
-    "workflow-automation",
-    "worktree",
-    "yolo-mode"
-  ],
-  "author": "dmae97",
-  "license": "MIT",
-  "dependencies": {
-    "@clack/prompts": "^1.4.0",
-    "@inquirer/prompts": "^7.0.0",
-    "chalk-animation": "^2.0.3",
-    "cli-boxes": "^4.0.1",
-    "clipanion": "^4.0.0-rc.4",
-    "commander": "^14.0.0",
-    "execa": "^9.0.0",
-    "figlet": "^1.11.0",
-    "fs-extra": "^11.0.0",
-    "gradient-string": "^3.0.0",
-    "ink-gradient": "^4.0.1",
-    "node-pty": "^1.1.0",
-    "pyright": "^1.1.410",
-    "terminal-kit": "^3.1.2",
-    "typescript": "^5.9.3",
-    "typescript-language-server": "^5.1.3",
-    "yaml": "^2.0.0",
-    "zod": "^3.0.0"
-  },
-  "devDependencies": {
-    "@eslint/js": "^9.0.0",
-    "@types/fs-extra": "^11.0.0",
-    "@types/node": "^22.0.0",
-    "eslint": "^9.0.0",
-    "globals": "^15.0.0",
-    "tsx": "^4.22.4",
-    "typescript-eslint": "^8.0.0"
-  },
-  "files": [
-    "dist",
-    "templates",
-    "docs",
-    "readmeasset",
-    "CHANGELOG.md",
-    "MATURITY.md",
-    "README.md",
-    "AGENTS.md",
-    "SECURITY.md",
-    "ROADMAP.md",
-    "DESIGN.md",
-    "WORKER_MANIFEST.md",
-    "CLAUDE.md",
-    "GEMINI.md",
-    "LICENSE",
-    "llms.txt"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/dmae97/open-multi-agent-kit.git"
-  },
-  "bugs": {
-    "url": "https://github.com/dmae97/open-multi-agent-kit/issues"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "homepage": "https://github.com/dmae97/open-multi-agent-kit#readme",
-  "engines": {
-    "node": ">=20.0.0",
-    "npm": ">=10.0.0"
-  },
-  "optionalDependencies": {
-    "kuzu": "^0.11.3",
-    "playwright": "^1.44.0"
-  },
-  "overrides": {
-    "cmake-js": {
-      "tar": "^7.5.13"
-    }
-  }
+	"name": "open-multi-agent-kit",
+	"version": "0.80.3",
+	"description": "OMK interactive coding agent CLI with read, bash, edit, write tools, skills, hooks, MCP, and session management",
+	"type": "module",
+	"omkConfig": {
+		"name": "omk",
+		"configDir": ".omk"
+	},
+	"bin": {
+		"omk": "dist/cli.js"
+	},
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		},
+		"./hooks": {
+			"types": "./dist/core/hooks/index.d.ts",
+			"import": "./dist/core/hooks/index.js"
+		}
+	},
+	"files": [
+		"dist",
+		"docs",
+		"examples",
+		"containerization.md",
+		"CHANGELOG.md"
+	],
+	"scripts": {
+		"clean": "shx rm -rf dist",
+		"build": "tsgo -p tsconfig.build.json && shx chmod +x dist/cli.js && npm run copy-assets",
+		"build:binary": "npm --prefix ../tui run build && npm --prefix ../ai run build && npm --prefix ../agent run build && npm run build && bun build --compile ./dist/bun/cli.js ./src/utils/image-resize-worker.ts --outfile dist/omk && npm run copy-binary-assets",
+		"copy-assets": "shx mkdir -p dist/modes/interactive/theme && shx cp src/modes/interactive/theme/*.json dist/modes/interactive/theme/ && shx mkdir -p dist/modes/interactive/assets && shx cp src/modes/interactive/assets/*.png dist/modes/interactive/assets/ && shx mkdir -p dist/core/export-html/vendor && shx cp src/core/export-html/template.html src/core/export-html/template.css src/core/export-html/template.js dist/core/export-html/ && shx cp src/core/export-html/vendor/*.js dist/core/export-html/vendor/",
+		"copy-binary-assets": "shx cp package.json dist/ && shx cp README.md dist/ && shx cp CHANGELOG.md dist/ && shx mkdir -p dist/theme && shx cp src/modes/interactive/theme/*.json dist/theme/ && shx mkdir -p dist/assets && shx cp src/modes/interactive/assets/*.png dist/assets/ && shx mkdir -p dist/export-html/vendor && shx cp src/core/export-html/template.html dist/export-html/ && shx cp src/core/export-html/vendor/*.js dist/export-html/vendor/ && shx cp -r docs dist/ && shx cp -r examples dist/ && shx cp ../../node_modules/@silvia-odwyer/photon-node/photon_rs_bg.wasm dist/",
+		"test": "vitest --run",
+		"shrinkwrap": "node ../../scripts/generate-coding-agent-shrinkwrap.mjs",
+		"prepublishOnly": "npm run clean && npm run build"
+	},
+	"dependencies": {
+		"@earendil-works/omk-agent-core": "npm:@earendil-works/pi-agent-core@0.79.2",
+		"@earendil-works/omk-ai": "npm:@earendil-works/pi-ai@0.79.2",
+		"@earendil-works/omk-tui": "npm:@earendil-works/pi-tui@0.79.2",
+		"@silvia-odwyer/photon-node": "0.3.4",
+		"chalk": "5.6.2",
+		"cross-spawn": "7.0.6",
+		"diff": "8.0.4",
+		"glob": "13.0.6",
+		"highlight.js": "10.7.3",
+		"hosted-git-info": "9.0.3",
+		"ignore": "7.0.5",
+		"jiti": "2.7.0",
+		"minimatch": "10.2.5",
+		"proper-lockfile": "4.1.2",
+		"typebox": "1.1.38",
+		"undici": "8.3.0",
+		"yaml": "2.9.0"
+	},
+	"overrides": {
+		"rimraf": "6.1.2",
+		"gaxios": {
+			"rimraf": "6.1.2"
+		}
+	},
+	"optionalDependencies": {
+		"@mariozechner/clipboard": "0.3.9"
+	},
+	"devDependencies": {
+		"@types/cross-spawn": "6.0.6",
+		"@types/diff": "7.0.2",
+		"@types/hosted-git-info": "3.0.5",
+		"@types/ms": "2.1.0",
+		"@types/node": "24.12.4",
+		"@types/proper-lockfile": "4.1.4",
+		"shx": "0.4.0",
+		"typescript": "5.9.3",
+		"vitest": "3.2.6"
+	},
+	"keywords": [
+		"coding-agent",
+		"ai",
+		"llm",
+		"cli",
+		"tui",
+		"agent"
+	],
+	"author": "Mario Zechner",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/dmae97/open-multi-agent-kit.git",
+		"directory": "packages/coding-agent"
+	},
+	"engines": {
+		"node": ">=22.19.0"
+	},
+	"bugs": {
+		"url": "https://github.com/dmae97/open-multi-agent-kit/issues"
+	},
+	"homepage": "https://github.com/dmae97/open-multi-agent-kit#readme",
+	"publishConfig": {
+		"access": "public"
+	}
 }