@nookplot/runtime 0.5.140 → 0.5.141

package/dist/goal/types.d.ts

@@ -1,98 +0,0 @@
-/**
- * Goal loop types — shared interfaces for the L3 autonomous goal execution loop.
- *
- * @module goal/types
- */
-import type { NookplotRuntime } from "../index.js";
-/**
- * One action the LLM can return each turn of the goal loop.
- * Parsed from the model's JSON response.
- */
-export type GoalAction = {
-    type: "action";
-    actionName: string;
-    actionParams: Record<string, unknown>;
-    description: string;
-} | {
-    type: "complete";
-    title: string;
-    body: string;
-    domain: string;
-    description: string;
-} | {
-    type: "noop";
-    description: string;
-} | {
-    type: "needs_capability";
-    description: string;
-    suggestedPreset?: string;
-};
-/**
- * Terminal state of a GoalLoop.run() invocation. Always one of the four
- * outcomes — the loop never throws for normal termination conditions.
- */
-export type GoalResult = {
-    outcome: "complete";
-    artifact: {
-        title: string;
-        body: string;
-        domain: string;
-    };
-    stepsExecuted: number;
-    spentNook: bigint;
-} | {
-    outcome: "blocked_budget";
-    spentNook: bigint;
-} | {
-    outcome: "blocked_stuck";
-    stuckReason: string;
-    spentNook: bigint;
-} | {
-    outcome: "blocked_capability";
-    capabilityNeeded: string;
-    suggestedPreset?: string;
-    spentNook: bigint;
-};
-/**
- * Configuration for a single run of the GoalLoop.
- */
-export interface GoalLoopOptions {
-    runtime: NookplotRuntime;
-    goal: string;
-    /** Soft cap — loop continues past this but emits a warning. */
-    budgetNook: bigint;
-    parentSwarmId?: string | null;
-    /** Hard stop on step count. Default 20. */
-    maxSteps?: number;
-    /** Hard stop on consecutive no-op responses. Default 3. */
-    maxConsecutiveNoops?: number;
-    /** Hard stop on consecutive identical step descriptions. Default 3. */
-    maxReformulations?: number;
-    /** Optional verbose logging. */
-    verbose?: boolean;
-    /**
-     * Optional LLM caller — defaults to runtime.economy.inference or a runtime
-     * provided by the consumer. The caller is abstracted because different
-     * environments wire inference differently (platform / BYOK / Ollama).
-     */
-    inferenceCall?: (input: {
-        systemPrompt: string;
-        userPrompt: string;
-        maxTokens: number;
-        temperature: number;
-    }) => Promise<{
-        content: string;
-        costNook?: number;
-    }>;
-}
-/**
- * Result of executing a single step within the goal loop.
- * costNook is optional because many actions are free (off-chain tools).
- */
-export interface StepExecutionResult {
-    ok: boolean;
-    output: string;
-    costNook: number;
-    error?: string;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/goal/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/goal/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;GAGG;AACH,MAAM,MAAM,UAAU,GAClB;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,IAAI,EAAE,kBAAkB,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEN;;;GAGG;AACH,MAAM,MAAM,UAAU,GAClB;IACE,OAAO,EAAE,UAAU,CAAC;IACpB,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1D,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,OAAO,EAAE,gBAAgB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,OAAO,EAAE,eAAe,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,OAAO,EAAE,oBAAoB,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEN;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,eAAe,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,uEAAuE;IACvE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gCAAgC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;KACrB,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvD;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/goal/types.js

@@ -1,7 +0,0 @@
-/**
- * Goal loop types — shared interfaces for the L3 autonomous goal execution loop.
- *
- * @module goal/types
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/goal/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/goal/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/loadProfile.d.ts

@@ -1,100 +0,0 @@
-/**
- * Profile-aware credential loading for @nookplot/runtime.
- *
- * The SDK normally takes `{ apiKey, gatewayUrl }` at instantiation —
- * developers pass keys directly. This helper is for developers who want
- * the SDK to read from `~/.nookplot/` like @nookplot/cli and @nookplot/mcp
- * do, so a user running multiple forged agents can point the SDK at
- * whichever scope is active in their shell.
- *
- * Reads from the same files the rest of the Nookplot stack uses:
- *   ~/.nookplot/credentials.json              ← creator API key (shared)
- *   ~/.nookplot/profiles/<name>/profile.json  ← per-agent scope
- *   ~/.nookplot/active-profile                ← sticky default (CLI-written)
- *
- * Resolution order:
- *   1. Explicit `name` argument to loadProfile()
- *   2. NOOKPLOT_PROFILE env var
- *   3. Sticky default from ~/.nookplot/active-profile
- *   4. null (load default creds only, no scope)
- *
- * @module loadProfile
- *
- * @example Basic usage — pick up whatever profile is active
- * ```ts
- * import { NookplotRuntime } from "@nookplot/runtime";
- * import { loadProfile } from "@nookplot/runtime/loadProfile";
- *
- * const creds = loadProfile();   // respects NOOKPLOT_PROFILE env + sticky default
- * if (!creds) throw new Error("No credentials — run `nookplot register` first");
- *
- * const runtime = new NookplotRuntime({
- *   apiKey: creds.apiKey,
- *   gatewayUrl: creds.gatewayUrl,
- * });
- * ```
- *
- * @example Explicit profile override
- * ```ts
- * const creds = loadProfile("jeffs-researcher");
- * ```
- *
- * @example Multi-agent — run two SDK instances in parallel
- * ```ts
- * const researcherCreds = loadProfile("jeffs-researcher");
- * const writerCreds = loadProfile("jeffs-writer");
- *
- * const researcher = new NookplotRuntime({ apiKey: researcherCreds!.apiKey, ... });
- * const writer = new NookplotRuntime({ apiKey: writerCreds!.apiKey, ... });
- * // Both clients share the creator's API key but scope to different forged agents.
- * ```
- */
-export interface LoadedProfile {
-    /** Creator's API key (shared across all forged agents owned by this creator). */
-    apiKey: string;
-    /** Creator's wallet address. */
-    address: string;
-    /** Creator's private key — only read if developer passes { requirePrivateKey }. */
-    privateKey: string;
-    /** Gateway base URL, honoring NOOKPLOT_GATEWAY_URL env if set. */
-    gatewayUrl: string;
-    /** Present when a profile was active — the forged agent's address to scope to. */
-    scopedAgentAddress?: string;
-    /** Present when a profile was active — the profile's name (for logging). */
-    profileName?: string;
-    /** Display name of the creator (not the scoped forged agent). */
-    displayName?: string;
-}
-/**
- * Resolve the active profile name in priority order.
- * Exported for testing + for developers who want to see which profile
- * WOULD be used without actually loading credentials.
- */
-export declare function resolveActiveProfileName(explicitName?: string): string | null;
-/**
- * Load credentials, optionally merging a named profile's scope on top.
- *
- * Returns null if no `credentials.json` exists — the developer should
- * surface a clear "run `nookplot register` first" message in that case.
- *
- * Does not throw on invalid profiles — if the named profile doesn't
- * exist or is malformed, falls back to plain creator-direct credentials
- * (matches @nookplot/mcp's fail-open behavior so stale env vars don't
- * break unrelated commands).
- */
-export declare function loadProfile(name?: string): LoadedProfile | null;
-/**
- * List all profiles registered on the local machine. Each entry includes
- * the profile name + its metadata. Useful for SDK consumers who want to
- * enumerate the user's forged agents programmatically.
- *
- * Returns an empty array if ~/.nookplot/profiles doesn't exist. Never
- * throws — invalid profiles are silently skipped.
- */
-export declare function listProfiles(): Array<{
-    name: string;
-    scopedAgentAddress: string;
-    displayName?: string;
-    hermesProfile?: string;
-}>;
-//# sourceMappingURL=loadProfile.d.ts.map

package/dist/loadProfile.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"loadProfile.d.ts","sourceRoot":"","sources":["../src/loadProfile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAMH,MAAM,WAAW,aAAa;IAC5B,iFAAiF;IACjF,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAsBD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAa7E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAwE/D;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA8BhI"}

package/dist/loadProfile.js

@@ -1,221 +0,0 @@
-/**
- * Profile-aware credential loading for @nookplot/runtime.
- *
- * The SDK normally takes `{ apiKey, gatewayUrl }` at instantiation —
- * developers pass keys directly. This helper is for developers who want
- * the SDK to read from `~/.nookplot/` like @nookplot/cli and @nookplot/mcp
- * do, so a user running multiple forged agents can point the SDK at
- * whichever scope is active in their shell.
- *
- * Reads from the same files the rest of the Nookplot stack uses:
- *   ~/.nookplot/credentials.json              ← creator API key (shared)
- *   ~/.nookplot/profiles/<name>/profile.json  ← per-agent scope
- *   ~/.nookplot/active-profile                ← sticky default (CLI-written)
- *
- * Resolution order:
- *   1. Explicit `name` argument to loadProfile()
- *   2. NOOKPLOT_PROFILE env var
- *   3. Sticky default from ~/.nookplot/active-profile
- *   4. null (load default creds only, no scope)
- *
- * @module loadProfile
- *
- * @example Basic usage — pick up whatever profile is active
- * ```ts
- * import { NookplotRuntime } from "@nookplot/runtime";
- * import { loadProfile } from "@nookplot/runtime/loadProfile";
- *
- * const creds = loadProfile();   // respects NOOKPLOT_PROFILE env + sticky default
- * if (!creds) throw new Error("No credentials — run `nookplot register` first");
- *
- * const runtime = new NookplotRuntime({
- *   apiKey: creds.apiKey,
- *   gatewayUrl: creds.gatewayUrl,
- * });
- * ```
- *
- * @example Explicit profile override
- * ```ts
- * const creds = loadProfile("jeffs-researcher");
- * ```
- *
- * @example Multi-agent — run two SDK instances in parallel
- * ```ts
- * const researcherCreds = loadProfile("jeffs-researcher");
- * const writerCreds = loadProfile("jeffs-writer");
- *
- * const researcher = new NookplotRuntime({ apiKey: researcherCreds!.apiKey, ... });
- * const writer = new NookplotRuntime({ apiKey: writerCreds!.apiKey, ... });
- * // Both clients share the creator's API key but scope to different forged agents.
- * ```
- */
-import { existsSync, readFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { join } from "node:path";
-function nookplotDir() {
-    return join(homedir(), ".nookplot");
-}
-function credentialsPath() {
-    return join(nookplotDir(), "credentials.json");
-}
-function profilePath(name) {
-    return join(nookplotDir(), "profiles", name, "profile.json");
-}
-function activeProfilePath() {
-    return join(nookplotDir(), "active-profile");
-}
-/**
- * Resolve the active profile name in priority order.
- * Exported for testing + for developers who want to see which profile
- * WOULD be used without actually loading credentials.
- */
-export function resolveActiveProfileName(explicitName) {
-    if (explicitName)
-        return explicitName;
-    const env = process.env.NOOKPLOT_PROFILE;
-    if (env)
-        return env;
-    try {
-        if (existsSync(activeProfilePath())) {
-            const content = readFileSync(activeProfilePath(), "utf-8").trim();
-            if (content)
-                return content;
-        }
-    }
-    catch {
-        // Permissions error or disk issue — fall through
-    }
-    return null;
-}
-/**
- * Load credentials, optionally merging a named profile's scope on top.
- *
- * Returns null if no `credentials.json` exists — the developer should
- * surface a clear "run `nookplot register` first" message in that case.
- *
- * Does not throw on invalid profiles — if the named profile doesn't
- * exist or is malformed, falls back to plain creator-direct credentials
- * (matches @nookplot/mcp's fail-open behavior so stale env vars don't
- * break unrelated commands).
- */
-export function loadProfile(name) {
-    // 1. Load base credentials — the shared creator API key.
-    if (!existsSync(credentialsPath()))
-        return null;
-    let creds;
-    try {
-        creds = JSON.parse(readFileSync(credentialsPath(), "utf-8"));
-    }
-    catch {
-        return null;
-    }
-    if (!creds.apiKey || !creds.address || !creds.privateKey || !creds.gatewayUrl) {
-        return null;
-    }
-    // 2. Honor NOOKPLOT_GATEWAY_URL env if set (matches SDK + MCP convention).
-    const gatewayUrl = process.env.NOOKPLOT_GATEWAY_URL ?? creds.gatewayUrl;
-    // 3. Resolve profile (if any) and read its scope.
-    const profileName = resolveActiveProfileName(name);
-    if (!profileName) {
-        return {
-            apiKey: creds.apiKey,
-            address: creds.address,
-            privateKey: creds.privateKey,
-            gatewayUrl,
-            displayName: creds.displayName,
-        };
-    }
-    const pPath = profilePath(profileName);
-    if (!existsSync(pPath)) {
-        // Stale profile reference — fall back to creator-direct. Matches
-        // @nookplot/mcp's fail-open pattern.
-        return {
-            apiKey: creds.apiKey,
-            address: creds.address,
-            privateKey: creds.privateKey,
-            gatewayUrl,
-            displayName: creds.displayName,
-        };
-    }
-    try {
-        const p = JSON.parse(readFileSync(pPath, "utf-8"));
-        if (typeof p.scopedAgentAddress !== "string" || p.scopedAgentAddress.length === 0) {
-            // Malformed profile — fall back.
-            return {
-                apiKey: creds.apiKey,
-                address: creds.address,
-                privateKey: creds.privateKey,
-                gatewayUrl,
-                displayName: creds.displayName,
-            };
-        }
-        return {
-            apiKey: creds.apiKey,
-            address: creds.address,
-            privateKey: creds.privateKey,
-            gatewayUrl,
-            scopedAgentAddress: p.scopedAgentAddress,
-            profileName,
-            displayName: creds.displayName,
-        };
-    }
-    catch {
-        // JSON parse error on profile — fall back to creator-direct.
-        return {
-            apiKey: creds.apiKey,
-            address: creds.address,
-            privateKey: creds.privateKey,
-            gatewayUrl,
-            displayName: creds.displayName,
-        };
-    }
-}
-/**
- * List all profiles registered on the local machine. Each entry includes
- * the profile name + its metadata. Useful for SDK consumers who want to
- * enumerate the user's forged agents programmatically.
- *
- * Returns an empty array if ~/.nookplot/profiles doesn't exist. Never
- * throws — invalid profiles are silently skipped.
- */
-export function listProfiles() {
-    const dir = join(nookplotDir(), "profiles");
-    if (!existsSync(dir))
-        return [];
-    const out = [];
-    try {
-        const { readdirSync, statSync } = require("node:fs");
-        for (const name of readdirSync(dir).sort()) {
-            const full = join(dir, name);
-            try {
-                if (!statSync(full).isDirectory())
-                    continue;
-            }
-            catch {
-                continue;
-            }
-            const pPath = join(full, "profile.json");
-            if (!existsSync(pPath))
-                continue;
-            try {
-                const p = JSON.parse(readFileSync(pPath, "utf-8"));
-                if (typeof p.scopedAgentAddress !== "string")
-                    continue;
-                out.push({
-                    name,
-                    scopedAgentAddress: p.scopedAgentAddress,
-                    displayName: p.displayName,
-                    hermesProfile: p.hermesProfile,
-                });
-            }
-            catch {
-                // Skip invalid profiles
-            }
-        }
-    }
-    catch {
-        // Missing dir or perms — return empty
-    }
-    return out;
-}
-//# sourceMappingURL=loadProfile.js.map

package/dist/loadProfile.js.map

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

package/dist/presetLoader.d.ts

@@ -1,130 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}