@a2aletheia/sdk 0.2.0

package/dist/tools/index.d.ts

@@ -0,0 +1,80 @@
+export { calculate, calculatorToolDefinition, type CalculatorInput, type CalculatorResult, } from "./calculator.js";
+export { getCurrentTime, getCurrentTimeToolDefinition, type CurrentTimeResult, } from "./get-current-time.js";
+export { convertUnits, convertUnitsToolDefinition, type CryptoUnit, type TimeUnit, type DataUnit, type SupportedUnit, type UnitCategory, type UnitConversionInput, type UnitConversionResult, } from "./convert-units.js";
+export { generateUUID, uuidGeneratorToolDefinition, type UUIDResult, } from "./uuid-generator.js";
+export declare const aletheiaToolDefinitions: readonly [{
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                expression: {
+                    type: "string";
+                    description: string;
+                };
+            };
+            required: readonly ["expression"];
+            additionalProperties: false;
+        };
+    };
+    execute: (input: import("./calculator.js").CalculatorInput) => import("./calculator.js").CalculatorResult;
+}, {
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: "object";
+            properties: Record<string, never>;
+            required: string[];
+            additionalProperties: false;
+        };
+    };
+    execute: (_input?: Record<string, never>) => import("./get-current-time.js").CurrentTimeResult;
+}, {
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                value: {
+                    type: "string";
+                    description: string;
+                };
+                from: {
+                    type: "string";
+                    enum: readonly ["wei", "gwei", "ether", "seconds", "minutes", "hours", "days", "bytes", "KB", "MB", "GB", "TB"];
+                    description: string;
+                };
+                to: {
+                    type: "string";
+                    enum: readonly ["wei", "gwei", "ether", "seconds", "minutes", "hours", "days", "bytes", "KB", "MB", "GB", "TB"];
+                    description: string;
+                };
+            };
+            required: readonly ["value", "from", "to"];
+            additionalProperties: false;
+        };
+    };
+    execute: (input: import("./convert-units.js").UnitConversionInput) => import("./convert-units.js").UnitConversionResult;
+}, {
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: "object";
+            properties: Record<string, never>;
+            required: string[];
+            additionalProperties: false;
+        };
+    };
+    execute: (_input?: Record<string, never>) => import("./uuid-generator.js").UUIDResult;
+}];
+/** Map of tool name → execute function, for routing tool calls from LLM responses. */
+export declare const aletheiaToolExecutors: Record<string, (input: any) => unknown>;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,SAAS,EACT,wBAAwB,EACxB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,cAAc,EACd,4BAA4B,EAC5B,KAAK,iBAAiB,GACvB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,YAAY,EACZ,0BAA0B,EAC1B,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,YAAY,EACZ,2BAA2B,EAC3B,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC;AAyB7B,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK1B,CAAC;AAEX,sFAAsF;AAEtF,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAQzE,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,41 @@
+// ── Individual tool exports ──────────────────────────────────────────────────
+export { calculate, calculatorToolDefinition, } from "./calculator.js";
+export { getCurrentTime, getCurrentTimeToolDefinition, } from "./get-current-time.js";
+export { convertUnits, convertUnitsToolDefinition, } from "./convert-units.js";
+export { generateUUID, uuidGeneratorToolDefinition, } from "./uuid-generator.js";
+// ── Convenience: all tool definitions as an array ────────────────────────────
+//
+// Usage with LangChain:
+//   import { aletheiaToolDefinitions } from "@a2aletheia/sdk";
+//   const tools = aletheiaToolDefinitions; // pass to ChatOpenAI.bind({ tools })
+//
+// Usage with Vercel AI SDK:
+//   import { aletheiaToolDefinitions } from "@a2aletheia/sdk";
+//   const result = await generateText({ tools: aletheiaToolDefinitions, ... });
+//
+// Usage with OpenAI function calling:
+//   import { aletheiaToolDefinitions } from "@a2aletheia/sdk";
+//   const response = await openai.chat.completions.create({
+//     tools: aletheiaToolDefinitions.map(t => ({ type: t.type, function: t.function })),
+//     ...
+//   });
+//   // Then route tool calls to the matching definition's .execute()
+import { calculatorToolDefinition } from "./calculator.js";
+import { getCurrentTimeToolDefinition } from "./get-current-time.js";
+import { convertUnitsToolDefinition } from "./convert-units.js";
+import { uuidGeneratorToolDefinition } from "./uuid-generator.js";
+export const aletheiaToolDefinitions = [
+    calculatorToolDefinition,
+    getCurrentTimeToolDefinition,
+    convertUnitsToolDefinition,
+    uuidGeneratorToolDefinition,
+];
+/** Map of tool name → execute function, for routing tool calls from LLM responses. */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const aletheiaToolExecutors = {
+    [calculatorToolDefinition.function.name]: calculatorToolDefinition.execute,
+    [getCurrentTimeToolDefinition.function.name]: getCurrentTimeToolDefinition.execute,
+    [convertUnitsToolDefinition.function.name]: convertUnitsToolDefinition.execute,
+    [uuidGeneratorToolDefinition.function.name]: uuidGeneratorToolDefinition.execute,
+};
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,OAAO,EACL,SAAS,EACT,wBAAwB,GAGzB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,cAAc,EACd,4BAA4B,GAE7B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,YAAY,EACZ,0BAA0B,GAQ3B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,YAAY,EACZ,2BAA2B,GAE5B,MAAM,qBAAqB,CAAC;AAE7B,gFAAgF;AAChF,EAAE;AACF,wBAAwB;AACxB,+DAA+D;AAC/D,iFAAiF;AACjF,EAAE;AACF,4BAA4B;AAC5B,+DAA+D;AAC/D,gFAAgF;AAChF,EAAE;AACF,sCAAsC;AACtC,+DAA+D;AAC/D,4DAA4D;AAC5D,yFAAyF;AACzF,UAAU;AACV,QAAQ;AACR,qEAAqE;AAErE,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,wBAAwB;IACxB,4BAA4B;IAC5B,0BAA0B;IAC1B,2BAA2B;CACnB,CAAC;AAEX,sFAAsF;AACtF,8DAA8D;AAC9D,MAAM,CAAC,MAAM,qBAAqB,GAA4C;IAC5E,CAAC,wBAAwB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,wBAAwB,CAAC,OAAO;IAC1E,CAAC,4BAA4B,CAAC,QAAQ,CAAC,IAAI,CAAC,EAC1C,4BAA4B,CAAC,OAAO;IACtC,CAAC,0BAA0B,CAAC,QAAQ,CAAC,IAAI,CAAC,EACxC,0BAA0B,CAAC,OAAO;IACpC,CAAC,2BAA2B,CAAC,QAAQ,CAAC,IAAI,CAAC,EACzC,2BAA2B,CAAC,OAAO;CACtC,CAAC"}

