@moolam/edge-agent 1.0.0

package/dist/slm_runtime.js

@@ -0,0 +1,247 @@
+/**
+ * @module slm_runtime
+ *
+ * Pluggable local inference boundary of the Edge Harness.
+ *
+ * The harness never links against a specific inference engine. Instead it
+ * speaks `SlmRuntime`, and adapters bind that interface to whatever the
+ * host device offers:
+ *   - llama.cpp / GGUF   (`@moolam/bindings-slm` LlamaCppSlmRuntime;
+ *     ModelInterface via createLlamaCppModelAdapter / createSlmModelAdapter)
+ *   - ONNX Runtime Mobile (quantized INT4/INT8 exports)
+ *   - MediaPipe LLM Inference API (Android AICore)
+ *   - Apple Foundation Models / MLX (iOS)
+ *   - any localhost OpenAI-compatible server (Ollama, llamafile)
+ *
+ * CognitiveCore consumes ModelInterface. Pass a loaded LlamaCppSlmRuntime
+ * into edge cognitive bindings, or call createLlamaCppModelAdapter and
+ * inject the resulting model into the binding set.
+ *
+ * This is what makes the Edge Harness sovereign: a district deployment can
+ * swap models and engines without touching a line of domain code.
+ */
+/** Init/load obligation named on typed failures (never silent catch-and-continue). */
+export const EDGE_SLM_LOAD_OBLIGATION = "EDGE.SLM_LOAD";
+/**
+ * Typed initialization/load failure for local model weights.
+ * Hosts MUST surface this to the operator — never retry unboundedly.
+ */
+export class SlmRuntimeInitError extends Error {
+    name = "SlmRuntimeInitError";
+    failureClass;
+    obligationId;
+    reason;
+    constructor(message, opts) {
+        super(message);
+        this.failureClass = opts.failureClass;
+        this.reason = opts.reason;
+        this.obligationId = opts.obligationId ?? EDGE_SLM_LOAD_OBLIGATION;
+    }
+}
+/** Magic prefix for drill / on-disk weight fixtures (not a full GGUF parser). */
+export const SLM_WEIGHTS_MAGIC = "SUTRA-WEIGHTS-v1";
+/**
+ * File-backed SlmRuntime load seam used for edge degradation drills and
+ * host deployments that materialize weights from disk before inference.
+ *
+ * Missing or corrupt weights → {@link SlmRuntimeInitError} once per `load()`
+ * (no internal retry loop). Generation requires a prior successful load.
+ */
+export class LocalWeightSlmRuntime {
+    card;
+    options;
+    loaded = false;
+    loadAttempts = 0;
+    constructor(card, options) {
+        this.card = card;
+        this.options = options;
+        if (!options.weightsPath || !String(options.weightsPath).trim()) {
+            throw new SlmRuntimeInitError("LocalWeightSlmRuntime requires weightsPath", {
+                failureClass: "config",
+                reason: "config",
+            });
+        }
+    }
+    /** How many times `load()` has been invoked (crash-loop detection). */
+    get loadAttemptCount() {
+        return this.loadAttempts;
+    }
+    get isLoaded() {
+        return this.loaded;
+    }
+    async load() {
+        this.loadAttempts += 1;
+        if (this.loaded) {
+            this.emit({ op: "load", outcome: "ok" });
+            return;
+        }
+        const fs = await import("node:fs/promises");
+        const path = this.options.weightsPath;
+        let bytes;
+        try {
+            bytes = new Uint8Array(await fs.readFile(path));
+        }
+        catch (err) {
+            const code = err && typeof err === "object" && "code" in err
+                ? String(err.code)
+                : "";
+            if (code === "ENOENT" || code === "ENOTDIR") {
+                throw this.failLoad("missing", `model weights missing at path`);
+            }
+            throw this.failLoad("corrupt", `model weights unreadable (${code || "io_error"})`);
+        }
+        if (bytes.byteLength === 0) {
+            throw this.failLoad("corrupt", "model weights file is empty");
+        }
+        const header = new TextDecoder().decode(bytes.subarray(0, Math.min(bytes.byteLength, SLM_WEIGHTS_MAGIC.length)));
+        if (header !== SLM_WEIGHTS_MAGIC) {
+            throw this.failLoad("corrupt", "model weights magic header mismatch");
+        }
+        if (this.options.inspectWeights && !this.options.inspectWeights(bytes)) {
+            throw this.failLoad("corrupt", "model weights failed integrity inspect");
+        }
+        this.loaded = true;
+        this.emit({ op: "load", outcome: "ok" });
+    }
+    async unload() {
+        this.loaded = false;
+        this.emit({ op: "unload", outcome: "ok" });
+    }
+    async generate(_params) {
+        if (!this.loaded) {
+            throw new SlmRuntimeInitError("SlmRuntime.generate before successful load", {
+                failureClass: "config",
+                reason: "config",
+            });
+        }
+        // Reference: weights-validated stub; native adapters replace with real inference.
+        return { text: "", tokensPerSecond: 0, finishReason: "stop" };
+    }
+    async *generateStream(params) {
+        const result = await this.generate(params);
+        if (result.text)
+            yield result.text;
+    }
+    async embed(_text) {
+        if (!this.loaded) {
+            throw new SlmRuntimeInitError("SlmRuntime.embed before successful load", {
+                failureClass: "config",
+                reason: "config",
+            });
+        }
+        return new Float32Array(8);
+    }
+    failLoad(reason, message) {
+        const failureClass = reason === "missing" ? "missing_weights" : "corrupt_weights";
+        const error = new SlmRuntimeInitError(message, {
+            failureClass,
+            reason,
+        });
+        this.emit({
+            op: "load",
+            outcome: "init_error",
+            failureClass,
+            obligationId: EDGE_SLM_LOAD_OBLIGATION,
+            reason,
+        });
+        return error;
+    }
+    emit(partial) {
+        const event = {
+            event: "edge_agent.slm_runtime",
+            modelId: this.card.modelId,
+            ...partial,
+        };
+        const sid = this.options.subjectId?.trim();
+        const did = this.options.deviceId?.trim();
+        if (sid)
+            event.subjectId = sid;
+        if (did)
+            event.deviceId = did;
+        this.options.onTelemetry?.(event);
+    }
+}
+/**
+ * Adapter for any localhost OpenAI-compatible endpoint (Ollama, llamafile,
+ * llama.cpp server). This is the reference adapter used by the Playground and
+ * by desktop deployments; mobile targets ship their own native adapters.
+ */
+export class OpenAiCompatibleSlmRuntime {
+    card;
+    baseUrl;
+    constructor(card, baseUrl = "http://127.0.0.1:11434/v1") {
+        this.card = card;
+        this.baseUrl = baseUrl;
+    }
+    async load() {
+        // Warm the model by issuing a 1-token generation; Ollama-style servers
+        // load weights lazily on first request.
+        await this.generate({ prompt: " ", maxTokens: 1, temperature: 0, deadlineMs: 120_000 });
+    }
+    async unload() {
+        // OpenAI-compatible servers manage their own eviction; nothing to do.
+    }
+    async generate(params) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), params.deadlineMs);
+        const startedAt = performance.now();
+        try {
+            const res = await fetch(`${this.baseUrl}/completions`, {
+                method: "POST",
+                headers: { "content-type": "application/json" },
+                signal: controller.signal,
+                body: JSON.stringify({
+                    model: this.card.modelId,
+                    prompt: params.prompt,
+                    max_tokens: params.maxTokens,
+                    temperature: params.temperature,
+                    stop: params.stopSequences,
+                }),
+            });
+            if (!res.ok) {
+                throw new Error(`local SLM server returned HTTP ${res.status}`);
+            }
+            const body = (await res.json());
+            const choice = body.choices[0];
+            if (!choice)
+                throw new Error("local SLM server returned no choices");
+            const elapsedS = (performance.now() - startedAt) / 1000;
+            const tokens = body.usage?.completion_tokens ?? Math.ceil(choice.text.length / 4);
+            return {
+                text: choice.text,
+                tokensPerSecond: elapsedS > 0 ? tokens / elapsedS : 0,
+                finishReason: choice.finish_reason === "length" ? "length" : "stop",
+            };
+        }
+        catch (err) {
+            if (controller.signal.aborted) {
+                return { text: "", tokensPerSecond: 0, finishReason: "deadline" };
+            }
+            throw err;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async *generateStream(params) {
+        // Reference implementation degrades to buffered generation; native
+        // adapters override with true SSE/token streaming.
+        const result = await this.generate(params);
+        yield result.text;
+    }
+    async embed(text) {
+        const res = await fetch(`${this.baseUrl}/embeddings`, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify({ model: this.card.modelId, input: text }),
+        });
+        if (!res.ok)
+            throw new Error(`embedding request failed: HTTP ${res.status}`);
+        const body = (await res.json());
+        const vector = body.data[0]?.embedding;
+        if (!vector)
+            throw new Error("embedding response contained no vector");
+        return Float32Array.from(vector);
+    }
+}
+//# sourceMappingURL=slm_runtime.js.map

