@a2aletheia/a2a 0.2.0

package/dist/peer-agent.d.ts

@@ -0,0 +1,144 @@
+import type { Agent } from "@a2aletheia/types";
+import type { AletheiaLogger, AletheiaLogLevel, AletheiaEventType, AletheiaEventHandler } from "@a2aletheia/types";
+import type { AgentCard, AgentSkill, AgentCapabilities, A2AResponse } from "@a2a-js/sdk";
+import type { TaskStore, A2ARequestHandler } from "@a2a-js/sdk/server";
+import { AletheiaAgent, type AletheiaExtensions, type AgentHandler, type CancelHandler } from "@a2aletheia/sdk/agent";
+import { AletheiaA2A } from "./aletheia-a2a.js";
+import type { AgentSelector, MessageInput, SendOptions, TrustedResponse, TrustedStreamEvent } from "./types.js";
+import type { TrustedAgent } from "./trusted-agent.js";
+export interface PeerAgentConfig {
+    registryUrl: string;
+    name: string;
+    version: string;
+    url: string;
+    description: string;
+    skills: AgentSkill[];
+    defaultInputModes?: string[];
+    defaultOutputModes?: string[];
+    capabilities?: Partial<AgentCapabilities>;
+    iconUrl?: string;
+    documentationUrl?: string;
+    provider?: {
+        organization: string;
+        url: string;
+    };
+    aletheiaExtensions?: AletheiaExtensions;
+    taskStore?: TaskStore;
+    agentSelector?: AgentSelector;
+    minTrustScore?: number;
+    requireLive?: boolean;
+    livenessCheckBeforeSend?: boolean;
+    verifyIdentity?: boolean;
+    authToken?: string;
+    logger?: AletheiaLogger;
+    logLevel?: AletheiaLogLevel;
+}
+/**
+ * A full-duplex peer that can both host an A2A agent (inbound) and
+ * send trust-verified requests to other agents (outbound).
+ *
+ * Composes `AletheiaAgent` (server) + `AletheiaA2A` (client).
+ *
+ * @example
+ * ```typescript
+ * import { PeerAgent } from "@a2aletheia/a2a";
+ *
+ * const peer = new PeerAgent({
+ *   registryUrl: "https://registry.aletheia.dev",
+ *   name: "Orchestrator",
+ *   version: "1.0.0",
+ *   url: "https://orchestrator.example.com",
+ *   description: "Routes work to specialist agents",
+ *   skills: [{ id: "orchestrate", name: "orchestrate", description: "Orchestrate tasks", tags: [] }],
+ *   minTrustScore: 0.7,
+ * });
+ *
+ * peer.handle(async (context, response) => {
+ *   // Use outbound client inside the handler
+ *   const result = await peer.sendByCapability("translate", context.textContent);
+ *   response.text(result.response);
+ * });
+ *
+ * await peer.start(4000);
+ * ```
+ */
+export declare class PeerAgent {
+    private readonly agent;
+    private readonly client;
+    constructor(config: PeerAgentConfig);
+    /**
+     * Register the message handler for incoming requests.
+     */
+    handle(handler: AgentHandler): this;
+    /**
+     * Register an optional cancel handler.
+     */
+    onCancel(handler: CancelHandler): this;
+    /**
+     * Handle a JSON-RPC request body (framework-agnostic).
+     */
+    handleRequest(body: unknown): Promise<A2AResponse | AsyncGenerator<A2AResponse, void, undefined>>;
+    /**
+     * Subscribe to lifecycle events. Returns an unsubscribe function.
+     */
+    on(event: AletheiaEventType | "*", handler: AletheiaEventHandler): () => void;
+    /**
+     * Discover agents by capability, query, or trust criteria.
+     */
+    discover(params: {
+        capability?: string;
+        query?: string;
+        isLive?: boolean;
+        minTrustScore?: number;
+        limit?: number;
+    }): Promise<Agent[]>;
+    /**
+     * Connect to an agent by DID with trust verification.
+     */
+    connect(did: string): Promise<TrustedAgent>;
+    /**
+     * Connect to an agent by URL (no trust verification).
+     */
+    connectByUrl(url: string): Promise<TrustedAgent>;
+    /**
+     * Discover, select, and send a message by capability.
+     */
+    sendByCapability(capability: string, input: string | MessageInput, options?: SendOptions): Promise<TrustedResponse>;
+    /**
+     * Discover, select, and stream a response by capability.
+     */
+    streamByCapability(capability: string, input: string | MessageInput, options?: SendOptions): AsyncGenerator<TrustedStreamEvent>;
+    /**
+     * Start a standalone Express server.
+     */
+    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;
+    /**
+     * Get Aletheia-specific extensions.
+     */
+    getAletheiaExtensions(): AletheiaExtensions | undefined;
+    /**
+     * Get the underlying AletheiaAgent (escape hatch).
+     */
+    getAgent(): AletheiaAgent;
+    /**
+     * Get the underlying AletheiaA2A client (escape hatch).
+     */
+    getClient(): AletheiaA2A;
+}
+//# sourceMappingURL=peer-agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"peer-agent.d.ts","sourceRoot":"","sources":["../src/peer-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,WAAW,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EACL,aAAa,EAEb,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,WAAW,EACX,eAAe,EACf,kBAAkB,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMvD,MAAM,WAAW,eAAe;IAE9B,WAAW,EAAE,MAAM,CAAC;IAGpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,SAAS,CAAC,EAAE,SAAS,CAAC;IAGtB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;gBAEzB,MAAM,EAAE,eAAe;IAuCnC;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAKnC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAKtC;;OAEG;IACG,aAAa,CACjB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,WAAW,GAAG,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IAQtE;;OAEG;IACH,EAAE,CACA,KAAK,EAAE,iBAAiB,GAAG,GAAG,EAC9B,OAAO,EAAE,oBAAoB,GAC5B,MAAM,IAAI;IAQb;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAIpB;;OAEG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAIjD;;OAEG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAItD;;OAEG;IACG,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GAAG,YAAY,EAC5B,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,eAAe,CAAC;IAI3B;;OAEG;IACI,kBAAkB,CACvB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GAAG,YAAY,EAC5B,OAAO,CAAC,EAAE,WAAW,GACpB,cAAc,CAAC,kBAAkB,CAAC;IAQrC;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC;;OAEG;IACH,IAAI,IAAI,IAAI;IAQZ;;OAEG;IACH,YAAY,IAAI,SAAS;IAIzB;;OAEG;IACH,iBAAiB,IAAI,iBAAiB;IAItC;;OAEG;IACH,YAAY,IAAI,SAAS;IAIzB;;OAEG;IACH,qBAAqB,IAAI,kBAAkB,GAAG,SAAS;IAIvD;;OAEG;IACH,QAAQ,IAAI,aAAa;IAIzB;;OAEG;IACH,SAAS,IAAI,WAAW;CAGzB"}

