@project-ava-supernova/core 0.2.71

package/dist/tools/day-plan.js

@@ -0,0 +1,207 @@
+// ─── day_plan_read / day_plan_write / day_plan_item_status ──────────────────
+//
+// Ava's side of the day plan. The operator sees it in a sidebar all day; these
+// let her see the same thing, add to it when they agree something, and tick off
+// what she can actually verify.
+//
+// The read tool is the important one, and it exists because of a mistake made
+// twice. In the health room she could create plans but never SEE one, so she
+// archived a plan somebody was four days into and reported that nothing had
+// been displaced — confidently, because no tool had told her otherwise. A list
+// she cannot read is a list she will eventually contradict.
+//
+// What she must never do is tick something she did not witness. A scheduled
+// post publishes itself and the system records that; a post the operator put
+// out by hand is theirs to confirm. Claiming either on her own behalf turns the
+// plan from a record into an opinion, and the whole point of writing the day
+// down is that it stays a record.
+const ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
+function store(context) {
+    return context.sharedState?.dayPlanStore ?? null;
+}
+/** One line per item, grouped so a story reads as one thing. */
+function describe(items) {
+    if (!items.length)
+        return 'Nothing planned.';
+    const groups = new Map();
+    for (const it of items) {
+        const key = it.group_id || `solo:${it.id}`;
+        const list = groups.get(key);
+        if (list)
+            list.push(it);
+        else
+            groups.set(key, [it]);
+    }
+    const lines = [];
+    for (const rows of groups.values()) {
+        const head = rows[0];
+        const when = head.plan_time ? head.plan_time.slice(0, 5) : 'anytime';
+        const outputs = rows
+            .map(r => {
+            const where = r.platform || (r.kind === 'work' ? 'to do' : 'post');
+            // Say HOW it is known, every time. "done" alone invites her to treat a
+            // box someone ticked and a post that actually published as the same
+            // fact, which is exactly the confusion this column exists to prevent.
+            const state = r.status === 'done'
+                ? `done${r.done_by ? ` (${r.done_by})` : ''}`
+                : r.status;
+            return `${where}: ${state}`;
+        })
+            .join(', ');
+        lines.push(`- ${when} — ${head.title} [${outputs}]${head.notes ? ` — ${head.notes}` : ''}`);
+        if (rows[0].id)
+            lines.push(`  ids: ${rows.map(r => r.id).join(' ')}`);
+    }
+    return lines.join('\n');
+}
+export class DayPlanReadTool {
+    name = 'day_plan_read';
+    description = 'Read the plan for a day — what was agreed, what has gone out, what has not. Call this before planning a day (items may already be there, carried from yesterday) and any time you need to know where the day stands.';
+    riskLevel = 'safe';
+    requiresConfirmation = false;
+    schema = {
+        name: 'day_plan_read',
+        description: 'The day\'s plan: each story, its time, and the state of every platform under it. Call it BEFORE planning a day — work carried from yesterday is already sitting there, and planning over the top of it produces duplicates.',
+        parameters: {
+            type: 'object',
+            properties: {
+                date: {
+                    type: 'string',
+                    description: 'YYYY-MM-DD, the operator\'s LOCAL day. Omit for today. Call get_datetime rather than assuming what today is.',
+                },
+            },
+            required: [],
+        },
+    };
+    async execute(args, context) {
+        const s = store(context);
+        if (!s)
+            return { success: false, output: 'The day plan is not available in this context.' };
+        const date = typeof args.date === 'string' && ISO_DATE.test(args.date) ? args.date : null;
+        if (args.date && !date) {
+            return { success: false, output: `Invalid date "${String(args.date)}" — must be YYYY-MM-DD. Call get_datetime and use the local day.` };
+        }
+        try {
+            const items = await s.list(date ?? '');
+            return {
+                success: true,
+                output: describe(items),
+                metadata: { count: items.length, date: date ?? 'today' },
+            };
+        }
+        catch (err) {
+            return { success: false, output: `Could not read the plan: ${err instanceof Error ? err.message : String(err)}` };
+        }
+    }
+}
+export class DayPlanWriteTool {
+    name = 'day_plan_write';
+    description = 'Write agreed items into a day\'s plan. Use it when the operator has DECIDED something goes out — not to record a suggestion. A story going to several platforms is several items sharing one group_id.';
+    riskLevel = 'write';
+    requiresConfirmation = false;
+    schema = {
+        name: 'day_plan_write',
+        description: 'Add items to a day\'s plan. Only what the operator has actually agreed — this is the record of decisions, and filling it with things they have not chosen makes it useless to both of you. A story going to several platforms is one item PER PLATFORM sharing a group_id, because each output is separately done or not.',
+        parameters: {
+            type: 'object',
+            properties: {
+                date: { type: 'string', description: 'YYYY-MM-DD local day. Omit for today.' },
+                items: {
+                    type: 'array',
+                    description: 'The agreed items.',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            title: { type: 'string', description: 'The story or the task, in their words where possible.' },
+                            time: { type: 'string', description: 'HH:MM local. Omit for anytime. Never invent a time they did not agree; ask or leave it out.' },
+                            kind: { type: 'string', enum: ['post', 'work'], description: 'post = something that goes out; work = everything else the day contains (record the video, cut the thumbnail, reply to comments).' },
+                            platform: { type: 'string', description: 'For a post: tweet, bluesky, linkedin, facebook, instagram, youtube. Omit for work.' },
+                            group_id: { type: 'string', description: 'Same value across every platform of ONE story, so they read as one thing. Any stable string; reuse it across that story\'s items in this call.' },
+                            notes: { type: 'string', description: 'Optional one line — why it lands, or what it needs.' },
+                        },
+                        required: ['title'],
+                    },
+                },
+            },
+            required: ['items'],
+        },
+    };
+    async execute(args, context) {
+        const s = store(context);
+        if (!s)
+            return { success: false, output: 'The day plan is not available in this context.' };
+        const date = typeof args.date === 'string' && ISO_DATE.test(args.date) ? args.date : '';
+        const raw = Array.isArray(args.items) ? args.items : [];
+        const items = raw
+            .map((r) => {
+            const o = (r && typeof r === 'object') ? r : {};
+            const time = typeof o.time === 'string' && /^\d{2}:\d{2}$/.test(o.time) ? `${o.time}:00` : null;
+            return {
+                title: String(o.title || '').trim(),
+                plan_time: time,
+                kind: o.kind === 'work' ? 'work' : 'post',
+                platform: typeof o.platform === 'string' ? o.platform.trim() : null,
+                notes: typeof o.notes === 'string' ? o.notes.trim() : null,
+                group_id: typeof o.group_id === 'string' ? o.group_id.trim() : null,
+            };
+        })
+            .filter(i => i.title);
+        if (!items.length)
+            return { success: false, output: 'No items with a title — nothing written.' };
+        try {
+            const n = await s.add(date, items);
+            return {
+                success: true,
+                output: `${n} item${n === 1 ? '' : 's'} written to the plan. They are on the operator's screen now.`,
+                metadata: { written: n },
+            };
+        }
+        catch (err) {
+            return { success: false, output: `Could not write the plan: ${err instanceof Error ? err.message : String(err)}` };
+        }
+    }
+}
+export class DayPlanItemStatusTool {
+    name = 'day_plan_item_status';
+    description = 'Change one plan item: done, dropped, or carried. Only mark done what you can actually verify — a post you watched publish. Anything the operator did by hand is theirs to tick.';
+    riskLevel = 'write';
+    requiresConfirmation = false;
+    schema = {
+        name: 'day_plan_item_status',
+        description: 'Set one item to done, dropped, carried, or back to planned. Get ids from day_plan_read. NEVER mark something done that you did not witness — if the operator says they posted it, that is them telling you, and it is still their tick to make, not evidence you hold.',
+        parameters: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'The item id, from day_plan_read.' },
+                status: { type: 'string', enum: ['planned', 'done', 'dropped', 'carried'], description: 'The new state.' },
+            },
+            required: ['id', 'status'],
+        },
+    };
+    async execute(args, context) {
+        const s = store(context);
+        if (!s)
+            return { success: false, output: 'The day plan is not available in this context.' };
+        const id = typeof args.id === 'string' ? args.id.trim() : '';
+        const status = args.status;
+        if (!id)
+            return { success: false, output: 'Missing `id` — read the plan first to get it.' };
+        if (!['planned', 'done', 'dropped', 'carried'].includes(status)) {
+            return { success: false, output: `Invalid status "${String(args.status)}".` };
+        }
+        try {
+            // 'ava' as done_by, never 'system' or 'operator': whoever reads this row
+            // later should be able to tell that SHE marked it, and weigh it
+            // accordingly. Laundering her own tick as the system's would be the
+            // quietest possible lie.
+            const ok = await s.setStatus(id, status, status === 'done' ? 'ava' : null);
+            if (!ok)
+                return { success: false, output: `No plan item with id ${id}.` };
+            return { success: true, output: `Item ${id} is now ${status}.`, metadata: { id, status } };
+        }
+        catch (err) {
+            return { success: false, output: `Could not update the item: ${err instanceof Error ? err.message : String(err)}` };
+        }
+    }
+}
+//# sourceMappingURL=day-plan.js.map

