im-hub-pro 0.2.29

package/dist/plugins/agents/acp/acp-client.d.ts

@@ -0,0 +1,32 @@
+import type { ChatMessage } from '../../../core/types.js';
+import type { ACPAgentConfig, ACPManifest } from './types.js';
+/**
+ * Build auth headers from ACP config. Extracted as a shared helper
+ * so both ACPClient and CLI config validation use the same logic.
+ */
+export declare function buildAuthHeaders(config: {
+    auth?: ACPAgentConfig['auth'];
+}): Record<string, string> | undefined;
+export declare class ACPClient {
+    private baseUrl;
+    private authHeaders?;
+    private manifest?;
+    constructor(config: ACPAgentConfig);
+    /** Fetch and cache the Agent Manifest (GET /agent/card) */
+    fetchManifest(): Promise<ACPManifest>;
+    /** Check if the agent endpoint is reachable */
+    healthCheck(): Promise<boolean>;
+    /**
+     * Send prompt and stream response chunks via SSE.
+     * Parses Server-Sent Events per the W3C spec:
+     * - Multiple `data:` lines for a single event are joined with newlines
+     * - Events separated by blank lines
+     *
+     * `sessionId` is forwarded as `session_id` in the request body so the
+     * remote agent can persist context across turns (P2-C).
+     */
+    streamPrompt(prompt: string, history?: ChatMessage[], sessionId?: string): AsyncGenerator<string>;
+    /** Send prompt and wait for complete response (non-streaming fallback) */
+    sendPromptSync(prompt: string, history?: ChatMessage[], sessionId?: string): Promise<string>;
+}
+//# sourceMappingURL=acp-client.d.ts.map

package/dist/plugins/agents/acp/acp-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-client.d.ts","sourceRoot":"","sources":["../../../../src/plugins/agents/acp/acp-client.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAyC,MAAM,YAAY,CAAA;AAEpG;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAM9G;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,WAAW,CAAC,CAAwB;IAC5C,OAAO,CAAC,QAAQ,CAAC,CAAa;gBAElB,MAAM,EAAE,cAAc;IAKlC,2DAA2D;IACrD,aAAa,IAAI,OAAO,CAAC,WAAW,CAAC;IAc3C,+CAA+C;IACzC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IASrC;;;;;;;;OAQG;IACI,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC;IAwFxG,0EAA0E;IACpE,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CA2BnG"}

package/dist/plugins/agents/acp/acp-client.js

