@radaros/core 0.3.5 → 0.3.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@radaros/core",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -10,9 +10,13 @@
       "types": "./dist/index.d.ts"
     }
   },
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "tsup src/index.ts --format esm --dts --clean",
-    "dev": "tsup src/index.ts --format esm --dts --watch"
+    "dev": "tsup src/index.ts --format esm --dts --watch",
+    "prepublishOnly": "npm run build"
   },
   "dependencies": {
     "uuid": "^11.0.0",

package/src/a2a/a2a-remote-agent.ts

@@ -1,270 +0,0 @@
-import type {
-  A2AAgentCard,
-  A2AJsonRpcRequest,
-  A2AJsonRpcResponse,
-  A2AMessage,
-  A2APart,
-  A2ATask,
-} from "./types.js";
-import type { RunOpts, RunOutput } from "../agent/types.js";
-import type { ToolDef, ToolResult } from "../tools/types.js";
-import type { StreamChunk } from "../models/types.js";
-import type { RunContext } from "../agent/run-context.js";
-import { z } from "zod";
-
-export interface A2ARemoteAgentConfig {
-  url: string;
-  /** Custom headers for every request (e.g. auth tokens). */
-  headers?: Record<string, string>;
-  /** Override the discovered name. */
-  name?: string;
-  /** Request timeout in ms (default 60000). */
-  timeoutMs?: number;
-}
-
-/**
- * A2ARemoteAgent wraps a remote A2A-compliant agent.
- * It can be used as a tool, a Team member, or called directly.
- */
-export class A2ARemoteAgent {
-  readonly url: string;
-  name: string;
-  instructions: string;
-  skills: Array<{ id: string; name: string; description?: string }> = [];
-
-  private headers: Record<string, string>;
-  private timeoutMs: number;
-  private card: A2AAgentCard | null = null;
-  private rpcId = 0;
-
-  get tools(): ToolDef[] {
-    return [];
-  }
-
-  get modelId(): string {
-    return "a2a-remote";
-  }
-
-  get providerId(): string {
-    return "a2a";
-  }
-
-  get hasStructuredOutput(): boolean {
-    return false;
-  }
-
-  constructor(config: A2ARemoteAgentConfig) {
-    this.url = config.url.replace(/\/$/, "");
-    this.name = config.name ?? "remote-agent";
-    this.instructions = "";
-    this.headers = config.headers ?? {};
-    this.timeoutMs = config.timeoutMs ?? 60_000;
-  }
-
-  /**
-   * Fetch the Agent Card from /.well-known/agent.json and populate metadata.
-   */
-  async discover(): Promise<A2AAgentCard> {
-    const res = await fetch(`${this.url}/.well-known/agent.json`, {
-      headers: this.headers,
-      signal: AbortSignal.timeout(this.timeoutMs),
-    });
-
-    if (!res.ok) {
-      throw new Error(
-        `A2A discover failed: ${res.status} ${res.statusText} from ${this.url}`
-      );
-    }
-
-    this.card = (await res.json()) as A2AAgentCard;
-    this.name = this.card.name;
-    this.instructions = this.card.description ?? "";
-    this.skills =
-      this.card.skills?.map((s) => ({
-        id: s.id,
-        name: s.name,
-        description: s.description,
-      })) ?? [];
-
-    return this.card;
-  }
-
-  /**
-   * Synchronous run: sends message/send and returns RunOutput.
-   */
-  async run(
-    input: string,
-    opts?: RunOpts
-  ): Promise<RunOutput> {
-    const message: A2AMessage = {
-      role: "user",
-      parts: [{ kind: "text", text: input }],
-    };
-
-    const rpcReq: A2AJsonRpcRequest = {
-      jsonrpc: "2.0",
-      id: ++this.rpcId,
-      method: "message/send",
-      params: {
-        message,
-        ...(opts?.sessionId ? { sessionId: opts.sessionId } : {}),
-      },
-    };
-
-    const startMs = Date.now();
-    const res = await fetch(this.url, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        ...this.headers,
-      },
-      body: JSON.stringify(rpcReq),
-      signal: AbortSignal.timeout(this.timeoutMs),
-    });
-
-    if (!res.ok) {
-      throw new Error(`A2A message/send failed: ${res.status} ${res.statusText}`);
-    }
-
-    const rpcRes = (await res.json()) as A2AJsonRpcResponse;
-    if (rpcRes.error) {
-      throw new Error(`A2A error: ${rpcRes.error.message}`);
-    }
-
-    const task = rpcRes.result as A2ATask;
-    const agentMsg = task.status?.message;
-    const text = agentMsg
-      ? this.partsToText(agentMsg.parts)
-      : "";
-
-    return {
-      text,
-      toolCalls: [],
-      usage: { promptTokens: 0, completionTokens: 0, totalTokens: 0 },
-      durationMs: Date.now() - startMs,
-    };
-  }
-
-  /**
-   * Streaming run: sends message/stream and yields StreamChunks from SSE.
-   */
-  async *stream(
-    input: string,
-    opts?: RunOpts
-  ): AsyncGenerator<StreamChunk> {
-    const message: A2AMessage = {
-      role: "user",
-      parts: [{ kind: "text", text: input }],
-    };
-
-    const rpcReq: A2AJsonRpcRequest = {
-      jsonrpc: "2.0",
-      id: ++this.rpcId,
-      method: "message/stream",
-      params: {
-        message,
-        ...(opts?.sessionId ? { sessionId: opts.sessionId } : {}),
-      },
-    };
-
-    const res = await fetch(this.url, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        ...this.headers,
-      },
-      body: JSON.stringify(rpcReq),
-      signal: AbortSignal.timeout(this.timeoutMs),
-    });
-
-    if (!res.ok) {
-      throw new Error(`A2A message/stream failed: ${res.status} ${res.statusText}`);
-    }
-
-    if (!res.body) {
-      throw new Error("A2A message/stream: no response body for SSE");
-    }
-
-    const reader = res.body.getReader();
-    const decoder = new TextDecoder();
-    let buffer = "";
-
-    while (true) {
-      const { done, value } = await reader.read();
-      if (done) break;
-
-      buffer += decoder.decode(value, { stream: true });
-      const lines = buffer.split("\n");
-      buffer = lines.pop()!;
-
-      for (const line of lines) {
-        if (!line.startsWith("data: ")) continue;
-        const jsonStr = line.slice(6).trim();
-        if (!jsonStr) continue;
-
-        try {
-          const event = JSON.parse(jsonStr) as A2AJsonRpcResponse;
-          const task = event.result as A2ATask | undefined;
-          if (!task) continue;
-
-          if (
-            task.status?.state === "working" &&
-            task.status.message?.parts?.length
-          ) {
-            for (const part of task.status.message.parts) {
-              if (part.kind === "text") {
-                yield { type: "text", text: part.text };
-              }
-            }
-          }
-
-          if (task.status?.state === "completed") {
-            yield {
-              type: "finish",
-              finishReason: "stop",
-              usage: { promptTokens: 0, completionTokens: 0, totalTokens: 0 },
-            };
-          }
-        } catch {
-          // skip unparseable lines
-        }
-      }
-    }
-  }
-
-  /**
-   * Wrap this remote agent as a ToolDef so it can be used by an orchestrator agent.
-   */
-  asTool(): ToolDef {
-    const self = this;
-    return {
-      name: `a2a_${this.name.replace(/[^a-zA-Z0-9_]/g, "_")}`,
-      description:
-        this.instructions ||
-        `Remote A2A agent: ${this.name}`,
-      parameters: z.object({
-        message: z.string().describe("The message to send to the remote agent"),
-      }),
-      async execute(
-        args: Record<string, unknown>,
-        _ctx: RunContext
-      ): Promise<string | ToolResult> {
-        const result = await self.run(args.message as string);
-        return result.text;
-      },
-    };
-  }
-
-  getAgentCard(): A2AAgentCard | null {
-    return this.card;
-  }
-
-  private partsToText(parts: A2APart[]): string {
-    return parts
-      .filter(
-        (p): p is { kind: "text"; text: string } => p.kind === "text"
-      )
-      .map((p) => p.text)
-      .join("\n");
-  }
-}

