neuron-inspector 0.1.1 → 0.2.0

package/README.md

@@ -1,30 +1,32 @@
 # neuron-inspector
 
-**51 browser tools for AI agents.** Turn Chrome into an MCP-powered DevOps platform — inspect DOM, automate clicks, audit security, mock APIs, extract data, record demos — all from Claude Code, Cursor, Windsurf, or any MCP client.
+**51 browser tools for AI agents.** Your AI can't see your browser. This fixes that.
 
-```bash
-npx neuron-inspector
-```
+Inspect DOM, automate clicks, run JavaScript, search network traffic, audit security, check accessibility, scan SEO, mock APIs, extract structured data, record demos — all from Claude Code, Cursor, Windsurf, or any MCP client.
 
-## What this does
+No API keys. No cloud. Runs on localhost.
 
-Your AI agent can't see your browser. neuron-inspector fixes that.
+[![npm](https://img.shields.io/npm/v/neuron-inspector)](https://www.npmjs.com/package/neuron-inspector)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
-It bridges a Chrome extension to your AI coding tool via MCP (Model Context Protocol). Once connected, your agent gets 51 tools that let it read the DOM, click buttons, run JS, search network traffic, audit accessibility, scan for security leaks, mock API responses, extract structured data from any page, and more.
+```bash
+npx neuron-inspector
+```
 
-No API keys. No cloud. Runs entirely on localhost.
+---
 
-## Setup (2 minutes)
+## Get started
 
 ### 1. Install the Chrome extension
 
-Download from [neuron.ng/extension](https://neuron.ng/extension) and sideload it:
+Download from **[neuron.ng/extension](https://neuron.ng/extension)** and sideload:
 
-1. Extract the zip
-2. Open `chrome://extensions`, enable Developer Mode
-3. Click "Load unpacked" and select the folder
+1. Download and extract the zip
+2. Open `chrome://extensions` and enable **Developer Mode**
+3. Click **Load unpacked** and select the extracted folder
+4. The extension icon appears in your toolbar
 
-### 2. Register the MCP server
+### 2. Connect to your AI tool
 
 **Claude Code:**
 ```bash
@@ -55,9 +57,75 @@ claude mcp add neuron-inspector -- npx neuron-inspector
 }
 ```
 
-That's it. The extension auto-connects to the bridge on `ws://localhost:7377`.
+### 3. Use it
+
+Open any page in Chrome. Ask your AI agent to interact with it. Done.
+
+---
+
+## What you can do
+
+### Ask your agent to debug a page
+
+> "Why is this page slow?"
+
+The agent calls `neuron_perf_snapshot` and gets back Core Web Vitals, render-blocking scripts, memory usage, and the heaviest resources.
+
+> "Check this page for security issues"
+
+`neuron_security_scan` finds leaked API keys in inline scripts, missing CSP headers, mixed content, insecure forms, exposed source maps.
+
+> "Is this page accessible?"
+
+`neuron_a11y_audit` runs a WCAG audit — color contrast failures, missing alt text, broken heading hierarchy, unlabeled form fields.
+
+### Ask your agent to explore traffic
+
+> "What APIs is this SPA calling?"
+
+`neuron_discover_apis` maps every endpoint from observed traffic — call counts, status codes, auth patterns, response shapes.
+
+> "Search all network responses for 'user_id'"
+
+`neuron_search_traffic` does full-text search across every captured response body.
+
+> "Show me the network waterfall"
+
+`neuron_waterfall` gives DNS, TCP, TLS, TTFB timing per resource — the same view as DevTools Network, but in your agent's context.
+
+### Ask your agent to interact with the page
+
+> "Click the Sign Up button"
+
+`neuron_click` finds it by CSS selector or visible text and clicks it.
+
+> "Fill in the email field with test@example.com"
+
+`neuron_type` targets the input and types into it.
+
+> "Scroll down and extract all the product listings"
 
-## The 51 tools
+`neuron_scroll` + `neuron_extract_data` — scrolls the page and pulls structured data from repeating patterns (cards, tables, feeds).
+
+### Ask your agent to test edge cases
+
+> "Mock the payments API to return a 500 error"
+
+`neuron_set_mock` intercepts matching requests and returns your custom response. Test error states without touching the real backend.
+
+> "Take a snapshot, click submit, then tell me what changed"
+
+`neuron_snapshot_state` before, action, `neuron_diff_states` after — detects DOM changes, added/removed elements, URL changes.
+
+### Ask your agent to record and replay
+
+> "Record what I'm doing as a workflow"
+
+`neuron_start_recording` captures clicks, typing, and navigation. `neuron_start_demo` replays it as a polished video with chapter markers and cursor overlay.
+
+---
+
+## All 51 tools
 
 ### Inspect & Debug
 | Tool | What it does |
@@ -67,141 +135,132 @@ That's it. The extension auto-connects to the bridge on `ws://localhost:7377`.
 | `neuron_evaluate_js` | Run JavaScript in page context |
 | `neuron_get_logs` | Console logs filtered by level, tab, search |
 | `neuron_screenshot` | PNG screenshot of the visible area |
-| `neuron_diagnose` | Connection health — extension connected? Tabs open? |
+| `neuron_diagnose` | Connection health check |
 | `neuron_list_tabs` | Open tabs with platform detection |
 
 ### Browse & Automate
 | Tool | What it does |
 |------|-------------|
-| `neuron_click` | Click an element by selector or text |
+| `neuron_click` | Click by selector or text |
 | `neuron_type` | Type into inputs and contenteditable |
-| `neuron_scroll` | Scroll by pixels or scroll an element into view |
-| `neuron_navigate` | Navigate a tab to a URL |
+| `neuron_scroll` | Scroll by pixels or into view |
+| `neuron_navigate` | Navigate to a URL |
 | `neuron_open_tab` | Open a new tab |
 | `neuron_reload` | Reload a tab |
-| `neuron_run_sequence` | Execute a multi-step sequence (click, type, wait, eval) |
+| `neuron_run_sequence` | Multi-step automation (click, type, wait, eval) |
 
 ### Network Intelligence
 | Tool | What it does |
 |------|-------------|
-| `neuron_get_requests` | Query captured HTTP requests by tab, method, status, URL |
-| `neuron_get_errors` | Recent 4xx/5xx responses and console errors |
+| `neuron_get_requests` | Query HTTP requests by tab, method, status, URL |
+| `neuron_get_errors` | Recent 4xx/5xx and console errors |
 | `neuron_get_ws_frames` | WebSocket and SSE frame history |
-| `neuron_export_har` | Export traffic as HAR 1.2 |
-| `neuron_search_traffic` | Full-text search across all captured response bodies |
-| `neuron_discover_apis` | Auto-map API endpoints from observed traffic |
-| `neuron_replay_request` | Re-fire an HTTP request with the browser's live session |
-| `neuron_waterfall` | Network timing breakdown — DNS, TLS, TTFB per resource |
+| `neuron_export_har` | Export as HAR 1.2 |
+| `neuron_search_traffic` | Full-text search across response bodies |
+| `neuron_discover_apis` | Auto-map API endpoints from traffic |
+| `neuron_replay_request` | Re-fire a request with the browser's live session |
+| `neuron_waterfall` | DNS/TLS/TTFB timing per resource |
 
-### Security Scan
+### Security
 | Tool | What it does |
 |------|-------------|
-| `neuron_security_scan` | Scan for leaked secrets, missing headers, CORS issues, mixed content |
-| `neuron_check_auth` | Verify platform credentials are still valid |
+| `neuron_security_scan` | Leaked secrets, missing headers, CORS, mixed content |
+| `neuron_check_auth` | Verify platform credentials |
 | `neuron_detect_blocker` | Detect rate limits, captchas, login walls |
 
-### Quality Audits
+### Quality
 | Tool | What it does |
 |------|-------------|
-| `neuron_a11y_audit` | WCAG accessibility audit — contrast, labels, headings, tabindex |
-| `neuron_perf_snapshot` | Core Web Vitals, resource breakdown, memory, long tasks |
-| `neuron_seo_audit` | Title, meta, OG, headings, structured data, link ratio |
+| `neuron_a11y_audit` | WCAG audit — contrast, labels, headings, tabindex |
+| `neuron_perf_snapshot` | Core Web Vitals, resource breakdown, memory |
+| `neuron_seo_audit` | Meta, OG, headings, structured data, links |
 
 ### Network Mocking
 | Tool | What it does |
 |------|-------------|
-| `neuron_set_mock` | Intercept requests and return custom responses |
+| `neuron_set_mock` | Intercept requests, return custom responses |
 | `neuron_get_mocks` | List active mock rules |
 | `neuron_clear_mocks` | Remove all mocks |
 
 ### Cookies & Storage
 | Tool | What it does |
 |------|-------------|
-| `neuron_get_cookies` | Read all cookies for a URL |
+| `neuron_get_cookies` | Read cookies for a URL |
 | `neuron_set_cookie` | Set a cookie |
 | `neuron_delete_cookie` | Delete a cookie |
-| `neuron_get_storage` | Read localStorage or sessionStorage |
+| `neuron_get_storage` | Read localStorage / sessionStorage |
 | `neuron_clear_storage` | Clear storage |
 
 ### Page Monitoring
 | Tool | What it does |
 |------|-------------|
-| `neuron_snapshot_state` | Capture page state (DOM, visibility, text) for later diff |
-| `neuron_diff_states` | Compare two snapshots — detect what changed |
-| `neuron_watch_element` | Watch a selector for changes over time |
+| `neuron_snapshot_state` | Capture page state for later diff |
+| `neuron_diff_states` | Compare two snapshots |
+| `neuron_watch_element` | Watch a selector for changes |
 | `neuron_get_watches` | Check accumulated changes |
 | `neuron_stop_watch` | Stop watching |
-| `neuron_extract_data` | Extract structured data from repeating patterns (feeds, tables, listings) |
+| `neuron_extract_data` | Extract structured data from feeds, tables, listings |
 
 ### Demo Recording
 | Tool | What it does |
 |------|-------------|
-| `neuron_start_recording` | Record user interactions as a replayable workflow |
+| `neuron_start_recording` | Record interactions as a workflow |
 | `neuron_stop_recording` | Save the recording |
 | `neuron_list_workflows` | List saved workflows |
 | `neuron_start_replay` | Replay a workflow |
 | `neuron_stop_replay` | Stop replay |
-| `neuron_start_demo` | Record a demo video with chapters, captions, cursor overlay |
-| `neuron_workflow_status` | Current engine state |
+| `neuron_start_demo` | Record a demo video with chapters + cursor |
+| `neuron_workflow_status` | Engine state |
 
 ### Other
 | Tool | What it does |
 |------|-------------|
-| `neuron_trigger_post` | Trigger the IG post runner |
-| `neuron_session_diagnostics` | Agent session health — capture rate, stalls, auth, buffers |
+| `neuron_trigger_post` | Trigger the post runner |
+| `neuron_session_diagnostics` | Agent session health |
 
-## Examples
+---
 
-**"Why is this page slow?"**
-```
-→ neuron_perf_snapshot { tabId: 123 }
-← LCP: 3.2s, CLS: 0.04, 14 render-blocking scripts, heaviest: analytics.js (890KB)
-```
+## Recipes — purpose-built agents
 
-**"Check this page for security issues"**
-```
-→ neuron_security_scan { tabId: 123 }
-← 3 findings: API key leaked in inline script, missing CSP header, autocomplete on password field
-```
+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.
 
-**"What APIs is this SPA calling?"**
-```
-→ neuron_discover_apis {}
-← 12 endpoints: GET /api/users/{id} (called 8x), POST /api/auth/refresh (2x), ...
-```
+### Built-in recipes
 
-**"Extract all product listings from this page"**
-```
-→ neuron_extract_data { tabId: 123 }
-← 47 items: [{ text: "Nike Air Max", link: "/product/123", image: "...", price: "$129" }, ...]
-```
+| 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 |
 
-**"Mock the payments API to return a 500"**
-```
-→ neuron_set_mock { urlPattern: "*/api/payments*", responseStatus: 500, responseBody: "{\"error\":\"service down\"}" }
-← Mock rule active. All matching requests will return 500.
-```
+### How recipes work
 
-## How it works
+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).
 
-```
-┌─────────────┐     WebSocket      ┌──────────────────┐     stdio/MCP     ┌──────────────┐
-│   Chrome +   │ ←──────────────→  │  neuron-inspector │ ←──────────────→ │  Claude Code  │
-│  Extension   │   localhost:7377   │    (this pkg)     │                  │  / Cursor     │
-└─────────────┘                    └──────────────────┘                   └──────────────┘
-```
+**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.
 
-1. The Chrome extension captures network traffic, DOM state, and console logs in real time
-2. `neuron-inspector` runs as a local bridge — WebSocket server on port 7377 (extension connects here) + MCP server on stdio (your AI tool connects here)
-3. Your AI agent calls tools via MCP → the bridge forwards them to the extension → the extension executes in Chrome → results flow back
+### Build your own
 
-Everything runs on localhost. No data leaves your machine.
+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+
-- Chrome (or Chromium-based browser)
-- [Neuron extension](https://neuron.ng/extension) installed
+- Chrome or any Chromium browser
+- [Neuron extension](https://neuron.ng/extension)
+
+## Links
+
+- **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,169 @@
+/**
+ * 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";
+export const RECIPE_TOOLS = [
+    {
+        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_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,57 @@
+/**
+ * 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>;
+} | 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 {};