@project-ava-supernova/core 0.2.71

package/dist/tools/propose-hooks.js

@@ -0,0 +1,71 @@
+/**
+ * Offer the operator 2–3 candidate opening hooks BEFORE writing the full post.
+ * Side-effect-free: validate + hand the proposal to the surface-injected
+ * `hookStore`, which the surface renders as a picker. Then Ava WAITS for the
+ * operator to choose (the persona rule) — unless they delegated the call.
+ */
+export class ProposeHooksTool {
+    name = 'propose_hooks';
+    description = 'Offer the operator 2-3 candidate opening hooks to choose from before writing the full post. Then WAIT — do not write_post in the same turn unless the operator delegated the choice.';
+    riskLevel = 'safe';
+    requiresConfirmation = false;
+    schema = {
+        name: 'propose_hooks',
+        description: 'Offer the operator 2-3 candidate opening hooks to choose from BEFORE writing the full post. Call this after research_post when starting a NEW post from a subject/brief — the hook decides whether the post lands, so the operator picks the angle first. Then WAIT: do not call write_post in the same turn. When the operator replies with their chosen hook, build the body around it. Skip this only for follow-ups (cross-posting existing content, rewrites), when the operator already gave you the exact hook/wording, delegated the choice ("you decide"), or for trivial banter.',
+        parameters: {
+            type: 'object',
+            properties: {
+                subject: { type: 'string', description: 'The subject the hooks are for — echoed back so the follow-up turn has context.' },
+                platform: { type: 'string', description: 'Target platform for the eventual post (tweet, linkedin, etc.).' },
+                hooks: {
+                    type: 'array',
+                    description: '2-3 candidate opening lines, each with a one-line angle/rationale.',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            hook: { type: 'string', description: 'The opening line itself — sharp, specific, scroll-stopping.' },
+                            angle: { type: 'string', description: 'One line on why this hook works / what angle it takes (e.g. "contrarian", "curiosity gap", "stat shock").' },
+                        },
+                        required: ['hook', 'angle'],
+                    },
+                },
+            },
+            required: ['hooks'],
+        },
+    };
+    async execute(args, context) {
+        const store = context.sharedState?.hookStore;
+        if (!store) {
+            return {
+                success: false,
+                output: 'Hook proposal is not available in this context. The host must inject `hookStore` into shared state.',
+            };
+        }
+        const rawHooks = Array.isArray(args.hooks) ? args.hooks : [];
+        const hooks = rawHooks
+            .map((h) => {
+            const o = (h && typeof h === 'object') ? h : {};
+            return { hook: String(o.hook || '').trim(), angle: String(o.angle || '').trim() || null };
+        })
+            .filter(h => h.hook)
+            .slice(0, 3);
+        if (hooks.length === 0) {
+            return { success: false, output: 'propose_hooks requires at least one hook.' };
+        }
+        const subject = (args.subject?.trim()) || '';
+        const platform = (args.platform?.trim()) || 'tweet';
+        try {
+            await store.propose({ subject, platform, hooks });
+            return {
+                success: true,
+                output: `Proposed ${hooks.length} hook${hooks.length === 1 ? '' : 's'} for the operator to pick — WAIT for their choice before writing (unless they told you to decide).`,
+                metadata: { count: hooks.length, subject, platform },
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { success: false, output: `Failed to propose hooks: ${msg}` };
+        }
+    }
+}
+//# sourceMappingURL=propose-hooks.js.map

package/dist/tools/propose-hooks.js.map

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

package/dist/tools/propose-tool.d.ts

