@agentick/shared 0.0.1

package/dist/identity.js

@@ -0,0 +1,116 @@
+/**
+ * Symbol-based identity utilities for minification-safe type checking.
+ *
+ * Functions can be marked with symbols to identify them even after minification
+ * where function names are mangled.
+ *
+ * @example
+ * ```typescript
+ * // Define a symbol for your component type
+ * const MY_COMPONENT_SYMBOL = Symbol.for('agentick.myComponent');
+ *
+ * // Mark the component
+ * export const MyComponent = markWithSymbol(MY_COMPONENT_SYMBOL, (props) => {
+ *   return createElement(MyComponent, props);
+ * });
+ *
+ * // Check identity (minification-safe)
+ * if (hasSymbol(someFunction, MY_COMPONENT_SYMBOL)) {
+ *   // It's a MyComponent
+ * }
+ * ```
+ */
+/**
+ * Symbol used to mark host primitive components.
+ * These are structural primitives that should be handled by the renderer,
+ * not executed as functions.
+ */
+export const HOST_PRIMITIVE_SYMBOL = Symbol.for("agentick.hostPrimitive");
+/**
+ * Symbol used to mark semantic components.
+ */
+export const SEMANTIC_COMPONENT_SYMBOL = Symbol.for("agentick.semanticComponent");
+/**
+ * Symbol used to mark content components.
+ */
+export const CONTENT_COMPONENT_SYMBOL = Symbol.for("agentick.contentComponent");
+/**
+ * Check if a value has a specific symbol marker.
+ *
+ * @param value - The value to check
+ * @param symbol - The symbol to look for
+ * @returns True if the value has the symbol marker
+ */
+export function hasSymbol(value, symbol) {
+    return (typeof value === "function" && value[symbol] === true);
+}
+/**
+ * Mark a function with a symbol for identity checking.
+ * Returns the same function with the symbol attached.
+ *
+ * @param symbol - The symbol to attach
+ * @param fn - The function to mark
+ * @returns The same function with the symbol attached
+ */
+export function markWithSymbol(symbol, fn) {
+    fn[symbol] = true;
+    return fn;
+}
+/**
+ * Mark a function as a host primitive.
+ * Host primitives are structural components that should be handled by the
+ * renderer directly, not executed as functions.
+ *
+ * @param fn - The function to mark as a host primitive
+ * @returns The same function marked as a host primitive
+ */
+export function markAsHostPrimitive(fn) {
+    return markWithSymbol(HOST_PRIMITIVE_SYMBOL, fn);
+}
+/**
+ * Check if a value is a host primitive component.
+ * Minification-safe - uses symbol identity, not function name.
+ *
+ * @param value - The value to check
+ * @returns True if it's a host primitive
+ */
+export function isHostPrimitive(value) {
+    return hasSymbol(value, HOST_PRIMITIVE_SYMBOL);
+}
+/**
+ * Mark a function as a semantic component.
+ *
+ * @param fn - The function to mark
+ * @returns The same function marked as a semantic component
+ */
+export function markAsSemanticComponent(fn) {
+    return markWithSymbol(SEMANTIC_COMPONENT_SYMBOL, fn);
+}
+/**
+ * Check if a value is a semantic component.
+ *
+ * @param value - The value to check
+ * @returns True if it's a semantic component
+ */
+export function isSemanticComponent(value) {
+    return hasSymbol(value, SEMANTIC_COMPONENT_SYMBOL);
+}
+/**
+ * Mark a function as a content component.
+ *
+ * @param fn - The function to mark
+ * @returns The same function marked as a content component
+ */
+export function markAsContentComponent(fn) {
+    return markWithSymbol(CONTENT_COMPONENT_SYMBOL, fn);
+}
+/**
+ * Check if a value is a content component.
+ *
+ * @param value - The value to check
+ * @returns True if it's a content component
+ */
+export function isContentComponent(value) {
+    return hasSymbol(value, CONTENT_COMPONENT_SYMBOL);
+}
+//# sourceMappingURL=identity.js.map

