@shuyhere/takotako 0.0.1

package/dist/core/thread-bindings.js

@@ -0,0 +1,94 @@
+/**
+ * Thread binding manager — maps Discord threads to sub-agent sessions.
+ *
+ * When a sub-agent spawns with `thread: true`, a Discord thread is created
+ * and bound to that agent's session. Messages in the thread route to the
+ * sub-agent instead of the main agent. After 24h idle the thread is unbound
+ * and auto-archived.
+ *
+ * Session key format: agent:<agentId>:<channelId>:thread:<threadId>
+ */
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+// ─── Constants ──────────────────────────────────────────────────────
+export const THREAD_IDLE_TIMEOUT_MS = 24 * 60 * 60 * 1000; // 24 hours
+// ─── Manager ────────────────────────────────────────────────────────
+export class ThreadBindingManager {
+    bindings = new Map();
+    persistPath;
+    constructor(persistPath) {
+        this.persistPath = persistPath;
+    }
+    /** Bind a thread to a sub-agent session. */
+    bind(threadId, binding) {
+        const now = Date.now();
+        this.bindings.set(threadId, {
+            ...binding,
+            createdAt: now,
+            lastActiveAt: now,
+        });
+    }
+    /** Unbind a thread. */
+    unbind(threadId) {
+        this.bindings.delete(threadId);
+    }
+    /** Get the binding for a thread, if any. */
+    getBinding(threadId) {
+        return this.bindings.get(threadId);
+    }
+    /** Update lastActiveAt for a thread. */
+    touch(threadId) {
+        const binding = this.bindings.get(threadId);
+        if (binding) {
+            binding.lastActiveAt = Date.now();
+        }
+    }
+    /** Sweep expired bindings (idle > 24h). Returns the expired bindings. */
+    sweepExpired() {
+        const now = Date.now();
+        const expired = [];
+        for (const [threadId, binding] of this.bindings) {
+            if (now - binding.lastActiveAt > THREAD_IDLE_TIMEOUT_MS) {
+                expired.push(binding);
+                this.bindings.delete(threadId);
+            }
+        }
+        return expired;
+    }
+    /** Number of active bindings. */
+    get size() {
+        return this.bindings.size;
+    }
+    /** Save bindings to disk. */
+    async save() {
+        const data = {};
+        for (const [threadId, binding] of this.bindings) {
+            data[threadId] = binding;
+        }
+        try {
+            await mkdir(dirname(this.persistPath), { recursive: true });
+            await writeFile(this.persistPath, JSON.stringify({ bindings: data }, null, 2), 'utf-8');
+        }
+        catch (err) {
+            console.error('[tako] Failed to save thread bindings:', err instanceof Error ? err.message : err);
+        }
+    }
+    /** Load bindings from disk. */
+    async load() {
+        try {
+            const raw = await readFile(this.persistPath, 'utf-8');
+            const parsed = JSON.parse(raw);
+            this.bindings.clear();
+            for (const [threadId, binding] of Object.entries(parsed.bindings)) {
+                this.bindings.set(threadId, binding);
+            }
+            if (this.bindings.size > 0) {
+                console.log(`[tako] Loaded ${this.bindings.size} thread binding(s)`);
+            }
+        }
+        catch {
+            // File doesn't exist yet — that's fine
+        }
+    }
+}
+//# sourceMappingURL=thread-bindings.js.map

package/dist/core/thread-bindings.js.map

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

package/dist/core/timezone.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Timezone — provide timezone context to the agent.
+ *
+ * Auto-detects from the system or uses a configured IANA timezone.
+ * Generates a human-readable context string for system prompt injection.
+ */
+export interface TimezoneConfig {
+    /** User's timezone (IANA format, e.g. 'Asia/Riyadh'). */
+    timezone?: string;
+    /** Auto-detect from system (default: true). */
+    autoDetect: boolean;
+}
+export declare class TimezoneManager {
+    private tz;
+    constructor(config?: Partial<TimezoneConfig>);
+    /** Get current timezone. */
+    getTimezone(): string;
+    /** Get current time formatted for the agent. */
+    getCurrentTime(): string;
+    /** Format a date in the user's timezone. */
+    format(date: Date, fmt?: string): string;
+    /**
+     * Get timezone context string for system prompt injection.
+     * Returns: "Current date/time: Saturday, March 7th, 2026 — 2:09 PM (Asia/Riyadh)"
+     */
+    getContextString(): string;
+}
+//# sourceMappingURL=timezone.d.ts.map

