chore: import upstream snapshot with attribution

apps/sim/tools/a2a/cancel_task.ts

@@ -0,0 +1,52 @@
+import type { A2ACancelTaskParams, A2ACancelTaskResponse } from '@/tools/a2a/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const a2aCancelTaskTool: ToolConfig<A2ACancelTaskParams, A2ACancelTaskResponse> = {
+  id: 'a2a_cancel_task',
+  name: 'A2A Cancel Task',
+  description: 'Request cancellation of an in-progress A2A task.',
+  version: '1.0.0',
+
+  params: {
+    agentUrl: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'The A2A agent endpoint URL',
+    },
+    taskId: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'The task ID to cancel',
+    },
+    apiKey: {
+      type: 'string',
+      required: false,
+      visibility: 'user-only',
+      description: 'API key for authentication (if required)',
+    },
+  },
+
+  request: {
+    url: '/api/tools/a2a/cancel-task',
+    method: 'POST',
+    headers: () => ({ 'Content-Type': 'application/json' }),
+    body: (params) => {
+      const body: Record<string, unknown> = {
+        agentUrl: params.agentUrl,
+        taskId: params.taskId,
+      }
+      if (params.apiKey) body.apiKey = params.apiKey
+      return body
+    },
+  },
+
+  transformResponse: async (response: Response) => response.json(),
+
+  outputs: {
+    taskId: { type: 'string', description: 'Task identifier' },
+    state: { type: 'string', description: 'Task lifecycle state after cancellation' },
+    canceled: { type: 'boolean', description: 'Whether the task was canceled' },
+  },
+}

apps/sim/tools/a2a/get_agent_card.ts

@@ -0,0 +1,76 @@
+import type { A2AAgentCardResponse, A2AGetAgentCardParams } from '@/tools/a2a/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const a2aGetAgentCardTool: ToolConfig<A2AGetAgentCardParams, A2AAgentCardResponse> = {
+  id: 'a2a_get_agent_card',
+  name: 'A2A Get Agent Card',
+  description: 'Fetch the Agent Card (discovery document) for an external A2A agent.',
+  version: '1.0.0',
+
+  params: {
+    agentUrl: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'The A2A agent endpoint URL',
+    },
+    apiKey: {
+      type: 'string',
+      required: false,
+      visibility: 'user-only',
+      description: 'API key for authentication (if required)',
+    },
+  },
+
+  request: {
+    url: '/api/tools/a2a/get-agent-card',
+    method: 'POST',
+    headers: () => ({ 'Content-Type': 'application/json' }),
+    body: (params) => {
+      const body: Record<string, unknown> = { agentUrl: params.agentUrl }
+      if (params.apiKey) body.apiKey = params.apiKey
+      return body
+    },
+  },
+
+  transformResponse: async (response: Response) => response.json(),
+
+  outputs: {
+    name: { type: 'string', description: 'Agent display name' },
+    description: { type: 'string', description: 'Agent description' },
+    url: { type: 'string', description: 'Agent endpoint URL' },
+    version: { type: 'string', description: "The agent's own version" },
+    protocolVersion: { type: 'string', description: 'A2A protocol version the agent exposes' },
+    capabilities: {
+      type: 'json',
+      description: 'Agent capability flags',
+      properties: {
+        streaming: { type: 'boolean', description: 'Supports streaming responses' },
+        pushNotifications: { type: 'boolean', description: 'Supports push notifications' },
+        extendedAgentCard: { type: 'boolean', description: 'Provides an extended agent card' },
+      },
+    },
+    skills: {
+      type: 'array',
+      description: 'Skills the agent can perform',
+      items: {
+        type: 'object',
+        properties: {
+          id: { type: 'string', description: 'Skill identifier' },
+          name: { type: 'string', description: 'Skill name' },
+          description: { type: 'string', description: 'Skill description' },
+        },
+      },
+    },
+    defaultInputModes: {
+      type: 'array',
+      description: 'Default accepted input media types',
+      items: { type: 'string' },
+    },
+    defaultOutputModes: {
+      type: 'array',
+      description: 'Default produced output media types',
+      items: { type: 'string' },
+    },
+  },
+}

apps/sim/tools/a2a/get_task.ts

@@ -0,0 +1,55 @@
+import { A2A_TASK_OUTPUTS, type A2AGetTaskParams, type A2ATaskResponse } from '@/tools/a2a/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const a2aGetTaskTool: ToolConfig<A2AGetTaskParams, A2ATaskResponse> = {
+  id: 'a2a_get_task',
+  name: 'A2A Get Task',
+  description: 'Retrieve the current state and result of an A2A task.',
+  version: '1.0.0',
+
+  params: {
+    agentUrl: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'The A2A agent endpoint URL',
+    },
+    taskId: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'The task ID to retrieve',
+    },
+    historyLength: {
+      type: 'number',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Maximum number of history messages to include',
+    },
+    apiKey: {
+      type: 'string',
+      required: false,
+      visibility: 'user-only',
+      description: 'API key for authentication (if required)',
+    },
+  },
+
+  request: {
+    url: '/api/tools/a2a/get-task',
+    method: 'POST',
+    headers: () => ({ 'Content-Type': 'application/json' }),
+    body: (params) => {
+      const body: Record<string, unknown> = {
+        agentUrl: params.agentUrl,
+        taskId: params.taskId,
+      }
+      if (params.historyLength !== undefined) body.historyLength = params.historyLength
+      if (params.apiKey) body.apiKey = params.apiKey
+      return body
+    },
+  },
+
+  transformResponse: async (response: Response) => response.json(),
+
+  outputs: A2A_TASK_OUTPUTS,
+}