package/dist/tools/day-plan.js.map

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

package/dist/tools/debug-logs.d.ts

@@ -0,0 +1,13 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+export declare class DebugLogsTool implements Tool {
+    readonly name = "debug_logs";
+    readonly description = "Read and filter log files or command output for debugging";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+    private formatLogLine;
+    private runCommand;
+}
+//# sourceMappingURL=debug-logs.d.ts.map

package/dist/tools/debug-logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-logs.d.ts","sourceRoot":"","sources":["../../src/tools/debug-logs.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAO5D,qBAAa,aAAc,YAAW,IAAI;IACxC,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,+DAA+D;IACnF,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAU;IAC3C,QAAQ,CAAC,oBAAoB,SAAS;IAEtC,QAAQ,CAAC,MAAM,EAAE,cAAc,CA6B7B;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;IA8EhG,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,UAAU;CAYnB"}

package/dist/tools/debug-logs.js

@@ -0,0 +1,141 @@
+import { readFile, stat } from 'node:fs/promises';
+import { exec } from 'node:child_process';
+import { validatePath } from './security.js';
+const MAX_OUTPUT_LENGTH = 30_000;
+const DEFAULT_LINES = 100;
+const TAIL_TIMEOUT_MS = 10_000;
+export class DebugLogsTool {
+    name = 'debug_logs';
+    description = 'Read and filter log files or command output for debugging';
+    riskLevel = 'safe';
+    requiresConfirmation = false;
+    schema = {
+        name: 'debug_logs',
+        description: 'Read log files or capture command output for debugging. Supports filtering by regex pattern, ' +
+            'limiting output to last N lines, and parsing common log formats (JSON logs, timestamped logs). ' +
+            'Use source as a file path for log files, or a command string to capture live output.',
+        parameters: {
+            type: 'object',
+            properties: {
+                source: {
+                    type: 'string',
+                    description: 'File path to a log file, or a shell command to capture output from (e.g., "docker logs app").',
+                },
+                filter: {
+                    type: 'string',
+                    description: 'Regex pattern to filter lines (e.g., "ERROR|WARN", "status.*500").',
+                },
+                lines: {
+                    type: 'number',
+                    description: `Number of lines to return (from end of file/output). Default: ${DEFAULT_LINES}.`,
+                },
+                level: {
+                    type: 'string',
+                    enum: ['error', 'warn', 'info', 'debug', 'all'],
+                    description: 'Filter by log level (auto-detected from common formats). Default: all.',
+                },
+            },
+            required: ['source'],
+        },
+    };
+    async execute(args, context) {
+        const source = args.source;
+        const filter = args.filter;
+        const lines = args.lines ?? DEFAULT_LINES;
+        const level = args.level ?? 'all';
+        let rawOutput;
+        let isFile = false;
+        // Try as file path first
+        try {
+            const filePath = validatePath(source, context.cwd);
+            const fileStat = await stat(filePath);
+            if (fileStat.isFile()) {
+                rawOutput = await readFile(filePath, 'utf-8');
+                isFile = true;
+            }
+            else {
+                return { success: false, output: `"${source}" is not a file.` };
+            }
+        }
+        catch {
+            // Not a file — try as command
+            rawOutput = await this.runCommand(source, context.cwd);
+        }
+        // Split into lines and take last N
+        let logLines = rawOutput.split('\n');
+        logLines = logLines.slice(-lines);
+        // Filter by level
+        if (level !== 'all') {
+            const levelPatterns = {
+                error: /\b(error|err|fatal|critical|panic)\b/i,
+                warn: /\b(warn|warning)\b/i,
+                info: /\b(info)\b/i,
+                debug: /\b(debug|trace|verbose)\b/i,
+            };
+            const levelRegex = levelPatterns[level];
+            if (levelRegex) {
+                logLines = logLines.filter(l => levelRegex.test(l));
+            }
+        }
+        // Filter by regex
+        if (filter) {
+            try {
+                const regex = new RegExp(filter, 'i');
+                logLines = logLines.filter(l => regex.test(l));
+            }
+            catch (err) {
+                return { success: false, output: `Invalid filter regex: ${err.message}` };
+            }
+        }
+        // Parse JSON log lines for better formatting
+        const formatted = logLines.map(line => this.formatLogLine(line));
+        let output = formatted.join('\n');
+        if (output.length > MAX_OUTPUT_LENGTH) {
+            output = output.slice(0, MAX_OUTPUT_LENGTH) + '\n... (output truncated)';
+        }
+        const summary = `Source: ${isFile ? 'file' : 'command'} "${source}"\n`;
+        const filterInfo = filter ? `Filter: /${filter}/i\n` : '';
+        const levelInfo = level !== 'all' ? `Level: ${level}\n` : '';
+        const countInfo = `Lines: ${formatted.length}${logLines.length < lines ? '' : ` (last ${lines})`}\n\n`;
+        return {
+            success: true,
+            output: summary + filterInfo + levelInfo + countInfo + output,
+            metadata: {
+                source,
+                isFile,
+                lineCount: formatted.length,
+                filter: filter ?? undefined,
+                level,
+            },
+        };
+    }
+    formatLogLine(line) {
+        // Try parsing as JSON log
+        try {
+            if (line.trim().startsWith('{')) {
+                const parsed = JSON.parse(line);
+                const ts = parsed.timestamp || parsed.time || parsed.ts || parsed['@timestamp'] || '';
+                const lvl = parsed.level || parsed.severity || parsed.lvl || '';
+                const msg = parsed.message || parsed.msg || parsed.text || '';
+                if (msg) {
+                    return `[${ts}] ${lvl.toUpperCase()} ${msg}`;
+                }
+            }
+        }
+        catch { /* not JSON */ }
+        return line;
+    }
+    runCommand(command, cwd) {
+        return new Promise((resolve) => {
+            exec(command, {
+                cwd,
+                timeout: TAIL_TIMEOUT_MS,
+                maxBuffer: 1024 * 1024 * 5,
+                env: { ...process.env, FORCE_COLOR: '0' },
+            }, (_error, stdout, stderr) => {
+                resolve((stdout || '') + (stderr || ''));
+            });
+        });
+    }
+}
+//# sourceMappingURL=debug-logs.js.map

