@fabric-harness/node

Node.js runtime, build pipeline, dev server, and pluggable session stores for Fabric Harness.

Companion package to @fabric-harness/sdk. The SDK ships the runtime contract; this package provides the Node-flavored implementations that the CLI and most deployments use under the hood.

Install

npm install @fabric-harness/node @fabric-harness/sdk
# or
pnpm add @fabric-harness/node @fabric-harness/sdk

What's in the box

• Agent loader — discovers .fabricharness/agents/*.ts, transpiles them on-the-fly for fh dev / fh run.
• Skill / role loader — reads .fabricharness/skills/*.md and .fabricharness/roles/*.md with frontmatter.
• Build pipeline — buildWorkspace({ target: 'node' | 'cloudflare' | 'docker' | ... }) → deployable artifact + manifest.
• Dev server — startDevServer() exposes every agent as POST /agents/:agent/:id.
• Session stores:
  • FileSessionStore — JSON files under .fabricharness/sessions/.
  • SQLiteSessionStore — single-file embedded DB.
  • PostgresSessionStore — production-grade durable store.
  • createConfiguredSessionStore — pick by config.
• Inspection helpers — listSessions, inspectSession, getSessionMetrics, cancelSessionTask, etc.

Typical usage

You usually don't import this package directly — the @fabric-harness/cli wraps it. Reach for it when you're building custom tooling on top of Fabric Harness or embedding the runtime in another Node app.

import { startDevServer, createConfiguredSessionStore } from '@fabric-harness/node';

const store = await createConfiguredSessionStore({ /* ... */ });
await startDevServer({ port: 8787, store });

Documentation

• Session stores
• Building agents
• Full reference

License

Apache-2.0