package/dist/peer-agent.js

@@ -0,0 +1,190 @@
+import { AletheiaAgent, } from "@a2aletheia/sdk/agent";
+import { AletheiaA2A } from "./aletheia-a2a.js";
+// ---------------------------------------------------------------------------
+// PeerAgent
+// ---------------------------------------------------------------------------
+/**
+ * A full-duplex peer that can both host an A2A agent (inbound) and
+ * send trust-verified requests to other agents (outbound).
+ *
+ * Composes `AletheiaAgent` (server) + `AletheiaA2A` (client).
+ *
+ * @example
+ * ```typescript
+ * import { PeerAgent } from "@a2aletheia/a2a";
+ *
+ * const peer = new PeerAgent({
+ *   registryUrl: "https://registry.aletheia.dev",
+ *   name: "Orchestrator",
+ *   version: "1.0.0",
+ *   url: "https://orchestrator.example.com",
+ *   description: "Routes work to specialist agents",
+ *   skills: [{ id: "orchestrate", name: "orchestrate", description: "Orchestrate tasks", tags: [] }],
+ *   minTrustScore: 0.7,
+ * });
+ *
+ * peer.handle(async (context, response) => {
+ *   // Use outbound client inside the handler
+ *   const result = await peer.sendByCapability("translate", context.textContent);
+ *   response.text(result.response);
+ * });
+ *
+ * await peer.start(4000);
+ * ```
+ */
+export class PeerAgent {
+    agent;
+    client;
+    constructor(config) {
+        const agentConfig = {
+            name: config.name,
+            version: config.version,
+            url: config.url,
+            description: config.description,
+            skills: config.skills,
+            defaultInputModes: config.defaultInputModes,
+            defaultOutputModes: config.defaultOutputModes,
+            capabilities: config.capabilities,
+            iconUrl: config.iconUrl,
+            documentationUrl: config.documentationUrl,
+            provider: config.provider,
+            aletheiaExtensions: config.aletheiaExtensions,
+            registryUrl: config.registryUrl,
+            taskStore: config.taskStore,
+            logger: config.logger,
+            logLevel: config.logLevel,
+        };
+        this.agent = new AletheiaAgent(agentConfig);
+        this.client = new AletheiaA2A({
+            registryUrl: config.registryUrl,
+            agentSelector: config.agentSelector,
+            minTrustScore: config.minTrustScore,
+            requireLive: config.requireLive,
+            livenessCheckBeforeSend: config.livenessCheckBeforeSend,
+            verifyIdentity: config.verifyIdentity,
+            authToken: config.authToken,
+            logger: config.logger,
+            logLevel: config.logLevel,
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // Inbound (delegated to AletheiaAgent)
+    // ---------------------------------------------------------------------------
+    /**
+     * Register the message handler for incoming requests.
+     */
+    handle(handler) {
+        this.agent.handle(handler);
+        return this;
+    }
+    /**
+     * Register an optional cancel handler.
+     */
+    onCancel(handler) {
+        this.agent.onCancel(handler);
+        return this;
+    }
+    /**
+     * Handle a JSON-RPC request body (framework-agnostic).
+     */
+    async handleRequest(body) {
+        return this.agent.handleRequest(body);
+    }
+    // ---------------------------------------------------------------------------
+    // Lifecycle event hooks
+    // ---------------------------------------------------------------------------
+    /**
+     * Subscribe to lifecycle events. Returns an unsubscribe function.
+     */
+    on(event, handler) {
+        return this.agent.on(event, handler);
+    }
+    // ---------------------------------------------------------------------------
+    // Outbound (delegated to AletheiaA2A)
+    // ---------------------------------------------------------------------------
+    /**
+     * Discover agents by capability, query, or trust criteria.
+     */
+    async discover(params) {
+        return this.client.discover(params);
+    }
+    /**
+     * Connect to an agent by DID with trust verification.
+     */
+    async connect(did) {
+        return this.client.connect(did);
+    }
+    /**
+     * Connect to an agent by URL (no trust verification).
+     */
+    async connectByUrl(url) {
+        return this.client.connectByUrl(url);
+    }
+    /**
+     * Discover, select, and send a message by capability.
+     */
+    async sendByCapability(capability, input, options) {
+        return this.client.sendByCapability(capability, input, options);
+    }
+    /**
+     * Discover, select, and stream a response by capability.
+     */
+    async *streamByCapability(capability, input, options) {
+        yield* this.client.streamByCapability(capability, input, options);
+    }
+    // ---------------------------------------------------------------------------
+    // Lifecycle
+    // ---------------------------------------------------------------------------
+    /**
+     * Start a standalone Express server.
+     */
+    async start(port) {
+        return this.agent.start(port);
+    }
+    /**
+     * Stop the standalone server if running.
+     */
+    stop() {
+        this.agent.stop();
+    }
+    // ---------------------------------------------------------------------------
+    // Accessors
+    // ---------------------------------------------------------------------------
+    /**
+     * Get the agent's AgentCard.
+     */
+    getAgentCard() {
+        return this.agent.getAgentCard();
+    }
+    /**
+     * Get the underlying request handler for custom integrations.
+     */
+    getRequestHandler() {
+        return this.agent.getRequestHandler();
+    }
+    /**
+     * Get the task store.
+     */
+    getTaskStore() {
+        return this.agent.getTaskStore();
+    }
+    /**
+     * Get Aletheia-specific extensions.
+     */
+    getAletheiaExtensions() {
+        return this.agent.getAletheiaExtensions();
+    }
+    /**
+     * Get the underlying AletheiaAgent (escape hatch).
+     */
+    getAgent() {
+        return this.agent;
+    }
+    /**
+     * Get the underlying AletheiaA2A client (escape hatch).
+     */
+    getClient() {
+        return this.client;
+    }
+}
+//# sourceMappingURL=peer-agent.js.map

package/dist/peer-agent.js.map

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

package/dist/trust-pipeline.d.ts

@@ -0,0 +1,12 @@
+import type { Agent, AletheiaLogger } from "@a2aletheia/types";
+import type { AletheiaClient } from "@a2aletheia/sdk";
+import type { AletheiaA2AConfig, TrustInfo } from "./types.js";
+export interface TrustPipelineConfig {
+    verifyIdentity: boolean;
+    livenessCheckBeforeSend: boolean;
+    minTrustScore: number;
+    requireLive: boolean;
+}
+export declare function buildPipelineConfig(config: AletheiaA2AConfig): TrustPipelineConfig;
+export declare function verifySendPreconditions(agent: Agent, client: AletheiaClient, pipelineConfig: TrustPipelineConfig, logger?: AletheiaLogger): Promise<TrustInfo>;
+//# sourceMappingURL=trust-pipeline.d.ts.map

package/dist/trust-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trust-pipeline.d.ts","sourceRoot":"","sources":["../src/trust-pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAQ/D,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,OAAO,CAAC;IACxB,uBAAuB,EAAE,OAAO,CAAC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,iBAAiB,GACxB,mBAAmB,CAOrB;AAED,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,cAAc,EACtB,cAAc,EAAE,mBAAmB,EACnC,MAAM,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,SAAS,CAAC,CAsEpB"}

package/dist/trust-pipeline.js

@@ -0,0 +1,72 @@
+import { buildTrustInfo } from "./types.js";
+import { DIDResolutionError, AgentNotLiveError, TrustScoreBelowThresholdError, } from "./errors.js";
+export function buildPipelineConfig(config) {
+    return {
+        verifyIdentity: config.verifyIdentity ?? true,
+        livenessCheckBeforeSend: config.livenessCheckBeforeSend ?? false,
+        minTrustScore: config.minTrustScore ?? 0,
+        requireLive: config.requireLive ?? true,
+    };
+}
+export async function verifySendPreconditions(agent, client, pipelineConfig, logger) {
+    // 1. DID resolution
+    if (pipelineConfig.verifyIdentity) {
+        logger?.debug("Verifying DID identity", { did: agent.did });
+        try {
+            await client.resolveDID(agent.did);
+            logger?.debug("DID verified", { did: agent.did });
+        }
+        catch (err) {
+            logger?.warn("DID resolution failed", {
+                did: agent.did,
+                error: String(err),
+            });
+            throw new DIDResolutionError(`Failed to resolve DID: ${agent.did}`, {
+                cause: err instanceof Error ? err : new Error(String(err)),
+            });
+        }
+    }
+    // 2. Liveness check
+    if (pipelineConfig.livenessCheckBeforeSend) {
+        logger?.debug("Checking liveness", { did: agent.did });
+        try {
+            const isLive = await client.checkLiveness(agent.did);
+            if (!isLive) {
+                logger?.warn("Agent not live", { did: agent.did });
+                throw new AgentNotLiveError(`Agent ${agent.did} is not live`);
+            }
+            logger?.debug("Liveness confirmed", { did: agent.did });
+        }
+        catch (err) {
+            if (err instanceof AgentNotLiveError)
+                throw err;
+            logger?.warn("Liveness check failed", {
+                did: agent.did,
+                error: String(err),
+            });
+            throw new AgentNotLiveError(`Liveness check failed for agent ${agent.did}`, { cause: err instanceof Error ? err : new Error(String(err)) });
+        }
+    }
+    else if (pipelineConfig.requireLive && !agent.isLive) {
+        logger?.warn("Agent not live (cached)", { did: agent.did });
+        throw new AgentNotLiveError(`Agent ${agent.did} is not live (cached status)`);
+    }
+    // 3. Trust score gate
+    if (pipelineConfig.minTrustScore > 0 &&
+        (agent.trustScore === null ||
+            agent.trustScore < pipelineConfig.minTrustScore)) {
+        logger?.warn("Trust score below threshold", {
+            did: agent.did,
+            score: agent.trustScore,
+            threshold: pipelineConfig.minTrustScore,
+        });
+        throw new TrustScoreBelowThresholdError(agent.trustScore, pipelineConfig.minTrustScore);
+    }
+    logger?.info("Trust pipeline passed", {
+        did: agent.did,
+        trustScore: agent.trustScore,
+        isLive: agent.isLive,
+    });
+    return buildTrustInfo(agent);
+}
+//# sourceMappingURL=trust-pipeline.js.map

package/dist/trust-pipeline.js.map

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

package/dist/trusted-agent.d.ts

@@ -0,0 +1,52 @@
+import type { Agent } from "@a2aletheia/types";
+import type { AgentCard } from "@a2a-js/sdk";
+import { A2AClient } from "@a2a-js/sdk/client";
+import type { TrustInfo, TrustedResponse, TrustedStreamEvent, TrustedTaskResponse, MessageInput, SendOptions, ContextStore } from "./types.js";
+export declare class TrustedAgent {
+    readonly did: string | null;
+    readonly agent: Agent | null;
+    readonly agentCard: AgentCard;
+    readonly trustInfo: TrustInfo;
+    /** @internal */
+    readonly _a2aClient: A2AClient;
+    /**
+     * Tracked conversation state — populated after the first send/stream.
+     * Subsequent calls reuse these to continue the same conversation.
+     */
+    private _contextId;
+    private _lastTaskId;
+    /** Optional persistent store + key for surviving cold-starts. */
+    private readonly _contextStore;
+    private readonly _storeKey;
+    constructor(opts: {
+        a2aClient: A2AClient;
+        agentCard: AgentCard;
+        agent: Agent | null;
+        trustInfo: TrustInfo;
+        contextStore?: ContextStore;
+        storeKey?: string;
+    });
+    /**
+     * Restore conversation context from the persistent store.
+     * Called by `AletheiaA2A` after constructing a new `TrustedAgent`.
+     */
+    restoreContext(): Promise<void>;
+    get supportsStreaming(): boolean;
+    /** The contextId from the most recent exchange, if any. */
+    get contextId(): string | undefined;
+    /** The taskId from the most recent exchange, if any. */
+    get lastTaskId(): string | undefined;
+    send(input: string | MessageInput, options?: SendOptions): Promise<TrustedResponse>;
+    stream(input: string | MessageInput, options?: SendOptions): AsyncGenerator<TrustedStreamEvent>;
+    getTask(taskId: string): Promise<TrustedTaskResponse>;
+    cancelTask(taskId: string): Promise<TrustedTaskResponse>;
+    resubscribeTask(taskId: string): AsyncGenerator<TrustedStreamEvent>;
+    refreshCard(): Promise<AgentCard>;
+    /**
+     * Reset conversation state. Next send() starts a fresh conversation.
+     */
+    resetContext(): void;
+    /** Fire-and-forget persist of current context to the store. */
+    private _persistContext;
+}
+//# sourceMappingURL=trusted-agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trusted-agent.d.ts","sourceRoot":"","sources":["../src/trusted-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAA8B,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,WAAW,EACX,YAAY,EACb,MAAM,YAAY,CAAC;AAIpB,qBAAa,YAAY;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAE9B,gBAAgB;IAChB,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC;IAE/B;;;OAGG;IACH,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,WAAW,CAAqB;IAExC,iEAAiE;IACjE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA2B;IACzD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;gBAEnC,IAAI,EAAE;QAChB,SAAS,EAAE,SAAS,CAAC;QACrB,SAAS,EAAE,SAAS,CAAC;QACrB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;QACpB,SAAS,EAAE,SAAS,CAAC;QACrB,YAAY,CAAC,EAAE,YAAY,CAAC;QAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB;IAUD;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IASrC,IAAI,iBAAiB,IAAI,OAAO,CAE/B;IAED,2DAA2D;IAC3D,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAElC;IAED,wDAAwD;IACxD,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAEnC;IAEK,IAAI,CACR,KAAK,EAAE,MAAM,GAAG,YAAY,EAC5B,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,eAAe,CAAC;IA+CpB,MAAM,CACX,KAAK,EAAE,MAAM,GAAG,YAAY,EAC5B,OAAO,CAAC,EAAE,WAAW,GACpB,cAAc,CAAC,kBAAkB,CAAC;IA2C/B,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAkBrD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAkBvD,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAAC,kBAAkB,CAAC;IAapE,WAAW,IAAI,OAAO,CAAC,SAAS,CAAC;IAMvC;;OAEG;IACH,YAAY,IAAI,IAAI;IAQpB,+DAA+D;IAC/D,OAAO,CAAC,eAAe;CAUxB"}