neuron-inspector 0.1.2 → 0.2.1

package/README.md

@@ -220,6 +220,36 @@ The agent calls `neuron_perf_snapshot` and gets back Core Web Vitals, render-blo
 
 ---
 
+## Recipes — purpose-built agents
+
+The 51 tools are primitives. A **recipe** turns them into a purpose-built agent — a QA engineer, a job applicant, a web researcher. Recipes are shareable, and they get better with every run.
+
+### Built-in recipes
+
+| Recipe | What it does |
+|--------|-------------|
+| **[Web Researcher](recipes/web-researcher/)** | Deep-dives into topics, cross-references sources, produces reports with citations |
+| **[Job Applicant](recipes/job-applicant/)** | Searches job boards, evaluates fit, writes cover letters, fills forms, tracks outcomes |
+| **[QA Engineer](recipes/qa-engineer/)** | Tests web apps — finds bugs, checks a11y, audits security, builds regression suites |
+
+### How recipes work
+
+A recipe is a folder with instructions (`agent.md`) and config (`recipe.yaml`). The instructions tell the AI *how* to use the browser tools for a specific purpose. The config declares variables you fill in (your resume, your target URL, your preferences).
+
+**Recipes are alive.** Each run captures outcomes to `memory/`. After enough runs, the agent reviews what worked and updates its own strategy in `learnings.md`. A job applicant that discovers technical-tone cover letters get 3x more responses will start writing technical-tone cover letters by default.
+
+**Recipes feed each other.** The web researcher produces reports that the job applicant reads to tailor cover letters. The QA engineer reads its own previous reports to re-check if old bugs are fixed. Output from one recipe is input to another.
+
+### Use a recipe
+
+Copy a recipe's `agent.md` into your project as a CLAUDE.md (or append it), fill in the `{{variables}}` from `recipe.yaml`, and run. The recipe tells your AI agent exactly how to use the 51 tools for that purpose.
+
+### Build your own
+
+See [RECIPE-SPEC.md](RECIPE-SPEC.md) for the full format. The core idea: write the instructions you'd give a skilled human, reference the tools by name, add reflect/evolve sections so the agent improves itself, and declare your variables so others can import and customize.
+
+---
+
 ## Requirements
 
 - Node.js 18+
