npm - @qduc/term2 - Versions diffs - 0.7.2 → 0.8.0 - Mend

@qduc/term2 0.7.2 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2610) hide show

package/dist/tools/web/web-fetch.test.js ADDED Viewed

@@ -0,0 +1,158 @@
+import { it, expect } from 'vitest';
+import * as fs from 'fs/promises';
+import { createWebFetchToolDefinition } from './web-fetch.js';
+// Mock services
+const mockSettingsService = {};
+const mockLoggingService = {
+    error: () => { },
+    info: () => { },
+    warn: () => { },
+    debug: () => { },
+};
+const webFetchTool = createWebFetchToolDefinition({
+    settingsService: mockSettingsService,
+    loggingService: mockLoggingService,
+});
+it('needsApproval: returns false', async () => {
+    const result = await webFetchTool.needsApproval({ url: 'https://example.com' });
+    expect(result).toBe(false);
+});
+it.sequential('execute: fetches and converts to markdown', async () => {
+    // Mock global fetch
+    const originalFetch = global.fetch;
+    global.fetch = async () => {
+        return {
+            ok: true,
+            status: 200,
+            headers: new Map([['content-type', 'text/html']]),
+            text: async () => '<html><body><h1>Hello World</h1><p>This is a test.</p></body></html>',
+            body: {
+                getReader: () => {
+                    const chunks = [Buffer.from('<html><body><h1>Hello World</h1><p>This is a test.</p></body></html>')];
+                    let i = 0;
+                    return {
+                        read: async () => {
+                            if (i < chunks.length) {
+                                return { done: false, value: chunks[i++] };
+                            }
+                            return { done: true };
+                        },
+                        releaseLock: () => { },
+                    };
+                },
+            },
+        };
+    };
+    try {
+        const result = await webFetchTool.execute({ url: 'https://example.com' });
+        expect(result.includes('# Hello World')).toBe(true);
+        expect(result.includes('This is a test.')).toBe(true);
+        expect(result.includes('Table of Contents')).toBe(true);
+    }
+    finally {
+        global.fetch = originalFetch;
+    }
+});
+it.sequential('execute: handles fetch errors', async () => {
+    const originalFetch = global.fetch;
+    global.fetch = async () => {
+        return {
+            ok: false,
+            status: 404,
+            statusText: 'Not Found',
+        };
+    };
+    try {
+        const result = await webFetchTool.execute({ url: 'https://example.com/404' });
+        expect(result.includes('Error')).toBe(true);
+        expect(result.includes('404')).toBe(true);
+    }
+    finally {
+        global.fetch = originalFetch;
+    }
+});
+it.sequential('execute: converts github blob links to raw links', async () => {
+    const originalFetch = global.fetch;
+    let fetchedUrl = '';
+    global.fetch = async (url) => {
+        fetchedUrl = url.toString();
+        return {
+            ok: true,
+            status: 200,
+            headers: new Map([['content-type', 'text/plain']]),
+            text: async () => 'raw github content',
+        };
+    };
+    try {
+        const githubUrl = 'https://github.com/qduc/term2/blob/main/package.json';
+        await webFetchTool.execute({ url: githubUrl });
+        expect(fetchedUrl).toBe('https://raw.githubusercontent.com/qduc/term2/main/package.json');
+    }
+    finally {
+        global.fetch = originalFetch;
+    }
+});
+it.sequential('execute: saves full content to temp file when content exceeds max_chars', async () => {
+    const originalFetch = global.fetch;
+    // Generate enough HTML to produce > 200 chars of markdown
+    const longText = 'This is a long paragraph that generates enough markdown to exceed the max_chars limit and trigger the temp file creation behavior in the web fetch tool. '.repeat(10);
+    const html = `<html><body><h1>Long Page</h1><p>${longText}</p></body></html>`;
+    global.fetch = async () => {
+        return {
+            ok: true,
+            status: 200,
+            headers: new Map([['content-type', 'text/html']]),
+            text: async () => html,
+        };
+    };
+    let tempFile = null;
+    try {
+        const result = await webFetchTool.execute({ url: 'https://example.com/long', max_chars: 200 });
+        expect(result.includes('Content truncated at 200 characters')).toBe(true);
+        expect(result.includes('Full content saved to temp file:')).toBe(true);
+        // Extract the temp file path from the output and clean up
+        const match = result.match(/`([^`]+\.md)`/);
+        if (match) {
+            tempFile = match[1];
+        }
+    }
+    finally {
+        global.fetch = originalFetch;
+        if (tempFile) {
+            await fs.rm(tempFile, { force: true });
+        }
+    }
+});
+it.sequential('execute: does not save temp file when content fits within max_chars', async () => {
+    const originalFetch = global.fetch;
+    const shortHtml = '<html><body><h1>Short Page</h1><p>Small content.</p></body></html>';
+    global.fetch = async () => {
+        return {
+            ok: true,
+            status: 200,
+            headers: new Map([['content-type', 'text/html']]),
+            text: async () => shortHtml,
+        };
+    };
+    try {
+        const result = await webFetchTool.execute({ url: 'https://example.com/short' });
+        expect(result.includes('Full content saved to temp file:')).toBe(false);
+    }
+    finally {
+        global.fetch = originalFetch;
+    }
+});
+it.sequential('execute: does not save temp file on continuation request', async () => {
+    // Continuation requests should skip the temp file logic entirely,
+    // even if a valid result were returned.
+    const result = await webFetchTool.execute({
+        url: 'https://example.com/page',
+        max_chars: 200,
+        continuation_token: 'nonexistent-token',
+    });
+    // The call will error because the token doesn't exist in the cache,
+    // but it should never try to save a temp file.
+    expect(result.startsWith('Error:')).toBe(true);
+    expect(result.includes('Full content saved to temp file:')).toBe(false);
+});
+//# sourceMappingURL=web-fetch.test.js.map

package/dist/tools/web/web-fetch.test.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"web-fetch.test.js","sourceRoot":"","sources":["../../../source/tools/web/web-fetch.test.ts"],"names":[],"mappings":"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"}

package/dist/tools/web/web-search.d.ts ADDED Viewed

@@ -0,0 +1,29 @@
+/**
+ * Web search tool for the terminal assistant.
+ * Uses pluggable web search providers (default: Tavily) to fetch current information from the web.
+ */
+import { z } from 'zod';
+import type { ToolDefinition, FormatCommandMessage } from '../types.js';
+import { type WebSearchResponse } from '../../providers/web-search/index.js';
+import type { ISettingsService, ILoggingService } from '../../services/service-interfaces.js';
+declare const webSearchSchema: z.ZodObject<{
+    query: z.ZodString;
+}, z.core.$strip>;
+export type WebSearchParams = z.infer<typeof webSearchSchema>;
+/**
+ * Convert web search results to a markdown-formatted string
+ */
+export declare function formatResultsAsMarkdown(response: WebSearchResponse): string;
+/**
+ * Format command message for display in the terminal
+ */
+export declare const formatWebSearchCommandMessage: FormatCommandMessage;
+/**
+ * Factory function to create the web_search tool definition
+ */
+export declare const createWebSearchToolDefinition: (deps: {
+    settingsService: ISettingsService;
+    loggingService: ILoggingService;
+}) => ToolDefinition<WebSearchParams>;
+export {};
+//# sourceMappingURL=web-search.d.ts.map

package/dist/tools/web/web-search.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"web-search.d.ts","sourceRoot":"","sources":["../../../source/tools/web/web-search.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExE,OAAO,EAAkC,KAAK,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAC7G,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAQ9F,QAAA,MAAM,eAAe;;iBAEnB,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CA4B3E;AAED;;GAEG;AACH,eAAO,MAAM,6BAA6B,EAAE,oBAoB3C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,6BAA6B,GAAI,MAAM;IAClD,eAAe,EAAE,gBAAgB,CAAC;IAClC,cAAc,EAAE,eAAe,CAAC;CACjC,KAAG,cAAc,CAAC,eAAe,CAyCjC,CAAC"}

package/dist/tools/web/web-search.js ADDED Viewed

@@ -0,0 +1,104 @@
+/**
+ * Web search tool for the terminal assistant.
+ * Uses pluggable web search providers (default: Tavily) to fetch current information from the web.
+ */
+import { z } from 'zod';
+import { getOutputText, normalizeToolArguments, createBaseMessage, getCallIdFromItem } from '../format-helpers.js';
+import { getConfiguredWebSearchProvider } from '../../providers/web-search/index.js';
+const WEB_SEARCH_DESCRIPTION = 'Search the web for current information. ' +
+    'Use this when you need up-to-date information that may not be in your training data, such as recent news, current events, documentation updates, or any time-sensitive information. ' +
+    'Do NOT use this to read a specific known page; use web_fetch. ' +
+    'Returns a markdown summary with an answer box (when available) and a numbered list of results.';
+const webSearchSchema = z.object({
+    query: z.string().min(1).describe('The search query to look up on the web.'),
+});
+/**
+ * Convert web search results to a markdown-formatted string
+ */
+export function formatResultsAsMarkdown(response) {
+    const parts = [];
+    // Add answer box if available (Tavily's synthesized answer)
+    if (response.answerBox) {
+        parts.push('## Answer\n');
+        parts.push(response.answerBox);
+        parts.push('\n');
+    }
+    // Add search results
+    if (response.results.length > 0) {
+        parts.push('## Search Results\n');
+        response.results.forEach((result, index) => {
+            parts.push(`### ${index + 1}. ${result.title}\n`);
+            parts.push(`**URL:** ${result.url}\n`);
+            if (result.publishedDate) {
+                parts.push(`**Published:** ${result.publishedDate}\n`);
+            }
+            parts.push(`\n${result.content}\n`);
+            parts.push('\n---\n');
+        });
+    }
+    else {
+        parts.push('No results found for this query.\n');
+    }
+    return parts.join('\n');
+}
+/**
+ * Format command message for display in the terminal
+ */
+export const formatWebSearchCommandMessage = (item, index, toolCallArgumentsById) => {
+    const callId = getCallIdFromItem(item);
+    const fallbackArgs = callId && toolCallArgumentsById.has(callId) ? toolCallArgumentsById.get(callId) : null;
+    const normalizedArgs = item?.rawItem?.arguments ?? item?.arguments;
+    const args = normalizeToolArguments(normalizedArgs) ?? normalizeToolArguments(fallbackArgs) ?? {};
+    const query = args?.query ?? 'unknown query';
+    const command = `web_search: "${query}"`;
+    const output = getOutputText(item) || 'No results';
+    const success = !output.startsWith('Error:');
+    return [
+        createBaseMessage(item, index, 0, false, {
+            command,
+            output,
+            success,
+            toolName: 'web_search',
+            toolArgs: args,
+        }),
+    ];
+};
+/**
+ * Factory function to create the web_search tool definition
+ */
+export const createWebSearchToolDefinition = (deps) => {
+    const { settingsService, loggingService } = deps;
+    return {
+        name: 'web_search',
+        description: WEB_SEARCH_DESCRIPTION,
+        parameters: webSearchSchema,
+        needsApproval: () => false, // Web search is read-only, safe operation
+        execute: async (params) => {
+            const { query } = params;
+            try {
+                const provider = getConfiguredWebSearchProvider({ settingsService });
+                if (!provider) {
+                    return 'Error: No web search provider is configured.';
+                }
+                if (!provider.isConfigured({ settingsService })) {
+                    return (`Error: Web search provider '${provider.id}' is not properly configured. ` +
+                        `Please set the required API key (e.g., TAVILY_API_KEY environment variable).`);
+                }
+                const response = await provider.search(query, {
+                    settingsService,
+                    loggingService,
+                });
+                return formatResultsAsMarkdown(response);
+            }
+            catch (error) {
+                loggingService.error('Web search failed', {
+                    query,
+                    error: error.message || String(error),
+                });
+                return `Error: ${error.message || String(error)}`;
+            }
+        },
+        formatCommandMessage: formatWebSearchCommandMessage,
+    };
+};
+//# sourceMappingURL=web-search.js.map

