@nookplot/runtime 0.5.107 → 0.5.109

package/dist/__tests__/lineage.test.js

@@ -0,0 +1,131 @@
+import { describe, it, expect, vi } from "vitest";
+import { LineageManager } from "../lineage.js";
+function createMockConnection(overrides) {
+    return {
+        request: vi.fn().mockImplementation((_method, path) => {
+            if (path === "/v1/forge/lineage/self") {
+                return overrides?.lineage ?? {
+                    address: "0xchild",
+                    parentAddress: "0xparent",
+                    childAddresses: [],
+                    isSpawn: true,
+                    generation: 1,
+                };
+            }
+            if (path.startsWith("/v1/forge/tree/")) {
+                return overrides?.tree ?? { children: [
+                        { address: "0xchild", soulCid: "QmChild", deploymentId: 42, bundleName: "test-bundle", createdAt: 1000 },
+                        { address: "0xsibling", soulCid: "QmSib", deploymentId: 43, bundleName: "test-bundle", createdAt: 1001 },
+                    ] };
+            }
+            if (path.startsWith("/v1/forge/parent/")) {
+                return overrides?.parent ?? {
+                    address: "0xparent",
+                    soulCid: "QmParent",
+                    deploymentId: 1,
+                };
+            }
+            return {};
+        }),
+    };
+}
+describe("LineageManager", () => {
+    it("getLineage returns spawn info", async () => {
+        const conn = createMockConnection();
+        const mgr = new LineageManager(conn);
+        const lineage = await mgr.getLineage();
+        expect(lineage.isSpawn).toBe(true);
+        expect(lineage.parentAddress).toBe("0xparent");
+        expect(lineage.generation).toBe(1);
+        expect(conn.request).toHaveBeenCalledWith("GET", "/v1/forge/lineage/self");
+    });
+    it("caches lineage after first call", async () => {
+        const conn = createMockConnection();
+        const mgr = new LineageManager(conn);
+        await mgr.getLineage();
+        await mgr.getLineage();
+        // Should only have called the API once
+        const lineageCalls = conn.request.mock.calls.filter((c) => c[1] === "/v1/forge/lineage/self");
+        expect(lineageCalls).toHaveLength(1);
+    });
+    it("clearCache forces re-fetch", async () => {
+        const conn = createMockConnection();
+        const mgr = new LineageManager(conn);
+        await mgr.getLineage();
+        mgr.clearCache();
+        await mgr.getLineage();
+        const lineageCalls = conn.request.mock.calls.filter((c) => c[1] === "/v1/forge/lineage/self");
+        expect(lineageCalls).toHaveLength(2);
+    });
+    it("getParent returns parent info for spawned agent", async () => {
+        const conn = createMockConnection();
+        const mgr = new LineageManager(conn);
+        const parent = await mgr.getParent();
+        expect(parent).not.toBeNull();
+        expect(parent.address).toBe("0xparent");
+    });
+    it("getParent returns null for root deployment", async () => {
+        const conn = createMockConnection({
+            lineage: { address: "0xroot", parentAddress: null, childAddresses: ["0xchild"], isSpawn: false, generation: 0 },
+        });
+        const mgr = new LineageManager(conn);
+        const parent = await mgr.getParent();
+        expect(parent).toBeNull();
+    });
+    it("getSiblings excludes self", async () => {
+        const conn = createMockConnection();
+        const mgr = new LineageManager(conn);
+        const siblings = await mgr.getSiblings();
+        expect(siblings).toHaveLength(1);
+        expect(siblings[0].address).toBe("0xsibling");
+    });
+    it("getSiblings returns empty for root deployment", async () => {
+        const conn = createMockConnection({
+            lineage: { address: "0xroot", parentAddress: null, childAddresses: [], isSpawn: false, generation: 0 },
+        });
+        const mgr = new LineageManager(conn);
+        const siblings = await mgr.getSiblings();
+        expect(siblings).toHaveLength(0);
+    });
+    it("getChildren returns child list", async () => {
+        const conn = createMockConnection({
+            lineage: { address: "0xparent", parentAddress: null, childAddresses: ["0xchild", "0xsibling"], isSpawn: false, generation: 0 },
+        });
+        const mgr = new LineageManager(conn);
+        const children = await mgr.getChildren();
+        expect(children).toHaveLength(2);
+    });
+    it("isSpawn returns boolean", async () => {
+        const conn = createMockConnection();
+        const mgr = new LineageManager(conn);
+        expect(await mgr.isSpawn()).toBe(true);
+    });
+    describe("inheritFromParent", () => {
+        it("inherits memories for spawned agent", async () => {
+            const conn = createMockConnection();
+            conn.request.mockImplementation((_method, path) => {
+                if (path === "/v1/forge/lineage/self") {
+                    return { address: "0xchild", parentAddress: "0xparent", childAddresses: [], isSpawn: true, generation: 1 };
+                }
+                if (path === "/v1/forge/inherit") {
+                    return { inherited: 47, total: 50, parentAddress: "0xparent" };
+                }
+                return {};
+            });
+            const mgr = new LineageManager(conn);
+            const result = await mgr.inheritFromParent({ types: ["semantic"], minImportance: 0.7 });
+            expect(result.inherited).toBe(47);
+            expect(result.parentAddress).toBe("0xparent");
+        });
+        it("returns zero for root deployment", async () => {
+            const conn = createMockConnection({
+                lineage: { address: "0xroot", parentAddress: null, childAddresses: [], isSpawn: false, generation: 0 },
+            });
+            const mgr = new LineageManager(conn);
+            const result = await mgr.inheritFromParent();
+            expect(result.inherited).toBe(0);
+            expect(result.parentAddress).toBeNull();
+        });
+    });
+});
+//# sourceMappingURL=lineage.test.js.map

