@ellyco/agentic 0.1.0

package/dist/messages/message.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Object representation of message content with optional text field.
+ *
+ * @property {string} [text] - The text content of the message
+ */
+export interface MessageContentObject {
+    text?: string;
+}
+/**
+ * Message content can be either a plain string or a structured content object.
+ */
+export type MessageContent = string | MessageContentObject;
+/**
+ * Enum representing the role of a message in the conversation.
+ *
+ * @enum {string}
+ * @property {string} SYSTEM - System message for setting context/behavior
+ * @property {string} USER - User message requesting something
+ * @property {string} AGENT - Agent/AI message responding or taking action
+ */
+export declare enum MessageRole {
+    SYSTEM = "system",
+    USER = "user",
+    AGENT = "agent"
+}
+/**
+ * Base class for all message types in a conversation.
+ * Handles message content parsing, interpolation, and serialization.
+ *
+ * @abstract
+ * @property {MessageRole} role - The role of this message
+ * @property {string | undefined} text - The text content of the message
+ *
+ * @example
+ * ```typescript
+ * const message = new UserMessage("Hello, can you help me?");
+ * const systemMsg = new SystemMessage("You are a helpful assistant.");
+ * ```
+ */
+export declare abstract class BaseMessage {
+    readonly role: MessageRole;
+    private _textContent?;
+    /**
+     * Gets the text content of the message.
+     *
+     * @returns {string | undefined} The message text, or undefined if not set
+     */
+    get text(): string | undefined;
+    /**
+     * Creates a new message instance.
+     *
+     * @param {MessageRole} role - The role of this message
+     * @param {MessageContent} content - The message content (string or object)
+     */
+    constructor(role: MessageRole, content: MessageContent);
+    /**
+     * Interpolates template variables in the message text.
+     * Replaces {variableName} patterns with values from the properties object.
+     *
+     * @param {Record<string, any>} properties - Key-value pairs for template substitution
+     * @returns {this} The same message instance for chaining
+     * @throws {Error} If a referenced property is not found in the properties object
+     *
+     * @example
+     * ```typescript
+     * const msg = new UserMessage("Hello {name}, your score is {score}");
+     * msg.interpolate({ name: "Alice", score: 100 });
+     * // Result: "Hello Alice, your score is 100"
+     * ```
+     */
+    interpolate(properties: Record<string, any>): this;
+    /**
+     * Converts the message to JSON representation.
+     *
+     * @returns {{role: MessageRole; content: MessageContentObject}} JSON representation of the message
+     */
+    toJSON(): {
+        role: MessageRole;
+        content: MessageContentObject;
+    };
+    /**
+     * Checks if the message contains text content.
+     *
+     * @returns {boolean} True if the message has text content, false otherwise
+     */
+    hasText(): boolean;
+}
+/**
+ * A system message used to set the behavior and context for the AI model.
+ * System messages typically appear at the beginning of a conversation.
+ *
+ * @extends {BaseMessage}
+ *
+ * @example
+ * ```typescript
+ * const systemMsg = new SystemMessage("You are a helpful customer service assistant.");
+ * ```
+ */
+export declare class SystemMessage extends BaseMessage {
+    /**
+     * Creates a new system message.
+     *
+     * @param {MessageContent} content - The system message content
+     */
+    constructor(content: MessageContent);
+}
+/**
+ * A user message representing input or requests from the user.
+ *
+ * @extends {BaseMessage}
+ *
+ * @example
+ * ```typescript
+ * const userMsg = new UserMessage("What is the weather today?");
+ * ```
+ */
+export declare class UserMessage extends BaseMessage {
+    /**
+     * Creates a new user message.
+     *
+     * @param {MessageContent} content - The user message content
+     */
+    constructor(content: MessageContent);
+}
+/**
+ * An agent message representing responses or actions from the AI agent.
+ *
+ * @extends {BaseMessage}
+ *
+ * @example
+ * ```typescript
+ * const agentMsg = new AgentMessage("The weather is sunny with a high of 75°F.");
+ * ```
+ */
+export declare class AgentMessage extends BaseMessage {
+    /**
+     * Creates a new agent message.
+     *
+     * @param {MessageContent} content - The agent message content
+     */
+    constructor(content: MessageContent);
+}
+//# sourceMappingURL=message.d.ts.map

