@ash-cloud/ash-ai 0.1.8

package/dist/embed.cjs

@@ -0,0 +1,19 @@
+'use strict';
+
+// src/embed/loader.ts
+function generateEmbedSnippet(widgetUrl, settings) {
+  const settingsJson = JSON.stringify(settings, null, 2);
+  return `<!-- Ash AI Widget -->
+<script>
+  window.AshSettings = ${settingsJson};
+  (function(){var w=window;var a=w.Ash;if(typeof a==="function"){a('boot',w.AshSettings);}else{var d=document;var i=function(){i.c(arguments);};i.q=[];i.c=function(args){i.q.push(args);};w.Ash=i;var l=function(){var s=d.createElement('script');s.type='text/javascript';s.async=true;s.src='${widgetUrl}';var x=d.getElementsByTagName('script')[0];x.parentNode.insertBefore(s,x);};if(document.readyState==='complete'){l();}else if(w.attachEvent){w.attachEvent('onload',l);}else{w.addEventListener('load',l,false);}}})();
+</script>`;
+}
+function generateMinifiedLoader(widgetUrl) {
+  return `(function(){var w=window;var a=w.Ash;if(typeof a==="function"){a('boot',w.AshSettings);}else{var d=document;var i=function(){i.c(arguments);};i.q=[];i.c=function(args){i.q.push(args);};w.Ash=i;var l=function(){var s=d.createElement('script');s.type='text/javascript';s.async=true;s.src='${widgetUrl}';var x=d.getElementsByTagName('script')[0];x.parentNode.insertBefore(s,x);};if(document.readyState==='complete'){l();}else if(w.attachEvent){w.attachEvent('onload',l);}else{w.addEventListener('load',l,false);}}})();`;
+}
+
+exports.generateEmbedSnippet = generateEmbedSnippet;
+exports.generateMinifiedLoader = generateMinifiedLoader;
+//# sourceMappingURL=embed.cjs.map
+//# sourceMappingURL=embed.cjs.map

