@metaharness/kernel 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 RuvNet (https://ruv.io)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,66 @@
+# @metaharness/kernel
+
+Cross-platform kernel for the [agent-harness-generator](https://github.com/ruvnet/agent-harness-generator) project.
+
+## What it is
+
+A Rust kernel compiled to two npm-shippable targets:
+
+- **WebAssembly** (primary distribution — runs on Node, browser, Cloudflare Workers, Deno, Bun, edge)
+- **NAPI-RS native** (per-platform `.node` binaries — escape hatch for Node hot paths)
+
+At load time, `loadKernel()` prefers the per-platform native package; falls back to wasm.
+
+## Install
+
+```bash
+npm install @metaharness/kernel
+```
+
+The native packages (`@metaharness/kernel-darwin-arm64`, `-linux-x64-gnu`, etc.) are declared as `optionalDependencies` — npm installs only the one for your platform.
+
+## Usage
+
+```js
+import { loadKernel } from '@metaharness/kernel';
+
+const kernel = await loadKernel();
+const info = kernel.kernelInfo();
+console.log(`kernel ${info.version} (${kernel.backend})`);
+
+// Validate an MCP server spec.
+const err = kernel.mcpValidate(JSON.stringify({
+  name: 'demo',
+  command: ['npx', '-y', 'demo'],
+}));
+if (err) throw new Error(err);
+```
+
+### Memory subsystem (subpath export)
+
+```js
+import { rankWithDecay } from '@metaharness/kernel/memory';
+
+const ranked = await rankWithDecay(hits, {
+  useDecay: true,
+  halfLifeMs: 7 * 24 * 60 * 60 * 1000,  // 7-day half-life
+});
+```
+
+Wraps `@ruvector/emergent-time` for HNSW decay scoring.
+
+## Subsystems
+
+| Subsystem | What it does |
+|---|---|
+| `mcp` | MCP server spec + tool registry |
+| `hooks` | Lifecycle hook dispatch with permission-decision merge |
+| `memory` | AgentDB bridge + emergent-time decay weighting |
+| `routing` | 3-tier routing (codemod / Haiku / Sonnet-Opus) |
+| `intel` | Intelligence pipeline phases |
+| `claims` | Claims-based authorization |
+| `witness` | Ed25519-signed provenance manifests |
+
+## License
+
+MIT

package/dist/dispatch.d.ts

@@ -0,0 +1,45 @@
+export interface ToolHandler {
+    (args: Record<string, unknown>): Promise<unknown>;
+}
+export interface ToolClaim {
+    capability: string;
+    resource?: string;
+    expires_at: number;
+}
+export interface DispatchOptions {
+    server: string;
+    tool: string;
+    args: Record<string, unknown>;
+    claims: ToolClaim[];
+    resource?: string;
+}
+export type DispatchOutcome = {
+    kind: 'result';
+    output: unknown;
+} | {
+    kind: 'denied';
+    reason: string;
+} | {
+    kind: 'not-found';
+    server: string;
+    tool: string;
+} | {
+    kind: 'bad-args';
+    reason: string;
+};
+/**
+ * In-process tool dispatcher. Use for harnesses that register tool
+ * handlers directly in TS (host adapter wraps these).
+ */
+export declare class ToolDispatcher {
+    private handlers;
+    private key;
+    register(server: string, tool: string, handler: ToolHandler): void;
+    has(server: string, tool: string): boolean;
+    /**
+     * Execute the dispatch. Returns the structured outcome rather than
+     * throwing so callers can branch on the result type.
+     */
+    dispatch(opts: DispatchOptions, nowUnix?: number): Promise<DispatchOutcome>;
+}
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,WAAW;IAC1B,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAkC;IAElD,OAAO,CAAC,GAAG;IAIX,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAIlE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1C;;;OAGG;IACG,QAAQ,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,GAAE,MAAsC,GAAG,OAAO,CAAC,eAAe,CAAC;CAwBjH"}

package/dist/dispatch.js

@@ -0,0 +1,74 @@
+// SPDX-License-Identifier: MIT
+//
+// TS-side MCP tool dispatch wrapper.
+//
+// The Rust kernel owns the dispatch decision (look up tool, shape-check
+// args, claims check). This TS layer wraps that decision with the HOST-
+// SIDE execution: when the kernel returns `Invoke`, we run the actual
+// tool; when it returns Denied/NotFound/BadArgs, we surface the reason.
+/**
+ * In-process tool dispatcher. Use for harnesses that register tool
+ * handlers directly in TS (host adapter wraps these).
+ */
+export class ToolDispatcher {
+    handlers = new Map();
+    key(server, tool) {
+        return `${server}/${tool}`;
+    }
+    register(server, tool, handler) {
+        this.handlers.set(this.key(server, tool), handler);
+    }
+    has(server, tool) {
+        return this.handlers.has(this.key(server, tool));
+    }
+    /**
+     * Execute the dispatch. Returns the structured outcome rather than
+     * throwing so callers can branch on the result type.
+     */
+    async dispatch(opts, nowUnix = Math.floor(Date.now() / 1000)) {
+        if (!this.has(opts.server, opts.tool)) {
+            return { kind: 'not-found', server: opts.server, tool: opts.tool };
+        }
+        if (typeof opts.args !== 'object' || opts.args === null || Array.isArray(opts.args)) {
+            return { kind: 'bad-args', reason: 'args must be a non-array object' };
+        }
+        const cap = `tool.invoke.${opts.server}.${opts.tool}`;
+        const allowed = opts.claims.some(c => capabilityMatches(c.capability, cap) &&
+            resourceMatches(c.resource, opts.resource) &&
+            c.expires_at > nowUnix);
+        if (!allowed) {
+            return { kind: 'denied', reason: `no claim authorises ${cap}` };
+        }
+        try {
+            const handler = this.handlers.get(this.key(opts.server, opts.tool));
+            const output = await handler(opts.args);
+            return { kind: 'result', output };
+        }
+        catch (err) {
+            return { kind: 'denied', reason: err instanceof Error ? err.message : String(err) };
+        }
+    }
+}
+function capabilityMatches(granted, requested) {
+    if (granted === '*' || granted === requested)
+        return true;
+    if (granted.endsWith('.*')) {
+        const prefix = granted.slice(0, -2);
+        return requested === prefix || (requested.startsWith(prefix + '.'));
+    }
+    return false;
+}
+function resourceMatches(granted, requested) {
+    if (granted === undefined)
+        return true;
+    if (requested === undefined)
+        return false;
+    if (granted === requested || granted === '*')
+        return true;
+    if (granted.endsWith('/*')) {
+        const prefix = granted.slice(0, -2);
+        return requested.startsWith(prefix + '/');
+    }
+    return false;
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export type { McpServerSpec, ToolSpec, AgentSpec, HookSpec, HarnessSpec, HostAdapter } from './types.js';
+export interface KernelInfo {
+    version: string;
+    git_sha: string;
+    target: string;
+}
+interface KernelBackend {
+    kernelInfo(): KernelInfo;
+    mcpValidate(specJson: string): string | null;
+    version(): string;
+    backend: 'native' | 'wasm' | 'js';
+}
+/**
+ * Load the kernel. native > wasm > pure-JS. The JS backend is the floor, so
+ * this never rejects with a missing-module error. Cached.
+ */
+export declare function loadKernel(): Promise<KernelBackend>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzG,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,aAAa;IACrB,UAAU,IAAI,UAAU,CAAC;IACzB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC7C,OAAO,IAAI,MAAM,CAAC;IAClB,OAAO,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAAC;CACnC;AAuGD;;;GAGG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,aAAa,CAAC,CAKzD"}

package/dist/index.js

@@ -0,0 +1,127 @@
+// SPDX-License-Identifier: MIT
+//
+// @metaharness/kernel runtime resolver. Per ADR-002a, the kernel ships as Rust
+// source compiled to wasm + per-platform NAPI-RS for speed. BUT neither of
+// those is guaranteed to be present in a plain `npm install` (the wasm pkg/
+// is built by a separate CI job; the NAPI platform packages are optional).
+// Without a fallback, `loadKernel()` threw ERR_MODULE_NOT_FOUND and every
+// generated harness was dead on arrival. This module therefore ALWAYS has a
+// third backend: a dependency-free pure-JS implementation. native > wasm > js,
+// but js is the floor — the kernel is always loadable. (ADR-002a §fallback.)
+import { createRequire } from 'node:module';
+let _cached = null;
+async function loadNative() {
+    try {
+        const plat = `${process.platform}-${process.arch}`;
+        const map = {
+            'darwin-arm64': '@metaharness/kernel-darwin-arm64',
+            'darwin-x64': '@metaharness/kernel-darwin-x64',
+            'linux-x64': '@metaharness/kernel-linux-x64-gnu',
+            'linux-arm64': '@metaharness/kernel-linux-arm64-gnu',
+            'win32-x64': '@metaharness/kernel-win32-x64-msvc',
+        };
+        const pkg = map[plat];
+        if (!pkg)
+            return null;
+        const mod = await import(pkg);
+        return {
+            kernelInfo: () => mod.kernelInfo(),
+            mcpValidate: (s) => mod.mcpValidate(s) ?? null,
+            version: () => mod.version(),
+            backend: 'native',
+        };
+    }
+    catch {
+        return null;
+    }
+}
+async function loadWasm() {
+    try {
+        // @ts-ignore — generated by `wasm-pack build` into ../pkg/, absent during
+        // a TS-only build (the WASM CI job builds it separately). A miss is
+        // non-fatal: we fall through to the pure-JS backend below.
+        const mod = await import('../pkg/ruflo_kernel_wasm.js');
+        if (typeof mod.default === 'function') {
+            await mod.default();
+        }
+        return {
+            kernelInfo: () => mod.kernelInfo(),
+            mcpValidate: (s) => mod.mcpValidate(s) ?? null,
+            version: () => mod.version(),
+            backend: 'wasm',
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The kernel's own version, read from its package.json. Cached. Falls back to
+ * '0.0.0' only if the package.json is somehow unreadable (never expected).
+ */
+let _version = null;
+function kernelVersion() {
+    if (_version)
+        return _version;
+    try {
+        const require = createRequire(import.meta.url);
+        // dist/index.js → ../package.json
+        _version = require('../package.json').version ?? '0.0.0';
+    }
+    catch {
+        _version = '0.0.0';
+    }
+    return _version;
+}
+/**
+ * Pure-JS kernel backend — zero native/wasm dependencies, always available.
+ * It reimplements the load-bearing kernel surface (kernelInfo / version /
+ * mcpValidate) in TypeScript so a harness installed from npm works with no
+ * compiled artifacts. The validation rules mirror crates/kernel/src/mcp.rs
+ * exactly (server name non-empty; command XOR url) so behaviour is identical
+ * whether the native, wasm, or js backend answers.
+ */
+function loadJs() {
+    return {
+        kernelInfo: () => ({
+            version: kernelVersion(),
+            git_sha: 'js',
+            target: `${process.platform}-${process.arch}`,
+        }),
+        version: () => kernelVersion(),
+        mcpValidate: (specJson) => {
+            let spec;
+            try {
+                spec = JSON.parse(specJson);
+            }
+            catch (e) {
+                // Mirror the NAPI binding, which throws on unparseable spec JSON.
+                throw new Error(`invalid spec json: ${e.message}`);
+            }
+            // Rules, byte-for-byte from crates/kernel/src/mcp.rs::validate.
+            if (typeof spec.name !== 'string' || spec.name.length === 0) {
+                return 'server name is empty';
+            }
+            const hasCommand = Array.isArray(spec.command) && spec.command.length > 0;
+            const hasUrl = typeof spec.url === 'string' && spec.url.length > 0;
+            if (hasCommand && hasUrl)
+                return 'command and url are mutually exclusive';
+            if (!hasCommand && !hasUrl)
+                return 'either command or url must be set';
+            return null;
+        },
+        backend: 'js',
+    };
+}
+/**
+ * Load the kernel. native > wasm > pure-JS. The JS backend is the floor, so
+ * this never rejects with a missing-module error. Cached.
+ */
+export async function loadKernel() {
+    if (_cached)
+        return _cached;
+    const native = await loadNative();
+    _cached = native ?? (await loadWasm()) ?? loadJs();
+    return _cached;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/memory-rvf.d.ts

@@ -0,0 +1,22 @@
+import type { MemoryHit } from './memory.js';
+export interface RvfBackend {
+    /** Insert a vector into the index. */
+    insert(id: string, embedding: number[], namespace?: string): Promise<void>;
+    /** Search by embedding similarity. */
+    search(embedding: number[], k: number, namespace?: string): Promise<MemoryHit[]>;
+    /** Total items currently indexed. */
+    size(): Promise<number>;
+    /** Persist + flush. */
+    flush(): Promise<void>;
+}
+/** Is the RVF package installed and importable in the current process? */
+export declare function isRvfAvailable(): Promise<boolean>;
+/**
+ * Create an RVF-backed backend. Returns null if RVF isn't installed —
+ * caller falls back to the in-process HNSW.
+ */
+export declare function createRvfBackend(opts: {
+    dimensions: number;
+    metric?: 'cosine' | 'l2';
+}): Promise<RvfBackend | null>;
+//# sourceMappingURL=memory-rvf.d.ts.map

package/dist/memory-rvf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-rvf.d.ts","sourceRoot":"","sources":["../src/memory-rvf.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,UAAU;IACzB,sCAAsC;IACtC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,sCAAsC;IACtC,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACjF,qCAAqC;IACrC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,uBAAuB;IACvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAiCD,0EAA0E;AAC1E,wBAAsB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAEvD;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;CAC1B,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CA2C7B"}

package/dist/memory-rvf.js

@@ -0,0 +1,87 @@
+// SPDX-License-Identifier: MIT
+//
+// memory-rvf — graceful-fallback wrapper over @ruvector/rvf
+// (https://www.npmjs.com/package/@ruvector/rvf).
+//
+// RVF is "RuVector Format — unified TypeScript SDK for vector intelligence":
+// HNSW-indexed binary vector format with SIMD, dual-target (TypeScript
+// runtime + optional @ruvector/rvf-wasm). When the user has RVF installed
+// AND wants RVF-backed memory storage, the kernel uses it; otherwise the
+// memory subsystem keeps using its plain in-process HNSW.
+//
+// RVF is declared as an OPTIONAL peer dep so the kernel doesn't bloat
+// install size for users who don't need it. The pairing matters most
+// for RVM-deployed harnesses — RVM's wasm guest can run rvf-wasm
+// inside the partition for hardware-isolated vector storage.
+let _rvf;
+async function loadRvf() {
+    if (_rvf !== undefined)
+        return _rvf;
+    try {
+        // @ts-ignore — @ruvector/rvf is declared as an OPTIONAL peer
+        // dependency, so a fresh CI install without it must build cleanly.
+        // The graceful-fallback path returns null when the package is absent.
+        _rvf = await import('@ruvector/rvf');
+        return _rvf;
+    }
+    catch {
+        _rvf = null;
+        return null;
+    }
+}
+/** Is the RVF package installed and importable in the current process? */
+export async function isRvfAvailable() {
+    return (await loadRvf()) !== null;
+}
+/**
+ * Create an RVF-backed backend. Returns null if RVF isn't installed —
+ * caller falls back to the in-process HNSW.
+ */
+export async function createRvfBackend(opts) {
+    const mod = await loadRvf();
+    if (!mod)
+        return null;
+    const createIndex = mod.createIndex ?? mod.default?.createIndex;
+    if (typeof createIndex !== 'function')
+        return null;
+    const indexByNs = new Map();
+    const ensure = async (ns) => {
+        let idx = indexByNs.get(ns);
+        if (!idx) {
+            idx = await createIndex({ dimensions: opts.dimensions, metric: opts.metric ?? 'cosine' });
+            indexByNs.set(ns, idx);
+        }
+        return idx;
+    };
+    return {
+        async insert(id, embedding, namespace = 'default') {
+            const idx = await ensure(namespace);
+            await idx.add(id, embedding);
+        },
+        async search(embedding, k, namespace = 'default') {
+            const idx = await ensure(namespace);
+            const raw = await idx.search(embedding, k);
+            return raw.map(r => ({
+                id: r.id,
+                score: r.score,
+                decayedScore: r.score, // memory.rankWithDecay applies decay separately
+                namespace,
+            }));
+        },
+        async size() {
+            let total = 0;
+            for (const idx of indexByNs.values()) {
+                const count = await (idx.count?.() ?? idx.size?.() ?? Promise.resolve(0));
+                total += count ?? 0;
+            }
+            return total;
+        },
+        async flush() {
+            for (const idx of indexByNs.values()) {
+                if (typeof idx.flush === 'function')
+                    await idx.flush();
+            }
+        },
+    };
+}
+//# sourceMappingURL=memory-rvf.js.map

package/dist/memory-rvf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-rvf.js","sourceRoot":"","sources":["../src/memory-rvf.ts"],"names":[],"mappings":"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"}

package/dist/memory.d.ts

@@ -0,0 +1,55 @@
+export interface MemoryHit {
+    /** Memory entry id. */
+    id: string;
+    /** Raw cosine similarity (0..1) — what HNSW returned. */
+    score: number;
+    /**
+     * Decay-weighted score. When emergent-time isn't loaded, equals `score`.
+     * When loaded, multiplied by the AgenticClock weight for the entry's age.
+     */
+    decayedScore: number;
+    /** Namespace the hit lives in. */
+    namespace: string;
+    /** When this entry was stored (ms since epoch). */
+    storedAt?: number;
+}
+export interface DecayConfig {
+    /** Reference timestamp for "now" (ms). Defaults to Date.now() at query time. */
+    now?: number;
+    /** When true, returns hits ranked by decayedScore. When false, by score. */
+    useDecay?: boolean;
+    /**
+     * Half-life in milliseconds — at this age, decay weight is 0.5. The
+     * AgenticClock translates this into a six-channel structural-proper-time
+     * estimate; we surface only the resulting weight here.
+     */
+    halfLifeMs?: number;
+}
+/**
+ * Rank a list of raw HNSW hits, applying AgenticClock decay weights when
+ * `useDecay` is true and the emergent-time package is available.
+ *
+ * Returns a NEW array sorted descending by decayedScore (when useDecay=true)
+ * or score (when false).
+ */
+export declare function rankWithDecay(hits: MemoryHit[], config?: DecayConfig): Promise<MemoryHit[]>;
+/**
+ * Change-point trigger for the DISTILL phase. Feeds a stream of
+ * trajectory-success scores into PageHinkleyDetector; when the detector
+ * fires, the intel pipeline kicks DISTILL.
+ *
+ * Returns a callable that consumes scores one at a time.
+ */
+export declare function distillTrigger(opts?: {
+    threshold?: number;
+    delta?: number;
+}): Promise<(score: number) => {
+    changePoint: boolean;
+    magnitude: number;
+}>;
+/**
+ * Linear decay function for tests / fallback paths that need a simple
+ * deterministic weight without loading emergent-time.
+ */
+export declare function linearDecay(ageMs: number, halfLifeMs: number): number;
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,SAAS;IACxB,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,gFAAgF;IAChF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA6BD;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,SAAS,EAAE,EACjB,MAAM,GAAE,WAAgB,GACvB,OAAO,CAAC,SAAS,EAAE,CAAC,CAyBtB;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAC9F,CAAC,KAAK,EAAE,MAAM,KAAK;IAAE,WAAW,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAC/D,CASA;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAIrE"}

package/dist/memory.js

@@ -0,0 +1,100 @@
+// SPDX-License-Identifier: MIT
+//
+// Memory subsystem TS bridge.
+//
+// Per ADR-006, the kernel exposes the memory BRIDGE API. The actual vector
+// store is AgentDB-backed; the kernel adds DECAY-WEIGHTED scoring on top of
+// raw cosine similarity, driven by `@ruvector/emergent-time@0.1.0`.
+//
+// The integration follows the per-API mapping table in ADR-006:
+//   - AgenticClock        -> per-memory decay weight (HNSW score multiplier)
+//   - WindowedDeltaClock  -> trajectory-step weighting (intel pipeline)
+//   - PageHinkleyDetector -> change-point trigger for DISTILL phase firing
+//   - LearnedWeights      -> reserved for self-evolution (iter 7+, ADR-014)
+//
+// All four exports come from the same npm package the user shipped
+// today: https://www.npmjs.com/package/@ruvector/emergent-time
+//
+// Honesty caveat (from the @ruvector/emergent-time README): the SDK is
+// "diagnostic signal, no proven early-warning lead over a fair baseline".
+// So we gate the decay-weighted path behind a feature flag and ALWAYS
+// preserve the raw cosine score so callers can compare.
+let _emergent;
+async function loadEmergent() {
+    if (_emergent !== undefined)
+        return _emergent;
+    try {
+        const mod = await import('@ruvector/emergent-time');
+        // Probe-construct an AgenticClock to confirm WASM is actually initialised.
+        // The dynamic-import resolves the JS shim even when the underlying WASM
+        // bindings haven't been bootstrapped, so a present-module check isn't
+        // enough — the constructor throws on first use ("Cannot read properties
+        // of undefined (reading 'agenticclock_new')"). Probe + discard catches
+        // that case and routes the caller to its raw-score fallback.
+        new mod.AgenticClock({ halfLifeMs: 1000 });
+        _emergent = mod;
+        return mod;
+    }
+    catch {
+        _emergent = null;
+        return null;
+    }
+}
+/**
+ * Rank a list of raw HNSW hits, applying AgenticClock decay weights when
+ * `useDecay` is true and the emergent-time package is available.
+ *
+ * Returns a NEW array sorted descending by decayedScore (when useDecay=true)
+ * or score (when false).
+ */
+export async function rankWithDecay(hits, config = {}) {
+    const now = config.now ?? Date.now();
+    const useDecay = config.useDecay ?? true;
+    const halfLifeMs = config.halfLifeMs ?? 7 * 24 * 60 * 60 * 1000; // 7 days
+    if (!useDecay) {
+        return [...hits].sort((a, b) => b.score - a.score);
+    }
+    const emergent = await loadEmergent();
+    if (!emergent) {
+        // Graceful fallback — return raw scores in `decayedScore` so callers
+        // don't have to special-case the absence of emergent-time.
+        return [...hits].map(h => ({ ...h, decayedScore: h.score }))
+            .sort((a, b) => b.decayedScore - a.decayedScore);
+    }
+    const clock = new emergent.AgenticClock({ halfLifeMs });
+    const ranked = hits.map(h => {
+        const ageMs = h.storedAt !== undefined ? Math.max(0, now - h.storedAt) : 0;
+        const weight = clock.weight(ageMs);
+        return { ...h, decayedScore: h.score * weight };
+    });
+    ranked.sort((a, b) => b.decayedScore - a.decayedScore);
+    return ranked;
+}
+/**
+ * Change-point trigger for the DISTILL phase. Feeds a stream of
+ * trajectory-success scores into PageHinkleyDetector; when the detector
+ * fires, the intel pipeline kicks DISTILL.
+ *
+ * Returns a callable that consumes scores one at a time.
+ */
+export async function distillTrigger(opts = {}) {
+    const emergent = await loadEmergent();
+    if (!emergent) {
+        // Fallback: never fire. Caller's DISTILL phase still runs on its
+        // threshold-based gate.
+        return (_score) => ({ changePoint: false, magnitude: 0 });
+    }
+    const detector = new emergent.PageHinkleyDetector(opts);
+    return (score) => detector.feed(score);
+}
+/**
+ * Linear decay function for tests / fallback paths that need a simple
+ * deterministic weight without loading emergent-time.
+ */
+export function linearDecay(ageMs, halfLifeMs) {
+    if (ageMs <= 0)
+        return 1;
+    const halves = ageMs / halfLifeMs;
+    return Math.pow(0.5, halves);
+}
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"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"}

package/dist/self-evolution.d.ts

@@ -0,0 +1,63 @@
+export type RoutingTier = 'codemod' | 'small' | 'frontier';
+export interface RoutingHistoryEntry {
+    /** Tier that was chosen. */
+    tier: RoutingTier;
+    /** Did the call succeed (e.g. task completed)? */
+    success: boolean;
+    /** Latency in ms. */
+    latencyMs: number;
+    /** Approximate cost in USD. */
+    costUsd: number;
+    /** Optional task fingerprint (semantic class). */
+    taskFingerprint?: string;
+}
+export interface SelfEvolvingConfig {
+    /** When true, applies learned weights. When false, passes through. */
+    enabled: boolean;
+    /** Reward signal weights. Defaults sum to 1.0. */
+    rewardMix?: {
+        successWeight: number;
+        latencyWeight: number;
+        costWeight: number;
+    };
+    /** Bias toward small-tier (saving budget) — multiplier on small's weight. */
+    smallTierBias?: number;
+}
+/**
+ * Compute a reward in [0, 1] from a single routing outcome.
+ *
+ * - success contributes successWeight directly (1 if succeeded, 0 if not)
+ * - latency contributes latencyWeight scaled by 1/(1 + ms/1000) — saturates
+ * - cost contributes costWeight scaled by 1/(1 + usd*1000) — saturates
+ */
+export declare function computeReward(entry: RoutingHistoryEntry, config: SelfEvolvingConfig): number;
+/**
+ * A learned-weights router. Wraps the kernel router's decision with a
+ * post-hoc weight applied to each tier; weights update from outcomes.
+ *
+ * When `config.enabled === false`, this is a pure pass-through.
+ */
+export declare class SelfEvolvingRouter {
+    private config;
+    private weights;
+    private history;
+    private impl;
+    constructor(config: SelfEvolvingConfig);
+    ensureLoaded(): Promise<void>;
+    /**
+     * Record an outcome and update learned weights.
+     * Returns the reward used (for tests/telemetry).
+     */
+    recordOutcome(entry: RoutingHistoryEntry): Promise<number>;
+    /**
+     * Get the current weight for a tier. Higher = more preferred.
+     */
+    weightFor(tier: RoutingTier): number;
+    /**
+     * Re-rank a tier shortlist by current weights.
+     * Returns tiers ordered most preferred first.
+     */
+    reRank(tiers: RoutingTier[]): RoutingTier[];
+    history_(): readonly RoutingHistoryEntry[];
+}
+//# sourceMappingURL=self-evolution.d.ts.map

package/dist/self-evolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-evolution.d.ts","sourceRoot":"","sources":["../src/self-evolution.ts"],"names":[],"mappings":"AAgBA,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AAE3D,MAAM,WAAW,mBAAmB;IAClC,4BAA4B;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,kDAAkD;IAClD,OAAO,EAAE,OAAO,CAAC;IACjB,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,OAAO,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,SAAS,CAAC,EAAE;QACV,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAgCD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,mBAAmB,EAAE,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAY5F;AAED;;;;;GAKG;AACH,qBAAa,kBAAkB;IAKjB,OAAO,CAAC,MAAM;IAJ1B,OAAO,CAAC,OAAO,CAAsE;IACrF,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,IAAI,CAAgI;gBAExH,MAAM,EAAE,kBAAkB;IAExC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IASnC;;;OAGG;IACG,aAAa,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IAkChE;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM;IAIpC;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE;IAI3C,QAAQ,IAAI,SAAS,mBAAmB,EAAE;CAG3C"}

package/dist/self-evolution.js

@@ -0,0 +1,138 @@
+// SPDX-License-Identifier: MIT
+//
+// Self-evolving routing. Wraps `@ruvector/emergent-time`'s LearnedWeights
+// over the kernel's 3-tier router so a harness can ADAPT its routing
+// decisions over time based on the outcomes of past calls.
+//
+// Per ADR-014 (Self-evolution + federation), this is the "exotic" mode —
+// off by default, opt-in. When enabled, every routing decision feeds back
+// a reward signal (success/failure + latency + cost), and the LearnedWeights
+// inference shifts future decisions toward whichever tier worked best for
+// similar tasks.
+//
+// Honesty caveat from the @ruvector/emergent-time README applies here:
+// "diagnostic signal, no proven early-warning lead over a fair baseline".
+// The self-evolving path is gated behind explicit opt-in for that reason.
+let _emergent;
+async function loadEmergent() {
+    if (_emergent !== undefined)
+        return _emergent;
+    try {
+        const mod = await import('@ruvector/emergent-time');
+        // Probe-construct + verify the API contract holds. Catches both:
+        //   (1) WASM not initialised — constructor throws on `learnedweights_new`
+        //   (2) API drift — module loaded but `.update` no longer on the prototype
+        // In either case, fall back to the local EMA path so tests + runtime see
+        // a consistent "graceful absent" signal.
+        const probe = new mod.LearnedWeights({ tiers: ['probe'] });
+        if (typeof probe.update !== 'function' || typeof probe.weights !== 'function') {
+            throw new Error('LearnedWeights API surface drifted');
+        }
+        _emergent = mod;
+        return mod;
+    }
+    catch {
+        _emergent = null;
+        return null;
+    }
+}
+/**
+ * Compute a reward in [0, 1] from a single routing outcome.
+ *
+ * - success contributes successWeight directly (1 if succeeded, 0 if not)
+ * - latency contributes latencyWeight scaled by 1/(1 + ms/1000) — saturates
+ * - cost contributes costWeight scaled by 1/(1 + usd*1000) — saturates
+ */
+export function computeReward(entry, config) {
+    const mix = config.rewardMix ?? { successWeight: 0.5, latencyWeight: 0.3, costWeight: 0.2 };
+    const successComponent = entry.success ? 1 : 0;
+    const latencyComponent = 1 / (1 + entry.latencyMs / 1000);
+    const costComponent = 1 / (1 + entry.costUsd * 1000);
+    const total = mix.successWeight * successComponent +
+        mix.latencyWeight * latencyComponent +
+        mix.costWeight * costComponent;
+    // Normalise to [0, 1] in case the weights don't sum to 1.
+    const denominator = mix.successWeight + mix.latencyWeight + mix.costWeight;
+    return total / denominator;
+}
+/**
+ * A learned-weights router. Wraps the kernel router's decision with a
+ * post-hoc weight applied to each tier; weights update from outcomes.
+ *
+ * When `config.enabled === false`, this is a pure pass-through.
+ */
+export class SelfEvolvingRouter {
+    config;
+    weights = { codemod: 1, small: 1, frontier: 1 };
+    history = [];
+    impl = null;
+    constructor(config) {
+        this.config = config;
+    }
+    async ensureLoaded() {
+        if (!this.config.enabled)
+            return;
+        if (this.impl)
+            return;
+        const emergent = await loadEmergent();
+        if (emergent) {
+            this.impl = new emergent.LearnedWeights({ tiers: ['codemod', 'small', 'frontier'] });
+        }
+    }
+    /**
+     * Record an outcome and update learned weights.
+     * Returns the reward used (for tests/telemetry).
+     */
+    async recordOutcome(entry) {
+        this.history.push(entry);
+        if (!this.config.enabled)
+            return 0;
+        await this.ensureLoaded();
+        const reward = computeReward(entry, this.config);
+        if (this.impl) {
+            this.impl.update(entry.tier, reward);
+            const w = this.impl.weights();
+            this.weights = {
+                codemod: w.codemod ?? 1,
+                small: w.small ?? 1,
+                frontier: w.frontier ?? 1,
+            };
+        }
+        else {
+            // Local exponential moving average fallback when emergent-time
+            // isn't installed. Smaller learning rate so single bad runs don't
+            // crater a tier.
+            //
+            // Important: the EMA target is `reward * 2`, not `reward`. computeReward
+            // returns values in [0, 1] where 0.5 is "neutral / break-even". Mapping
+            // to [0, 2] keeps the initial weight of 1.0 as the neutral baseline:
+            // successful tiers pull above 1.0, failed tiers pull below, untouched
+            // tiers stay at 1.0. Without this rescale, ALL tiers slowly drift below
+            // 1.0 and untouched tiers always win — silently breaking re-ranking.
+            const lr = 0.1;
+            const target = reward * 2;
+            this.weights[entry.tier] = (1 - lr) * this.weights[entry.tier] + lr * target;
+        }
+        if (this.config.smallTierBias) {
+            this.weights.small *= this.config.smallTierBias;
+        }
+        return reward;
+    }
+    /**
+     * Get the current weight for a tier. Higher = more preferred.
+     */
+    weightFor(tier) {
+        return this.weights[tier];
+    }
+    /**
+     * Re-rank a tier shortlist by current weights.
+     * Returns tiers ordered most preferred first.
+     */
+    reRank(tiers) {
+        return [...tiers].sort((a, b) => this.weights[b] - this.weights[a]);
+    }
+    history_() {
+        return this.history;
+    }
+}
+//# sourceMappingURL=self-evolution.js.map

package/dist/self-evolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-evolution.js","sourceRoot":"","sources":["../src/self-evolution.ts"],"names":[],"mappings":"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"}

package/dist/trajectory.d.ts

@@ -0,0 +1,20 @@
+export interface TrajectoryRecord {
+    /** ISO-8601 timestamp. */
+    ts: string;
+    /** Pipeline phase. */
+    phase: 'Retrieve' | 'Judge' | 'Distill' | 'Consolidate';
+    /** Outcome — Success/Skip/Fail in lowercase for JSONL compactness. */
+    outcome: 'success' | 'skip' | 'fail';
+    /** Free-form output. */
+    output?: unknown;
+}
+export declare class TrajectoryStore {
+    private path;
+    constructor(path: string);
+    append(record: TrajectoryRecord): Promise<void>;
+    readAll(): Promise<TrajectoryRecord[]>;
+    /** Rotate the file if it exceeds maxBytes. Old data goes to `<path>.1`. */
+    rotateIfLarger(maxBytes: number): Promise<boolean>;
+    size(): Promise<number>;
+}
+//# sourceMappingURL=trajectory.d.ts.map

package/dist/trajectory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trajectory.d.ts","sourceRoot":"","sources":["../src/trajectory.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,sBAAsB;IACtB,KAAK,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,aAAa,CAAC;IACxD,sEAAsE;IACtE,OAAO,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IACrC,wBAAwB;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,qBAAa,eAAe;IACd,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,MAAM;IAE1B,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,OAAO,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAM5C,2EAA2E;IACrE,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASlD,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;CAI9B"}

package/dist/trajectory.js

@@ -0,0 +1,43 @@
+// SPDX-License-Identifier: MIT
+//
+// Trajectory persistence — JSONL append-only store for the intel pipeline's
+// RETRIEVE → JUDGE → DISTILL → CONSOLIDATE phases.
+//
+// Append-only: each record is one line of JSON. Reading is a streaming
+// line-by-line parse so unbounded growth doesn't blow up memory. Optional
+// rotation cap (records-old-than-N or file-size-greater-than-M) keeps
+// the store bounded.
+import { appendFile, readFile, stat, rename, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+export class TrajectoryStore {
+    path;
+    constructor(path) {
+        this.path = path;
+    }
+    async append(record) {
+        await appendFile(this.path, JSON.stringify(record) + '\n', 'utf-8');
+    }
+    async readAll() {
+        if (!existsSync(this.path))
+            return [];
+        const raw = await readFile(this.path, 'utf-8');
+        return raw.split('\n').filter(Boolean).map(l => JSON.parse(l));
+    }
+    /** Rotate the file if it exceeds maxBytes. Old data goes to `<path>.1`. */
+    async rotateIfLarger(maxBytes) {
+        if (!existsSync(this.path))
+            return false;
+        const s = await stat(this.path);
+        if (s.size <= maxBytes)
+            return false;
+        await rename(this.path, this.path + '.1');
+        await writeFile(this.path, '', 'utf-8');
+        return true;
+    }
+    async size() {
+        if (!existsSync(this.path))
+            return 0;
+        return (await stat(this.path)).size;
+    }
+}
+//# sourceMappingURL=trajectory.js.map

package/dist/trajectory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trajectory.js","sourceRoot":"","sources":["../src/trajectory.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,4EAA4E;AAC5E,mDAAmD;AACnD,EAAE;AACF,uEAAuE;AACvE,0EAA0E;AAC1E,sEAAsE;AACtE,qBAAqB;AAErB,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAarC,MAAM,OAAO,eAAe;IACN;IAApB,YAAoB,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;IAAG,CAAC;IAEpC,KAAK,CAAC,MAAM,CAAC,MAAwB;QACnC,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC/C,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAqB,CAAC,CAAC;IACrF,CAAC;IAED,2EAA2E;IAC3E,KAAK,CAAC,cAAc,CAAC,QAAgB;QACnC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QACzC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,CAAC,IAAI,IAAI,QAAQ;YAAE,OAAO,KAAK,CAAC;QACrC,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;QAC1C,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;QACrC,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACtC,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,40 @@
+export interface McpServerSpec {
+    name: string;
+    command?: string[];
+    url?: string;
+    env?: Array<[string, string]>;
+}
+export interface ToolSpec {
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+}
+export interface AgentSpec {
+    name: string;
+    systemPrompt?: string;
+}
+export interface HookSpec {
+    event: string;
+    matcher?: string;
+    handler: string;
+}
+export interface HarnessSpec {
+    name: string;
+    description?: string;
+    systemPrompt?: string;
+    mcpServers?: McpServerSpec[];
+    tools?: ToolSpec[];
+    agents?: AgentSpec[];
+    hooks?: HookSpec[];
+    permissions?: {
+        allow?: string[];
+        deny?: string[];
+    };
+    statusLine?: string;
+}
+export interface HostAdapter {
+    name: string;
+    /** Return a map of file-path -> file-content for the host's config. */
+    generateConfig(spec: HarnessSpec): Record<string, string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3D"}

package/dist/types.js

@@ -0,0 +1,7 @@
+// SPDX-License-Identifier: MIT
+//
+// Shared types consumed by the host adapter packages. Defined separately
+// from the runtime loader so adapters can `import type` without pulling
+// the wasm/native loader into their bundle.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,yEAAyE;AACzE,wEAAwE;AACxE,4CAA4C"}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@metaharness/kernel",
+  "version": "0.1.0",
+  "description": "Cross-platform kernel for the agent-harness-generator — wasm primary, NAPI-RS native fallback",
+  "homepage": "https://github.com/ruvnet/agent-harness-generator",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ruvnet/agent-harness-generator.git",
+    "directory": "packages/kernel-js"
+  },
+  "license": "MIT",
+  "author": "rUv <ruv@ruv.net>",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./memory": {
+      "types": "./dist/memory.d.ts",
+      "import": "./dist/memory.js"
+    },
+    "./memory-rvf": {
+      "types": "./dist/memory-rvf.d.ts",
+      "import": "./dist/memory-rvf.js"
+    },
+    "./dispatch": {
+      "types": "./dist/dispatch.d.ts",
+      "import": "./dist/dispatch.js"
+    }
+  },
+  "files": [
+    "dist/**",
+    "pkg/**",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "lint": "tsc --noEmit"
+  },
+  "keywords": [
+    "agent-harness",
+    "mcp",
+    "wasm",
+    "kernel",
+    "ruflo"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@ruvector/emergent-time": "^0.1.0"
+  },
+  "peerDependencies": {
+    "@ruvector/rvf": "^0.2.0"
+  },
+  "peerDependenciesMeta": {
+    "@ruvector/rvf": {
+      "optional": true
+    }
+  },
+  "optionalDependencies": {
+    "@metaharness/kernel-darwin-arm64": "0.1.0",
+    "@metaharness/kernel-darwin-x64": "0.1.0",
+    "@metaharness/kernel-linux-x64-gnu": "0.1.0",
+    "@metaharness/kernel-linux-arm64-gnu": "0.1.0",
+    "@metaharness/kernel-win32-x64-msvc": "0.1.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}