package/dist/messages/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/messages/message.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,oBAAoB,CAAC;AAE3D;;;;;;;GAOG;AACH,oBAAY,WAAW;IACnB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,KAAK,UAAU;CAClB;AAED;;;;;;;;;;;;;GAaG;AACH,8BAAsB,WAAW;aAmBT,IAAI,EAAE,WAAW;IAlBrC,OAAO,CAAC,YAAY,CAAC,CAAS;IAE9B;;;;OAIG;IACH,IAAW,IAAI,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED;;;;;OAKG;gBAEiB,IAAI,EAAE,WAAW,EACjC,OAAO,EAAE,cAAc;IAS3B;;;;;;;;;;;;;;OAcG;IACI,WAAW,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAgBzD;;;;OAIG;IACI,MAAM,IAAI;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,OAAO,EAAE,oBAAoB,CAAA;KAAE;IASrE;;;;OAIG;IACI,OAAO,IAAI,OAAO;CAG5B;AAED;;;;;;;;;;GAUG;AACH,qBAAa,aAAc,SAAQ,WAAW;IAC1C;;;;OAIG;gBACS,OAAO,EAAE,cAAc;CAGtC;AAED;;;;;;;;;GASG;AACH,qBAAa,WAAY,SAAQ,WAAW;IACxC;;;;OAIG;gBACS,OAAO,EAAE,cAAc;CAGtC;AAED;;;;;;;;;GASG;AACH,qBAAa,YAAa,SAAQ,WAAW;IACzC;;;;OAIG;gBACS,OAAO,EAAE,cAAc;CAGtC"}

package/dist/messages/message.js