package/dist/embed.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/embed/loader.ts"],"names":[],"mappings":";;;AA2WO,SAAS,oBAAA,CACd,WACA,QAAA,EACQ;AACR,EAAA,MAAM,YAAA,GAAe,IAAA,CAAK,SAAA,CAAU,QAAA,EAAU,MAAM,CAAC,CAAA;AAErD,EAAA,OAAO,CAAA;AAAA;AAAA,uBAAA,EAEgB,YAAY,CAAA;AAAA,iSAAA,EAC8P,SAAS,CAAA;AAAA,SAAA,CAAA;AAE5S;AAKO,SAAS,uBAAuB,SAAA,EAA2B;AAChE,EAAA,OAAO,kSAAkS,SAAS,CAAA,wNAAA,CAAA;AACpT","file":"embed.cjs","sourcesContent":["/**\n * Ash AI Embeddable Widget Loader\n *\n * This is the lightweight loader script that users embed on their sites.\n * It creates a command queue and asynchronously loads the full widget bundle.\n *\n * Usage:\n * ```html\n * <script>\n *   window.AshSettings = {\n *     apiBasePath: 'https://your-api.com/api',\n *     agent: 'your-agent-slug'\n *   };\n *   (function(){var w=window;var a=w.Ash;if(typeof a===\"function\"){a('boot',w.AshSettings);}else{var d=document;var i=function(){i.c(arguments);};i.q=[];i.c=function(args){i.q.push(args);};w.Ash=i;var l=function(){var s=d.createElement('script');s.type='text/javascript';s.async=true;s.src='https://cdn.your-domain.com/ash-widget.js';var x=d.getElementsByTagName('script')[0];x.parentNode.insertBefore(s,x);};if(document.readyState==='complete'){l();}else if(w.attachEvent){w.attachEvent('onload',l);}else{w.addEventListener('load',l,false);}}})();\n * </script>\n * ```\n */\n\n// =============================================================================\n// Event Types\n// =============================================================================\n\n/**\n * Tool use event - fired when the agent invokes a tool\n */\nexport interface AshToolUseEvent {\n  type: 'tool_use';\n  toolName: string;\n  toolId: string;\n  input: unknown;\n}\n\n/**\n * Tool result event - fired when a tool returns a result\n */\nexport interface AshToolResultEvent {\n  type: 'tool_result';\n  toolId: string;\n  result: unknown;\n  isError?: boolean;\n}\n\n/**\n * Streaming event - fired during message streaming\n */\nexport interface AshStreamEvent {\n  type: 'stream_start' | 'stream_delta' | 'stream_end';\n  content?: string;\n  fullContent?: string;\n}\n\n/**\n * Error event - fired when an error occurs\n */\nexport interface AshErrorEvent {\n  type: 'error';\n  error: string;\n  code?: string;\n}\n\n/**\n * Message event - fired for complete messages\n */\nexport interface AshMessageEvent {\n  type: 'message';\n  role: 'user' | 'assistant';\n  content: string;\n  messageId?: string;\n}\n\n/**\n * Todo item in a todo update\n */\nexport interface AshTodoItem {\n  content: string;\n  status: 'pending' | 'in_progress' | 'completed';\n  activeForm: string;\n}\n\n/**\n * Todo update event - fired when todos are updated\n */\nexport interface AshTodoUpdateEvent {\n  type: 'todo_update';\n  todos: AshTodoItem[];\n  stats: {\n    total: number;\n    completed: number;\n    inProgress: number;\n    pending: number;\n  };\n}\n\n/**\n * Union of all widget events\n */\nexport type AshEvent =\n  | AshToolUseEvent\n  | AshToolResultEvent\n  | AshStreamEvent\n  | AshErrorEvent\n  | AshMessageEvent\n  | AshTodoUpdateEvent;\n\n/**\n * Context data that can be pushed to the widget\n */\nexport interface AshContextData {\n  /**\n   * Key-value pairs to include in the system context\n   */\n  [key: string]: unknown;\n}\n\n// =============================================================================\n// Settings Interface\n// =============================================================================\n\nexport interface AshWidgetSettings {\n  /**\n   * Base path for API calls (e.g., \"https://your-api.com/api\")\n   */\n  apiBasePath: string;\n\n  /**\n   * Agent slug to use (optional - auto-selects first agent if not specified)\n   */\n  agent?: string;\n\n  /**\n   * Widget position on the page\n   * - 'bottom-right', 'bottom-left', 'top-right', 'top-left': Floating widget in corner\n   * - 'inline' or 'embedded': Widget fills its parent container (use with containerId)\n   * @default 'bottom-right'\n   */\n  position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left' | 'inline' | 'embedded';\n\n  /**\n   * Container element ID for inline/embedded mode.\n   * The widget will render inside this element and fill it completely.\n   * Make sure to set a height on the container element.\n   */\n  containerId?: string;\n\n  /**\n   * Initial session ID to resume\n   */\n  sessionId?: string;\n\n  /**\n   * Whether to show the widget on load\n   * @default false (shows launcher button)\n   */\n  open?: boolean;\n\n  /**\n   * Custom launcher button text\n   * @default undefined (shows icon only)\n   */\n  launcherText?: string;\n\n  /**\n   * Theme customization\n   */\n  theme?: {\n    /**\n     * Primary accent color (hex)\n     * @default '#ccff00'\n     */\n    accentColor?: string;\n\n    /**\n     * Background color for widget (hex)\n     * @default '#0a0a0a'\n     */\n    backgroundColor?: string;\n\n    /**\n     * Text color (hex)\n     * @default '#f3f4f6'\n     */\n    textColor?: string;\n\n    /**\n     * Border radius for the widget container\n     * @default '16px'\n     */\n    borderRadius?: string;\n  };\n\n  /**\n   * Widget dimensions\n   */\n  size?: {\n    /**\n     * Width of the widget panel\n     * @default '400px'\n     */\n    width?: string;\n\n    /**\n     * Height of the widget panel\n     * @default '600px'\n     */\n    height?: string;\n\n    /**\n     * Maximum height (for inline mode)\n     */\n    maxHeight?: string;\n  };\n\n  /**\n   * Z-index for the widget\n   * @default 2147483647 (max z-index)\n   */\n  zIndex?: number;\n\n  /**\n   * Custom greeting message shown before first interaction\n   */\n  greeting?: string;\n\n  /**\n   * Placeholder text for the input field\n   * @default 'Type a message...'\n   */\n  placeholder?: string;\n\n  /**\n   * Callback when widget is opened\n   */\n  onOpen?: () => void;\n\n  /**\n   * Callback when widget is closed\n   */\n  onClose?: () => void;\n\n  /**\n   * Callback when a session starts\n   */\n  onSessionStart?: (sessionId: string) => void;\n\n  /**\n   * Callback when a message is sent\n   */\n  onMessageSent?: (message: string) => void;\n\n  /**\n   * Callback when a message is received\n   */\n  onMessageReceived?: (message: string) => void;\n\n  // =========================================================================\n  // Advanced Event Hooks\n  // =========================================================================\n\n  /**\n   * Callback for all events (use for logging or custom handling)\n   * This is called for every event type\n   */\n  onEvent?: (event: AshEvent) => void;\n\n  /**\n   * Callback when the agent uses a tool\n   */\n  onToolUse?: (event: AshToolUseEvent) => void;\n\n  /**\n   * Callback when a tool returns a result\n   */\n  onToolResult?: (event: AshToolResultEvent) => void;\n\n  /**\n   * Callback when streaming starts\n   */\n  onStreamStart?: () => void;\n\n  /**\n   * Callback during streaming with delta content\n   */\n  onStreamDelta?: (content: string, fullContent: string) => void;\n\n  /**\n   * Callback when streaming ends\n   */\n  onStreamEnd?: (fullContent: string) => void;\n\n  /**\n   * Callback when an error occurs\n   */\n  onError?: (error: string, code?: string) => void;\n\n  /**\n   * Callback when todos are updated (TodoWrite tool is called)\n   */\n  onTodoUpdate?: (event: AshTodoUpdateEvent) => void;\n\n  // =========================================================================\n  // Context & Data\n  // =========================================================================\n\n  /**\n   * Initial context data to include with messages\n   * This data will be sent as part of the system context\n   */\n  context?: AshContextData;\n\n  /**\n   * Hide the default launcher button (for custom triggers)\n   * @default false\n   */\n  hideLauncher?: boolean;\n}\n\nexport type AshCommand =\n  // Lifecycle commands\n  | ['boot', AshWidgetSettings]\n  | ['shutdown']\n  // Visibility commands\n  | ['open']\n  | ['close']\n  | ['toggle']\n  | ['show']\n  | ['hide']\n  | ['showLauncher']\n  | ['hideLauncher']\n  // Configuration commands\n  | ['update', Partial<AshWidgetSettings>]\n  // Event listener commands\n  | ['onOpen', () => void]\n  | ['onClose', () => void]\n  | ['onEvent', (event: AshEvent) => void]\n  // Data/Context commands\n  | ['setContext', AshContextData]\n  | ['updateContext', Partial<AshContextData>]\n  | ['clearContext']\n  // Message commands\n  | ['sendMessage', string]\n  | ['sendMessageWithContext', string, AshContextData]\n  // Query commands (returns via callback)\n  | ['getSessionId', (sessionId: string | null) => void]\n  | ['getContext', (context: AshContextData) => void]\n  | ['getMessages', (messages: Array<{ role: string; content: string }>) => void];\n\nexport interface AshWidget {\n  (command: AshCommand[0], ...args: unknown[]): void;\n  q?: AshCommand[];\n  c?: (args: AshCommand) => void;\n  booted?: boolean;\n}\n\ndeclare global {\n  interface Window {\n    Ash: AshWidget;\n    AshSettings?: AshWidgetSettings;\n  }\n}\n\n/**\n * Generate the embed snippet for a given configuration\n */\nexport function generateEmbedSnippet(\n  widgetUrl: string,\n  settings: Partial<AshWidgetSettings>\n): string {\n  const settingsJson = JSON.stringify(settings, null, 2);\n\n  return `<!-- Ash AI Widget -->\n<script>\n  window.AshSettings = ${settingsJson};\n  (function(){var w=window;var a=w.Ash;if(typeof a===\"function\"){a('boot',w.AshSettings);}else{var d=document;var i=function(){i.c(arguments);};i.q=[];i.c=function(args){i.q.push(args);};w.Ash=i;var l=function(){var s=d.createElement('script');s.type='text/javascript';s.async=true;s.src='${widgetUrl}';var x=d.getElementsByTagName('script')[0];x.parentNode.insertBefore(s,x);};if(document.readyState==='complete'){l();}else if(w.attachEvent){w.attachEvent('onload',l);}else{w.addEventListener('load',l,false);}}})();\n</script>`;\n}\n\n/**\n * Generate a minified version of the loader\n */\nexport function generateMinifiedLoader(widgetUrl: string): string {\n  return `(function(){var w=window;var a=w.Ash;if(typeof a===\"function\"){a('boot',w.AshSettings);}else{var d=document;var i=function(){i.c(arguments);};i.q=[];i.c=function(args){i.q.push(args);};w.Ash=i;var l=function(){var s=d.createElement('script');s.type='text/javascript';s.async=true;s.src='${widgetUrl}';var x=d.getElementsByTagName('script')[0];x.parentNode.insertBefore(s,x);};if(document.readyState==='complete'){l();}else if(w.attachEvent){w.attachEvent('onload',l);}else{w.addEventListener('load',l,false);}}})();`;\n}\n"]}

