@project-ava-supernova/core 0.2.71

package/dist/tools/task-manage.js

@@ -0,0 +1,256 @@
+import { randomUUID } from 'node:crypto';
+/** Map the tool's reminder enum to minutes-before-due. */
+const REMINDER_TO_MINUTES = {
+    at_time: 0, '10m': 10, '30m': 30, '1h': 60, '1d': 1440,
+};
+/** Turn a list of subtask titles into TaskSubtask rows. */
+function toSubtasks(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const titles = value.filter((v) => typeof v === 'string' && v.trim().length > 0);
+    if (titles.length === 0)
+        return undefined;
+    return titles.map(title => ({ id: randomUUID(), title: title.trim(), done: false }));
+}
+export class TaskManageTool {
+    name = 'task_manage';
+    description = 'Manage the user\'s personal task list — list, create, complete, update, delete tasks';
+    // Write actions on the operator's personal task list need explicit
+    // consent — Ava was creating tasks unprompted from tangential mentions
+    // in conversation. Set requiresConfirmation true at the tool level;
+    // list/complete prompts are mild friction, create/update/delete
+    // prompts are the whole point. Operators who want to skip prompts on
+    // list calls can use the per-tool always-allow permission.
+    riskLevel = 'safe';
+    requiresConfirmation = true;
+    schema = {
+        name: 'task_manage',
+        description: 'Manage the user\'s personal task list. Use this to help users organize their work and life — ' +
+            'coding tasks, meetings, personal errands, anything. This is their persistent task system, not your session progress. ' +
+            'Actions: list (view tasks), create (add a task), complete (mark done), update (change details), delete (remove). ' +
+            'Tasks persist across sessions and can sync to the cloud. ' +
+            'Proactive use: when the user mentions an obligation, deadline, or thing-to-do in conversation, offer to capture it ' +
+            '("Want me to add that as a task?") and only create on explicit yes. Don\'t silently create tasks the user didn\'t agree to.',
+        parameters: {
+            type: 'object',
+            properties: {
+                action: {
+                    type: 'string',
+                    enum: ['list', 'create', 'complete', 'update', 'delete'],
+                    description: 'The action to perform',
+                },
+                // For create
+                title: {
+                    type: 'string',
+                    description: 'Task title (required for create, optional for update)',
+                },
+                description: {
+                    type: 'string',
+                    description: 'Task description (optional)',
+                },
+                priority: {
+                    type: 'string',
+                    enum: ['low', 'medium', 'high', 'urgent'],
+                    description: 'Priority level (default: medium)',
+                },
+                category: {
+                    type: 'string',
+                    description: 'Category — a free-form label. Common ones: personal, coding, admin, meeting, health, finance, errands, study, home — but use ANY label that fits the task (e.g. "fitness", "garden", "kids"). Pick from the content: software work → coding, paperwork/accounts → admin, calls/appointments → meeting. Most users are NOT coders; only use "coding" for actual software work. Default: personal.',
+                },
+                due_date: {
+                    type: 'string',
+                    description: 'Due date in YYYY-MM-DD format. Only set this when the user gives a real date or deadline — never invent one. Leave unset for tasks with no due date.',
+                },
+                due_time: {
+                    type: 'string',
+                    description: 'Time of day the task is due, in 24h HH:MM (e.g. "18:00"). Only when the user gives a real time ("call mum at 6"). Needs a due_date to anchor to.',
+                },
+                reminder: {
+                    type: 'string',
+                    enum: ['at_time', '10m', '30m', '1h', '1d'],
+                    description: 'Fire a reminder this far before the task is due: at_time, 10m, 30m, 1h, or 1d before. Only set when the user wants reminding. Needs a due_date.',
+                },
+                subtasks: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Optional checklist — a list of subtask titles to break the task into steps.',
+                },
+                recurrence: {
+                    type: 'string',
+                    enum: ['none', 'daily', 'weekdays', 'weekly', 'monthly'],
+                    description: 'Recurrence: none, daily, weekdays (Mon–Fri), weekly (same weekday), or monthly (same date). Default: none.',
+                },
+                scope: {
+                    type: 'string',
+                    enum: ['project', 'global'],
+                    description: 'Where to store: project (this workspace) or global (all projects). Default: project',
+                },
+                // For complete, update, delete
+                task_id: {
+                    type: 'string',
+                    description: 'Task ID (required for complete, update, delete)',
+                },
+                // For list
+                status_filter: {
+                    type: 'string',
+                    enum: ['all', 'active', 'done', 'today'],
+                    description: 'Filter tasks by status (default: active)',
+                },
+            },
+            required: ['action'],
+        },
+    };
+    async execute(args, context) {
+        const taskManager = context.sharedState?.taskManager;
+        if (!taskManager) {
+            return { success: false, output: 'Task manager not available.' };
+        }
+        const action = args.action;
+        switch (action) {
+            case 'list':
+                return this.handleList(taskManager, args);
+            case 'create':
+                return this.handleCreate(taskManager, args);
+            case 'complete':
+                return this.handleComplete(taskManager, args);
+            case 'update':
+                return this.handleUpdate(taskManager, args);
+            case 'delete':
+                return this.handleDelete(taskManager, args);
+            default:
+                return { success: false, output: `Unknown action: ${action}` };
+        }
+    }
+    async handleList(tm, args) {
+        const filter = args.status_filter || 'active';
+        let tasks;
+        if (filter === 'today') {
+            tasks = await tm.getTodayTasks();
+        }
+        else if (filter === 'done') {
+            tasks = await tm.listTasks({ status: ['done'] });
+        }
+        else if (filter === 'all') {
+            tasks = await tm.listTasks({ includeArchived: true });
+        }
+        else {
+            // active = todo + in-progress
+            tasks = await tm.listTasks({ status: ['todo', 'in-progress'] });
+        }
+        if (tasks.length === 0) {
+            return { success: true, output: `No ${filter} tasks found.` };
+        }
+        const lines = tasks.map(t => {
+            const icon = t.status === 'done' ? '[x]' : t.status === 'in-progress' ? '[~]' : '[ ]';
+            const parts = [`${icon} ${t.title}`];
+            if (t.priority === 'urgent' || t.priority === 'high')
+                parts.push(`(${t.priority})`);
+            if (t.dueDate)
+                parts.push(`due: ${t.dueDate}`);
+            if (t.category !== 'coding')
+                parts.push(`[${t.category}]`);
+            if (t.recurrence !== 'none')
+                parts.push(`(${t.recurrence})`);
+            parts.push(`  id: ${t.id}`);
+            return parts.join(' ');
+        });
+        return {
+            success: true,
+            output: `${tasks.length} ${filter} task${tasks.length === 1 ? '' : 's'}:\n${lines.join('\n')}`,
+        };
+    }
+    async handleCreate(tm, args) {
+        const title = args.title;
+        if (!title) {
+            return { success: false, output: 'Missing required field: title' };
+        }
+        const reminder = args.reminder;
+        const opts = {
+            title,
+            description: args.description,
+            priority: args.priority ?? 'medium',
+            // Neutral default — most users aren't coders. Ava picks the fitting
+            // category from the task content (see schema); fall back to personal.
+            category: args.category ?? 'personal',
+            // No auto due-date — a task only lands in "Today" if the user gave a
+            // real deadline. Auto-stamping today polluted the Today view.
+            dueDate: args.due_date,
+            dueTime: args.due_time,
+            reminderLead: reminder ? REMINDER_TO_MINUTES[reminder] : undefined,
+            subtasks: toSubtasks(args.subtasks),
+            recurrence: args.recurrence ?? 'none',
+            scope: args.scope ?? 'project',
+            source: 'ava',
+        };
+        const entry = await tm.addTask(opts);
+        const parts = [`Task created: "${entry.title}"`];
+        if (entry.priority !== 'medium')
+            parts.push(`(${entry.priority})`);
+        if (entry.dueDate)
+            parts.push(`due: ${entry.dueDate}`);
+        if (entry.category !== 'coding')
+            parts.push(`[${entry.category}]`);
+        parts.push(`\nid: ${entry.id}`);
+        return { success: true, output: parts.join(' ') };
+    }
+    async handleComplete(tm, args) {
+        const taskId = args.task_id;
+        if (!taskId) {
+            return { success: false, output: 'Missing required field: task_id' };
+        }
+        const entry = await tm.completeTask(taskId);
+        if (!entry) {
+            return { success: false, output: `Task not found: ${taskId}` };
+        }
+        return { success: true, output: `Task completed: "${entry.title}"` };
+    }
+    async handleUpdate(tm, args) {
+        const taskId = args.task_id;
+        if (!taskId) {
+            return { success: false, output: 'Missing required field: task_id' };
+        }
+        const updates = {};
+        if (args.title !== undefined)
+            updates.title = args.title;
+        if (args.description !== undefined)
+            updates.description = args.description;
+        if (args.priority !== undefined)
+            updates.priority = args.priority;
+        if (args.category !== undefined)
+            updates.category = args.category;
+        if (args.due_date !== undefined)
+            updates.dueDate = args.due_date;
+        if (args.due_time !== undefined)
+            updates.dueTime = args.due_time;
+        if (args.reminder !== undefined) {
+            updates.reminderLead = REMINDER_TO_MINUTES[args.reminder];
+        }
+        if (args.subtasks !== undefined) {
+            const subs = toSubtasks(args.subtasks);
+            if (subs)
+                updates.subtasks = subs;
+        }
+        if (args.recurrence !== undefined)
+            updates.recurrence = args.recurrence;
+        if (Object.keys(updates).length === 0) {
+            return { success: false, output: 'No fields to update. Provide title, description, priority, category, due_date, due_time, reminder, subtasks, or recurrence.' };
+        }
+        const entry = await tm.updateTask(taskId, updates);
+        if (!entry) {
+            return { success: false, output: `Task not found: ${taskId}` };
+        }
+        return { success: true, output: `Task updated: "${entry.title}"` };
+    }
+    async handleDelete(tm, args) {
+        const taskId = args.task_id;
+        if (!taskId) {
+            return { success: false, output: 'Missing required field: task_id' };
+        }
+        const deleted = await tm.deleteTask(taskId);
+        if (!deleted) {
+            return { success: false, output: `Task not found: ${taskId}` };
+        }
+        return { success: true, output: `Task deleted.` };
+    }
+}
+//# sourceMappingURL=task-manage.js.map

