@xandout/libra-harness 0.1.128 → 0.1.129

package/README.md

@@ -135,67 +135,25 @@ const loggingExtension: Extension = {
 agent.use(loggingExtension)
 ```
 
-### Built-in extensions (`@xandout/libra-harness/extras`)
+### Built-in extensions
 
-Libra ships with a set of optional extensions under `@xandout/libra-harness/extras`. Each is importable via its own subpath — import only what you need:
+Libra ships the extensions used by `libra-code` as explicit subpath exports:
 
 ```typescript
-import { createLoggerExtension } from '@xandout/libra-harness/extensions/logger'
 import { createDiskSessionExtension } from '@xandout/libra-harness/extensions/disk-session'
-
-agent.use(createLoggerExtension())
-agent.use(createDiskSessionExtension({ dir: './sessions' }))
+import { createCodeToolsExtension } from '@xandout/libra-harness/extensions/code-tools'
+import { createStreamingExtension } from '@xandout/libra-harness/extensions/streaming'
+import { createSkillExtension } from '@xandout/libra-harness/extensions/skills'
 ```
 
-| Extension | Import | Description |
-|-----------|--------|-------------|
-| logger | `@xandout/libra-harness/extensions/logger` | Logs each lifecycle stage |
-| streaming | `@xandout/libra-harness/extensions/streaming` | Streams text/reasoning/tool-input deltas |
-| otel | `@xandout/libra-harness/extensions/otel` | OpenTelemetry tracing (JSONL or OTLP export) |
-| weather-tool | `@xandout/libra-harness/extensions/weather-tool` | Registers a `get_weather` tool |
-| structured-output | `@xandout/libra-harness/extensions/structured-output` | Validates LLM output against a JSON schema |
-| mcp | `@xandout/libra-harness/extensions/mcp` | Connects to MCP servers, registers tools |
-| skills | `@xandout/libra-harness/extensions/skills` | Loads Agent Skills from directories |
-| filesystem | `@xandout/libra-harness/extensions/filesystem` | File read/write/list tools |
-| scripts | `@xandout/libra-harness/extensions/scripts` | Runs shell scripts in pipeline stages |
-| keyword-extractor | `@xandout/libra-harness/extensions/keyword-extractor` | Extracts keywords from messages (local NLP) |
-| token-stats | `@xandout/libra-harness/extensions/token-stats` | Tracks token usage per turn |
-| tool-buffer | `@xandout/libra-harness/extensions/tool-buffer` | Buffers and replays tool results |
-| auto-steer | `@xandout/libra-harness/extensions/auto-steer` | Auto-injects steering messages based on conditions |
-| emoji | `@xandout/libra-harness/extensions/emoji` | Decorates responses with an emoji prefix |
-| timestamp | `@xandout/libra-harness/extensions/timestamp` | Records start/finish timestamps in metadata |
-| disk-session | `@xandout/libra-harness/extensions/disk-session` | Disk-backed session history per session ID |
-| mem-session | `@xandout/libra-harness/extensions/mem-session` | In-memory session history per session ID |
-| memory | `@xandout/libra-harness/extensions/memory` | Long-term memory with LLM-based extraction |
-
-**Priority** controls hook execution order within each lifecycle stage (higher = runs first, ties keep registration order). Set `priority` on any extension whose hooks must run before or after another extension's hooks.
-
-See [`src/extensions/README.md`](src/extensions/README.md) for full API docs.
-
-### Extension loader
-
-For larger setups, `loadExtensions` accepts a mix of factory functions, `Extension` objects, and directory paths. It passes a shared config object to each factory, sorts by priority, and handles cleanup:
-
-```typescript
-import { loadExtensions, installExtensions, closeExtensions } from '@xandout/libra-harness/extensions'
-import { createLoggerExtension } from '@xandout/libra-harness/extensions/logger'
-import { createMcpExtension } from '@xandout/libra-harness/extensions/mcp'
-
-const loaded = await loadExtensions(
-  [
-    createLoggerExtension,        // factory — config passed automatically
-    createMcpExtension,           // factory — opts out if no mcpConfigPaths
-    './extensions',               // directory — discovers extensions by extension.json
-  ],
-  { mcpConfigPaths: './mcpServers.json' },
-)
+| Extension | Description |
+|-----------|-------------|
+| disk-session | Disk-backed session history per session ID |
+| code-tools | Coding, filesystem, shell, and task tools |
+| streaming | Text, reasoning, and tool-input delta callbacks |
+| skills | Agent Skill discovery and loading |
 
-installExtensions(loaded, agent)
-
-// ... run turns ...
-
-await closeExtensions(loaded)     // calls close() on extensions that have one (e.g. MCP)
-```
+**Priority** controls hook execution order within each lifecycle stage (higher = runs first, ties keep registration order).
 
 ## Model Providers
 
@@ -268,49 +226,6 @@ class MyModel implements Model {
 }
 ```
 
-## Virtual Models (OpenAI-compatible provider)
-
-Expose Libra agents as OpenAI-compatible models. Any framework that supports a custom OpenAI base URL can use your agents as models — with their own context, tools, extensions, and policy controls.
-
-```typescript
-import { Agent } from '@xandout/libra-harness'
-import { resolveModel } from '@xandout/libra-harness/models'
-import { createOpenAICompatibleServer } from '@xandout/libra-harness/openai-provider'
-
-const model = await resolveModel('deepseek/deepseek-v4-flash')
-
-const server = createOpenAICompatibleServer({
-  agents: {
-    'research-agent': new Agent({ model, systemPrompt: 'You are a research assistant.' }),
-    'coding-agent': new Agent({ model, systemPrompt: 'You are a coding assistant.' }),
-  },
-  apiKeys: ['your-provider-key'],
-})
-
-server.listen(8787, '127.0.0.1')
-```
-
-Now any OpenAI-compatible client can call these agents as models:
-
-```python
-client = OpenAI(base_url="http://127.0.0.1:8787/v1", api_key="your-provider-key")
-response = client.chat.completions.create(
-    model="research-agent",
-    messages=[{"role": "user", "content": "Research quantum computing"}],
-)
-```
-
-Features:
-- `GET /v1/models` and `POST /v1/chat/completions`
-- Bearer and `x-api-key` authentication
-- Text, image, system, developer, assistant, and tool messages
-- JSON and SSE streaming responses
-- Client-defined tools (external tool calling with round-trip)
-- Agent's own tools run internally (invisible to the caller)
-- Per-agent hooks for moderation, context injection, output filtering
-
-See [`docs/virtual-models.md`](docs/virtual-models.md) and [`docs/virtual-models-pii-dlp.md`](docs/virtual-models-pii-dlp.md) for concepts and the PII/DLP pattern.
-
 ## Hook Lifecycle
 
 ```
@@ -445,21 +360,6 @@ agent.use(streamingExtension)
 
 When `onDelta` is not set, `AISdkModel` uses `doGenerate` (no streaming overhead). The core never interprets deltas — it simply passes the callback through.
 
-## Examples
-
-The `examples/` directory includes reference implementations:
-
-- **`full-agent/`** — all built-in extensions via the loader, plus a local search-replace extension. Multi-turn session memory, MCP tools, skill loader, weather tool, streaming.
-- **`basic-agent-concurrent/`** — single agent handling many concurrent users with session isolation and per-turn halt.
-- **`subagents/`** — orchestrator agent delegating to specialized subagents via `createAgentTool`, with signal chaining and halt propagation.
-- **`subagents-concurrent/`** — orchestrator fanning out to multiple subagents in parallel via `Promise.all`.
-- **`structured-output/`** — `beforeResponse` hook that validates LLM output against a JSON schema.
-- **`streaming/`** — `beforeLLM` hook that streams text/reasoning/tool-input deltas.
-- **`openai-compatible-provider/`** — exposes multiple independent Libra agents as authenticated OpenAI-compatible models. Supports text, images, SSE streaming, and client-defined external tools.
-- **`pii-dlp-provider/`** — proves the virtual model PII/DLP pattern: the LLM never sees real PII, the consumer never sees placeholders. Uses a CSV datasource with tool calling and full lifecycle logging.
-- **`slack-bot/`** — full Slack bot with Socket Mode, block kit rendering, session persistence, MCP, skills, and OpenTelemetry tracing.
-- **`large-document-mapper/`** — processes large documents in chunks with mapping and reduction.
-
 ## Architecture
 
 - **Library-first** — no server, daemon, database, or queue required
@@ -470,8 +370,7 @@ The `examples/` directory includes reference implementations:
 - **Multimodal** — text, images, documents, audio, and video in message content
 - **Steerable & haltable** — per-turn controls via `RunHandle` or `ctx.turn`
 - **Streamable** — text, reasoning, and tool-input deltas via `onDelta` callback
-- **Virtual models** — expose agents as OpenAI-compatible models with full provider-side control
-- **Testable** — 354 tests with mock model
+- **Testable** — comprehensive tests with mock models
 
 ### What the core owns
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xandout/libra-harness",
-  "version": "0.1.128",
+  "version": "0.1.129",
   "description": "A small, composable, hookable agent harness. Library-first.",
   "repository": {
     "type": "git",
@@ -14,30 +14,10 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
-    "./extensions": {
-      "types": "./dist/extensions/index.d.ts",
-      "import": "./dist/extensions/index.js"
-    },
-    "./extensions/loader": {
-      "types": "./dist/extensions/loader.d.ts",
-      "import": "./dist/extensions/loader.js"
-    },
     "./models": {
       "types": "./dist/models/index.d.ts",
       "import": "./dist/models/index.js"
     },
-    "./models/ai-sdk-resolver": {
-      "types": "./dist/models/ai-sdk-resolver.d.ts",
-      "import": "./dist/models/ai-sdk-resolver.js"
-    },
-    "./models/routing-model": {
-      "types": "./dist/models/routing-model.d.ts",
-      "import": "./dist/models/routing-model.js"
-    },
-    "./openai-provider": {
-      "types": "./dist/openai-provider/index.d.ts",
-      "import": "./dist/openai-provider/index.js"
-    },
     "./extensions/disk-session": {
       "types": "./dist/extensions/disk-session/index.d.ts",
       "import": "./dist/extensions/disk-session/index.js"
@@ -53,26 +33,19 @@
     "./extensions/skills": {
       "types": "./dist/extensions/skills/index.d.ts",
       "import": "./dist/extensions/skills/index.js"
-    },
-    "./skills": {
-      "types": "./dist/extensions/skills/index.d.ts",
-      "import": "./dist/extensions/skills/index.js"
-    },
-    "./code-tools": {
-      "types": "./dist/extensions/code-tools/index.d.ts",
-      "import": "./dist/extensions/code-tools/index.js"
-    },
-    "./disk-session": {
-      "types": "./dist/extensions/disk-session/index.d.ts",
-      "import": "./dist/extensions/disk-session/index.js"
-    },
-    "./streaming": {
-      "types": "./dist/extensions/streaming/index.d.ts",
-      "import": "./dist/extensions/streaming/index.js"
     }
   },
   "files": [
-    "dist",
+    "dist/*.js",
+    "dist/*.js.map",
+    "dist/*.d.ts",
+    "dist/*.d.ts.map",
+    "dist/models",
+    "dist/extensions/code-tools",
+    "dist/extensions/disk-session",
+    "dist/extensions/skills",
+    "dist/extensions/streaming",
+    "!dist/**/*.test.*",
     "README.md"
   ],
   "publishConfig": {
@@ -90,47 +63,18 @@
     "node": ">=20"
   },
   "devDependencies": {
-    "@opentelemetry/sdk-trace-base": "^2.10.0",
     "@types/node": "^26.2.0",
     "@vitest/coverage-v8": "^4.1.10",
-    "fallow": "^3.22.0",
-    "quickjs-emscripten": "^0.32.0",
     "typescript": "^7.0.2",
     "vitest": "^4.1.10"
   },
-  "peerDependencies": {
-    "@modelcontextprotocol/client": "^2.0.0",
-    "@opentelemetry/api": "^1.9.0",
-    "@opentelemetry/sdk-trace-base": "^2.0.0",
-    "ai": "^7.0.0",
-    "quickjs-emscripten": "^0.32.0"
-  },
-  "peerDependenciesMeta": {
-    "ai": {
-      "optional": true
-    },
-    "@modelcontextprotocol/client": {
-      "optional": true
-    },
-    "@opentelemetry/api": {
-      "optional": true
-    },
-    "@opentelemetry/sdk-trace-base": {
-      "optional": true
-    },
-    "quickjs-emscripten": {
-      "optional": true
-    }
-  },
   "dependencies": {
     "@ai-sdk/anthropic": "^4.0.36",
     "@ai-sdk/deepseek": "^3.0.36",
     "@ai-sdk/google": "^4.0.39",
     "@ai-sdk/openai": "^4.0.36",
     "@ai-sdk/provider": "^4.0.7",
-    "ai": "^7.0.84",
-    "wink-eng-lite-web-model": "^1.8.1",
-    "wink-nlp": "^2.4.0"
+    "ai": "^7.0.84"
   },
   "scripts": {
     "build": "tsc && for d in src/extensions/*/; do name=$(basename \"$d\") && if [ -f \"$d\"extension.json ]; then cp \"$d\"extension.json dist/extensions/\"$name\"/; fi; done && cp src/extensions/code-tools/tools/task-wrapper.sh dist/extensions/code-tools/tools/task-wrapper.sh && chmod +x dist/extensions/code-tools/tools/task-wrapper.sh",

package/dist/extensions/code-tools/extension.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=extension.test.d.ts.map

package/dist/extensions/code-tools/extension.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"extension.test.d.ts","sourceRoot":"","sources":["../../../src/extensions/code-tools/extension.test.ts"],"names":[],"mappings":""}