package/dist/__tests__/lineage.test.js.map

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

package/dist/__tests__/loadProfile.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Tests for the SDK's loadProfile helper.
+ *
+ * Parallel to @nookplot/mcp's auth-profile.test.ts and @nookplot/cli's
+ * profile.test.ts — same resolution order, same backward-compat guarantees.
+ */
+export {};
+//# sourceMappingURL=loadProfile.test.d.ts.map

package/dist/__tests__/loadProfile.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadProfile.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/loadProfile.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/__tests__/loadProfile.test.js

@@ -0,0 +1,134 @@
+/**
+ * Tests for the SDK's loadProfile helper.
+ *
+ * Parallel to @nookplot/mcp's auth-profile.test.ts and @nookplot/cli's
+ * profile.test.ts — same resolution order, same backward-compat guarantees.
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+import { mkdtempSync, mkdirSync, writeFileSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+let testHome;
+vi.mock("node:os", async () => {
+    const actual = await vi.importActual("node:os");
+    return {
+        ...actual,
+        homedir: () => testHome,
+    };
+});
+const { loadProfile, listProfiles, resolveActiveProfileName } = await import("../loadProfile.js");
+const BASE_CREDS = {
+    apiKey: "nk_" + "a".repeat(64),
+    privateKey: "0x" + "1".repeat(64),
+    address: "0xcreator0000000000000000000000000000aaaa",
+    gatewayUrl: "https://gateway.nookplot.com",
+    displayName: "Test Creator",
+};
+function seedCreds() {
+    const dir = join(testHome, ".nookplot");
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(join(dir, "credentials.json"), JSON.stringify(BASE_CREDS));
+}
+function seedProfile(name, overrides = {}) {
+    const dir = join(testHome, ".nookplot", "profiles", name);
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(join(dir, "profile.json"), JSON.stringify({
+        scopedAgentAddress: "0x" + name.padEnd(40, "f").slice(0, 40),
+        ...overrides,
+    }));
+}
+beforeEach(() => {
+    testHome = mkdtempSync(join(tmpdir(), "sdk-profile-"));
+    delete process.env.NOOKPLOT_PROFILE;
+    delete process.env.NOOKPLOT_GATEWAY_URL;
+});
+afterEach(() => {
+    rmSync(testHome, { recursive: true, force: true });
+    delete process.env.NOOKPLOT_PROFILE;
+    delete process.env.NOOKPLOT_GATEWAY_URL;
+});
+describe("loadProfile — default-path backward compat", () => {
+    it("returns null when no credentials.json exists", () => {
+        expect(loadProfile()).toBeNull();
+    });
+    it("returns flat creds when no profile is active (IDENTICAL to pre-change shape)", () => {
+        seedCreds();
+        const creds = loadProfile();
+        expect(creds).not.toBeNull();
+        expect(creds.apiKey).toBe(BASE_CREDS.apiKey);
+        expect(creds.address).toBe(BASE_CREDS.address);
+        expect(creds.gatewayUrl).toBe(BASE_CREDS.gatewayUrl);
+        // Scope fields absent — SDK users who switch to this helper without
+        // opting into profiles see no behavior change.
+        expect(creds.scopedAgentAddress).toBeUndefined();
+        expect(creds.profileName).toBeUndefined();
+    });
+    it("honors NOOKPLOT_GATEWAY_URL env override (existing SDK convention)", () => {
+        seedCreds();
+        process.env.NOOKPLOT_GATEWAY_URL = "http://127.0.0.1:4321";
+        expect(loadProfile().gatewayUrl).toBe("http://127.0.0.1:4321");
+    });
+});
+describe("loadProfile — profile scope merging", () => {
+    it("merges scopedAgentAddress from a named profile", () => {
+        seedCreds();
+        seedProfile("researcher");
+        const creds = loadProfile("researcher");
+        expect(creds.apiKey).toBe(BASE_CREDS.apiKey); // unchanged
+        expect(creds.scopedAgentAddress).toMatch(/^0xresearcher/);
+        expect(creds.profileName).toBe("researcher");
+    });
+    it("falls back gracefully when the profile doesn't exist (doesn't break scripts)", () => {
+        seedCreds();
+        const creds = loadProfile("ghost");
+        expect(creds).not.toBeNull();
+        expect(creds.scopedAgentAddress).toBeUndefined();
+    });
+    it("falls back gracefully on malformed profile.json", () => {
+        seedCreds();
+        const dir = join(testHome, ".nookplot", "profiles", "broken");
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(join(dir, "profile.json"), "not json at all");
+        const creds = loadProfile("broken");
+        expect(creds).not.toBeNull();
+        expect(creds.scopedAgentAddress).toBeUndefined();
+    });
+    it("never touches the creator credentials.json (additive-only guarantee)", () => {
+        seedCreds();
+        seedProfile("a");
+        loadProfile("a");
+        const raw = require("node:fs").readFileSync(join(testHome, ".nookplot", "credentials.json"), "utf-8");
+        expect(JSON.parse(raw)).toEqual(BASE_CREDS);
+    });
+});
+describe("resolveActiveProfileName — priority order", () => {
+    beforeEach(() => seedCreds());
+    it("explicit argument beats env beats sticky default", () => {
+        writeFileSync(join(testHome, ".nookplot", "active-profile"), "sticky");
+        process.env.NOOKPLOT_PROFILE = "env";
+        expect(resolveActiveProfileName("explicit")).toBe("explicit");
+        expect(resolveActiveProfileName()).toBe("env");
+        delete process.env.NOOKPLOT_PROFILE;
+        expect(resolveActiveProfileName()).toBe("sticky");
+    });
+    it("returns null when nothing is set", () => {
+        expect(resolveActiveProfileName()).toBeNull();
+    });
+});
+describe("listProfiles", () => {
+    it("returns empty when no profiles dir exists", () => {
+        seedCreds();
+        expect(listProfiles()).toEqual([]);
+    });
+    it("enumerates valid profiles sorted alphabetically, skips invalid", () => {
+        seedCreds();
+        seedProfile("writer");
+        seedProfile("researcher");
+        const badDir = join(testHome, ".nookplot", "profiles", "bad");
+        mkdirSync(badDir, { recursive: true });
+        writeFileSync(join(badDir, "profile.json"), "{}");
+        const profiles = listProfiles();
+        expect(profiles.map((p) => p.name)).toEqual(["researcher", "writer"]);
+    });
+});
+//# sourceMappingURL=loadProfile.test.js.map

package/dist/__tests__/loadProfile.test.js.map

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

package/dist/__tests__/presetLoader.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=presetLoader.test.d.ts.map

package/dist/__tests__/presetLoader.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presetLoader.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/presetLoader.test.ts"],"names":[],"mappings":""}