package/dist/embed.d.cts

@@ -0,0 +1,278 @@
+/**
+ * Ash AI Embeddable Widget Loader
+ *
+ * This is the lightweight loader script that users embed on their sites.
+ * It creates a command queue and asynchronously loads the full widget bundle.
+ *
+ * Usage:
+ * ```html
+ * <script>
+ *   window.AshSettings = {
+ *     apiBasePath: 'https://your-api.com/api',
+ *     agent: 'your-agent-slug'
+ *   };
+ *   (function(){var w=window;var a=w.Ash;if(typeof a==="function"){a('boot',w.AshSettings);}else{var d=document;var i=function(){i.c(arguments);};i.q=[];i.c=function(args){i.q.push(args);};w.Ash=i;var l=function(){var s=d.createElement('script');s.type='text/javascript';s.async=true;s.src='https://cdn.your-domain.com/ash-widget.js';var x=d.getElementsByTagName('script')[0];x.parentNode.insertBefore(s,x);};if(document.readyState==='complete'){l();}else if(w.attachEvent){w.attachEvent('onload',l);}else{w.addEventListener('load',l,false);}}})();
+ * </script>
+ * ```
+ */
+/**
+ * Tool use event - fired when the agent invokes a tool
+ */
+interface AshToolUseEvent {
+    type: 'tool_use';
+    toolName: string;
+    toolId: string;
+    input: unknown;
+}
+/**
+ * Tool result event - fired when a tool returns a result
+ */
+interface AshToolResultEvent {
+    type: 'tool_result';
+    toolId: string;
+    result: unknown;
+    isError?: boolean;
+}
+/**
+ * Streaming event - fired during message streaming
+ */
+interface AshStreamEvent {
+    type: 'stream_start' | 'stream_delta' | 'stream_end';
+    content?: string;
+    fullContent?: string;
+}
+/**
+ * Error event - fired when an error occurs
+ */
+interface AshErrorEvent {
+    type: 'error';
+    error: string;
+    code?: string;
+}
+/**
+ * Message event - fired for complete messages
+ */
+interface AshMessageEvent {
+    type: 'message';
+    role: 'user' | 'assistant';
+    content: string;
+    messageId?: string;
+}
+/**
+ * Todo item in a todo update
+ */
+interface AshTodoItem {
+    content: string;
+    status: 'pending' | 'in_progress' | 'completed';
+    activeForm: string;
+}
+/**
+ * Todo update event - fired when todos are updated
+ */
+interface AshTodoUpdateEvent {
+    type: 'todo_update';
+    todos: AshTodoItem[];
+    stats: {
+        total: number;
+        completed: number;
+        inProgress: number;
+        pending: number;
+    };
+}
+/**
+ * Union of all widget events
+ */
+type AshEvent = AshToolUseEvent | AshToolResultEvent | AshStreamEvent | AshErrorEvent | AshMessageEvent | AshTodoUpdateEvent;
+/**
+ * Context data that can be pushed to the widget
+ */
+interface AshContextData {
+    /**
+     * Key-value pairs to include in the system context
+     */
+    [key: string]: unknown;
+}
+interface AshWidgetSettings {
+    /**
+     * Base path for API calls (e.g., "https://your-api.com/api")
+     */
+    apiBasePath: string;
+    /**
+     * Agent slug to use (optional - auto-selects first agent if not specified)
+     */
+    agent?: string;
+    /**
+     * Widget position on the page
+     * - 'bottom-right', 'bottom-left', 'top-right', 'top-left': Floating widget in corner
+     * - 'inline' or 'embedded': Widget fills its parent container (use with containerId)
+     * @default 'bottom-right'
+     */
+    position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left' | 'inline' | 'embedded';
+    /**
+     * Container element ID for inline/embedded mode.
+     * The widget will render inside this element and fill it completely.
+     * Make sure to set a height on the container element.
+     */
+    containerId?: string;
+    /**
+     * Initial session ID to resume
+     */
+    sessionId?: string;
+    /**
+     * Whether to show the widget on load
+     * @default false (shows launcher button)
+     */
+    open?: boolean;
+    /**
+     * Custom launcher button text
+     * @default undefined (shows icon only)
+     */
+    launcherText?: string;
+    /**
+     * Theme customization
+     */
+    theme?: {
+        /**
+         * Primary accent color (hex)
+         * @default '#ccff00'
+         */
+        accentColor?: string;
+        /**
+         * Background color for widget (hex)
+         * @default '#0a0a0a'
+         */
+        backgroundColor?: string;
+        /**
+         * Text color (hex)
+         * @default '#f3f4f6'
+         */
+        textColor?: string;
+        /**
+         * Border radius for the widget container
+         * @default '16px'
+         */
+        borderRadius?: string;
+    };
+    /**
+     * Widget dimensions
+     */
+    size?: {
+        /**
+         * Width of the widget panel
+         * @default '400px'
+         */
+        width?: string;
+        /**
+         * Height of the widget panel
+         * @default '600px'
+         */
+        height?: string;
+        /**
+         * Maximum height (for inline mode)
+         */
+        maxHeight?: string;
+    };
+    /**
+     * Z-index for the widget
+     * @default 2147483647 (max z-index)
+     */
+    zIndex?: number;
+    /**
+     * Custom greeting message shown before first interaction
+     */
+    greeting?: string;
+    /**
+     * Placeholder text for the input field
+     * @default 'Type a message...'
+     */
+    placeholder?: string;
+    /**
+     * Callback when widget is opened
+     */
+    onOpen?: () => void;
+    /**
+     * Callback when widget is closed
+     */
+    onClose?: () => void;
+    /**
+     * Callback when a session starts
+     */
+    onSessionStart?: (sessionId: string) => void;
+    /**
+     * Callback when a message is sent
+     */
+    onMessageSent?: (message: string) => void;
+    /**
+     * Callback when a message is received
+     */
+    onMessageReceived?: (message: string) => void;
+    /**
+     * Callback for all events (use for logging or custom handling)
+     * This is called for every event type
+     */
+    onEvent?: (event: AshEvent) => void;
+    /**
+     * Callback when the agent uses a tool
+     */
+    onToolUse?: (event: AshToolUseEvent) => void;
+    /**
+     * Callback when a tool returns a result
+     */
+    onToolResult?: (event: AshToolResultEvent) => void;
+    /**
+     * Callback when streaming starts
+     */
+    onStreamStart?: () => void;
+    /**
+     * Callback during streaming with delta content
+     */
+    onStreamDelta?: (content: string, fullContent: string) => void;
+    /**
+     * Callback when streaming ends
+     */
+    onStreamEnd?: (fullContent: string) => void;
+    /**
+     * Callback when an error occurs
+     */
+    onError?: (error: string, code?: string) => void;
+    /**
+     * Callback when todos are updated (TodoWrite tool is called)
+     */
+    onTodoUpdate?: (event: AshTodoUpdateEvent) => void;
+    /**
+     * Initial context data to include with messages
+     * This data will be sent as part of the system context
+     */
+    context?: AshContextData;
+    /**
+     * Hide the default launcher button (for custom triggers)
+     * @default false
+     */
+    hideLauncher?: boolean;
+}
+type AshCommand = ['boot', AshWidgetSettings] | ['shutdown'] | ['open'] | ['close'] | ['toggle'] | ['show'] | ['hide'] | ['showLauncher'] | ['hideLauncher'] | ['update', Partial<AshWidgetSettings>] | ['onOpen', () => void] | ['onClose', () => void] | ['onEvent', (event: AshEvent) => void] | ['setContext', AshContextData] | ['updateContext', Partial<AshContextData>] | ['clearContext'] | ['sendMessage', string] | ['sendMessageWithContext', string, AshContextData] | ['getSessionId', (sessionId: string | null) => void] | ['getContext', (context: AshContextData) => void] | ['getMessages', (messages: Array<{
+    role: string;
+    content: string;
+}>) => void];
+interface AshWidget {
+    (command: AshCommand[0], ...args: unknown[]): void;
+    q?: AshCommand[];
+    c?: (args: AshCommand) => void;
+    booted?: boolean;
+}
+declare global {
+    interface Window {
+        Ash: AshWidget;
+        AshSettings?: AshWidgetSettings;
+    }
+}
+/**
+ * Generate the embed snippet for a given configuration
+ */
+declare function generateEmbedSnippet(widgetUrl: string, settings: Partial<AshWidgetSettings>): string;
+/**
+ * Generate a minified version of the loader
+ */
+declare function generateMinifiedLoader(widgetUrl: string): string;
+
+export { type AshCommand, type AshContextData, type AshErrorEvent, type AshEvent, type AshMessageEvent, type AshStreamEvent, type AshTodoItem, type AshTodoUpdateEvent, type AshToolResultEvent, type AshToolUseEvent, type AshWidget, type AshWidgetSettings, generateEmbedSnippet, generateMinifiedLoader };