@@ -0,0 +1,11 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+export declare class ProposeToolTool implements Tool {
+    readonly name = "propose_tool";
+    readonly description = "Propose a new tool when you hit a capability gap \u2014 something you should be able to do but can't. The proposal is reviewed by the development team and may be built. Include: what the tool would do, why it's needed, and example use cases. This is how Ava evolves.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = true;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=propose-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"propose-tool.d.ts","sourceRoot":"","sources":["../../src/tools/propose-tool.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,qBAAa,eAAgB,YAAW,IAAI;IAC1C,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,WAAW,gRAA6Q;IACjS,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAW;IAC5C,QAAQ,CAAC,oBAAoB,QAAQ;IAErC,QAAQ,CAAC,MAAM,EAAE,cAAc,CA2D7B;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;CAmHjG"}

package/dist/tools/propose-tool.js

@@ -0,0 +1,155 @@
+export class ProposeToolTool {
+    name = 'propose_tool';
+    description = 'Propose a new tool when you hit a capability gap — something you should be able to do but can\'t. The proposal is reviewed by the development team and may be built. Include: what the tool would do, why it\'s needed, and example use cases. This is how Ava evolves.';
+    riskLevel = 'write';
+    requiresConfirmation = true;
+    schema = {
+        name: 'propose_tool',
+        description: 'Propose a new tool when you identify a capability gap — something you need to accomplish the ' +
+            'user\'s task but cannot do with existing tools. The proposal is sent to the Ava development team ' +
+            'for review. The user who triggered this proposal may receive bonus tokens as a reward. ' +
+            'You MUST explain to the user what you\'re proposing and why before invoking this tool. ' +
+            'Only propose tools that would be genuinely useful and reusable — not one-off workarounds.',
+        parameters: {
+            type: 'object',
+            properties: {
+                email: {
+                    type: 'string',
+                    description: 'The user\'s email address (for crediting the proposal). Ask the user if not known.',
+                },
+                name: {
+                    type: 'string',
+                    description: 'The user\'s name (optional, for crediting).',
+                },
+                tool_name: {
+                    type: 'string',
+                    description: 'A snake_case name for the proposed tool (e.g. "docker_exec", "slack_send", "pdf_read"). ' +
+                        'Keep it consistent with existing tool naming conventions.',
+                },
+                description: {
+                    type: 'string',
+                    description: 'What the tool does — a clear, concise description suitable for an LLM tool description. ' +
+                        'Max 2,000 characters.',
+                },
+                proposed_schema: {
+                    type: 'object',
+                    description: 'The proposed JSON Schema for the tool\'s parameters. Follow the same structure as ' +
+                        'existing tools: { type: "object", properties: { ... }, required: [...] }.',
+                },
+                risk_level: {
+                    type: 'string',
+                    enum: ['safe', 'write', 'dangerous'],
+                    description: 'Proposed risk level. "safe" = read-only, "write" = modifies files/state, ' +
+                        '"dangerous" = arbitrary system commands or destructive potential.',
+                },
+                justification: {
+                    type: 'string',
+                    description: 'Why this tool is needed — what you were trying to do, what existing tools fall short, ' +
+                        'and how this tool would help. Be specific about the gap. Max 5,000 characters.',
+                },
+                task_context: {
+                    type: 'string',
+                    description: 'Brief description of what the user was working on when you identified this gap (optional).',
+                },
+            },
+            required: ['tool_name', 'description', 'risk_level', 'justification'],
+        },
+    };
+    async execute(args, context) {
+        const email = args.email?.trim();
+        const name = args.name?.trim() || undefined;
+        const toolName = args.tool_name?.trim();
+        const description = args.description?.trim();
+        const proposedSchema = args.proposed_schema || {};
+        const riskLevel = args.risk_level;
+        const justification = args.justification?.trim();
+        const taskContext = args.task_context?.trim() || undefined;
+        // Email is OPTIONAL. It exists so an end user can be credited and replied
+        // to — but the operator running this in their own hub IS the dev team, and
+        // demanding their address to propose a tool to themselves blocked the call
+        // outright. Record it uncredited rather than refusing to file the gap.
+        if (email && !email.includes('@')) {
+            return { success: false, output: 'That does not look like a valid email address. Leave it out to file the proposal uncredited.' };
+        }
+        if (!toolName) {
+            return { success: false, output: 'Tool name is required.' };
+        }
+        if (!/^[a-z][a-z0-9_]*$/.test(toolName)) {
+            return { success: false, output: 'Tool name must be snake_case (lowercase letters, numbers, underscores).' };
+        }
+        if (toolName.length > 100) {
+            return { success: false, output: 'Tool name must be 100 characters or fewer.' };
+        }
+        if (!description) {
+            return { success: false, output: 'Description is required.' };
+        }
+        if (description.length > 2000) {
+            return { success: false, output: 'Description must be 2,000 characters or fewer.' };
+        }
+        if (!justification) {
+            return { success: false, output: 'Justification is required.' };
+        }
+        if (justification.length > 5000) {
+            return { success: false, output: 'Justification must be 5,000 characters or fewer.' };
+        }
+        if (!['safe', 'write', 'dangerous'].includes(riskLevel)) {
+            return { success: false, output: 'Risk level must be one of: safe, write, dangerous.' };
+        }
+        // Get the API base URL
+        const apiBase = context.sharedState?.platformApiBase || 'https://avasupernova.com';
+        const platformKey = context.sharedState?.platformKey;
+        try {
+            const headers = {
+                'Content-Type': 'application/json',
+            };
+            if (platformKey) {
+                headers['Authorization'] = `Bearer ${platformKey}`;
+            }
+            const response = await fetch(`${apiBase}/api/tool-proposals`, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify({
+                    email,
+                    name,
+                    tool_name: toolName,
+                    description,
+                    proposed_schema: proposedSchema,
+                    risk_level: riskLevel,
+                    justification,
+                    task_context: taskContext,
+                }),
+            });
+            if (!response.ok) {
+                const errorData = await response.json().catch(() => ({}));
+                const errorMsg = errorData.error || `HTTP ${response.status}`;
+                return { success: false, output: `Failed to submit tool proposal: ${errorMsg}` };
+            }
+            const result = await response.json();
+            if (result.duplicate) {
+                return {
+                    success: true,
+                    output: `This tool ("${toolName}") has already been proposed by another user! ` +
+                        `Your vote has been recorded (now ${result.vote_count} votes). ` +
+                        `The more users who need this tool, the higher priority it gets. ` +
+                        `The user who triggered this will be credited if the tool is implemented.`,
+                };
+            }
+            const proposalId = result.id?.slice(0, 8) || 'unknown';
+            return {
+                success: true,
+                output: `Tool proposal submitted successfully (ID: ${proposalId}).\n\n` +
+                    `**Proposed tool:** \`${toolName}\`\n` +
+                    `**Risk level:** ${riskLevel}\n` +
+                    `**Status:** Pending review\n\n` +
+                    `The Ava development team will review this proposal. ` +
+                    `If approved and implemented, ${email} will receive bonus tokens as a thank-you. ` +
+                    `You can track proposals at ${apiBase}/dashboard.`,
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            return { success: false, output: `Failed to submit tool proposal: ${msg}` };
+        }
+    }
+}
+//# sourceMappingURL=propose-tool.js.map

package/dist/tools/propose-tool.js.map

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

package/dist/tools/recipe-repair.d.ts

@@ -0,0 +1,116 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+/**
+ * read_recipe — see the recipe before repairing it.
+ *
+ * The fix for blind repair. Working from the check findings alone, Ava cannot
+ * tell a genuinely missing ingredient from one that is already there under
+ * another name or another language ("flour" missing, when the list says
+ * "harina"). The deterministic check cannot bridge that; Ava can, but only if
+ * she can SEE the actual list. So: read first, then repair.
+ */
+export declare class ReadRecipeTool implements Tool {
+    readonly name = "read_recipe";
+    readonly description = "Read an existing recipe by id \u2014 its full shopping list (shared and per skill level) and its method. Do this BEFORE repairing, so you can tell a truly missing ingredient from one already listed under another name or language. Read-only.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+/**
+ * find_recipe — does this dish already exist?
+ *
+ * The check that stops duplication before it starts. Before writing a dish, Ava
+ * searches. If it already exists as the same dish, she associates the new
+ * cuisine rather than making a second copy; if it is a genuine variant (fava vs
+ * chickpea falafel), she writes a distinct one. And when a search turns up two
+ * of the same, she can propose a merge. Read-only — it finds, it never changes
+ * anything, and it never merges: the merge is the operator's click, not hers.
+ */
+export declare class FindRecipeTool implements Tool {
+    readonly name = "find_recipe";
+    readonly description = "Search existing recipes by dish name BEFORE writing a new one. Returns matches with the cuisines each belongs to. If the dish already exists as the same dish, associate the cuisine instead of duplicating; if it is a genuine regional variant, write a distinct recipe. Read-only.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+/**
+ * add_ingredient — the targeted repair.
+ *
+ * This is the tool the whole "repair, don't re-roll" doctrine rests on. When a
+ * recipe's method uses garlic and the list has none, the fix is to add garlic —
+ * one line — not to regenerate the entire dish and gamble on the next roll being
+ * clean. A full regeneration is a fresh recipe with fresh gaps; this is a needle
+ * and thread.
+ */
+/** Re-shoot a hero that came from a superseded engine. Part of a repair, not a
+ *  question to put to the operator — a recipe carrying a visibly older picture
+ *  is half-fixed. */
+export declare class RegenerateHeroTool implements Tool {
+    readonly name = "regenerate_hero";
+    readonly description = "Re-shoot a recipe's hero photograph on the current image engine. Use it when read_recipe reports the hero is outdated, or when the recipe has none.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+/** The nutrition repair. Separate from add_ingredient because a missing figure
+ *  is not a missing ingredient — the dish is cookable, the meal plan just can't
+ *  count it. */
+export declare class SetNutritionTool implements Tool {
+    readonly name = "set_nutrition";
+    readonly description = "Fill in one version's per-serving nutrition on an existing recipe. Use it when read_recipe shows a version has none.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+export declare class AddIngredientTool implements Tool {
+    readonly name = "add_ingredient";
+    readonly description = "Add ONE missing or level-specific ingredient to an existing recipe \u2014 the targeted fix for a shopping-list gap. Use this to repair a check failure; do NOT regenerate the whole recipe to chase away a single missing item.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+/**
+ * check_recipe — run the shopping-list check on an existing recipe and get back
+ * exactly what is missing. The read-only counterpart to write_recipe's built-in
+ * check, for auditing or confirming a repair.
+ */
+export declare class CheckRecipeTool implements Tool {
+    readonly name = "check_recipe";
+    readonly description = "Run the shopping-list check on an existing recipe by id. Returns pass, or the ingredients each version's method names but its list is missing. Read-only.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+/**
+ * revise_section — regenerate ONE part of an existing recipe without touching
+ * the rest. For when a whole part is genuinely wrong, not to chase a single
+ * missing ingredient (that is add_ingredient's job).
+ */
+export declare class ReviseSectionTool implements Tool {
+    readonly name = "revise_section";
+    readonly description = "Regenerate ONE part of an existing recipe \u2014 the overview, the ingredients, or one skill level's steps \u2014 leaving everything else untouched. Use when a whole part is wrong. For a single missing ingredient, use add_ingredient instead.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+/**
+ * propose_seeds — find the gaps in a region or collection, each with a reason.
+ * The recipe desk's equivalent of suggest_stories: the selection is the skill,
+ * and the operator is owed the reason, not just a list of names.
+ */
+export declare class ProposeSeedsTool implements Tool {
+    readonly name = "propose_seeds";
+    readonly description = "Propose dishes worth adding to a region or a curated collection \u2014 the honest gaps, each with why it belongs. The catalogue-planning tool.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=recipe-repair.d.ts.map

package/dist/tools/recipe-repair.d.ts.map

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