@saccolabs/tars 1.15.0 → 1.16.0

package/dist/swarm/swarm-service.d.ts

@@ -0,0 +1,47 @@
+/**
+ * SwarmService — A2A Server for Tars Swarm.
+ *
+ * Exposes this Tars instance as a remote agent that other Tars instances
+ * (or any A2A-compliant agent) can discover and delegate tasks to.
+ *
+ * Endpoints:
+ *   GET  /.well-known/agent.json  → Agent Card (public, no auth)
+ *   POST /a2a                     → JSON-RPC handler (authenticated)
+ */
+import { Config } from '../config/config.js';
+import type { Supervisor } from '../supervisor/supervisor.js';
+export declare class SwarmService {
+    private readonly config;
+    private readonly supervisor;
+    private server;
+    constructor(config: Config, supervisor: Supervisor);
+    /**
+     * Starts the A2A HTTP server if swarm mode is enabled.
+     */
+    start(): Promise<void>;
+    /**
+     * Stops the A2A server gracefully.
+     */
+    stop(): void;
+    /**
+     * Main request router.
+     */
+    private handleRequest;
+    /**
+     * Serve the agent card. This endpoint is public (no auth required).
+     */
+    private handleAgentCard;
+    /**
+     * Handle A2A JSON-RPC requests. Requires authentication.
+     */
+    private handleA2A;
+    /**
+     * Validates the API key from the request headers.
+     */
+    private validateAuth;
+    /**
+     * Reads the request body up to MAX_BODY_SIZE.
+     * Returns null if the body exceeds the limit.
+     */
+    private readBody;
+}

package/dist/swarm/swarm-service.js