package/dist/slm_runtime.js.map

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

package/dist/trajectory_capture.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Edge-owned trajectory writer.
+ *
+ * The adapter binds the shared write-ahead queue to exactly one subject and
+ * one sovereign locality. Loop-hook integration is intentionally separate.
+ */
+import type { StorageDriver } from "@moolam/contracts";
+import { type CaptureTrajectoryResult, type TrajectoryCaptureConsent, type TrajectoryWriterEvent } from "@moolam/telemetry";
+import type { HLCTimestamp, TurnTrajectoryV1 } from "@moolam/sync-protocol";
+export type EdgeTrajectoryCaptureWriterOptions = {
+    storage: StorageDriver;
+    subjectId: string;
+    deviceId: string;
+    locality?: TurnTrajectoryV1["locality"];
+    /** Resolve the current active record; null means capture is disabled. */
+    resolveActiveConsentRecordId: () => string | null | undefined;
+    resolveConsent: (consentRecordId: string) => TrajectoryCaptureConsent | null | undefined;
+    capacity?: number;
+    storageTimeoutMs?: number;
+    maxRetries?: number;
+    onTelemetry?: (event: TrajectoryWriterEvent) => void;
+    onHookTelemetry?: (event: EdgeTrajectoryCaptureHookEvent) => void;
+};
+export type EdgeTrajectoryCaptureHookInput = {
+    turnId: string;
+    subjectId: string;
+    deviceId: string;
+    sessionId: string;
+    capturedAt: HLCTimestamp;
+    utterance: string;
+    reply: string;
+    modelId: string;
+    declined: boolean;
+};
+export type EdgeTrajectoryCaptureHookEvent = {
+    event: "edge_agent.trajectory_capture";
+    outcome: "scheduled" | "skipped" | "queued" | "rejected";
+    subjectId: string;
+    deviceId: string;
+    turnId: string;
+    failureClass?: "consent_missing" | "consent_resolve_failed" | "cross_subject" | "cross_device" | "content_too_large" | "hash_failed" | string;
+};
+export type ScheduleTrajectoryCaptureResult = {
+    scheduled: true;
+    subjectId: string;
+    turnId: string;
+} | {
+    scheduled: false;
+    subjectId: string;
+    turnId: string;
+    failureClass: string;
+};
+/**
+ * Subject-scoped SQLite trajectory persistence for an edge installation.
+ *
+ * `captureTrajectory` is synchronous: it only admits to the bounded queue.
+ * Durable write-ahead and final inserts run in the background.
+ */
+export declare class EdgeTrajectoryCaptureWriter {
+    private readonly queue;
+    private readonly subjectId;
+    private readonly deviceId;
+    private readonly locality;
+    private readonly resolveActiveConsentRecordId;
+    private readonly onHookTelemetry;
+    private readonly pendingBuilds;
+    constructor(options: EdgeTrajectoryCaptureWriterOptions);
+    initialize(): Promise<void>;
+    captureTrajectory(input: unknown): CaptureTrajectoryResult;
+    /**
+     * Completion hook invoked only after CognitiveCore's reflect stage resolves.
+     *
+     * Consent is resolved before hashing. Hashing and queue persistence continue
+     * asynchronously, so the completed turn never awaits trajectory I/O.
+     */
+    captureAfterReflect(input: EdgeTrajectoryCaptureHookInput): ScheduleTrajectoryCaptureResult;
+    flush(timeoutMs?: number): Promise<boolean>;
+    get queueDepth(): number;
+    get droppedCount(): number;
+    private rejectHook;
+    private emitHook;
+}
+//# sourceMappingURL=trajectory_capture.d.ts.map