package/dist/tools/task-manage.js.map

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

package/dist/tools/task-suggest.d.ts

@@ -0,0 +1,27 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+/**
+ * Offer the user a task you've noticed — as a tappable card, NOT a silent write.
+ *
+ * This is the heart of "Ava suggests, you decide": when something task-worthy
+ * comes up in conversation, Ava proposes it through this tool. The host renders
+ * a card in the chat with Add / Edit & add / Dismiss; the task only lands on the
+ * user's board if they tap Add. Nothing is persisted otherwise.
+ *
+ * Like `ask_user` / `health_profile_ask`, the body is bypassed: the host renders
+ * the card, the user decides, and the host creates the task (on Add) and returns
+ * the outcome as the tool result.
+ *
+ * Use `task_manage` create ONLY when the user explicitly asks to add a task
+ * ("add X to my list"). For anything you merely *noticed*, use this — it keeps
+ * the user in control of their own board.
+ */
+export declare class TaskSuggestTool implements Tool {
+    readonly name = "task_suggest";
+    readonly description = "Offer the user a task you noticed, as a card they can Add / edit / dismiss. Use this \u2014 not task_manage create \u2014 whenever you spot a task-worthy thing in conversation; it never writes to their list without a tap.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = true;
+    readonly schema: FunctionSchema;
+    execute(_args: Record<string, unknown>, _context: ToolExecutionContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=task-suggest.d.ts.map

package/dist/tools/task-suggest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-suggest.d.ts","sourceRoot":"","sources":["../../src/tools/task-suggest.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;AAE5D;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,eAAgB,YAAW,IAAI;IAC1C,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,WAAW,mOACoM;IACxN,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAU;IAC3C,QAAQ,CAAC,oBAAoB,QAAQ;IAErC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAyC7B;IAEI,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;CAMnG"}

package/dist/tools/task-suggest.js

@@ -0,0 +1,70 @@
+/**
+ * Offer the user a task you've noticed — as a tappable card, NOT a silent write.
+ *
+ * This is the heart of "Ava suggests, you decide": when something task-worthy
+ * comes up in conversation, Ava proposes it through this tool. The host renders
+ * a card in the chat with Add / Edit & add / Dismiss; the task only lands on the
+ * user's board if they tap Add. Nothing is persisted otherwise.
+ *
+ * Like `ask_user` / `health_profile_ask`, the body is bypassed: the host renders
+ * the card, the user decides, and the host creates the task (on Add) and returns
+ * the outcome as the tool result.
+ *
+ * Use `task_manage` create ONLY when the user explicitly asks to add a task
+ * ("add X to my list"). For anything you merely *noticed*, use this — it keeps
+ * the user in control of their own board.
+ */
+export class TaskSuggestTool {
+    name = 'task_suggest';
+    description = 'Offer the user a task you noticed, as a card they can Add / edit / dismiss. Use this — not task_manage create — whenever you spot a task-worthy thing in conversation; it never writes to their list without a tap.';
+    riskLevel = 'safe';
+    requiresConfirmation = true;
+    schema = {
+        name: 'task_suggest',
+        description: 'Suggest a task to the user as a tap-to-add card (it is NOT added until they tap Add). ' +
+            'This is your DEFAULT when you notice a task-worthy thing in conversation ("I should call the dentist", "we need to renew the licence by Friday"). ' +
+            'Only use task_manage create instead when the user explicitly tells you to add a task. ' +
+            'Propose a clean, complete task — fill in due date/time, recurrence, reminder and subtasks when the conversation gives them. One suggestion per item; if they dismiss it, drop it.',
+        parameters: {
+            type: 'object',
+            properties: {
+                title: { type: 'string', description: 'Short, clear task title.' },
+                note: { type: 'string', description: 'Optional one-line note / description for the task.' },
+                priority: {
+                    type: 'string',
+                    enum: ['low', 'medium', 'high', 'urgent'],
+                    description: 'Priority (default: medium).',
+                },
+                category: {
+                    type: 'string',
+                    description: 'Free-form category — personal, admin, health, finance, errands, home, coding… Pick what fits; most users are not coders.',
+                },
+                due_date: { type: 'string', description: 'Due date YYYY-MM-DD — only if the conversation gives a real date.' },
+                due_time: { type: 'string', description: 'Due time HH:MM (24h) — only if a real time was mentioned ("at 6").' },
+                reminder: {
+                    type: 'string',
+                    enum: ['at_time', '10m', '30m', '1h', '1d'],
+                    description: 'Reminder lead before due (only if reminding makes sense). Needs a due_date.',
+                },
+                recurrence: {
+                    type: 'string',
+                    enum: ['none', 'daily', 'weekdays', 'weekly', 'monthly'],
+                    description: 'Recurrence if it repeats (default none).',
+                },
+                subtasks: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Optional checklist of subtask titles if the task naturally breaks into steps.',
+                },
+            },
+            required: ['title'],
+        },
+    };
+    async execute(_args, _context) {
+        // Normally bypassed — the host's confirmation handler creates the task (on
+        // Add) and returns the outcome. This fallback runs only if a surface has no
+        // task-suggestion bridge wired.
+        return { success: true, output: 'Task suggestion shown.' };
+    }
+}
+//# sourceMappingURL=task-suggest.js.map

package/dist/tools/task-suggest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-suggest.js","sourceRoot":"","sources":["../../src/tools/task-suggest.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,eAAe;IACjB,IAAI,GAAG,cAAc,CAAC;IACtB,WAAW,GAClB,qNAAqN,CAAC;IAC/M,SAAS,GAAkB,MAAM,CAAC;IAClC,oBAAoB,GAAG,IAAI,CAAC;IAE5B,MAAM,GAAmB;QAChC,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,wFAAwF;YACxF,oJAAoJ;YACpJ,wFAAwF;YACxF,mLAAmL;QACrL,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;gBAClE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oDAAoD,EAAE;gBAC3F,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;oBACzC,WAAW,EAAE,6BAA6B;iBAC3C;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0HAA0H;iBACxI;gBACD,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mEAAmE,EAAE;gBAC9G,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oEAAoE,EAAE;gBAC/G,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC;oBAC3C,WAAW,EAAE,6EAA6E;iBAC3F;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,CAAC;oBACxD,WAAW,EAAE,0CAA0C;iBACxD;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,+EAA+E;iBAC7F;aACF;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB;KACF,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,KAA8B,EAAE,QAA8B;QAC1E,2EAA2E;QAC3E,4EAA4E;QAC5E,gCAAgC;QAChC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC;IAC7D,CAAC;CACF"}

package/dist/tools/test-generate.d.ts

@@ -0,0 +1,20 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+export declare class TestGenerateTool implements Tool {
+    readonly name = "test_generate";
+    readonly description = "Generate test scaffolding for a source file using the detected test framework";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = true;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+    private extractJsSymbols;
+    private extractPythonSymbols;
+    private detectFramework;
+    private getFramework;
+    private buildTest;
+    private buildPytestFile;
+    private buildJsTestFile;
+    private resolveTestPath;
+    private findExistingTest;
+}
+//# sourceMappingURL=test-generate.d.ts.map

package/dist/tools/test-generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-generate.d.ts","sourceRoot":"","sources":["../../src/tools/test-generate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAc5D,qBAAa,gBAAiB,YAAW,IAAI;IAC3C,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,WAAW,mFAAmF;IACvG,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAW;IAC5C,QAAQ,CAAC,oBAAoB,QAAQ;IAErC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAyB7B;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;IAiFhG,OAAO,CAAC,gBAAgB;IAiBxB,OAAO,CAAC,oBAAoB;YAUd,eAAe;IAgB7B,OAAO,CAAC,YAAY;IAiCpB,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,eAAe;IAuBvB,OAAO,CAAC,eAAe;IAyBvB,OAAO,CAAC,eAAe;YAaT,gBAAgB;CAc/B"}