package/src/a2a/types.ts

@@ -1,142 +0,0 @@
-/**
- * A2A (Agent-to-Agent) Protocol types.
- * Based on the A2A specification v0.2.
- * https://google.github.io/A2A/specification/
- */
-
-// ── Parts ─────────────────────────────────────────────────────────────────
-
-export interface A2ATextPart {
-  kind: "text";
-  text: string;
-}
-
-export interface A2AFilePart {
-  kind: "file";
-  file: {
-    name?: string;
-    mimeType?: string;
-    bytes?: string;
-    uri?: string;
-  };
-}
-
-export interface A2ADataPart {
-  kind: "data";
-  data: Record<string, unknown>;
-}
-
-export type A2APart = A2ATextPart | A2AFilePart | A2ADataPart;
-
-// ── Messages ──────────────────────────────────────────────────────────────
-
-export interface A2AMessage {
-  role: "user" | "agent";
-  parts: A2APart[];
-  messageId?: string;
-  taskId?: string;
-  referenceTaskIds?: string[];
-  metadata?: Record<string, unknown>;
-}
-
-// ── Task ──────────────────────────────────────────────────────────────────
-
-export type A2ATaskState =
-  | "submitted"
-  | "working"
-  | "input-required"
-  | "completed"
-  | "failed"
-  | "canceled";
-
-export interface A2AArtifact {
-  artifactId: string;
-  name?: string;
-  description?: string;
-  parts: A2APart[];
-  metadata?: Record<string, unknown>;
-}
-
-export interface A2ATask {
-  id: string;
-  sessionId?: string;
-  status: {
-    state: A2ATaskState;
-    message?: A2AMessage;
-    timestamp?: string;
-  };
-  artifacts?: A2AArtifact[];
-  history?: A2AMessage[];
-  metadata?: Record<string, unknown>;
-}
-
-// ── Agent Card ────────────────────────────────────────────────────────────
-
-export interface A2ASkill {
-  id: string;
-  name: string;
-  description?: string;
-  tags?: string[];
-  examples?: string[];
-}
-
-export interface A2AAgentCard {
-  name: string;
-  description?: string;
-  url: string;
-  version?: string;
-  provider?: {
-    organization: string;
-    url?: string;
-  };
-  capabilities?: {
-    streaming?: boolean;
-    pushNotifications?: boolean;
-    stateTransitionHistory?: boolean;
-  };
-  authentication?: {
-    schemes?: string[];
-    credentials?: string;
-  };
-  skills?: A2ASkill[];
-  defaultInputModes?: string[];
-  defaultOutputModes?: string[];
-  supportedInputModes?: string[];
-  supportedOutputModes?: string[];
-}
-
-// ── JSON-RPC ──────────────────────────────────────────────────────────────
-
-export interface A2AJsonRpcRequest {
-  jsonrpc: "2.0";
-  id: string | number;
-  method: string;
-  params?: Record<string, unknown>;
-}
-
-export interface A2AJsonRpcResponse {
-  jsonrpc: "2.0";
-  id: string | number;
-  result?: unknown;
-  error?: {
-    code: number;
-    message: string;
-    data?: unknown;
-  };
-}
-
-// ── Send/Stream params ────────────────────────────────────────────────────
-
-export interface A2ASendParams {
-  message: A2AMessage;
-  configuration?: {
-    acceptedOutputModes?: string[];
-    blocking?: boolean;
-  };
-  metadata?: Record<string, unknown>;
-}
-
-export interface A2ATaskQueryParams {
-  id: string;
-  historyLength?: number;
-}