@@ -0,0 +1,175 @@
+// ACP HTTP client — communicates with remote ACP-compatible agents
+//
+// ACP convention for endpoint paths (per OpenAPI spec):
+//   GET  /agent/card    → Agent Manifest
+//   POST /tasks         → Create task (sync or stream)
+//   GET  /tasks/{id}    → Get task status
+//
+// The user provides the base URL. We append these standard paths.
+/**
+ * Build auth headers from ACP config. Extracted as a shared helper
+ * so both ACPClient and CLI config validation use the same logic.
+ */
+export function buildAuthHeaders(config) {
+    if (!config.auth || config.auth.type === 'none')
+        return undefined;
+    if (!config.auth.token)
+        return undefined;
+    if (config.auth.type === 'bearer')
+        return { Authorization: `Bearer ${config.auth.token}` };
+    if (config.auth.type === 'apikey')
+        return { 'X-API-Key': config.auth.token };
+    return undefined;
+}
+export class ACPClient {
+    baseUrl;
+    authHeaders;
+    manifest;
+    constructor(config) {
+        this.baseUrl = config.endpoint.replace(/\/$/, '');
+        this.authHeaders = buildAuthHeaders(config);
+    }
+    /** Fetch and cache the Agent Manifest (GET /agent/card) */
+    async fetchManifest() {
+        const res = await fetch(`${this.baseUrl}/agent/card`, {
+            headers: { ...this.authHeaders, Accept: 'application/json' },
+            signal: AbortSignal.timeout(10000),
+        });
+        if (!res.ok) {
+            throw new Error(`Failed to fetch manifest: ${res.status} ${res.statusText}`);
+        }
+        this.manifest = (await res.json());
+        return this.manifest;
+    }
+    /** Check if the agent endpoint is reachable */
+    async healthCheck() {
+        try {
+            const manifest = await this.fetchManifest();
+            return !!manifest.name;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Send prompt and stream response chunks via SSE.
+     * Parses Server-Sent Events per the W3C spec:
+     * - Multiple `data:` lines for a single event are joined with newlines
+     * - Events separated by blank lines
+     *
+     * `sessionId` is forwarded as `session_id` in the request body so the
+     * remote agent can persist context across turns (P2-C).
+     */
+    async *streamPrompt(prompt, history, sessionId) {
+        const body = {
+            input: {
+                prompt,
+                history: history?.map((m) => ({ role: m.role, content: m.content })),
+            },
+            mode: 'stream',
+            ...(sessionId ? { session_id: sessionId } : {}),
+        };
+        const res = await fetch(`${this.baseUrl}/tasks`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...this.authHeaders,
+            },
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(300000), // 5min timeout for long tasks
+        });
+        if (!res.ok) {
+            const errorBody = await res.text().catch(() => 'unknown error');
+            throw new Error(`ACP task failed: ${res.status} ${errorBody}`);
+        }
+        // Parse SSE stream (W3C spec compliant)
+        const reader = res.body?.getReader();
+        if (!reader)
+            throw new Error('No response body for streaming');
+        const decoder = new TextDecoder();
+        let buffer = '';
+        let eventDataLines = [];
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            // Process complete lines
+            let newlineIdx;
+            while ((newlineIdx = buffer.indexOf('\n')) !== -1) {
+                const line = buffer.slice(0, newlineIdx).replace(/\r$/, '');
+                buffer = buffer.slice(newlineIdx + 1);
+                if (line === '') {
+                    // Empty line = end of event. Process accumulated data.
+                    if (eventDataLines.length > 0) {
+                        const data = eventDataLines.join('\n');
+                        eventDataLines = [];
+                        if (data === '[DONE]')
+                            return;
+                        try {
+                            const event = JSON.parse(data);
+                            if (event.output?.content) {
+                                yield event.output.content;
+                            }
+                            else if (event.error) {
+                                throw new Error(`ACP error: ${event.error.message}`);
+                            }
+                        }
+                        catch (e) {
+                            if (e instanceof SyntaxError)
+                                continue;
+                            throw e;
+                        }
+                    }
+                }
+                else if (line.startsWith('data: ')) {
+                    eventDataLines.push(line.slice(6));
+                }
+                else if (line.startsWith('data:')) {
+                    eventDataLines.push(line.slice(5).trimStart());
+                }
+                // Ignore comment lines (starting with ':') and other SSE fields
+            }
+        }
+        // Process any remaining data in buffer
+        if (eventDataLines.length > 0) {
+            const data = eventDataLines.join('\n');
+            if (data !== '[DONE]') {
+                try {
+                    const event = JSON.parse(data);
+                    if (event.output?.content)
+                        yield event.output.content;
+                }
+                catch {
+                    /* ignore trailing malformed data */
+                }
+            }
+        }
+    }
+    /** Send prompt and wait for complete response (non-streaming fallback) */
+    async sendPromptSync(prompt, history, sessionId) {
+        const body = {
+            input: {
+                prompt,
+                history: history?.map((m) => ({ role: m.role, content: m.content })),
+            },
+            mode: 'sync',
+            ...(sessionId ? { session_id: sessionId } : {}),
+        };
+        const res = await fetch(`${this.baseUrl}/tasks`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...this.authHeaders,
+            },
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(300000),
+        });
+        if (!res.ok) {
+            throw new Error(`ACP task failed: ${res.status}`);
+        }
+        const task = (await res.json());
+        return task.output?.content || '';
+    }
+}
+//# sourceMappingURL=acp-client.js.map

package/dist/plugins/agents/acp/acp-client.js.map

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

package/dist/plugins/agents/acp/discovery.d.ts