package/dist/tools/uuid-generator.d.ts

@@ -0,0 +1,21 @@
+export interface UUIDResult {
+    tool: "uuid_generator";
+    uuid: string;
+    version: 4;
+}
+export declare function generateUUID(): UUIDResult;
+export declare const uuidGeneratorToolDefinition: {
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: "object";
+            properties: Record<string, never>;
+            required: string[];
+            additionalProperties: false;
+        };
+    };
+    execute: (_input?: Record<string, never>) => UUIDResult;
+};
+//# sourceMappingURL=uuid-generator.d.ts.map

package/dist/tools/uuid-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid-generator.d.ts","sourceRoot":"","sources":["../../src/tools/uuid-generator.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,CAAC;CACZ;AAID,wBAAgB,YAAY,IAAI,UAAU,CAMzC;AAID,eAAO,MAAM,2BAA2B;;;;;;;wBAQhB,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;sBACvB,MAAM,EAAE;;;;uBAIT,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,KAAG,UAAU;CACtD,CAAC"}

package/dist/tools/uuid-generator.js

@@ -0,0 +1,25 @@
+// ── Result type ──────────────────────────────────────────────────────────────
+// ── Core function ────────────────────────────────────────────────────────────
+export function generateUUID() {
+    return {
+        tool: "uuid_generator",
+        uuid: crypto.randomUUID(),
+        version: 4,
+    };
+}
+// ── Tool definition (OpenAI-compatible / LangChain / Vercel AI SDK) ──────────
+export const uuidGeneratorToolDefinition = {
+    type: "function",
+    function: {
+        name: "uuid_generator",
+        description: "Generate a random UUID v4 identifier. Use this when you need a unique ID for creating resources, correlation IDs, or any scenario requiring a globally unique identifier.",
+        parameters: {
+            type: "object",
+            properties: {},
+            required: [],
+            additionalProperties: false,
+        },
+    },
+    execute: (_input) => generateUUID(),
+};
+//# sourceMappingURL=uuid-generator.js.map

