synthos 0.7.1 → 0.8.0

package/required-pages/synthos_apis.html

@@ -261,12 +261,67 @@
                     <div class="api-output"></div>
                 </div>
             </div>
+            <div class="api-section">
+                <div class="api-header" onclick="toggleSection(this)">GET /api/agents</div>
+                <div class="api-content">
+                    Lists configured agents (A2A and OpenClaw). Supports optional filters: enabled (boolean) and provider (a2a|openclaw). Returns id, name, description, url, enabled, provider, and capabilities for each agent.
+                    <div class="api-input">
+                        <select id="agentListEnabled">
+                            <option value="">All</option>
+                            <option value="true">Enabled only</option>
+                        </select>
+                        <select id="agentListProvider">
+                            <option value="">All providers</option>
+                            <option value="a2a">A2A</option>
+                            <option value="openclaw">OpenClaw</option>
+                        </select>
+                        <button onclick="listAgents(event)">Submit</button>
+                    </div>
+                    <div class="api-output"></div>
+                </div>
+            </div>
+            <div class="api-section">
+                <div class="api-header" onclick="toggleSection(this)">POST /api/agents/:id/send</div>
+                <div class="api-content">
+                    Sends a text message to an agent (works for both A2A and OpenClaw protocols). Returns a normalized response: { kind: 'message'|'task', text?: string, raw: object }. Optionally include an attachments array: [{ fileName: string, mimeType: string, content: string (base64 for binary) }].
+                    <div class="api-input">
+                        <input type="text" placeholder="Agent ID" id="agentSendId">
+                        <textarea placeholder="Message" id="agentSendMessage"></textarea>
+                        <button onclick="sendAgentMessage(event)">Send</button>
+                    </div>
+                    <div class="api-output"></div>
+                </div>
+            </div>
+            <div class="api-section">
+                <div class="api-header" onclick="toggleSection(this)">POST /api/agents/:id/stream</div>
+                <div class="api-content">
+                    Sends a message and receives a streaming SSE response. Each event is JSON: { kind: 'text'|'status'|'artifact'|'done'|'error', data: any }. The stream ends with a [DONE] sentinel. Optionally include an attachments array: [{ fileName: string, mimeType: string, content: string (base64 for binary) }].
+                    <div class="api-input">
+                        <input type="text" placeholder="Agent ID" id="agentStreamId">
+                        <textarea placeholder="Message" id="agentStreamMessage"></textarea>
+                        <button onclick="streamAgentMessage(event)">Stream</button>
+                    </div>
+                    <div class="api-output"></div>
+                </div>
+            </div>
+            <div class="api-section">
+                <div class="api-header" onclick="toggleSection(this)">PATCH /api/agents/:id</div>
+                <div class="api-content">
+                    Toggle an agent's enabled/disabled state or update its name and description. Send only the fields to change.
+                    <div class="api-input">
+                        <input type="text" placeholder="Agent ID" id="agentPatchId">
+                        <textarea placeholder="{ &quot;enabled&quot;: true }" id="agentPatchBody"></textarea>
+                        <button onclick="patchAgent(event)">Submit</button>
+                    </div>
+                    <div class="api-output"></div>
+                </div>
+            </div>
         </div>
         <div id="loadingOverlay" class="loading-overlay"><div class="spinner"></div></div>
     </div>
     <div id="instructions" style="display: none;" data-locked="true"></div>
     <div id="thoughts" style="display: none;" data-locked="true"></div>