package/dist/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;AAE1E;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;AAElF;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;AAEhF;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc,EAAE,MAAc;IACtD,OAAO,CACL,OAAO,KAAK,KAAK,UAAU,IAAK,KAA4C,CAAC,MAAM,CAAC,KAAK,IAAI,CAC9F,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAqB,MAAc,EAAE,EAAK;IACrE,EAA8B,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAC/C,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAqB,EAAK;IAC3D,OAAO,cAAc,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;AACnD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,SAAS,CAAC,KAAK,EAAE,qBAAqB,CAAC,CAAC;AACjD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAqB,EAAK;IAC/D,OAAO,cAAc,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,OAAO,SAAS,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAC;AACrD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAqB,EAAK;IAC9D,OAAO,cAAc,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC;AACtD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,SAAS,CAAC,KAAK,EAAE,wBAAwB,CAAC,CAAC;AACpD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,56 @@
+/**
+ * # Agentick Shared Types
+ *
+ * Platform-independent type definitions shared across all Agentick packages.
+ * These types define the core data structures for messages, content blocks,
+ * tools, and streaming.
+ *
+ * ## Content Blocks
+ *
+ * Content blocks are discriminated unions representing all content types:
+ *
+ * - **Text** - Plain text content
+ * - **Image/Audio/Video** - Media content with base64 or URL sources
+ * - **ToolUse/ToolResult** - Tool call requests and responses
+ * - **Code** - Executable code blocks
+ *
+ * ## Messages
+ *
+ * Messages represent conversation entries with roles:
+ *
+ * - `user` - Human input
+ * - `assistant` - Model responses
+ * - `system` - System prompts
+ * - `tool_result` - Tool execution results
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * import type { Message, ContentBlock, ToolDefinition } from '@agentick/shared';
+ *
+ * const message: Message = {
+ *   role: 'user',
+ *   content: [{ type: 'text', text: 'Hello!' }]
+ * };
+ * ```
+ *
+ * @see {@link ContentBlock} - All content block types
+ * @see {@link Message} - Conversation message structure
+ * @see {@link ToolDefinition} - Tool schema definition
+ *
+ * @module @agentick/shared
+ */
+export * from "./block-types";
+export * from "./blocks";
+export * from "./messages";
+export * from "./streaming";
+export * from "./tools";
+export * from "./models";
+export * from "./input";
+export * from "./timeline";
+export * from "./errors";
+export * from "./identity";
+export * from "./devtools";
+export * from "./protocol";
+export * from "./model-catalog";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,56 @@
+/**
+ * # Agentick Shared Types
+ *
+ * Platform-independent type definitions shared across all Agentick packages.
+ * These types define the core data structures for messages, content blocks,
+ * tools, and streaming.
+ *
+ * ## Content Blocks
+ *
+ * Content blocks are discriminated unions representing all content types:
+ *
+ * - **Text** - Plain text content
+ * - **Image/Audio/Video** - Media content with base64 or URL sources
+ * - **ToolUse/ToolResult** - Tool call requests and responses
+ * - **Code** - Executable code blocks
+ *
+ * ## Messages
+ *
+ * Messages represent conversation entries with roles:
+ *
+ * - `user` - Human input
+ * - `assistant` - Model responses
+ * - `system` - System prompts
+ * - `tool_result` - Tool execution results
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * import type { Message, ContentBlock, ToolDefinition } from '@agentick/shared';
+ *
+ * const message: Message = {
+ *   role: 'user',
+ *   content: [{ type: 'text', text: 'Hello!' }]
+ * };
+ * ```
+ *
+ * @see {@link ContentBlock} - All content block types
+ * @see {@link Message} - Conversation message structure
+ * @see {@link ToolDefinition} - Tool schema definition
+ *
+ * @module @agentick/shared
+ */
+export * from "./block-types";
+export * from "./blocks";
+export * from "./messages";
+export * from "./streaming";
+export * from "./tools";
+export * from "./models";
+export * from "./input";
+export * from "./timeline";
+export * from "./errors";
+export * from "./identity";
+export * from "./devtools";
+export * from "./protocol";
+export * from "./model-catalog";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/input.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Input Normalization Types
+ *
+ * Platform-independent types for flexible input handling.
+ * Used by both backend (@agentick/core) and frontend (@agentick/client) for
+ * normalizing various input formats into standardized structures.
+ */
+import type { ContentBlock } from "./blocks";
+import type { Message } from "./messages";
+/**
+ * Flexible content input - accepts string or ContentBlock
+ */
+export type ContentInput = ContentBlock | string;
+/**
+ * Flexible content array input - accepts single or array of ContentInput
+ */
+export type ContentInputArray = ContentInput | ContentInput[];
+/**
+ * Flexible message input - accepts various message formats
+ *
+ * Can be:
+ * - Single string
+ * - Array of strings
+ * - Single Message
+ * - Array of Messages
+ * - Single ContentBlock
+ * - Array of ContentBlocks
+ * - Mixed ContentInputArray
+ */
+export type MessageInput = ContentInputArray | Message | Message[];
+/**
+ * Check if value is a ContentBlock.
+ * Validates that `type` is a known block type, not just any object with a type property.
+ */
+export declare function isContentBlock(value: unknown): value is ContentBlock;
+/**
+ * Check if value is a Message
+ */
+export declare function isMessage(value: unknown): value is Message;
+/**
+ * Normalize ContentInput to ContentBlock
+ */
+export declare function normalizeContentInput(input: ContentInput): ContentBlock;
+/**
+ * Normalize ContentInputArray to ContentBlock[]
+ */
+export declare function normalizeContentArray(input: ContentInputArray): ContentBlock[];
+/**
+ * Normalize MessageInput to Message[]
+ *
+ * @param input - Flexible message input
+ * @param role - Default role if input is not already a Message (default: 'user')
+ */
+export declare function normalizeMessageInput(input: MessageInput, role?: Message["role"]): Message[];
+//# sourceMappingURL=input.d.ts.map