package/dist/tools/uuid-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid-generator.js","sourceRoot":"","sources":["../../src/tools/uuid-generator.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAQhF,gFAAgF;AAEhF,MAAM,UAAU,YAAY;IAC1B,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE;QACzB,OAAO,EAAE,CAAC;KACX,CAAC;AACJ,CAAC;AAED,gFAAgF;AAEhF,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,IAAI,EAAE,UAAmB;IACzB,QAAQ,EAAE;QACR,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,2KAA2K;QAC7K,UAAU,EAAE;YACV,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE,EAA2B;YACvC,QAAQ,EAAE,EAAc;YACxB,oBAAoB,EAAE,KAAc;SACrC;KACF;IACD,OAAO,EAAE,CAAC,MAA8B,EAAc,EAAE,CAAC,YAAY,EAAE;CACxE,CAAC"}

package/dist/utils/http.d.ts

@@ -0,0 +1,11 @@
+export declare class HttpClient {
+    private baseUrl;
+    private authToken;
+    constructor(baseUrl: string);
+    setAuthToken(token: string | null): void;
+    private getHeaders;
+    get<T>(path: string, params?: Record<string, string>): Promise<T>;
+    post<T>(path: string, body: unknown): Promise<T>;
+    put<T>(path: string, body: unknown): Promise<T>;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/utils/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/utils/http.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAU;IAGT,OAAO,CAAC,OAAO;IAF3B,OAAO,CAAC,SAAS,CAAuB;gBAEpB,OAAO,EAAE,MAAM;IAEnC,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAIxC,OAAO,CAAC,UAAU;IAWZ,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAgBjE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAahD,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;CAYtD"}

package/dist/utils/http.js

@@ -0,0 +1,60 @@
+export class HttpClient {
+    baseUrl;
+    authToken = null;
+    constructor(baseUrl) {
+        this.baseUrl = baseUrl;
+    }
+    setAuthToken(token) {
+        this.authToken = token;
+    }
+    getHeaders(includeBody = false) {
+        const headers = {};
+        if (includeBody) {
+            headers["Content-Type"] = "application/json";
+        }
+        if (this.authToken) {
+            headers["Authorization"] = `Bearer ${this.authToken}`;
+        }
+        return headers;
+    }
+    async get(path, params) {
+        const url = new URL(path, this.baseUrl);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                url.searchParams.set(key, value);
+            }
+        }
+        const response = await fetch(url.toString(), {
+            headers: this.getHeaders(),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        return response.json();
+    }
+    async post(path, body) {
+        const url = new URL(path, this.baseUrl);
+        const response = await fetch(url.toString(), {
+            method: "POST",
+            headers: this.getHeaders(true),
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        return response.json();
+    }
+    async put(path, body) {
+        const url = new URL(path, this.baseUrl);
+        const response = await fetch(url.toString(), {
+            method: "PUT",
+            headers: this.getHeaders(true),
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        return response.json();
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/utils/http.js.map

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

package/dist/utils/signing.d.ts

@@ -0,0 +1,43 @@
+/**
+ * EIP-712 signing helpers for rating payloads.
+ *
+ * Uses viem for typed-data signing and verification.
+ */
+import { type Hex } from "viem";
+export interface RatingPayloadMessage {
+    fromDid: string;
+    toDid: string;
+    score: number;
+    chainId: number | bigint;
+    powNonce: string;
+    powHash: string;
+    challengeId: string;
+}
+export interface SignedPayload {
+    payload: string;
+    signature: string;
+    signer: string;
+}
+/**
+ * Sign a rating payload using EIP-712 typed data signing.
+ *
+ * @param payload - The rating payload fields
+ * @param privateKey - Hex-encoded private key (with 0x prefix)
+ * @returns SignedPayload with JSON-encoded payload, signature, and signer address
+ */
+export declare function signRatingPayload(payload: RatingPayloadMessage, privateKey: string): Promise<SignedPayload>;
+/**
+ * Verify an EIP-712 signed rating payload.
+ *
+ * @param payload - JSON-encoded rating payload
+ * @param signature - Hex-encoded signature
+ * @param expectedSigner - Expected Ethereum address of the signer
+ * @returns true if the signature is valid and matches the expected signer
+ */
+export declare function verifyRatingSignature(payload: string, signature: string, expectedSigner: string): Promise<boolean>;
+/**
+ * Hash a rating payload using EIP-712 typed data hashing.
+ * Useful for on-chain verification where only the hash is needed.
+ */
+export declare function hashRatingPayload(payload: RatingPayloadMessage): Hex;
+//# sourceMappingURL=signing.d.ts.map

package/dist/utils/signing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signing.d.ts","sourceRoot":"","sources":["../../src/utils/signing.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAGL,KAAK,GAAG,EACT,MAAM,MAAM,CAAC;AAwBd,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,oBAAoB,EAC7B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,CAAC,CAexB;AAED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,GAAG,CAOpE"}

package/dist/utils/signing.js

@@ -0,0 +1,78 @@
+/**
+ * EIP-712 signing helpers for rating payloads.
+ *
+ * Uses viem for typed-data signing and verification.
+ */
+import { hashTypedData, recoverTypedDataAddress, } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+// EIP-712 domain for Aletheia Reputation (chainId required to prevent cross-chain replay)
+const getDomain = (chainId) => ({
+    name: "Aletheia Reputation",
+    version: "1",
+    chainId,
+});
+// Rating payload type definitions for EIP-712
+const RATING_TYPES = {
+    RatingPayload: [
+        { name: "fromDid", type: "string" },
+        { name: "toDid", type: "string" },
+        { name: "score", type: "uint8" },
+        { name: "chainId", type: "uint256" },
+        { name: "powNonce", type: "string" },
+        { name: "powHash", type: "string" },
+        { name: "challengeId", type: "string" },
+    ],
+};
+/**
+ * Sign a rating payload using EIP-712 typed data signing.
+ *
+ * @param payload - The rating payload fields
+ * @param privateKey - Hex-encoded private key (with 0x prefix)
+ * @returns SignedPayload with JSON-encoded payload, signature, and signer address
+ */
+export async function signRatingPayload(payload, privateKey) {
+    const account = privateKeyToAccount(privateKey);
+    const signature = await account.signTypedData({
+        domain: getDomain(Number(payload.chainId)),
+        types: RATING_TYPES,
+        primaryType: "RatingPayload",
+        message: { ...payload, chainId: BigInt(payload.chainId) },
+    });
+    return {
+        payload: JSON.stringify(payload),
+        signature,
+        signer: account.address,
+    };
+}
+/**
+ * Verify an EIP-712 signed rating payload.
+ *
+ * @param payload - JSON-encoded rating payload
+ * @param signature - Hex-encoded signature
+ * @param expectedSigner - Expected Ethereum address of the signer
+ * @returns true if the signature is valid and matches the expected signer
+ */
+export async function verifyRatingSignature(payload, signature, expectedSigner) {
+    const message = JSON.parse(payload);
+    const recoveredAddress = await recoverTypedDataAddress({
+        domain: getDomain(Number(message.chainId)),
+        types: RATING_TYPES,
+        primaryType: "RatingPayload",
+        message: { ...message, chainId: BigInt(message.chainId) },
+        signature: signature,
+    });
+    return recoveredAddress.toLowerCase() === expectedSigner.toLowerCase();
+}
+/**
+ * Hash a rating payload using EIP-712 typed data hashing.
+ * Useful for on-chain verification where only the hash is needed.
+ */
+export function hashRatingPayload(payload) {
+    return hashTypedData({
+        domain: getDomain(Number(payload.chainId)),
+        types: RATING_TYPES,
+        primaryType: "RatingPayload",
+        message: { ...payload, chainId: BigInt(payload.chainId) },
+    });
+}
+//# sourceMappingURL=signing.js.map

package/dist/utils/signing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signing.js","sourceRoot":"","sources":["../../src/utils/signing.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,aAAa,EACb,uBAAuB,GAExB,MAAM,MAAM,CAAC;AACd,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpD,0FAA0F;AAC1F,MAAM,SAAS,GAAG,CAAC,OAAe,EAAE,EAAE,CACpC,CAAC;IACC,IAAI,EAAE,qBAAqB;IAC3B,OAAO,EAAE,GAAG;IACZ,OAAO;CACR,CAAU,CAAC;AAEd,8CAA8C;AAC9C,MAAM,YAAY,GAAG;IACnB,aAAa,EAAE;QACb,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE;QACnC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE;QACjC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE;QAChC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;QACpC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;QACpC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE;QACnC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE;KACxC;CACO,CAAC;AAkBX;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAA6B,EAC7B,UAAkB;IAElB,MAAM,OAAO,GAAG,mBAAmB,CAAC,UAAiB,CAAC,CAAC;IAEvD,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC;QAC5C,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1C,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,eAAe;QAC5B,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;KAC1D,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;QAChC,SAAS;QACT,MAAM,EAAE,OAAO,CAAC,OAAO;KACxB,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAe,EACf,SAAiB,EACjB,cAAsB;IAEtB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAyB,CAAC;IAE5D,MAAM,gBAAgB,GAAG,MAAM,uBAAuB,CAAC;QACrD,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1C,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,eAAe;QAC5B,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;QACzD,SAAS,EAAE,SAAgB;KAC5B,CAAC,CAAC;IAEH,OAAO,gBAAgB,CAAC,WAAW,EAAE,KAAK,cAAc,CAAC,WAAW,EAAE,CAAC;AACzE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA6B;IAC7D,OAAO,aAAa,CAAC;QACnB,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1C,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,eAAe;QAC5B,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;KAC1D,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@a2aletheia/sdk",
+  "version": "0.2.0",
+  "description": "SDK for integrating with the Aletheia A2A Agent Discovery Registry",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./agent": {
+      "types": "./dist/agent/index.d.ts",
+      "default": "./dist/agent/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "a2a",
+    "agent",
+    "discovery",
+    "aletheia",
+    "multi-agent",
+    "ai-agents"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/weedeej/aletheia"
+  },
+  "dependencies": {
+    "@a2a-js/sdk": "^0.2.5",
+    "@noble/ed25519": "^2.1.0",
+    "@noble/hashes": "^2.0.1",
+    "viem": "^2.21.0",
+    "@a2aletheia/types": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "rimraf": "^6.0.1",
+    "@types/node": "^20",
+    "typescript": "^5.9.2",
+    "vitest": "^2.1.0",
+    "@a2aletheia/base-typescript-config": "0.0.0"
+  },
+  "peerDependencies": {
+    "express": ">=4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "express": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "check-types": "tsc --noEmit",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "clean": "rimraf dist"
+  }
+}