package/dist/tools/debug-logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-logs.js","sourceRoot":"","sources":["../../src/tools/debug-logs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAG1C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,iBAAiB,GAAG,MAAM,CAAC;AACjC,MAAM,aAAa,GAAG,GAAG,CAAC;AAC1B,MAAM,eAAe,GAAG,MAAM,CAAC;AAE/B,MAAM,OAAO,aAAa;IACf,IAAI,GAAG,YAAY,CAAC;IACpB,WAAW,GAAG,2DAA2D,CAAC;IAC1E,SAAS,GAAkB,MAAM,CAAC;IAClC,oBAAoB,GAAG,KAAK,CAAC;IAE7B,MAAM,GAAmB;QAChC,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,+FAA+F;YAC/F,iGAAiG;YACjG,sFAAsF;QACxF,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+FAA+F;iBAC7G;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,oEAAoE;iBAClF;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iEAAiE,aAAa,GAAG;iBAC/F;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC;oBAC/C,WAAW,EAAE,wEAAwE;iBACtF;aACF;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;KACF,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,IAA6B,EAAE,OAA6B;QACxE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAgB,CAAC;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,MAA4B,CAAC;QACjD,MAAM,KAAK,GAAI,IAAI,CAAC,KAAgB,IAAI,aAAa,CAAC;QACtD,MAAM,KAAK,GAAI,IAAI,CAAC,KAAgB,IAAI,KAAK,CAAC;QAE9C,IAAI,SAAiB,CAAC;QACtB,IAAI,MAAM,GAAG,KAAK,CAAC;QAEnB,yBAAyB;QACzB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;YACnD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtC,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;gBACtB,SAAS,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAC9C,MAAM,GAAG,IAAI,CAAC;YAChB,CAAC;iBAAM,CAAC;gBACN,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,MAAM,kBAAkB,EAAE,CAAC;YAClE,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,8BAA8B;YAC9B,SAAS,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;QACzD,CAAC;QAED,mCAAmC;QACnC,IAAI,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrC,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;QAElC,kBAAkB;QAClB,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;YACpB,MAAM,aAAa,GAA2B;gBAC5C,KAAK,EAAE,uCAAuC;gBAC9C,IAAI,EAAE,qBAAqB;gBAC3B,IAAI,EAAE,aAAa;gBACnB,KAAK,EAAE,4BAA4B;aACpC,CAAC;YACF,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;YACxC,IAAI,UAAU,EAAE,CAAC;gBACf,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;QAED,kBAAkB;QAClB,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;gBACtC,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACjD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,yBAA0B,GAAa,CAAC,OAAO,EAAE,EAAE,CAAC;YACvF,CAAC;QACH,CAAC;QAED,6CAA6C;QAC7C,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;QAEjE,IAAI,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,MAAM,CAAC,MAAM,GAAG,iBAAiB,EAAE,CAAC;YACtC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,GAAG,0BAA0B,CAAC;QAC3E,CAAC;QAED,MAAM,OAAO,GAAG,WAAW,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,KAAK,MAAM,KAAK,CAAC;QACvE,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,YAAY,MAAM,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,MAAM,SAAS,GAAG,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,MAAM,SAAS,GAAG,UAAU,SAAS,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,GAAG,MAAM,CAAC;QAEvG,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM;YAC7D,QAAQ,EAAE;gBACR,MAAM;gBACN,MAAM;gBACN,SAAS,EAAE,SAAS,CAAC,MAAM;gBAC3B,MAAM,EAAE,MAAM,IAAI,SAAS;gBAC3B,KAAK;aACN;SACF,CAAC;IACJ,CAAC;IAEO,aAAa,CAAC,IAAY;QAChC,0BAA0B;QAC1B,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAChC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAChC,MAAM,EAAE,GAAG,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;gBACtF,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;gBAChE,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;gBAC9D,IAAI,GAAG,EAAE,CAAC;oBACR,OAAO,IAAI,EAAE,KAAK,GAAG,CAAC,WAAW,EAAE,IAAI,GAAG,EAAE,CAAC;gBAC/C,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,cAAc,CAAC,CAAC;QAE1B,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,UAAU,CAAC,OAAe,EAAE,GAAW;QAC7C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,IAAI,CAAC,OAAO,EAAE;gBACZ,GAAG;gBACH,OAAO,EAAE,eAAe;gBACxB,SAAS,EAAE,IAAI,GAAG,IAAI,GAAG,CAAC;gBAC1B,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE;aAC1C,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;gBAC5B,OAAO,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;YAC3C,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/tools/deploy-manifest.d.ts

