@shuyhere/takotako 0.0.1

package/dist/tools/symphony.js

@@ -0,0 +1,142 @@
+/**
+ * Symphony tools — agent-invocable tools for project orchestration.
+ *
+ * - symphony_start: Start the orchestrator
+ * - symphony_stop: Stop the orchestrator
+ * - symphony_status: Show dashboard
+ * - symphony_history: Show recent completed runs
+ */
+import { SymphonyOrchestrator } from '../core/symphony/orchestrator.js';
+import { formatStatus, formatHistory } from '../core/symphony/status.js';
+function parseIntervalMs(interval) {
+    const match = interval.match(/^(\d+)(ms|s|m|h)?$/);
+    if (!match)
+        return 30000;
+    const [, num, unit] = match;
+    const n = parseInt(num, 10);
+    switch (unit) {
+        case 'ms': return n;
+        case 's': return n * 1000;
+        case 'm': return n * 60000;
+        case 'h': return n * 3600000;
+        default: return n * 1000; // default to seconds
+    }
+}
+const symphonyStartTool = {
+    name: 'symphony_start',
+    description: 'Start Symphony project orchestrator — polls GitHub issues and spawns agents to implement them.',
+    parameters: {
+        type: 'object',
+        properties: {
+            repo: {
+                type: 'string',
+                description: 'GitHub repo in owner/repo format',
+            },
+            labels: {
+                type: 'string',
+                description: 'Comma-separated label filter (e.g. "bug,feature")',
+            },
+            interval: {
+                type: 'string',
+                description: 'Poll interval (e.g. "30s", "5m"). Default: 30s',
+                default: '30s',
+            },
+            max_agents: {
+                type: 'number',
+                description: 'Max concurrent agents. Default: 5',
+                default: 5,
+            },
+        },
+        required: ['repo'],
+    },
+    async execute(params, _ctx) {
+        const { repo, labels, interval, max_agents } = params;
+        // Check if already running
+        const existing = SymphonyOrchestrator.getInstance();
+        if (existing?.isRunning()) {
+            return {
+                output: 'Symphony is already running. Use symphony_stop first.',
+                success: false,
+            };
+        }
+        const config = {
+            repo,
+            labels: labels ? labels.split(',').map((l) => l.trim()) : undefined,
+            pollIntervalMs: interval ? parseIntervalMs(interval) : 30000,
+            maxConcurrentAgents: max_agents ?? 5,
+        };
+        const orchestrator = SymphonyOrchestrator.getInstance(config);
+        if (!orchestrator) {
+            return { output: 'Failed to create orchestrator.', success: false };
+        }
+        orchestrator.start();
+        return {
+            output: `🎵 Symphony started!\n  Repo: ${repo}\n  Labels: ${labels ?? 'all'}\n  Interval: ${interval ?? '30s'}\n  Max agents: ${max_agents ?? 5}`,
+            success: true,
+        };
+    },
+};
+const symphonyStopTool = {
+    name: 'symphony_stop',
+    description: 'Stop the Symphony orchestrator and all running agents.',
+    parameters: {
+        type: 'object',
+        properties: {},
+    },
+    async execute(_params, _ctx) {
+        const orchestrator = SymphonyOrchestrator.getInstance();
+        if (!orchestrator?.isRunning()) {
+            return { output: 'Symphony is not running.', success: false };
+        }
+        SymphonyOrchestrator.destroyInstance();
+        return { output: '🎵 Symphony stopped.', success: true };
+    },
+};
+const symphonyStatusTool = {
+    name: 'symphony_status',
+    description: 'Show Symphony dashboard — running agents, retry queue, history.',
+    parameters: {
+        type: 'object',
+        properties: {},
+    },
+    async execute(_params, _ctx) {
+        const orchestrator = SymphonyOrchestrator.getInstance();
+        if (!orchestrator) {
+            return { output: 'Symphony is not running. Start with symphony_start.', success: false };
+        }
+        const dashboard = formatStatus(orchestrator.getState(), orchestrator.getConfig());
+        return { output: dashboard, success: true };
+    },
+};
+const symphonyHistoryTool = {
+    name: 'symphony_history',
+    description: 'Show recent completed Symphony runs.',
+    parameters: {
+        type: 'object',
+        properties: {
+            limit: {
+                type: 'number',
+                description: 'Max number of entries to show. Default: 20',
+                default: 20,
+            },
+        },
+    },
+    async execute(params, _ctx) {
+        const { limit } = params;
+        const orchestrator = SymphonyOrchestrator.getInstance();
+        if (!orchestrator) {
+            return { output: 'Symphony is not running. Start with symphony_start.', success: false };
+        }
+        const completed = Array.from(orchestrator.getState().completed.values());
+        const output = formatHistory(completed, limit ?? 20);
+        return { output, success: true };
+    },
+};
+/** All Symphony tools for registration. */
+export const symphonyTools = [
+    symphonyStartTool,
+    symphonyStopTool,
+    symphonyStatusTool,
+    symphonyHistoryTool,
+];
+//# sourceMappingURL=symphony.js.map