package/dist/tools/web/web-search.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"web-search.js","sourceRoot":"","sources":["../../../source/tools/web/web-search.ts"],"names":[],"mappings":"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"}

package/dist/tools/web/web-search.test.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export {};
2	+ //# sourceMappingURL=web-search.test.d.ts.map

package/dist/tools/web/web-search.test.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"web-search.test.d.ts","sourceRoot":"","sources":["../../../source/tools/web/web-search.test.ts"],"names":[],"mappings":""}

package/dist/tools/web/web-search.test.js ADDED Viewed

@@ -0,0 +1,174 @@
+import { it, expect } from 'vitest';
+import { createWebSearchToolDefinition, formatResultsAsMarkdown, formatWebSearchCommandMessage } from './web-search.js';
+// Helper to create a mock settings service
+const createMockSettingsService = (settings = {}) => ({
+    get: (key) => settings[key],
+    set: () => { },
+});
+// Helper to create a mock logging service
+const createMockLoggingService = () => {
+    const logs = [];
+    return {
+        info: (message, meta) => logs.push({ level: 'info', message, meta }),
+        warn: (message, meta) => logs.push({ level: 'warn', message, meta }),
+        error: (message, meta) => logs.push({ level: 'error', message, meta }),
+        debug: (message, meta) => logs.push({ level: 'debug', message, meta }),
+        security: (message, meta) => logs.push({ level: 'security', message, meta }),
+        setCorrelationId: () => { },
+        getCorrelationId: () => undefined,
+        clearCorrelationId: () => { },
+        getLogs: () => logs,
+    };
+};
+it('createWebSearchToolDefinition defines tool correctly', () => {
+    const settings = createMockSettingsService();
+    const logging = createMockLoggingService();
+    const tool = createWebSearchToolDefinition({
+        settingsService: settings,
+        loggingService: logging,
+    });
+    expect(tool.name).toBe('web_search');
+    expect(tool.description.includes('Search the web')).toBe(true);
+    expect(typeof tool.execute).toBe('function');
+    expect(typeof tool.formatCommandMessage).toBe('function');
+});
+it('needsApproval returns false (read-only operation)', () => {
+    const settings = createMockSettingsService();
+    const logging = createMockLoggingService();
+    const tool = createWebSearchToolDefinition({
+        settingsService: settings,
+        loggingService: logging,
+    });
+    const result = tool.needsApproval({ query: 'test' }, undefined);
+    expect(result).toBe(false);
+});
+it('execute returns error when provider not configured', async () => {
+    const settings = createMockSettingsService({
+        'webSearch.provider': 'tavily',
+        // No API key set
+    });
+    const logging = createMockLoggingService();
+    const tool = createWebSearchToolDefinition({
+        settingsService: settings,
+        loggingService: logging,
+    });
+    const result = await tool.execute({ query: 'test' }, undefined);
+    expect(typeof result === 'string').toBe(true);
+    expect(result.includes('Error:')).toBe(true);
+    expect(result.includes('not properly configured')).toBe(true);
+});
+it('formatResultsAsMarkdown formats results correctly', () => {
+    const response = {
+        query: 'test query',
+        results: [
+            {
+                title: 'Test Result 1',
+                url: 'https://example.com/1',
+                content: 'This is the first result content.',
+                score: 0.95,
+            },
+            {
+                title: 'Test Result 2',
+                url: 'https://example.com/2',
+                content: 'This is the second result content.',
+                publishedDate: '2024-01-15',
+            },
+        ],
+    };
+    const markdown = formatResultsAsMarkdown(response);
+    expect(markdown.includes('## Search Results')).toBe(true);
+    expect(markdown.includes('### 1. Test Result 1')).toBe(true);
+    expect(markdown.includes('**URL:** https://example.com/1')).toBe(true);
+    expect(markdown.includes('This is the first result content.')).toBe(true);
+    expect(markdown.includes('### 2. Test Result 2')).toBe(true);
+    expect(markdown.includes('**Published:** 2024-01-15')).toBe(true);
+});
+it('formatResultsAsMarkdown handles empty results', () => {
+    const response = {
+        query: 'no results query',
+        results: [],
+    };
+    const markdown = formatResultsAsMarkdown(response);
+    expect(markdown.includes('No results found')).toBe(true);
+});
+it('formatResultsAsMarkdown includes answer box when available', () => {
+    const response = {
+        query: 'what is the capital of France',
+        results: [],
+        answerBox: 'The capital of France is Paris.',
+    };
+    const markdown = formatResultsAsMarkdown(response);
+    expect(markdown.includes('## Answer')).toBe(true);
+    expect(markdown.includes('The capital of France is Paris.')).toBe(true);
+});
+it('formatResultsAsMarkdown includes both answer box and results', () => {
+    const response = {
+        query: 'test',
+        results: [
+            {
+                title: 'Result',
+                url: 'https://example.com',
+                content: 'Content here.',
+            },
+        ],
+        answerBox: 'Direct answer.',
+    };
+    const markdown = formatResultsAsMarkdown(response);
+    expect(markdown.includes('## Answer')).toBe(true);
+    expect(markdown.includes('Direct answer.')).toBe(true);
+    expect(markdown.includes('## Search Results')).toBe(true);
+    expect(markdown.includes('Result')).toBe(true);
+});
+it('formatWebSearchCommandMessage extracts query correctly', () => {
+    const item = {
+        rawItem: {
+            arguments: JSON.stringify({ query: 'test search' }),
+        },
+        output: 'Search results here',
+    };
+    const messages = formatWebSearchCommandMessage(item, 0, new Map());
+    expect(messages.length).toBe(1);
+    expect(messages[0].command).toBe('web_search: "test search"');
+    expect(messages[0].toolName).toBe('web_search');
+    expect(messages[0].sender).toBe('command');
+});
+it('formatWebSearchCommandMessage handles missing query', () => {
+    const item = {
+        rawItem: {},
+        output: 'Some output',
+    };
+    const messages = formatWebSearchCommandMessage(item, 0, new Map());
+    expect(messages.length).toBe(1);
+    expect(messages[0].command).toBe('web_search: "unknown query"');
+});
+it('formatWebSearchCommandMessage detects success from output', () => {
+    const successItem = {
+        rawItem: {
+            arguments: JSON.stringify({ query: 'test' }),
+        },
+        output: '## Search Results\n...',
+    };
+    const errorItem = {
+        rawItem: {
+            arguments: JSON.stringify({ query: 'test' }),
+        },
+        output: 'Error: Something went wrong',
+    };
+    const successMessages = formatWebSearchCommandMessage(successItem, 0, new Map());
+    const errorMessages = formatWebSearchCommandMessage(errorItem, 0, new Map());
+    expect(successMessages[0].success).toBe(true);
+    expect(errorMessages[0].success).toBe(false);
+});
+it('formatWebSearchCommandMessage uses fallback args from map', () => {
+    const callId = 'call-123';
+    const item = {
+        rawItem: {
+            callId,
+        },
+        output: 'Results',
+    };
+    const argsMap = new Map([[callId, { query: 'fallback query' }]]);
+    const messages = formatWebSearchCommandMessage(item, 0, argsMap);
+    expect(messages[0].command).toBe('web_search: "fallback query"');
+});
+//# sourceMappingURL=web-search.test.js.map