@@ -0,0 +1,19 @@
+import type { ACPAgentConfig } from './types.js';
+export interface DiscoveryResult {
+    baseUrl: string;
+    agents: ACPAgentConfig[];
+}
+/**
+ * Fetch and parse `<baseUrl>/.well-known/acp`. Trailing slashes are
+ * trimmed. Returns the discovery result on success; throws on network
+ * error, non-2xx status, or invalid JSON. Individual malformed agent
+ * entries are skipped silently with a warn log.
+ */
+export declare function discoverAgents(baseUrl: string): Promise<DiscoveryResult>;
+/**
+ * Discover from multiple base URLs in parallel. Failures on individual
+ * URLs are logged but don't fail the batch — partial results are
+ * returned. Useful for `discoveryUrls` config or REST API fan-out.
+ */
+export declare function discoverMany(baseUrls: string[]): Promise<DiscoveryResult[]>;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/plugins/agents/acp/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../../src/plugins/agents/acp/discovery.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAMhD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,cAAc,EAAE,CAAA;CACzB;AAgCD;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CA8B9E;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAWjF"}

package/dist/plugins/agents/acp/discovery.js

@@ -0,0 +1,109 @@
+// ACP agent discovery via the `.well-known/acp` HTTP endpoint.
+//
+// Convention: a host that wants to publish one or more ACP-compatible
+// agents serves a JSON document at <base>/.well-known/acp containing:
+//
+//   {
+//     "agents": [
+//       {
+//         "name": "weather-bot",
+//         "endpoint": "https://example.com/agents/weather",
+//         "aliases": ["w", "wx"],
+//         "auth": { "type": "bearer", "token": "..." },
+//         "description": "Real-time weather forecasts"
+//       },
+//       ...
+//     ]
+//   }
+//
+// The endpoint must be the BASE of the agent's ACP root — discovery
+// itself does not poke the agent's `/agent/card`; that's left to
+// ACPAdapter.isAvailable() at registration time.
+import { logger as rootLogger } from '../../../core/logger.js';
+const log = rootLogger.child({ component: 'acp-discovery' });
+const DISCOVERY_TIMEOUT_MS = 10_000;
+/**
+ * Validate one entry from the well-known doc. Returns a clean
+ * ACPAgentConfig or null if the entry is malformed.
+ */
+function validateEntry(raw) {
+    if (!raw || typeof raw !== 'object')
+        return null;
+    const r = raw;
+    if (typeof r.name !== 'string' || r.name.length === 0)
+        return null;
+    if (typeof r.endpoint !== 'string' || r.endpoint.length === 0)
+        return null;
+    const out = {
+        name: r.name,
+        endpoint: r.endpoint,
+    };
+    if (Array.isArray(r.aliases)) {
+        out.aliases = r.aliases.filter((a) => typeof a === 'string');
+    }
+    if (r.auth && typeof r.auth === 'object') {
+        const auth = r.auth;
+        if (auth.type === 'none' || auth.type === 'apikey' || auth.type === 'bearer') {
+            out.auth = {
+                type: auth.type,
+                token: typeof auth.token === 'string' ? auth.token : undefined,
+            };
+        }
+    }
+    if (typeof r.enabled === 'boolean')
+        out.enabled = r.enabled;
+    return out;
+}
+/**
+ * Fetch and parse `<baseUrl>/.well-known/acp`. Trailing slashes are
+ * trimmed. Returns the discovery result on success; throws on network
+ * error, non-2xx status, or invalid JSON. Individual malformed agent
+ * entries are skipped silently with a warn log.
+ */
+export async function discoverAgents(baseUrl) {
+    const cleaned = baseUrl.replace(/\/+$/, '');
+    const url = `${cleaned}/.well-known/acp`;
+    log.info({ url }, 'Discovering ACP agents');
+    const res = await fetch(url, {
+        headers: { Accept: 'application/json' },
+        signal: AbortSignal.timeout(DISCOVERY_TIMEOUT_MS),
+    });
+    if (!res.ok) {
+        throw new Error(`Discovery failed: ${res.status} ${res.statusText}`);
+    }
+    const body = (await res.json());
+    if (!body || !Array.isArray(body.agents)) {
+        throw new Error('Invalid discovery doc: missing `agents` array');
+    }
+    const agents = [];
+    for (const raw of body.agents) {
+        const entry = validateEntry(raw);
+        if (entry) {
+            agents.push(entry);
+        }
+        else {
+            log.warn({ raw }, 'Skipping malformed agent entry');
+        }
+    }
+    log.info({ baseUrl: cleaned, count: agents.length }, 'Discovery complete');
+    return { baseUrl: cleaned, agents };
+}
+/**
+ * Discover from multiple base URLs in parallel. Failures on individual
+ * URLs are logged but don't fail the batch — partial results are
+ * returned. Useful for `discoveryUrls` config or REST API fan-out.
+ */
+export async function discoverMany(baseUrls) {
+    const results = await Promise.allSettled(baseUrls.map((u) => discoverAgents(u)));
+    const out = [];
+    results.forEach((r, i) => {
+        if (r.status === 'fulfilled') {
+            out.push(r.value);
+        }
+        else {
+            log.warn({ baseUrl: baseUrls[i], error: String(r.reason) }, 'Discovery failed');
+        }
+    });
+    return out;
+}
+//# sourceMappingURL=discovery.js.map