-    <script id="api-explorer">function toggleSection(header){const content=header.nextElementSibling;content.style.display="block"===content.style.display?"none":"block"}function callApi(event,method,endpoint){event.preventDefault();const button=event.target;button.disabled=!0;const inputs=event.target.parentElement.querySelectorAll("input, textarea");let url=endpoint,data={};inputs.forEach(input=>{"Page Name"===input.placeholder?url+=input.value:"Table Name"===input.placeholder||"ID"===input.placeholder?url+="/"+input.value:"JSON Data"===input.placeholder&&(data=JSON.parse(input.value))}),fetch(url,{method:method,headers:{"Content-Type":"application/json"},body:"POST"===method?JSON.stringify(data):null}).then(response=>response.json()).then(data=>{console.log("Success:",data),event.target.parentElement.nextElementSibling.textContent=JSON.stringify(data,null,2)}).catch(error=>{console.error("Error:",error),alert("API call failed! Check console for details.")}).finally(()=>{button.disabled=!1})}function callPaginatedApi(event){event.preventDefault();const button=event.target;button.disabled=!0;const inputs=event.target.parentElement.querySelectorAll("input");let page="",table="",limit="",offset="";inputs.forEach(input=>{"Page Name"===input.placeholder?page=input.value:"Table Name"===input.placeholder?table=input.value:"Limit"===input.placeholder?limit=input.value:"Offset (optional)"===input.placeholder&&(offset=input.value)});let url="/api/data/"+encodeURIComponent(page)+"/"+encodeURIComponent(table)+"?limit="+encodeURIComponent(limit);offset&&(url+="&offset="+encodeURIComponent(offset)),fetch(url).then(response=>response.json()).then(data=>{event.target.parentElement.nextElementSibling.textContent=JSON.stringify(data,null,2)}).catch(error=>{console.error("Error:",error),alert("API call failed! Check console for details.")}).finally(()=>{button.disabled=!1})}function callPageApi(event,method,suffix){event.preventDefault();const button=event.target;button.disabled=!0;const inputs=event.target.parentElement.querySelectorAll("input, textarea");let pageName="",data=null;inputs.forEach(input=>{"Page Name"===input.placeholder?pageName=input.value:"TEXTAREA"===input.tagName&&(data=JSON.parse(input.value))});const url="/api/pages/"+encodeURIComponent(pageName)+(suffix||"");fetch(url,{method:method,headers:{"Content-Type":"application/json"},body:"POST"===method?JSON.stringify(data):null}).then(response=>response.json()).then(data=>{event.target.parentElement.nextElementSibling.textContent=JSON.stringify(data,null,2)}).catch(error=>{console.error("Error:",error),alert("API call failed! Check console for details.")}).finally(()=>{button.disabled=!1})}function generateImage(event){event.preventDefault();const button=event.target;button.disabled=!0;const prompt=document.getElementById("imagePrompt").value,shape=document.getElementById("imageShape").value,style=document.getElementById("imageStyle").value,outputBox=event.target.parentElement.nextElementSibling;fetch("/api/generate/image",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({prompt:prompt,shape:shape,style:style})}).then(response=>response.json()).then(data=>{if(console.log("Success:",data),outputBox.textContent=JSON.stringify(data,null,2),data.url){const img=document.createElement("img");img.src=data.url,img.alt="Generated Image",img.className="generated-image",outputBox.appendChild(img)}}).catch(error=>{console.error("Error:",error),alert("Image generation failed! Check console for details.")}).finally(()=>{button.disabled=!1})}function generateCompletion(event){event.preventDefault();const button=event.target;button.disabled=!0;const prompt=document.getElementById("completionPrompt").value,temperature=document.getElementById("completionTemperature").value,outputBox=event.target.parentElement.nextElementSibling;fetch("/api/generate/completion",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({prompt:prompt,temperature:parseFloat(temperature)||void 0})}).then(response=>response.json()).then(data=>{console.log("Success:",data),outputBox.textContent=JSON.stringify(data,null,2)}).catch(error=>{console.error("Error:",error),alert("Completion generation failed! Check console for details.")}).finally(()=>{button.disabled=!1})}function webSearch(event){event.preventDefault();var button=event.target;button.disabled=!0;var query=document.getElementById("webSearchQuery").value,count=document.getElementById("webSearchCount").value,outputBox=event.target.parentElement.nextElementSibling,body={query:query};count&&(body.count=parseInt(count,10)),fetch("/api/search/web",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(body)}).then(function(response){return response.json()}).then(function(data){outputBox.textContent=JSON.stringify(data,null,2)}).catch(function(error){console.error("Error:",error),alert("Web search failed! Check console for details.")}).finally(function(){button.disabled=!1})}function executeScript(event){event.preventDefault();const button=event.target;button.disabled=!0;const scriptId=document.getElementById("scriptId").value,variables=JSON.parse(document.getElementById("scriptVariables").value),outputBox=event.target.parentElement.nextElementSibling;fetch(`/api/scripts/${scriptId}`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(variables)}).then(response=>response.json()).then(data=>{console.log("Success:",data),outputBox.textContent=JSON.stringify(data,null,2)}).catch(error=>{console.error("Error:",error),alert("Script execution failed! Check console for details.")}).finally(()=>{button.disabled=!1})}function listConnectors(event){event.preventDefault();var button=event.target;button.disabled=!0;var category=document.getElementById("connectorListCategory").value;var url="/api/connectors";if(category)url+="?category="+encodeURIComponent(category);var outputBox=event.target.parentElement.nextElementSibling;fetch(url).then(function(r){return r.json()}).then(function(data){outputBox.textContent=JSON.stringify(data,null,2)}).catch(function(err){console.error("Error:",err);alert("Failed! Check console.")}).finally(function(){button.disabled=!1})}function getConnectorDetail(event){event.preventDefault();var button=event.target;button.disabled=!0;var id=document.getElementById("connectorDetailId").value;var outputBox=event.target.parentElement.nextElementSibling;fetch("/api/connectors/"+encodeURIComponent(id)).then(function(r){return r.json()}).then(function(data){outputBox.textContent=JSON.stringify(data,null,2)}).catch(function(err){console.error("Error:",err);alert("Failed! Check console.")}).finally(function(){button.disabled=!1})}function callConnector(event){event.preventDefault();var button=event.target;button.disabled=!0;var body={connector:document.getElementById("connectorCallId").value,method:document.getElementById("connectorCallMethod").value,path:document.getElementById("connectorCallPath").value};var queryVal=document.getElementById("connectorCallQuery").value;if(queryVal)try{body.query=JSON.parse(queryVal)}catch(e){}var bodyVal=document.getElementById("connectorCallBody").value;if(bodyVal)try{body.body=JSON.parse(bodyVal)}catch(e){}var outputBox=event.target.parentElement.nextElementSibling;fetch("/api/connectors",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(body)}).then(function(r){return r.json()}).then(function(data){outputBox.textContent=JSON.stringify(data,null,2)}).catch(function(err){console.error("Error:",err);alert("Failed! Check console.")}).finally(function(){button.disabled=!1})}</script>
+    <script id="api-explorer">function toggleSection(header){const content=header.nextElementSibling;content.style.display="block"===content.style.display?"none":"block"}function callApi(event,method,endpoint){event.preventDefault();const button=event.target;button.disabled=!0;const inputs=event.target.parentElement.querySelectorAll("input, textarea");let url=endpoint,data={};inputs.forEach(input=>{"Page Name"===input.placeholder?url+=input.value:"Table Name"===input.placeholder||"ID"===input.placeholder?url+="/"+input.value:"JSON Data"===input.placeholder&&(data=JSON.parse(input.value))}),fetch(url,{method:method,headers:{"Content-Type":"application/json"},body:"POST"===method?JSON.stringify(data):null}).then(response=>response.json()).then(data=>{console.log("Success:",data),event.target.parentElement.nextElementSibling.textContent=JSON.stringify(data,null,2)}).catch(error=>{console.error("Error:",error),alert("API call failed! Check console for details.")}).finally(()=>{button.disabled=!1})}function callPaginatedApi(event){event.preventDefault();const button=event.target;button.disabled=!0;const inputs=event.target.parentElement.querySelectorAll("input");let page="",table="",limit="",offset="";inputs.forEach(input=>{"Page Name"===input.placeholder?page=input.value:"Table Name"===input.placeholder?table=input.value:"Limit"===input.placeholder?limit=input.value:"Offset (optional)"===input.placeholder&&(offset=input.value)});let url="/api/data/"+encodeURIComponent(page)+"/"+encodeURIComponent(table)+"?limit="+encodeURIComponent(limit);offset&&(url+="&offset="+encodeURIComponent(offset)),fetch(url).then(response=>response.json()).then(data=>{event.target.parentElement.nextElementSibling.textContent=JSON.stringify(data,null,2)}).catch(error=>{console.error("Error:",error),alert("API call failed! Check console for details.")}).finally(()=>{button.disabled=!1})}function callPageApi(event,method,suffix){event.preventDefault();const button=event.target;button.disabled=!0;const inputs=event.target.parentElement.querySelectorAll("input, textarea");let pageName="",data=null;inputs.forEach(input=>{"Page Name"===input.placeholder?pageName=input.value:"TEXTAREA"===input.tagName&&(data=JSON.parse(input.value))});const url="/api/pages/"+encodeURIComponent(pageName)+(suffix||"");fetch(url,{method:method,headers:{"Content-Type":"application/json"},body:"POST"===method?JSON.stringify(data):null}).then(response=>response.json()).then(data=>{event.target.parentElement.nextElementSibling.textContent=JSON.stringify(data,null,2)}).catch(error=>{console.error("Error:",error),alert("API call failed! Check console for details.")}).finally(()=>{button.disabled=!1})}function generateImage(event){event.preventDefault();const button=event.target;button.disabled=!0;const prompt=document.getElementById("imagePrompt").value,shape=document.getElementById("imageShape").value,style=document.getElementById("imageStyle").value,outputBox=event.target.parentElement.nextElementSibling;fetch("/api/generate/image",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({prompt:prompt,shape:shape,style:style})}).then(response=>response.json()).then(data=>{if(console.log("Success:",data),outputBox.textContent=JSON.stringify(data,null,2),data.url){const img=document.createElement("img");img.src=data.url,img.alt="Generated Image",img.className="generated-image",outputBox.appendChild(img)}}).catch(error=>{console.error("Error:",error),alert("Image generation failed! Check console for details.")}).finally(()=>{button.disabled=!1})}function generateCompletion(event){event.preventDefault();const button=event.target;button.disabled=!0;const prompt=document.getElementById("completionPrompt").value,temperature=document.getElementById("completionTemperature").value,outputBox=event.target.parentElement.nextElementSibling;fetch("/api/generate/completion",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({prompt:prompt,temperature:parseFloat(temperature)||void 0})}).then(response=>response.json()).then(data=>{console.log("Success:",data),outputBox.textContent=JSON.stringify(data,null,2)}).catch(error=>{console.error("Error:",error),alert("Completion generation failed! Check console for details.")}).finally(()=>{button.disabled=!1})}function webSearch(event){event.preventDefault();var button=event.target;button.disabled=!0;var query=document.getElementById("webSearchQuery").value,count=document.getElementById("webSearchCount").value,outputBox=event.target.parentElement.nextElementSibling,body={query:query};count&&(body.count=parseInt(count,10)),fetch("/api/search/web",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(body)}).then(function(response){return response.json()}).then(function(data){outputBox.textContent=JSON.stringify(data,null,2)}).catch(function(error){console.error("Error:",error),alert("Web search failed! Check console for details.")}).finally(function(){button.disabled=!1})}function executeScript(event){event.preventDefault();const button=event.target;button.disabled=!0;const scriptId=document.getElementById("scriptId").value,variables=JSON.parse(document.getElementById("scriptVariables").value),outputBox=event.target.parentElement.nextElementSibling;fetch(`/api/scripts/${scriptId}`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(variables)}).then(response=>response.json()).then(data=>{console.log("Success:",data),outputBox.textContent=JSON.stringify(data,null,2)}).catch(error=>{console.error("Error:",error),alert("Script execution failed! Check console for details.")}).finally(()=>{button.disabled=!1})}function listConnectors(event){event.preventDefault();var button=event.target;button.disabled=!0;var category=document.getElementById("connectorListCategory").value;var url="/api/connectors";if(category)url+="?category="+encodeURIComponent(category);var outputBox=event.target.parentElement.nextElementSibling;fetch(url).then(function(r){return r.json()}).then(function(data){outputBox.textContent=JSON.stringify(data,null,2)}).catch(function(err){console.error("Error:",err);alert("Failed! Check console.")}).finally(function(){button.disabled=!1})}function getConnectorDetail(event){event.preventDefault();var button=event.target;button.disabled=!0;var id=document.getElementById("connectorDetailId").value;var outputBox=event.target.parentElement.nextElementSibling;fetch("/api/connectors/"+encodeURIComponent(id)).then(function(r){return r.json()}).then(function(data){outputBox.textContent=JSON.stringify(data,null,2)}).catch(function(err){console.error("Error:",err);alert("Failed! Check console.")}).finally(function(){button.disabled=!1})}function callConnector(event){event.preventDefault();var button=event.target;button.disabled=!0;var body={connector:document.getElementById("connectorCallId").value,method:document.getElementById("connectorCallMethod").value,path:document.getElementById("connectorCallPath").value};var queryVal=document.getElementById("connectorCallQuery").value;if(queryVal)try{body.query=JSON.parse(queryVal)}catch(e){}var bodyVal=document.getElementById("connectorCallBody").value;if(bodyVal)try{body.body=JSON.parse(bodyVal)}catch(e){}var outputBox=event.target.parentElement.nextElementSibling;fetch("/api/connectors",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(body)}).then(function(r){return r.json()}).then(function(data){outputBox.textContent=JSON.stringify(data,null,2)}).catch(function(err){console.error("Error:",err);alert("Failed! Check console.")}).finally(function(){button.disabled=!1})}function listAgents(event){event.preventDefault();var button=event.target;button.disabled=!0;var enabled=document.getElementById("agentListEnabled").value;var provider=document.getElementById("agentListProvider").value;var url="/api/agents";var params=[];if(enabled)params.push("enabled="+enabled);if(provider)params.push("provider="+encodeURIComponent(provider));if(params.length)url+="?"+params.join("&");var outputBox=event.target.parentElement.nextElementSibling;fetch(url).then(function(r){return r.json()}).then(function(data){outputBox.textContent=JSON.stringify(data,null,2)}).catch(function(err){console.error("Error:",err);alert("Failed! Check console.")}).finally(function(){button.disabled=!1})}function sendAgentMessage(event){event.preventDefault();var button=event.target;button.disabled=!0;var id=document.getElementById("agentSendId").value;var message=document.getElementById("agentSendMessage").value;var outputBox=event.target.parentElement.nextElementSibling;fetch("/api/agents/"+encodeURIComponent(id)+"/send",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({message:message})}).then(function(r){return r.json()}).then(function(data){outputBox.textContent=JSON.stringify(data,null,2)}).catch(function(err){console.error("Error:",err);alert("Failed! Check console.")}).finally(function(){button.disabled=!1})}function streamAgentMessage(event){event.preventDefault();var button=event.target;button.disabled=!0;var id=document.getElementById("agentStreamId").value;var message=document.getElementById("agentStreamMessage").value;var outputBox=event.target.parentElement.nextElementSibling;outputBox.textContent="Streaming...\n";fetch("/api/agents/"+encodeURIComponent(id)+"/stream",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({message:message})}).then(function(res){var reader=res.body.getReader();var decoder=new TextDecoder();var buffer="";function pump(){return reader.read().then(function(result){if(result.done){button.disabled=!1;return}buffer+=decoder.decode(result.value,{stream:!0});var lines=buffer.split("\n");buffer=lines.pop()||"";for(var i=0;i<lines.length;i++){var line=lines[i];if(line.indexOf("data: ")===0){var data=line.substring(6);if(data==="[DONE]"){outputBox.textContent+="\n[DONE]";button.disabled=!1;return}try{var event=JSON.parse(data);outputBox.textContent+=JSON.stringify(event)+"\n"}catch(e){}}}return pump()})}return pump()}).catch(function(err){console.error("Error:",err);outputBox.textContent+="Error: "+err.message;button.disabled=!1})}function patchAgent(event){event.preventDefault();var button=event.target;button.disabled=!0;var id=document.getElementById("agentPatchId").value;var body;try{body=JSON.parse(document.getElementById("agentPatchBody").value)}catch(e){alert("Invalid JSON");button.disabled=!1;return}var outputBox=event.target.parentElement.nextElementSibling;fetch("/api/agents/"+encodeURIComponent(id),{method:"PATCH",headers:{"Content-Type":"application/json"},body:JSON.stringify(body)}).then(function(r){return r.json()}).then(function(data){outputBox.textContent=JSON.stringify(data,null,2)}).catch(function(err){console.error("Error:",err);alert("Failed! Check console.")}).finally(function(){button.disabled=!1})}</script>
 <script id="page-helpers" src="/api/page-helpers.js?v=2" data-locked="true"></script>
 <script id="page-script" src="/api/page-script.js?v=2" data-locked="true"></script>
 </body></html>

