@aithos/sdk 0.1.0-alpha.38 → 0.1.0-alpha.39

package/dist/src/data.d.ts

@@ -63,6 +63,45 @@ export interface DataClient {
         opPrefix?: string;
         verify?: boolean;
     }): Promise<unknown>;
+    /**
+     * Idempotently publish a vendor (`aithos.x.<vendor>.<name>.v<N>`)
+     * JSON Schema document to this subject's PDS. Once published, the
+     * PDS validates record writes against the schema doc server-side,
+     * closing the gap A2a left open (cf. Aithos-protocol/PLAN-A2b-…).
+     *
+     * Safe to call on every app boot — re-registering the same document
+     * (same canonical hash) resolves to `{ created: false }`. A different
+     * document for the same `aithos:schema` id is REJECTED with code
+     * -32082 `AITHOS_DATA_SCHEMA_IMMUTABLE` ; the caller must bump the
+     * version segment in `aithos:schema` and retry.
+     *
+     * Core schemas (`aithos.<name>.v<N>` without `.x.`) cannot be
+     * registered via this RPC ; they're bundled by the platform per spec
+     * §3.7.2.
+     *
+     * @param schemaDoc Full JSON Schema 2020-12 document. MUST carry
+     *   `aithos:schema` and `aithos:version` top-level fields.
+     */
+    registerSchema(schemaDoc: object): Promise<{
+        schemaId: string;
+        docHash: string;
+        created: boolean;
+        createdAt?: string;
+    }>;
+    /**
+     * Fetch a published schema document from the PDS.
+     *
+     * For core schemas (`aithos.<name>.v<N>`) the lookup is global ;
+     * `subjectDid` is ignored. For vendor schemas (`aithos.x.*`) the
+     * `subjectDid` arg selects whose published registry to query and
+     * defaults to this client's own DID.
+     *
+     * Returns null when the lookup misses (rather than throwing) so
+     * call sites can branch on the result.
+     */
+    getSchema(schemaId: string, opts?: {
+        subjectDid?: string;
+    }): Promise<object | null>;
     /** Drop in-memory cache (CMK, collection metadata, …). */
     reset(): void;
 }

package/dist/src/data.js

@@ -145,6 +145,37 @@ class DataClientImpl {
             params.verify = true;
         return this.#call("/mcp/primitives/read", "aithos.data.list_gamma_entries", params);
     }
+    async registerSchema(schemaDoc) {
+        if (schemaDoc === null || typeof schemaDoc !== "object" || Array.isArray(schemaDoc)) {
+            throw new Error("sdk.data.registerSchema: schemaDoc must be a JSON object");
+        }
+        const r = (await this.#call("/mcp/primitives/write", "aithos.data.register_schema", {
+            subject_did: this.#did,
+            schema_doc: schemaDoc,
+        }));
+        return {
+            schemaId: r.schema_id,
+            docHash: r.doc_hash,
+            created: r.created,
+            ...(r.created_at ? { createdAt: r.created_at } : {}),
+        };
+    }
+    async getSchema(schemaId, opts = {}) {
+        const params = { schema: schemaId };
+        // Vendor schemas always need a subject_did to address the right
+        // registry ; for core schemas the PDS ignores it but we still send
+        // ours so the auth check (envelope iss === subject_did) lines up.
+        params.subject_did = opts.subjectDid ?? this.#did;
+        try {
+            const r = (await this.#call("/mcp/primitives/read", "aithos.data.get_schema", params));
+            return r.schema;
+        }
+        catch (e) {
+            if (e.code === -32070)
+                return null;
+            throw e;
+        }
+    }
     reset() {
         for (const k of this.#cmkCache.values())
             k.fill(0);

package/dist/src/index.d.ts

@@ -1,4 +1,4 @@
-export declare const VERSION = "0.1.0-alpha.35";
+export declare const VERSION = "0.1.0-alpha.39";
 export { AithosSDK } from "./sdk.js";
 export type { AithosSDKConfig } from "./types.js";
 export { AithosSDKError } from "./types.js";

package/dist/src/index.js

@@ -17,7 +17,7 @@
 // Public types specific to the SDK (`AithosSDKConfig`, `AithosSDKError`)
 // are exported from here. Endpoint config (`AithosSdkEndpoints`,
 // `DEFAULT_SDK_ENDPOINTS`) likewise.
-export const VERSION = "0.1.0-alpha.35";
+export const VERSION = "0.1.0-alpha.39";
 export { AithosSDK } from "./sdk.js";
 export { AithosSDKError } from "./types.js";
 // Re-export protocol-client's JSON-RPC error type so consumers can

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aithos/sdk",
-  "version": "0.1.0-alpha.38",
+  "version": "0.1.0-alpha.39",
   "description": "Aithos SDK — high-level TypeScript developer kit for building agentic apps on the Aithos protocol. Wraps @aithos/protocol-client and exposes the Aithos compute proxy and wallet (Stripe top-up) endpoints.",
   "keywords": [
     "aithos",
@@ -39,6 +39,15 @@
     "README.md",
     "LICENSE"
   ],
+  "scripts": {
+    "build": "tsc",
+    "build:test": "tsc -p tsconfig.test.json",
+    "check-types": "tsc --noEmit && tsc -p tsconfig.test.json --noEmit",
+    "test": "npm run clean && npm run build && npm run build:test && cd dist && node --test",
+    "test:watch": "cd dist && node --test --watch",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build && npm test"
+  },
   "engines": {
     "node": ">=20"
   },
@@ -54,13 +63,5 @@
   "publishConfig": {
     "access": "public",
     "tag": "alpha"
-  },
-  "scripts": {
-    "build": "tsc",
-    "build:test": "tsc -p tsconfig.test.json",
-    "check-types": "tsc --noEmit && tsc -p tsconfig.test.json --noEmit",
-    "test": "npm run clean && npm run build && npm run build:test && cd dist && node --test",
-    "test:watch": "cd dist && node --test --watch",
-    "clean": "rm -rf dist"
   }
-}
+}