@@ -0,0 +1,172 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentMessage = exports.UserMessage = exports.SystemMessage = exports.BaseMessage = exports.MessageRole = void 0;
+/**
+ * Enum representing the role of a message in the conversation.
+ *
+ * @enum {string}
+ * @property {string} SYSTEM - System message for setting context/behavior
+ * @property {string} USER - User message requesting something
+ * @property {string} AGENT - Agent/AI message responding or taking action
+ */
+var MessageRole;
+(function (MessageRole) {
+    MessageRole["SYSTEM"] = "system";
+    MessageRole["USER"] = "user";
+    MessageRole["AGENT"] = "agent";
+})(MessageRole || (exports.MessageRole = MessageRole = {}));
+/**
+ * Base class for all message types in a conversation.
+ * Handles message content parsing, interpolation, and serialization.
+ *
+ * @abstract
+ * @property {MessageRole} role - The role of this message
+ * @property {string | undefined} text - The text content of the message
+ *
+ * @example
+ * ```typescript
+ * const message = new UserMessage("Hello, can you help me?");
+ * const systemMsg = new SystemMessage("You are a helpful assistant.");
+ * ```
+ */
+class BaseMessage {
+    role;
+    _textContent;
+    /**
+     * Gets the text content of the message.
+     *
+     * @returns {string | undefined} The message text, or undefined if not set
+     */
+    get text() {
+        return this._textContent;
+    }
+    /**
+     * Creates a new message instance.
+     *
+     * @param {MessageRole} role - The role of this message
+     * @param {MessageContent} content - The message content (string or object)
+     */
+    constructor(role, content) {
+        this.role = role;
+        if (typeof content === "string") {
+            this._textContent = content;
+        }
+        else {
+            this._textContent = content.text;
+        }
+    }
+    /**
+     * Interpolates template variables in the message text.
+     * Replaces {variableName} patterns with values from the properties object.
+     *
+     * @param {Record<string, any>} properties - Key-value pairs for template substitution
+     * @returns {this} The same message instance for chaining
+     * @throws {Error} If a referenced property is not found in the properties object
+     *
+     * @example
+     * ```typescript
+     * const msg = new UserMessage("Hello {name}, your score is {score}");
+     * msg.interpolate({ name: "Alice", score: 100 });
+     * // Result: "Hello Alice, your score is 100"
+     * ```
+     */
+    interpolate(properties) {
+        if (this._textContent) {
+            this._textContent = this._textContent.replace(/\{\s*(\w+)\s*\}/g, (match, p1) => {
+                const value = properties[p1];
+                if (value === undefined) {
+                    throw new Error(`Property ${p1} is not defined`);
+                }
+                return value;
+            });
+        }
+        return this;
+    }
+    /**
+     * Converts the message to JSON representation.
+     *
+     * @returns {{role: MessageRole; content: MessageContentObject}} JSON representation of the message
+     */
+    toJSON() {
+        return {
+            role: this.role,
+            content: {
+                text: this._textContent,
+            },
+        };
+    }
+    /**
+     * Checks if the message contains text content.
+     *
+     * @returns {boolean} True if the message has text content, false otherwise
+     */
+    hasText() {
+        return this._textContent !== undefined;
+    }
+}
+exports.BaseMessage = BaseMessage;
+/**
+ * A system message used to set the behavior and context for the AI model.
+ * System messages typically appear at the beginning of a conversation.
+ *
+ * @extends {BaseMessage}
+ *
+ * @example
+ * ```typescript
+ * const systemMsg = new SystemMessage("You are a helpful customer service assistant.");
+ * ```
+ */
+class SystemMessage extends BaseMessage {
+    /**
+     * Creates a new system message.
+     *
+     * @param {MessageContent} content - The system message content
+     */
+    constructor(content) {
+        super(MessageRole.SYSTEM, content);
+    }
+}
+exports.SystemMessage = SystemMessage;
+/**
+ * A user message representing input or requests from the user.
+ *
+ * @extends {BaseMessage}
+ *
+ * @example
+ * ```typescript
+ * const userMsg = new UserMessage("What is the weather today?");
+ * ```
+ */
+class UserMessage extends BaseMessage {
+    /**
+     * Creates a new user message.
+     *
+     * @param {MessageContent} content - The user message content
+     */
+    constructor(content) {
+        super(MessageRole.USER, content);
+    }
+}
+exports.UserMessage = UserMessage;
+/**
+ * An agent message representing responses or actions from the AI agent.
+ *
+ * @extends {BaseMessage}
+ *
+ * @example
+ * ```typescript
+ * const agentMsg = new AgentMessage("The weather is sunny with a high of 75°F.");
+ * ```
+ */
+class AgentMessage extends BaseMessage {
+    /**
+     * Creates a new agent message.
+     *
+     * @param {MessageContent} content - The agent message content
+     */
+    constructor(content) {
+        super(MessageRole.AGENT, content);
+    }
+}
+exports.AgentMessage = AgentMessage;
+//# sourceMappingURL=message.js.map