package/src/agents/a2a/a2aProvider.ts

@@ -0,0 +1,110 @@
+import { v4 as uuidv4 } from 'uuid';
+import { AgentConfig, AgentResponse, AgentEvent, AgentProvider, Attachment } from '../types';
+
+/**
+ * Extract readable text from an A2A response (Message or Task object).
+ */
+function extractText(raw: unknown): string | undefined {
+    if (!raw || typeof raw !== 'object') return undefined;
+    const obj = raw as Record<string, unknown>;
+
+    // A2A Message shape: { kind: 'message', parts: [{ kind: 'text', text: '...' }] }
+    if (obj.kind === 'message' && Array.isArray(obj.parts)) {
+        const texts = (obj.parts as Array<Record<string, unknown>>)
+            .filter(p => p.kind === 'text' && typeof p.text === 'string')
+            .map(p => p.text as string);
+        if (texts.length > 0) return texts.join('\n');
+    }
+
+    // A2A Task shape: { kind: 'task', status: { message: { parts: [...] } } }
+    if (obj.kind === 'task' && obj.status && typeof obj.status === 'object') {
+        const status = obj.status as Record<string, unknown>;
+        if (status.message) {
+            return extractText(status.message);
+        }
+    }
+
+    // Fallback: look for a result.message in the response
+    if (obj.result && typeof obj.result === 'object') {
+        return extractText(obj.result);
+    }
+
+    return undefined;
+}
+
+export const a2aProvider: AgentProvider = {
+    async send(agent: AgentConfig, message: string, _attachments?: Attachment[]): Promise<AgentResponse> {
+        const { A2AClient } = await import('@a2a-js/sdk/client');
+        const cardUrl = agent.url.replace(/\/+$/, '') + '/.well-known/agent-card.json';
+        const client = new A2AClient(cardUrl);
+
+        const sendResult = await client.sendMessage({
+            message: {
+                kind: 'message' as const,
+                role: 'user' as const,
+                messageId: uuidv4(),
+                parts: [{ kind: 'text' as const, text: message }]
+            }
+        });
+
+        const raw = sendResult as unknown;
+        const rawObj = raw as Record<string, unknown>;
+        const kind = rawObj.kind === 'task' ? 'task' : 'message';
+
+        return {
+            kind,
+            text: extractText(raw),
+            raw,
+            taskId: kind === 'task' ? (rawObj.id as string | undefined) : undefined,
+            status: kind === 'task' ? ((rawObj.status as Record<string, unknown>)?.state as string | undefined) : undefined,
+        };
+    },
+
+    async *sendStream(agent: AgentConfig, message: string, _attachments?: Attachment[]): AsyncIterable<AgentEvent> {
+        // If the agent supports streaming, use SSE-based streaming via A2A SDK
+        if (!agent.capabilities?.streaming) {
+            // Fallback: send a regular message and yield the result as a single event
+            const response = await a2aProvider.send(agent, message);
+            if (response.text) {
+                yield { kind: 'text', data: response.text };
+            }
+            yield { kind: 'done', data: response.raw };
+            return;
+        }
+
+        // A2A streaming via sendSubscribe (if available in the SDK)
+        try {
+            const { A2AClient } = await import('@a2a-js/sdk/client');
+            const cardUrl = agent.url.replace(/\/+$/, '') + '/.well-known/agent-card.json';
+            const client = new A2AClient(cardUrl);
+
+            const stream = client.sendMessageStream({
+                message: {
+                    kind: 'message' as const,
+                    role: 'user' as const,
+                    messageId: uuidv4(),
+                    parts: [{ kind: 'text' as const, text: message }]
+                }
+            });
+
+            for await (const event of stream) {
+                const eventObj = event as unknown as Record<string, unknown>;
+                if (eventObj.kind === 'status-update') {
+                    yield { kind: 'status', data: eventObj };
+                } else if (eventObj.kind === 'artifact-update') {
+                    yield { kind: 'artifact', data: eventObj };
+                } else {
+                    yield { kind: 'text', data: eventObj };
+                }
+            }
+
+            yield { kind: 'done', data: null };
+        } catch (err) {
+            yield { kind: 'error', data: err instanceof Error ? err.message : String(err) };
+        }
+    },
+
+    supportsStreaming(agent: AgentConfig): boolean {
+        return agent.capabilities?.streaming === true;
+    }
+};

