@project-ava-supernova/core 0.2.71

package/dist/tools/http-request.js

@@ -0,0 +1,329 @@
+import { request as httpsRequest } from 'node:https';
+import { request as httpRequest } from 'node:http';
+const DEFAULT_TIMEOUT = 15_000;
+const MAX_TIMEOUT = 60_000;
+const MAX_BODY_LENGTH = 30_000;
+const MAX_REDIRECTS = 5;
+const ALLOWED_METHODS = new Set(['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS']);
+/** Block requests to private/internal IP ranges (SSRF protection). */
+function isPrivateHost(hostname) {
+    // Block obvious private hostnames
+    if (hostname === 'localhost' || hostname === '[::1]')
+        return true;
+    // IPv4 private ranges
+    const parts = hostname.split('.').map(Number);
+    if (parts.length === 4 && parts.every(n => !isNaN(n))) {
+        if (parts[0] === 127)
+            return true; // 127.0.0.0/8 loopback
+        if (parts[0] === 10)
+            return true; // 10.0.0.0/8 private
+        if (parts[0] === 172 && parts[1] >= 16 && parts[1] <= 31)
+            return true; // 172.16.0.0/12 private
+        if (parts[0] === 192 && parts[1] === 168)
+            return true; // 192.168.0.0/16 private
+        if (parts[0] === 169 && parts[1] === 254)
+            return true; // 169.254.0.0/16 link-local / cloud metadata
+        if (parts[0] === 0)
+            return true; // 0.0.0.0/8
+    }
+    return false;
+}
+/** Headers worth showing in the response summary. */
+const INTERESTING_HEADERS = new Set([
+    'content-type', 'content-length', 'location', 'set-cookie',
+    'x-request-id', 'x-ratelimit-remaining', 'retry-after',
+    'cache-control', 'etag', 'last-modified',
+]);
+function doRequest(opts) {
+    return new Promise((resolve, reject) => {
+        const parsed = new URL(opts.url);
+        const isHttps = parsed.protocol === 'https:';
+        const reqFn = isHttps ? httpsRequest : httpRequest;
+        const reqHeaders = {
+            'User-Agent': 'Ava-Supernova/1.0',
+            ...(opts.headers ?? {}),
+        };
+        if (opts.body && !reqHeaders['Content-Type'] && !reqHeaders['content-type']) {
+            reqHeaders['Content-Type'] = 'application/json';
+        }
+        const req = reqFn(opts.url, {
+            method: opts.method,
+            headers: reqHeaders,
+            timeout: opts.timeout ?? DEFAULT_TIMEOUT,
+        }, (res) => {
+            // Handle redirects
+            const isRedirect = res.statusCode && res.statusCode >= 300 && res.statusCode < 400 && res.headers.location;
+            if (isRedirect) {
+                const redirectCount = opts.redirectCount ?? 0;
+                if (redirectCount >= MAX_REDIRECTS) {
+                    resolve({
+                        status: res.statusCode,
+                        statusText: `Too many redirects (${MAX_REDIRECTS})`,
+                        headers: {},
+                        allHeaders: {},
+                        body: `Redirect limit exceeded. Last location: ${res.headers.location}`,
+                    });
+                    return;
+                }
+                // Resolve relative redirects
+                const redirectUrl = new URL(res.headers.location, opts.url).href;
+                doRequest({ ...opts, url: redirectUrl, redirectCount: redirectCount + 1 })
+                    .then(resolve)
+                    .catch(reject);
+                return;
+            }
+            const chunks = [];
+            res.on('data', (chunk) => chunks.push(chunk));
+            res.on('end', () => {
+                const rawHeaders = res.headers;
+                const filteredHeaders = {};
+                const allHeaders = {};
+                for (const [key, value] of Object.entries(rawHeaders)) {
+                    if (value) {
+                        const strValue = Array.isArray(value) ? value.join(', ') : value;
+                        allHeaders[key] = strValue;
+                        if (INTERESTING_HEADERS.has(key.toLowerCase())) {
+                            filteredHeaders[key] = strValue;
+                        }
+                    }
+                }
+                let body = Buffer.concat(chunks).toString('utf-8');
+                if (body.length > MAX_BODY_LENGTH) {
+                    body = body.slice(0, MAX_BODY_LENGTH) + '\n... (body truncated)';
+                }
+                resolve({
+                    status: res.statusCode ?? 0,
+                    statusText: res.statusMessage ?? '',
+                    headers: filteredHeaders,
+                    allHeaders,
+                    body,
+                });
+            });
+            res.on('error', reject);
+        });
+        req.on('error', reject);
+        req.on('timeout', () => {
+            req.destroy();
+            reject(new Error('Request timed out'));
+        });
+        if (opts.body) {
+            req.write(opts.body);
+        }
+        req.end();
+    });
+}
+export class HttpRequestTool {
+    name = 'http_request';
+    description = 'Make HTTP requests to test APIs or fetch data';
+    riskLevel = 'dangerous';
+    outputTrust = 'untrusted';
+    requiresConfirmation = true;
+    schema = {
+        name: 'http_request',
+        description: 'Make an HTTP request. Supports GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS. ' +
+            'Use to test API endpoints, check URLs, or fetch data. ' +
+            'Supports auth shortcuts, response assertions, JSON path extraction, and timing. ' +
+            'Returns status code, relevant headers, and response body (truncated at 30KB). ' +
+            'Follows redirects automatically (up to 5).',
+        parameters: {
+            type: 'object',
+            properties: {
+                url: {
+                    type: 'string',
+                    description: 'The URL to request (must be http:// or https://)',
+                },
+                method: {
+                    type: 'string',
+                    description: 'HTTP method. Default: GET',
+                    enum: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS'],
+                },
+                headers: {
+                    type: 'object',
+                    description: 'Custom request headers (optional)',
+                },
+                body: {
+                    type: 'string',
+                    description: 'Request body for POST/PUT/PATCH (optional). Defaults to JSON content type.',
+                },
+                auth: {
+                    type: 'object',
+                    description: 'Authentication shortcut. Sets Authorization header automatically.',
+                    properties: {
+                        type: { type: 'string', enum: ['bearer', 'basic'], description: 'Auth type' },
+                        token: { type: 'string', description: 'Bearer token (for type: bearer)' },
+                        username: { type: 'string', description: 'Username (for type: basic)' },
+                        password: { type: 'string', description: 'Password (for type: basic)' },
+                    },
+                },
+                timeout_ms: {
+                    type: 'number',
+                    description: 'Request timeout in milliseconds. Default: 15000. Max: 60000.',
+                },
+                assert_status: {
+                    type: 'number',
+                    description: 'Expected HTTP status code. Tool returns failure if status does not match.',
+                },
+                assert_body_contains: {
+                    type: 'string',
+                    description: 'String that must appear in response body. Tool returns failure if not found.',
+                },
+                extract_json_path: {
+                    type: 'string',
+                    description: 'Dot-notation path to extract from JSON response (e.g. "data.users[0].name").',
+                },
+                verbose: {
+                    type: 'boolean',
+                    description: 'Show full request/response headers and timing. Default: false.',
+                },
+            },
+            required: ['url'],
+        },
+    };
+    async execute(args, _context) {
+        const url = args.url;
+        const method = (args.method ?? 'GET').toUpperCase();
+        const headers = { ...args.headers };
+        const body = args.body;
+        const auth = args.auth;
+        const timeoutMs = Math.min(Math.max(args.timeout_ms || DEFAULT_TIMEOUT, 1000), MAX_TIMEOUT);
+        const assertStatus = args.assert_status;
+        const assertBodyContains = args.assert_body_contains;
+        const extractJsonPath = args.extract_json_path;
+        const verbose = args.verbose ?? false;
+        if (!url) {
+            return { success: false, output: 'URL is required.' };
+        }
+        // Validate URL protocol and block private/internal hosts (SSRF protection)
+        try {
+            const parsed = new URL(url);
+            if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+                return { success: false, output: `Unsupported protocol: ${parsed.protocol}. Only http:// and https:// are allowed.` };
+            }
+            if (isPrivateHost(parsed.hostname)) {
+                return { success: false, output: `Blocked: requests to private/internal addresses are not allowed (${parsed.hostname}).` };
+            }
+        }
+        catch {
+            return { success: false, output: `Invalid URL: ${url}` };
+        }
+        if (!ALLOWED_METHODS.has(method)) {
+            return { success: false, output: `Unsupported method: ${method}. Use one of: ${[...ALLOWED_METHODS].join(', ')}` };
+        }
+        // Apply auth shortcut
+        if (auth?.type === 'bearer' && auth.token) {
+            headers['Authorization'] = `Bearer ${auth.token}`;
+        }
+        else if (auth?.type === 'basic' && auth.username) {
+            const encoded = Buffer.from(`${auth.username}:${auth.password ?? ''}`).toString('base64');
+            headers['Authorization'] = `Basic ${encoded}`;
+        }
+        try {
+            const startTime = Date.now();
+            const result = await doRequest({ url, method, headers, body, timeout: timeoutMs });
+            const elapsed = Date.now() - startTime;
+            const lines = [];
+            const assertions = [];
+            // Verbose: show request info
+            if (verbose) {
+                lines.push(`> ${method} ${url}`);
+                for (const [key, value] of Object.entries(headers)) {
+                    lines.push(`> ${key}: ${value}`);
+                }
+                lines.push('');
+            }
+            lines.push(`HTTP ${result.status} ${result.statusText}`);
+            // Headers (verbose = all, normal = interesting only)
+            const showHeaders = verbose ? result.allHeaders : result.headers;
+            const headerEntries = Object.entries(showHeaders);
+            if (headerEntries.length > 0) {
+                lines.push('');
+                for (const [key, value] of headerEntries) {
+                    lines.push(`${key}: ${value}`);
+                }
+            }
+            // JSON path extraction
+            let extracted;
+            if (extractJsonPath && result.body) {
+                try {
+                    const json = JSON.parse(result.body);
+                    extracted = resolveJsonPath(json, extractJsonPath);
+                    if (extracted !== undefined) {
+                        lines.push('');
+                        lines.push(`[extracted ${extractJsonPath}]: ${typeof extracted === 'object' ? JSON.stringify(extracted, null, 2) : String(extracted)}`);
+                    }
+                    else {
+                        lines.push('');
+                        lines.push(`[extracted ${extractJsonPath}]: (not found)`);
+                    }
+                }
+                catch {
+                    lines.push('');
+                    lines.push(`[extract_json_path]: Response is not valid JSON`);
+                }
+            }
+            // Body
+            if (result.body && method !== 'HEAD' && !extractJsonPath) {
+                lines.push('');
+                // Strip <script>/<style> blocks from HTML responses before they
+                // reach the model context. The trust-tag wrapper at the registry
+                // level tells the model "this is data" — but we still don't need
+                // to ship raw JS payloads embedded in fetched HTML to the model
+                // in the first place. Prose-only is what's useful for LLM-driven
+                // web fetches; the actual scripts add only attack surface.
+                const contentType = (result.headers['content-type'] || '').toLowerCase();
+                const looksLikeHtml = contentType.includes('html') || /<html[\s>]|<!doctype html/i.test(result.body.slice(0, 200));
+                const sanitised = looksLikeHtml
+                    ? result.body
+                        .replace(/<script\b[^>]*>[\s\S]*?<\/script>/gi, '')
+                        .replace(/<style\b[^>]*>[\s\S]*?<\/style>/gi, '')
+                    : result.body;
+                lines.push(sanitised);
+            }
+            // Timing
+            if (verbose) {
+                lines.push('');
+                lines.push(`Time: ${elapsed}ms`);
+            }
+            // Assertions
+            let isSuccess = result.status >= 200 && result.status < 400;
+            if (assertStatus !== undefined && result.status !== assertStatus) {
+                isSuccess = false;
+                assertions.push(`Status assertion failed: expected ${assertStatus}, got ${result.status}`);
+            }
+            if (assertBodyContains && !result.body.includes(assertBodyContains)) {
+                isSuccess = false;
+                assertions.push(`Body assertion failed: "${assertBodyContains}" not found in response`);
+            }
+            if (assertions.length > 0) {
+                lines.push('');
+                lines.push('ASSERTIONS FAILED:');
+                for (const a of assertions)
+                    lines.push(`  - ${a}`);
+            }
+            return {
+                success: isSuccess,
+                output: lines.join('\n'),
+                metadata: {
+                    status: result.status, method, url, elapsed_ms: elapsed,
+                    ...(extracted !== undefined ? { extracted } : {}),
+                },
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return { success: false, output: `HTTP request failed: ${message}` };
+        }
+    }
+}
+/** Resolve a dot-notation path like "data.users[0].name" against a JSON object. */
+function resolveJsonPath(obj, path) {
+    const parts = path.replace(/\[(\d+)\]/g, '.$1').split('.');
+    let current = obj;
+    for (const part of parts) {
+        if (current == null || typeof current !== 'object')
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+//# sourceMappingURL=http-request.js.map

package/dist/tools/http-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-request.js","sourceRoot":"","sources":["../../src/tools/http-request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AAInD,MAAM,eAAe,GAAG,MAAM,CAAC;AAC/B,MAAM,WAAW,GAAG,MAAM,CAAC;AAC3B,MAAM,eAAe,GAAG,MAAM,CAAC;AAC/B,MAAM,aAAa,GAAG,CAAC,CAAC;AAExB,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;AAE9F,sEAAsE;AACtE,SAAS,aAAa,CAAC,QAAgB;IACrC,kCAAkC;IAClC,IAAI,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IAElE,sBAAsB;IACtB,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC,CAAoC,uBAAuB;QAC7F,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE;YAAE,OAAO,IAAI,CAAC,CAAqC,qBAAqB;QAC3F,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;YAAE,OAAO,IAAI,CAAC,CAAC,wBAAwB;QAC/F,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC,CAAe,yBAAyB;QAC9F,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC,CAAe,6CAA6C;QAClH,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,CAAsC,YAAY;IACpF,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,qDAAqD;AACrD,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,cAAc,EAAE,gBAAgB,EAAE,UAAU,EAAE,YAAY;IAC1D,cAAc,EAAE,uBAAuB,EAAE,aAAa;IACtD,eAAe,EAAE,MAAM,EAAE,eAAe;CACzC,CAAC,CAAC;AAYH,SAAS,SAAS,CAAC,IAAoB;IACrC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC;QAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC;QAEnD,MAAM,UAAU,GAA2B;YACzC,YAAY,EAAE,mBAAmB;YACjC,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;SACxB,CAAC;QAEF,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YAC5E,UAAU,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;QAClD,CAAC;QAED,MAAM,GAAG,GAAG,KAAK,CACf,IAAI,CAAC,GAAG,EACR;YACE,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,UAAU;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,eAAe;SACzC,EACD,CAAC,GAAG,EAAE,EAAE;YACN,mBAAmB;YACnB,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,IAAI,GAAG,CAAC,UAAU,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC;YAC3G,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC;gBAC9C,IAAI,aAAa,IAAI,aAAa,EAAE,CAAC;oBACnC,OAAO,CAAC;wBACN,MAAM,EAAE,GAAG,CAAC,UAAW;wBACvB,UAAU,EAAE,uBAAuB,aAAa,GAAG;wBACnD,OAAO,EAAE,EAAE;wBACX,UAAU,EAAE,EAAE;wBACd,IAAI,EAAE,2CAA2C,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE;qBACxE,CAAC,CAAC;oBACH,OAAO;gBACT,CAAC;gBAED,6BAA6B;gBAC7B,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,QAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBAClE,SAAS,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,GAAG,CAAC,EAAE,CAAC;qBACvE,IAAI,CAAC,OAAO,CAAC;qBACb,KAAK,CAAC,MAAM,CAAC,CAAC;gBACjB,OAAO;YACT,CAAC;YAED,MAAM,MAAM,GAAa,EAAE,CAAC;YAC5B,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YACtD,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;gBACjB,MAAM,UAAU,GAAG,GAAG,CAAC,OAAwD,CAAC;gBAChF,MAAM,eAAe,GAA2B,EAAE,CAAC;gBACnD,MAAM,UAAU,GAA2B,EAAE,CAAC;gBAC9C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;oBACtD,IAAI,KAAK,EAAE,CAAC;wBACV,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;wBACjE,UAAU,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;wBAC3B,IAAI,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;4BAC/C,eAAe,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;wBAClC,CAAC;oBACH,CAAC;gBACH,CAAC;gBAED,IAAI,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBACnD,IAAI,IAAI,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC;oBAClC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,GAAG,wBAAwB,CAAC;gBACnE,CAAC;gBAED,OAAO,CAAC;oBACN,MAAM,EAAE,GAAG,CAAC,UAAU,IAAI,CAAC;oBAC3B,UAAU,EAAE,GAAG,CAAC,aAAa,IAAI,EAAE;oBACnC,OAAO,EAAE,eAAe;oBACxB,UAAU;oBACV,IAAI;iBACL,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YACH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1B,CAAC,CACF,CAAC;QAEF,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACxB,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;YACrB,GAAG,CAAC,OAAO,EAAE,CAAC;YACd,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QACD,GAAG,CAAC,GAAG,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,OAAO,eAAe;IACjB,IAAI,GAAG,cAAc,CAAC;IACtB,WAAW,GAAG,+CAA+C,CAAC;IAC9D,SAAS,GAAkB,WAAW,CAAC;IACvC,WAAW,GAAG,WAAoB,CAAC;IACnC,oBAAoB,GAAG,IAAI,CAAC;IAE5B,MAAM,GAAmB;QAChC,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,+EAA+E;YAC/E,wDAAwD;YACxD,kFAAkF;YAClF,gFAAgF;YAChF,4CAA4C;QAC9C,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,GAAG,EAAE;oBACH,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,kDAAkD;iBAChE;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2BAA2B;oBACxC,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC;iBACnE;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,mCAAmC;iBACjD;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4EAA4E;iBAC1F;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,mEAAmE;oBAChF,UAAU,EAAE;wBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,WAAW,EAAE,WAAW,EAAE;wBAC7E,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iCAAiC,EAAE;wBACzE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;wBACvE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;qBACxE;iBACF;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8DAA8D;iBAC5E;gBACD,aAAa,EAAE;oBACb,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2EAA2E;iBACzF;gBACD,oBAAoB,EAAE;oBACpB,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8EAA8E;iBAC5F;gBACD,iBAAiB,EAAE;oBACjB,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8EAA8E;iBAC5F;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,gEAAgE;iBAC9E;aACF;YACD,QAAQ,EAAE,CAAC,KAAK,CAAC;SAClB;KACF,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,IAA6B,EAAE,QAA8B;QACzE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAa,CAAC;QAC/B,MAAM,MAAM,GAAG,CAAE,IAAI,CAAC,MAAiB,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QAChE,MAAM,OAAO,GAAG,EAAE,GAAI,IAAI,CAAC,OAA8C,EAAE,CAAC;QAC5E,MAAM,IAAI,GAAG,IAAI,CAAC,IAA0B,CAAC;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,IAA2F,CAAC;QAC9G,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAE,IAAI,CAAC,UAAqB,IAAI,eAAe,EAAE,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC;QACxG,MAAM,YAAY,GAAG,IAAI,CAAC,aAAmC,CAAC;QAC9D,MAAM,kBAAkB,GAAG,IAAI,CAAC,oBAA0C,CAAC;QAC3E,MAAM,eAAe,GAAG,IAAI,CAAC,iBAAuC,CAAC;QACrE,MAAM,OAAO,GAAI,IAAI,CAAC,OAAmB,IAAI,KAAK,CAAC;QAEnD,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;QACxD,CAAC;QAED,2EAA2E;QAC3E,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAChE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,yBAAyB,MAAM,CAAC,QAAQ,0CAA0C,EAAE,CAAC;YACxH,CAAC;YACD,IAAI,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACnC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,oEAAoE,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;YAC7H,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,GAAG,EAAE,EAAE,CAAC;QAC3D,CAAC;QAED,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACjC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,uBAAuB,MAAM,iBAAiB,CAAC,GAAG,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACrH,CAAC;QAED,sBAAsB;QACtB,IAAI,IAAI,EAAE,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC1C,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC;QACpD,CAAC;aAAM,IAAI,IAAI,EAAE,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC1F,OAAO,CAAC,eAAe,CAAC,GAAG,SAAS,OAAO,EAAE,CAAC;QAChD,CAAC;QAED,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;YACnF,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAEvC,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,MAAM,UAAU,GAAa,EAAE,CAAC;YAEhC,6BAA6B;YAC7B,IAAI,OAAO,EAAE,CAAC;gBACZ,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC;gBACjC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;oBACnD,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC;gBACnC,CAAC;gBACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjB,CAAC;YAED,KAAK,CAAC,IAAI,CAAC,QAAQ,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;YAEzD,qDAAqD;YACrD,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;YACjE,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YAClD,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACf,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,aAAa,EAAE,CAAC;oBACzC,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC;gBACjC,CAAC;YACH,CAAC;YAED,uBAAuB;YACvB,IAAI,SAAkB,CAAC;YACvB,IAAI,eAAe,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;gBACnC,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;oBACrC,SAAS,GAAG,eAAe,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;oBACnD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;wBAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;wBACf,KAAK,CAAC,IAAI,CAAC,cAAc,eAAe,MAAM,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;oBAC1I,CAAC;yBAAM,CAAC;wBACN,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;wBACf,KAAK,CAAC,IAAI,CAAC,cAAc,eAAe,gBAAgB,CAAC,CAAC;oBAC5D,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBACf,KAAK,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;gBAChE,CAAC;YACH,CAAC;YAED,OAAO;YACP,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,KAAK,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;gBACzD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACf,gEAAgE;gBAChE,iEAAiE;gBACjE,iEAAiE;gBACjE,gEAAgE;gBAChE,iEAAiE;gBACjE,2DAA2D;gBAC3D,MAAM,WAAW,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;gBACzE,MAAM,aAAa,GAAG,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,4BAA4B,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBACnH,MAAM,SAAS,GAAG,aAAa;oBAC7B,CAAC,CAAC,MAAM,CAAC,IAAI;yBACR,OAAO,CAAC,qCAAqC,EAAE,EAAE,CAAC;yBAClD,OAAO,CAAC,mCAAmC,EAAE,EAAE,CAAC;oBACrD,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;gBAChB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACxB,CAAC;YAED,SAAS;YACT,IAAI,OAAO,EAAE,CAAC;gBACZ,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACf,KAAK,CAAC,IAAI,CAAC,SAAS,OAAO,IAAI,CAAC,CAAC;YACnC,CAAC;YAED,aAAa;YACb,IAAI,SAAS,GAAG,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC;YAC5D,IAAI,YAAY,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;gBACjE,SAAS,GAAG,KAAK,CAAC;gBAClB,UAAU,CAAC,IAAI,CAAC,qCAAqC,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YAC7F,CAAC;YACD,IAAI,kBAAkB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBACpE,SAAS,GAAG,KAAK,CAAC;gBAClB,UAAU,CAAC,IAAI,CAAC,2BAA2B,kBAAkB,yBAAyB,CAAC,CAAC;YAC1F,CAAC;YACD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACf,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;gBACjC,KAAK,MAAM,CAAC,IAAI,UAAU;oBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACrD,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,SAAS;gBAClB,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;gBACxB,QAAQ,EAAE;oBACR,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO;oBACvD,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAClD;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,wBAAwB,OAAO,EAAE,EAAE,CAAC;QACvE,CAAC;IACH,CAAC;CACF;AAED,mFAAmF;AACnF,SAAS,eAAe,CAAC,GAAY,EAAE,IAAY;IACjD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3D,IAAI,OAAO,GAAY,GAAG,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QACrE,OAAO,GAAI,OAAmC,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/tools/journal.d.ts

@@ -0,0 +1,17 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+export declare class JournalWriteTool implements Tool {
+    readonly name = "journal_write";
+    readonly description: string;
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+    private handleAdd;
+    private handleUpdate;
+    private handleDelete;
+    private handleRead;
+    private handleSearch;
+    private formatDay;
+}
+//# sourceMappingURL=journal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"journal.d.ts","sourceRoot":"","sources":["../../src/tools/journal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAM5D,qBAAa,gBAAiB,YAAW,IAAI;IAC3C,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,WAAW,SAGiG;IACrH,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAU;IAC3C,QAAQ,CAAC,oBAAoB,SAAS;IAEtC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAoC7B;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;YA6BlF,SAAS;YAkBT,YAAY;YAcZ,YAAY;YAQZ,UAAU;YAgBV,YAAY;IAiB1B,OAAO,CAAC,SAAS;CAWlB"}

package/dist/tools/journal.js

@@ -0,0 +1,159 @@
+import { DEFAULT_AVA_KIND, DEFAULT_USER_KIND } from '../journal/types.js';
+import { todayLocal } from '../core/dates.js';
+export class JournalWriteTool {
+    name = 'journal_write';
+    description = 'Write and read the local journal — a stream of typed entries (personal, feeling, idea, business, observation, or a custom kind). ' +
+        "You and the user share it: log your own observations as you work, or help the user capture a reflection. " +
+        'Different from memory (persistent facts) and task_manage (action items). Fully local — never leaves the machine.';
+    riskLevel = 'safe';
+    requiresConfirmation = false;
+    schema = {
+        name: 'journal_write',
+        description: 'Local journal of typed entries. Many entries per day, each with a kind. ' +
+            'Use add_entry to log a new entry — set author to "ava" for your own observations (kind defaults to "observation") ' +
+            'or "user" to capture the user\'s reflection (kind "personal"/"feeling" carry a 1-5 mood). ' +
+            'Use update_entry / delete_entry by id, read to review a day or range, and search (with optional kind/author filters) to find topics.',
+        parameters: {
+            type: 'object',
+            properties: {
+                action: {
+                    type: 'string',
+                    enum: ['add_entry', 'update_entry', 'delete_entry', 'read', 'search'],
+                    description: 'The action to perform',
+                },
+                author: {
+                    type: 'string',
+                    enum: ['ava', 'user'],
+                    description: 'Who the entry is for (add_entry). Defaults to "ava".',
+                },
+                kind: {
+                    type: 'string',
+                    description: 'Entry kind id: personal, feeling, idea, business, observation, or a custom kind. Optional.',
+                },
+                title: { type: 'string', description: 'Optional short heading for the entry.' },
+                content: { type: 'string', description: 'Entry content in markdown (required for add_entry).' },
+                id: { type: 'string', description: 'Entry id (required for update_entry, delete_entry).' },
+                date: { type: 'string', description: 'Date in YYYY-MM-DD format (defaults to today).' },
+                mood: { type: 'number', description: 'Mood 1-5 for reflective kinds (1=low, 5=great). Optional.' },
+                tags: { type: 'array', items: { type: 'string' }, description: 'Tags for the entry (optional).' },
+                from: { type: 'string', description: 'Start date for range read / search filter (YYYY-MM-DD).' },
+                to: { type: 'string', description: 'End date for range read / search filter (YYYY-MM-DD).' },
+                query: { type: 'string', description: 'Search query for the search action.' },
+            },
+            required: ['action'],
+        },
+    };
+    async execute(args, context) {
+        const jm = context.sharedState?.journalManager;
+        if (!jm)
+            return { success: false, output: 'Journal system not available.' };
+        const action = args.action;
+        // The user's day, not UTC's — an entry written at 23:00 in New York
+        // was filing under tomorrow, and one at 00:30 in British Summer Time
+        // under yesterday.
+        const today = todayLocal();
+        const date = args.date || today;
+        switch (action) {
+            case 'add_entry':
+            case 'write_user': // legacy alias
+            case 'write_ava': // legacy alias
+                return this.handleAdd(jm, date, args, action);
+            case 'update_entry':
+                return this.handleUpdate(jm, date, args);
+            case 'delete_entry':
+                return this.handleDelete(jm, date, args);
+            case 'read':
+                return this.handleRead(jm, date, args);
+            case 'search':
+                return this.handleSearch(jm, args);
+            default:
+                return { success: false, output: `Unknown action: ${action}` };
+        }
+    }
+    async handleAdd(jm, date, args, action) {
+        const content = args.content;
+        if (!content)
+            return { success: false, output: 'Missing required field: content' };
+        const author = args.author || (action === 'write_user' ? 'user' : 'ava');
+        const kind = args.kind || (author === 'user' ? DEFAULT_USER_KIND : DEFAULT_AVA_KIND);
+        const mood = args.mood;
+        const tags = args.tags;
+        const title = args.title;
+        const { id } = await jm.addEntry(date, { author, kind, content, title, mood, tags });
+        const parts = [`${author === 'user' ? 'User' : 'Ava'} entry added for ${date} (${kind}, id ${id})`];
+        if (mood)
+            parts.push(`mood ${mood}/5`);
+        if (tags?.length)
+            parts.push(`[${tags.join(', ')}]`);
+        return { success: true, output: parts.join(' ') };
+    }
+    async handleUpdate(jm, date, args) {
+        const id = args.id;
+        if (!id)
+            return { success: false, output: 'Missing required field: id' };
+        const day = await jm.updateEntry(date, id, {
+            kind: args.kind,
+            title: args.title,
+            content: args.content,
+            mood: args.mood,
+            tags: args.tags,
+        });
+        if (!day)
+            return { success: false, output: `No entry ${id} on ${date}.` };
+        return { success: true, output: `Updated entry ${id} on ${date}.` };
+    }
+    async handleDelete(jm, date, args) {
+        const id = args.id;
+        if (!id)
+            return { success: false, output: 'Missing required field: id' };
+        const day = await jm.deleteEntry(date, id);
+        if (!day)
+            return { success: false, output: `No entry ${id} on ${date}.` };
+        return { success: true, output: `Deleted entry ${id} on ${date}.` };
+    }
+    async handleRead(jm, date, args) {
+        const from = args.from;
+        const to = args.to;
+        if (from && to) {
+            const days = await jm.getDaysInRange(from, to);
+            if (days.length === 0)
+                return { success: true, output: `No journal entries between ${from} and ${to}.` };
+            const output = days.map((d) => this.formatDay(d)).join('\n\n---\n\n');
+            return { success: true, output: `${days.length} day(s) with entries (${from} to ${to}):\n\n${output}` };
+        }
+        const day = await jm.getDay(date);
+        if (!day || day.entries.length === 0)
+            return { success: true, output: `No journal entries for ${date}.` };
+        return { success: true, output: this.formatDay(day) };
+    }
+    async handleSearch(jm, args) {
+        const query = args.query;
+        if (!query)
+            return { success: false, output: 'Missing required field: query' };
+        const filters = {
+            kind: args.kind,
+            author: args.author,
+            from: args.from,
+            to: args.to,
+        };
+        const hits = await jm.search(query, filters);
+        if (hits.length === 0)
+            return { success: true, output: `No journal entries matching "${query}".` };
+        const lines = hits.map((h) => `**${h.date}** [${h.author}/${h.kind}] (id ${h.entryId})${h.title ? ` — ${h.title}` : ''}\n  …${h.snippet}…`);
+        return { success: true, output: `Found ${hits.length} matching "${query}":\n\n${lines.join('\n\n')}` };
+    }
+    formatDay(day) {
+        const parts = [`## ${day.date}`];
+        for (const e of day.entries) {
+            const head = `**${e.author === 'user' ? 'You' : 'Ava'} · ${e.kind}**${e.mood ? ` · mood ${e.mood}/5` : ''} (id ${e.id})`;
+            parts.push(`\n${head}`);
+            if (e.title)
+                parts.push(`### ${e.title}`);
+            parts.push(e.content);
+            if (e.tags?.length)
+                parts.push(`Tags: ${e.tags.join(', ')}`);
+        }
+        return parts.join('\n');
+    }
+}
+//# sourceMappingURL=journal.js.map

package/dist/tools/journal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.js","sourceRoot":"","sources":["../../src/tools/journal.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,OAAO,gBAAgB;IAClB,IAAI,GAAG,eAAe,CAAC;IACvB,WAAW,GAClB,mIAAmI;QACnI,2GAA2G;QAC3G,kHAAkH,CAAC;IAC5G,SAAS,GAAkB,MAAM,CAAC;IAClC,oBAAoB,GAAG,KAAK,CAAC;IAE7B,MAAM,GAAmB;QAChC,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,0EAA0E;YAC1E,oHAAoH;YACpH,4FAA4F;YAC5F,sIAAsI;QACxI,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,CAAC;oBACrE,WAAW,EAAE,uBAAuB;iBACrC;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;oBACrB,WAAW,EAAE,sDAAsD;iBACpE;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4FAA4F;iBAC1G;gBACD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uCAAuC,EAAE;gBAC/E,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qDAAqD,EAAE;gBAC/F,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qDAAqD,EAAE;gBAC1F,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gDAAgD,EAAE;gBACvF,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2DAA2D,EAAE;gBAClG,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,gCAAgC,EAAE;gBACjG,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yDAAyD,EAAE;gBAChG,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uDAAuD,EAAE;gBAC5F,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qCAAqC,EAAE;aAC9E;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;KACF,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,IAA6B,EAAE,OAA6B;QACxE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,cAA4C,CAAC;QAC7E,IAAI,CAAC,EAAE;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,+BAA+B,EAAE,CAAC;QAE5E,MAAM,MAAM,GAAG,IAAI,CAAC,MAAgB,CAAC;QACrC,oEAAoE;QACpE,qEAAqE;QACrE,mBAAmB;QACnB,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAI,IAAI,CAAC,IAAe,IAAI,KAAK,CAAC;QAE5C,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,WAAW,CAAC;YACjB,KAAK,YAAY,CAAC,CAAC,eAAe;YAClC,KAAK,WAAW,EAAE,eAAe;gBAC/B,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YAChD,KAAK,cAAc;gBACjB,OAAO,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YAC3C,KAAK,cAAc;gBACjB,OAAO,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YAC3C,KAAK,MAAM;gBACT,OAAO,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YACzC,KAAK,QAAQ;gBACX,OAAO,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YACrC;gBACE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,mBAAmB,MAAM,EAAE,EAAE,CAAC;QACnE,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,SAAS,CAAC,EAAkB,EAAE,IAAY,EAAE,IAA6B,EAAE,MAAc;QACrG,MAAM,OAAO,GAAG,IAAI,CAAC,OAA6B,CAAC;QACnD,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,iCAAiC,EAAE,CAAC;QAEnF,MAAM,MAAM,GAAmB,IAAI,CAAC,MAAwB,IAAI,CAAC,MAAM,KAAK,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC3G,MAAM,IAAI,GAAI,IAAI,CAAC,IAAe,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;QACjG,MAAM,IAAI,GAAG,IAAI,CAAC,IAA+B,CAAC;QAClD,MAAM,IAAI,GAAG,IAAI,CAAC,IAA4B,CAAC;QAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,KAA2B,CAAC;QAE/C,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAErF,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,oBAAoB,IAAI,KAAK,IAAI,QAAQ,EAAE,GAAG,CAAC,CAAC;QACpG,IAAI,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC;QACvC,IAAI,IAAI,EAAE,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IACpD,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,EAAkB,EAAE,IAAY,EAAE,IAA6B;QACxF,MAAM,EAAE,GAAG,IAAI,CAAC,EAAwB,CAAC;QACzC,IAAI,CAAC,EAAE;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,4BAA4B,EAAE,CAAC;QACzE,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,EAAE;YACzC,IAAI,EAAE,IAAI,CAAC,IAA0B;YACrC,KAAK,EAAE,IAAI,CAAC,KAA2B;YACvC,OAAO,EAAE,IAAI,CAAC,OAA6B;YAC3C,IAAI,EAAE,IAAI,CAAC,IAA+B;YAC1C,IAAI,EAAE,IAAI,CAAC,IAA4B;SACxC,CAAC,CAAC;QACH,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,IAAI,GAAG,EAAE,CAAC;QAC1E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,OAAO,IAAI,GAAG,EAAE,CAAC;IACtE,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,EAAkB,EAAE,IAAY,EAAE,IAA6B;QACxF,MAAM,EAAE,GAAG,IAAI,CAAC,EAAwB,CAAC;QACzC,IAAI,CAAC,EAAE;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,4BAA4B,EAAE,CAAC;QACzE,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,IAAI,GAAG,EAAE,CAAC;QAC1E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,OAAO,IAAI,GAAG,EAAE,CAAC;IACtE,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,EAAkB,EAAE,IAAY,EAAE,IAA6B;QACtF,MAAM,IAAI,GAAG,IAAI,CAAC,IAA0B,CAAC;QAC7C,MAAM,EAAE,GAAG,IAAI,CAAC,EAAwB,CAAC;QAEzC,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC/C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,8BAA8B,IAAI,QAAQ,EAAE,GAAG,EAAE,CAAC;YACzG,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACtE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,yBAAyB,IAAI,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,CAAC;QAC1G,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,0BAA0B,IAAI,GAAG,EAAE,CAAC;QAC1G,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;IACxD,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,EAAkB,EAAE,IAA6B;QAC1E,MAAM,KAAK,GAAG,IAAI,CAAC,KAA2B,CAAC;QAC/C,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,+BAA+B,EAAE,CAAC;QAC/E,MAAM,OAAO,GAAkB;YAC7B,IAAI,EAAE,IAAI,CAAC,IAA0B;YACrC,MAAM,EAAE,IAAI,CAAC,MAAmC;YAChD,IAAI,EAAE,IAAI,CAAC,IAA0B;YACrC,EAAE,EAAE,IAAI,CAAC,EAAwB;SAClC,CAAC;QACF,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC7C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,gCAAgC,KAAK,IAAI,EAAE,CAAC;QACnG,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,OAAO,GAAG,CACpH,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,IAAI,CAAC,MAAM,cAAc,KAAK,SAAS,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;IACzG,CAAC;IAEO,SAAS,CAAC,GAAe;QAC/B,MAAM,KAAK,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QACjC,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;YACzH,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YACxB,IAAI,CAAC,CAAC,KAAK;gBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YAC1C,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YACtB,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF"}