apps/sim/tools/a2a/index.ts

@@ -0,0 +1,5 @@
+export { a2aCancelTaskTool } from './cancel_task'
+export { a2aGetAgentCardTool } from './get_agent_card'
+export { a2aGetTaskTool } from './get_task'
+export { a2aSendMessageTool } from './send_message'
+export * from './types'

apps/sim/tools/a2a/send_message.ts

@@ -0,0 +1,80 @@
+import {
+  A2A_TASK_OUTPUTS,
+  type A2ASendMessageParams,
+  type A2ATaskResponse,
+} from '@/tools/a2a/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const a2aSendMessageTool: ToolConfig<A2ASendMessageParams, A2ATaskResponse> = {
+  id: 'a2a_send_message',
+  name: 'A2A Send Message',
+  description: 'Send a message to an external A2A agent and return its response.',
+  version: '1.0.0',
+
+  params: {
+    agentUrl: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'The A2A agent endpoint URL',
+    },
+    message: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'The message text to send',
+    },
+    data: {
+      type: 'json',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Optional structured JSON data to attach',
+    },
+    files: {
+      type: 'json',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Optional files to attach',
+    },
+    taskId: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Existing task ID to continue',
+    },
+    contextId: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Conversation context ID to continue',
+    },
+    apiKey: {
+      type: 'string',
+      required: false,
+      visibility: 'user-only',
+      description: 'API key for authentication (if required)',
+    },
+  },
+
+  request: {
+    url: '/api/tools/a2a/send-message',
+    method: 'POST',
+    headers: () => ({ 'Content-Type': 'application/json' }),
+    body: (params) => {
+      const body: Record<string, unknown> = {
+        agentUrl: params.agentUrl,
+        message: params.message,
+      }
+      if (params.data) body.data = params.data
+      if (params.files) body.files = params.files
+      if (params.taskId) body.taskId = params.taskId
+      if (params.contextId) body.contextId = params.contextId
+      if (params.apiKey) body.apiKey = params.apiKey
+      return body
+    },
+  },
+
+  transformResponse: async (response: Response) => response.json(),
+
+  outputs: A2A_TASK_OUTPUTS,
+}

apps/sim/tools/a2a/types.ts

@@ -0,0 +1,63 @@
+import type { A2AAgentCardOutput, A2ATaskOutput } from '@/lib/a2a/client'
+import type { UserFile } from '@/executor/types'
+import type { OutputProperty, ToolResponse } from '@/tools/types'
+
+export interface A2ABaseParams {
+  agentUrl: string
+  apiKey?: string
+}
+
+export interface A2ASendMessageParams extends A2ABaseParams {
+  message: string
+  data?: unknown
+  files?: UserFile[]
+  taskId?: string
+  contextId?: string
+}
+
+export interface A2AGetTaskParams extends A2ABaseParams {
+  taskId: string
+  historyLength?: number
+}
+
+export interface A2ACancelTaskParams extends A2ABaseParams {
+  taskId: string
+}
+
+export type A2AGetAgentCardParams = A2ABaseParams
+
+export interface A2ATaskResponse extends ToolResponse {
+  output: A2ATaskOutput
+}
+
+export interface A2ACancelTaskResponse extends ToolResponse {
+  output: {
+    taskId: string
+    state: string
+    canceled: boolean
+  }
+}
+
+export interface A2AAgentCardResponse extends ToolResponse {
+  output: A2AAgentCardOutput
+}
+
+/** Shared output schema for the task-returning operations (send, get). */
+export const A2A_TASK_OUTPUTS = {
+  content: { type: 'string', description: 'Agent response text' },
+  taskId: { type: 'string', description: 'Task identifier' },
+  contextId: { type: 'string', description: 'Conversation/context identifier' },
+  state: { type: 'string', description: 'Task lifecycle state' },
+  artifacts: {
+    type: 'array',
+    description: 'Structured task output artifacts',
+    items: {
+      type: 'object',
+      properties: {
+        name: { type: 'string', description: 'Artifact name' },
+        description: { type: 'string', description: 'Artifact description' },
+        content: { type: 'string', description: 'Artifact text content' },
+      },
+    },
+  },
+} as const satisfies Record<string, OutputProperty>