package/dist/tools/symphony.js.map

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

package/dist/tools/system-tools.d.ts

@@ -0,0 +1,11 @@
+/**
+ * System tools — restart, config reload, status.
+ *
+ * Allows the agent to restart itself and deliver a post-restart note.
+ */
+import type { ToolRegistry } from './registry.js';
+export declare function registerSystemTools(registry: ToolRegistry, opts: {
+    gatewayPort: number;
+    gatewayBind: string;
+}): void;
+//# sourceMappingURL=system-tools.d.ts.map

package/dist/tools/system-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-tools.d.ts","sourceRoot":"","sources":["../../src/tools/system-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAgCpH"}

package/dist/tools/system-tools.js

@@ -0,0 +1,39 @@
+/**
+ * System tools — restart, config reload, status.
+ *
+ * Allows the agent to restart itself and deliver a post-restart note.
+ */
+export function registerSystemTools(registry, opts) {
+    registry.register({
+        name: 'system_restart',
+        description: 'Restart Tako. Use after making code changes, config updates, or when asked to restart. Pass a human-readable note that will be delivered to the user after restart. IMPORTANT: The process will exit shortly after this tool is called, so always include a note for post-restart delivery.',
+        parameters: {
+            type: 'object',
+            properties: {
+                note: {
+                    type: 'string',
+                    description: 'Human-readable message to deliver after restart (e.g. "Restarted after config update.")',
+                },
+            },
+        },
+        execute: async (_args, ctx) => {
+            const note = _args.note || 'Tako restarted.';
+            const sessionKey = ctx.sessionId || null;
+            try {
+                const res = await fetch(`http://${opts.gatewayBind}:${opts.gatewayPort}/restart`, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({ note, sessionKey }),
+                });
+                if (res.ok) {
+                    return { success: true, output: `Restart initiated. Note "${note}" will be delivered after restart.` };
+                }
+                return { output: `Restart request failed: ${res.status}`, success: false };
+            }
+            catch (err) {
+                return { output: `Failed to reach gateway: ${err instanceof Error ? err.message : err}`, success: false };
+            }
+        },
+    });
+}
+//# sourceMappingURL=system-tools.js.map

