@nookplot/runtime 0.5.142 → 0.5.144

package/dist/packLoader.js

@@ -0,0 +1,236 @@
+/**
+ * PackLoader — loads a Pack at agent boot (ROADMAP_external-mcp-connectors
+ * Phase 3; the minimal pack-load slice that ROADMAP_pack-primitive inherits).
+ *
+ * On load it:
+ *  1. Parses + validates the pack (from options.pack or a pack YAML file).
+ *  2. Pre-flights every declared connection — which external services are
+ *     already connected (agent credential / OAuth / workspace connection) —
+ *     and produces actionable hints for the missing ones.
+ *  3. Mounts the declared MCP servers via the Phase-1/2 bridge
+ *     (POST /v1/agents/me/mcp/servers is an upsert, so re-loading is
+ *     idempotent). Servers whose connection is unsatisfied are skipped.
+ *  4. Reports connector binding status (Discord bindings are created in the
+ *     platform install flow — a pack declares the capability; the loader
+ *     reports bound/unbound).
+ *  5. Delegates the embedded `preset` block verbatim to PresetLoader.
+ *
+ * The loader mounts and reports; it does NOT gate. Pass the same pack to
+ * `new AutonomousAgent(runtime, { pack })` for prompt + dispatch gating.
+ *
+ * @module packLoader
+ */
+import { readFile } from "node:fs/promises";
+import { PresetLoader } from "./presetLoader.js";
+import { CONNECTOR_PLATFORMS, parsePack, resolvePackActions } from "./pack.js";
+// ── Registry fetch (shared by PackLoader + the CLI loops) ─────
+/**
+ * Fetch a pack from the gateway registry by `"name"` or `"name@1.2.3"` via
+ * POST /v1/agents/me/pack/load — which also records it as the calling
+ * agent's active pack. Registry content is untrusted: it is re-validated
+ * with parsePack before returning; invalid content throws.
+ */
+export async function fetchRegistryPack(runtime, ref) {
+    const at = ref.indexOf("@");
+    const name = at === -1 ? ref : ref.slice(0, at);
+    const version = at === -1 ? undefined : ref.slice(at + 1);
+    const res = await runtime.connection.request("POST", "/v1/agents/me/pack/load", {
+        name,
+        ...(version ? { version } : {}),
+    });
+    const result = parsePack(res.pack.content);
+    if (!result.ok || !result.pack) {
+        throw new Error(`Registry pack "${ref}" failed validation:\n  - ${result.errors.join("\n  - ")}`);
+    }
+    return { pack: result.pack, contentHash: res.pack.contentHash };
+}
+// ── PackLoader ────────────────────────────────────────────────
+export class PackLoader {
+    runtime;
+    options;
+    constructor(runtime, options = {}) {
+        this.runtime = runtime;
+        this.options = options;
+    }
+    /** Load the pack: validate → pre-flight → mount → connector status → preset. */
+    async load() {
+        const { pack, source, contentHash } = await this.resolvePack();
+        const connections = await this.checkConnections(pack);
+        const mcpServers = await this.mountServers(pack, connections);
+        const connectors = await this.checkConnectors(pack);
+        let preset;
+        if (pack.preset) {
+            const presetLoader = new PresetLoader(this.runtime, this.options.presetConfigPath ?? "./nookplot.yaml", pack.preset);
+            preset = await presetLoader.load();
+        }
+        return {
+            name: pack.name,
+            version: pack.version,
+            source,
+            ...(contentHash ? { contentHash } : {}),
+            connections,
+            mcpServers,
+            connectors,
+            ...(preset ? { preset } : {}),
+            actions: resolvePackActions(pack),
+            ok: connections.every((c) => c.status === "satisfied") &&
+                mcpServers.every((s) => s.status === "mounted"),
+        };
+    }
+    async resolvePack() {
+        if (this.options.pack)
+            return { pack: this.options.pack, source: "inline" };
+        if (this.options.packRef) {
+            const { pack, contentHash } = await fetchRegistryPack(this.runtime, this.options.packRef);
+            return { pack, source: "registry", contentHash };
+        }
+        const path = this.options.packPath ?? "./pack.yaml";
+        const text = await readFile(path, "utf-8");
+        const result = parsePack(text);
+        if (!result.ok || !result.pack) {
+            throw new Error(`Pack "${path}" is invalid:\n  - ${result.errors.join("\n  - ")}`);
+        }
+        return { pack: result.pack, source: "file" };
+    }
+    // ── Connection pre-flight ───────────────────────────────────
+    async checkConnections(pack) {
+        const declared = pack.connections ?? [];
+        if (declared.length === 0)
+            return [];
+        // One credentials fetch covers every agent-owned connection.
+        let agentServices = null;
+        if (declared.some((c) => c.owner === "agent")) {
+            try {
+                const res = await this.runtime.connection.request("GET", "/v1/agents/me/credentials");
+                agentServices = new Set((res.credentials ?? []).map((c) => c.service));
+            }
+            catch {
+                agentServices = new Set();
+            }
+        }
+        // One workspace-connections fetch covers every workspace-owned connection.
+        let workspaceServices = null;
+        if (declared.some((c) => c.owner === "workspace") && this.options.workspaceId) {
+            try {
+                const res = await this.runtime.connection.request("GET", `/v1/workspaces/${encodeURIComponent(this.options.workspaceId)}/connections`);
+                workspaceServices = new Set((res.connections ?? []).map((c) => c.service));
+            }
+            catch {
+                workspaceServices = new Set();
+            }
+        }
+        const statuses = [];
+        for (const conn of declared) {
+            if (conn.owner === "agent") {
+                if (agentServices?.has(conn.service)) {
+                    statuses.push({ service: conn.service, owner: "agent", status: "satisfied", authType: "bearer_credential" });
+                    continue;
+                }
+                if (await this.oauthConnected(conn.service)) {
+                    statuses.push({ service: conn.service, owner: "agent", status: "satisfied", authType: "oauth" });
+                    continue;
+                }
+                statuses.push({
+                    service: conn.service, owner: "agent", status: "missing",
+                    hint: `Store an API token for "${conn.service}" (tools.storeCredential / POST /v1/agents/me/credentials) or connect it via OAuth (/v1/oauth/${conn.service}/connect).`,
+                });
+            }
+            else {
+                if (!this.options.workspaceId) {
+                    statuses.push({
+                        service: conn.service, owner: "workspace", status: "missing",
+                        hint: `Connection "${conn.service}" is workspace-owned but no workspaceId was provided — set it in PackLoaderOptions (SDK) or the pack block of nookplot.yaml (CLI).`,
+                    });
+                    continue;
+                }
+                if (workspaceServices?.has(conn.service)) {
+                    statuses.push({ service: conn.service, owner: "workspace", status: "satisfied", authType: "workspace" });
+                }
+                else {
+                    statuses.push({
+                        service: conn.service, owner: "workspace", status: "missing",
+                        hint: `Workspace ${this.options.workspaceId} has no "${conn.service}" connection — a workspace admin must add one (POST /v1/workspaces/:id/connections).`,
+                    });
+                }
+            }
+        }
+        return statuses;
+    }
+    async oauthConnected(provider) {
+        try {
+            const res = await this.runtime.connection.request("GET", `/v1/oauth/${encodeURIComponent(provider)}/status`);
+            return res.connected === true;
+        }
+        catch {
+            return false;
+        }
+    }
+    // ── MCP server mounting ─────────────────────────────────────
+    async mountServers(pack, connections) {
+        const byService = new Map(connections.map((c) => [c.service, c]));
+        const statuses = [];
+        for (const server of pack.mcpServers ?? []) {
+            let auth;
+            if (server.connection) {
+                const conn = byService.get(server.connection);
+                if (!conn || conn.status !== "satisfied") {
+                    statuses.push({
+                        name: server.name, url: server.url, status: "skipped",
+                        reason: `connection "${server.connection}" not satisfied${conn?.hint ? ` — ${conn.hint}` : ""}`,
+                    });
+                    continue;
+                }
+                if (conn.authType === "bearer_credential") {
+                    auth = { authType: "bearer_credential", credentialService: conn.service };
+                }
+                else if (conn.authType === "oauth") {
+                    auth = { authType: "oauth", oauthProvider: conn.service };
+                }
+                else {
+                    auth = { authType: "workspace", credentialService: conn.service, workspaceId: this.options.workspaceId };
+                }
+            }
+            try {
+                const mounted = await this.runtime.tools.connectMcpServer(server.url, server.name, auth);
+                statuses.push({ name: server.name, url: server.url, status: "mounted", toolCount: mounted.toolCount });
+            }
+            catch (err) {
+                statuses.push({
+                    name: server.name, url: server.url, status: "failed",
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+        return statuses;
+    }
+    // ── Connector status ────────────────────────────────────────
+    async checkConnectors(pack) {
+        const statuses = [];
+        for (const connector of pack.connectors ?? []) {
+            const { platform, mode } = connector;
+            const descriptor = CONNECTOR_PLATFORMS[platform];
+            if (!descriptor.hasBindings) {
+                // e.g. email — outbound rides the agent's own inbox; nothing to check.
+                statuses.push({ platform, mode, status: "ready", detail: descriptor.readyDetail });
+                continue;
+            }
+            // Every bindings-bearing platform exposes the same contract on the
+            // shared connector core (Phase 4): GET /v1/<platform>/bindings.
+            let active = 0;
+            let detail;
+            try {
+                const res = await this.runtime.connection.request("GET", `/v1/${platform}/bindings`);
+                active = (res.bindings ?? []).filter((b) => b.status === "active").length;
+                detail = active > 0
+                    ? `${active} active binding(s)`
+                    : `no active ${descriptor.label} bindings — bind the agent via the ${descriptor.label} install flow`;
+            }
+            catch (err) {
+                detail = `binding lookup failed: ${err instanceof Error ? err.message : String(err)}`;
+            }
+            statuses.push({ platform, mode, status: active > 0 ? "bound" : "unbound", detail });
+        }
+        return statuses;
+    }
+}
+//# sourceMappingURL=packLoader.js.map

package/dist/packLoader.js.map

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

package/dist/presetLoader.d.ts

@@ -0,0 +1,132 @@
+/**
+ * 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;
+    /** When set, used instead of reading the `preset:` section of the config file (PackLoader delegation). */
+    private presetOverride;
+    constructor(runtime: NookplotRuntime, configPath?: string, presetOverride?: PresetConfig);
+    /**
+     * 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":"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"}