@nookplot/runtime 0.5.88 → 0.5.90

package/dist/lineage.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Lineage manager — spawn tree navigation for forged agents.
+ *
+ * Lets agents discover their parent, children, and siblings
+ * in the on-chain spawn tree (AgentFactory contract).
+ *
+ * @module lineage
+ */
+import type { ConnectionManager } from "./connection.js";
+export interface LineageInfo {
+    /** This agent's address */
+    address: string;
+    /** Parent agent address (null if root deployment, not a spawn) */
+    parentAddress: string | null;
+    /** Direct child agent addresses */
+    childAddresses: string[];
+    /** Whether this agent was spawned (vs. independently deployed) */
+    isSpawn: boolean;
+    /** Generation depth — 0 = root, 1 = direct child, 2 = grandchild, etc. */
+    generation: number;
+}
+export interface SpawnChild {
+    address: string;
+    soulCid: string | null;
+    deploymentId: number | null;
+    bundleName: string | null;
+    createdAt: number;
+}
+export interface SpawnParent {
+    address: string;
+    soulCid: string | null;
+    deploymentId: number | null;
+}
+export declare class LineageManager {
+    private readonly connection;
+    private cachedLineage;
+    constructor(connection: ConnectionManager);
+    /**
+     * Get full lineage info for this agent (parent, children, generation).
+     * Cached after first call — spawn tree is immutable on-chain.
+     */
+    getLineage(): Promise<LineageInfo>;
+    /** Get this agent's parent info, or null if root deployment. */
+    getParent(): Promise<SpawnParent | null>;
+    /** Get this agent's direct children. */
+    getChildren(): Promise<SpawnChild[]>;
+    /** Get siblings (children of this agent's parent, excluding self). */
+    getSiblings(): Promise<SpawnChild[]>;
+    /** Whether this agent was spawned (not root deployed). */
+    isSpawn(): Promise<boolean>;
+    /**
+     * Inherit filtered memories from parent agent.
+     * Only works for spawned agents. No-op for root deployments.
+     * Returns the number of memories inherited.
+     */
+    inheritFromParent(filter?: {
+        types?: string[];
+        tags?: string[];
+        minImportance?: number;
+        maxMemories?: number;
+    }): Promise<{
+        inherited: number;
+        total: number;
+        parentAddress: string | null;
+    }>;
+    /** Clear cached lineage (e.g., if new children were spawned). */
+    clearCache(): void;
+}
+//# sourceMappingURL=lineage.d.ts.map

package/dist/lineage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lineage.d.ts","sourceRoot":"","sources":["../src/lineage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAIzD,MAAM,WAAW,WAAW;IAC1B,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,mCAAmC;IACnC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,kEAAkE;IAClE,OAAO,EAAE,OAAO,CAAC;IACjB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAID,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,aAAa,CAA4B;gBAErC,UAAU,EAAE,iBAAiB;IAIzC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;IAOxC,gEAAgE;IAC1D,SAAS,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAM9C,wCAAwC;IAClC,WAAW,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAS1C,sEAAsE;IAChE,WAAW,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAS1C,0DAA0D;IACpD,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAKjC;;;;OAIG;IACG,iBAAiB,CAAC,MAAM,CAAC,EAAE;QAC/B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAU/E,iEAAiE;IACjE,UAAU,IAAI,IAAI;CAGnB"}

package/dist/lineage.js