package/dist/messages/message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../src/messages/message.ts"],"names":[],"mappings":";;;AAcA;;;;;;;GAOG;AACH,IAAY,WAIX;AAJD,WAAY,WAAW;IACnB,gCAAiB,CAAA;IACjB,4BAAa,CAAA;IACb,8BAAe,CAAA;AACnB,CAAC,EAJW,WAAW,2BAAX,WAAW,QAItB;AAED;;;;;;;;;;;;;GAaG;AACH,MAAsB,WAAW;IAmBT;IAlBZ,YAAY,CAAU;IAE9B;;;;OAIG;IACH,IAAW,IAAI;QACX,OAAO,IAAI,CAAC,YAAY,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACH,YACoB,IAAiB,EACjC,OAAuB;QADP,SAAI,GAAJ,IAAI,CAAa;QAGjC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC9B,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;QAChC,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;QACrC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACI,WAAW,CAAC,UAA+B;QAC9C,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACpB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CACzC,kBAAkB,EAClB,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;gBACV,MAAM,KAAK,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;gBAC7B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACtB,MAAM,IAAI,KAAK,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;gBACrD,CAAC;gBACD,OAAO,KAAK,CAAC;YACjB,CAAC,CACJ,CAAC;QACN,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACI,MAAM;QACT,OAAO;YACH,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE;gBACL,IAAI,EAAE,IAAI,CAAC,YAAY;aAC1B;SACJ,CAAC;IACN,CAAC;IAED;;;;OAIG;IACI,OAAO;QACV,OAAO,IAAI,CAAC,YAAY,KAAK,SAAS,CAAC;IAC3C,CAAC;CACJ;AAlFD,kCAkFC;AAED;;;;;;;;;;GAUG;AACH,MAAa,aAAc,SAAQ,WAAW;IAC1C;;;;OAIG;IACH,YAAY,OAAuB;QAC/B,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;CACJ;AATD,sCASC;AAED;;;;;;;;;GASG;AACH,MAAa,WAAY,SAAQ,WAAW;IACxC;;;;OAIG;IACH,YAAY,OAAuB;QAC/B,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;CACJ;AATD,kCASC;AAED;;;;;;;;;GASG;AACH,MAAa,YAAa,SAAQ,WAAW;IACzC;;;;OAIG;IACH,YAAY,OAAuB;QAC/B,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;CACJ;AATD,oCASC"}

