actoviq-agent-sdk 0.4.0 → 0.4.1

package/dist/src/tools/tavilySearch.js

@@ -0,0 +1,139 @@
+/**
+ * Tavily Search Tool — AI-optimized web search via Tavily REST API.
+ * No Python dependency. Uses fetch() directly.
+ *
+ * Requires: TAVILY_API_KEY env var (get key at https://tavily.com)
+ */
+import { z } from 'zod';
+import { tool } from '../runtime/tools.js';
+export const TAVILY_SEARCH_TOOL_NAME = 'TavilySearch';
+const tavilySearchSchema = z.strictObject({
+    query: z.string().min(2).describe('The search query'),
+    depth: z.enum(['basic', 'advanced']).optional().default('basic')
+        .describe('Search depth: basic (fast, 1-2s) or advanced (comprehensive, 5-10s)'),
+    topic: z.enum(['general', 'news']).optional().default('general')
+        .describe('general for broad web, news for current events (last 7 days)'),
+    max_results: z.number().int().min(1).max(20).optional().default(5)
+        .describe('Number of results (1-20)'),
+    include_answer: z.boolean().optional().default(true)
+        .describe('Include AI-generated answer summary'),
+    include_raw_content: z.boolean().optional().default(false)
+        .describe('Include raw HTML content of sources'),
+    include_domains: z.array(z.string()).optional()
+        .describe('Only include results from these domains'),
+    exclude_domains: z.array(z.string()).optional()
+        .describe('Exclude results from these domains'),
+});
+function formatResults(data, input) {
+    const lines = [];
+    lines.push(`Query: "${data.query}"`);
+    if (data.response_time)
+        lines.push(`Response time: ${data.response_time.toFixed(2)}s`);
+    if (data.answer) {
+        lines.push('');
+        lines.push('## AI Answer');
+        lines.push(data.answer);
+    }
+    if (data.results.length > 0) {
+        lines.push('');
+        lines.push(`## Results (${data.results.length})`);
+        for (let i = 0; i < data.results.length; i++) {
+            const r = data.results[i];
+            lines.push(`\n${i + 1}. **${r.title}**`);
+            lines.push(`   URL: ${r.url}`);
+            lines.push(`   Score: ${r.score.toFixed(2)}`);
+            lines.push(`   ${r.content.slice(0, 300)}`);
+        }
+    }
+    if (data.images && data.images.length > 0) {
+        lines.push(`\n## Images (${data.images.length})`);
+        for (const img of data.images.slice(0, 5)) {
+            lines.push(`   ${img}`);
+        }
+    }
+    return lines.join('\n');
+}
+export function createTavilySearchTool() {
+    return tool({
+        name: TAVILY_SEARCH_TOOL_NAME,
+        description: 'AI-optimized web search via Tavily. Returns clean structured results with ' +
+            'optional AI-generated answer summary. Supports domain filtering, news search, ' +
+            'and raw content extraction. Use for research, fact-checking, current events.',
+        inputSchema: tavilySearchSchema,
+        isReadOnly: () => true,
+        prompt: async () => [
+            '## TavilySearch Tool',
+            'AI-optimized web search. Key capabilities:',
+            '- AI-generated answer summaries from search results',
+            '- Clean structured results (title, URL, content, relevance score)',
+            '- `depth: "basic"` for quick facts, `"advanced"` for comprehensive research',
+            '- `topic: "news"` for current events (last 7 days)',
+            '- Domain filtering with `include_domains` / `exclude_domains`',
+            '- Set `include_raw_content: true` for full HTML of sources',
+            '',
+            'Best practices:',
+            '- Start with basic depth for most queries',
+            '- Use advanced only for complex research topics',
+            '- Limit max_results to what you actually need',
+            '- Always cite sources in your response',
+        ].join('\n'),
+    }, async (input, _context, onProgress) => {
+        // Resolve API key: env var > ~/.tavily/config.json
+        let apiKey = process.env.TAVILY_API_KEY;
+        if (!apiKey) {
+            try {
+                const fs = await import('node:fs');
+                const path = await import('node:path');
+                const os = await import('node:os');
+                const configPath = path.join(os.homedir(), '.tavily', 'config.json');
+                if (fs.existsSync(configPath)) {
+                    const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+                    apiKey = config.api_key;
+                }
+            }
+            catch { /* ignore */ }
+        }
+        if (!apiKey) {
+            return 'Error: Tavily API key not found. Set TAVILY_API_KEY env var or create ~/.tavily/config.json with {"api_key": "tvly-..."}. Get a free key at https://tavily.com';
+        }
+        onProgress?.({
+            toolUseID: '',
+            data: { type: 'searching', message: `Tavily search: "${input.query}" (${input.depth}/${input.topic})` },
+        });
+        const body = {
+            api_key: apiKey,
+            query: input.query,
+            search_depth: input.depth,
+            topic: input.topic,
+            max_results: input.max_results,
+            include_answer: input.include_answer,
+            include_raw_content: input.include_raw_content,
+        };
+        if (input.include_domains)
+            body.include_domains = input.include_domains;
+        if (input.exclude_domains)
+            body.exclude_domains = input.exclude_domains;
+        try {
+            const response = await fetch('https://api.tavily.com/search', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(body),
+                signal: AbortSignal.timeout(30000),
+            });
+            if (!response.ok) {
+                const errText = await response.text().catch(() => '');
+                return `Tavily search failed: HTTP ${response.status} ${response.statusText}. ${errText.slice(0, 200)}`;
+            }
+            const data = (await response.json());
+            return formatResults(data, input);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (message.includes('abort') || message.includes('timeout')) {
+                return `Tavily search timed out after 30s. Try a simpler query or use basic depth.`;
+            }
+            return `Tavily search failed: ${message}`;
+        }
+    });
+}
+//# sourceMappingURL=tavilySearch.js.map

package/dist/src/tools/tavilySearch.js.map

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

package/dist/src/tui/actoviqTui.d.ts

@@ -1,6 +1,16 @@
 import type { ActoviqPermissionMode } from '../types.js';
 export declare const TUI_SLASH_COMMANDS: Record<string, string>;
 export declare function filterSlashCommands(input: string): string[];
+/**
+ * Detect an active "@file" mention at the cursor for path completion. Returns
+ * the partial token typed after the '@' plus the '@' offset, or null when the
+ * cursor is not inside a mention. The '@' only opens a mention at the start of
+ * input or after whitespace, and the token ends at the first whitespace.
+ */
+export declare function activeAtToken(text: string, cursor: number): {
+    token: string;
+    start: number;
+} | null;
 export interface ActoviqTuiOptions {
     workDir?: string;
     configPath?: string;

package/dist/src/tui/actoviqTui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actoviqTui.d.ts","sourceRoot":"","sources":["../../../src/tui/actoviqTui.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAIV,qBAAqB,EAGtB,MAAM,aAAa,CAAC;AA0CrB,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAiBrD,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAM3D;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAkED,wBAAsB,aAAa,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAggDlF"}
+{"version":3,"file":"actoviqTui.d.ts","sourceRoot":"","sources":["../../../src/tui/actoviqTui.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAIV,qBAAqB,EAMtB,MAAM,aAAa,CAAC;AA2CrB,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAoBrD,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAM3D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAYzC;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAgGD,wBAAsB,aAAa,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CA05DlF"}