@@ -0,0 +1,37 @@
+/**
+ * One deployed surface. `match` is a forgiving path pattern (a bare prefix like
+ * `packages/web` or a globby `packages/web/**`); a changed file "belongs to"
+ * this surface when its path starts with the literal portion of `match`.
+ *
+ * Liveness is read from the deployed URL via ONE of:
+ *   - `marker`: a response header carrying the live commit/build id
+ *     (default `x-ava-commit` when neither field is given), or
+ *   - `markerJsonPath`: fetch the URL as JSON and read this dot-path
+ *     (e.g. `commit` or `build.sha`).
+ */
+export interface DeploySurface {
+    name: string;
+    match: string;
+    url: string;
+    marker?: string;
+    markerJsonPath?: string;
+}
+export interface DeployManifest {
+    surfaces: DeploySurface[];
+}
+/** True when `file` lives under `surface.match`'s prefix. */
+export declare function fileMatchesSurface(file: string, surface: DeploySurface): boolean;
+/**
+ * Load the deploy manifest from the nearest known location, or null when the
+ * project hasn't declared one. Never throws — a malformed manifest is treated
+ * as absent (logged by the caller if it cares), because a broken config must
+ * not break verification.
+ */
+export declare function loadDeployManifest(cwd: string): Promise<DeployManifest | null>;
+/**
+ * The set of literal path prefixes declared by the manifest. Passed into the
+ * (pure) verification matrix so it can tag changed files as `deployed` without
+ * doing any IO itself.
+ */
+export declare function deployPrefixes(manifest: DeployManifest | null): string[];
+//# sourceMappingURL=deploy-manifest.d.ts.map