package/dist/tools/system-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-tools.js","sourceRoot":"","sources":["../../src/tools/system-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,UAAU,mBAAmB,CAAC,QAAsB,EAAE,IAAkD;IAC5G,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,6RAA6R;QAC1S,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yFAAyF;iBACvG;aACF;SACF;QACD,OAAO,EAAE,KAAK,EAAE,KAA8B,EAAE,GAAgB,EAAuB,EAAE;YACvF,MAAM,IAAI,GAAI,KAAK,CAAC,IAAe,IAAI,iBAAiB,CAAC;YACzD,MAAM,UAAU,GAAG,GAAG,CAAC,SAAS,IAAI,IAAI,CAAC;YAEzC,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,UAAU,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,UAAU,EAAE;oBAChF,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;oBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;iBAC3C,CAAC,CAAC;gBACH,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;oBACX,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,4BAA4B,IAAI,oCAAoC,EAAE,CAAC;gBACzG,CAAC;gBACD,OAAO,EAAE,MAAM,EAAE,2BAA2B,GAAG,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YAC7E,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,EAAE,MAAM,EAAE,4BAA4B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YAC5G,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/tool.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Tool — agent syscall trait.
+ *
+ * Tools are the agent's interface to the outside world. Core tools are
+ * baked into the kernel (fs, exec, memory), and skill arms register
+ * additional tools at runtime.
+ *
+ * Each tool defines:
+ * - A JSON Schema for its parameters (sent to the model)
+ * - An execute function that performs the action
+ * - An optional group for profile-based activation
+ *
+ * @example
+ * ```typescript
+ * const readTool: Tool = {
+ *   name: 'read',
+ *   description: 'Read a file from disk',
+ *   parameters: { type: 'object', properties: { path: { type: 'string' } }, required: ['path'] },
+ *   group: 'fs',
+ *   async execute(params, ctx) {
+ *     const { path } = params as { path: string };
+ *     const content = await readFile(path, 'utf-8');
+ *     return { output: content, success: true };
+ *   },
+ * };
+ * ```
+ */
+/** JSON Schema definition for tool parameters. */
+export interface JSONSchema {
+    /** JSON Schema type ('object', 'string', 'number', 'boolean', 'array') */
+    type: string;
+    /** Human-readable description of this schema node */
+    description?: string;
+    /** Property definitions (for type: 'object') */
+    properties?: Record<string, JSONSchema>;
+    /** Required property names (for type: 'object') */
+    required?: string[];
+    /** Item schema (for type: 'array') */
+    items?: JSONSchema;
+    /** Allowed values (enumeration) */
+    enum?: unknown[];
+    /** Default value */
+    default?: unknown;
+    /** Additional schema keywords */
+    [key: string]: unknown;
+}
+/** Runtime context passed to every tool execution. */
+export interface ToolContext {
+    /** Current session ID */
+    sessionId: string;
+    /** Working directory for file operations */
+    workDir: string;
+    /** Agent's workspace root directory */
+    workspaceRoot: string;
+    /** Active agent ID */
+    agentId?: string;
+    /** Active agent's permission role name */
+    agentRole?: string;
+    /** Channel type (e.g. 'discord', 'telegram', 'cli') */
+    channelType?: string;
+    /** Channel target ID (e.g. Discord channel ID without prefix) */
+    channelTarget?: string;
+    /** Channel instance reference for direct channel operations */
+    channel?: unknown;
+    /** Abort signal for cancellation (e.g. timeout) */
+    signal?: AbortSignal;
+    /** Arbitrary metadata from the agent loop */
+    meta?: Record<string, unknown>;
+}
+/** Result returned by a tool execution. */
+export interface ToolResult {
+    /** Tool output text (returned to the model as the tool result) */
+    output: string;
+    /** Whether the tool call succeeded */
+    success: boolean;
+    /** Optional structured data (not sent to model, used internally) */
+    data?: unknown;
+    /** Optional error message (for logging/debugging) */
+    error?: string;
+}
+/**
+ * Tool groups organize tools by domain.
+ * Profiles activate subsets of groups based on the agent's role.
+ */
+export type ToolGroup = 'fs' | 'runtime' | 'memory' | 'web' | 'search' | 'sessions' | 'git' | 'image' | 'agents' | 'messaging';
+/**
+ * Tool activation profiles.
+ * - `minimal`: only fs + runtime (safe for sandboxed environments)
+ * - `coding`: adds search, git, memory (standard development)
+ * - `full`: all groups enabled (unrestricted agent)
+ */
+export type ToolProfile = 'minimal' | 'coding' | 'full';
+/**
+ * Tool — the agent syscall trait.
+ *
+ * Each tool is a named function the model can invoke during generation.
+ * Tools are registered with the ToolRegistry and activated based on the
+ * current profile and policy. Skill arms can register additional tools
+ * at runtime.
+ */
+export interface Tool {
+    /** Unique tool name sent to the model (e.g. 'read', 'exec', 'web_search') */
+    name: string;
+    /** Human-readable description sent to the model to guide tool selection */
+    description: string;
+    /** JSON Schema defining the tool's input parameters */
+    parameters: JSONSchema;
+    /** Tool group for profile-based activation (ungrouped tools are always active) */
+    group?: ToolGroup;
+    /**
+     * Execute the tool with the given parameters and context.
+     *
+     * @param params - Parsed parameters matching the JSON Schema
+     * @param ctx - Runtime context (session, workspace, abort signal)
+     * @returns Tool result with output text and success status
+     */
+    execute(params: unknown, ctx: ToolContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=tool.d.ts.map

package/dist/tools/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/tools/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,kDAAkD;AAClD,MAAM,WAAW,UAAU;IACzB,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,sCAAsC;IACtC,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,mCAAmC;IACnC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,oBAAoB;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iCAAiC;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAID,sDAAsD;AACtD,MAAM,WAAW,WAAW;IAC1B,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mDAAmD;IACnD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,2CAA2C;AAC3C,MAAM,WAAW,UAAU;IACzB,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID;;;GAGG;AACH,MAAM,MAAM,SAAS,GACjB,IAAI,GACJ,SAAS,GACT,QAAQ,GACR,KAAK,GACL,QAAQ,GACR,UAAU,GACV,KAAK,GACL,OAAO,GACP,QAAQ,GACR,WAAW,CAAC;AAEhB;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAIxD;;;;;;;GAOG;AACH,MAAM,WAAW,IAAI;IACnB,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IAEb,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAC;IAEpB,uDAAuD;IACvD,UAAU,EAAE,UAAU,CAAC;IAEvB,kFAAkF;IAClF,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACjE"}

package/dist/tools/tool.js

@@ -0,0 +1,29 @@
+/**
+ * Tool — agent syscall trait.
+ *
+ * Tools are the agent's interface to the outside world. Core tools are
+ * baked into the kernel (fs, exec, memory), and skill arms register
+ * additional tools at runtime.
+ *
+ * Each tool defines:
+ * - A JSON Schema for its parameters (sent to the model)
+ * - An execute function that performs the action
+ * - An optional group for profile-based activation
+ *
+ * @example
+ * ```typescript
+ * const readTool: Tool = {
+ *   name: 'read',
+ *   description: 'Read a file from disk',
+ *   parameters: { type: 'object', properties: { path: { type: 'string' } }, required: ['path'] },
+ *   group: 'fs',
+ *   async execute(params, ctx) {
+ *     const { path } = params as { path: string };
+ *     const content = await readFile(path, 'utf-8');
+ *     return { output: content, success: true };
+ *   },
+ * };
+ * ```
+ */
+export {};
+//# sourceMappingURL=tool.js.map

package/dist/tools/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/tools/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG"}

package/dist/tools/web.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Web tools — web_search, web_fetch.
+ * Kernel tools (always available).
+ */
+import type { Tool } from './tool.js';
+export declare const webSearchTool: Tool;
+export declare const webFetchTool: Tool;
+/** All web tools. */
+export declare const webTools: Tool[];
+//# sourceMappingURL=web.d.ts.map

package/dist/tools/web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/tools/web.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAA2B,MAAM,WAAW,CAAC;AAU/D,eAAO,MAAM,aAAa,EAAE,IAsE3B,CAAC;AAWF,eAAO,MAAM,YAAY,EAAE,IAsC1B,CAAC;AAEF,qBAAqB;AACrB,eAAO,MAAM,QAAQ,EAAE,IAAI,EAAkC,CAAC"}

package/dist/tools/web.js

@@ -0,0 +1,105 @@
+/**
+ * Web tools — web_search, web_fetch.
+ * Kernel tools (always available).
+ */
+import { checkNetworkPolicy } from '../core/security.js';
+export const webSearchTool = {
+    name: 'web_search',
+    description: 'Search the internet for information.',
+    group: 'web',
+    parameters: {
+        type: 'object',
+        properties: {
+            query: { type: 'string', description: 'Search query' },
+            limit: { type: 'number', description: 'Max results (default: 5)' },
+        },
+        required: ['query'],
+    },
+    async execute(params, _ctx) {
+        const { query, limit } = params;
+        const maxResults = limit ?? 5;
+        try {
+            // Use DuckDuckGo HTML lite — no API key required
+            const searchUrl = `https://html.duckduckgo.com/html/?q=${encodeURIComponent(query)}`;
+            const resp = await fetch(searchUrl, {
+                headers: {
+                    'User-Agent': 'Mozilla/5.0 (compatible; Tako/1.0)',
+                },
+            });
+            if (!resp.ok) {
+                return { output: '', success: false, error: `Search request failed: ${resp.status}` };
+            }
+            const html = await resp.text();
+            // Parse search results from DuckDuckGo HTML lite response
+            const results = [];
+            const resultBlocks = html.split('<div class="links_main links_deep result__body">');
+            for (let i = 1; i < resultBlocks.length && results.length < maxResults; i++) {
+                const block = resultBlocks[i];
+                // Extract title
+                const titleMatch = block.match(/<a[^>]*class="result__a"[^>]*>([^<]*(?:<[^>]*>[^<]*)*)<\/a>/);
+                const title = titleMatch
+                    ? titleMatch[1].replace(/<[^>]*>/g, '').replace(/&amp;/g, '&').replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&#x27;/g, "'").replace(/&quot;/g, '"').trim()
+                    : '';
+                // Extract URL from result__url or href
+                const urlMatch = block.match(/href="\/\/duckduckgo\.com\/l\/\?uddg=([^&"]+)/);
+                const url = urlMatch ? decodeURIComponent(urlMatch[1]) : '';
+                // Extract snippet
+                const snippetMatch = block.match(/<a class="result__snippet"[^>]*>([\s\S]*?)<\/a>/);
+                const snippet = snippetMatch
+                    ? snippetMatch[1].replace(/<[^>]*>/g, '').replace(/&amp;/g, '&').replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&#x27;/g, "'").replace(/&quot;/g, '"').replace(/\s+/g, ' ').trim()
+                    : '';
+                if (title || url) {
+                    results.push({ title, url, snippet });
+                }
+            }
+            if (results.length === 0) {
+                return { output: `No results found for: ${query}`, success: true };
+            }
+            const formatted = results.map((r, i) => `${i + 1}. ${r.title}\n   ${r.url}\n   ${r.snippet}`).join('\n\n');
+            return { output: formatted, success: true };
+        }
+        catch (err) {
+            return { output: '', success: false, error: `web_search failed: ${err}` };
+        }
+    },
+};
+export const webFetchTool = {
+    name: 'web_fetch',
+    description: 'Fetch content from a URL.',
+    group: 'web',
+    parameters: {
+        type: 'object',
+        properties: {
+            url: { type: 'string', description: 'URL to fetch' },
+            method: { type: 'string', description: 'HTTP method (default: GET)' },
+            headers: { type: 'object', description: 'Request headers' },
+            body: { type: 'string', description: 'Request body' },
+        },
+        required: ['url'],
+    },
+    async execute(params, _ctx) {
+        const { url, method, headers, body } = params;
+        // Check network policy before fetching
+        const policyBlock = checkNetworkPolicy(url);
+        if (policyBlock) {
+            return { output: '', success: false, error: policyBlock };
+        }
+        try {
+            const resp = await fetch(url, {
+                method: method ?? 'GET',
+                headers,
+                body,
+            });
+            const text = await resp.text();
+            // Truncate large responses
+            const truncated = text.length > 50_000 ? text.slice(0, 50_000) + '\n[...truncated]' : text;
+            return { output: truncated, success: resp.ok };
+        }
+        catch (err) {
+            return { output: '', success: false, error: `web_fetch failed: ${err}` };
+        }
+    },
+};
+/** All web tools. */
+export const webTools = [webSearchTool, webFetchTool];
+//# sourceMappingURL=web.js.map