package/dist/messages/tool.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Internal interface for serializing tool-related messages to JSON.
+ *
+ * @interface ToolUseJSON
+ * @property {string} type - The type of tool message: "tool_request", "tool_response", or "tool_error"
+ * @property {string} toolUseId - Unique identifier linking request to response/error
+ * @property {string} toolName - Name of the tool being used
+ * @property {string} [input] - JSON-stringified input parameters for the tool
+ * @property {string} [output] - JSON-stringified output/result from the tool
+ * @property {string} [error] - Error message if the tool execution failed
+ */
+interface ToolUseJSON {
+    type: "tool_request" | "tool_response" | "tool_error";
+    toolUseId: string;
+    toolName: string;
+    input?: string;
+    output?: string;
+    error?: string;
+}
+/**
+ * Base class for tool-related messages representing tool usage in agent-model interactions.
+ * Covers tool requests, responses, and errors.
+ *
+ * @abstract
+ * @property {string} toolUseId - Unique identifier for this tool usage instance
+ * @property {string} toolName - Name of the tool
+ *
+ * @example
+ * ```typescript
+ * // ToolRequest: Agent requests to use a tool
+ * const request = new ToolRequest("call_123", "search", { query: "weather" });
+ *
+ * // ToolResponse: Tool returns a result
+ * const response = new ToolResponse("call_123", "search", { result: "Sunny" });
+ *
+ * // ToolError: Tool execution failed
+ * const error = new ToolError("call_123", "search", "API connection failed");
+ * ```
+ */
+export declare abstract class ToolUse {
+    readonly toolUseId: string;
+    readonly toolName: string;
+    /**
+     * Creates a new tool usage instance.
+     *
+     * @param {string} toolUseId - Unique identifier for this tool usage
+     * @param {string} toolName - Name of the tool being used
+     */
+    constructor(toolUseId: string, toolName: string);
+    /**
+     * Converts the tool usage to JSON representation.
+     *
+     * @abstract
+     * @returns {ToolUseJSON} JSON representation of the tool usage
+     */
+    abstract toJSON(): ToolUseJSON;
+}
+/**
+ * Represents a request from the agent to execute a tool.
+ * Contains the tool name and input parameters for execution.
+ *
+ * @extends {ToolUse}
+ * @template T - The type of the input parameters object
+ * @property {T} input - The input parameters for the tool
+ *
+ * @example
+ * ```typescript
+ * const request = new ToolRequest(
+ *   "call_123",
+ *   "search",
+ *   { query: "Paris weather" }
+ * );
+ * ```
+ */
+export declare class ToolRequest<T = object> extends ToolUse {
+    readonly input: T;
+    /**
+     * Creates a new tool request.
+     *
+     * @param {string} toolUseId - Unique identifier for this request
+     * @param {string} toolName - Name of the tool to invoke
+     * @param {T} input - Parameters to pass to the tool
+     */
+    constructor(toolUseId: string, toolName: string, input: T);
+    /**
+     * Converts the tool request to JSON representation.
+     *
+     * @returns {ToolUseJSON} JSON representation with type "tool_request"
+     */
+    toJSON(): ToolUseJSON;
+}
+/**
+ * Represents the successful result of a tool execution.
+ * Contains the output/result returned by the tool.
+ *
+ * @extends {ToolUse}
+ * @template T - The type of the output/result object
+ * @property {T} output - The result returned by the tool
+ *
+ * @example
+ * ```typescript
+ * const response = new ToolResponse(
+ *   "call_123",
+ *   "search",
+ *   { results: ["result1", "result2"], totalCount: 2 }
+ * );
+ * ```
+ */
+export declare class ToolResponse<T = object> extends ToolUse {
+    readonly output: T;
+    /**
+     * Creates a new tool response.
+     *
+     * @param {string} toolUseId - Unique identifier matching the original request
+     * @param {string} toolName - Name of the tool that was executed
+     * @param {T} output - The result returned by the tool
+     */
+    constructor(toolUseId: string, toolName: string, output: T);
+    /**
+     * Converts the tool response to JSON representation.
+     *
+     * @returns {ToolUseJSON} JSON representation with type "tool_response"
+     */
+    toJSON(): ToolUseJSON;
+}
+/**
+ * Represents an error that occurred during tool execution.
+ * Contains the error message describing what went wrong.
+ *
+ * @extends {ToolUse}
+ * @property {string} error - The error message
+ *
+ * @example
+ * ```typescript
+ * const error = new ToolError(
+ *   "call_123",
+ *   "search",
+ *   "Network timeout: Request took longer than 30 seconds"
+ * );
+ * ```
+ */
+export declare class ToolError extends ToolUse {
+    readonly error: string;
+    /**
+     * Creates a new tool error.
+     *
+     * @param {string} toolUseId - Unique identifier matching the original request
+     * @param {string} toolName - Name of the tool that failed
+     * @param {string} error - Description of the error that occurred
+     */
+    constructor(toolUseId: string, toolName: string, error: string);
+    /**
+     * Converts the tool error to JSON representation.
+     *
+     * @returns {ToolUseJSON} JSON representation with type "tool_error"
+     */
+    toJSON(): ToolUseJSON;
+}
+export {};
+//# sourceMappingURL=tool.d.ts.map

package/dist/messages/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/messages/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,UAAU,WAAW;IACjB,IAAI,EAAE,cAAc,GAAG,eAAe,GAAG,YAAY,CAAC;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,8BAAsB,OAAO;aAQL,SAAS,EAAE,MAAM;aACjB,QAAQ,EAAE,MAAM;IARpC;;;;;OAKG;gBAEiB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM;IAGpC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,IAAI,WAAW;CACjC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,WAAW,CAAC,CAAC,GAAG,MAAM,CAAE,SAAQ,OAAO;aAW5B,KAAK,EAAE,CAAC;IAV5B;;;;;;OAMG;gBAEC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EACA,KAAK,EAAE,CAAC;IAK5B;;;;OAIG;IACH,MAAM,IAAI,WAAW;CAQxB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,YAAY,CAAC,CAAC,GAAG,MAAM,CAAE,SAAQ,OAAO;aAW7B,MAAM,EAAE,CAAC;IAV7B;;;;;;OAMG;gBAEC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EACA,MAAM,EAAE,CAAC;IAK7B;;;;OAIG;IACH,MAAM,IAAI,WAAW;CAQxB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,SAAU,SAAQ,OAAO;aAWd,KAAK,EAAE,MAAM;IAVjC;;;;;;OAMG;gBAEC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EACA,KAAK,EAAE,MAAM;IAKjC;;;;OAIG;IACH,MAAM,IAAI,WAAW;CAQxB"}