package/dist/tools/web/web-search.test.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"web-search.test.js","sourceRoot":"","sources":["../../../source/tools/web/web-search.test.ts"],"names":[],"mappings":"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"}

package/dist/types/message.d.ts ADDED Viewed

@@ -0,0 +1,55 @@
+import type { CommandMessage as BaseCommandMessage } from '../tools/types.js';
+import type { NormalizedUsage } from '../utils/ai/token-usage.js';
+import type { SkillAttachment } from '../types/user-turn.js';
+export interface UserMessage {
+    id: string;
+    sender: 'user';
+    text: string;
+    /**
+     * True when the input was consumed as resolution for an aborted tool approval
+     * rather than added to the conversation store as a new user turn. /undo and the
+     * undo selection menu must skip these so UI and store stay aligned.
+     */
+    consumedForAbort?: boolean;
+    skill?: SkillAttachment;
+}
+export interface BotMessage {
+    id: string;
+    sender: 'bot';
+    text: string;
+    status?: 'streaming' | 'finalized';
+    reasoningText?: string;
+    usage?: NormalizedUsage;
+}
+export type CommandMessage = BaseCommandMessage & {
+    hadApproval?: boolean;
+};
+export interface SystemMessage {
+    id: string;
+    sender: 'system';
+    text: string;
+}
+export interface ReasoningMessage {
+    id: string;
+    sender: 'reasoning';
+    text: string;
+    status?: 'finalized';
+}
+export interface SubagentActivityMessage {
+    id: string;
+    sender: 'subagent';
+    status: 'running' | 'completed' | 'failed' | 'cancelled';
+    callId?: string;
+    agentId: string;
+    role: string;
+    task: string;
+    tools: (string | CommandMessage)[];
+    finalText?: string;
+}
+export type Message = UserMessage | BotMessage | CommandMessage | SystemMessage | ReasoningMessage | SubagentActivityMessage;
+export declare const isUserMessage: (message: Message) => message is UserMessage;
+export declare const isBotMessage: (message: Message) => message is BotMessage;
+export declare const isCommandMessage: (message: Message) => message is CommandMessage;
+export declare const isReasoningMessage: (message: Message) => message is ReasoningMessage;
+export declare const isSubagentActivityMessage: (message: Message) => message is SubagentActivityMessage;
+//# sourceMappingURL=message.d.ts.map