package/dist/trajectory_capture.d.ts.map

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

package/dist/trajectory_capture.js

@@ -0,0 +1,193 @@
+/**
+ * Edge-owned trajectory writer.
+ *
+ * The adapter binds the shared write-ahead queue to exactly one subject and
+ * one sovereign locality. Loop-hook integration is intentionally separate.
+ */
+import { TrajectoryWriteAheadQueue, } from "@moolam/telemetry";
+const TRAJECTORY_CONTENT_HASH_MAX_BYTES = 64_000;
+/**
+ * Subject-scoped SQLite trajectory persistence for an edge installation.
+ *
+ * `captureTrajectory` is synchronous: it only admits to the bounded queue.
+ * Durable write-ahead and final inserts run in the background.
+ */
+export class EdgeTrajectoryCaptureWriter {
+    queue;
+    subjectId;
+    deviceId;
+    locality;
+    resolveActiveConsentRecordId;
+    onHookTelemetry;
+    pendingBuilds = new Set();
+    constructor(options) {
+        this.subjectId = options.subjectId.trim();
+        this.deviceId = options.deviceId.trim();
+        this.locality = options.locality ?? "on-device";
+        if (!this.deviceId) {
+            throw new Error("edge trajectory writer deviceId is required");
+        }
+        this.resolveActiveConsentRecordId = options.resolveActiveConsentRecordId;
+        this.onHookTelemetry = options.onHookTelemetry;
+        this.queue = new TrajectoryWriteAheadQueue({
+            driver: options.storage,
+            subjectId: this.subjectId,
+            locality: this.locality,
+            resolveConsent: options.resolveConsent,
+            ...(options.capacity === undefined ? {} : { capacity: options.capacity }),
+            ...(options.storageTimeoutMs === undefined
+                ? {}
+                : { storageTimeoutMs: options.storageTimeoutMs }),
+            ...(options.maxRetries === undefined
+                ? {}
+                : { maxRetries: options.maxRetries }),
+            ...(options.onTelemetry === undefined
+                ? {}
+                : { onTelemetry: options.onTelemetry }),
+        });
+    }
+    async initialize() {
+        await this.queue.initialize();
+    }
+    captureTrajectory(input) {
+        return this.queue.captureTrajectory(input);
+    }
+    /**
+     * Completion hook invoked only after CognitiveCore's reflect stage resolves.
+     *
+     * Consent is resolved before hashing. Hashing and queue persistence continue
+     * asynchronously, so the completed turn never awaits trajectory I/O.
+     */
+    captureAfterReflect(input) {
+        if (input.subjectId !== this.subjectId) {
+            return this.rejectHook(input, "cross_subject");
+        }
+        if (input.deviceId !== this.deviceId) {
+            return this.rejectHook(input, "cross_device");
+        }
+        let consentRecordId;
+        try {
+            consentRecordId = this.resolveActiveConsentRecordId()?.trim() ?? "";
+        }
+        catch {
+            return this.rejectHook(input, "consent_resolve_failed");
+        }
+        if (!consentRecordId) {
+            this.emitHook(input, "skipped", "consent_missing");
+            return {
+                scheduled: false,
+                subjectId: input.subjectId,
+                turnId: input.turnId,
+                failureClass: "consent_missing",
+            };
+        }
+        const promptBytes = new TextEncoder().encode(input.utterance);
+        const responseBytes = new TextEncoder().encode(input.reply);
+        if (promptBytes.byteLength > TRAJECTORY_CONTENT_HASH_MAX_BYTES ||
+            responseBytes.byteLength > TRAJECTORY_CONTENT_HASH_MAX_BYTES) {
+            return this.rejectHook(input, "content_too_large");
+        }
+        const build = Promise.all([
+            sha256Hex(promptBytes),
+            sha256Hex(responseBytes),
+        ])
+            .then(([promptHash, responseHash]) => {
+            const record = {
+                trajectoryFormatVersion: "trajectory.v1",
+                turnId: input.turnId,
+                subjectId: input.subjectId,
+                deviceId: input.deviceId,
+                sessionId: input.sessionId,
+                capturedAt: input.capturedAt,
+                locality: this.locality,
+                consentRecordId,
+                stages: [
+                    { stage: "perceive", status: "ok", chunkIndex: 0 },
+                    { stage: "reason", status: "ok", chunkIndex: 0 },
+                    {
+                        stage: "act",
+                        status: input.declined ? "skipped" : "ok",
+                        chunkIndex: 0,
+                    },
+                ],
+                toolCalls: [],
+                outcomes: {
+                    status: "completed",
+                    terminalStage: input.declined ? "reason" : "act",
+                },
+                modelId: input.modelId,
+                promptHash,
+                responseHash,
+                promptByteLength: promptBytes.byteLength,
+                responseByteLength: responseBytes.byteLength,
+            };
+            const result = this.queue.captureTrajectory(record);
+            this.emitHook(input, result.queued ? "queued" : "rejected", result.queued ? undefined : result.failureClass);
+        })
+            .catch(() => {
+            this.emitHook(input, "rejected", "hash_failed");
+        })
+            .finally(() => {
+            this.pendingBuilds.delete(build);
+        });
+        this.pendingBuilds.add(build);
+        this.emitHook(input, "scheduled");
+        return {
+            scheduled: true,
+            subjectId: input.subjectId,
+            turnId: input.turnId,
+        };
+    }
+    async flush(timeoutMs) {
+        await Promise.allSettled([...this.pendingBuilds]);
+        return timeoutMs === undefined
+            ? await this.queue.flush()
+            : await this.queue.flush(timeoutMs);
+    }
+    get queueDepth() {
+        return this.queue.queueDepth;
+    }
+    get droppedCount() {
+        return this.queue.droppedCount;
+    }
+    rejectHook(input, failureClass) {
+        this.emitHook(input, "rejected", failureClass);
+        return {
+            scheduled: false,
+            subjectId: input.subjectId,
+            turnId: input.turnId,
+            failureClass,
+        };
+    }
+    emitHook(input, outcome, failureClass) {
+        if (!this.onHookTelemetry)
+            return;
+        const event = {
+            event: "edge_agent.trajectory_capture",
+            outcome,
+            subjectId: input.subjectId,
+            deviceId: input.deviceId,
+            turnId: input.turnId,
+            ...(failureClass === undefined ? {} : { failureClass }),
+        };
+        try {
+            this.onHookTelemetry(event);
+        }
+        catch (error) {
+            console.error(JSON.stringify({
+                event: "edge_agent.trajectory_capture.observer",
+                outcome: "rejected",
+                subjectId: input.subjectId,
+                deviceId: input.deviceId,
+                failureClass: error instanceof Error ? error.name.slice(0, 64) : "observer_failed",
+            }));
+        }
+    }
+}
+async function sha256Hex(bytes) {
+    const digest = await crypto.subtle.digest("SHA-256", Uint8Array.from(bytes).buffer);
+    return `sha256:${[...new Uint8Array(digest)]
+        .map((byte) => byte.toString(16).padStart(2, "0"))
+        .join("")}`;
+}
+//# sourceMappingURL=trajectory_capture.js.map