package/dist/tools/deploy-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy-manifest.d.ts","sourceRoot":"","sources":["../../src/tools/deploy-manifest.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAgBD,6DAA6D;AAC7D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAKhF;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAqBpF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,GAAG,MAAM,EAAE,CAGxE"}

package/dist/tools/deploy-manifest.js

@@ -0,0 +1,71 @@
+// ─── Deploy Manifest ────────────────────────────────────────────────────────
+// Optional, project-supplied map of "which files deploy to which live surface,
+// and how to read that surface's currently-serving commit."
+//
+// This is the data behind the `deploy_state` verification check. Core ships to
+// every user, so it MUST NOT hardcode any URLs — the check does nothing until a
+// project drops an `ava.deploy.json` (or `.ava/deploy.json`) at its root. That
+// keeps the liveness check honest and portable: it observes whatever the
+// project declares, and stays silent when nothing is declared.
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+const MANIFEST_LOCATIONS = ['ava.deploy.json', join('.ava', 'deploy.json')];
+/**
+ * Reduce a `match` pattern to the literal directory prefix used for matching:
+ * strips a trailing `/**`, `/*`, or `/`. Backslashes are normalised so Windows
+ * paths compare cleanly against POSIX-style manifest entries.
+ */
+function matchPrefix(match) {
+    return match
+        .replace(/\\/g, '/')
+        .replace(/\/\*\*?$/, '')
+        .replace(/\/$/, '');
+}
+/** True when `file` lives under `surface.match`'s prefix. */
+export function fileMatchesSurface(file, surface) {
+    const f = file.replace(/\\/g, '/').replace(/^\.\//, '');
+    const prefix = matchPrefix(surface.match);
+    if (!prefix)
+        return false;
+    return f === prefix || f.startsWith(prefix + '/');
+}
+/**
+ * Load the deploy manifest from the nearest known location, or null when the
+ * project hasn't declared one. Never throws — a malformed manifest is treated
+ * as absent (logged by the caller if it cares), because a broken config must
+ * not break verification.
+ */
+export async function loadDeployManifest(cwd) {
+    for (const rel of MANIFEST_LOCATIONS) {
+        const abs = join(cwd, rel);
+        if (!existsSync(abs))
+            continue;
+        try {
+            const parsed = JSON.parse(await readFile(abs, 'utf8'));
+            const surfaces = parsed.surfaces;
+            if (!Array.isArray(surfaces))
+                return null;
+            const valid = surfaces.filter((s) => !!s &&
+                typeof s.name === 'string' &&
+                typeof s.match === 'string' &&
+                typeof s.url === 'string');
+            return valid.length > 0 ? { surfaces: valid } : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}
+/**
+ * The set of literal path prefixes declared by the manifest. Passed into the
+ * (pure) verification matrix so it can tag changed files as `deployed` without
+ * doing any IO itself.
+ */
+export function deployPrefixes(manifest) {
+    if (!manifest)
+        return [];
+    return manifest.surfaces.map((s) => matchPrefix(s.match)).filter(Boolean);
+}
+//# sourceMappingURL=deploy-manifest.js.map

package/dist/tools/deploy-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy-manifest.js","sourceRoot":"","sources":["../../src/tools/deploy-manifest.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,+EAA+E;AAC/E,4DAA4D;AAC5D,EAAE;AACF,+EAA+E;AAC/E,gFAAgF;AAChF,+EAA+E;AAC/E,yEAAyE;AACzE,+DAA+D;AAE/D,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAyBjC,MAAM,kBAAkB,GAAG,CAAC,iBAAiB,EAAE,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;AAE5E;;;;GAIG;AACH,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,KAAK;SACT,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACxB,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,OAAsB;IACrE,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1B,OAAO,CAAC,KAAK,MAAM,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;AACpD,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAAW;IAClD,KAAK,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAC/B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAY,CAAC;YAClE,MAAM,QAAQ,GAAI,MAAiC,CAAC,QAAQ,CAAC;YAC7D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAC3B,CAAC,CAAC,EAAsB,EAAE,CACxB,CAAC,CAAC,CAAC;gBACH,OAAQ,CAAmB,CAAC,IAAI,KAAK,QAAQ;gBAC7C,OAAQ,CAAmB,CAAC,KAAK,KAAK,QAAQ;gBAC9C,OAAQ,CAAmB,CAAC,GAAG,KAAK,QAAQ,CAC/C,CAAC;YACF,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,QAA+B;IAC5D,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IACzB,OAAO,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC5E,CAAC"}

package/dist/tools/design-studio-tools.d.ts

@@ -0,0 +1,83 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+export declare class DesignFindShapeTool implements Tool {
+    readonly name = "design_find_shape";
+    readonly description = "Find a known-good Lucide shape (the armature) that matches an icon subject. Always call this before generating \u2014 the shape hands the model correct geometry so the icon reads as the thing.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+export declare class DesignGenerateIconTool implements Tool {
+    readonly name = "design_generate_icon";
+    readonly description = "Generate one on-brand icon from a shape armature: pick shape + material + colour, run shape-as-dial (Lucide \u2192 qwen-image-edit-max \u2192 matte). Costs 20 credits \u2014 confirm cost with the user first.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+export declare class DesignGenerateSetTool implements Tool {
+    readonly name = "design_generate_set";
+    readonly description = "Generate a matched set of icons \u2014 same material, colour and lighting held constant so they sit together as a family. N \u00D7 20 credits; quote the total and get a yes first.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+export declare class DesignBrandKitTool implements Tool {
+    readonly name = "design_brand_kit";
+    readonly description = "Manage the user's brand kits \u2014 multiple named identities, one active. Each kit carries Look (palette + style) AND Voice (tone, do/don't, hashtags). List, read, create, switch the active kit, update, rename, or delete. The active kit is what design AND posts come out on.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+export declare class DesignSaveTool implements Tool {
+    readonly name = "design_save";
+    readonly description = "Save the icon currently on the canvas to the user's local creative library (transparent PNG). Local-first, on their machine.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+export declare class DesignGenerateVideoTool implements Tool {
+    readonly name = "design_generate_video";
+    readonly description = "Generate a short video on the Open Canvas from an authored prompt (shot / subject / motion / mood) via Wan. YOU write the prompt from what you gauged the user wants. Uses credits \u2014 confirm cost first.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+export declare class DesignGenerateImageTool implements Tool {
+    readonly name = "design_generate_image";
+    readonly description = "Generate a free-form image on the Open Canvas from an authored prompt (subject / style / composition / lighting / mood). YOU write the full prompt from what you gauged the user wants. This is NOT an icon \u2014 no armature, no matte. Uses credits \u2014 confirm cost first.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+export declare class DesignGenerateLogoTool implements Tool {
+    readonly name = "design_generate_logo";
+    readonly description = "Design a full LOGO SYSTEM for the active brand \u2014 a mark YOU construct as exact vector geometry, plus a real-font wordmark, composed into lockups, symbol-only, wordmark-only, mono (light/dark) and favicon. No image model, instant; 20 credits (same as an icon). Name/palette/feel come from the active brand kit. After it renders, offer to set it as the brand logo (design_brand_kit set_logo).";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+export declare class DesignExploreLogosTool implements Tool {
+    readonly name = "design_explore_logos";
+    readonly description = "Explore several logo DIRECTIONS at once. You author 3\u20134 genuinely different candidates (different mark ideas, forms, fonts); it renders them all into one numbered grid and returns it as an image so you can compare and pick the strongest. Instant; 20 credits for the whole batch (picking one from it is then free \u2014 great value). Use this to lead with real options instead of one guess.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+export declare class DesignGenerateVoiceTool implements Tool {
+    readonly name = "design_generate_voice";
+    readonly description = "Generate a voiceover on the Open Canvas via Qwen3-TTS. YOU author the script (the exact words) AND the delivery (tone / pace / emotion) from what you gauged. Pick a voice from the roster; translate the script yourself and set the language to voice it in another language in the SAME voice. Uses credits \u2014 confirm cost first.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=design-studio-tools.d.ts.map

package/dist/tools/design-studio-tools.d.ts.map

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