@aithos/sdk 0.1.0-alpha.6 → 0.1.0-alpha.60

package/dist/test/ethos-first-edition.test.js

@@ -0,0 +1,371 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright 2026 Mathieu Colla
+// Tests for the alpha.7 first-edition path in EthosClient — the case
+// where an Ethos identity exists on api.aithos.be (provisioned by
+// auth.signUp() since alpha.6) but no edition has been published yet.
+//
+// Two flows must work:
+//   1. Reading any zone returns an empty list (instead of throwing
+//      "not found: edition").
+//   2. Publishing for the first time builds height=1 from staged
+//      mutations and POSTs publish_ethos_edition directly, instead
+//      of going through publishZoneEdit (which requires a previous
+//      manifest).
+//
+// We mock global fetch end-to-end so the tests run offline.
+import { strict as assert } from "node:assert";
+import { afterEach, beforeEach, describe, it } from "node:test";
+import { createBrowserIdentity } from "@aithos/protocol-client";
+import { AithosAuth, AithosSDKError, EthosNamespace, memoryKeyStore, noopStore, } from "../src/index.js";
+import { serializeRecoveryFile } from "../src/internal/recovery-file.js";
+import { DEFAULT_SDK_ENDPOINTS } from "../src/endpoints.js";
+let fetchCalls = [];
+let savedFetch;
+function installFetchMock(handlers) {
+    savedFetch = globalThis.fetch;
+    fetchCalls = [];
+    globalThis.fetch = (async (input, init) => {
+        const url = String(input);
+        const method = init?.method ?? "GET";
+        const bodyText = typeof init?.body === "string"
+            ? init.body
+            : init?.body == null
+                ? null
+                : String(init.body);
+        const body = bodyText ? JSON.parse(bodyText) : null;
+        const call = { url, method, body };
+        fetchCalls.push(call);
+        for (const h of handlers) {
+            if (!url.includes(h.url))
+                continue;
+            if (h.rpcMethod && body?.method !== h.rpcMethod)
+                continue;
+            const out = h.respond(call);
+            const status = out.status ?? 200;
+            return new Response(JSON.stringify(out.json), {
+                status,
+                headers: { "content-type": "application/json" },
+            });
+        }
+        throw new Error(`unhandled fetch: ${method} ${url} (rpc: ${body?.method ?? "n/a"})`);
+    });
+}
+function uninstallFetchMock() {
+    if (savedFetch) {
+        globalThis.fetch = savedFetch;
+        savedFetch = undefined;
+    }
+    fetchCalls = [];
+}
+function makeAuth() {
+    return new AithosAuth({
+        authBaseUrl: "https://auth.test",
+        apiBaseUrl: "https://api.test",
+        fetch: (() => {
+            throw new Error("AithosAuth.fetch must not be called in these tests");
+        }),
+        sessionStore: noopStore(),
+        keyStore: memoryKeyStore(),
+    });
+}
+function makeNamespace(auth) {
+    return new EthosNamespace({
+        auth,
+        endpoints: DEFAULT_SDK_ENDPOINTS,
+        // EthosNamespace itself doesn't read fetch from this slot today;
+        // protocol-client uses the global fetch we mock above.
+        fetch: globalThis.fetch.bind(globalThis),
+    });
+}
+async function signInAsAlice(auth) {
+    const id = createBrowserIdentity("alice", "Alice");
+    const { text } = serializeRecoveryFile(id);
+    const info = await auth.signInWithRecovery({ file: text });
+    return { did: info.did };
+}
+function noEditionYetResponse() {
+    // Mirrors the server's primitives-read `notFound("edition for <did>")`:
+    // JSON-RPC error code -32020, message starts with "not found: edition for ".
+    return {
+        json: {
+            jsonrpc: "2.0",
+            id: "aithos.get_ethos_manifest",
+            error: {
+                code: -32020,
+                message: "not found: edition for did:aithos:zSomething",
+            },
+        },
+    };
+}
+function publishOkResponse() {
+    return {
+        json: {
+            jsonrpc: "2.0",
+            id: "publish_ethos_edition",
+            result: { ok: true, height: 1, manifest_uri: "s3://aithos/.../manifest.json" },
+        },
+    };
+}
+/* -------------------------------------------------------------------------- */
+/*  Tests                                                                     */
+/* -------------------------------------------------------------------------- */
+describe("EthosClient — fresh Ethos (no edition published yet)", () => {
+    beforeEach(() => {
+        fetchCalls = [];
+    });
+    afterEach(() => {
+        uninstallFetchMock();
+    });
+    it("zone(public).sections() returns [] when server says 'not found: edition'", async () => {
+        installFetchMock([
+            {
+                url: "/mcp/primitives/read",
+                rpcMethod: "aithos.get_ethos_manifest",
+                respond: noEditionYetResponse,
+            },
+        ]);
+        const auth = makeAuth();
+        await signInAsAlice(auth);
+        const me = makeNamespace(auth).me();
+        const sections = await me.zone("public").sections();
+        assert.deepEqual(sections, []);
+    });
+    it("zone(public).sections() reflects locally staged adds even when no edition exists", async () => {
+        installFetchMock([
+            {
+                url: "/mcp/primitives/read",
+                rpcMethod: "aithos.get_ethos_manifest",
+                respond: noEditionYetResponse,
+            },
+        ]);
+        const auth = makeAuth();
+        await signInAsAlice(auth);
+        const me = makeNamespace(auth).me();
+        me.zone("public").addSection({ title: "Hello", body: "World" });
+        const sections = await me.zone("public").sections();
+        assert.equal(sections.length, 1);
+        assert.equal(sections[0].title, "Hello");
+    });
+    it("publish() routes to publish_ethos_edition with height=1 on first publish", async () => {
+        let publishBody = null;
+        installFetchMock([
+            {
+                url: "/mcp/primitives/read",
+                rpcMethod: "aithos.get_ethos_manifest",
+                respond: noEditionYetResponse,
+            },
+            {
+                url: "/mcp/primitives/write",
+                rpcMethod: "aithos.publish_ethos_edition",
+                respond: (call) => {
+                    publishBody = call.body;
+                    return publishOkResponse();
+                },
+            },
+        ]);
+        const auth = makeAuth();
+        const alice = await signInAsAlice(auth);
+        const me = makeNamespace(auth).me();
+        me.zone("public").addSection({ title: "First", body: "Hello." });
+        me.zone("public").addSection({ title: "Second", body: "World." });
+        const r = await me.publish();
+        assert.equal(r.editionHeight, 1);
+        assert.equal(r.subjectDid, alice.did);
+        assert.deepEqual(r.zonesPublished, ["public"]);
+        // Verify the wire shape: JSON-RPC publish_ethos_edition with a height=1
+        // manifest containing both staged sections.
+        assert.equal(publishBody.method, "aithos.publish_ethos_edition");
+        const manifest = publishBody.params.manifest;
+        assert.equal(manifest.edition.height, 1);
+        assert.equal(manifest.edition.prev_hash, null);
+        assert.equal(manifest.edition.supersedes, null);
+        assert.deepEqual(manifest.zones.public.section_titles, ["First", "Second"]);
+        // Envelope is signed under #public.
+        const env = publishBody.params._envelope;
+        assert.equal(env.method, "aithos.publish_ethos_edition");
+        assert.match(env.proof.verificationMethod, /#public$/);
+    });
+    it("publish() accepts circle mutations on first edition with auto-injected public sentinel", async () => {
+        // Regression target: this used to throw `ethos_first_edition_public_only`.
+        // Since aithos-sdk@0.1.0-alpha.43 + protocol-client@0.1.0-alpha.14, the
+        // SDK auto-injects an `aithos-init` public section and seals the circle
+        // sections in the same height=1 manifest.
+        let publishBody = null;
+        installFetchMock([
+            {
+                url: "/mcp/primitives/read",
+                rpcMethod: "aithos.get_ethos_manifest",
+                respond: noEditionYetResponse,
+            },
+            {
+                url: "/mcp/primitives/write",
+                rpcMethod: "aithos.publish_ethos_edition",
+                respond: (call) => {
+                    publishBody = call.body;
+                    return publishOkResponse();
+                },
+            },
+        ]);
+        const auth = makeAuth();
+        await signInAsAlice(auth);
+        const me = makeNamespace(auth).me();
+        me.zone("circle").addSection({ title: "Private", body: "..." });
+        const r = await me.publish();
+        assert.equal(r.editionHeight, 1);
+        assert.deepEqual(r.zonesPublished, ["public", "circle"]);
+        const manifest = publishBody.params.manifest;
+        assert.equal(manifest.edition.height, 1);
+        assert.equal(manifest.edition.prev_hash, null);
+        // Auto-injected sentinel.
+        assert.deepEqual(manifest.zones.public.section_titles, ["aithos-init"]);
+        assert.equal(manifest.zones.public.encrypted, false);
+        // Sealed circle zone.
+        assert.deepEqual(manifest.zones.circle.section_titles, ["Private"]);
+        assert.equal(manifest.zones.circle.encrypted, true);
+        assert.ok(manifest.zones.circle.cipher, "circle cipher must be present");
+        // Both zones uploaded.
+        assert.ok(publishBody.params.zones.public?.bytes_base64);
+        assert.ok(publishBody.params.zones.circle?.bytes_base64);
+        assert.equal(publishBody.params.zones.self, undefined);
+    });
+    it("publish() preserves the caller's explicit public section when mixed with circle", async () => {
+        // When the caller stages BOTH a public and a circle add, the SDK
+        // must NOT inject a sentinel — the user's public section is enough.
+        let publishBody = null;
+        installFetchMock([
+            {
+                url: "/mcp/primitives/read",
+                rpcMethod: "aithos.get_ethos_manifest",
+                respond: noEditionYetResponse,
+            },
+            {
+                url: "/mcp/primitives/write",
+                rpcMethod: "aithos.publish_ethos_edition",
+                respond: (call) => {
+                    publishBody = call.body;
+                    return publishOkResponse();
+                },
+            },
+        ]);
+        const auth = makeAuth();
+        await signInAsAlice(auth);
+        const me = makeNamespace(auth).me();
+        me.zone("public").addSection({ title: "About", body: "Public bio." });
+        me.zone("circle").addSection({ title: "Notes", body: "Private notes." });
+        const r = await me.publish();
+        assert.deepEqual(r.zonesPublished, ["public", "circle"]);
+        const manifest = publishBody.params.manifest;
+        // No sentinel — the user's section is the public titles entry.
+        assert.deepEqual(manifest.zones.public.section_titles, ["About"]);
+        assert.deepEqual(manifest.zones.circle.section_titles, ["Notes"]);
+    });
+    it("publish() auto-injects public sentinel when only self mutations are staged", async () => {
+        let publishBody = null;
+        installFetchMock([
+            {
+                url: "/mcp/primitives/read",
+                rpcMethod: "aithos.get_ethos_manifest",
+                respond: noEditionYetResponse,
+            },
+            {
+                url: "/mcp/primitives/write",
+                rpcMethod: "aithos.publish_ethos_edition",
+                respond: (call) => {
+                    publishBody = call.body;
+                    return publishOkResponse();
+                },
+            },
+        ]);
+        const auth = makeAuth();
+        await signInAsAlice(auth);
+        const me = makeNamespace(auth).me();
+        me.zone("self").addSection({ title: "Journal", body: "Private." });
+        const r = await me.publish();
+        assert.deepEqual(r.zonesPublished, ["public", "self"]);
+        const manifest = publishBody.params.manifest;
+        assert.deepEqual(manifest.zones.public.section_titles, ["aithos-init"]);
+        assert.deepEqual(manifest.zones.self.section_titles, ["Journal"]);
+        assert.equal(manifest.zones.self.encrypted, true);
+        assert.equal(manifest.zones.circle, undefined);
+    });
+    it("publish() lands public + circle + self in a single height=1 edition", async () => {
+        let publishBody = null;
+        installFetchMock([
+            {
+                url: "/mcp/primitives/read",
+                rpcMethod: "aithos.get_ethos_manifest",
+                respond: noEditionYetResponse,
+            },
+            {
+                url: "/mcp/primitives/write",
+                rpcMethod: "aithos.publish_ethos_edition",
+                respond: (call) => {
+                    publishBody = call.body;
+                    return publishOkResponse();
+                },
+            },
+        ]);
+        const auth = makeAuth();
+        await signInAsAlice(auth);
+        const me = makeNamespace(auth).me();
+        me.zone("public").addSection({ title: "Bio", body: "Bio body." });
+        me.zone("circle").addSection({ title: "Circle", body: "Circle body." });
+        me.zone("self").addSection({ title: "Self", body: "Self body." });
+        const r = await me.publish();
+        assert.equal(r.editionHeight, 1);
+        assert.deepEqual(r.zonesPublished, ["public", "circle", "self"]);
+        const manifest = publishBody.params.manifest;
+        assert.deepEqual(manifest.zones.public.section_titles, ["Bio"]);
+        assert.deepEqual(manifest.zones.circle.section_titles, ["Circle"]);
+        assert.deepEqual(manifest.zones.self.section_titles, ["Self"]);
+        assert.ok(publishBody.params.zones.public?.bytes_base64);
+        assert.ok(publishBody.params.zones.circle?.bytes_base64);
+        assert.ok(publishBody.params.zones.self?.bytes_base64);
+    });
+    it("publish() rejects update/delete operations on a fresh Ethos", async () => {
+        installFetchMock([
+            {
+                url: "/mcp/primitives/read",
+                rpcMethod: "aithos.get_ethos_manifest",
+                respond: noEditionYetResponse,
+            },
+        ]);
+        const auth = makeAuth();
+        await signInAsAlice(auth);
+        const me = makeNamespace(auth).me();
+        // Stage a delete for a section that doesn't exist (no edition exists at all).
+        me.zone("public")["_parent"]; // type-safety placeholder; we use the public API
+        // EthosZone exposes deleteSection — go via that.
+        me.zone("public").deleteSection("sec_doesnotexist000");
+        await assert.rejects(() => me.publish(), (e) => e instanceof AithosSDKError && e.code === "ethos_first_edition_invalid_op");
+    });
+    it("publish() surfaces server JSON-RPC errors as ethos_first_edition_rejected", async () => {
+        installFetchMock([
+            {
+                url: "/mcp/primitives/read",
+                rpcMethod: "aithos.get_ethos_manifest",
+                respond: noEditionYetResponse,
+            },
+            {
+                url: "/mcp/primitives/write",
+                rpcMethod: "aithos.publish_ethos_edition",
+                respond: () => ({
+                    json: {
+                        jsonrpc: "2.0",
+                        id: "publish_ethos_edition",
+                        error: {
+                            code: -32020,
+                            message: "subject identity not published (call publish_identity first)",
+                        },
+                    },
+                }),
+            },
+        ]);
+        const auth = makeAuth();
+        await signInAsAlice(auth);
+        const me = makeNamespace(auth).me();
+        me.zone("public").addSection({ title: "Hi", body: "There." });
+        await assert.rejects(() => me.publish(), (e) => e instanceof AithosSDKError && e.code === "ethos_first_edition_rejected");
+    });
+});
+//# sourceMappingURL=ethos-first-edition.test.js.map

package/dist/test/invoke-turn-sdk.test.d.ts

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

package/dist/test/invoke-turn-sdk.test.js

@@ -0,0 +1,177 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright 2026 Mathieu Colla
+// Wire tests for sdk.compute.invokeTurn + sdk.compute.runConversationLocal,
+// mirroring converse.test.ts: a real BrowserIdentity drives envelope signing
+// and we assert on the JSON-RPC body posted to the proxy.
+import { strict as assert } from "node:assert";
+import { describe, it } from "node:test";
+import { createBrowserIdentity } from "@aithos/protocol-client";
+import { AithosAuth, AithosSDK, AithosSDKError, memoryKeyStore, noopStore, AITHOS_AGENT_TOOLS, } from "../src/index.js";
+import { serializeRecoveryFile } from "../src/internal/recovery-file.js";
+const APP_DID = "did:aithos:app:test";
+async function makeSdk(fetchImpl) {
+    const id = createBrowserIdentity("turn-handle", "Turn User");
+    const auth = new AithosAuth({
+        authBaseUrl: "https://auth.test",
+        fetch: (() => {
+            throw new Error("auth not used");
+        }),
+        sessionStore: noopStore(),
+        keyStore: memoryKeyStore(),
+    });
+    const { text } = serializeRecoveryFile(id);
+    await auth.signInWithRecovery({ file: text });
+    const sdk = new AithosSDK({
+        auth,
+        appDid: APP_DID,
+        endpoints: { compute: "https://compute.example.test" },
+        fetch: fetchImpl,
+    });
+    return { sdk, did: id.did };
+}
+const TURN_RESULT = {
+    content: [{ type: "text", text: "Réponse." }],
+    stopReason: "end_turn",
+    usage: { inputTokens: 100, outputTokens: 20 },
+    creditsCharged: 12,
+    walletBalance: 9_988,
+    auditId: "audit-turn-1",
+    fundedBy: "purchase",
+};
+describe("compute.invokeTurn — wire", () => {
+    it("posts aithos.compute_invoke_turn with tools + mapped params", async () => {
+        let capturedUrl;
+        let capturedInit;
+        const fakeFetch = async (input, init) => {
+            capturedUrl = typeof input === "string" ? input : input.toString();
+            capturedInit = init;
+            return new Response(JSON.stringify({ result: TURN_RESULT }), {
+                status: 200,
+                headers: { "content-type": "application/json" },
+            });
+        };
+        const { sdk } = await makeSdk(fakeFetch);
+        const out = await sdk.compute.invokeTurn({
+            mandateId: "mandate:abc",
+            model: "claude-sonnet-4-6",
+            system: "sys",
+            messages: [{ role: "user", content: "salut" }],
+            tools: [
+                {
+                    name: "ethos_list_sections",
+                    description: "list",
+                    input_schema: { type: "object", properties: {} },
+                },
+            ],
+            maxTokens: 512,
+            temperature: 0.2,
+        });
+        assert.deepEqual(out, TURN_RESULT);
+        assert.equal(capturedUrl, "https://compute.example.test/v1/invoke");
+        const body = JSON.parse(capturedInit?.body);
+        assert.equal(body.method, "aithos.compute_invoke_turn");
+        assert.equal(body.params.app_did, APP_DID);
+        assert.equal(body.params.mandate_id, "mandate:abc");
+        assert.equal(body.params.model, "claude-sonnet-4-6");
+        assert.equal(body.params.system, "sys");
+        assert.equal(body.params.max_tokens, 512);
+        assert.equal(body.params.temperature, 0.2);
+        assert.ok(Array.isArray(body.params.tools), "tools must be on the wire");
+        assert.equal(body.params.tools.length, 1);
+        assert.match(body.params.idempotency_key, /^[0-9a-f]{32}$/);
+        assert.ok(body.params._envelope, "must carry a signed envelope");
+        // SDK-only camelCase keys must not leak.
+        assert.equal(body.params.maxTokens, undefined);
+    });
+    it("maps a JSON-RPC error to AithosSDKError", async () => {
+        const fakeFetch = async () => new Response(JSON.stringify({ error: { code: -32071, message: "insufficient credits" } }), {
+            status: 200,
+            headers: { "content-type": "application/json" },
+        });
+        const { sdk } = await makeSdk(fakeFetch);
+        await assert.rejects(() => sdk.compute.invokeTurn({
+            model: "claude-sonnet-4-6",
+            messages: [{ role: "user", content: "hi" }],
+            tools: [],
+        }), (err) => {
+            assert.ok(err instanceof AithosSDKError);
+            assert.equal(err.code, "-32071");
+            return true;
+        });
+    });
+});
+describe("compute.runConversationLocal — wiring", () => {
+    it("drives the loop: single end_turn → 1 iteration, full catalogue forwarded", async () => {
+        const bodies = [];
+        const fakeFetch = async (_input, init) => {
+            bodies.push(JSON.parse(init?.body));
+            return new Response(JSON.stringify({ result: TURN_RESULT }), {
+                status: 200,
+                headers: { "content-type": "application/json" },
+            });
+        };
+        const { sdk } = await makeSdk(fakeFetch);
+        const out = await sdk.compute.runConversationLocal({
+            model: "claude-sonnet-4-6",
+            messages: [{ role: "user", content: "Mets à jour ma bio si besoin." }],
+            system: "Écris seulement si nécessaire.",
+        });
+        assert.equal(out.iterations, 1);
+        assert.equal(out.stopReason, "end_turn");
+        assert.equal(out.content, "Réponse.");
+        assert.equal(out.creditsCharged, 12);
+        assert.equal(out.walletBalance, 9_988);
+        assert.equal(out.auditId, "audit-turn-1");
+        assert.equal(out.fundedBy, "purchase");
+        assert.deepEqual(out.toolCalls, []);
+        // One proxy turn, the right method, the full tool catalogue forwarded.
+        assert.equal(bodies.length, 1);
+        assert.equal(bodies[0].method, "aithos.compute_invoke_turn");
+        assert.equal(bodies[0].params.tools.length, AITHOS_AGENT_TOOLS.length);
+    });
+    it("readOnly forwards only the read family", async () => {
+        const bodies = [];
+        const fakeFetch = async (_input, init) => {
+            bodies.push(JSON.parse(init?.body));
+            return new Response(JSON.stringify({ result: TURN_RESULT }), {
+                status: 200,
+                headers: { "content-type": "application/json" },
+            });
+        };
+        const { sdk } = await makeSdk(fakeFetch);
+        await sdk.compute.runConversationLocal({
+            model: "claude-sonnet-4-6",
+            messages: [{ role: "user", content: "résume" }],
+            readOnly: true,
+        });
+        const toolNames = bodies[0].params.tools.map((t) => t.name).sort();
+        assert.deepEqual(toolNames, ["data_query", "ethos_list_sections", "ethos_read_section"]);
+    });
+    it("throws sdk_no_signer when no owner and no mandate/subject", async () => {
+        const auth = new AithosAuth({
+            authBaseUrl: "https://auth.test",
+            fetch: (() => {
+                throw new Error("unused");
+            }),
+            sessionStore: noopStore(),
+            keyStore: memoryKeyStore(),
+        });
+        const sdk = new AithosSDK({
+            auth,
+            appDid: APP_DID,
+            endpoints: { compute: "https://compute.example.test" },
+            fetch: (() => {
+                throw new Error("fetch must not be reached");
+            }),
+        });
+        await assert.rejects(() => sdk.compute.runConversationLocal({
+            model: "claude-sonnet-4-6",
+            messages: [{ role: "user", content: "hi" }],
+        }), (err) => {
+            assert.ok(err instanceof AithosSDKError);
+            assert.equal(err.code, "sdk_no_signer");
+            return true;
+        });
+    });
+});
+//# sourceMappingURL=invoke-turn-sdk.test.js.map

package/dist/test/migrate.test.d.ts

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