package/dist/trajectory_capture.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@moolam/edge-agent",
+  "version": "1.0.0",
+  "description": "The Edge Harness. Offline-first autonomous agent runtime for local SLMs (Phi-3, Gemma, quantized GGUF/ONNX) with durable friction telemetry and on-device vector memory.",
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/moolamai/sutra/tree/main/packages/edge-agent#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/moolamai/sutra.git",
+    "directory": "packages/edge-agent"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@moolam/cognitive-core": "1.0.0",
+    "@moolam/contracts": "1.0.0",
+    "@moolam/observability": "1.0.0",
+    "@moolam/runtime": "1.0.0",
+    "@moolam/sync-protocol": "1.0.0",
+    "@moolam/telemetry": "1.0.0"
+  },
+  "devDependencies": {
+    "@opentelemetry/sdk-trace-base": "2.0.1",
+    "@types/node": "^22.20.0",
+    "typescript": "^5.8.0",
+    "@moolam/contract-conformance": "1.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "pnpm run build && node --test tests/chat_prompt_assembly.test.mjs tests/slm_model_adapter.test.mjs tests/slm_runtime_weights.test.mjs tests/model_adapter_conformance.test.mjs tests/local_vector_memory.test.mjs tests/memory_decay_pinning.test.mjs tests/edge_cognitive_bindings.test.mjs tests/edge_agent_event_bus.test.mjs tests/edge_agent_turn_completed.test.mjs tests/edge_agent_sync_outcome.test.mjs tests/edge_agent_unified_turn.test.mjs tests/trajectory_capture_hook.test.mjs tests/trajectory_capture_load.test.mjs tests/offline_edge_regression.test.mjs tests/offline_horizon.test.mjs tests/coldstart.test.mjs tests/coldstart_parity.test.mjs",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\""
+  }
+}