package/dist/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../src/input.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAM1C;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,MAAM,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,YAAY,EAAE,CAAC;AAE9D;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG,OAAO,GAAG,OAAO,EAAE,CAAC;AAgCnE;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAMpE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAE1D;AAMD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,CAEvE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,EAAE,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,YAAY,EACnB,IAAI,GAAE,OAAO,CAAC,MAAM,CAAU,GAC7B,OAAO,EAAE,CAQX"}

package/dist/input.js

@@ -0,0 +1,83 @@
+/**
+ * Input Normalization Types
+ *
+ * Platform-independent types for flexible input handling.
+ * Used by both backend (@agentick/core) and frontend (@agentick/client) for
+ * normalizing various input formats into standardized structures.
+ */
+// ============================================================================
+// Type Guards
+// ============================================================================
+/**
+ * Valid content block types
+ */
+const VALID_BLOCK_TYPES = new Set([
+    "text",
+    "image",
+    "document",
+    "audio",
+    "video",
+    "tool_use",
+    "tool_result",
+    "reasoning",
+    "json",
+    "xml",
+    "csv",
+    "html",
+    "code",
+    "generated_image",
+    "generated_file",
+    "executable_code",
+    "code_execution_result",
+    "user_action",
+    "system_event",
+    "state_change",
+]);
+/**
+ * Check if value is a ContentBlock.
+ * Validates that `type` is a known block type, not just any object with a type property.
+ */
+export function isContentBlock(value) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    const obj = value;
+    return typeof obj["type"] === "string" && VALID_BLOCK_TYPES.has(obj["type"]);
+}
+/**
+ * Check if value is a Message
+ */
+export function isMessage(value) {
+    return typeof value === "object" && value !== null && "role" in value && "content" in value;
+}
+// ============================================================================
+// Normalization Functions
+// ============================================================================
+/**
+ * Normalize ContentInput to ContentBlock
+ */
+export function normalizeContentInput(input) {
+    return typeof input === "string" ? { type: "text", text: input } : input;
+}
+/**
+ * Normalize ContentInputArray to ContentBlock[]
+ */
+export function normalizeContentArray(input) {
+    return Array.isArray(input) ? input.map(normalizeContentInput) : [normalizeContentInput(input)];
+}
+/**
+ * Normalize MessageInput to Message[]
+ *
+ * @param input - Flexible message input
+ * @param role - Default role if input is not already a Message (default: 'user')
+ */
+export function normalizeMessageInput(input, role = "user") {
+    if (Array.isArray(input) && input.length > 0 && isMessage(input[0])) {
+        return input;
+    }
+    if (isMessage(input)) {
+        return [input];
+    }
+    return [{ role, content: normalizeContentArray(input) }];
+}
+//# sourceMappingURL=input.js.map