package/dist/messages/tool.js

@@ -0,0 +1,173 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolError = exports.ToolResponse = exports.ToolRequest = exports.ToolUse = void 0;
+/**
+ * Base class for tool-related messages representing tool usage in agent-model interactions.
+ * Covers tool requests, responses, and errors.
+ *
+ * @abstract
+ * @property {string} toolUseId - Unique identifier for this tool usage instance
+ * @property {string} toolName - Name of the tool
+ *
+ * @example
+ * ```typescript
+ * // ToolRequest: Agent requests to use a tool
+ * const request = new ToolRequest("call_123", "search", { query: "weather" });
+ *
+ * // ToolResponse: Tool returns a result
+ * const response = new ToolResponse("call_123", "search", { result: "Sunny" });
+ *
+ * // ToolError: Tool execution failed
+ * const error = new ToolError("call_123", "search", "API connection failed");
+ * ```
+ */
+class ToolUse {
+    toolUseId;
+    toolName;
+    /**
+     * Creates a new tool usage instance.
+     *
+     * @param {string} toolUseId - Unique identifier for this tool usage
+     * @param {string} toolName - Name of the tool being used
+     */
+    constructor(toolUseId, toolName) {
+        this.toolUseId = toolUseId;
+        this.toolName = toolName;
+    }
+}
+exports.ToolUse = ToolUse;
+/**
+ * Represents a request from the agent to execute a tool.
+ * Contains the tool name and input parameters for execution.
+ *
+ * @extends {ToolUse}
+ * @template T - The type of the input parameters object
+ * @property {T} input - The input parameters for the tool
+ *
+ * @example
+ * ```typescript
+ * const request = new ToolRequest(
+ *   "call_123",
+ *   "search",
+ *   { query: "Paris weather" }
+ * );
+ * ```
+ */
+class ToolRequest extends ToolUse {
+    input;
+    /**
+     * Creates a new tool request.
+     *
+     * @param {string} toolUseId - Unique identifier for this request
+     * @param {string} toolName - Name of the tool to invoke
+     * @param {T} input - Parameters to pass to the tool
+     */
+    constructor(toolUseId, toolName, input) {
+        super(toolUseId, toolName);
+        this.input = input;
+    }
+    /**
+     * Converts the tool request to JSON representation.
+     *
+     * @returns {ToolUseJSON} JSON representation with type "tool_request"
+     */
+    toJSON() {
+        return {
+            type: "tool_request",
+            toolUseId: this.toolUseId,
+            toolName: this.toolName,
+            input: JSON.stringify(this.input),
+        };
+    }
+}
+exports.ToolRequest = ToolRequest;
+/**
+ * Represents the successful result of a tool execution.
+ * Contains the output/result returned by the tool.
+ *
+ * @extends {ToolUse}
+ * @template T - The type of the output/result object
+ * @property {T} output - The result returned by the tool
+ *
+ * @example
+ * ```typescript
+ * const response = new ToolResponse(
+ *   "call_123",
+ *   "search",
+ *   { results: ["result1", "result2"], totalCount: 2 }
+ * );
+ * ```
+ */
+class ToolResponse extends ToolUse {
+    output;
+    /**
+     * Creates a new tool response.
+     *
+     * @param {string} toolUseId - Unique identifier matching the original request
+     * @param {string} toolName - Name of the tool that was executed
+     * @param {T} output - The result returned by the tool
+     */
+    constructor(toolUseId, toolName, output) {
+        super(toolUseId, toolName);
+        this.output = output;
+    }
+    /**
+     * Converts the tool response to JSON representation.
+     *
+     * @returns {ToolUseJSON} JSON representation with type "tool_response"
+     */
+    toJSON() {
+        return {
+            type: "tool_response",
+            toolUseId: this.toolUseId,
+            toolName: this.toolName,
+            output: JSON.stringify(this.output),
+        };
+    }
+}
+exports.ToolResponse = ToolResponse;
+/**
+ * Represents an error that occurred during tool execution.
+ * Contains the error message describing what went wrong.
+ *
+ * @extends {ToolUse}
+ * @property {string} error - The error message
+ *
+ * @example
+ * ```typescript
+ * const error = new ToolError(
+ *   "call_123",
+ *   "search",
+ *   "Network timeout: Request took longer than 30 seconds"
+ * );
+ * ```
+ */
+class ToolError extends ToolUse {
+    error;
+    /**
+     * Creates a new tool error.
+     *
+     * @param {string} toolUseId - Unique identifier matching the original request
+     * @param {string} toolName - Name of the tool that failed
+     * @param {string} error - Description of the error that occurred
+     */
+    constructor(toolUseId, toolName, error) {
+        super(toolUseId, toolName);
+        this.error = error;
+    }
+    /**
+     * Converts the tool error to JSON representation.
+     *
+     * @returns {ToolUseJSON} JSON representation with type "tool_error"
+     */
+    toJSON() {
+        return {
+            type: "tool_error",
+            toolUseId: this.toolUseId,
+            toolName: this.toolName,
+            error: this.error,
+        };
+    }
+}
+exports.ToolError = ToolError;
+//# sourceMappingURL=tool.js.map

