@toolpack-sdk/agents 2.1.0 → 2.2.0

package/dist/{index-Du6S0eG7.d.cts → index-DVhRtkNq.d.cts}

@@ -924,4 +924,78 @@ declare class SMSChannel extends BaseChannel {
     stop(): Promise<void>;
 }
 
-export { BaseChannel as B, type CreateJobOptions as C, DiscordChannel as D, EmailChannel as E, type JobStatus as J, SchedulerStore as S, TelegramChannel as T, WebhookChannel as W, type CreateJobResult as a, type DiscordChannelConfig as b, type EmailChannelConfig as c, SMSChannel as d, type SMSChannelConfig as e, ScheduledChannel as f, type ScheduledChannelConfig as g, type ScheduledJob as h, SlackChannel as i, type SlackChannelConfig as j, type TelegramChannelConfig as k, type WebhookChannelConfig as l };
+interface McpChannelConfig {
+    /**
+     * Maximum milliseconds to wait for the agent to respond.
+     * Default: 120_000 (2 minutes).
+     */
+    timeout?: number;
+}
+/**
+ * Channel that connects a Toolpack agent to an MCP server as a tool.
+ *
+ * Unlike other channels (Slack, Webhook) this channel does not own a server or
+ * socket. Instead it exposes a `trigger()` method that the MCP tools/call handler
+ * calls directly. The agent runs and sends its output back through `send()`, which
+ * resolves the Promise that `trigger()` is waiting on.
+ *
+ * Usage:
+ * ```typescript
+ * const ch = new McpChannel();
+ * const agent = new PrReviewerAgent({ channels: [ch] });
+ * await agent.start();
+ *
+ * await sdk.startMcpServer({
+ *   transport: 'stdio',
+ *   agents: [ch.asAgentDefinition(agent)],
+ * });
+ * ```
+ *
+ * ⚠ One McpChannel handles one concurrent call at a time. If two tools/call
+ * requests arrive for the same channel simultaneously, the second call's
+ * pendingResolve overwrites the first and the first call's result is lost.
+ * Create one McpChannel per agent instance and do not share channels.
+ */
+declare class McpChannel extends BaseChannel {
+    readonly isTriggerChannel = false;
+    private readonly _timeout;
+    private _pendingResolve?;
+    constructor(config?: McpChannelConfig);
+    /**
+     * No-op — McpChannel is driven by trigger(), not a background listener.
+     */
+    listen(): void;
+    /**
+     * Resolves the pending trigger() Promise with the agent's output.
+     */
+    send(output: AgentOutput): Promise<void>;
+    /**
+     * Convert raw MCP arguments into AgentInput.
+     * If args contains a string 'message' field it is used as the message;
+     * otherwise the entire args object is JSON-stringified as the message.
+     */
+    normalize(incoming: unknown): AgentInput;
+    /**
+     * Called by the MCP tools/call handler.
+     * Triggers the agent and waits for it to respond via send().
+     * Rejects if the agent does not respond within the configured timeout.
+     */
+    trigger(args: Record<string, unknown>): Promise<string>;
+    /**
+     * Produce an McpAgentDefinition suitable for startMcpServer({ agents: [...] }).
+     *
+     * @param agent  Object with name and description (typically a BaseAgent instance).
+     * @param inputSchema  Optional JSON Schema for the tool's input parameters.
+     */
+    asAgentDefinition(agent: {
+        name: string;
+        description: string;
+    }, inputSchema?: Record<string, unknown>): {
+        invoke: (args: Record<string, unknown>) => Promise<string>;
+        inputSchema?: Record<string, unknown> | undefined;
+        name: string;
+        description: string;
+    };
+}
+
+export { BaseChannel as B, type CreateJobOptions as C, DiscordChannel as D, EmailChannel as E, type JobStatus as J, McpChannel as M, SchedulerStore as S, TelegramChannel as T, WebhookChannel as W, type CreateJobResult as a, type DiscordChannelConfig as b, type EmailChannelConfig as c, type McpChannelConfig as d, SMSChannel as e, type SMSChannelConfig as f, ScheduledChannel as g, type ScheduledChannelConfig as h, type ScheduledJob as i, SlackChannel as j, type SlackChannelConfig as k, type TelegramChannelConfig as l, type WebhookChannelConfig as m };