package/dist/tools/web.js.map

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

package/dist/tui/App.d.ts

@@ -0,0 +1,43 @@
+/**
+ * App — Main Tako 🐙 TUI application.
+ *
+ * Composes Header, MessageList, InputBar, and StatusBar into
+ * a full-screen terminal interface.
+ */
+import React from 'react';
+export interface AgentChoice {
+    id: string;
+    description: string;
+    role: string;
+    isMain: boolean;
+}
+export interface AppConfig {
+    version: string;
+    model: string;
+    toolCount: number;
+    skillCount: number;
+    channel: string;
+    toolProfile: string;
+    memoryStatus: string;
+    /** All available models for /models switching */
+    availableModels?: string[];
+    /** All registered agents for /agent switching */
+    agents?: AgentChoice[];
+    /** Currently active agent ID */
+    activeAgent?: string;
+}
+export interface AppCallbacks {
+    onMessage: (text: string) => void;
+    onCommand: (cmd: string, args: string) => void;
+    onQuit: () => void;
+    /** Switch active model at runtime. */
+    onModelSwitch?: (modelRef: string) => void;
+    /** Switch active agent at runtime. */
+    onAgentSwitch?: (agentId: string) => void;
+}
+export interface TuiAppProps {
+    config: AppConfig;
+    callbacks: AppCallbacks;
+}
+export declare const TuiApp: React.FC<TuiAppProps>;
+//# sourceMappingURL=App.d.ts.map

package/dist/tui/App.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../src/tui/App.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAgC,MAAM,OAAO,CAAC;AAOrD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,iDAAiD;IACjD,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACvB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,sCAAsC;IACtC,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,sCAAsC;IACtC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,YAAY,CAAC;CACzB;AAED,eAAO,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CAoSxC,CAAC"}