package/dist/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../src/input.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiCH,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;GAEG;AACH,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,MAAM;IACN,OAAO;IACP,UAAU;IACV,OAAO;IACP,OAAO;IACP,UAAU;IACV,aAAa;IACb,WAAW;IACX,MAAM;IACN,KAAK;IACL,KAAK;IACL,MAAM;IACN,MAAM;IACN,iBAAiB;IACjB,gBAAgB;IAChB,iBAAiB;IACjB,uBAAuB;IACvB,aAAa;IACb,cAAc;IACd,cAAc;CACf,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,OAAO,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,QAAQ,IAAI,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,IAAI,SAAS,IAAI,KAAK,CAAC;AAC9F,CAAC;AAED,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAmB;IACvD,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AAC3E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAwB;IAC5D,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC;AAClG,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAmB,EACnB,OAAwB,MAAM;IAE9B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,OAAO,KAAkB,CAAC;IAC5B,CAAC;IACD,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,qBAAqB,CAAC,KAA0B,CAAC,EAAE,CAAC,CAAC;AAChF,CAAC"}

package/dist/messages.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Message types for model input/output.
+ *
+ * Messages represent conversation entries with specific roles:
+ * - `user` - Human input messages
+ * - `assistant` - Model-generated responses
+ * - `system` - System/behavioral instructions
+ * - `tool` - Tool/function call results
+ * - `event` - Application events (user actions, system events, state changes)
+ *
+ * @example Creating messages
+ * ```typescript
+ * const userMsg = createUserMessage('Hello!');
+ * const systemMsg = createSystemMessage('You are a helpful assistant.');
+ * const assistantMsg: AssistantMessage = {
+ *   role: 'assistant',
+ *   content: [{ type: 'text', text: 'Hi there!' }]
+ * };
+ * ```
+ *
+ * @see {@link Message} - Base message interface
+ * @see {@link ContentBlock} - Content block types
+ *
+ * @module
+ */
+import type { MessageRoles } from "./block-types";
+import type { ContentBlock, EventAllowedBlock } from "./blocks";
+/**
+ * Base message interface for all message types.
+ *
+ * Messages are the fundamental unit of conversation in Agentick.
+ * Each message has a role indicating its source and an array
+ * of content blocks.
+ *
+ * @example
+ * ```typescript
+ * const message: Message = {
+ *   id: 'msg-123',
+ *   role: 'user',
+ *   content: [{ type: 'text', text: 'Hello!' }],
+ *   metadata: { source: 'web' }
+ * };
+ * ```
+ *
+ * @see {@link UserMessage}, {@link AssistantMessage}, {@link SystemMessage}
+ */
+export interface Message {
+    /** Unique message identifier */
+    readonly id?: string;
+    /** Message role (user, assistant, system, tool, event) */
+    readonly role: MessageRoles;
+    /** Array of content blocks */
+    readonly content: ContentBlock[];
+    /** Additional metadata */
+    readonly metadata?: Record<string, any>;
+    /** When the message was created */
+    readonly createdAt?: string | Date;
+    /** When the message was last updated */
+    readonly updatedAt?: string | Date;
+}
+export interface ModelMessage extends Message {
+}
+/** Message from a user/human */
+export interface UserMessage extends Message {
+    readonly role: "user";
+}
+/** Message from the AI assistant/model */
+export interface AssistantMessage extends Message {
+    readonly role: "assistant";
+}
+/** System instruction message (typically at conversation start) */
+export interface SystemMessage extends Message {
+    readonly role: "system";
+}
+/** Tool/function execution result message */
+export interface ToolMessage extends Message {
+    readonly role: "tool";
+    /** ID of the tool call this result is for */
+    readonly toolCallId?: string;
+}
+/** Application event message (user actions, system events, state changes) */
+export interface EventMessage extends Message {
+    readonly role: "event";
+    readonly content: EventAllowedBlock[];
+    /** Categorization of the event type */
+    readonly eventType?: string;
+}
+export declare function createUserMessage(content: ContentBlock[] | string, metadata?: Record<string, any>): UserMessage;
+export declare function createAssistantMessage(content: ContentBlock[] | string, metadata?: Record<string, any>): AssistantMessage;
+export declare function createSystemMessage(content: ContentBlock[] | string, metadata?: Record<string, any>): SystemMessage;
+export declare function isUserMessage(message: Message): message is UserMessage;
+export declare function isAssistantMessage(message: Message): message is AssistantMessage;
+export declare function isSystemMessage(message: Message): message is SystemMessage;
+export declare function isToolMessage(message: Message): message is ToolMessage;
+export declare function isEventMessage(message: Message): message is EventMessage;
+export declare function createToolMessage(content: ContentBlock[] | string, toolCallId?: string, metadata?: Record<string, any>): ToolMessage;
+export declare function createEventMessage(content: EventAllowedBlock[] | string, eventType?: string, metadata?: Record<string, any>): EventMessage;
+//# sourceMappingURL=messages.d.ts.map