package/dist/embed.d.ts

@@ -0,0 +1,278 @@
+/**
+ * Ash AI Embeddable Widget Loader
+ *
+ * This is the lightweight loader script that users embed on their sites.
+ * It creates a command queue and asynchronously loads the full widget bundle.
+ *
+ * Usage:
+ * ```html
+ * <script>
+ *   window.AshSettings = {
+ *     apiBasePath: 'https://your-api.com/api',
+ *     agent: 'your-agent-slug'
+ *   };
+ *   (function(){var w=window;var a=w.Ash;if(typeof a==="function"){a('boot',w.AshSettings);}else{var d=document;var i=function(){i.c(arguments);};i.q=[];i.c=function(args){i.q.push(args);};w.Ash=i;var l=function(){var s=d.createElement('script');s.type='text/javascript';s.async=true;s.src='https://cdn.your-domain.com/ash-widget.js';var x=d.getElementsByTagName('script')[0];x.parentNode.insertBefore(s,x);};if(document.readyState==='complete'){l();}else if(w.attachEvent){w.attachEvent('onload',l);}else{w.addEventListener('load',l,false);}}})();
+ * </script>
+ * ```
+ */
+/**
+ * Tool use event - fired when the agent invokes a tool
+ */
+interface AshToolUseEvent {
+    type: 'tool_use';
+    toolName: string;
+    toolId: string;
+    input: unknown;
+}
+/**
+ * Tool result event - fired when a tool returns a result
+ */
+interface AshToolResultEvent {
+    type: 'tool_result';
+    toolId: string;
+    result: unknown;
+    isError?: boolean;
+}
+/**
+ * Streaming event - fired during message streaming
+ */
+interface AshStreamEvent {
+    type: 'stream_start' | 'stream_delta' | 'stream_end';
+    content?: string;
+    fullContent?: string;
+}
+/**
+ * Error event - fired when an error occurs
+ */
+interface AshErrorEvent {
+    type: 'error';
+    error: string;
+    code?: string;
+}
+/**
+ * Message event - fired for complete messages
+ */
+interface AshMessageEvent {
+    type: 'message';
+    role: 'user' | 'assistant';
+    content: string;
+    messageId?: string;
+}
+/**
+ * Todo item in a todo update
+ */
+interface AshTodoItem {
+    content: string;
+    status: 'pending' | 'in_progress' | 'completed';
+    activeForm: string;
+}
+/**
+ * Todo update event - fired when todos are updated
+ */
+interface AshTodoUpdateEvent {
+    type: 'todo_update';
+    todos: AshTodoItem[];
+    stats: {
+        total: number;
+        completed: number;
+        inProgress: number;
+        pending: number;
+    };
+}
+/**
+ * Union of all widget events
+ */
+type AshEvent = AshToolUseEvent | AshToolResultEvent | AshStreamEvent | AshErrorEvent | AshMessageEvent | AshTodoUpdateEvent;
+/**
+ * Context data that can be pushed to the widget
+ */
+interface AshContextData {
+    /**
+     * Key-value pairs to include in the system context
+     */
+    [key: string]: unknown;
+}
+interface AshWidgetSettings {
+    /**
+     * Base path for API calls (e.g., "https://your-api.com/api")
+     */
+    apiBasePath: string;
+    /**
+     * Agent slug to use (optional - auto-selects first agent if not specified)
+     */
+    agent?: string;
+    /**
+     * Widget position on the page
+     * - 'bottom-right', 'bottom-left', 'top-right', 'top-left': Floating widget in corner
+     * - 'inline' or 'embedded': Widget fills its parent container (use with containerId)
+     * @default 'bottom-right'
+     */
+    position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left' | 'inline' | 'embedded';
+    /**
+     * Container element ID for inline/embedded mode.
+     * The widget will render inside this element and fill it completely.
+     * Make sure to set a height on the container element.
+     */
+    containerId?: string;
+    /**
+     * Initial session ID to resume
+     */
+    sessionId?: string;
+    /**
+     * Whether to show the widget on load
+     * @default false (shows launcher button)
+     */
+    open?: boolean;
+    /**
+     * Custom launcher button text
+     * @default undefined (shows icon only)
+     */
+    launcherText?: string;
+    /**
+     * Theme customization
+     */
+    theme?: {
+        /**
+         * Primary accent color (hex)
+         * @default '#ccff00'
+         */
+        accentColor?: string;
+        /**
+         * Background color for widget (hex)
+         * @default '#0a0a0a'
+         */
+        backgroundColor?: string;
+        /**
+         * Text color (hex)
+         * @default '#f3f4f6'
+         */
+        textColor?: string;
+        /**
+         * Border radius for the widget container
+         * @default '16px'
+         */
+        borderRadius?: string;
+    };
+    /**
+     * Widget dimensions
+     */
+    size?: {
+        /**
+         * Width of the widget panel
+         * @default '400px'
+         */
+        width?: string;
+        /**
+         * Height of the widget panel
+         * @default '600px'
+         */
+        height?: string;
+        /**
+         * Maximum height (for inline mode)
+         */
+        maxHeight?: string;
+    };
+    /**
+     * Z-index for the widget
+     * @default 2147483647 (max z-index)
+     */
+    zIndex?: number;
+    /**
+     * Custom greeting message shown before first interaction
+     */
+    greeting?: string;
+    /**
+     * Placeholder text for the input field
+     * @default 'Type a message...'
+     */
+    placeholder?: string;
+    /**
+     * Callback when widget is opened
+     */
+    onOpen?: () => void;
+    /**
+     * Callback when widget is closed
+     */
+    onClose?: () => void;
+    /**
+     * Callback when a session starts
+     */
+    onSessionStart?: (sessionId: string) => void;
+    /**
+     * Callback when a message is sent
+     */
+    onMessageSent?: (message: string) => void;
+    /**
+     * Callback when a message is received
+     */
+    onMessageReceived?: (message: string) => void;
+    /**
+     * Callback for all events (use for logging or custom handling)
+     * This is called for every event type
+     */
+    onEvent?: (event: AshEvent) => void;
+    /**
+     * Callback when the agent uses a tool
+     */
+    onToolUse?: (event: AshToolUseEvent) => void;
+    /**
+     * Callback when a tool returns a result
+     */
+    onToolResult?: (event: AshToolResultEvent) => void;
+    /**
+     * Callback when streaming starts
+     */
+    onStreamStart?: () => void;
+    /**
+     * Callback during streaming with delta content
+     */
+    onStreamDelta?: (content: string, fullContent: string) => void;
+    /**
+     * Callback when streaming ends
+     */
+    onStreamEnd?: (fullContent: string) => void;
+    /**
+     * Callback when an error occurs
+     */
+    onError?: (error: string, code?: string) => void;
+    /**
+     * Callback when todos are updated (TodoWrite tool is called)
+     */
+    onTodoUpdate?: (event: AshTodoUpdateEvent) => void;
+    /**
+     * Initial context data to include with messages
+     * This data will be sent as part of the system context
+     */
+    context?: AshContextData;
+    /**
+     * Hide the default launcher button (for custom triggers)
+     * @default false
+     */
+    hideLauncher?: boolean;
+}
+type AshCommand = ['boot', AshWidgetSettings] | ['shutdown'] | ['open'] | ['close'] | ['toggle'] | ['show'] | ['hide'] | ['showLauncher'] | ['hideLauncher'] | ['update', Partial<AshWidgetSettings>] | ['onOpen', () => void] | ['onClose', () => void] | ['onEvent', (event: AshEvent) => void] | ['setContext', AshContextData] | ['updateContext', Partial<AshContextData>] | ['clearContext'] | ['sendMessage', string] | ['sendMessageWithContext', string, AshContextData] | ['getSessionId', (sessionId: string | null) => void] | ['getContext', (context: AshContextData) => void] | ['getMessages', (messages: Array<{
+    role: string;
+    content: string;
+}>) => void];
+interface AshWidget {
+    (command: AshCommand[0], ...args: unknown[]): void;
+    q?: AshCommand[];
+    c?: (args: AshCommand) => void;
+    booted?: boolean;
+}
+declare global {
+    interface Window {
+        Ash: AshWidget;
+        AshSettings?: AshWidgetSettings;
+    }
+}
+/**
+ * Generate the embed snippet for a given configuration
+ */
+declare function generateEmbedSnippet(widgetUrl: string, settings: Partial<AshWidgetSettings>): string;
+/**
+ * Generate a minified version of the loader
+ */
+declare function generateMinifiedLoader(widgetUrl: string): string;
+
+export { type AshCommand, type AshContextData, type AshErrorEvent, type AshEvent, type AshMessageEvent, type AshStreamEvent, type AshTodoItem, type AshTodoUpdateEvent, type AshToolResultEvent, type AshToolUseEvent, type AshWidget, type AshWidgetSettings, generateEmbedSnippet, generateMinifiedLoader };