package/dist/messages/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/messages/tool.ts"],"names":[],"mappings":";;;AAoBA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAsB,OAAO;IAQL;IACA;IARpB;;;;;OAKG;IACH,YACoB,SAAiB,EACjB,QAAgB;QADhB,cAAS,GAAT,SAAS,CAAQ;QACjB,aAAQ,GAAR,QAAQ,CAAQ;IAChC,CAAC;CASR;AAnBD,0BAmBC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAa,WAAwB,SAAQ,OAAO;IAW5B;IAVpB;;;;;;OAMG;IACH,YACI,SAAiB,EACjB,QAAgB,EACA,KAAQ;QAExB,KAAK,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAFX,UAAK,GAAL,KAAK,CAAG;IAG5B,CAAC;IAED;;;;OAIG;IACH,MAAM;QACF,OAAO;YACH,IAAI,EAAE,cAAc;YACpB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC;SACpC,CAAC;IACN,CAAC;CACJ;AA7BD,kCA6BC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAa,YAAyB,SAAQ,OAAO;IAW7B;IAVpB;;;;;;OAMG;IACH,YACI,SAAiB,EACjB,QAAgB,EACA,MAAS;QAEzB,KAAK,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAFX,WAAM,GAAN,MAAM,CAAG;IAG7B,CAAC;IAED;;;;OAIG;IACH,MAAM;QACF,OAAO;YACH,IAAI,EAAE,eAAe;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC;SACtC,CAAC;IACN,CAAC;CACJ;AA7BD,oCA6BC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAa,SAAU,SAAQ,OAAO;IAWd;IAVpB;;;;;;OAMG;IACH,YACI,SAAiB,EACjB,QAAgB,EACA,KAAa;QAE7B,KAAK,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAFX,UAAK,GAAL,KAAK,CAAQ;IAGjC,CAAC;IAED;;;;OAIG;IACH,MAAM;QACF,OAAO;YACH,IAAI,EAAE,YAAY;YAClB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,IAAI,CAAC,KAAK;SACpB,CAAC;IACN,CAAC;CACJ;AA7BD,8BA6BC"}