package/dist/{index-o8Lbzv5N.d.ts → index-dhKoHWTy.d.ts}

@@ -924,4 +924,78 @@ declare class SMSChannel extends BaseChannel {
     stop(): Promise<void>;
 }
 
-export { BaseChannel as B, type CreateJobOptions as C, DiscordChannel as D, EmailChannel as E, type JobStatus as J, SchedulerStore as S, TelegramChannel as T, WebhookChannel as W, type CreateJobResult as a, type DiscordChannelConfig as b, type EmailChannelConfig as c, SMSChannel as d, type SMSChannelConfig as e, ScheduledChannel as f, type ScheduledChannelConfig as g, type ScheduledJob as h, SlackChannel as i, type SlackChannelConfig as j, type TelegramChannelConfig as k, type WebhookChannelConfig as l };
+interface McpChannelConfig {
+    /**
+     * Maximum milliseconds to wait for the agent to respond.
+     * Default: 120_000 (2 minutes).
+     */
+    timeout?: number;
+}
+/**
+ * Channel that connects a Toolpack agent to an MCP server as a tool.
+ *
+ * Unlike other channels (Slack, Webhook) this channel does not own a server or
+ * socket. Instead it exposes a `trigger()` method that the MCP tools/call handler
+ * calls directly. The agent runs and sends its output back through `send()`, which
+ * resolves the Promise that `trigger()` is waiting on.
+ *
+ * Usage:
+ * ```typescript
+ * const ch = new McpChannel();
+ * const agent = new PrReviewerAgent({ channels: [ch] });
+ * await agent.start();
+ *
+ * await sdk.startMcpServer({
+ *   transport: 'stdio',
+ *   agents: [ch.asAgentDefinition(agent)],
+ * });
+ * ```
+ *
+ * ⚠ One McpChannel handles one concurrent call at a time. If two tools/call
+ * requests arrive for the same channel simultaneously, the second call's
+ * pendingResolve overwrites the first and the first call's result is lost.
+ * Create one McpChannel per agent instance and do not share channels.
+ */
+declare class McpChannel extends BaseChannel {
+    readonly isTriggerChannel = false;
+    private readonly _timeout;
+    private _pendingResolve?;
+    constructor(config?: McpChannelConfig);
+    /**
+     * No-op — McpChannel is driven by trigger(), not a background listener.
+     */
+    listen(): void;
+    /**
+     * Resolves the pending trigger() Promise with the agent's output.
+     */
+    send(output: AgentOutput): Promise<void>;
+    /**
+     * Convert raw MCP arguments into AgentInput.
+     * If args contains a string 'message' field it is used as the message;
+     * otherwise the entire args object is JSON-stringified as the message.
+     */
+    normalize(incoming: unknown): AgentInput;
+    /**
+     * Called by the MCP tools/call handler.
+     * Triggers the agent and waits for it to respond via send().
+     * Rejects if the agent does not respond within the configured timeout.
+     */
+    trigger(args: Record<string, unknown>): Promise<string>;
+    /**
+     * Produce an McpAgentDefinition suitable for startMcpServer({ agents: [...] }).
+     *
+     * @param agent  Object with name and description (typically a BaseAgent instance).
+     * @param inputSchema  Optional JSON Schema for the tool's input parameters.
+     */
+    asAgentDefinition(agent: {
+        name: string;
+        description: string;
+    }, inputSchema?: Record<string, unknown>): {
+        invoke: (args: Record<string, unknown>) => Promise<string>;
+        inputSchema?: Record<string, unknown> | undefined;
+        name: string;
+        description: string;
+    };
+}
+
+export { BaseChannel as B, type CreateJobOptions as C, DiscordChannel as D, EmailChannel as E, type JobStatus as J, McpChannel as M, SchedulerStore as S, TelegramChannel as T, WebhookChannel as W, type CreateJobResult as a, type DiscordChannelConfig as b, type EmailChannelConfig as c, type McpChannelConfig as d, SMSChannel as e, type SMSChannelConfig as f, ScheduledChannel as g, type ScheduledChannelConfig as h, type ScheduledJob as i, SlackChannel as j, type SlackChannelConfig as k, type TelegramChannelConfig as l, type WebhookChannelConfig as m };