package/src/agents/discovery.ts

@@ -0,0 +1,74 @@
+import { httpBaseUrl } from './openclaw/gatewayManager';
+
+// ---------------------------------------------------------------------------
+// A2A Discovery
+// ---------------------------------------------------------------------------
+
+export interface A2ADiscoveryResult {
+    name: string;
+    description: string;
+    url: string;
+    iconUrl?: string;
+    capabilities?: { streaming?: boolean; pushNotifications?: boolean };
+    skills?: { id: string; name: string; description: string; tags: string[] }[];
+}
+
+/**
+ * Discover an A2A agent by fetching its agent card from /.well-known/agent-card.json.
+ */
+export async function discoverA2AAgent(url: string): Promise<A2ADiscoveryResult> {
+    const cardUrl = url.replace(/\/+$/, '') + '/.well-known/agent-card.json';
+    const res = await fetch(cardUrl);
+    if (!res.ok) {
+        throw new Error(`Failed to fetch agent card: ${res.status} ${res.statusText}`);
+    }
+
+    const card = await res.json() as Record<string, unknown>;
+    return {
+        name: (card.name as string) ?? '',
+        description: (card.description as string) ?? '',
+        url: (card.url as string) ?? url,
+        iconUrl: (card as Record<string, string>).iconUrl ?? undefined,
+        capabilities: (card.capabilities as A2ADiscoveryResult['capabilities']) ?? {},
+        skills: (card.skills as A2ADiscoveryResult['skills']) ?? [],
+    };
+}
+
+// ---------------------------------------------------------------------------
+// OpenClaw Discovery
+// ---------------------------------------------------------------------------
+
+export interface OpenClawDiscoveryResult {
+    name: string;
+    verified: boolean;
+}
+
+/**
+ * Verify an OpenClaw gateway is reachable and authenticated by probing
+ * the HTTP API (GET /v1/models with Bearer token).
+ */
+export async function discoverOpenClawAgent(url: string, token: string): Promise<OpenClawDiscoveryResult> {
+    const baseUrl = httpBaseUrl({ url });
+
+    const res = await fetch(`${baseUrl}/v1/models`, {
+        headers: { 'Authorization': `Bearer ${token}` },
+    });
+
+    if (!res.ok) {
+        throw new Error(`OpenClaw probe failed (${res.status}): ${await res.text()}`);
+    }
+
+    // Try to extract a name from the models response
+    let name = 'OpenClaw Agent';
+    try {
+        const data = await res.json() as Record<string, unknown>;
+        const models = (data.data ?? data.models) as Array<Record<string, unknown>> | undefined;
+        if (Array.isArray(models) && models.length > 0) {
+            name = (models[0].id as string) ?? name;
+        }
+    } catch {
+        // Response parsed but no useful data — that's fine
+    }
+
+    return { name, verified: true };
+}

package/src/agents/index.ts

@@ -0,0 +1,6 @@
+export { AgentConfig, AgentResponse, AgentEvent, AgentProvider, Attachment, ChatMessage } from './types';
+export { a2aProvider } from './a2a/a2aProvider';
+export { openclawProvider } from './openclaw/openclawProvider';
+export { connectAgent, disconnectAgent, getAgentStatus } from './openclaw/gatewayManager';
+export { startTunnel, stopTunnel, getTunnelStatus } from './openclaw/sshTunnelManager';
+export { discoverA2AAgent, discoverOpenClawAgent } from './discovery';