package/dist/types/message.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../source/types/message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,IAAI,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,KAAK,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,WAAW,GAAG,WAAW,CAAC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED,MAAM,MAAM,cAAc,GAAG,kBAAkB,GAAG;IAChD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,QAAQ,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,CAAC,MAAM,GAAG,cAAc,CAAC,EAAE,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,OAAO,GACf,WAAW,GACX,UAAU,GACV,cAAc,GACd,aAAa,GACb,gBAAgB,GAChB,uBAAuB,CAAC;AAE5B,eAAO,MAAM,aAAa,GAAI,SAAS,OAAO,KAAG,OAAO,IAAI,WAAwC,CAAC;AAErG,eAAO,MAAM,YAAY,GAAI,SAAS,OAAO,KAAG,OAAO,IAAI,UAAsC,CAAC;AAElG,eAAO,MAAM,gBAAgB,GAAI,SAAS,OAAO,KAAG,OAAO,IAAI,cAA8C,CAAC;AAE9G,eAAO,MAAM,kBAAkB,GAAI,SAAS,OAAO,KAAG,OAAO,IAAI,gBAAkD,CAAC;AAEpH,eAAO,MAAM,yBAAyB,GAAI,SAAS,OAAO,KAAG,OAAO,IAAI,uBACzC,CAAC"}

