@a2aletheia/sdk 0.2.0

package/README.md

@@ -0,0 +1,436 @@
+# @a2aletheia/sdk
+
+SDK for integrating with the **Aletheia A2A Agent Discovery Registry**.
+
+Aletheia is a discovery layer for [A2A (Agent-to-Agent)](https://google.github.io/A2A/) compatible agents, enabling agents to find each other by capabilities, establish trust scores, and communicate securely.
+
+## Installation
+
+```bash
+npm install @a2aletheia/sdk
+# or
+pnpm add @a2aletheia/sdk
+# or
+yarn add @a2aletheia/sdk
+```
+
+## Quick Start
+
+```typescript
+import { AletheiaClient } from "@a2aletheia/sdk";
+
+// Initialize the client
+const aletheia = new AletheiaClient({
+  apiUrl: "https://aletheia.example.com",
+});
+
+// Discover agents by capability
+const agents = await aletheia.discoverAgents({
+  capability: "define-word",
+  isLive: true,
+  limit: 5,
+});
+
+console.log(
+  `Found ${agents.items.length} agents with word definition capability`,
+);
+
+// Get agent details
+const agent = await aletheia.getAgent("did:web:example.com");
+console.log(`Agent: ${agent.name} at ${agent.url}`);
+```
+
+## API Reference
+
+### Initialization
+
+```typescript
+const aletheia = new AletheiaClient({
+  apiUrl: string;    // Aletheia registry URL
+  chainId?: number;  // Optional: blockchain chain ID for SIWE
+});
+```
+
+### Discovery
+
+#### `discoverAgents(params)`
+
+Find agents by capability, trust score, or other criteria.
+
+```typescript
+const result = await aletheia.discoverAgents({
+  capability?: string;       // Filter by capability ID
+  query?: string;            // Search by name/description
+  minTrustScore?: number;    // Minimum trust score (0-100)
+  isLive?: boolean;          // Only return live agents
+  limit?: number;            // Max results to return
+});
+
+// Returns: { items: Agent[], total: number, page: number, limit: number }
+```
+
+#### `searchAgents(params)`
+
+Search agents with more filtering options.
+
+```typescript
+const result = await aletheia.searchAgents({
+  query?: string;
+  status?: "active" | "inactive" | "suspended" | "pending";
+  page?: number;
+  limit?: number;
+});
+```
+
+### Agent Registration
+
+#### `registerAgent(manifestUrl, ownerAddress?)`
+
+Register a new agent with the registry.
+
+```typescript
+const agent = await aletheia.registerAgent(
+  "https://my-agent.example.com/.well-known/agent.json",
+  "0x1234...", // Optional: owner wallet address
+);
+```
+
+#### `getAgent(did)`
+
+Get an agent by its DID.
+
+```typescript
+const agent = await aletheia.getAgent("did:web:my-agent.example.com");
+```
+
+### Liveness
+
+#### `checkLiveness(did)`
+
+Check if an agent is currently live/reachable.
+
+```typescript
+const isLive = await aletheia.checkLiveness("did:web:my-agent.example.com");
+```
+
+### Identity
+
+#### `resolveDID(did)`
+
+Resolve a DID to get its DID Document.
+
+```typescript
+const didDocument = await aletheia.resolveDID("did:web:example.com");
+```
+
+#### `fetchManifest(baseUrl)`
+
+Fetch an agent's A2A manifest (Agent Card).
+
+```typescript
+const manifest = await aletheia.fetchManifest("https://my-agent.example.com");
+```
+
+### Agent Message Signing & Verification
+
+The SDK provides Ed25519 cryptographic signing for secure agent-to-agent authentication. This allows agents to prove their identity when communicating with each other.
+
+#### Generate a Key Pair
+
+```typescript
+import { generateAgentKeyPair } from "@a2aletheia/sdk";
+
+const keys = await generateAgentKeyPair();
+console.log(keys.didKey); // did:key:z6Mk...
+
+// Store keys.privateKey securely! Never share it.
+// Include keys.publicKeyMultibase in your DID document
+```
+
+#### Sign Messages
+
+```typescript
+import { signAgentMessage } from "@a2aletheia/sdk";
+
+const signedMessage = await signAgentMessage(
+  { action: "book", hotelId: "123" }, // Your payload
+  keys.privateKey,
+  keys.didKey, // or your did:web
+);
+
+// signedMessage contains: { payload, signature, signer, timestamp }
+```
+
+#### Verify Messages (with Public Key)
+
+```typescript
+import { verifyAgentSignature } from "@a2aletheia/sdk";
+
+const isValid = await verifyAgentSignature(signedMessage, publicKeyHex);
+```
+
+#### Verify Messages (with DID Resolution)
+
+The recommended way to verify agent messages - automatically resolves the signer's DID and verifies against their published public key:
+
+```typescript
+// Using the client (recommended)
+const result = await aletheia.verifyAgentMessage(signedMessage);
+if (!result.valid) {
+  throw new Error(`Verification failed: ${result.error}`);
+}
+console.log(`Verified message from ${result.didDocument?.id}`);
+
+// Or using the low-level function
+import { verifyAgentMessageWithDID } from "@a2aletheia/sdk";
+
+const didDocument = await aletheia.resolveDID(signedMessage.signer);
+const isValid = await verifyAgentMessageWithDID(signedMessage, didDocument);
+```
+
+#### End-to-End Example: Agent Authentication
+
+```typescript
+// === AGENT SIDE (the one proving identity) ===
+
+// 1. Generate keys (do this once, store securely)
+const keys = await generateAgentKeyPair();
+
+// 2. Publish public key in your DID document at:
+//    https://your-agent.com/.well-known/did.json
+const didDocument = {
+  "@context": ["https://www.w3.org/ns/did/v1"],
+  id: "did:web:your-agent.com",
+  verificationMethod: [
+    {
+      id: "did:web:your-agent.com#key-1",
+      type: "Ed25519VerificationKey2020",
+      controller: "did:web:your-agent.com",
+      publicKeyMultibase: keys.publicKeyMultibase,
+    },
+  ],
+  authentication: ["did:web:your-agent.com#key-1"],
+};
+
+// 3. Sign outgoing messages
+const signedResponse = await signAgentMessage(
+  { result: "booking confirmed", confirmationId: "ABC123" },
+  keys.privateKey,
+  "did:web:your-agent.com",
+);
+
+// === CLIENT SIDE (the one verifying) ===
+
+// 4. Receive and verify the signed message
+const verification = await aletheia.verifyAgentMessage(signedResponse);
+if (!verification.valid) {
+  throw new Error("Message not from the claimed agent!");
+}
+
+// Now we know this message really came from did:web:your-agent.com
+console.log("Verified response:", signedResponse.payload);
+```
+
+### Authentication (SIWE)
+
+The SDK supports Sign-In with Ethereum (SIWE) for authenticated actions.
+
+```typescript
+// Get a nonce for signing
+const nonce = await aletheia.getNonce();
+
+// Sign the message with your wallet (using viem, ethers, etc.)
+const message = createSiweMessage({ nonce, address, ... });
+const signature = await wallet.signMessage(message);
+
+// Verify and get session token
+const { sessionToken } = await aletheia.verifySiwe(message, signature);
+
+// Set auth token for subsequent requests
+aletheia.setAuthToken(sessionToken);
+```
+
+## Types & Exports
+
+The SDK exports types and utilities:
+
+```typescript
+// Main client
+import { AletheiaClient } from "@a2aletheia/sdk";
+
+// Identity utilities
+import {
+  DIDResolver,
+  ManifestFetcher,
+  generateAgentKeyPair,
+  signAgentMessage,
+  verifyAgentSignature,
+  verifyAgentMessageWithDID,
+} from "@a2aletheia/sdk";
+
+// Types
+import type {
+  AletheiaClientConfig,
+  AgentKeyPair,
+  SignedMessage,
+} from "@a2aletheia/sdk";
+
+// Re-exported from @a2aletheia/base-types
+import type {
+  Agent,
+  AgentManifest,
+  DID,
+  DIDDocument,
+  TrustScore,
+  // ... etc
+} from "@a2aletheia/base-types";
+```
+
+## LLM Agent Tools
+
+The SDK ships four deterministic utility tools that LLM agents commonly need. Each tool is exported as an **OpenAI-compatible tool definition** with an `execute` function, making them directly usable with LangChain, Vercel AI SDK, CrewAI, or any OpenAI function-calling compatible framework.
+
+### Quick Start — Plug into your agent framework
+
+```typescript
+import {
+  aletheiaToolDefinitions,
+  aletheiaToolExecutors,
+} from "@a2aletheia/sdk";
+
+// Pass definitions to your LLM (OpenAI function calling format)
+const response = await openai.chat.completions.create({
+  model: "gpt-4",
+  tools: aletheiaToolDefinitions.map((t) => ({
+    type: t.type,
+    function: t.function,
+  })),
+  messages,
+});
+
+// Route tool calls back to the matching executor
+for (const call of response.choices[0].message.tool_calls ?? []) {
+  const result = aletheiaToolExecutors[call.function.name]?.(
+    JSON.parse(call.function.arguments),
+  );
+  console.log(result);
+}
+```
+
+### Available Tools
+
+| Tool                           | Name               | Description                                                                                                                                                                                                                     |
+| ------------------------------ | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `calculatorToolDefinition`     | `calculator`       | Safe math expression evaluator (recursive descent parser, no eval). Supports `+ - * / % **`, parentheses, functions (`sqrt`, `abs`, `ceil`, `floor`, `round`, `min`, `max`, `log`, `sin`, `cos`, `tan`), constants (`PI`, `E`). |
+| `getCurrentTimeToolDefinition` | `get_current_time` | Returns current time in ISO 8601, Unix timestamp (s/ms), and UTC string.                                                                                                                                                        |
+| `convertUnitsToolDefinition`   | `convert_units`    | Convert between units in the same category: crypto (wei/gwei/ether with bigint precision via viem), time (seconds/minutes/hours/days), data (bytes/KB/MB/GB/TB).                                                                |
+| `uuidGeneratorToolDefinition`  | `uuid_generator`   | Generate a random UUID v4 via `crypto.randomUUID()`.                                                                                                                                                                            |
+
+### Using individual tools directly
+
+```typescript
+import {
+  calculate,
+  getCurrentTime,
+  convertUnits,
+  generateUUID,
+} from "@a2aletheia/sdk";
+
+calculate("2 ** 10 + sqrt(144)");
+// { tool: "calculator", input: "2 ** 10 + sqrt(144)", result: 1036 }
+
+getCurrentTime();
+// { tool: "get_current_time", iso8601: "2025-...", unixTimestamp: 1735..., ... }
+
+convertUnits("1.5", "ether", "wei");
+// { tool: "convert_units", result: "1500000000000000000", category: "crypto", ... }
+
+generateUUID();
+// { tool: "uuid_generator", uuid: "550e8400-...", version: 4 }
+```
+
+## Agent-to-Agent Communication
+
+`@a2aletheia/sdk` covers agent **hosting** (receiving inbound A2A messages) and **registry access** (discovery, registration, reputation). To initiate **outbound** communication with other agents on the Aletheia network — with trust-verified discovery, liveness gating, and trust score thresholds — use [`@a2aletheia/a2a`](https://www.npmjs.com/package/@a2aletheia/a2a):
+
+```bash
+pnpm add @a2aletheia/a2a
+```
+
+| Capability                                    | `@a2aletheia/sdk` | `@a2aletheia/a2a`           |
+| --------------------------------------------- | ----------------- | --------------------------- |
+| Host an A2A agent (receive messages)          | `AletheiaAgent`   | `PeerAgent`                 |
+| Registry client (discover, register, ratings) | `AletheiaClient`  | --                          |
+| Send messages to other agents                 | --                | `AletheiaA2A` / `PeerAgent` |
+| Trust pipeline (DID + liveness + score gates) | --                | Built-in                    |
+
+### Inbound-only agent (SDK)
+
+```typescript
+import { AletheiaAgent } from "@a2aletheia/sdk/agent";
+
+const agent = new AletheiaAgent({
+  name: "MyAgent",
+  version: "1.0.0",
+  url: "https://my-agent.example.com",
+  description: "Handles inbound requests",
+  skills: [
+    {
+      id: "summarize",
+      name: "Summarize",
+      description: "Summarize text",
+      tags: [],
+    },
+  ],
+});
+
+agent.handle(async (context, response) => {
+  response.text(`You said: ${context.textContent}`);
+});
+
+await agent.start(4000);
+```
+
+### Full-duplex peer (A2A) — receive AND send
+
+```typescript
+import { PeerAgent } from "@a2aletheia/a2a";
+
+const peer = new PeerAgent({
+  registryUrl: "https://registry.aletheia.dev",
+  name: "MyAgent",
+  version: "1.0.0",
+  url: "https://my-agent.example.com",
+  description: "Can reach out to other agents",
+  skills: [
+    {
+      id: "orchestrate",
+      name: "Orchestrate",
+      description: "Orchestrate tasks",
+      tags: [],
+    },
+  ],
+  minTrustScore: 0.5,
+});
+
+peer.handle(async (context, response) => {
+  // Delegate to another agent on the network
+  const result = await peer.sendByCapability("translate", context.textContent);
+  response.text(`Translated via ${result.agentName}`);
+});
+
+await peer.start(4000);
+```
+
+See the [`@a2aletheia/a2a` README](https://www.npmjs.com/package/@a2aletheia/a2a) for the full API reference.
+
+## Roadmap
+
+- **Phase 1** ✅ Identity & Discovery
+- **Phase 2** ✅ Reputation & Trust Scores
+- **Phase 3** 🚧 Security Audits
+- **Phase 4** 🚧 Payments & Staking
+
+## License
+
+MIT

package/dist/__tests__/pow-solver.test.d.ts

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

package/dist/__tests__/pow-solver.test.d.ts.map

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

package/dist/__tests__/pow-solver.test.js

@@ -0,0 +1,35 @@
+import { describe, it, expect } from "vitest";
+import { solvePoWChallenge } from "../reputation/pow-solver.js";
+describe("PoW Solver", () => {
+    it("solves a challenge with low difficulty", async () => {
+        const result = await solvePoWChallenge("test-challenge", 8);
+        expect(result.nonce).toBeDefined();
+        expect(result.hash).toMatch(/^0x[0-9a-f]{64}$/);
+        // Verify 8 leading zero bits (first 2 hex chars must be "00")
+        const hex = result.hash.slice(2);
+        expect(hex.slice(0, 2)).toBe("00");
+    });
+    it("returns valid hash format", async () => {
+        const result = await solvePoWChallenge("another-challenge", 4);
+        expect(result.hash).toMatch(/^0x[0-9a-f]{64}$/);
+        expect(typeof result.nonce).toBe("string");
+    });
+    it("hash meets the specified difficulty", async () => {
+        const difficulty = 12;
+        const result = await solvePoWChallenge("difficulty-test", difficulty);
+        // 12 bits = first 3 hex chars must represent values with 12 leading zero bits
+        // That means first byte (2 hex chars) = 0x00, second byte top 4 bits = 0
+        const hex = result.hash.slice(2);
+        const firstByte = parseInt(hex.slice(0, 2), 16);
+        const secondByte = parseInt(hex.slice(2, 4), 16);
+        expect(firstByte).toBe(0);
+        expect(secondByte >> 4).toBe(0); // top 4 bits of second byte = 0
+    });
+    it("different challenges produce different results", async () => {
+        const result1 = await solvePoWChallenge("challenge-a", 4);
+        const result2 = await solvePoWChallenge("challenge-b", 4);
+        // Hashes should differ (extremely unlikely to match)
+        expect(result1.hash).not.toBe(result2.hash);
+    });
+});
+//# sourceMappingURL=pow-solver.test.js.map

package/dist/__tests__/pow-solver.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pow-solver.test.js","sourceRoot":"","sources":["../../src/__tests__/pow-solver.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEhE,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC;QAE5D,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QAEhD,8DAA8D;QAC9D,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;QACzC,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC;QAE/D,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QAChD,MAAM,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,UAAU,GAAG,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,iBAAiB,EAAE,UAAU,CAAC,CAAC;QAEtE,8EAA8E;QAC9E,yEAAyE;QACzE,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChD,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAEjD,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,gCAAgC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QAC1D,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QAE1D,qDAAqD;QACrD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

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

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

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

package/dist/__tests__/signing.test.js

@@ -0,0 +1,59 @@
+import { describe, it, expect } from "vitest";
+import { generatePrivateKey } from "viem/accounts";
+import { signRatingPayload, verifyRatingSignature, hashRatingPayload, } from "../utils/signing.js";
+const TEST_PAYLOAD = {
+    fromDid: "did:pkh:eip155:1:0x1234567890abcdef1234567890abcdef12345678",
+    toDid: "did:web:agent.example.com",
+    score: 4,
+    chainId: 1,
+    powNonce: "ff",
+    powHash: "0x0000abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234",
+    challengeId: "test-challenge-id",
+};
+describe("EIP-712 Rating Signing", () => {
+    it("signRatingPayload + verifyRatingSignature round-trip", async () => {
+        const privateKey = generatePrivateKey();
+        const signed = await signRatingPayload(TEST_PAYLOAD, privateKey);
+        expect(signed.payload).toBeDefined();
+        expect(signed.signature).toMatch(/^0x[0-9a-fA-F]+$/);
+        expect(signed.signer).toMatch(/^0x[0-9a-fA-F]{40}$/);
+        const valid = await verifyRatingSignature(signed.payload, signed.signature, signed.signer);
+        expect(valid).toBe(true);
+    });
+    it("verifyRatingSignature rejects wrong signer", async () => {
+        const privateKey = generatePrivateKey();
+        const signed = await signRatingPayload(TEST_PAYLOAD, privateKey);
+        // Use a different address as expected signer
+        const wrongSigner = "0x0000000000000000000000000000000000000001";
+        const valid = await verifyRatingSignature(signed.payload, signed.signature, wrongSigner);
+        expect(valid).toBe(false);
+    });
+    it("hashRatingPayload returns consistent hash", () => {
+        const hash1 = hashRatingPayload(TEST_PAYLOAD);
+        const hash2 = hashRatingPayload(TEST_PAYLOAD);
+        expect(hash1).toBe(hash2);
+        expect(hash1).toMatch(/^0x[0-9a-fA-F]{64}$/);
+    });
+    it("hashRatingPayload changes with different inputs", () => {
+        const hash1 = hashRatingPayload(TEST_PAYLOAD);
+        const hash2 = hashRatingPayload({ ...TEST_PAYLOAD, score: 3 });
+        expect(hash1).not.toBe(hash2);
+    });
+    it("includes chainId in signature verification", async () => {
+        const privateKey = generatePrivateKey();
+        const signed = await signRatingPayload(TEST_PAYLOAD, privateKey);
+        // Tamper with chainId in the payload
+        const parsed = JSON.parse(signed.payload);
+        parsed.chainId = 999;
+        const tampered = JSON.stringify(parsed);
+        const valid = await verifyRatingSignature(tampered, signed.signature, signed.signer);
+        expect(valid).toBe(false);
+    });
+    it("signature changes with different chainId", async () => {
+        const privateKey = generatePrivateKey();
+        const signed1 = await signRatingPayload(TEST_PAYLOAD, privateKey);
+        const signed2 = await signRatingPayload({ ...TEST_PAYLOAD, chainId: 137 }, privateKey);
+        expect(signed1.signature).not.toBe(signed2.signature);
+    });
+});
+//# sourceMappingURL=signing.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signing.test.js","sourceRoot":"","sources":["../../src/__tests__/signing.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,GAElB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,YAAY,GAAyB;IACzC,OAAO,EAAE,6DAA6D;IACtE,KAAK,EAAE,2BAA2B;IAClC,KAAK,EAAE,CAAC;IACR,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,IAAI;IACd,OAAO,EAAE,kEAAkE;IAC3E,WAAW,EAAE,mBAAmB;CACjC,CAAC;AAEF,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,UAAU,GAAG,kBAAkB,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QAEjE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;QAErD,MAAM,KAAK,GAAG,MAAM,qBAAqB,CACvC,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,SAAS,EAChB,MAAM,CAAC,MAAM,CACd,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,UAAU,GAAG,kBAAkB,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QAEjE,6CAA6C;QAC7C,MAAM,WAAW,GAAG,4CAA4C,CAAC;QACjE,MAAM,KAAK,GAAG,MAAM,qBAAqB,CACvC,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,SAAS,EAChB,WAAW,CACZ,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,KAAK,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;QAE9C,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,KAAK,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,iBAAiB,CAAC,EAAE,GAAG,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAE/D,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,UAAU,GAAG,kBAAkB,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QAEjE,qCAAqC;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC1C,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC;QACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAExC,MAAM,KAAK,GAAG,MAAM,qBAAqB,CACvC,QAAQ,EACR,MAAM,CAAC,SAAS,EAChB,MAAM,CAAC,MAAM,CACd,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,UAAU,GAAG,kBAAkB,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QAClE,MAAM,OAAO,GAAG,MAAM,iBAAiB,CACrC,EAAE,GAAG,YAAY,EAAE,OAAO,EAAE,GAAG,EAAE,EACjC,UAAU,CACX,CAAC;QAEF,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/agent/agent-context.d.ts

@@ -0,0 +1,26 @@
+import type { Message, Task, Part } from "@a2a-js/sdk";
+import { RequestContext } from "@a2a-js/sdk/server";
+import type { AgentContext } from "./types.js";
+/**
+ * Extended RequestContext with helper methods for accessing message content.
+ */
+export declare class AgentContextImpl extends RequestContext implements AgentContext {
+    constructor(userMessage: Message, taskId: string, contextId: string, task?: Task, referenceTasks?: Task[]);
+    /**
+     * Access the raw message parts.
+     */
+    get parts(): Part[];
+    /**
+     * Extracts all text from message parts, joined with newlines.
+     */
+    get textContent(): string;
+    /**
+     * Extracts the first data part's data, or null if none.
+     */
+    get dataContent(): Record<string, unknown> | null;
+    /**
+     * Create an AgentContext from a RequestContext.
+     */
+    static from(context: RequestContext): AgentContextImpl;
+}
+//# sourceMappingURL=agent-context.d.ts.map

package/dist/agent/agent-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-context.d.ts","sourceRoot":"","sources":["../../src/agent/agent-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;GAEG;AACH,qBAAa,gBACX,SAAQ,cACR,YAAW,YAAY;gBAGrB,WAAW,EAAE,OAAO,EACpB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,IAAI,EACX,cAAc,CAAC,EAAE,IAAI,EAAE;IAKzB;;OAEG;IACH,IAAI,KAAK,IAAI,IAAI,EAAE,CAElB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAKxB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAKhD;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,gBAAgB;CASvD"}

package/dist/agent/agent-context.js

@@ -0,0 +1,38 @@
+import { RequestContext } from "@a2a-js/sdk/server";
+/**
+ * Extended RequestContext with helper methods for accessing message content.
+ */
+export class AgentContextImpl extends RequestContext {
+    constructor(userMessage, taskId, contextId, task, referenceTasks) {
+        super(userMessage, taskId, contextId, task, referenceTasks);
+    }
+    /**
+     * Access the raw message parts.
+     */
+    get parts() {
+        return this.userMessage.parts;
+    }
+    /**
+     * Extracts all text from message parts, joined with newlines.
+     */
+    get textContent() {
+        return this.userMessage.parts
+            .filter((part) => part.kind === "text")
+            .map((part) => part.text)
+            .join("\n");
+    }
+    /**
+     * Extracts the first data part's data, or null if none.
+     */
+    get dataContent() {
+        const dataPart = this.userMessage.parts.find((part) => part.kind === "data");
+        return dataPart?.data ?? null;
+    }
+    /**
+     * Create an AgentContext from a RequestContext.
+     */
+    static from(context) {
+        return new AgentContextImpl(context.userMessage, context.taskId, context.contextId, context.task, context.referenceTasks);
+    }
+}
+//# sourceMappingURL=agent-context.js.map

package/dist/agent/agent-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-context.js","sourceRoot":"","sources":["../../src/agent/agent-context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD;;GAEG;AACH,MAAM,OAAO,gBACX,SAAQ,cAAc;IAGtB,YACE,WAAoB,EACpB,MAAc,EACd,SAAiB,EACjB,IAAW,EACX,cAAuB;QAEvB,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK;aAC1B,MAAM,CAAC,CAAC,IAAI,EAAmC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;aACvE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;aACxB,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,IAAI,WAAW;QACb,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAC1C,CAAC,IAAI,EAAmC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAChE,CAAC;QACF,OAAO,QAAQ,EAAE,IAAI,IAAI,IAAI,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,OAAuB;QACjC,OAAO,IAAI,gBAAgB,CACzB,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,IAAI,EACZ,OAAO,CAAC,cAAc,CACvB,CAAC;IACJ,CAAC;CACF"}

package/dist/agent/agent-executor.d.ts

@@ -0,0 +1,17 @@
+import type { AgentExecutor, ExecutionEventBus, RequestContext } from "@a2a-js/sdk/server";
+import type { AletheiaLogger } from "@a2aletheia/types";
+import type { AgentHandler, CancelHandler } from "./types.js";
+import type { EventEmitter } from "../logger/event-emitter.js";
+/**
+ * Bridges the functional handler pattern to the @a2a-js AgentExecutor interface.
+ */
+export declare class DelegatingAgentExecutor implements AgentExecutor {
+    private getHandler;
+    private getCancelHandler;
+    private readonly logger;
+    private readonly events;
+    constructor(getHandler: () => AgentHandler | undefined, getCancelHandler: () => CancelHandler | undefined, logger: AletheiaLogger, events: EventEmitter);
+    execute(context: RequestContext, eventBus: ExecutionEventBus): Promise<void>;
+    cancelTask(taskId: string, eventBus: ExecutionEventBus): Promise<void>;
+}
+//# sourceMappingURL=agent-executor.d.ts.map

package/dist/agent/agent-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-executor.d.ts","sourceRoot":"","sources":["../../src/agent/agent-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,cAAc,EACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAI/D;;GAEG;AACH,qBAAa,uBAAwB,YAAW,aAAa;IAEzD,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAHf,UAAU,EAAE,MAAM,YAAY,GAAG,SAAS,EAC1C,gBAAgB,EAAE,MAAM,aAAa,GAAG,SAAS,EACxC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,YAAY;IAGjC,OAAO,CACX,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,iBAAiB,GAC1B,OAAO,CAAC,IAAI,CAAC;IA2DV,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;CAwB7E"}