package/dist/embed.js

@@ -0,0 +1,16 @@
+// src/embed/loader.ts
+function generateEmbedSnippet(widgetUrl, settings) {
+  const settingsJson = JSON.stringify(settings, null, 2);
+  return `<!-- Ash AI Widget -->
+<script>
+  window.AshSettings = ${settingsJson};
+  (function(){var w=window;var a=w.Ash;if(typeof a==="function"){a('boot',w.AshSettings);}else{var d=document;var i=function(){i.c(arguments);};i.q=[];i.c=function(args){i.q.push(args);};w.Ash=i;var l=function(){var s=d.createElement('script');s.type='text/javascript';s.async=true;s.src='${widgetUrl}';var x=d.getElementsByTagName('script')[0];x.parentNode.insertBefore(s,x);};if(document.readyState==='complete'){l();}else if(w.attachEvent){w.attachEvent('onload',l);}else{w.addEventListener('load',l,false);}}})();
+</script>`;
+}
+function generateMinifiedLoader(widgetUrl) {
+  return `(function(){var w=window;var a=w.Ash;if(typeof a==="function"){a('boot',w.AshSettings);}else{var d=document;var i=function(){i.c(arguments);};i.q=[];i.c=function(args){i.q.push(args);};w.Ash=i;var l=function(){var s=d.createElement('script');s.type='text/javascript';s.async=true;s.src='${widgetUrl}';var x=d.getElementsByTagName('script')[0];x.parentNode.insertBefore(s,x);};if(document.readyState==='complete'){l();}else if(w.attachEvent){w.attachEvent('onload',l);}else{w.addEventListener('load',l,false);}}})();`;
+}
+
+export { generateEmbedSnippet, generateMinifiedLoader };
+//# sourceMappingURL=embed.js.map
+//# sourceMappingURL=embed.js.map