package/dist/types/message.js ADDED Viewed

@@ -0,0 +1,6 @@
+export const isUserMessage = (message) => message.sender === 'user';
+export const isBotMessage = (message) => message.sender === 'bot';
+export const isCommandMessage = (message) => message.sender === 'command';
+export const isReasoningMessage = (message) => message.sender === 'reasoning';
+export const isSubagentActivityMessage = (message) => message.sender === 'subagent';
+//# sourceMappingURL=message.js.map

package/dist/types/message.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"message.js","sourceRoot":"","sources":["../../source/types/message.ts"],"names":[],"mappings":"AA+DA,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAgB,EAA0B,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC;AAErG,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAgB,EAAyB,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC;AAElG,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAAgB,EAA6B,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC;AAE9G,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAAgB,EAA+B,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,WAAW,CAAC;AAEpH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,OAAgB,EAAsC,EAAE,CAChG,OAAO,CAAC,MAAM,KAAK,UAAU,CAAC"}

package/dist/types/terminal.d.ts ADDED Viewed

@@ -0,0 +1,4 @@
+export type TerminalWriter = {
+    write: (value: string) => unknown;
+};
+//# sourceMappingURL=terminal.d.ts.map

package/dist/types/terminal.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../source/types/terminal.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;CACnC,CAAC"}

