@a2aletheia/sdk 0.2.0

package/dist/agent/agent-executor.js

@@ -0,0 +1,91 @@
+import { AgentContextImpl } from "./agent-context.js";
+import { AgentResponse } from "./agent-response.js";
+/**
+ * Bridges the functional handler pattern to the @a2a-js AgentExecutor interface.
+ */
+export class DelegatingAgentExecutor {
+    getHandler;
+    getCancelHandler;
+    logger;
+    events;
+    constructor(getHandler, getCancelHandler, logger, events) {
+        this.getHandler = getHandler;
+        this.getCancelHandler = getCancelHandler;
+        this.logger = logger;
+        this.events = events;
+    }
+    async execute(context, eventBus) {
+        const handler = this.getHandler();
+        if (!handler) {
+            throw new Error("No message handler registered. Call agent.handle() first.");
+        }
+        const agentContext = AgentContextImpl.from(context);
+        const response = new AgentResponse(context, eventBus);
+        this.logger.debug("Message received", {
+            taskId: context.taskId,
+            contextId: context.contextId,
+        });
+        this.events.emit("message.received", {
+            taskId: context.taskId,
+            contextId: context.contextId,
+        });
+        try {
+            await handler(agentContext, response);
+            // Ensure finished is called if handler didn't finalize
+            if (!response.isFinished) {
+                eventBus.finished();
+            }
+            this.logger.debug("Message handled", {
+                taskId: context.taskId,
+                contextId: context.contextId,
+            });
+            this.events.emit("message.sent", {
+                taskId: context.taskId,
+                contextId: context.contextId,
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger.error("Handler error", {
+                taskId: context.taskId,
+                error: errorMessage,
+            });
+            this.events.emit("message.failed", {
+                taskId: context.taskId,
+                error: errorMessage,
+            });
+            // Publish failure if not already finalized
+            if (!response.isFinished) {
+                response.fail(`Handler error: ${errorMessage}`);
+            }
+            else {
+                // Re-throw if already finished (shouldn't happen normally)
+                throw error;
+            }
+        }
+    }
+    async cancelTask(taskId, eventBus) {
+        const handler = this.getCancelHandler();
+        const response = new AgentResponse(null, eventBus);
+        if (handler) {
+            try {
+                await handler(taskId, response);
+                // Ensure finished is called
+                if (!response.isFinished) {
+                    response.canceled();
+                }
+            }
+            catch (error) {
+                if (!response.isFinished) {
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    response.fail(`Cancel handler error: ${errorMessage}`);
+                }
+            }
+        }
+        else {
+            // Default: publish canceled status
+            response.canceled();
+        }
+    }
+}
+//# sourceMappingURL=agent-executor.js.map

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

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

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

@@ -0,0 +1,63 @@
+import type { ExecutionEventBus, RequestContext } from "@a2a-js/sdk/server";
+import type { Part, Artifact } from "@a2a-js/sdk";
+/**
+ * Response helper that wraps ExecutionEventBus with convenience methods.
+ */
+export declare class AgentResponse {
+    readonly context: RequestContext | null;
+    readonly eventBus: ExecutionEventBus;
+    private _isFinished;
+    private _taskSeeded;
+    constructor(context: RequestContext | null, eventBus: ExecutionEventBus);
+    /**
+     * Whether the response has been finalized.
+     */
+    get isFinished(): boolean;
+    /**
+     * Send a text response and complete the request.
+     */
+    text(content: string): void;
+    /**
+     * Send a data response and complete the request.
+     */
+    data(data: Record<string, unknown>): void;
+    /**
+     * Send a message with custom parts and complete the request.
+     */
+    message(parts: Part[]): void;
+    /**
+     * Publish a "working" status update (non-final).
+     */
+    working(message?: string): void;
+    /**
+     * Publish an artifact update.
+     */
+    artifact(artifact: Artifact, options?: {
+        append?: boolean;
+        lastChunk?: boolean;
+    }): void;
+    /**
+     * Publish a "completed" status and finalize.
+     */
+    done(message?: string): void;
+    /**
+     * Publish a "failed" status and finalize.
+     */
+    fail(error: string): void;
+    /**
+     * Publish a "canceled" status and finalize.
+     */
+    canceled(): void;
+    /**
+     * Publish an "input-required" status (non-final by default).
+     */
+    inputRequired(message: string): void;
+    /**
+     * Emit a Task event to initialize the ResultManager's state.
+     * Called once before the first status-update/artifact-update so the
+     * ResultManager can match subsequent events by taskId.
+     */
+    private _seedTask;
+    private _finish;
+}
+//# sourceMappingURL=agent-response.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-response.d.ts","sourceRoot":"","sources":["../../src/agent/agent-response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAElD;;GAEG;AACH,qBAAa,aAAa;IAKtB,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IACvC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB;IALtC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;gBAGjB,OAAO,EAAE,cAAc,GAAG,IAAI,EAC9B,QAAQ,EAAE,iBAAiB;IAGtC;;OAEG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAMD;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAY3B;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAYzC;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI;IAgB5B;;OAEG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAwB/B;;OAEG;IACH,QAAQ,CACN,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAClD,IAAI;IAYP;;OAEG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAqB5B;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAmBzB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAWhB;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAuBpC;;;;OAIG;IACH,OAAO,CAAC,SAAS;IAejB,OAAO,CAAC,OAAO;CAIhB"}

package/dist/agent/agent-response.js

@@ -0,0 +1,211 @@
+/**
+ * Response helper that wraps ExecutionEventBus with convenience methods.
+ */
+export class AgentResponse {
+    context;
+    eventBus;
+    _isFinished = false;
+    _taskSeeded = false;
+    constructor(context, eventBus) {
+        this.context = context;
+        this.eventBus = eventBus;
+    }
+    /**
+     * Whether the response has been finalized.
+     */
+    get isFinished() {
+        return this._isFinished;
+    }
+    // ---------------------------------------------------------------------------
+    // Quick responses (publishes + finishes)
+    // ---------------------------------------------------------------------------
+    /**
+     * Send a text response and complete the request.
+     */
+    text(content) {
+        this.eventBus.publish({
+            kind: "message",
+            role: "agent",
+            messageId: crypto.randomUUID(),
+            parts: [{ kind: "text", text: content }],
+            contextId: this.context?.contextId ?? "",
+            taskId: this.context?.taskId,
+        });
+        this._finish();
+    }
+    /**
+     * Send a data response and complete the request.
+     */
+    data(data) {
+        this.eventBus.publish({
+            kind: "message",
+            role: "agent",
+            messageId: crypto.randomUUID(),
+            parts: [{ kind: "data", data }],
+            contextId: this.context?.contextId ?? "",
+            taskId: this.context?.taskId,
+        });
+        this._finish();
+    }
+    /**
+     * Send a message with custom parts and complete the request.
+     */
+    message(parts) {
+        this.eventBus.publish({
+            kind: "message",
+            role: "agent",
+            messageId: crypto.randomUUID(),
+            parts,
+            contextId: this.context?.contextId ?? "",
+            taskId: this.context?.taskId,
+        });
+        this._finish();
+    }
+    // ---------------------------------------------------------------------------
+    // Streaming responses (call done() or fail() at end)
+    // ---------------------------------------------------------------------------
+    /**
+     * Publish a "working" status update (non-final).
+     */
+    working(message) {
+        // Seed a Task event first so the ResultManager can track subsequent
+        // status-updates (avoids "unknown task" warnings from @a2a-js/sdk).
+        this._seedTask();
+        this.eventBus.publish({
+            kind: "status-update",
+            taskId: this.context?.taskId ?? "",
+            contextId: this.context?.contextId ?? "",
+            status: {
+                state: "working",
+                message: message
+                    ? {
+                        kind: "message",
+                        role: "agent",
+                        messageId: crypto.randomUUID(),
+                        parts: [{ kind: "text", text: message }],
+                    }
+                    : undefined,
+            },
+            final: false,
+        });
+    }
+    /**
+     * Publish an artifact update.
+     */
+    artifact(artifact, options) {
+        this._seedTask();
+        this.eventBus.publish({
+            kind: "artifact-update",
+            taskId: this.context?.taskId ?? "",
+            contextId: this.context?.contextId ?? "",
+            artifact,
+            append: options?.append,
+            lastChunk: options?.lastChunk,
+        });
+    }
+    /**
+     * Publish a "completed" status and finalize.
+     */
+    done(message) {
+        this.eventBus.publish({
+            kind: "status-update",
+            taskId: this.context?.taskId ?? "",
+            contextId: this.context?.contextId ?? "",
+            status: {
+                state: "completed",
+                message: message
+                    ? {
+                        kind: "message",
+                        role: "agent",
+                        messageId: crypto.randomUUID(),
+                        parts: [{ kind: "text", text: message }],
+                    }
+                    : undefined,
+            },
+            final: true,
+        });
+        this._finish();
+    }
+    /**
+     * Publish a "failed" status and finalize.
+     */
+    fail(error) {
+        this.eventBus.publish({
+            kind: "status-update",
+            taskId: this.context?.taskId ?? "",
+            contextId: this.context?.contextId ?? "",
+            status: {
+                state: "failed",
+                message: {
+                    kind: "message",
+                    role: "agent",
+                    messageId: crypto.randomUUID(),
+                    parts: [{ kind: "text", text: error }],
+                },
+            },
+            final: true,
+        });
+        this._finish();
+    }
+    /**
+     * Publish a "canceled" status and finalize.
+     */
+    canceled() {
+        this.eventBus.publish({
+            kind: "status-update",
+            taskId: this.context?.taskId ?? "",
+            contextId: this.context?.contextId ?? "",
+            status: { state: "canceled" },
+            final: true,
+        });
+        this._finish();
+    }
+    /**
+     * Publish an "input-required" status (non-final by default).
+     */
+    inputRequired(message) {
+        this._seedTask();
+        this.eventBus.publish({
+            kind: "status-update",
+            taskId: this.context?.taskId ?? "",
+            contextId: this.context?.contextId ?? "",
+            status: {
+                state: "input-required",
+                message: {
+                    kind: "message",
+                    role: "agent",
+                    messageId: crypto.randomUUID(),
+                    parts: [{ kind: "text", text: message }],
+                },
+            },
+            final: false,
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // Internal
+    // ---------------------------------------------------------------------------
+    /**
+     * Emit a Task event to initialize the ResultManager's state.
+     * Called once before the first status-update/artifact-update so the
+     * ResultManager can match subsequent events by taskId.
+     */
+    _seedTask() {
+        if (this._taskSeeded || !this.context)
+            return;
+        this._taskSeeded = true;
+        this.eventBus.publish({
+            kind: "task",
+            id: this.context.taskId,
+            contextId: this.context.contextId,
+            status: {
+                state: "working",
+                timestamp: new Date().toISOString(),
+            },
+        });
+    }
+    _finish() {
+        this._isFinished = true;
+        this.eventBus.finished();
+    }
+}
+//# sourceMappingURL=agent-response.js.map

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

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

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

@@ -0,0 +1,114 @@
+import type { AgentCard } from "@a2a-js/sdk";
+import { type TaskStore, type A2ARequestHandler } from "@a2a-js/sdk/server";
+import type { A2AResponse } from "@a2a-js/sdk";
+import type { AletheiaLogger, AletheiaEventType, AletheiaEventHandler } from "@a2aletheia/types";
+import type { AletheiaAgentConfig, AgentHandler, CancelHandler } from "./types.js";
+import { EventEmitter } from "../logger/event-emitter.js";
+/**
+ * AletheiaAgent provides a high-level API for building A2A-compliant agents
+ * with Aletheia trust layer integration.
+ *
+ * @example
+ * ```typescript
+ * import { AletheiaAgent } from "@a2aletheia/sdk";
+ *
+ * const agent = new AletheiaAgent({
+ *   name: "Translator",
+ *   version: "1.0.0",
+ *   url: "https://translate.example.com",
+ *   description: "Translates text between languages",
+ *   skills: [{
+ *     id: "translate",
+ *     name: "translate-text",
+ *     description: "Translate text to another language",
+ *     tags: ["translation", "nlp"],
+ *   }],
+ * });
+ *
+ * agent.handle(async (context, response) => {
+ *   const text = context.textContent;
+ *   response.text(`Translated: ${text}`);
+ * });
+ *
+ * await agent.start(4000);
+ * ```
+ */
+export declare class AletheiaAgent {
+    private readonly config;
+    private readonly agentCard;
+    private readonly taskStore;
+    private readonly requestHandler;
+    private readonly jsonRpcHandler;
+    private readonly executor;
+    readonly logger: AletheiaLogger;
+    readonly events: EventEmitter;
+    private messageHandler?;
+    private cancelHandler?;
+    private server?;
+    constructor(config: AletheiaAgentConfig);
+    /**
+     * Register the message handler for incoming requests.
+     */
+    handle(handler: AgentHandler): this;
+    /**
+     * Register an optional cancel handler.
+     */
+    onCancel(handler: CancelHandler): this;
+    /**
+     * Subscribe to lifecycle events. Returns an unsubscribe function.
+     *
+     * @example
+     * ```typescript
+     * agent.on("message.received", (event) => {
+     *   console.log("Received message", event.data);
+     * });
+     *
+     * // Wildcard — receive all events
+     * agent.on("*", (event) => {
+     *   metrics.increment(`aletheia.${event.type}`);
+     * });
+     * ```
+     */
+    on(event: AletheiaEventType | "*", handler: AletheiaEventHandler): () => void;
+    /**
+     * Handle a JSON-RPC request body (framework-agnostic).
+     * Use this for Hono, Fastify, or other frameworks.
+     *
+     * @param body - The parsed JSON-RPC request body
+     * @returns A2AResponse or AsyncGenerator<A2AResponse> for streaming
+     */
+    handleRequest(body: unknown): Promise<A2AResponse | AsyncGenerator<A2AResponse, void, undefined>>;
+    /**
+     * Start a standalone Express server.
+     *
+     * @param port - Port to listen on
+     * @returns Promise that resolves when server is listening
+     */
+    start(port: number): Promise<void>;
+    /**
+     * Stop the standalone server if running.
+     */
+    stop(): void;
+    /**
+     * Get the agent's AgentCard.
+     */
+    getAgentCard(): AgentCard;
+    /**
+     * Get the underlying request handler for custom integrations.
+     */
+    getRequestHandler(): A2ARequestHandler;
+    /**
+     * Get the task store.
+     */
+    getTaskStore(): TaskStore;
+    private buildAgentCard;
+    /**
+     * Get Aletheia-specific extensions.
+     */
+    getAletheiaExtensions(): import("./types.js").AletheiaExtensions | undefined;
+    /**
+     * Build a minimal W3C DID Document for did:web self-hosting.
+     */
+    private buildDIDDocument;
+}
+//# sourceMappingURL=aletheia-agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aletheia-agent.d.ts","sourceRoot":"","sources":["../../src/agent/aletheia-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAKL,KAAK,SAAS,EACd,KAAK,iBAAiB,EACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EACV,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACd,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoB;IACnD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA0B;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0B;IAEnD,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAE9B,OAAO,CAAC,cAAc,CAAC,CAAe;IACtC,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,MAAM,CAAC,CAAwB;gBAE3B,MAAM,EAAE,mBAAmB;IA2BvC;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAKnC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAStC;;;;;;;;;;;;;;OAcG;IACH,EAAE,CACA,KAAK,EAAE,iBAAiB,GAAG,GAAG,EAC9B,OAAO,EAAE,oBAAoB,GAC5B,MAAM,IAAI;IAQb;;;;;;OAMG;IACG,aAAa,CACjB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,WAAW,GAAG,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IAQtE;;;;;OAKG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCxC;;OAEG;IACH,IAAI,IAAI,IAAI;IAWZ;;OAEG;IACH,YAAY,IAAI,SAAS;IAIzB;;OAEG;IACH,iBAAiB,IAAI,iBAAiB;IAItC;;OAEG;IACH,YAAY,IAAI,SAAS;IAQzB,OAAO,CAAC,cAAc;IAqDtB;;OAEG;IACH,qBAAqB;IAIrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAiBzB"}