package/dist/embed.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/embed/loader.ts"],"names":[],"mappings":";AA2WO,SAAS,oBAAA,CACd,WACA,QAAA,EACQ;AACR,EAAA,MAAM,YAAA,GAAe,IAAA,CAAK,SAAA,CAAU,QAAA,EAAU,MAAM,CAAC,CAAA;AAErD,EAAA,OAAO,CAAA;AAAA;AAAA,uBAAA,EAEgB,YAAY,CAAA;AAAA,iSAAA,EAC8P,SAAS,CAAA;AAAA,SAAA,CAAA;AAE5S;AAKO,SAAS,uBAAuB,SAAA,EAA2B;AAChE,EAAA,OAAO,kSAAkS,SAAS,CAAA,wNAAA,CAAA;AACpT","file":"embed.js","sourcesContent":["/**\n * Ash AI Embeddable Widget Loader\n *\n * This is the lightweight loader script that users embed on their sites.\n * It creates a command queue and asynchronously loads the full widget bundle.\n *\n * Usage:\n * ```html\n * <script>\n *   window.AshSettings = {\n *     apiBasePath: 'https://your-api.com/api',\n *     agent: 'your-agent-slug'\n *   };\n *   (function(){var w=window;var a=w.Ash;if(typeof a===\"function\"){a('boot',w.AshSettings);}else{var d=document;var i=function(){i.c(arguments);};i.q=[];i.c=function(args){i.q.push(args);};w.Ash=i;var l=function(){var s=d.createElement('script');s.type='text/javascript';s.async=true;s.src='https://cdn.your-domain.com/ash-widget.js';var x=d.getElementsByTagName('script')[0];x.parentNode.insertBefore(s,x);};if(document.readyState==='complete'){l();}else if(w.attachEvent){w.attachEvent('onload',l);}else{w.addEventListener('load',l,false);}}})();\n * </script>\n * ```\n */\n\n// =============================================================================\n// Event Types\n// =============================================================================\n\n/**\n * Tool use event - fired when the agent invokes a tool\n */\nexport interface AshToolUseEvent {\n  type: 'tool_use';\n  toolName: string;\n  toolId: string;\n  input: unknown;\n}\n\n/**\n * Tool result event - fired when a tool returns a result\n */\nexport interface AshToolResultEvent {\n  type: 'tool_result';\n  toolId: string;\n  result: unknown;\n  isError?: boolean;\n}\n\n/**\n * Streaming event - fired during message streaming\n */\nexport interface AshStreamEvent {\n  type: 'stream_start' | 'stream_delta' | 'stream_end';\n  content?: string;\n  fullContent?: string;\n}\n\n/**\n * Error event - fired when an error occurs\n */\nexport interface AshErrorEvent {\n  type: 'error';\n  error: string;\n  code?: string;\n}\n\n/**\n * Message event - fired for complete messages\n */\nexport interface AshMessageEvent {\n  type: 'message';\n  role: 'user' | 'assistant';\n  content: string;\n  messageId?: string;\n}\n\n/**\n * Todo item in a todo update\n */\nexport interface AshTodoItem {\n  content: string;\n  status: 'pending' | 'in_progress' | 'completed';\n  activeForm: string;\n}\n\n/**\n * Todo update event - fired when todos are updated\n */\nexport interface AshTodoUpdateEvent {\n  type: 'todo_update';\n  todos: AshTodoItem[];\n  stats: {\n    total: number;\n    completed: number;\n    inProgress: number;\n    pending: number;\n  };\n}\n\n/**\n * Union of all widget events\n */\nexport type AshEvent =\n  | AshToolUseEvent\n  | AshToolResultEvent\n  | AshStreamEvent\n  | AshErrorEvent\n  | AshMessageEvent\n  | AshTodoUpdateEvent;\n\n/**\n * Context data that can be pushed to the widget\n */\nexport interface AshContextData {\n  /**\n   * Key-value pairs to include in the system context\n   */\n  [key: string]: unknown;\n}\n\n// =============================================================================\n// Settings Interface\n// =============================================================================\n\nexport interface AshWidgetSettings {\n  /**\n   * Base path for API calls (e.g., \"https://your-api.com/api\")\n   */\n  apiBasePath: string;\n\n  /**\n   * Agent slug to use (optional - auto-selects first agent if not specified)\n   */\n  agent?: string;\n\n  /**\n   * Widget position on the page\n   * - 'bottom-right', 'bottom-left', 'top-right', 'top-left': Floating widget in corner\n   * - 'inline' or 'embedded': Widget fills its parent container (use with containerId)\n   * @default 'bottom-right'\n   */\n  position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left' | 'inline' | 'embedded';\n\n  /**\n   * Container element ID for inline/embedded mode.\n   * The widget will render inside this element and fill it completely.\n   * Make sure to set a height on the container element.\n   */\n  containerId?: string;\n\n  /**\n   * Initial session ID to resume\n   */\n  sessionId?: string;\n\n  /**\n   * Whether to show the widget on load\n   * @default false (shows launcher button)\n   */\n  open?: boolean;\n\n  /**\n   * Custom launcher button text\n   * @default undefined (shows icon only)\n   */\n  launcherText?: string;\n\n  /**\n   * Theme customization\n   */\n  theme?: {\n    /**\n     * Primary accent color (hex)\n     * @default '#ccff00'\n     */\n    accentColor?: string;\n\n    /**\n     * Background color for widget (hex)\n     * @default '#0a0a0a'\n     */\n    backgroundColor?: string;\n\n    /**\n     * Text color (hex)\n     * @default '#f3f4f6'\n     */\n    textColor?: string;\n\n    /**\n     * Border radius for the widget container\n     * @default '16px'\n     */\n    borderRadius?: string;\n  };\n\n  /**\n   * Widget dimensions\n   */\n  size?: {\n    /**\n     * Width of the widget panel\n     * @default '400px'\n     */\n    width?: string;\n\n    /**\n     * Height of the widget panel\n     * @default '600px'\n     */\n    height?: string;\n\n    /**\n     * Maximum height (for inline mode)\n     */\n    maxHeight?: string;\n  };\n\n  /**\n   * Z-index for the widget\n   * @default 2147483647 (max z-index)\n   */\n  zIndex?: number;\n\n  /**\n   * Custom greeting message shown before first interaction\n   */\n  greeting?: string;\n\n  /**\n   * Placeholder text for the input field\n   * @default 'Type a message...'\n   */\n  placeholder?: string;\n\n  /**\n   * Callback when widget is opened\n   */\n  onOpen?: () => void;\n\n  /**\n   * Callback when widget is closed\n   */\n  onClose?: () => void;\n\n  /**\n   * Callback when a session starts\n   */\n  onSessionStart?: (sessionId: string) => void;\n\n  /**\n   * Callback when a message is sent\n   */\n  onMessageSent?: (message: string) => void;\n\n  /**\n   * Callback when a message is received\n   */\n  onMessageReceived?: (message: string) => void;\n\n  // =========================================================================\n  // Advanced Event Hooks\n  // =========================================================================\n\n  /**\n   * Callback for all events (use for logging or custom handling)\n   * This is called for every event type\n   */\n  onEvent?: (event: AshEvent) => void;\n\n  /**\n   * Callback when the agent uses a tool\n   */\n  onToolUse?: (event: AshToolUseEvent) => void;\n\n  /**\n   * Callback when a tool returns a result\n   */\n  onToolResult?: (event: AshToolResultEvent) => void;\n\n  /**\n   * Callback when streaming starts\n   */\n  onStreamStart?: () => void;\n\n  /**\n   * Callback during streaming with delta content\n   */\n  onStreamDelta?: (content: string, fullContent: string) => void;\n\n  /**\n   * Callback when streaming ends\n   */\n  onStreamEnd?: (fullContent: string) => void;\n\n  /**\n   * Callback when an error occurs\n   */\n  onError?: (error: string, code?: string) => void;\n\n  /**\n   * Callback when todos are updated (TodoWrite tool is called)\n   */\n  onTodoUpdate?: (event: AshTodoUpdateEvent) => void;\n\n  // =========================================================================\n  // Context & Data\n  // =========================================================================\n\n  /**\n   * Initial context data to include with messages\n   * This data will be sent as part of the system context\n   */\n  context?: AshContextData;\n\n  /**\n   * Hide the default launcher button (for custom triggers)\n   * @default false\n   */\n  hideLauncher?: boolean;\n}\n\nexport type AshCommand =\n  // Lifecycle commands\n  | ['boot', AshWidgetSettings]\n  | ['shutdown']\n  // Visibility commands\n  | ['open']\n  | ['close']\n  | ['toggle']\n  | ['show']\n  | ['hide']\n  | ['showLauncher']\n  | ['hideLauncher']\n  // Configuration commands\n  | ['update', Partial<AshWidgetSettings>]\n  // Event listener commands\n  | ['onOpen', () => void]\n  | ['onClose', () => void]\n  | ['onEvent', (event: AshEvent) => void]\n  // Data/Context commands\n  | ['setContext', AshContextData]\n  | ['updateContext', Partial<AshContextData>]\n  | ['clearContext']\n  // Message commands\n  | ['sendMessage', string]\n  | ['sendMessageWithContext', string, AshContextData]\n  // Query commands (returns via callback)\n  | ['getSessionId', (sessionId: string | null) => void]\n  | ['getContext', (context: AshContextData) => void]\n  | ['getMessages', (messages: Array<{ role: string; content: string }>) => void];\n\nexport interface AshWidget {\n  (command: AshCommand[0], ...args: unknown[]): void;\n  q?: AshCommand[];\n  c?: (args: AshCommand) => void;\n  booted?: boolean;\n}\n\ndeclare global {\n  interface Window {\n    Ash: AshWidget;\n    AshSettings?: AshWidgetSettings;\n  }\n}\n\n/**\n * Generate the embed snippet for a given configuration\n */\nexport function generateEmbedSnippet(\n  widgetUrl: string,\n  settings: Partial<AshWidgetSettings>\n): string {\n  const settingsJson = JSON.stringify(settings, null, 2);\n\n  return `<!-- Ash AI Widget -->\n<script>\n  window.AshSettings = ${settingsJson};\n  (function(){var w=window;var a=w.Ash;if(typeof a===\"function\"){a('boot',w.AshSettings);}else{var d=document;var i=function(){i.c(arguments);};i.q=[];i.c=function(args){i.q.push(args);};w.Ash=i;var l=function(){var s=d.createElement('script');s.type='text/javascript';s.async=true;s.src='${widgetUrl}';var x=d.getElementsByTagName('script')[0];x.parentNode.insertBefore(s,x);};if(document.readyState==='complete'){l();}else if(w.attachEvent){w.attachEvent('onload',l);}else{w.addEventListener('load',l,false);}}})();\n</script>`;\n}\n\n/**\n * Generate a minified version of the loader\n */\nexport function generateMinifiedLoader(widgetUrl: string): string {\n  return `(function(){var w=window;var a=w.Ash;if(typeof a===\"function\"){a('boot',w.AshSettings);}else{var d=document;var i=function(){i.c(arguments);};i.q=[];i.c=function(args){i.q.push(args);};w.Ash=i;var l=function(){var s=d.createElement('script');s.type='text/javascript';s.async=true;s.src='${widgetUrl}';var x=d.getElementsByTagName('script')[0];x.parentNode.insertBefore(s,x);};if(document.readyState==='complete'){l();}else if(w.attachEvent){w.attachEvent('onload',l);}else{w.addEventListener('load',l,false);}}})();`;\n}\n"]}