package/dist/core/timezone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timezone.d.ts","sourceRoot":"","sources":["../../src/core/timezone.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,UAAU,EAAE,OAAO,CAAC;CACrB;AAID,qBAAa,eAAe;IAC1B,OAAO,CAAC,EAAE,CAAS;gBAEP,MAAM,GAAE,OAAO,CAAC,cAAc,CAAM;IAUhD,4BAA4B;IAC5B,WAAW,IAAI,MAAM;IAIrB,gDAAgD;IAChD,cAAc,IAAI,MAAM;IAIxB,4CAA4C;IAC5C,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM;IAqCxC;;;OAGG;IACH,gBAAgB,IAAI,MAAM;CAI3B"}

package/dist/core/timezone.js

@@ -0,0 +1,72 @@
+/**
+ * Timezone — provide timezone context to the agent.
+ *
+ * Auto-detects from the system or uses a configured IANA timezone.
+ * Generates a human-readable context string for system prompt injection.
+ */
+// ─── Implementation ─────────────────────────────────────────────────
+export class TimezoneManager {
+    tz;
+    constructor(config = {}) {
+        if (config.timezone) {
+            this.tz = config.timezone;
+        }
+        else if (config.autoDetect !== false) {
+            this.tz = Intl.DateTimeFormat().resolvedOptions().timeZone;
+        }
+        else {
+            this.tz = 'UTC';
+        }
+    }
+    /** Get current timezone. */
+    getTimezone() {
+        return this.tz;
+    }
+    /** Get current time formatted for the agent. */
+    getCurrentTime() {
+        return this.format(new Date());
+    }
+    /** Format a date in the user's timezone. */
+    format(date, fmt) {
+        if (fmt === 'iso') {
+            return date.toLocaleString('sv-SE', { timeZone: this.tz }).replace(' ', 'T');
+        }
+        if (fmt === 'time') {
+            return date.toLocaleTimeString('en-US', {
+                timeZone: this.tz,
+                hour: '2-digit',
+                minute: '2-digit',
+                hour12: true,
+            });
+        }
+        if (fmt === 'date') {
+            return date.toLocaleDateString('en-US', {
+                timeZone: this.tz,
+                weekday: 'long',
+                year: 'numeric',
+                month: 'long',
+                day: 'numeric',
+            });
+        }
+        // Default: full human-readable format
+        return date.toLocaleString('en-US', {
+            timeZone: this.tz,
+            weekday: 'long',
+            year: 'numeric',
+            month: 'long',
+            day: 'numeric',
+            hour: 'numeric',
+            minute: '2-digit',
+            hour12: true,
+        });
+    }
+    /**
+     * Get timezone context string for system prompt injection.
+     * Returns: "Current date/time: Saturday, March 7th, 2026 — 2:09 PM (Asia/Riyadh)"
+     */
+    getContextString() {
+        const formatted = this.format(new Date());
+        return `Current date/time: ${formatted} (${this.tz})`;
+    }
+}
+//# sourceMappingURL=timezone.js.map

package/dist/core/timezone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timezone.js","sourceRoot":"","sources":["../../src/core/timezone.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,uEAAuE;AAEvE,MAAM,OAAO,eAAe;IAClB,EAAE,CAAS;IAEnB,YAAY,SAAkC,EAAE;QAC9C,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC;QAC5B,CAAC;aAAM,IAAI,MAAM,CAAC,UAAU,KAAK,KAAK,EAAE,CAAC;YACvC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC,eAAe,EAAE,CAAC,QAAQ,CAAC;QAC7D,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC;QAClB,CAAC;IACH,CAAC;IAED,4BAA4B;IAC5B,WAAW;QACT,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IAED,gDAAgD;IAChD,cAAc;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,4CAA4C;IAC5C,MAAM,CAAC,IAAU,EAAE,GAAY;QAC7B,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAC/E,CAAC;QAED,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE;gBACtC,QAAQ,EAAE,IAAI,CAAC,EAAE;gBACjB,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,IAAI;aACb,CAAC,CAAC;QACL,CAAC;QAED,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE;gBACtC,QAAQ,EAAE,IAAI,CAAC,EAAE;gBACjB,OAAO,EAAE,MAAM;gBACf,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,MAAM;gBACb,GAAG,EAAE,SAAS;aACf,CAAC,CAAC;QACL,CAAC;QAED,sCAAsC;QACtC,OAAO,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;YAClC,QAAQ,EAAE,IAAI,CAAC,EAAE;YACjB,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,MAAM;YACb,GAAG,EAAE,SAAS;YACd,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,IAAI;SACb,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,gBAAgB;QACd,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAC1C,OAAO,sBAAsB,SAAS,KAAK,IAAI,CAAC,EAAE,GAAG,CAAC;IACxD,CAAC;CACF"}

