noumen 0.1.0 → 0.2.0

package/dist/a2a/index.d.ts

@@ -0,0 +1,148 @@
+import { A as Agent } from '../agent-BrkbZyOT.js';
+import { A as AgentSkill, a as AgentCard, T as TaskSendParams, b as Task, c as TaskStreamEvent } from '../types-NIyVwQ4h.js';
+export { d as A2A_METHODS, e as Artifact, D as DataPart, F as FilePart, M as Message, P as Part, f as TaskState, g as TaskStatus, h as TextPart } from '../types-NIyVwQ4h.js';
+import '../types-3c88cRKH.js';
+import '../types-CwKKucOF.js';
+import '../types-DwdzmXfs.js';
+import '../cache-DVqaCX8v.js';
+import '../types-2kTLUCnD.js';
+import '@modelcontextprotocol/sdk/client/index.js';
+import '@modelcontextprotocol/sdk/client/auth.js';
+import '@modelcontextprotocol/sdk/shared/auth.js';
+
+/**
+ * Build an A2A Agent Card from a noumen Code instance configuration.
+ */
+
+interface AgentCardOptions {
+    name: string;
+    description?: string;
+    url: string;
+    version?: string;
+    provider?: {
+        organization: string;
+        url?: string;
+    };
+    skills?: AgentSkill[];
+    authentication?: {
+        schemes: string[];
+        credentials?: string;
+    };
+    streaming?: boolean;
+}
+declare function buildAgentCard(options: AgentCardOptions): AgentCard;
+
+/**
+ * A2A HTTP server implementing the Agent2Agent protocol endpoints.
+ *
+ * Endpoints:
+ *   GET  /.well-known/agent.json  ->  Agent Card
+ *   POST /                        ->  JSON-RPC dispatch
+ */
+
+interface A2AServerOptions extends AgentCardOptions {
+    /** Port to listen on (default: 3000) */
+    port?: number;
+    /** CORS origin header (default: "*") */
+    cors?: string | false;
+}
+declare class A2AServer {
+    private httpServer;
+    private taskManager;
+    private agentCard;
+    private options;
+    constructor(code: Agent, options: A2AServerOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private handleRequest;
+    private dispatch;
+    private handleStreamingRequest;
+}
+
+/**
+ * A2A client for calling remote A2A agents.
+ *
+ * Enables noumen agents to discover and delegate work to other A2A agents.
+ */
+
+interface A2AClientOptions {
+    /** Override headers for all requests. */
+    headers?: Record<string, string>;
+    /** Bearer token for authentication. */
+    token?: string;
+}
+declare class A2AClient {
+    private agentUrl;
+    private headers;
+    constructor(agentUrl: string, options?: A2AClientOptions);
+    /**
+     * Discover the remote agent's capabilities via its Agent Card.
+     */
+    getAgentCard(): Promise<AgentCard>;
+    /**
+     * Send a task to the remote agent (non-streaming).
+     */
+    sendTask(params: TaskSendParams): Promise<Task>;
+    /**
+     * Send a task and subscribe to streaming updates via SSE.
+     */
+    sendTaskSubscribe(params: TaskSendParams): AsyncGenerator<TaskStreamEvent>;
+    /**
+     * Get the current state of a task.
+     */
+    getTask(taskId: string): Promise<Task>;
+    /**
+     * Cancel a running task.
+     */
+    cancelTask(taskId: string): Promise<void>;
+    /**
+     * Helper: send a simple text message and return the task.
+     */
+    ask(text: string, sessionId?: string): Promise<Task>;
+}
+
+/**
+ * A2A Task Manager: maps A2A task lifecycle to noumen sessions/threads.
+ */
+
+declare class TaskManager {
+    private tasks;
+    private code;
+    constructor(code: Agent);
+    /**
+     * Create a task, start running it, and return the task immediately.
+     * Use `getTask` to poll status or `streamTask` for SSE.
+     */
+    sendTask(params: TaskSendParams): Promise<Task>;
+    /**
+     * Stream task events as an async generator (for SSE).
+     */
+    sendTaskSubscribe(params: TaskSendParams): AsyncGenerator<TaskStreamEvent>;
+    getTask(taskId: string): Task | null;
+    cancelTask(taskId: string): boolean;
+    private runTask;
+    private mapStreamEvent;
+    private messageToPrompt;
+}
+
+/**
+ * A2A (Agent2Agent) protocol adapter for noumen.
+ *
+ * Server usage:
+ *   import { createA2AServer } from "noumen/a2a";
+ *   const server = createA2AServer(code, { name: "MyAgent", url: "https://..." });
+ *   await server.start();
+ *
+ * Client usage:
+ *   import { A2AClient } from "noumen/a2a";
+ *   const client = new A2AClient("https://remote-agent.example.com");
+ *   const card = await client.getAgentCard();
+ *   const task = await client.ask("Fix the bug in auth.ts");
+ */
+
+/**
+ * Create an A2A server that exposes an Agent instance via the Agent2Agent protocol.
+ */
+declare function createA2AServer(code: Agent, options: A2AServerOptions): A2AServer;
+
+export { A2AClient, type A2AClientOptions, A2AServer, type A2AServerOptions, AgentCard, type AgentCardOptions, AgentSkill, Task, TaskManager, TaskSendParams, TaskStreamEvent, buildAgentCard, createA2AServer };