package/dist/types/terminal.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export {};
2	+ //# sourceMappingURL=terminal.js.map

package/dist/types/terminal.js.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"terminal.js","sourceRoot":"","sources":["../../source/types/terminal.ts"],"names":[],"mappings":""}

package/dist/types/user-turn.d.ts CHANGED Viewed

@@ -5,12 +5,19 @@ export type UserTurnImage = {
     byteSize: number;
     displayNumber: number;
 };
+export type SkillAttachment = {
+    name: string;
+    description: string;
+    body: string;
+};
 export type UserTurn = {
     text: string;
     images?: UserTurnImage[];
+    skill?: SkillAttachment;
 };
 export declare function stripImageSentinels(text: string): string;
 export declare function normalizeUserTurn(input: string | UserTurn): UserTurn;
 export declare function hasUserTurnContent(turn: UserTurn): boolean;
 export declare function formatUserTurnForDisplay(turn: UserTurn): string;
+export declare function injectSkillIntoTurn(turn: UserTurn): UserTurn;
 //# sourceMappingURL=user-turn.d.ts.map

package/dist/types/user-turn.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"user-turn.d.ts","sourceRoot":"","sources":["../../source/types/user-turn.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;~~CAC1B~~,CAAC;AAKF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,~~CASpE~~;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAE1D;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,~~CAS~~/D"}
1	+ {"version":3,"file":"user-turn.d.ts","sourceRoot":"","sources":["../../source/types/user-turn.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB,CAAC;AAKF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAUpE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAE1D;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAkB/D;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAqB5D"}