package/dist/core/tool-loop-detector.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Tool loop detector — detect when agent is stuck calling the same tool repeatedly.
+ *
+ * Monitors tool call patterns within a session turn. If the same tool is called
+ * with similar arguments more than N times, it breaks the loop by injecting
+ * a warning into the context.
+ */
+export interface LoopDetectorConfig {
+    /** Enable loop detection (default: true) */
+    enabled: boolean;
+    /** Max identical tool calls before breaking (default: 3) */
+    maxRepetitions: number;
+    /** Max similar tool calls (same tool, different args) before warning (default: 5) */
+    maxSimilarCalls: number;
+    /** Window of recent tool calls to consider (default: 10) */
+    windowSize: number;
+}
+export declare class ToolLoopDetector {
+    private config;
+    private history;
+    constructor(config?: Partial<LoopDetectorConfig>);
+    /**
+     * Record a tool call and check for loops.
+     * Returns a warning message if a loop is detected, null otherwise.
+     */
+    recordAndCheck(sessionId: string, toolName: string, args: Record<string, unknown>): string | null;
+    /** Clear history for a session (on new turn). */
+    clearSession(sessionId: string): void;
+    /** Clear all history. */
+    clear(): void;
+    /** Get loop stats for a session. */
+    stats(sessionId: string): {
+        totalCalls: number;
+        uniqueTools: number;
+        repetitions: Map<string, number>;
+    };
+    private hashArgs;
+    private checkIdenticalLoop;
+    private checkSimilarLoop;
+}
+//# sourceMappingURL=tool-loop-detector.d.ts.map

package/dist/core/tool-loop-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-loop-detector.d.ts","sourceRoot":"","sources":["../../src/core/tool-loop-detector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,4DAA4D;IAC5D,cAAc,EAAE,MAAM,CAAC;IACvB,qFAAqF;IACrF,eAAe,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;CACpB;AAeD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,OAAO,CAA4C;gBAE/C,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC;IAIhD;;;OAGG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI;IA+BjG,iDAAiD;IACjD,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIrC,yBAAyB;IACzB,KAAK,IAAI,IAAI;IAIb,oCAAoC;IACpC,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE;IAavG,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,kBAAkB;IAK1B,OAAO,CAAC,gBAAgB;CAIzB"}

package/dist/core/tool-loop-detector.js

