@raindrop-ai/wizard 0.0.11 → 0.0.12

package/dist/src/docs/python.mdx

@@ -39,6 +39,12 @@ raindrop.init(os.getenv("RAINDROP_WRITE_KEY"),
 # raindrop.init(os.getenv("RAINDROP_WRITE_KEY"),
 #              wizard_session="__WIZARD_SESSION_UUID__", # REQUIRED
 #              tracing_enabled=True)
+
+# Optional: bypass OTEL exporters for interaction.track_tool() spans only
+# raindrop.init(os.getenv("RAINDROP_WRITE_KEY"),
+#              wizard_session="__WIZARD_SESSION_UUID__", # REQUIRED
+#              tracing_enabled=True,
+#              bypass_otel_for_tools=True)
 ```
 
 ### **Tracking AI Interactions**

package/dist/src/docs/typescript.mdx

@@ -28,7 +28,7 @@ import { Raindrop } from 'raindrop-ai';
 
 // RAINDROP_WRITE_KEY should have already been loaded from environment variables
 const raindrop = new Raindrop({
-  writeKey: process.env.RAINDROP_WRITE_KEY,
+  writeKey: process.env.RAINDROP_WRITE_KEY!,
   wizardSession: '__WIZARD_SESSION_UUID__', // REQUIRED
 });
 ```
@@ -39,10 +39,14 @@ const raindrop = new Raindrop({
 
 The Interaction API uses a simple three-step pattern:
 
-1. **`begin()`** – Create an interaction and log the initial user input
-2. **Update** – Optionally call `setProperty`, `setProperties`, or
-   `addAttachments`
-3. **`finish()`** – Record the AI's final output and close the interaction
+1. **`begin()`** – Start interaction; pass AI data (`model`, `input`, `convoId`)
+   here.
+2. **Update** – Optional: `setProperty` / `setProperties` / `addAttachments` for
+   **custom metadata only** (not `model`/`input`/`output`/`convoId`).
+3. **`finish()`** – End interaction; pass `output` and optionally `model`.
+
+For event tracking calls (`begin()` and `trackAi()`), both `event` and `userId`
+are **REQUIRED**.
 
 ### Example: Chat Completion
 
@@ -57,7 +61,7 @@ import { randomUUID } from 'crypto';
 import { Raindrop } from 'raindrop-ai';
 
 const raindrop = new Raindrop({
-  writeKey: process.env.RAINDROP_WRITE_KEY,
+  writeKey: process.env.RAINDROP_WRITE_KEY!,
   wizardSession: '__WIZARD_SESSION_UUID__', // REQUIRED
 });
 
@@ -66,8 +70,8 @@ const eventId = randomUUID(); // Only generate if the app doesn't already have a
 // 1. Start the interaction — use actual values from your app
 const interaction = raindrop.begin({
   eventId,
-  event: eventName, // A descriptive name for this AI action (e.g. 'chat_message', 'code_generation')
-  userId: userId, // The authenticated user's unique identifier from your app
+  event: eventName, // REQUIRED: descriptive name for this AI action (e.g. 'chat_message', 'code_generation')
+  userId: userId, // REQUIRED: authenticated user's unique identifier from your app
   input: userMessage, // The actual user message/prompt
   model: modelName, // The model being called (e.g. 'gpt-4o')
   convoId: conversationId, // Your app's conversation/thread ID (if applicable)
@@ -91,8 +95,10 @@ interaction.finish({
 
 ### Updating an Interaction
 
-Update an interaction at any point using `setProperty`, `setProperties`, or
-`addAttachments`:
+Use `setProperty`, `setProperties`, or `addAttachments` for custom metadata and
+attachments. Do not use them for `model`, `input`, `output`, or `convoId` (use
+`begin()` / `finish()` instead; see
+[AI data vs properties](#ai-data-fields-vs-custom-properties)).
 
 ```typescript
 interaction.setProperty('stage', 'embedding');
@@ -113,6 +119,22 @@ interaction.addAttachments([
 ]);
 ```
 
+### AI data fields vs custom properties
+
+**Rule:** `model`, `input`, `output`, `convoId` are **AI data** — set only via
+`begin()`, `finish()`, or `trackAi()`. `setProperty()` / `setProperties()` only
+write to **custom properties**; they do not update AI data or UI badges.
+
+| Field                                 | Set via                                    | Not set via     |
+| ------------------------------------- | ------------------------------------------ | --------------- |
+| `model`, `input`, `output`, `convoId` | `begin()`, `finish()`, `trackAi()`         | `setProperty()` |
+| Other metadata                        | `setProperty()`, `properties` in `begin()` | —               |
+
+- **Wrong:** `interaction.setProperty('model', 'gpt-4o')` → adds a property
+  only; Model badge stays empty.
+- **Correct:** pass `model` in `begin({ ... model: 'gpt-4o' })` or
+  `finish({ output: '...', model: 'gpt-4o' })`.
+
 ### Resuming an Interaction
 
 To resume an interaction without the original object returned from `begin()`,
@@ -126,15 +148,16 @@ const interaction = raindrop.resumeInteraction(eventId);
 
 ## Single-Shot Tracking (`trackAi`)
 
-For simple request-response interactions, you can use `trackAi()` directly:
+For simple request-response interactions, use `trackAi()`; pass all AI data
+(`model`, `input`, `output`, `convoId`) in that call (not via `setProperty()`).
 
-Note: `input` and `output` should be the actual prompt sent to and response
-received from your AI model - not literal placeholder strings.
+Note: `input` and `output` should be the actual prompt and response from your
+model, not placeholder strings.
 
 ```typescript
 raindrop.trackAi({
-  event: eventName, // A descriptive name for this AI action (e.g. 'chat_message', 'code_generation')
-  userId: userId, // The authenticated user's unique identifier from your app
+  event: eventName, // REQUIRED: descriptive name for this AI action (e.g. 'chat_message', 'code_generation')
+  userId: userId, // REQUIRED: authenticated user's unique identifier from your app
   model: modelName, // The model being called (e.g. 'gpt-4o-mini')
   input: userPrompt, // The actual prompt sent to the model
   output: modelResponse, // The actual response from the model
@@ -216,7 +239,7 @@ interaction.addAttachments([
 ```typescript
 // Pass actual user data from your app's auth/session
 raindrop.setUserDetails({
-  userId: userId, // The authenticated user's unique identifier
+  userId: userId, // REQUIRED: authenticated user's unique identifier
   traits: {
     // Pass any user traits available in your app — all keys are optional and freeform
     name: userName,
@@ -233,7 +256,7 @@ Enable client-side PII redaction when initializing the SDK:
 
 ```typescript
 new Raindrop({
-  writeKey: process.env.RAINDROP_WRITE_KEY,
+  writeKey: process.env.RAINDROP_WRITE_KEY!,
   wizardSession: '__WIZARD_SESSION_UUID__', // REQUIRED
   redactPii: true,
 });
@@ -252,7 +275,7 @@ appropriate error handling in the application.
 
 ```typescript
 new Raindrop({
-  writeKey: process.env.RAINDROP_WRITE_KEY,
+  writeKey: process.env.RAINDROP_WRITE_KEY!,
   wizardSession: '__WIZARD_SESSION_UUID__', // REQUIRED
   debugLogs: process.env.NODE_ENV !== 'production', // Print queued events
   disabled: process.env.NODE_ENV === 'test', // Disable all tracking
@@ -277,7 +300,7 @@ automatically captured:
 import { Raindrop } from "raindrop-ai";
 
 const raindrop = new Raindrop({
-  writeKey: process.env.RAINDROP_WRITE_KEY,
+  writeKey: process.env.RAINDROP_WRITE_KEY!,
   wizardSession: '__WIZARD_SESSION_UUID__', // REQUIRED
 });
 
@@ -378,8 +401,8 @@ Use `trackTool` to log a tool call after it has completed:
 ```typescript
 const interaction = raindrop.begin({
   eventId: eventId,
-  event: eventName, // A descriptive name for this AI action (e.g. 'chat_message', 'agent_run')
-  userId: userId, // The authenticated user's unique identifier from your app
+  event: eventName, // REQUIRED: descriptive name for this AI action (e.g. 'chat_message', 'agent_run')
+  userId: userId, // REQUIRED: authenticated user's unique identifier from your app
   input: userQuery, // The actual user input
 });
 
@@ -420,8 +443,8 @@ Use `startToolSpan` to track a tool as it executes:
 ```typescript
 const interaction = raindrop.begin({
   eventId: eventId,
-  event: eventName, // A descriptive name for this AI action (e.g. 'chat_message', 'agent_run')
-  userId: userId, // The authenticated user's unique identifier from your app
+  event: eventName, // REQUIRED: descriptive name for this AI action (e.g. 'chat_message', 'agent_run')
+  userId: userId, // REQUIRED: authenticated user's unique identifier from your app
   input: userInput, // The actual user input
 });
 
@@ -467,7 +490,7 @@ import * as AnthropicModule from '@anthropic-ai/sdk'; // Required for instrument
 import { Raindrop } from 'raindrop-ai';
 
 const raindrop = new Raindrop({
-  writeKey: process.env.RAINDROP_WRITE_KEY,
+  writeKey: process.env.RAINDROP_WRITE_KEY!,
   wizardSession: '__WIZARD_SESSION_UUID__', // REQUIRED
   instrumentModules: {
     openAI: OpenAI,
@@ -498,7 +521,7 @@ import { Raindrop } from 'raindrop-ai';
 
 // 1. Create Raindrop with useExternalOtel
 const raindrop = new Raindrop({
-  writeKey: process.env.RAINDROP_WRITE_KEY,
+  writeKey: process.env.RAINDROP_WRITE_KEY!,
   wizardSession: '__WIZARD_SESSION_UUID__',
   useExternalOtel: true, // ⬅️ REQUIRED
 });
@@ -525,7 +548,7 @@ import { Raindrop } from 'raindrop-ai';
 
 // 1. Create Raindrop with useExternalOtel
 const raindrop = new Raindrop({
-  writeKey: process.env.RAINDROP_WRITE_KEY,
+  writeKey: process.env.RAINDROP_WRITE_KEY!,
   wizardSession: '__WIZARD_SESSION_UUID__',
   useExternalOtel: true, // ⬅️ REQUIRED
   instrumentModules: { anthropic: AnthropicModule }, // ← Adapt to project's AI SDK
@@ -559,8 +582,8 @@ const anthropic = new Anthropic({ apiKey: '...' });
 // Note: input and output should be actual model I/O from your app, not placeholder strings
 const interaction = raindrop.begin({
   eventId: eventId,
-  event: eventName, // A descriptive name for this AI action
-  userId: userId, // The authenticated user's unique identifier from your app
+  event: eventName, // REQUIRED: descriptive name for this AI action
+  userId: userId, // REQUIRED: authenticated user's unique identifier from your app
   input: userMessage, // The actual user input
 });
 const response = await interaction.withSpan({ name: 'gen' }, async () => {
@@ -582,6 +605,80 @@ interaction.finish({ output: response.content[0].text }); // The actual model re
 
 ---
 
+### Framework-specific guides
+
+#### Mastra Exporter Integration Guide
+
+When integrating Raindrop into a Mastra project as a custom
+ObservabilityExporter, the following runtime behaviors must be accounted for:
+
+1. AGENT_RUN spans are not root spans
+
+Mastra's HTTP request handler creates a parent span before the agent execution
+span. As a result, AGENT_RUN spans have isRootSpan: false and a non-empty
+parentSpanId. Match on span type alone (span.type === SpanType.AGENT_RUN) and
+deduplicate by traceId using a Map to prevent creating multiple interactions per
+trace.
+
+2. Span IDs are not UUIDs
+
+Mastra uses its own internal span ID format which may not conform to UUID v4.
+Always generate a fresh UUID via crypto.randomUUID() for Raindrop's eventId
+parameter. Do not reuse framework-internal span or trace IDs.
+
+3. Agent input/output is a structured messages array
+
+**Input:** The input field on an AGENT_RUN span is not a plain string. It is an
+AI SDK messages array in the format:
+
+    [{ "role": "user", "content": [{ "type": "text", "text": "actual message" }] }]
+
+Extract the last user message's text content before passing it to Raindrop's
+input field. Handle both the string shorthand (content: "text") and the
+structured content blocks format (content: [{ type: "text", text: "..." }]).
+
+**Output:** The output field on an AGENT_RUN span is not a plain text string. It
+is a JSON-serialized string containing a structured object, typically:
+
+    '{"text":"actual assistant response","files":[]}'
+
+Parse the JSON string and extract the text field before passing it to Raindrop's
+output field. Handle parse failures gracefully by falling back to the raw
+string.
+
+4. Model name is only available on MODEL_GENERATION spans
+
+The AGENT_RUN span does not carry model information. The model name and provider
+are only available in span.attributes.model and span.attributes.provider on
+MODEL_GENERATION child spans. To populate Raindrop's top-level model field in
+aiData, defer the begin() call:
+
+    * On AGENT_RUN SPAN_STARTED: buffer the trace info (input, convoId, eventId) in a pending map.
+    * On MODEL_GENERATION SPAN_STARTED: materialize the pending trace by calling begin() with the model parameter from span.attributes.model.
+    * On AGENT_RUN SPAN_ENDED: call finish() on the interaction. If no MODEL_GENERATION span was seen, materialize without a model as a fallback.
+
+5. Span event ordering
+
+Mastra emits tracing events in this order for a typical agent chat interaction:
+
+    AGENT_RUN SPAN_STARTED
+      → PROCESSOR_RUN spans (started + ended)
+      → MODEL_GENERATION SPAN_STARTED
+        → MODEL_STEP SPAN_STARTED
+          → MODEL_CHUNK spans (streaming)
+        → MODEL_STEP SPAN_ENDED (contains usage/token counts)
+      → MODEL_GENERATION SPAN_ENDED
+      → TOOL_CALL SPAN_STARTED (if tools invoked)
+      → TOOL_CALL SPAN_ENDED
+      → (repeat MODEL_GENERATION + TOOL_CALL for multi-step agents)
+      → PROCESSOR_RUN spans (post-processing)
+    AGENT_RUN SPAN_ENDED
+
+TOOL_CALL and MCP_TOOL_CALL spans should be tracked via interaction.trackTool()
+on SPAN_ENDED, when input, output, and duration are all available.
+
+---
+
 ## Troubleshooting
 
 - Interactions are subject to a 1 MB event limit. Oversized payloads will be

package/dist/src/lib/__tests__/sdk-messages.test.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Tests for SDK message processing utilities
+ */
+export {};

package/dist/src/lib/__tests__/sdk-messages.test.js

@@ -0,0 +1,296 @@
+/**
+ * Tests for SDK message processing utilities
+ */
+const reportSessionErrorMock = jest.fn();
+jest.mock('../../utils/debug.js', () => ({
+    debug: () => { },
+    logToFile: () => { },
+}));
+jest.mock('../../utils/session.js', () => ({
+    reportSessionError: (...args) => reportSessionErrorMock(...args),
+}));
+jest.mock('../constants.js', () => ({
+    ERROR_DISPLAY_MESSAGE: (code) => code
+        ? `Sorry, I encountered a ${code} error. Send another message to continue. If the issue persists, please contact support@raindrop.ai`
+        : `Sorry, I encountered an error. Send another message to continue. If the issue persists, please contact support@raindrop.ai`,
+    INTERNAL_TOOL_NAMES: new Set(),
+    MCP_TOOL_PREFIX: 'mcp__',
+}));
+jest.mock('../handlers.js', () => ({}));
+import { extractResultSummary, getCannedErrorDisplayText, processSDKMessage, } from '../sdk-messages.js';
+import ui from '../../utils/ui.js';
+const addItemMock = ui.addItem;
+const sessionErrorContext = {
+    wizardSessionId: 'wizard-1',
+    accessToken: 'token',
+    orgId: 'org-1',
+    workingDirectory: '/tmp/project',
+};
+const baseContext = {
+    updateSpinner: jest.fn(),
+    baseSpinnerMessage: 'Working',
+    onError: sessionErrorContext,
+};
+const baseOptions = {
+    debug: false,
+    forceInstall: false,
+    installDir: '/tmp',
+    default: false,
+    sessionId: 'test-session',
+    compiledSetup: '',
+};
+const pendingToolCalls = new Map();
+describe('getCannedErrorDisplayText', () => {
+    it('extracts code from "Error: 504" and returns canned message with code', () => {
+        const text = getCannedErrorDisplayText('Error: 504');
+        expect(text).toContain('504');
+        expect(text).toContain('Sorry, I encountered');
+        expect(text).toContain('Send another message to continue');
+    });
+    it('extracts code from "API Error: 429"', () => {
+        const text = getCannedErrorDisplayText('API Error: 429');
+        expect(text).toContain('429');
+        expect(text).toContain('Sorry, I encountered');
+    });
+    it('returns generic message when no code match', () => {
+        const text = getCannedErrorDisplayText('Something went wrong');
+        expect(text).not.toMatch(/\d+ error/);
+        expect(text).toContain('Sorry, I encountered an error');
+        expect(text).toContain('Send another message to continue');
+    });
+    it('returns generic message for empty string', () => {
+        const text = getCannedErrorDisplayText('');
+        expect(text).toContain('Sorry, I encountered an error');
+    });
+});
+describe('extractResultSummary', () => {
+    it('returns undefined for empty content', () => {
+        expect(extractResultSummary('Glob', '')).toBeUndefined();
+        expect(extractResultSummary('Read', '')).toBeUndefined();
+        expect(extractResultSummary('Grep', undefined)).toBeUndefined();
+    });
+    it('Glob: counts non-empty lines as files', () => {
+        expect(extractResultSummary('Glob', '/a\n/b\n/c')).toBe('Found 3 files');
+        expect(extractResultSummary('Glob', '  \n/a\n  \n')).toBe('Found 1 files');
+        expect(extractResultSummary('Glob', '\n\n')).toBe('Found 0 files');
+    });
+    it('Read: returns line count', () => {
+        expect(extractResultSummary('Read', 'line1')).toBe('Read 1 lines');
+        expect(extractResultSummary('Read', 'a\nb\nc')).toBe('Read 3 lines');
+    });
+    it('Grep: counts non-empty match lines', () => {
+        expect(extractResultSummary('Grep', 'match1\nmatch2')).toBe('Found 2 matches');
+        expect(extractResultSummary('Grep', '  \n')).toBe('Found 0 matches');
+    });
+    it('Edit: returns summary from input when input provided', () => {
+        expect(extractResultSummary('Edit', 'ok', {
+            old_string: 'a\nb',
+            new_string: 'a\nb\nc',
+        })).toBe('Added 1 line');
+        expect(extractResultSummary('Edit', 'ok', {
+            old_string: 'x',
+            new_string: 'y',
+        })).toBe('Updated 1 line');
+    });
+    it('Edit: returns undefined when input not provided', () => {
+        expect(extractResultSummary('Edit', 'content')).toBeUndefined();
+    });
+    it('Write: returns summary from input when input provided', () => {
+        expect(extractResultSummary('Write', 'ok', { path: '/foo/bar.ts', content: 'line1\nline2\nline3' })).toBe('Wrote 3 lines to bar.ts');
+        expect(extractResultSummary('Write', 'ok', { path: 'file', content: '' })).toBe('Wrote 0 lines to file');
+    });
+    it('Write: returns undefined when input not provided', () => {
+        expect(extractResultSummary('Write', 'content')).toBeUndefined();
+    });
+    it('handles array result content (e.g. multi-block)', () => {
+        expect(extractResultSummary('Read', [{ text: 'a' }, { text: 'b' }])).toBe('Read 2 lines');
+    });
+    it('returns undefined for unknown tool', () => {
+        expect(extractResultSummary('UnknownTool', 'content')).toBeUndefined();
+    });
+});
+describe('processSDKMessage', () => {
+    beforeEach(() => {
+        reportSessionErrorMock.mockClear();
+        addItemMock.mockClear();
+    });
+    describe('assistant return value lastAssistantHadVisibleContent', () => {
+        it('returns lastAssistantHadVisibleContent true when message has text block', () => {
+            const result = processSDKMessage({
+                type: 'assistant',
+                session_id: 'conv-1',
+                message: {
+                    content: [{ type: 'text', text: 'Hello' }],
+                },
+            }, baseOptions, pendingToolCalls, false, baseContext);
+            expect(result).toEqual({ lastAssistantHadVisibleContent: true });
+        });
+        it('returns lastAssistantHadVisibleContent false when message has only thinking block', () => {
+            const result = processSDKMessage({
+                type: 'assistant',
+                session_id: 'conv-2',
+                message: {
+                    content: [
+                        {
+                            type: 'thinking',
+                            thinking: 'Some internal reasoning.',
+                        },
+                    ],
+                },
+            }, baseOptions, pendingToolCalls, false, baseContext);
+            expect(result).toEqual({ lastAssistantHadVisibleContent: false });
+        });
+        it('returns lastAssistantHadVisibleContent false when message has empty or no content', () => {
+            const result = processSDKMessage({
+                type: 'assistant',
+                session_id: 'conv-3',
+                message: { content: [] },
+            }, baseOptions, pendingToolCalls, false, baseContext);
+            expect(result).toEqual({ lastAssistantHadVisibleContent: false });
+        });
+    });
+    describe('assistant with error', () => {
+        it('reports to session/error and shows canned message in UI when message.error is "unknown" and error text', () => {
+            processSDKMessage({
+                type: 'assistant',
+                error: 'unknown',
+                session_id: 'conv-123',
+                message: {
+                    content: [{ type: 'text', text: 'Error: 504' }],
+                },
+            }, baseOptions, pendingToolCalls, false, baseContext);
+            expect(reportSessionErrorMock).toHaveBeenCalledTimes(1);
+            expect(reportSessionErrorMock).toHaveBeenCalledWith('Error: 504', 'conv-123', sessionErrorContext);
+            expect(addItemMock).toHaveBeenCalledWith({
+                type: 'agent-message',
+                text: expect.stringContaining('504'),
+            });
+            expect(addItemMock.mock.calls[0][0].text).toContain('Send another message to continue');
+        });
+        it('does not call reportSessionError when context.onError or session_id missing', () => {
+            processSDKMessage({
+                type: 'assistant',
+                error: {},
+                session_id: undefined,
+                message: { content: [{ type: 'text', text: 'Error: 504' }] },
+            }, baseOptions, pendingToolCalls, false, baseContext);
+            expect(reportSessionErrorMock).not.toHaveBeenCalled();
+            expect(addItemMock).toHaveBeenCalledWith({
+                type: 'agent-message',
+                text: expect.stringContaining('504'),
+            });
+        });
+    });
+    describe('result with errors', () => {
+        it('reports combined non-interrupt errors to session/error and shows first canned message in UI when not interrupting', () => {
+            processSDKMessage({
+                type: 'result',
+                subtype: 'error',
+                session_id: 'conv-456',
+                errors: ['Error: 503', 'Error: 504'],
+            }, baseOptions, pendingToolCalls, false, baseContext);
+            expect(reportSessionErrorMock).toHaveBeenCalledTimes(1);
+            expect(reportSessionErrorMock).toHaveBeenCalledWith('Error: 503\n\nError: 504', 'conv-456', sessionErrorContext);
+            expect(addItemMock).toHaveBeenCalledTimes(1);
+            expect(addItemMock).toHaveBeenCalledWith({
+                type: 'error',
+                text: expect.stringContaining('503'),
+            });
+        });
+        it('when isInterrupting: still reports to session/error but does not add error to UI', () => {
+            processSDKMessage({
+                type: 'result',
+                subtype: 'error',
+                session_id: 'conv-789',
+                errors: ['Error: 500'],
+            }, baseOptions, pendingToolCalls, true, baseContext);
+            expect(reportSessionErrorMock).toHaveBeenCalledTimes(1);
+            expect(reportSessionErrorMock).toHaveBeenCalledWith('Error: 500', 'conv-789', sessionErrorContext);
+            const errorCalls = addItemMock.mock.calls.filter((c) => c[0] && c[0].type === 'error');
+            expect(errorCalls).toHaveLength(0);
+        });
+        it('does not report or show interrupt-like errors (aborted, interrupted, 403)', () => {
+            processSDKMessage({
+                type: 'result',
+                subtype: 'error',
+                session_id: 'conv-x',
+                errors: ['request aborted', 'interrupted by user', 'Error: 403'],
+            }, baseOptions, pendingToolCalls, false, baseContext);
+            expect(reportSessionErrorMock).not.toHaveBeenCalled();
+            const errorCalls = addItemMock.mock.calls.filter((c) => c[0] && c[0].type === 'error');
+            expect(errorCalls).toHaveLength(0);
+        });
+    });
+    describe('result success with last assistant having only thinking content', () => {
+        it('reports to session/error and queues follow-up prompt when lastAssistantHadVisibleContent is false', () => {
+            const queueFollowUpPromptMock = jest.fn();
+            processSDKMessage({
+                type: 'result',
+                subtype: 'success',
+                session_id: 'conv-no-text',
+            }, baseOptions, pendingToolCalls, false, {
+                ...baseContext,
+                lastAssistantHadVisibleContent: false,
+                queueFollowUpPrompt: queueFollowUpPromptMock,
+            });
+            expect(reportSessionErrorMock).toHaveBeenCalledTimes(1);
+            expect(reportSessionErrorMock).toHaveBeenCalledWith('Last assistant message did not have a text response.', 'conv-no-text', sessionErrorContext);
+            expect(queueFollowUpPromptMock).toHaveBeenCalledTimes(1);
+            expect(queueFollowUpPromptMock).toHaveBeenCalledWith('[Wizard] Continue.');
+        });
+        it('does not report or queue when lastAssistantHadVisibleContent is true', () => {
+            const queueFollowUpPromptMock = jest.fn();
+            processSDKMessage({
+                type: 'result',
+                subtype: 'success',
+                session_id: 'conv-ok',
+            }, baseOptions, pendingToolCalls, false, {
+                ...baseContext,
+                lastAssistantHadVisibleContent: true,
+                queueFollowUpPrompt: queueFollowUpPromptMock,
+            });
+            expect(reportSessionErrorMock).not.toHaveBeenCalled();
+            expect(queueFollowUpPromptMock).not.toHaveBeenCalled();
+        });
+        it('does not report or queue when lastAssistantHadVisibleContent is undefined (treated as had visible)', () => {
+            const queueFollowUpPromptMock = jest.fn();
+            processSDKMessage({
+                type: 'result',
+                subtype: 'success',
+                session_id: 'conv-ok',
+            }, baseOptions, pendingToolCalls, false, { ...baseContext, queueFollowUpPrompt: queueFollowUpPromptMock });
+            expect(reportSessionErrorMock).not.toHaveBeenCalled();
+            expect(queueFollowUpPromptMock).not.toHaveBeenCalled();
+        });
+        it('does not report or queue when isInterrupting is true', () => {
+            const queueFollowUpPromptMock = jest.fn();
+            processSDKMessage({
+                type: 'result',
+                subtype: 'success',
+                session_id: 'conv-no-text',
+            }, baseOptions, pendingToolCalls, true, {
+                ...baseContext,
+                lastAssistantHadVisibleContent: false,
+                queueFollowUpPrompt: queueFollowUpPromptMock,
+            });
+            expect(reportSessionErrorMock).not.toHaveBeenCalled();
+            expect(queueFollowUpPromptMock).not.toHaveBeenCalled();
+        });
+        it('does not report or queue when context.onError or session_id is missing', () => {
+            const queueFollowUpPromptMock = jest.fn();
+            processSDKMessage({
+                type: 'result',
+                subtype: 'success',
+                session_id: undefined,
+            }, baseOptions, pendingToolCalls, false, {
+                updateSpinner: jest.fn(),
+                baseSpinnerMessage: 'Working',
+                lastAssistantHadVisibleContent: false,
+                queueFollowUpPrompt: queueFollowUpPromptMock,
+            });
+            expect(reportSessionErrorMock).not.toHaveBeenCalled();
+            expect(queueFollowUpPromptMock).not.toHaveBeenCalled();
+        });
+    });
+});
+//# sourceMappingURL=sdk-messages.test.js.map

package/dist/src/lib/__tests__/sdk-messages.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-messages.test.js","sourceRoot":"","sources":["../../../../src/lib/__tests__/sdk-messages.test.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Tests for SDK message processing utilities\n */\n\nconst reportSessionErrorMock = jest.fn();\n\njest.mock('../../utils/debug.js', () => ({\n  debug: () => {},\n  logToFile: () => {},\n}));\njest.mock('../../utils/session.js', () => ({\n  reportSessionError: (...args: unknown[]) => reportSessionErrorMock(...args),\n}));\njest.mock('../constants.js', () => ({\n  ERROR_DISPLAY_MESSAGE: (code?: string) =>\n    code\n      ? `Sorry, I encountered a ${code} error. Send another message to continue. If the issue persists, please contact support@raindrop.ai`\n      : `Sorry, I encountered an error. Send another message to continue. If the issue persists, please contact support@raindrop.ai`,\n  INTERNAL_TOOL_NAMES: new Set<string>(),\n  MCP_TOOL_PREFIX: 'mcp__',\n}));\njest.mock('../handlers.js', () => ({}));\n\nimport type { PendingToolCall } from '../handlers.js';\nimport {\n  extractResultSummary,\n  getCannedErrorDisplayText,\n  processSDKMessage,\n} from '../sdk-messages.js';\nimport ui from '../../utils/ui.js';\nconst addItemMock = ui.addItem as jest.Mock;\n\nconst sessionErrorContext = {\n  wizardSessionId: 'wizard-1',\n  accessToken: 'token',\n  orgId: 'org-1',\n  workingDirectory: '/tmp/project',\n};\nconst baseContext = {\n  updateSpinner: jest.fn(),\n  baseSpinnerMessage: 'Working',\n  onError: sessionErrorContext,\n};\nconst baseOptions = {\n  debug: false,\n  forceInstall: false,\n  installDir: '/tmp',\n  default: false,\n  sessionId: 'test-session',\n  compiledSetup: '',\n};\nconst pendingToolCalls = new Map<string, PendingToolCall>();\n\ndescribe('getCannedErrorDisplayText', () => {\n  it('extracts code from \"Error: 504\" and returns canned message with code', () => {\n    const text = getCannedErrorDisplayText('Error: 504');\n    expect(text).toContain('504');\n    expect(text).toContain('Sorry, I encountered');\n    expect(text).toContain('Send another message to continue');\n  });\n\n  it('extracts code from \"API Error: 429\"', () => {\n    const text = getCannedErrorDisplayText('API Error: 429');\n    expect(text).toContain('429');\n    expect(text).toContain('Sorry, I encountered');\n  });\n\n  it('returns generic message when no code match', () => {\n    const text = getCannedErrorDisplayText('Something went wrong');\n    expect(text).not.toMatch(/\\d+ error/);\n    expect(text).toContain('Sorry, I encountered an error');\n    expect(text).toContain('Send another message to continue');\n  });\n\n  it('returns generic message for empty string', () => {\n    const text = getCannedErrorDisplayText('');\n    expect(text).toContain('Sorry, I encountered an error');\n  });\n});\n\ndescribe('extractResultSummary', () => {\n  it('returns undefined for empty content', () => {\n    expect(extractResultSummary('Glob', '')).toBeUndefined();\n    expect(extractResultSummary('Read', '')).toBeUndefined();\n    expect(extractResultSummary('Grep', undefined)).toBeUndefined();\n  });\n\n  it('Glob: counts non-empty lines as files', () => {\n    expect(extractResultSummary('Glob', '/a\\n/b\\n/c')).toBe('Found 3 files');\n    expect(extractResultSummary('Glob', '  \\n/a\\n  \\n')).toBe('Found 1 files');\n    expect(extractResultSummary('Glob', '\\n\\n')).toBe('Found 0 files');\n  });\n\n  it('Read: returns line count', () => {\n    expect(extractResultSummary('Read', 'line1')).toBe('Read 1 lines');\n    expect(extractResultSummary('Read', 'a\\nb\\nc')).toBe('Read 3 lines');\n  });\n\n  it('Grep: counts non-empty match lines', () => {\n    expect(extractResultSummary('Grep', 'match1\\nmatch2')).toBe(\n      'Found 2 matches',\n    );\n    expect(extractResultSummary('Grep', '  \\n')).toBe('Found 0 matches');\n  });\n\n  it('Edit: returns summary from input when input provided', () => {\n    expect(\n      extractResultSummary(\n        'Edit',\n        'ok',\n        {\n          old_string: 'a\\nb',\n          new_string: 'a\\nb\\nc',\n        },\n      ),\n    ).toBe('Added 1 line');\n    expect(\n      extractResultSummary(\n        'Edit',\n        'ok',\n        {\n          old_string: 'x',\n          new_string: 'y',\n        },\n      ),\n    ).toBe('Updated 1 line');\n  });\n\n  it('Edit: returns undefined when input not provided', () => {\n    expect(extractResultSummary('Edit', 'content')).toBeUndefined();\n  });\n\n  it('Write: returns summary from input when input provided', () => {\n    expect(\n      extractResultSummary(\n        'Write',\n        'ok',\n        { path: '/foo/bar.ts', content: 'line1\\nline2\\nline3' },\n      ),\n    ).toBe('Wrote 3 lines to bar.ts');\n    expect(\n      extractResultSummary('Write', 'ok', { path: 'file', content: '' }),\n    ).toBe('Wrote 0 lines to file');\n  });\n\n  it('Write: returns undefined when input not provided', () => {\n    expect(extractResultSummary('Write', 'content')).toBeUndefined();\n  });\n\n  it('handles array result content (e.g. multi-block)', () => {\n    expect(\n      extractResultSummary('Read', [{ text: 'a' }, { text: 'b' }]),\n    ).toBe('Read 2 lines');\n  });\n\n  it('returns undefined for unknown tool', () => {\n    expect(extractResultSummary('UnknownTool', 'content')).toBeUndefined();\n  });\n});\n\ndescribe('processSDKMessage', () => {\n  beforeEach(() => {\n    reportSessionErrorMock.mockClear();\n    addItemMock.mockClear();\n  });\n\n  describe('assistant return value lastAssistantHadVisibleContent', () => {\n    it('returns lastAssistantHadVisibleContent true when message has text block', () => {\n      const result = processSDKMessage(\n        {\n          type: 'assistant',\n          session_id: 'conv-1',\n          message: {\n            content: [{ type: 'text', text: 'Hello' }],\n          },\n        },\n        baseOptions,\n        pendingToolCalls,\n        false,\n        baseContext,\n      );\n      expect(result).toEqual({ lastAssistantHadVisibleContent: true });\n    });\n\n    it('returns lastAssistantHadVisibleContent false when message has only thinking block', () => {\n      const result = processSDKMessage(\n        {\n          type: 'assistant',\n          session_id: 'conv-2',\n          message: {\n            content: [\n              {\n                type: 'thinking',\n                thinking: 'Some internal reasoning.',\n              },\n            ],\n          },\n        },\n        baseOptions,\n        pendingToolCalls,\n        false,\n        baseContext,\n      );\n      expect(result).toEqual({ lastAssistantHadVisibleContent: false });\n    });\n\n    it('returns lastAssistantHadVisibleContent false when message has empty or no content', () => {\n      const result = processSDKMessage(\n        {\n          type: 'assistant',\n          session_id: 'conv-3',\n          message: { content: [] },\n        },\n        baseOptions,\n        pendingToolCalls,\n        false,\n        baseContext,\n      );\n      expect(result).toEqual({ lastAssistantHadVisibleContent: false });\n    });\n  });\n\n  describe('assistant with error', () => {\n    it('reports to session/error and shows canned message in UI when message.error is \"unknown\" and error text', () => {\n      processSDKMessage(\n        {\n          type: 'assistant',\n          error: 'unknown',\n          session_id: 'conv-123',\n          message: {\n            content: [{ type: 'text', text: 'Error: 504' }],\n          },\n        },\n        baseOptions,\n        pendingToolCalls,\n        false,\n        baseContext,\n      );\n\n      expect(reportSessionErrorMock).toHaveBeenCalledTimes(1);\n      expect(reportSessionErrorMock).toHaveBeenCalledWith(\n        'Error: 504',\n        'conv-123',\n        sessionErrorContext,\n      );\n      expect(addItemMock).toHaveBeenCalledWith({\n        type: 'agent-message',\n        text: expect.stringContaining('504'),\n      });\n      expect(addItemMock.mock.calls[0][0].text).toContain(\n        'Send another message to continue',\n      );\n    });\n\n    it('does not call reportSessionError when context.onError or session_id missing', () => {\n      processSDKMessage(\n        {\n          type: 'assistant',\n          error: {},\n          session_id: undefined,\n          message: { content: [{ type: 'text', text: 'Error: 504' }] },\n        },\n        baseOptions,\n        pendingToolCalls,\n        false,\n        baseContext,\n      );\n      expect(reportSessionErrorMock).not.toHaveBeenCalled();\n      expect(addItemMock).toHaveBeenCalledWith({\n        type: 'agent-message',\n        text: expect.stringContaining('504'),\n      });\n    });\n  });\n\n  describe('result with errors', () => {\n    it('reports combined non-interrupt errors to session/error and shows first canned message in UI when not interrupting', () => {\n      processSDKMessage(\n        {\n          type: 'result',\n          subtype: 'error',\n          session_id: 'conv-456',\n          errors: ['Error: 503', 'Error: 504'],\n        },\n        baseOptions,\n        pendingToolCalls,\n        false,\n        baseContext,\n      );\n\n      expect(reportSessionErrorMock).toHaveBeenCalledTimes(1);\n      expect(reportSessionErrorMock).toHaveBeenCalledWith(\n        'Error: 503\\n\\nError: 504',\n        'conv-456',\n        sessionErrorContext,\n      );\n      expect(addItemMock).toHaveBeenCalledTimes(1);\n      expect(addItemMock).toHaveBeenCalledWith({\n        type: 'error',\n        text: expect.stringContaining('503'),\n      });\n    });\n\n    it('when isInterrupting: still reports to session/error but does not add error to UI', () => {\n      processSDKMessage(\n        {\n          type: 'result',\n          subtype: 'error',\n          session_id: 'conv-789',\n          errors: ['Error: 500'],\n        },\n        baseOptions,\n        pendingToolCalls,\n        true,\n        baseContext,\n      );\n\n      expect(reportSessionErrorMock).toHaveBeenCalledTimes(1);\n      expect(reportSessionErrorMock).toHaveBeenCalledWith(\n        'Error: 500',\n        'conv-789',\n        sessionErrorContext,\n      );\n      const errorCalls = addItemMock.mock.calls.filter(\n        (c: unknown[]) => c[0] && (c[0] as { type: string }).type === 'error',\n      );\n      expect(errorCalls).toHaveLength(0);\n    });\n\n    it('does not report or show interrupt-like errors (aborted, interrupted, 403)', () => {\n      processSDKMessage(\n        {\n          type: 'result',\n          subtype: 'error',\n          session_id: 'conv-x',\n          errors: ['request aborted', 'interrupted by user', 'Error: 403'],\n        },\n        baseOptions,\n        pendingToolCalls,\n        false,\n        baseContext,\n      );\n\n      expect(reportSessionErrorMock).not.toHaveBeenCalled();\n      const errorCalls = addItemMock.mock.calls.filter(\n        (c: unknown[]) => c[0] && (c[0] as { type: string }).type === 'error',\n      );\n      expect(errorCalls).toHaveLength(0);\n    });\n  });\n\n  describe('result success with last assistant having only thinking content', () => {\n    it('reports to session/error and queues follow-up prompt when lastAssistantHadVisibleContent is false', () => {\n      const queueFollowUpPromptMock = jest.fn();\n      processSDKMessage(\n        {\n          type: 'result',\n          subtype: 'success',\n          session_id: 'conv-no-text',\n        },\n        baseOptions,\n        pendingToolCalls,\n        false,\n        {\n          ...baseContext,\n          lastAssistantHadVisibleContent: false,\n          queueFollowUpPrompt: queueFollowUpPromptMock,\n        },\n      );\n\n      expect(reportSessionErrorMock).toHaveBeenCalledTimes(1);\n      expect(reportSessionErrorMock).toHaveBeenCalledWith(\n        'Last assistant message did not have a text response.',\n        'conv-no-text',\n        sessionErrorContext,\n      );\n      expect(queueFollowUpPromptMock).toHaveBeenCalledTimes(1);\n      expect(queueFollowUpPromptMock).toHaveBeenCalledWith(\n        '[Wizard] Continue.',\n      );\n    });\n\n    it('does not report or queue when lastAssistantHadVisibleContent is true', () => {\n      const queueFollowUpPromptMock = jest.fn();\n      processSDKMessage(\n        {\n          type: 'result',\n          subtype: 'success',\n          session_id: 'conv-ok',\n        },\n        baseOptions,\n        pendingToolCalls,\n        false,\n        {\n          ...baseContext,\n          lastAssistantHadVisibleContent: true,\n          queueFollowUpPrompt: queueFollowUpPromptMock,\n        },\n      );\n\n      expect(reportSessionErrorMock).not.toHaveBeenCalled();\n      expect(queueFollowUpPromptMock).not.toHaveBeenCalled();\n    });\n\n    it('does not report or queue when lastAssistantHadVisibleContent is undefined (treated as had visible)', () => {\n      const queueFollowUpPromptMock = jest.fn();\n      processSDKMessage(\n        {\n          type: 'result',\n          subtype: 'success',\n          session_id: 'conv-ok',\n        },\n        baseOptions,\n        pendingToolCalls,\n        false,\n        { ...baseContext, queueFollowUpPrompt: queueFollowUpPromptMock },\n      );\n\n      expect(reportSessionErrorMock).not.toHaveBeenCalled();\n      expect(queueFollowUpPromptMock).not.toHaveBeenCalled();\n    });\n\n    it('does not report or queue when isInterrupting is true', () => {\n      const queueFollowUpPromptMock = jest.fn();\n      processSDKMessage(\n        {\n          type: 'result',\n          subtype: 'success',\n          session_id: 'conv-no-text',\n        },\n        baseOptions,\n        pendingToolCalls,\n        true,\n        {\n          ...baseContext,\n          lastAssistantHadVisibleContent: false,\n          queueFollowUpPrompt: queueFollowUpPromptMock,\n        },\n      );\n\n      expect(reportSessionErrorMock).not.toHaveBeenCalled();\n      expect(queueFollowUpPromptMock).not.toHaveBeenCalled();\n    });\n\n    it('does not report or queue when context.onError or session_id is missing', () => {\n      const queueFollowUpPromptMock = jest.fn();\n      processSDKMessage(\n        {\n          type: 'result',\n          subtype: 'success',\n          session_id: undefined,\n        },\n        baseOptions,\n        pendingToolCalls,\n        false,\n        {\n          updateSpinner: jest.fn(),\n          baseSpinnerMessage: 'Working',\n          lastAssistantHadVisibleContent: false,\n          queueFollowUpPrompt: queueFollowUpPromptMock,\n        },\n      );\n\n      expect(reportSessionErrorMock).not.toHaveBeenCalled();\n      expect(queueFollowUpPromptMock).not.toHaveBeenCalled();\n    });\n  });\n});\n"]}