@@ -0,0 +1,207 @@
+/**
+ * SwarmService — A2A Server for Tars Swarm.
+ *
+ * Exposes this Tars instance as a remote agent that other Tars instances
+ * (or any A2A-compliant agent) can discover and delegate tasks to.
+ *
+ * Endpoints:
+ *   GET  /.well-known/agent.json  → Agent Card (public, no auth)
+ *   POST /a2a                     → JSON-RPC handler (authenticated)
+ */
+import http from 'http';
+import logger from '../utils/logger.js';
+import { buildAgentCard } from './agent-card.js';
+import { parseRPCRequest, handleRPCRequest } from './rpc-handler.js';
+/**
+ * Maximum request body size (1MB). Prevents abuse.
+ */
+const MAX_BODY_SIZE = 1024 * 1024;
+/**
+ * Swarm depth header — prevents infinite delegation loops.
+ * If a request arrives with X-Swarm-Depth >= MAX_DEPTH, the worker rejects it.
+ */
+const SWARM_DEPTH_HEADER = 'x-swarm-depth';
+const MAX_SWARM_DEPTH = 3;
+export class SwarmService {
+    config;
+    supervisor;
+    server = null;
+    constructor(config, supervisor) {
+        this.config = config;
+        this.supervisor = supervisor;
+    }
+    /**
+     * Starts the A2A HTTP server if swarm mode is enabled.
+     */
+    async start() {
+        if (!this.config.swarm.enabled) {
+            logger.debug('[Swarm] Swarm mode disabled, skipping.');
+            return;
+        }
+        if (!this.config.swarm.apiKey) {
+            logger.warn('⚠️ [Swarm] Swarm mode is enabled but SWARM_API_KEY is not set. Run `tars setup` to configure.');
+            return;
+        }
+        return new Promise((resolve) => {
+            this.server = http.createServer((req, res) => this.handleRequest(req, res));
+            this.server.listen(this.config.swarm.port, () => {
+                logger.info(`🌐 [Swarm] A2A server listening on port ${this.config.swarm.port}`);
+                logger.info(`🌐 [Swarm] Agent card: http://localhost:${this.config.swarm.port}/.well-known/agent.json`);
+                resolve();
+            });
+            this.server.on('error', (err) => {
+                if (err.code === 'EADDRINUSE') {
+                    logger.error(`❌ [Swarm] Port ${this.config.swarm.port} is already in use. Swarm server not started.`);
+                }
+                else {
+                    logger.error(`❌ [Swarm] Server error: ${err.message}`);
+                }
+                resolve();
+            });
+        });
+    }
+    /**
+     * Stops the A2A server gracefully.
+     */
+    stop() {
+        if (this.server) {
+            this.server.close();
+            this.server = null;
+            logger.info('🛑 [Swarm] A2A server stopped.');
+        }
+    }
+    /**
+     * Main request router.
+     */
+    async handleRequest(req, res) {
+        // CORS headers for broad compatibility
+        res.setHeader('Access-Control-Allow-Origin', '*');
+        res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
+        res.setHeader('Access-Control-Allow-Headers', 'Content-Type, X-API-Key, X-Swarm-Depth');
+        if (req.method === 'OPTIONS') {
+            res.writeHead(204);
+            res.end();
+            return;
+        }
+        const url = req.url || '/';
+        try {
+            if (req.method === 'GET' && url === '/.well-known/agent.json') {
+                return this.handleAgentCard(req, res);
+            }
+            if (req.method === 'POST' && url === '/a2a') {
+                return await this.handleA2A(req, res);
+            }
+            // Health check
+            if (req.method === 'GET' && url === '/health') {
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ status: 'ok', agent: this.config.assistantName }));
+                return;
+            }
+            res.writeHead(404, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ error: 'Not found' }));
+        }
+        catch (error) {
+            logger.error(`❌ [Swarm] Request handler error: ${error.message}`);
+            res.writeHead(500, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ error: 'Internal server error' }));
+        }
+    }
+    /**
+     * Serve the agent card. This endpoint is public (no auth required).
+     */
+    handleAgentCard(_req, res) {
+        const card = buildAgentCard(this.config);
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify(card, null, 2));
+    }
+    /**
+     * Handle A2A JSON-RPC requests. Requires authentication.
+     */
+    async handleA2A(req, res) {
+        // Auth check
+        if (!this.validateAuth(req)) {
+            res.writeHead(401, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({
+                jsonrpc: '2.0',
+                id: 0,
+                error: { code: -32000, message: 'Unauthorized: invalid or missing API key' }
+            }));
+            return;
+        }
+        // Swarm depth check (loop prevention)
+        const depthStr = req.headers[SWARM_DEPTH_HEADER];
+        const depth = depthStr ? parseInt(depthStr, 10) : 0;
+        if (depth >= MAX_SWARM_DEPTH) {
+            logger.warn(`⚠️ [Swarm] Rejecting request: swarm depth ${depth} >= max ${MAX_SWARM_DEPTH}`);
+            res.writeHead(429, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({
+                jsonrpc: '2.0',
+                id: 0,
+                error: {
+                    code: -32000,
+                    message: `Swarm delegation depth limit reached (max=${MAX_SWARM_DEPTH})`
+                }
+            }));
+            return;
+        }
+        // Read body
+        const body = await this.readBody(req);
+        if (body === null) {
+            res.writeHead(413, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({
+                jsonrpc: '2.0',
+                id: 0,
+                error: { code: -32000, message: 'Request body too large' }
+            }));
+            return;
+        }
+        // Parse JSON-RPC
+        const parsed = parseRPCRequest(body);
+        if ('error' in parsed) {
+            res.writeHead(400, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify(parsed.error));
+            return;
+        }
+        // Handle the RPC request
+        const result = await handleRPCRequest(parsed.request, this.supervisor);
+        const statusCode = result.error ? 400 : 200;
+        res.writeHead(statusCode, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify(result));
+    }
+    /**
+     * Validates the API key from the request headers.
+     */
+    validateAuth(req) {
+        const apiKey = req.headers['x-api-key'] ||
+            req.headers['authorization']?.replace(/^Bearer\s+/i, '');
+        if (!apiKey)
+            return false;
+        return apiKey === this.config.swarm.apiKey;
+    }
+    /**
+     * Reads the request body up to MAX_BODY_SIZE.
+     * Returns null if the body exceeds the limit.
+     */
+    readBody(req) {
+        return new Promise((resolve) => {
+            const chunks = [];
+            let totalSize = 0;
+            req.on('data', (chunk) => {
+                totalSize += chunk.length;
+                if (totalSize > MAX_BODY_SIZE) {
+                    req.destroy();
+                    resolve(null);
+                    return;
+                }
+                chunks.push(chunk);
+            });
+            req.on('end', () => {
+                resolve(Buffer.concat(chunks).toString('utf-8'));
+            });
+            req.on('error', () => {
+                resolve(null);
+            });
+        });
+    }
+}
+//# sourceMappingURL=swarm-service.js.map

package/dist/swarm/swarm-service.js.map

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

package/dist/swarm/types.d.ts