package/dist/plugins/agents/acp/discovery.js.map

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

package/dist/plugins/agents/acp/index.d.ts

@@ -0,0 +1,4 @@
+export { ACPAdapter } from './acp-adapter.js';
+export { ACPClient } from './acp-client.js';
+export type { ACPAgentConfig, ACPManifest, ACPCapability } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/agents/acp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/agents/acp/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA"}

package/dist/plugins/agents/acp/index.js

@@ -0,0 +1,4 @@
+// ACP agent adapter — export adapter and config loader
+export { ACPAdapter } from './acp-adapter.js';
+export { ACPClient } from './acp-client.js';
+//# sourceMappingURL=index.js.map

package/dist/plugins/agents/acp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/plugins/agents/acp/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/plugins/agents/acp/types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * ACP Agent Manifest — describes agent capabilities.
+ * Fetched from GET /agent/card per the ACP spec.
+ */
+export interface ACPManifest {
+    name: string;
+    description?: string;
+    version?: string;
+    capabilities: ACPCapability[];
+}
+export interface ACPCapability {
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
+}
+/** ACP Task creation request (POST /tasks) */
+export interface ACPCreateTaskRequest {
+    input: {
+        prompt: string;
+        history?: Array<{
+            role: string;
+            content: string;
+        }>;
+    };
+    mode: 'sync' | 'stream';
+    /**
+     * Stable session identifier — passed through so the remote agent can
+     * thread context across multi-turn conversations. Not part of the
+     * upstream ACP spec yet; the remote may ignore it (the field is in
+     * the request body, not headers, so unknown-field-tolerant parsers
+     * pass it through fine).
+     */
+    session_id?: string;
+}
+/** ACP Task response */
+export interface ACPTaskResponse {
+    id: string;
+    status: 'pending' | 'running' | 'completed' | 'failed';
+    output?: {
+        content: string;
+    };
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+/**
+ * Configuration for a remote ACP agent.
+ * Stored in ~/.im-hub/config.json under the "acpAgents" key.
+ */
+export interface ACPAgentConfig {
+    name: string;
+    aliases?: string[];
+    endpoint: string;
+    auth?: {
+        type: 'none' | 'apikey' | 'bearer';
+        token?: string;
+    };
+    enabled?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/agents/acp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/plugins/agents/acp/types.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,aAAa,EAAE,CAAA;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACvC;AAED,8CAA8C;AAC9C,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE;QACL,MAAM,EAAE,MAAM,CAAA;QACd,OAAO,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KACnD,CAAA;IACD,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAA;IACvB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,wBAAwB;AACxB,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAA;IACtD,MAAM,CAAC,EAAE;QACP,OAAO,EAAE,MAAM,CAAA;KAChB,CAAA;IACD,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,CAAA;KAChB,CAAA;CACF;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE;QACL,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAA;QAClC,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;IACD,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB"}

package/dist/plugins/agents/acp/types.js

@@ -0,0 +1,5 @@
+// ACP (Agent Communication Protocol) types
+// Based on the ACP OpenAPI specification
+// @see https://github.com/i-am-bee/acp/blob/main/docs/spec/openapi.yaml
+export {};
+//# sourceMappingURL=types.js.map

package/dist/plugins/agents/acp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/plugins/agents/acp/types.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,yCAAyC;AACzC,wEAAwE"}

package/dist/plugins/agents/claude-code/adapter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=adapter.test.d.ts.map

package/dist/plugins/agents/claude-code/adapter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.test.d.ts","sourceRoot":"","sources":["../../../../src/plugins/agents/claude-code/adapter.test.ts"],"names":[],"mappings":""}