@@ -0,0 +1,83 @@
+/**
+ * Tool loop detector — detect when agent is stuck calling the same tool repeatedly.
+ *
+ * Monitors tool call patterns within a session turn. If the same tool is called
+ * with similar arguments more than N times, it breaks the loop by injecting
+ * a warning into the context.
+ */
+import { createHash } from 'node:crypto';
+const DEFAULT_CONFIG = {
+    enabled: true,
+    maxRepetitions: 3,
+    maxSimilarCalls: 5,
+    windowSize: 10,
+};
+export class ToolLoopDetector {
+    config;
+    history = new Map();
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Record a tool call and check for loops.
+     * Returns a warning message if a loop is detected, null otherwise.
+     */
+    recordAndCheck(sessionId, toolName, args) {
+        if (!this.config.enabled)
+            return null;
+        const records = this.history.get(sessionId) ?? [];
+        const argsHash = this.hashArgs(args);
+        // Add new record
+        records.push({ toolName, argsHash, timestamp: Date.now() });
+        // Trim to window size
+        if (records.length > this.config.windowSize) {
+            records.splice(0, records.length - this.config.windowSize);
+        }
+        this.history.set(sessionId, records);
+        // Check for identical loop (same tool + same args)
+        if (this.checkIdenticalLoop(records, toolName, argsHash)) {
+            const count = records.filter((r) => r.toolName === toolName && r.argsHash === argsHash).length;
+            return `⚠️ Tool loop detected: you've called \`${toolName}\` ${count} times with identical arguments. This suggests you're stuck. Try a different approach or ask the user for help.`;
+        }
+        // Check for similar loop (same tool, different args)
+        if (this.checkSimilarLoop(records, toolName)) {
+            const count = records.filter((r) => r.toolName === toolName).length;
+            return `⚠️ Tool loop detected: you've called \`${toolName}\` ${count} times in the recent window. Consider whether you're making progress or if you should try a different approach.`;
+        }
+        return null;
+    }
+    /** Clear history for a session (on new turn). */
+    clearSession(sessionId) {
+        this.history.delete(sessionId);
+    }
+    /** Clear all history. */
+    clear() {
+        this.history.clear();
+    }
+    /** Get loop stats for a session. */
+    stats(sessionId) {
+        const records = this.history.get(sessionId) ?? [];
+        const repetitions = new Map();
+        for (const r of records) {
+            repetitions.set(r.toolName, (repetitions.get(r.toolName) ?? 0) + 1);
+        }
+        return {
+            totalCalls: records.length,
+            uniqueTools: repetitions.size,
+            repetitions,
+        };
+    }
+    hashArgs(args) {
+        const sorted = JSON.stringify(args, Object.keys(args).sort());
+        return createHash('sha256').update(sorted).digest('hex').slice(0, 16);
+    }
+    checkIdenticalLoop(records, toolName, argsHash) {
+        const count = records.filter((r) => r.toolName === toolName && r.argsHash === argsHash).length;
+        return count >= this.config.maxRepetitions;
+    }
+    checkSimilarLoop(records, toolName) {
+        const count = records.filter((r) => r.toolName === toolName).length;
+        return count >= this.config.maxSimilarCalls;
+    }
+}
+//# sourceMappingURL=tool-loop-detector.js.map

package/dist/core/tool-loop-detector.js.map

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

package/dist/core/tool-validator.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Tool Argument Validator — validates tool arguments before execution.
+ *
+ * Checks:
+ * - File paths: block path traversal (../ outside workspace)
+ * - Shell commands: warn on dangerous patterns
+ * - URLs: block private/internal IPs
+ * - Regex: timeout protection for ReDoS
+ */
+export type ValidationLevel = 'strict' | 'warn' | 'off';
+export interface ToolValidatorConfig {
+    /** Validation level: 'strict' blocks, 'warn' logs + allows, 'off' disables. */
+    level: ValidationLevel;
+}
+export interface ValidationResult {
+    /** Whether the tool call is allowed. */
+    allowed: boolean;
+    /** Validation warnings (even if allowed). */
+    warnings: string[];
+    /** Reason for blocking (if allowed=false). */
+    blockReason?: string;
+}
+export declare class ToolValidator {
+    private config;
+    private workspaceRoot;
+    constructor(config: ToolValidatorConfig, workspaceRoot: string);
+    /**
+     * Validate a file path argument.
+     */
+    validatePath(path: string, workDir: string, allowWrite: boolean): ValidationResult;
+    /**
+     * Validate a shell command argument.
+     */
+    validateCommand(command: string): ValidationResult;
+    /**
+     * Validate a URL argument (block private/internal IPs).
+     */
+    validateUrl(urlStr: string): ValidationResult;
+    /**
+     * Validate a regex pattern for ReDoS potential.
+     */
+    validateRegex(pattern: string, timeoutMs?: number): ValidationResult;
+}
+//# sourceMappingURL=tool-validator.d.ts.map

package/dist/core/tool-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-validator.d.ts","sourceRoot":"","sources":["../../src/core/tool-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;AAExD,MAAM,WAAW,mBAAmB;IAClC,+EAA+E;IAC/E,KAAK,EAAE,eAAe,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAsCD,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,aAAa,CAAS;gBAElB,MAAM,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM;IAK9D;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,gBAAgB;IAqClF;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB;IAoBlD;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB;IA8C7C;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,gBAAgB;CA0BlE"}

package/dist/core/tool-validator.js