@@ -0,0 +1,109 @@
+/**
+ * A2A Protocol types for Tars Swarm
+ * Minimal subset of the Agent-to-Agent (A2A) protocol data model.
+ * @see https://a2a-protocol.org/latest/specification/
+ */
+export interface JSONRPCRequest {
+    jsonrpc: '2.0';
+    id: string | number;
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface JSONRPCResponse {
+    jsonrpc: '2.0';
+    id: string | number;
+    result?: unknown;
+    error?: JSONRPCError;
+}
+export interface JSONRPCError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+export declare const RPC_PARSE_ERROR = -32700;
+export declare const RPC_INVALID_REQUEST = -32600;
+export declare const RPC_METHOD_NOT_FOUND = -32601;
+export declare const RPC_INTERNAL_ERROR = -32603;
+export declare const A2A_TASK_NOT_FOUND = -32001;
+export declare const A2A_CONTENT_TYPE_NOT_SUPPORTED = -32002;
+export declare const A2A_UNSUPPORTED_OPERATION = -32003;
+export type TaskState = 'submitted' | 'working' | 'input-required' | 'completed' | 'canceled' | 'failed' | 'rejected';
+export interface TaskStatus {
+    state: TaskState;
+    message?: Message;
+    timestamp?: string;
+}
+export interface Part {
+    text?: string;
+    data?: string;
+    mimeType?: string;
+}
+export interface Message {
+    role: 'user' | 'agent';
+    parts: Part[];
+    metadata?: Record<string, unknown>;
+}
+export interface Artifact {
+    name?: string;
+    description?: string;
+    parts: Part[];
+    index?: number;
+}
+export interface Task {
+    id: string;
+    contextId?: string;
+    status: TaskStatus;
+    artifacts?: Artifact[];
+    history?: Message[];
+    metadata?: Record<string, unknown>;
+}
+export interface SendMessageParams {
+    message: Message;
+    configuration?: {
+        acceptedOutputModes?: string[];
+        blocking?: boolean;
+    };
+    metadata?: Record<string, unknown>;
+}
+export interface TaskQueryParams {
+    id: string;
+    historyLength?: number;
+}
+export interface TaskCancelParams {
+    id: string;
+}
+export interface AgentCardSkill {
+    id: string;
+    name: string;
+    description: string;
+    tags?: string[];
+    examples?: string[];
+    inputModes?: string[];
+    outputModes?: string[];
+}
+export interface AgentCardCapabilities {
+    streaming: boolean;
+    pushNotifications: boolean;
+    stateTransitionHistory: boolean;
+}
+export interface AgentCardInterface {
+    url: string;
+    protocolBinding: string;
+    protocolVersion: string;
+}
+export interface AgentCard {
+    name: string;
+    description: string;
+    supportedInterfaces: AgentCardInterface[];
+    provider?: {
+        organization: string;
+        url?: string;
+    };
+    version: string;
+    capabilities: AgentCardCapabilities;
+    securitySchemes: Record<string, unknown>;
+    security: Array<Record<string, string[]>>;
+    defaultInputModes: string[];
+    defaultOutputModes: string[];
+    skills: AgentCardSkill[];
+}

package/dist/swarm/types.js

@@ -0,0 +1,15 @@
+/**
+ * A2A Protocol types for Tars Swarm
+ * Minimal subset of the Agent-to-Agent (A2A) protocol data model.
+ * @see https://a2a-protocol.org/latest/specification/
+ */
+// Standard JSON-RPC error codes
+export const RPC_PARSE_ERROR = -32700;
+export const RPC_INVALID_REQUEST = -32600;
+export const RPC_METHOD_NOT_FOUND = -32601;
+export const RPC_INTERNAL_ERROR = -32603;
+// A2A-specific error codes
+export const A2A_TASK_NOT_FOUND = -32001;
+export const A2A_CONTENT_TYPE_NOT_SUPPORTED = -32002;
+export const A2A_UNSUPPORTED_OPERATION = -32003;
+//# sourceMappingURL=types.js.map

package/dist/swarm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/swarm/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAwBH,gCAAgC;AAChC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAK,CAAC;AACtC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAK,CAAC;AAC1C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAK,CAAC;AAC3C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAK,CAAC;AAEzC,2BAA2B;AAC3B,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAK,CAAC;AACzC,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,KAAK,CAAC;AACrD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,KAAK,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@saccolabs/tars",
-    "version": "1.15.0",
+    "version": "1.16.0",
     "description": "Tars — Your personal AI assistant",
     "publishConfig": {
         "access": "public"