package/dist/messages.d.ts.map

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

package/dist/messages.js

@@ -0,0 +1,81 @@
+/**
+ * Message types for model input/output.
+ *
+ * Messages represent conversation entries with specific roles:
+ * - `user` - Human input messages
+ * - `assistant` - Model-generated responses
+ * - `system` - System/behavioral instructions
+ * - `tool` - Tool/function call results
+ * - `event` - Application events (user actions, system events, state changes)
+ *
+ * @example Creating messages
+ * ```typescript
+ * const userMsg = createUserMessage('Hello!');
+ * const systemMsg = createSystemMessage('You are a helpful assistant.');
+ * const assistantMsg: AssistantMessage = {
+ *   role: 'assistant',
+ *   content: [{ type: 'text', text: 'Hi there!' }]
+ * };
+ * ```
+ *
+ * @see {@link Message} - Base message interface
+ * @see {@link ContentBlock} - Content block types
+ *
+ * @module
+ */
+// ============================================================================
+// Message Helpers
+// ============================================================================
+export function createUserMessage(content, metadata) {
+    return {
+        role: "user",
+        content: typeof content === "string" ? [{ type: "text", text: content }] : content,
+        metadata,
+    };
+}
+export function createAssistantMessage(content, metadata) {
+    return {
+        role: "assistant",
+        content: typeof content === "string" ? [{ type: "text", text: content }] : content,
+        metadata,
+    };
+}
+export function createSystemMessage(content, metadata) {
+    return {
+        role: "system",
+        content: typeof content === "string" ? [{ type: "text", text: content }] : content,
+        metadata,
+    };
+}
+export function isUserMessage(message) {
+    return message.role === "user";
+}
+export function isAssistantMessage(message) {
+    return message.role === "assistant";
+}
+export function isSystemMessage(message) {
+    return message.role === "system";
+}
+export function isToolMessage(message) {
+    return message.role === "tool";
+}
+export function isEventMessage(message) {
+    return message.role === "event";
+}
+export function createToolMessage(content, toolCallId, metadata) {
+    return {
+        role: "tool",
+        content: typeof content === "string" ? [{ type: "text", text: content }] : content,
+        toolCallId,
+        metadata,
+    };
+}
+export function createEventMessage(content, eventType, metadata) {
+    return {
+        role: "event",
+        content: typeof content === "string" ? [{ type: "text", text: content }] : content,
+        eventType,
+        metadata,
+    };
+}
+//# sourceMappingURL=messages.js.map

package/dist/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AA2EH,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,MAAM,UAAU,iBAAiB,CAC/B,OAAgC,EAChC,QAA8B;IAE9B,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO;QAClF,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,OAAgC,EAChC,QAA8B;IAE9B,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO;QAClF,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,OAAgC,EAChC,QAA8B;IAE9B,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO;QAClF,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,OAAO,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,OAAO,OAAO,CAAC,IAAI,KAAK,WAAW,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,OAAO,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,OAAO,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,OAAgC,EAChC,UAAmB,EACnB,QAA8B;IAE9B,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO;QAClF,UAAU;QACV,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,OAAqC,EACrC,SAAkB,EAClB,QAA8B;IAE9B,OAAO;QACL,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO;QAClF,SAAS;QACT,QAAQ;KACT,CAAC;AACJ,CAAC"}