@@ -230,6 +260,7 @@ The agent calls `neuron_perf_snapshot` and gets back Core Web Vitals, render-blo
 
 - **Extension download:** [neuron.ng/extension](https://neuron.ng/extension)
 - **npm:** [npmjs.com/package/neuron-inspector](https://www.npmjs.com/package/neuron-inspector)
+- **Recipe spec:** [RECIPE-SPEC.md](RECIPE-SPEC.md)
 
 ## License
 

package/dist/recipe-tools.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Recipe MCP tools — same ToolDef shape as browser tools so they register
+ * through the same mcp.tool() overload. Handled locally (no extension needed).
+ */
+import type { ToolDef } from "./tools.js";
+export declare const RECIPE_TOOLS: ToolDef[];
+/** Handle a recipe tool call locally (no extension needed). */
+export declare function handleRecipeTool(name: string, args: Record<string, unknown>): Promise<unknown>;

package/dist/recipe-tools.js

@@ -0,0 +1,259 @@
+/**
+ * Recipe MCP tools — same ToolDef shape as browser tools so they register
+ * through the same mcp.tool() overload. Handled locally (no extension needed).
+ */
+import * as recipes from "./recipes.js";
+/** Track the active recipe so neuron_recipe_complete knows what to log. */
+let activeRecipe = null;
+export const RECIPE_TOOLS = [
+    {
+        name: "neuron_recipe_run",
+        description: "Start a recipe run. Loads the recipe's agent.md with variables interpolated, its learnings, and resolved variables (auto-filled from profile). Returns everything the AI needs to execute the recipe. Call neuron_recipe_complete when done to auto-log the outcome to memory.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                slug: { type: "string", description: "Recipe slug (e.g. 'web-researcher', 'qa-engineer')" },
+                variables: { type: "object", description: "Variable overrides — keys matching recipe.yaml variable names. Merged on top of profile defaults." },
+            },
+            required: ["slug"],
+        },
+    },
+    {
+        name: "neuron_recipe_complete",
+        description: "End a recipe run started with neuron_recipe_run. Logs the outcome to the recipe's memory automatically. Provide the outcome data matching the recipe's Reflect section. If the recipe has 5+ memory entries, also return the learnings so the evolve phase can update strategy.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                outcome: { type: "object", description: "Run outcome — structure varies per recipe, see the Reflect section in agent.md" },
+                updated_learnings: { type: "string", description: "If you ran the evolve phase, provide the updated learnings.md content here to persist it" },
+            },
+            required: ["outcome"],
+        },
+    },
+    {
+        name: "neuron_recipe_list",
+        description: "List all available recipes (bundled + user-installed). Shows name, description, whether it has accumulated learnings, and run count.",
+        inputSchema: { type: "object", properties: {} },
+    },
+    {
+        name: "neuron_recipe_get",
+        description: "Get a recipe's full contents — agent instructions (agent.md), configuration (recipe.yaml), accumulated learnings, and variable definitions. Use this to understand what a recipe does before running it.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                slug: { type: "string", description: "Recipe slug (e.g. 'web-researcher', 'qa-engineer')" },
+            },
+            required: ["slug"],
+        },
+    },
+    {
+        name: "neuron_recipe_create",
+        description: "Create a new recipe from scratch. Provide the slug, name, description, agent instructions (agent.md content with Strategy/Reflect/Evolve sections), and configuration (recipe.yaml content with variables/tools/pipes/limits). Saved to ~/.neuron/recipes/<slug>/.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                slug: { type: "string", description: "URL-safe identifier (e.g. 'grant-scraper')" },
+                name: { type: "string", description: "Display name" },
+                description: { type: "string", description: "One-line description" },
+                agent_md: { type: "string", description: "Full agent.md content — strategy, reflect, evolve sections" },
+                recipe_yaml: { type: "string", description: "Full recipe.yaml content — variables, tools, pipes, limits" },
+            },
+            required: ["slug", "name", "description", "agent_md", "recipe_yaml"],
+        },
+    },
+    {
+        name: "neuron_recipe_update",
+        description: "Update a recipe's agent instructions, learnings, or configuration. If updating a bundled recipe, it's forked to ~/.neuron/recipes/ first. Use this after the evolve phase to persist improved strategy.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                slug: { type: "string", description: "Recipe slug" },
+                agent_md: { type: "string", description: "Updated agent.md content" },
+                learnings: { type: "string", description: "Updated learnings.md content" },
+                recipe_yaml: { type: "string", description: "Updated recipe.yaml content" },
+            },
+            required: ["slug"],
+        },
+    },
+    {
+        name: "neuron_recipe_log",
+        description: "Log a run outcome to a recipe's memory. Each entry captures what happened — success/failure, sources found, dead ends, quality score. The recipe's evolve phase reads these to improve its strategy.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                slug: { type: "string", description: "Recipe slug" },
+                entry: { type: "object", description: "Run outcome data — structure varies per recipe, see the Reflect section in agent.md" },
+            },
+            required: ["slug", "entry"],
+        },
+    },
+    {
+        name: "neuron_recipe_memory",
+        description: "Read a recipe's run history — the outcomes captured by neuron_recipe_log. Returns the most recent entries. Use during the evolve phase to analyze what's working and what's not.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                slug: { type: "string", description: "Recipe slug" },
+                limit: { type: "number", description: "Max entries to return (default: 20)" },
+            },
+            required: ["slug"],
+        },
+    },
+    {
+        name: "neuron_recipe_import",
+        description: "Import a recipe from GitHub or a local path. GitHub: 'github:user/repo' imports all recipes from the repo's recipes/ subdir. Local: absolute path to a folder with recipe.yaml. Saved to ~/.neuron/recipes/. Memory is stripped on import (local-only).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                source: { type: "string", description: "GitHub repo (github:user/repo) or absolute local path to recipe folder" },
+            },
+            required: ["source"],
+        },
+    },
+    {
+        name: "neuron_recipe_export",
+        description: "Export a recipe's shareable contents — agent.md, recipe.yaml, and optionally learnings. The recipient imports this with neuron_recipe_import. Memory (run history) is never exported.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                slug: { type: "string", description: "Recipe slug" },
+                include_learnings: { type: "boolean", description: "Include accumulated learnings (default: true)" },
+            },
+            required: ["slug"],
+        },
+    },
+    {
+        name: "neuron_recipe_delete",
+        description: "Delete a user-installed recipe and all its memory/learnings. Bundled recipes cannot be deleted.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                slug: { type: "string", description: "Recipe slug to delete" },
+            },
+            required: ["slug"],
+        },
+    },
+    {
+        name: "neuron_profile_get",
+        description: "Read the user's profile (~/.neuron/profile.yaml). Profiles auto-fill recipe variables — name, email, location, tone, timezone, etc.",
+        inputSchema: { type: "object", properties: {} },
+    },
+    {
+        name: "neuron_profile_save",
+        description: "Save or update the user's profile (~/.neuron/profile.yaml). Common fields: name, email, location, timezone, tone, linkedin, github. Recipe variables with matching keys are auto-filled from this profile.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                data: { type: "object", description: "Profile key-value pairs (e.g. {name: 'Jane', email: 'jane@co.com', timezone: 'US/Eastern'})" },
+            },
+            required: ["data"],
+        },
+    },
+];
+/** Handle a recipe tool call locally (no extension needed). */
+export async function handleRecipeTool(name, args) {
+    switch (name) {
+        case "neuron_recipe_run": {
+            const slug = args.slug;
+            const recipe = recipes.getRecipe(slug);
+            if (!recipe)
+                throw new Error(`Recipe "${slug}" not found.`);
+            // Merge user-provided variables on top of profile-resolved defaults
+            const userVars = args.variables ?? {};
+            const resolved = { ...recipe.resolved_variables, ...userVars };
+            // Interpolate variables into agent.md
+            let instructions = recipe.agent_md;
+            for (const [key, value] of Object.entries(resolved)) {
+                instructions = instructions.replaceAll(`{{${key}}}`, String(value ?? ""));
+            }
+            // Track active run
+            activeRecipe = { slug, startedAt: new Date().toISOString(), variables: resolved };
+            // Get memory stats for evolve hint
+            const memory = recipes.getMemory(slug, 1);
+            const shouldEvolve = memory.total >= 5;
+            return {
+                recipe: recipe.meta.name,
+                slug,
+                instructions,
+                learnings: recipe.learnings,
+                resolved_variables: resolved,
+                unfilled_variables: Object.entries(recipe.variables)
+                    .filter(([key]) => !(key in resolved) || resolved[key] === undefined || resolved[key] === "")
+                    .map(([key, def]) => ({ key, ...def })),
+                memory_count: memory.total,
+                evolve_hint: shouldEvolve
+                    ? `This recipe has ${memory.total} past runs. After completing this run, read memory with neuron_recipe_memory, analyze patterns, and update learnings with neuron_recipe_complete (include updated_learnings).`
+                    : null,
+                pipes: recipe.recipe_yaml.includes("inputs:")
+                    ? "This recipe has input pipes — check resolved_variables for data from other recipes."
+                    : null,
+            };
+        }
+        case "neuron_recipe_complete": {
+            if (!activeRecipe)
+                throw new Error("No active recipe run. Call neuron_recipe_run first.");
+            const { slug, startedAt, variables } = activeRecipe;
+            const outcome = args.outcome ?? {};
+            // Auto-log memory
+            const entry = {
+                started_at: startedAt,
+                completed_at: new Date().toISOString(),
+                variables_used: variables,
+                ...outcome,
+            };
+            const memResult = recipes.logMemory(slug, entry);
+            // Persist updated learnings if provided (evolve phase)
+            const updatedLearnings = args.updated_learnings;
+            if (updatedLearnings) {
+                recipes.updateRecipe(slug, { learnings: updatedLearnings });
+            }
+            // Get updated memory count
+            const memory = recipes.getMemory(slug, 1);
+            activeRecipe = null;
+            return {
+                logged_to: memResult.path,
+                total_runs: memory.total,
+                learnings_updated: !!updatedLearnings,
+                next_evolve_at: memory.total < 5 ? `${5 - memory.total} more runs until first evolve` : "Ready to evolve — review memory and update learnings on next run",
+            };
+        }
+        case "neuron_recipe_list":
+            return recipes.listRecipes();
+        case "neuron_recipe_get": {
+            const result = recipes.getRecipe(args.slug);
+            if (!result)
+                throw new Error(`Recipe "${args.slug}" not found.`);
+            return result;
+        }
+        case "neuron_recipe_create":
+            return recipes.createRecipe(args.slug, args.name, args.description, args.agent_md, args.recipe_yaml);
+        case "neuron_recipe_update":
+            return recipes.updateRecipe(args.slug, {
+                agent_md: args.agent_md,
+                learnings: args.learnings,
+                recipe_yaml: args.recipe_yaml,
+            });
+        case "neuron_recipe_log":
+            return recipes.logMemory(args.slug, args.entry);
+        case "neuron_recipe_memory":
+            return recipes.getMemory(args.slug, args.limit || 20);
+        case "neuron_recipe_import":
+            return recipes.importRecipe(args.source);
+        case "neuron_recipe_export":
+            return recipes.exportRecipe(args.slug, args.include_learnings ?? true);
+        case "neuron_recipe_delete":
+            recipes.deleteRecipe(args.slug);
+            return { deleted: args.slug };
+        case "neuron_profile_get": {
+            const profile = recipes.getProfile();
+            if (!profile)
+                return { message: "No profile found. Create one with neuron_profile_save." };
+            return profile;
+        }
+        case "neuron_profile_save":
+            return recipes.saveProfile(args.data);
+        default:
+            throw new Error(`Unknown recipe tool: ${name}`);
+    }
+}
+//# sourceMappingURL=recipe-tools.js.map

