@nookplot/runtime 0.5.137 → 0.5.139

package/dist/presetLoader.d.ts

@@ -0,0 +1,130 @@
+/**
+ * PresetLoader — loads forge preset data into agent memory at boot.
+ *
+ * Reads the preset section of nookplot.yaml, fetches data per source via
+ * the gateway's forge data endpoint, runs content scanning, and ingests
+ * items as preset-tagged memories. Supports layered ingestion: RAG when
+ * available, memory.import() fallback.
+ *
+ * Features:
+ * - Content scanning (sanitizeForPrompt) on every item
+ * - Idempotent loading via .preset-loaded.json manifest
+ * - Configurable failure policy (abort / continue / retry)
+ * - Boot progress events via EventEmitter
+ * - Self-awareness memory generation
+ *
+ * @module presetLoader
+ */
+import { EventEmitter } from "node:events";
+import type { NookplotRuntime } from "./index.js";
+export interface PresetConfig {
+    id: string;
+    version?: number;
+    trustLevel?: "verified" | "scanned" | "raw";
+    failurePolicy?: "abort" | "continue";
+    maxCostNook?: number;
+    sources?: Array<{
+        type: string;
+        label?: string;
+        config: Record<string, unknown>;
+    }>;
+}
+export interface PresetLoadResult {
+    sources: Array<{
+        type: string;
+        label: string;
+        itemsLoaded: number;
+        itemsBlocked: number;
+        itemsSkipped: number;
+        method: "memory" | "rag" | "prompt";
+        status: "loaded" | "partial" | "failed";
+        error?: string;
+        costNook: number;
+    }>;
+    totalItems: number;
+    totalBlocked: number;
+    totalCostNook: number;
+    ragAvailable: boolean;
+    presetVersion: number;
+    loadedAt: string;
+}
+export type PresetLoadEvent = {
+    phase: "estimating";
+    message: string;
+} | {
+    phase: "fetching";
+    source: string;
+    progress: string;
+} | {
+    phase: "scanning";
+    source: string;
+    blocked: number;
+} | {
+    phase: "ingesting";
+    source: string;
+    method: "memory" | "rag";
+} | {
+    phase: "complete";
+    result: PresetLoadResult;
+} | {
+    phase: "error";
+    source: string;
+    error: string;
+};
+export declare class PresetLoader extends EventEmitter {
+    private runtime;
+    private configPath;
+    private loading;
+    constructor(runtime: NookplotRuntime, configPath?: string);
+    /**
+     * Build x-preset-hmac header so the gateway trusts isPreset/presetId fields.
+     * HMAC = SHA-256(apiKey, "preset-ingest:" + agent_address).
+     */
+    private presetIngestHeaders;
+    /**
+     * Load all preset data sources. Called once at agent boot.
+     * Concurrent calls are coalesced — only the first triggers a fetch,
+     * subsequent callers await the same promise (prevents double-pay).
+     */
+    load(): Promise<PresetLoadResult>;
+    private _doLoad;
+    /**
+     * Check if preset data was already loaded (idempotent reboot check).
+     */
+    isLoaded(): Promise<boolean>;
+    /**
+     * Map preset source type to knowledge graph knowledge_type.
+     */
+    private mapSourceToKnowledgeType;
+    /**
+     * Map preset source type to knowledge graph source_type.
+     */
+    private mapSourceToKGSourceType;
+    /**
+     * Ingest a KnowledgeAggregateV1 into the knowledge graph as structured items.
+     * Same decomposition as ingestAggregate but targets the KG endpoint.
+     */
+    private ingestAggregateToKG;
+    /**
+     * Ingest a KnowledgeAggregateV1 as structured memories.
+     * Uses 5-7x fewer memory slots than equivalent raw traces:
+     * - Synthesis → semantic memory (importance 0.9)
+     * - Each keyInsight → procedural memory (confidence-weighted)
+     * - Each reasoning pattern → procedural memory
+     * - Contradictions → self_model memory
+     *
+     * Returns the number of memories stored.
+     */
+    private ingestAggregate;
+    private readConfig;
+    private readManifest;
+    private writeManifest;
+    /**
+     * Lightweight client-side severity assessment.
+     * Full ContentScanner runs server-side; this is a first pass.
+     */
+    private assessSeverity;
+    private emptyResult;
+    private manifestToResult;
+}
+//# sourceMappingURL=presetLoader.d.ts.map

package/dist/presetLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presetLoader.d.ts","sourceRoot":"","sources":["../src/presetLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAKlD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,KAAK,CAAC;IAC5C,aAAa,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAC;QACpC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;QACxC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,KAAK,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,QAAQ,GAAG,KAAK,CAAA;CAAE,GAChE;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,GAC/C;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AActD,qBAAa,YAAa,SAAQ,YAAY;IAC5C,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAA0C;gBAE7C,OAAO,EAAE,eAAe,EAAE,UAAU,SAAoB;IAMpE;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAQ3B;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,gBAAgB,CAAC;YAUzB,OAAO;IAiVrB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAWlC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAWhC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAW/B;;;OAGG;YACW,mBAAmB;IAwIjC;;;;;;;;;OASG;YACW,eAAe;YAgHf,UAAU;YAYV,YAAY;YASZ,aAAa;IAQ3B;;;OAGG;IACH,OAAO,CAAC,cAAc;IAoBtB,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,gBAAgB;CAWzB"}