@@ -0,0 +1,175 @@
+/**
+ * Tool Argument Validator — validates tool arguments before execution.
+ *
+ * Checks:
+ * - File paths: block path traversal (../ outside workspace)
+ * - Shell commands: warn on dangerous patterns
+ * - URLs: block private/internal IPs
+ * - Regex: timeout protection for ReDoS
+ */
+import { resolve, relative, isAbsolute } from 'node:path';
+// ─── Dangerous command patterns ─────────────────────────────────────
+const DANGEROUS_COMMANDS = [
+    { pattern: /rm\s+(-[a-zA-Z]*f[a-zA-Z]*\s+)?\/(?!tmp)/i, description: 'Destructive rm on root paths' },
+    { pattern: /rm\s+-[a-zA-Z]*r[a-zA-Z]*f[a-zA-Z]*\s+\//i, description: 'Recursive forced delete on root' },
+    { pattern: /mkfs\./i, description: 'Filesystem format command' },
+    { pattern: /dd\s+.*of=\/dev\//i, description: 'Direct disk write' },
+    { pattern: /chmod\s+777\s/i, description: 'Overly permissive chmod' },
+    { pattern: /curl\s+[^|]*\|\s*(sh|bash|zsh)/i, description: 'Pipe remote script to shell' },
+    { pattern: /wget\s+[^|]*\|\s*(sh|bash|zsh)/i, description: 'Pipe remote download to shell' },
+    { pattern: />\s*\/etc\//i, description: 'Writing to /etc/' },
+    { pattern: />\s*\/proc\//i, description: 'Writing to /proc/' },
+    { pattern: /:\(\)\s*\{\s*:\|:&\s*\}\s*;/i, description: 'Fork bomb' },
+    { pattern: /shutdown|reboot|poweroff|init\s+[06]/i, description: 'System shutdown/reboot' },
+    { pattern: /iptables\s+-F/i, description: 'Flushing firewall rules' },
+];
+// ─── Private IP patterns ────────────────────────────────────────────
+const PRIVATE_IP_PATTERNS = [
+    /^127\.\d+\.\d+\.\d+/,
+    /^10\.\d+\.\d+\.\d+/,
+    /^172\.(1[6-9]|2\d|3[01])\.\d+\.\d+/,
+    /^192\.168\.\d+\.\d+/,
+    /^169\.254\.\d+\.\d+/,
+    /^0\.0\.0\.0/,
+    /^::1$/,
+    /^fc00:/i,
+    /^fd[0-9a-f]{2}:/i,
+    /^fe80:/i,
+];
+const PRIVATE_HOSTNAMES = ['localhost', 'host.docker.internal', '*.local', 'metadata.google.internal'];
+// ─── Validator ──────────────────────────────────────────────────────
+export class ToolValidator {
+    config;
+    workspaceRoot;
+    constructor(config, workspaceRoot) {
+        this.config = config;
+        this.workspaceRoot = workspaceRoot;
+    }
+    /**
+     * Validate a file path argument.
+     */
+    validatePath(path, workDir, allowWrite) {
+        if (this.config.level === 'off') {
+            return { allowed: true, warnings: [] };
+        }
+        const warnings = [];
+        const fullPath = isAbsolute(path) ? path : resolve(workDir, path);
+        const rel = relative(this.workspaceRoot, fullPath);
+        // Check for path traversal outside workspace
+        if (rel.startsWith('..') || isAbsolute(rel)) {
+            if (allowWrite) {
+                const msg = `Path traversal outside workspace: ${path} resolves to ${fullPath}`;
+                if (this.config.level === 'strict') {
+                    return { allowed: false, warnings: [], blockReason: msg };
+                }
+                warnings.push(msg);
+            }
+        }
+        // Block writing to sensitive system paths
+        if (allowWrite) {
+            const sensitiveRoots = ['/etc', '/usr', '/bin', '/sbin', '/boot', '/proc', '/sys', '/dev'];
+            for (const root of sensitiveRoots) {
+                if (fullPath.startsWith(root + '/') || fullPath === root) {
+                    const msg = `Writing to system path: ${fullPath}`;
+                    if (this.config.level === 'strict') {
+                        return { allowed: false, warnings: [], blockReason: msg };
+                    }
+                    warnings.push(msg);
+                }
+            }
+        }
+        return { allowed: true, warnings };
+    }
+    /**
+     * Validate a shell command argument.
+     */
+    validateCommand(command) {
+        if (this.config.level === 'off') {
+            return { allowed: true, warnings: [] };
+        }
+        const warnings = [];
+        for (const { pattern, description } of DANGEROUS_COMMANDS) {
+            if (pattern.test(command)) {
+                const msg = `Dangerous command pattern: ${description}`;
+                if (this.config.level === 'strict') {
+                    return { allowed: false, warnings: [], blockReason: msg };
+                }
+                warnings.push(msg);
+            }
+        }
+        return { allowed: true, warnings };
+    }
+    /**
+     * Validate a URL argument (block private/internal IPs).
+     */
+    validateUrl(urlStr) {
+        if (this.config.level === 'off') {
+            return { allowed: true, warnings: [] };
+        }
+        try {
+            const url = new URL(urlStr);
+            const hostname = url.hostname;
+            // Check private IPs
+            for (const pattern of PRIVATE_IP_PATTERNS) {
+                if (pattern.test(hostname)) {
+                    const msg = `URL points to private/internal IP: ${hostname}`;
+                    if (this.config.level === 'strict') {
+                        return { allowed: false, warnings: [], blockReason: msg };
+                    }
+                    return { allowed: true, warnings: [msg] };
+                }
+            }
+            // Check private hostnames
+            for (const pattern of PRIVATE_HOSTNAMES) {
+                if (pattern.startsWith('*')) {
+                    const suffix = pattern.slice(1);
+                    if (hostname.endsWith(suffix)) {
+                        const msg = `URL points to internal hostname: ${hostname}`;
+                        if (this.config.level === 'strict') {
+                            return { allowed: false, warnings: [], blockReason: msg };
+                        }
+                        return { allowed: true, warnings: [msg] };
+                    }
+                }
+                else if (hostname === pattern) {
+                    const msg = `URL points to internal hostname: ${hostname}`;
+                    if (this.config.level === 'strict') {
+                        return { allowed: false, warnings: [], blockReason: msg };
+                    }
+                    return { allowed: true, warnings: [msg] };
+                }
+            }
+        }
+        catch {
+            // Invalid URL — let the tool handle it
+        }
+        return { allowed: true, warnings: [] };
+    }
+    /**
+     * Validate a regex pattern for ReDoS potential.
+     */
+    validateRegex(pattern, timeoutMs = 100) {
+        if (this.config.level === 'off') {
+            return { allowed: true, warnings: [] };
+        }
+        // Heuristic: check for known ReDoS patterns
+        const redosPatterns = [
+            /\(.*\+\)\+/, // (a+)+
+            /\(.*\*\)\*/, // (a*)*
+            /\(.*\+\)\*/, // (a+)*
+            /\(.*\*\)\+/, // (a*)+
+            /\(.*\{\d+,\}\)\+/, // (a{2,})+
+        ];
+        for (const redos of redosPatterns) {
+            if (redos.test(pattern)) {
+                const msg = `Potential ReDoS pattern detected: ${pattern.slice(0, 50)}`;
+                if (this.config.level === 'strict') {
+                    return { allowed: false, warnings: [], blockReason: msg };
+                }
+                return { allowed: true, warnings: [msg] };
+            }
+        }
+        return { allowed: true, warnings: [] };
+    }
+}
+//# sourceMappingURL=tool-validator.js.map

package/dist/core/tool-validator.js.map

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

package/dist/core/typing.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Typing indicator manager — show "typing..." while agent is processing.
+ *
+ * Sends platform-specific typing indicators at regular intervals
+ * while the agent is thinking or executing tools.
+ */
+import type { Channel } from '../channels/channel.js';
+export interface TypingConfig {
+    /** Enable typing indicators (default: true) */
+    enabled: boolean;
+    /** Interval to re-send typing indicator in ms (default: 5000) */
+    intervalMs: number;
+}
+export declare class TypingManager {
+    private intervals;
+    private config;
+    constructor(config?: Partial<TypingConfig>);
+    /** Start showing typing indicator for a chat. */
+    start(channel: Channel, chatId: string): void;
+    /** Stop showing typing indicator for a chat. */
+    stop(chatId: string): void;
+    /** Stop all typing indicators. */
+    stopAll(): void;
+}
+//# sourceMappingURL=typing.d.ts.map

package/dist/core/typing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typing.d.ts","sourceRoot":"","sources":["../../src/core/typing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;CACpB;AAOD,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAA0D;IAC3E,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;IAI1C,iDAAiD;IACjD,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAkB7C,gDAAgD;IAChD,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ1B,kCAAkC;IAClC,OAAO,IAAI,IAAI;CAKhB"}