package/dist/recipe-tools.js.map

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

package/dist/recipes.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Recipe manager — list, read, create, import, export, and log memory
+ * for self-improving agent recipes. All file operations are local.
+ */
+interface RecipeSummary {
+    name: string;
+    slug: string;
+    version: string;
+    description: string;
+    author: string;
+    tags: string[];
+    location: "bundled" | "user";
+    path: string;
+    has_learnings: boolean;
+    has_memory: boolean;
+    memory_count: number;
+}
+export declare function listRecipes(): RecipeSummary[];
+export declare function getRecipe(slug: string): {
+    meta: RecipeSummary;
+    agent_md: string;
+    recipe_yaml: string;
+    learnings: string | null;
+    variables: Record<string, unknown>;
+    profile: Record<string, unknown> | null;
+    resolved_variables: Record<string, unknown>;
+} | null;
+export declare function createRecipe(slug: string, name: string, description: string, agentMd: string, recipeYaml: string): {
+    path: string;
+};
+export declare function updateRecipe(slug: string, updates: {
+    agent_md?: string;
+    learnings?: string;
+    recipe_yaml?: string;
+}): {
+    path: string;
+};
+export declare function logMemory(slug: string, entry: Record<string, unknown>): {
+    path: string;
+};
+export declare function getMemory(slug: string, limit?: number): {
+    entries: Record<string, unknown>[];
+    total: number;
+};
+export declare function importRecipe(source: string): {
+    slug: string;
+    path: string;
+};
+export declare function exportRecipe(slug: string, includeLearnings?: boolean): {
+    agent_md: string;
+    recipe_yaml: string;
+    learnings: string | null;
+};
+export declare function deleteRecipe(slug: string): void;
+export declare function getProfile(): Record<string, unknown> | null;
+export declare function saveProfile(data: Record<string, string>): {
+    path: string;
+};
+export {};