@@ -0,0 +1,72 @@
+/**
+ * Lineage manager — spawn tree navigation for forged agents.
+ *
+ * Lets agents discover their parent, children, and siblings
+ * in the on-chain spawn tree (AgentFactory contract).
+ *
+ * @module lineage
+ */
+// ─── Manager ──────────────────────────────────────────────────────────────────
+export class LineageManager {
+    connection;
+    cachedLineage = null;
+    constructor(connection) {
+        this.connection = connection;
+    }
+    /**
+     * Get full lineage info for this agent (parent, children, generation).
+     * Cached after first call — spawn tree is immutable on-chain.
+     */
+    async getLineage() {
+        if (this.cachedLineage)
+            return this.cachedLineage;
+        const result = await this.connection.request("GET", "/v1/forge/lineage/self");
+        this.cachedLineage = result;
+        return result;
+    }
+    /** Get this agent's parent info, or null if root deployment. */
+    async getParent() {
+        const lineage = await this.getLineage();
+        if (!lineage.parentAddress)
+            return null;
+        return this.connection.request("GET", `/v1/forge/parent/${lineage.parentAddress}`);
+    }
+    /** Get this agent's direct children. */
+    async getChildren() {
+        const lineage = await this.getLineage();
+        if (lineage.childAddresses.length === 0)
+            return [];
+        const result = await this.connection.request("GET", `/v1/forge/tree/${lineage.address}`);
+        return result.children ?? [];
+    }
+    /** Get siblings (children of this agent's parent, excluding self). */
+    async getSiblings() {
+        const lineage = await this.getLineage();
+        if (!lineage.parentAddress)
+            return [];
+        const result = await this.connection.request("GET", `/v1/forge/tree/${lineage.parentAddress}`);
+        return (result.children ?? []).filter(c => c.address !== lineage.address);
+    }
+    /** Whether this agent was spawned (not root deployed). */
+    async isSpawn() {
+        const lineage = await this.getLineage();
+        return lineage.isSpawn;
+    }
+    /**
+     * Inherit filtered memories from parent agent.
+     * Only works for spawned agents. No-op for root deployments.
+     * Returns the number of memories inherited.
+     */
+    async inheritFromParent(filter) {
+        const lineage = await this.getLineage();
+        if (!lineage.isSpawn) {
+            return { inherited: 0, total: 0, parentAddress: null };
+        }
+        return this.connection.request("POST", "/v1/forge/inherit", filter ?? {});
+    }
+    /** Clear cached lineage (e.g., if new children were spawned). */
+    clearCache() {
+        this.cachedLineage = null;
+    }
+}
+//# sourceMappingURL=lineage.js.map

package/dist/lineage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lineage.js","sourceRoot":"","sources":["../src/lineage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiCH,iFAAiF;AAEjF,MAAM,OAAO,cAAc;IACR,UAAU,CAAoB;IACvC,aAAa,GAAuB,IAAI,CAAC;IAEjD,YAAY,UAA6B;QACvC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,aAAa;YAAE,OAAO,IAAI,CAAC,aAAa,CAAC;QAClD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAc,KAAK,EAAE,wBAAwB,CAAC,CAAC;QAC3F,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;QAC5B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,gEAAgE;IAChE,KAAK,CAAC,SAAS;QACb,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACxC,IAAI,CAAC,OAAO,CAAC,aAAa;YAAE,OAAO,IAAI,CAAC;QACxC,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAc,KAAK,EAAE,oBAAoB,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAClG,CAAC;IAED,wCAAwC;IACxC,KAAK,CAAC,WAAW;QACf,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACxC,IAAI,OAAO,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACnD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAC1C,KAAK,EAAE,kBAAkB,OAAO,CAAC,OAAO,EAAE,CAC3C,CAAC;QACF,OAAO,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED,sEAAsE;IACtE,KAAK,CAAC,WAAW;QACf,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACxC,IAAI,CAAC,OAAO,CAAC,aAAa;YAAE,OAAO,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAC1C,KAAK,EAAE,kBAAkB,OAAO,CAAC,aAAa,EAAE,CACjD,CAAC;QACF,OAAO,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5E,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,OAAO;QACX,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACxC,OAAO,OAAO,CAAC,OAAO,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,iBAAiB,CAAC,MAKvB;QACC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACxC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACrB,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;QACzD,CAAC;QACD,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAC5B,MAAM,EAAE,mBAAmB,EAAE,MAAM,IAAI,EAAE,CAC1C,CAAC;IACJ,CAAC;IAED,iEAAiE;IACjE,UAAU;QACR,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;IAC5B,CAAC;CACF"}

package/dist/presetLoader.d.ts

@@ -0,0 +1,125 @@
+/**
+ * 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);
+    /**
+     * 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;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,gBAAgB,CAAC;YAUzB,OAAO;IAgVrB;;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;IAuIjC;;;;;;;;;OASG;YACW,eAAe;YAgHf,UAAU;YAYV,YAAY;YASZ,aAAa;IAQ3B;;;OAGG;IACH,OAAO,CAAC,cAAc;IAoBtB,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,gBAAgB;CAWzB"}