agentalk 0.1.0

package/README.zh-CN.md

@@ -0,0 +1,445 @@
+<div align="center">
+
+# ⚡ agentalk
+
+**AI 智能体的 curl — 通用 A2A 协议命令行工具**
+
+从终端发现、对话、流式交互、管理任何兼容 A2A 协议的智能体。
+
+[![npm version](https://img.shields.io/npm/v/agentalk?style=flat-square&color=cb3837&logo=npm&logoColor=white)](https://www.npmjs.com/package/agentalk)
+[![license](https://img.shields.io/npm/l/agentalk?style=flat-square&color=blue)](https://github.com/IchenDEV/agentalk/blob/main/LICENSE)
+[![node version](https://img.shields.io/node/v/agentalk?style=flat-square&color=339933&logo=node.js&logoColor=white)](https://nodejs.org)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.7+-3178C6?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+[![A2A Protocol](https://img.shields.io/badge/A2A_协议-v1.0-8B5CF6?style=flat-square&logo=google&logoColor=white)](https://google.github.io/A2A/)
+[![zero config](https://img.shields.io/badge/零配置-开箱即用-10B981?style=flat-square)](#快速开始)
+[![PRs Welcome](https://img.shields.io/badge/PRs-欢迎贡献-FF6F61?style=flat-square)](https://github.com/IchenDEV/agentalk/pulls)
+
+<br />
+
+[🇬🇧 English](./README.md) · [报告 Bug](https://github.com/IchenDEV/agentalk/issues) · [功能建议](https://github.com/IchenDEV/agentalk/issues)
+
+<br />
+
+```
+  ╭──────────────────────────────────────────────────╮
+  │                                                  │
+  │   $ agentalk agent https://my-agent.example.com      │
+  │                                                  │
+  │   🤖 食谱助手                                     │
+  │      v1.0.0                                      │
+  │      帮你搜索食谱和烹饪指南                         │
+  │                                                  │
+  │   Skills:                                        │
+  │     • 食谱搜索 (recipe-search)                    │
+  │       根据食材或菜系搜索食谱                        │
+  │                                                  │
+  │   $ agentalk send https://my-agent.example.com \     │
+  │       -m "帮我找一道意面食谱"                       │
+  │                                                  │
+  │   agent: 这是一道经典的卡博纳拉意面...              │
+  │                                                  │
+  ╰──────────────────────────────────────────────────╯
+```
+
+</div>
+
+---
+
+## 目录
+
+- [为什么选择 agentalk？](#为什么选择-agentalk)
+- [快速开始](#快速开始)
+- [使用方法](#使用方法)
+  - [发现智能体](#-发现智能体)
+  - [发送消息](#-发送消息)
+  - [流式响应](#-流式响应)
+  - [管理任务](#-管理任务)
+- [命令速查](#命令速查)
+- [实用技巧](#实用技巧)
+- [任务状态说明](#任务状态说明)
+- [架构](#架构)
+- [本地开发](#本地开发)
+- [贡献指南](#贡献指南)
+- [开源协议](#开源协议)
+
+---
+
+## 为什么选择 agentalk？
+
+[A2A（Agent-to-Agent）协议](https://google.github.io/A2A/) 是 Google 发起的开放标准，让 AI 智能体之间可以互相通信。**agentalk** 把这个协议带到了你的终端。
+
+<table>
+<tr>
+<td width="50">🔍</td>
+<td><strong>发现</strong></td>
+<td>获取并查看 Agent Card，了解智能体的能力</td>
+</tr>
+<tr>
+<td>💬</td>
+<td><strong>对话</strong></td>
+<td>发送消息，获取结构化响应</td>
+</tr>
+<tr>
+<td>🌊</td>
+<td><strong>流式</strong></td>
+<td>通过 SSE 实时流式接收长任务输出</td>
+</tr>
+<tr>
+<td>📋</td>
+<td><strong>任务</strong></td>
+<td>完整的任务生命周期管理 — 查询、列表、取消</td>
+</tr>
+<tr>
+<td>🎨</td>
+<td><strong>美化输出</strong></td>
+<td>彩色人类可读格式；<code>--json</code> 切换机器可读</td>
+</tr>
+<tr>
+<td>🔒</td>
+<td><strong>认证支持</strong></td>
+<td>通过 HTTP Header 传递 Bearer Token、API Key 等</td>
+</tr>
+<tr>
+<td>🏢</td>
+<td><strong>多租户</strong></td>
+<td>内置租户隔离，使用 <code>--tenant</code> 切换</td>
+</tr>
+</table>
+
+## 快速开始
+
+### 全局安装
+
+```bash
+pnpm add -g agentalk
+```
+
+### 或通过 pnpm dlx 直接运行
+
+```bash
+pnpm dlx agentalk agent https://agent.example.com
+```
+
+> [!TIP]
+> 无需任何配置。指向任何 A2A 兼容的智能体 URL 即可使用。
+
+## 使用方法
+
+### 🔍 发现智能体
+
+```bash
+agentalk agent https://agent.example.com
+```
+
+<details>
+<summary>📸 <strong>输出示例</strong></summary>
+
+```
+🤖 Recipe Agent
+   v1.0.0
+   帮助用户搜索食谱和烹饪指南的智能体
+
+Provider:
+  Google (https://ai.google.dev)
+
+Capabilities:
+  streaming, push-notifications
+
+Skills:
+  • Recipe Search (recipe-search)
+    根据食材或菜系搜索食谱
+    tags: cooking, recipes, food
+```
+
+</details>
+
+### 💬 发送消息
+
+```bash
+# 简单消息
+agentalk send https://agent.example.com -m "你能做什么？"
+
+# 带上下文的多轮对话
+agentalk send https://agent.example.com -m "继续说" -c ctx_abc123
+
+# 继续已有任务
+agentalk send https://agent.example.com -m "好的，继续" -t task_xyz
+
+# 异步发送（不等待完成）
+agentalk send https://agent.example.com -m "处理这份报告" --async
+```
+
+### 🌊 流式响应
+
+```bash
+agentalk stream https://agent.example.com -m "生成一份详细分析"
+```
+
+<details>
+<summary>📸 <strong>输出示例</strong>（实时流式）</summary>
+
+```
+[task-42] status → working
+agent: 正在分析数据...
+agent: 以下是主要发现：
+[task-42] 📎 report.md: # 分析报告 ... (final)
+[task-42] status → completed
+```
+
+</details>
+
+### 📋 管理任务
+
+```bash
+agentalk task get    https://agent.example.com task_abc123   # 查看状态
+agentalk task list   https://agent.example.com               # 列出所有
+agentalk task list   https://agent.example.com -s TASK_STATE_COMPLETED  # 按状态过滤
+agentalk task cancel https://agent.example.com task_abc123   # 取消任务
+```
+
+---
+
+## 命令速查
+
+```
+agentalk [选项] [命令]
+
+命令:
+  agent <url>                 获取并展示 Agent Card
+  send [选项] <url>           向智能体发送消息
+  stream [选项] <url>         发送消息并流式接收响应（SSE）
+  task get <url> <taskId>     通过 ID 获取任务
+  task list [选项] <url>      列出任务
+  task cancel <url> <taskId>  取消任务
+
+全局选项:
+  --json                      输出原始 JSON（方便管道和脚本处理）
+  -H, --header <key:value>    添加 HTTP 头（可重复使用）
+  --tenant <id>               租户 ID（多租户场景）
+  -V, --version               显示版本号
+  -h, --help                  显示帮助信息
+```
+
+<details>
+<summary><code>send</code> 选项</summary>
+
+| 参数 | 说明 |
+|------|------|
+| `-m, --message <text>` | 消息内容 **（必填）** |
+| `-c, --context <id>` | 上下文 ID，用于多轮对话 |
+| `-t, --task <id>` | 任务 ID，继续已有任务 |
+| `--output-modes <modes>` | 可接受的输出 MIME 类型（逗号分隔） |
+| `--history-length <n>` | 返回的最大历史消息数 |
+| `--async` | 立即返回，不等待任务完成 |
+
+</details>
+
+<details>
+<summary><code>stream</code> 选项</summary>
+
+| 参数 | 说明 |
+|------|------|
+| `-m, --message <text>` | 消息内容 **（必填）** |
+| `-c, --context <id>` | 上下文 ID，用于多轮对话 |
+| `-t, --task <id>` | 任务 ID，继续已有任务 |
+| `--output-modes <modes>` | 可接受的输出 MIME 类型（逗号分隔） |
+
+</details>
+
+<details>
+<summary><code>task list</code> 选项</summary>
+
+| 参数 | 说明 |
+|------|------|
+| `-c, --context <id>` | 按上下文 ID 过滤 |
+| `-s, --status <state>` | 按任务状态过滤 |
+| `--history-length <n>` | 每个任务的最大历史消息数 |
+| `--artifacts` | 包含产物（Artifacts） |
+| `--page-size <n>` | 每页结果数 |
+| `--page-token <token>` | 分页令牌 |
+
+</details>
+
+---
+
+## 实用技巧
+
+### 配合 jq 处理 JSON
+
+```bash
+# 提取任务状态
+agentalk --json task get https://agent.example.com task_123 | jq '.status.state'
+
+# 获取所有技能名称
+agentalk --json agent https://agent.example.com | jq '.skills[].name'
+```
+
+### 带认证使用
+
+```bash
+# Bearer Token
+agentalk agent https://agent.example.com -H "Authorization: Bearer sk-xxx"
+
+# API Key
+agentalk send https://agent.example.com -m "你好" -H "X-API-Key: key_xxx"
+```
+
+### 多轮对话
+
+```bash
+# 1. 开始对话 — 获取 contextId
+CTX=$(agentalk --json send https://agent.example.com -m "帮我规划一次东京旅行" \
+  | jq -r '.task.contextId')
+
+# 2. 带上下文继续
+agentalk send https://agent.example.com -m "改成 5 天的行程" -c "$CTX"
+
+# 3. 在同一任务上继续
+agentalk send https://agent.example.com -m "加上餐厅推荐" -c "$CTX" -t task-xyz
+```
+
+### 多租户场景
+
+```bash
+agentalk --tenant org_acme send https://agent.example.com -m "你好"
+```
+
+---
+
+## 任务状态说明
+
+| 状态 | 图标 | 说明 |
+|------|------|------|
+| `TASK_STATE_SUBMITTED` | 📥 | 任务已提交，等待处理 |
+| `TASK_STATE_WORKING` | ⏳ | 智能体正在处理中 |
+| `TASK_STATE_COMPLETED` | ✅ | 任务成功完成 |
+| `TASK_STATE_FAILED` | ❌ | 任务处理失败 |
+| `TASK_STATE_CANCELED` | 🚫 | 任务已取消 |
+| `TASK_STATE_INPUT_REQUIRED` | 💬 | 智能体需要更多输入 |
+| `TASK_STATE_REJECTED` | ⛔ | 智能体拒绝了该任务 |
+| `TASK_STATE_AUTH_REQUIRED` | 🔐 | 需要认证 |
+
+---
+
+## 架构
+
+```mermaid
+graph LR
+    subgraph CLI["🖥️ CLI 层"]
+        A[cli.ts<br/>Commander.js] --> B[commands/agent.ts]
+        A --> C[commands/send.ts]
+        A --> D[commands/stream.ts]
+        A --> E[commands/task.ts]
+    end
+
+    subgraph Core["⚙️ 核心层"]
+        F[client.ts<br/>A2AClient]
+        G[format.ts<br/>chalk 美化输出]
+        H[types.ts<br/>A2A v1.0 类型]
+    end
+
+    B & C & D & E --> F
+    B & C & D & E --> G
+    F --> H
+
+    subgraph Remote["☁️ 远程智能体"]
+        I["/.well-known/agent.json"]
+        J["POST /"]
+        K["POST /stream (SSE)"]
+        L["GET/POST /tasks/*"]
+    end
+
+    F -->|HTTP| I & J & K & L
+```
+
+<details>
+<summary>📁 <strong>项目结构</strong></summary>
+
+```
+src/
+├── cli.ts              # 入口 — Commander.js CLI 配置
+├── client.ts           # A2AClient — 封装所有 A2A HTTP 操作
+├── format.ts           # 美化输出格式化器（基于 chalk）
+├── types.ts            # 完整的 A2A Protocol v1.0 TypeScript 类型
+├── commands/
+│   ├── agent.ts        # `agentalk agent` 命令
+│   ├── send.ts         # `agentalk send` 命令
+│   ├── stream.ts       # `agentalk stream` 命令
+│   └── task.ts         # `agentalk task {get,list,cancel}` 命令
+└── test/
+    ├── client.test.ts  # A2AClient 单元测试（mock fetch）
+    ├── format.test.ts  # 格式化器单元测试
+    └── cli.test.ts     # CLI 集成测试
+```
+
+</details>
+
+---
+
+## 本地开发
+
+```bash
+# 安装依赖
+pnpm install
+
+# 构建
+pnpm build
+
+# 监听模式
+pnpm dev
+
+# 运行测试（72 个测试用例）
+pnpm test
+
+# 全局链接，方便本地调试
+pnpm link --global
+```
+
+### 环境要求
+
+| 依赖 | 版本 |
+|------|------|
+| Node.js | ≥ 22 |
+| TypeScript | ≥ 5.7 |
+
+> [!NOTE]
+> 使用原生 `fetch`（无需 polyfill）和 `node:test` 实现零依赖测试。
+
+---
+
+## 贡献指南
+
+欢迎贡献！步骤如下：
+
+1. Fork 本仓库
+2. 创建分支（`git checkout -b feat/amazing-feature`）
+3. 开发你的功能
+4. 运行测试（`pnpm test`）
+5. 提交代码（`git commit -m 'feat: add amazing feature'`）
+6. 推送分支（`git push origin feat/amazing-feature`）
+7. 发起 Pull Request
+
+> [!NOTE]
+> 请遵循 [Conventional Commits](https://www.conventionalcommits.org/) 规范编写提交信息。
+
+---
+
+## 相关链接
+
+| 资源 | 链接 |
+|------|------|
+| A2A 协议规范 | [google.github.io/A2A](https://google.github.io/A2A/) |
+| A2A GitHub | [github.com/google/A2A](https://github.com/google/A2A) |
+| npm 包 | [npmjs.com/package/agentalk](https://www.npmjs.com/package/agentalk) |
+
+---
+
+<div align="center">
+
+**[MIT](./LICENSE) © 2026**
+
+用 ❤️ 为 A2A 生态而造
+
+[⬆ 回到顶部](#-agentalk)
+
+</div>

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,141 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import chalk from "chalk";
+import { agentCommand } from "./commands/agent.js";
+import { sendCommand } from "./commands/send.js";
+import { streamCommand } from "./commands/stream.js";
+import { taskGetCommand, taskCancelCommand, taskListCommand } from "./commands/task.js";
+const program = new Command();
+function parseHeaders(val, prev) {
+    const [key, ...rest] = val.split(":");
+    prev[key.trim()] = rest.join(":").trim();
+    return prev;
+}
+program
+    .name("agentalk")
+    .description("A2A Protocol CLI client — discover and interact with A2A agents")
+    .version("0.1.0");
+// Global options
+program
+    .option("--json", "Output raw JSON")
+    .option("-H, --header <key:value>", "Add HTTP header (repeatable)", parseHeaders, {})
+    .option("--tenant <id>", "Tenant ID");
+// agentalk agent <url>
+program
+    .command("agent")
+    .description("Fetch and display an agent card")
+    .argument("<url>", "Agent base URL")
+    .action(async (url) => {
+    const opts = program.opts();
+    await agentCommand(url, { json: opts.json, headers: opts.header, tenant: opts.tenant });
+});
+// agentalk send <url>
+program
+    .command("send")
+    .description("Send a message to an agent")
+    .argument("<url>", "Agent base URL")
+    .requiredOption("-m, --message <text>", "Message text to send")
+    .option("-c, --context <id>", "Context ID")
+    .option("-t, --task <id>", "Task ID (continue existing task)")
+    .option("--output-modes <modes>", "Accepted output MIME types (comma-separated)")
+    .option("--history-length <n>", "Max history messages to return")
+    .option("--async", "Return immediately without waiting for completion")
+    .action(async (url, cmdOpts) => {
+    const opts = program.opts();
+    await sendCommand(url, {
+        ...cmdOpts,
+        message: cmdOpts.message,
+        context: cmdOpts.context,
+        task: cmdOpts.task,
+        outputModes: cmdOpts.outputModes,
+        historyLength: cmdOpts.historyLength,
+        async: cmdOpts.async,
+        json: opts.json,
+        headers: opts.header,
+        tenant: opts.tenant,
+    });
+});
+// agentalk stream <url>
+program
+    .command("stream")
+    .description("Send a message and stream the response (SSE)")
+    .argument("<url>", "Agent base URL")
+    .requiredOption("-m, --message <text>", "Message text to send")
+    .option("-c, --context <id>", "Context ID")
+    .option("-t, --task <id>", "Task ID")
+    .option("--output-modes <modes>", "Accepted output MIME types (comma-separated)")
+    .action(async (url, cmdOpts) => {
+    const opts = program.opts();
+    await streamCommand(url, {
+        ...cmdOpts,
+        message: cmdOpts.message,
+        context: cmdOpts.context,
+        task: cmdOpts.task,
+        outputModes: cmdOpts.outputModes,
+        json: opts.json,
+        headers: opts.header,
+        tenant: opts.tenant,
+    });
+});
+// agentalk task <subcommand>
+const task = program.command("task").description("Task management commands");
+// agentalk task get <url> <taskId>
+task
+    .command("get")
+    .description("Get a task by ID")
+    .argument("<url>", "Agent base URL")
+    .argument("<taskId>", "Task ID")
+    .option("--history-length <n>", "Max history messages to return")
+    .action(async (url, taskId, cmdOpts) => {
+    const opts = program.opts();
+    await taskGetCommand(url, taskId, {
+        historyLength: cmdOpts.historyLength,
+        json: opts.json,
+        headers: opts.header,
+        tenant: opts.tenant,
+    });
+});
+// agentalk task cancel <url> <taskId>
+task
+    .command("cancel")
+    .description("Cancel a task")
+    .argument("<url>", "Agent base URL")
+    .argument("<taskId>", "Task ID")
+    .action(async (url, taskId) => {
+    const opts = program.opts();
+    await taskCancelCommand(url, taskId, {
+        json: opts.json,
+        headers: opts.header,
+        tenant: opts.tenant,
+    });
+});
+// agentalk task list <url>
+task
+    .command("list")
+    .description("List tasks")
+    .argument("<url>", "Agent base URL")
+    .option("-c, --context <id>", "Filter by context ID")
+    .option("-s, --status <state>", "Filter by task state")
+    .option("--history-length <n>", "Max history messages per task")
+    .option("--artifacts", "Include artifacts")
+    .option("--page-size <n>", "Results per page")
+    .option("--page-token <token>", "Pagination token")
+    .action(async (url, cmdOpts) => {
+    const opts = program.opts();
+    await taskListCommand(url, {
+        context: cmdOpts.context,
+        status: cmdOpts.status,
+        historyLength: cmdOpts.historyLength,
+        artifacts: cmdOpts.artifacts,
+        pageSize: cmdOpts.pageSize,
+        pageToken: cmdOpts.pageToken,
+        json: opts.json,
+        headers: opts.header,
+        tenant: opts.tenant,
+    });
+});
+program.parseAsync().catch((err) => {
+    console.error(chalk.red("Error:"), err.message);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,29 @@
+import type { AgentCard, SendMessageResponse, Task, ListTasksRequest, ListTasksResponse, StreamResponse, Message } from "./types.js";
+export interface ClientOptions {
+    headers?: Record<string, string>;
+    tenant?: string;
+}
+export declare class A2AClient {
+    private baseUrl;
+    private headers;
+    private tenant?;
+    constructor(baseUrl: string, options?: ClientOptions);
+    private url;
+    private request;
+    getAgentCard(cardUrl?: string): Promise<AgentCard>;
+    sendMessage(message: string | Message, options?: {
+        contextId?: string;
+        taskId?: string;
+        acceptedOutputModes?: string[];
+        historyLength?: number;
+        returnImmediately?: boolean;
+    }): Promise<SendMessageResponse>;
+    sendMessageStream(message: string | Message, options?: {
+        contextId?: string;
+        taskId?: string;
+        acceptedOutputModes?: string[];
+    }): AsyncGenerator<StreamResponse>;
+    getTask(taskId: string, historyLength?: number): Promise<Task>;
+    cancelTask(taskId: string): Promise<Task>;
+    listTasks(options?: Omit<ListTasksRequest, "tenant">): Promise<ListTasksResponse>;
+}