@polpo-ai/dashboard 0.15.11 → 0.15.13

package/dist/v2/support/tool-catalog.js

@@ -0,0 +1,271 @@
+/**
+ * Static catalog of agent runtime tools (the strings used in an agent's
+ * `allowedTools`). Mirrors the `@polpo-ai/tools` package so the dashboard
+ * can show the FULL catalog — not just what a given agent has enabled —
+ * with human-readable descriptions and per-category metadata.
+ *
+ * Descriptions are taken from the tool definitions in @polpo-ai/tools.
+ * Keep in sync when the package adds/changes tools. (A future
+ * GET /v1/tools endpoint will replace this — see todo-tools-catalog-endpoint.)
+ *
+ * `core: true`  → always available, cannot be disabled (no allowedTools entry needed).
+ * `requiresKey` → needs an external credential (vault entry, env var, or managed Connection) to run.
+ */
+export const TOOL_CATALOG = [
+    {
+        key: "core",
+        label: "Core",
+        icon: "ShieldCheck",
+        core: true,
+        note: "Always on for every agent — vault access and task outcomes. Cannot be disabled.",
+        tools: [
+            { name: "vault_get", description: "Retrieve credentials for a service from the agent vault." },
+            { name: "vault_list", description: "List available vault services (names + key names, no values)." },
+            { name: "register_outcome", description: "Register a file, text, URL or data as a task deliverable — the only way to declare outcomes. Task runs only." },
+        ],
+    },
+    {
+        key: "fs",
+        label: "Coding",
+        icon: "Terminal",
+        baseline: true,
+        note: "Read/write files and run shell commands. On by default — turn tools off to sandbox the agent. (Once you customise tools, only the ones left on here stay available.)",
+        tools: [
+            { name: "read", description: "Read the contents of a file. Returns line-numbered text; supports offset/limit for large files." },
+            { name: "write", description: "Create or overwrite a file. Parent directories are created automatically." },
+            { name: "edit", description: "Replace a unique string in a file. The old text must appear exactly once." },
+            { name: "bash", description: "Execute a shell command and return its output — tests, packages, git, etc." },
+            { name: "glob", description: "Find files matching a glob pattern (**, *, ?, [abc], {a,b})." },
+            { name: "grep", description: "Search files for a regex pattern (PCRE). Returns matching lines with paths + line numbers." },
+            { name: "ls", description: "List files and directories at a given path." },
+        ],
+    },
+    {
+        key: "http_",
+        label: "HTTP",
+        icon: "Globe",
+        baseline: true,
+        note: "Outbound HTTP — fetch URLs and download files. SSRF-protected. On by default.",
+        tools: [
+            { name: "http_fetch", description: "Make an HTTP request (any method, headers, body). Returns status, headers and body. SSRF-protected." },
+            { name: "http_download", description: "Download a file from a URL and save it locally." },
+        ],
+    },
+    {
+        key: "browser_",
+        label: "Browser",
+        icon: "Globe",
+        note: "Browser automation via the agent-browser runtime. Set a browser profile on the agent to persist cookies and localStorage across runs.",
+        tools: [
+            { name: "browser_navigate", description: "Open a URL in the browser. Launches it if not running." },
+            { name: "browser_snapshot", description: "Get the accessibility tree with element refs (@e1, @e2) for reliable targeting." },
+            { name: "browser_click", description: "Click an element. Use refs from a snapshot." },
+            { name: "browser_fill", description: "Clear an input and type new text." },
+            { name: "browser_type", description: "Type text into an element without clearing it first." },
+            { name: "browser_press", description: "Press a keyboard key, including modifiers (Control+a, Shift+Enter)." },
+            { name: "browser_screenshot", description: "Screenshot the current page. Returns the saved image path." },
+            { name: "browser_get", description: "Read element text/html/value, page title, or current URL." },
+            { name: "browser_select", description: "Select an option from a <select> dropdown." },
+            { name: "browser_hover", description: "Hover an element to trigger tooltips or menus." },
+            { name: "browser_scroll", description: "Scroll the page to load lazy content or navigate." },
+            { name: "browser_wait", description: "Wait for an element, text, URL pattern, or load state." },
+            { name: "browser_eval", description: "Run JavaScript in the page context and return the result." },
+            { name: "browser_close", description: "Close the browser session (profile data is saved)." },
+            { name: "browser_back", description: "Navigate back in browser history." },
+            { name: "browser_forward", description: "Navigate forward in browser history." },
+            { name: "browser_reload", description: "Reload the current page." },
+            { name: "browser_tabs", description: "Manage tabs: list, open, switch, or close." },
+        ],
+    },
+    {
+        key: "image_",
+        label: "Image",
+        icon: "Image",
+        note: "Image generation + vision analysis — runs through the managed gateway, no key needed.",
+        tools: [
+            { name: "image_generate", description: "Generate an image from a text prompt. Model from agent.image_model (default fal/flux/dev)." },
+            { name: "image_analyze", description: "Analyze an image with a vision model — describe, OCR, answer questions. Model from agent.vision_model." },
+        ],
+    },
+    {
+        key: "video_",
+        label: "Video",
+        icon: "Video",
+        note: "Video generation — runs through the managed gateway, no key needed.",
+        tools: [
+            { name: "video_generate", description: "Generate a video from a text prompt (MP4). Model from agent.video_model (default luma-ray-2-flash)." },
+        ],
+    },
+    {
+        key: "audio_",
+        label: "Audio",
+        icon: "Volume2",
+        note: "Speech-to-text + text-to-speech — runs through the managed gateway (Edge TTS is free).",
+        tools: [
+            { name: "audio_transcribe", description: "Transcribe an audio file to text. Model from agent.transcribe_model (default whisper-1)." },
+            { name: "audio_speak", description: "Synthesize speech from text. Model from agent.tts_model (default tts-1; edge is free, no key)." },
+        ],
+    },
+    {
+        key: "search_",
+        label: "Search",
+        icon: "Search",
+        note: "Managed web search — runs through the platform (Perplexity via the AI Gateway). No key required.",
+        tools: [
+            { name: "search_web", description: "Search the web with natural-language queries. Returns titles, URLs and snippets." },
+            { name: "search_find_similar", description: "Find web pages similar to a given URL — alternatives, competitors, related resources." },
+        ],
+    },
+    {
+        key: "email_",
+        label: "Email",
+        icon: "Mail",
+        requiresKey: true,
+        note: "SMTP/IMAP email. Needs mail server credentials.",
+        tools: [
+            { name: "email_send", description: "Send an email via SMTP. HTML, to/cc/bcc, attachments, reply-to. Domain allowlist enforced." },
+            { name: "email_draft", description: "Create a draft by appending a composed message to the IMAP Drafts folder." },
+            { name: "email_list", description: "List recent emails from a folder — subject, from, date, UID." },
+            { name: "email_read", description: "Read a full email by UID — headers, body, attachment metadata." },
+            { name: "email_search", description: "Search the mailbox for messages matching a query." },
+            { name: "email_download_attachment", description: "Download a specific attachment from a message to the output directory." },
+            { name: "email_verify", description: "Verify SMTP credentials / connectivity before sending." },
+            { name: "email_count", description: "Count messages in a mailbox folder." },
+        ],
+    },
+    {
+        key: "excel_",
+        label: "Spreadsheet",
+        icon: "Sheet",
+        note: "Spreadsheet (.xlsx / CSV) read + write.",
+        tools: [
+            { name: "excel_read", description: "Read rows from an Excel/CSV file with column headers. Supports sheet + range." },
+            { name: "excel_write", description: "Write structured rows to an Excel/CSV file." },
+            { name: "excel_query", description: "Query a spreadsheet with filters/aggregations and return matching rows." },
+            { name: "excel_info", description: "Inspect a workbook — sheets, dimensions, column headers." },
+        ],
+    },
+    {
+        key: "pdf_",
+        label: "PDF",
+        icon: "FileText",
+        note: "PDF read, create (HTML→PDF), merge.",
+        tools: [
+            { name: "pdf_read", description: "Extract text from a PDF — all or specific pages." },
+            { name: "pdf_create", description: "Render a full HTML document to a professional PDF via Chromium (full CSS support)." },
+            { name: "pdf_merge", description: "Merge multiple PDFs into a single document." },
+            { name: "pdf_info", description: "Inspect a PDF — page count and metadata." },
+        ],
+    },
+    {
+        key: "docx_",
+        label: "Docs",
+        icon: "FileType",
+        note: "Word document (.docx) read + create.",
+        tools: [
+            { name: "docx_read", description: "Read a .docx and extract content as text, Markdown or HTML (preserves structure)." },
+            { name: "docx_create", description: "Create a .docx with headings, paragraphs, lists and bold/italic formatting." },
+        ],
+    },
+    {
+        key: "memory_",
+        label: "Memory",
+        icon: "Brain",
+        note: "The agent's own persistent memory across sessions.",
+        tools: [
+            { name: "memory_get", description: "Read the agent's persistent memory (empty if none yet)." },
+            { name: "memory_save", description: "Overwrite the entire persistent memory with new content." },
+            { name: "memory_append", description: "Append a timestamped line to the persistent memory." },
+            { name: "memory_update", description: "Find-and-replace a unique section in the persistent memory." },
+        ],
+    },
+    {
+        key: "github_",
+        label: "GitHub",
+        icon: "GithubLogo",
+        requiresKey: true,
+        credentialLabel: "needs connection",
+        explicitToolsOnly: true,
+        note: "Uses a project Connection. OAuth token is resolved server-side and never shown to the model.",
+        tools: [
+            { name: "github_list_repos", description: "List repositories visible to the connected GitHub account." },
+            { name: "github_create_issue", description: "Create an issue in an authorized repository." },
+            { name: "github_read_file", description: "Read a repository file through a connected GitHub account." },
+        ],
+    },
+    {
+        key: "slack_",
+        label: "Slack",
+        icon: "SlackLogo",
+        requiresKey: true,
+        credentialLabel: "needs connection",
+        explicitToolsOnly: true,
+        note: "Uses a project Connection. Slack tokens are resolved server-side and never shown to the model.",
+        tools: [
+            { name: "slack_list_channels", description: "List channels visible to the connected Slack workspace." },
+            { name: "slack_send_message", description: "Send a message to a channel in the connected workspace." },
+        ],
+    },
+    {
+        key: "drive_",
+        label: "Google Drive",
+        icon: "GoogleDriveLogo",
+        requiresKey: true,
+        credentialLabel: "needs connection",
+        explicitToolsOnly: true,
+        note: "Uses a project Connection. Drive tokens are resolved server-side and never shown to the model.",
+        tools: [
+            { name: "drive_search_files", description: "Search files in the connected Google Drive account." },
+            { name: "drive_read_file", description: "Read a Drive file. Google Docs are exported as text/plain." },
+        ],
+    },
+];
+/** Every catalogued tool name, for detecting custom/unknown enabled tools. */
+export const CATALOG_TOOL_NAMES = new Set(TOOL_CATALOG.flatMap((g) => g.tools.map((t) => t.name)));
+export const CATALOG_TOOL_WILDCARDS = new Set(TOOL_CATALOG.filter((g) => g.key.endsWith("_") && !g.explicitToolsOnly).map((g) => `${g.key}*`));
+/**
+ * Is `toolName` enabled by an agent's `allowedTools`? True on an exact match
+ * or a matching wildcard (e.g. "image_*" enables "image_generate").
+ */
+export function isToolEnabled(toolName, allowed) {
+    if (allowed.includes(toolName))
+        return true;
+    return allowed.some((a) => a.endsWith("*") && toolName.startsWith(a.slice(0, -1)));
+}
+/** Tools the runtime grants when an agent has no explicit allowedTools. */
+export const BASELINE_TOOLS = new Set([
+    "read",
+    "write",
+    "edit",
+    "bash",
+    "glob",
+    "grep",
+    "ls",
+    "http_fetch",
+    "http_download",
+]);
+/**
+ * The number of tools an agent actually has enabled — resolving core tools
+ * (always on), the empty-allowedTools baseline, and `prefix*` wildcards. Use
+ * this instead of `allowedTools.length`, which miscounts wildcards/baseline.
+ */
+export function countEnabledTools(allowed) {
+    let n = 0;
+    for (const group of TOOL_CATALOG) {
+        for (const tool of group.tools) {
+            const on = group.core
+                ? true
+                : allowed.length === 0
+                    ? BASELINE_TOOLS.has(tool.name)
+                    : isToolEnabled(tool.name, allowed);
+            if (on)
+                n += 1;
+        }
+    }
+    return n;
+}
+/** Does `allowed` enable a whole group via its wildcard (e.g. "image_*")? */
+export function hasGroupWildcard(groupKey, allowed) {
+    return allowed.includes(`${groupKey}*`);
+}
+//# sourceMappingURL=tool-catalog.js.map

package/dist/v2/support/tool-catalog.js.map

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

package/dist/v2/support/vault-fields.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Shared vault credential-field config + helpers.
+ *
+ * Mirrors the credential schemas in @polpo-ai/server's vault route
+ * (`SaveVaultEntryBody`). Used by both the agent vault tab CRUD and the
+ * builder's `save_credential` secure form so the typed fields stay in sync.
+ */
+export type VaultType = "api_key" | "smtp" | "imap" | "oauth" | "login" | "custom";
+export interface FieldDef {
+    k: string;
+    label: string;
+    secret?: boolean;
+    optional?: boolean;
+    placeholder?: string;
+}
+export declare const typeLabel: Record<string, string>;
+export declare const TYPE_OPTIONS: VaultType[];
+export declare const TYPE_FIELDS: Record<Exclude<VaultType, "custom">, FieldDef[]>;
+export declare const VAULT_INPUT_CLS = "w-full border border-border bg-background px-2.5 py-1.5 text-sm text-foreground placeholder:text-muted-foreground/40 focus:border-foreground/30 focus:outline-none";
+export declare const VAULT_FIELD_LABEL_CLS = "font-mono text-[10px] font-medium uppercase tracking-[0.12em] text-muted-foreground";
+/**
+ * Build the credentials object from form state, validating required fields.
+ * Throws a user-facing Error on the first missing required field.
+ */
+export declare function buildCredentials(type: VaultType, fields: Record<string, string>, customRows: {
+    k: string;
+    v: string;
+}[]): Record<string, string>;
+//# sourceMappingURL=vault-fields.d.ts.map

package/dist/v2/support/vault-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-fields.d.ts","sourceRoot":"","sources":["../../../src/v2/support/vault-fields.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEnF,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAO5C,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,SAAS,EAA4D,CAAC;AAEjG,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,QAAQ,EAAE,CA6BxE,CAAC;AAGF,eAAO,MAAM,eAAe,uKAC0I,CAAC;AACvK,eAAO,MAAM,qBAAqB,wFACqD,CAAC;AAExF;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,UAAU,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,GACrC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAcxB"}

package/dist/v2/support/vault-fields.js

@@ -0,0 +1,74 @@
+/**
+ * Shared vault credential-field config + helpers.
+ *
+ * Mirrors the credential schemas in @polpo-ai/server's vault route
+ * (`SaveVaultEntryBody`). Used by both the agent vault tab CRUD and the
+ * builder's `save_credential` secure form so the typed fields stay in sync.
+ */
+export const typeLabel = {
+    smtp: "SMTP",
+    imap: "IMAP",
+    oauth: "OAuth",
+    api_key: "API Key",
+    login: "Login",
+    custom: "Custom",
+};
+export const TYPE_OPTIONS = ["api_key", "smtp", "imap", "oauth", "login", "custom"];
+export const TYPE_FIELDS = {
+    api_key: [{ k: "key", label: "API key", secret: true }],
+    smtp: [
+        { k: "host", label: "Host" },
+        { k: "port", label: "Port", placeholder: "587" },
+        { k: "user", label: "User" },
+        { k: "pass", label: "Password", secret: true },
+        { k: "from", label: "From address" },
+        { k: "secure", label: "Secure", optional: true, placeholder: "true | false" },
+    ],
+    imap: [
+        { k: "host", label: "Host" },
+        { k: "port", label: "Port", placeholder: "993" },
+        { k: "user", label: "User" },
+        { k: "pass", label: "Password", secret: true },
+        { k: "tls", label: "TLS", optional: true, placeholder: "true | false" },
+    ],
+    oauth: [
+        { k: "access_token", label: "Access token", secret: true },
+        { k: "refresh_token", label: "Refresh token", secret: true, optional: true },
+        { k: "client_id", label: "Client ID", optional: true },
+        { k: "client_secret", label: "Client secret", secret: true, optional: true },
+        { k: "expires_at", label: "Expires at", optional: true },
+        { k: "scope", label: "Scope", optional: true },
+    ],
+    login: [
+        { k: "username", label: "Username" },
+        { k: "password", label: "Password", secret: true },
+    ],
+};
+// Sharp, design-system-consistent field styling (no rounded; native inputs).
+export const VAULT_INPUT_CLS = "w-full border border-border bg-background px-2.5 py-1.5 text-sm text-foreground placeholder:text-muted-foreground/40 focus:border-foreground/30 focus:outline-none";
+export const VAULT_FIELD_LABEL_CLS = "font-mono text-[10px] font-medium uppercase tracking-[0.12em] text-muted-foreground";
+/**
+ * Build the credentials object from form state, validating required fields.
+ * Throws a user-facing Error on the first missing required field.
+ */
+export function buildCredentials(type, fields, customRows) {
+    if (type === "custom") {
+        const out = {};
+        for (const r of customRows)
+            if (r.k.trim())
+                out[r.k.trim()] = r.v;
+        if (Object.keys(out).length === 0)
+            throw new Error("Add at least one field.");
+        return out;
+    }
+    const out = {};
+    for (const f of TYPE_FIELDS[type]) {
+        const v = (fields[f.k] ?? "").trim();
+        if (!v && !f.optional)
+            throw new Error(`${f.label} is required.`);
+        if (v)
+            out[f.k] = v;
+    }
+    return out;
+}
+//# sourceMappingURL=vault-fields.js.map

package/dist/v2/support/vault-fields.js.map

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

package/dist/v2/tools/param-fields.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Turn a tool's TypeBox/JSON-Schema `parameters` into a guided "Try it" form,
+ * and assemble a typed args object back from the form values. Ported from the
+ * v1 tools view so the run form works without needing the AI example endpoint.
+ */
+export type ParamField = {
+    name: string;
+    type: "string" | "number" | "integer" | "boolean" | "enum" | "json";
+    required: boolean;
+    description?: string;
+    enumValues?: (string | number)[];
+    raw?: Record<string, unknown>;
+};
+export declare function schemaToFields(schema: unknown): ParamField[] | null;
+export declare function placeholderFor(f: ParamField): string;
+export declare function argsToFormValues(fields: ParamField[], args: Record<string, unknown>): Record<string, string>;
+export declare function emptyFormValues(fields: ParamField[]): Record<string, string>;
+export declare function buildArgsFromForm(fields: ParamField[], values: Record<string, string>): Record<string, unknown>;
+//# sourceMappingURL=param-fields.d.ts.map

package/dist/v2/tools/param-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"param-fields.d.ts","sourceRoot":"","sources":["../../../src/v2/tools/param-fields.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IACpE,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,CAAC;AAIF,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,UAAU,EAAE,GAAG,IAAI,CAwCnE;AA2DD,wBAAgB,cAAc,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAKpD;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,UAAU,EAAE,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkBxB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAI5E;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,UAAU,EAAE,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+BzB"}

package/dist/v2/tools/param-fields.js

@@ -0,0 +1,191 @@
+/**
+ * Turn a tool's TypeBox/JSON-Schema `parameters` into a guided "Try it" form,
+ * and assemble a typed args object back from the form values. Ported from the
+ * v1 tools view so the run form works without needing the AI example endpoint.
+ */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+export function schemaToFields(schema) {
+    if (!schema || typeof schema !== "object")
+        return null;
+    const s = schema;
+    const props = s.properties;
+    if (!props || typeof props !== "object")
+        return null;
+    const required = Array.isArray(s.required) ? s.required : [];
+    const names = Object.keys(props);
+    if (names.length === 0)
+        return null;
+    return names.map((name) => {
+        const p = (props[name] ?? {});
+        const description = typeof p.description === "string" ? p.description : undefined;
+        const req = required.includes(name);
+        const enumFromKeyword = Array.isArray(p.enum) ? p.enum : null;
+        const enumFromAnyOf = Array.isArray(p.anyOf) && p.anyOf.every((m) => m && "const" in m)
+            ? p.anyOf.map((m) => m.const)
+            : null;
+        const enumValues = (enumFromKeyword ?? enumFromAnyOf);
+        if (enumValues && enumValues.length > 0) {
+            return { name, type: "enum", required: req, description, enumValues };
+        }
+        switch (p.type) {
+            case "string":
+                return { name, type: "string", required: req, description };
+            case "number":
+                return { name, type: "number", required: req, description };
+            case "integer":
+                return { name, type: "integer", required: req, description };
+            case "boolean":
+                return { name, type: "boolean", required: req, description };
+            default:
+                return { name, type: "json", required: req, description, raw: p };
+        }
+    });
+}
+function exampleString(name) {
+    const n = name.toLowerCase();
+    if (/email/.test(n))
+        return "user@example.com";
+    if (/url|link|website|endpoint/.test(n))
+        return "https://example.com";
+    if (/phone|tel/.test(n))
+        return "+15550100";
+    if (/datetime|timestamp/.test(n))
+        return "2024-01-15T09:30:00Z";
+    if (/date|day/.test(n))
+        return "2024-01-15";
+    if (/time/.test(n))
+        return "09:30";
+    if (/uuid|(^|_)id$/.test(n))
+        return "abc123";
+    if (/city/.test(n))
+        return "San Francisco";
+    if (/country/.test(n))
+        return "US";
+    if (/currency/.test(n))
+        return "USD";
+    if (/(^|_)name$|title|company/.test(n))
+        return "Acme Inc";
+    if (/query|search|(^|_)q$/.test(n))
+        return "quarterly report";
+    if (/message|text|body|content|prompt/.test(n))
+        return "Hello world";
+    if (/slug/.test(n))
+        return "my-tool";
+    if (/path|file/.test(n))
+        return "/tmp/out.txt";
+    if (/lang|locale/.test(n))
+        return "en";
+    return "text";
+}
+function exampleNumber(name) {
+    const n = name.toLowerCase();
+    if (/amount|price|cost|total|fee|balance/.test(n))
+        return 99.99;
+    if (/count|qty|quantity|limit|page|size|max|min/.test(n))
+        return 10;
+    if (/age/.test(n))
+        return 30;
+    if (/year/.test(n))
+        return 2024;
+    return 42;
+}
+function exampleFromSchema(node, name = "") {
+    if (!node || typeof node !== "object")
+        return "value";
+    if (Array.isArray(node.enum) && node.enum.length)
+        return node.enum[0];
+    if (Array.isArray(node.anyOf) && node.anyOf[0] && "const" in node.anyOf[0])
+        return node.anyOf[0].const;
+    switch (node.type) {
+        case "string":
+            return exampleString(name);
+        case "number":
+        case "integer":
+            return exampleNumber(name);
+        case "boolean":
+            return true;
+        case "array":
+            return [exampleFromSchema(node.items, name)];
+        case "object": {
+            const props = (node.properties ?? {});
+            const out = {};
+            for (const k of Object.keys(props).slice(0, 4))
+                out[k] = exampleFromSchema(props[k], k);
+            return Object.keys(out).length ? out : { key: "value" };
+        }
+        default:
+            return "value";
+    }
+}
+export function placeholderFor(f) {
+    if (f.type === "boolean" || f.type === "enum")
+        return "";
+    if (f.type === "json")
+        return `e.g. ${JSON.stringify(exampleFromSchema(f.raw, f.name))}`;
+    if (f.type === "number" || f.type === "integer")
+        return `e.g. ${exampleNumber(f.name)}`;
+    return `e.g. ${exampleString(f.name)}`;
+}
+export function argsToFormValues(fields, args) {
+    const values = {};
+    for (const f of fields) {
+        const v = args?.[f.name];
+        if (v === undefined || v === null) {
+            values[f.name] = f.type === "boolean" ? "false" : "";
+            continue;
+        }
+        values[f.name] =
+            typeof v === "boolean"
+                ? v
+                    ? "true"
+                    : "false"
+                : typeof v === "object"
+                    ? JSON.stringify(v)
+                    : String(v);
+    }
+    return values;
+}
+export function emptyFormValues(fields) {
+    const out = {};
+    for (const f of fields)
+        out[f.name] = f.type === "boolean" ? "false" : "";
+    return out;
+}
+export function buildArgsFromForm(fields, values) {
+    const args = {};
+    for (const f of fields) {
+        const raw = values[f.name];
+        if (f.type === "boolean") {
+            if (raw === "true")
+                args[f.name] = true;
+            else if (raw === "false" && f.required)
+                args[f.name] = false;
+            continue;
+        }
+        if (raw === undefined || raw === "")
+            continue;
+        if (f.type === "number" || f.type === "integer") {
+            const n = Number(raw);
+            if (Number.isNaN(n))
+                throw new Error(`"${f.name}" must be a number.`);
+            args[f.name] = f.type === "integer" ? Math.trunc(n) : n;
+            continue;
+        }
+        if (f.type === "enum") {
+            args[f.name] = raw;
+            continue;
+        }
+        if (f.type === "json") {
+            try {
+                args[f.name] = JSON.parse(raw);
+            }
+            catch {
+                throw new Error(`"${f.name}" must be valid JSON.`);
+            }
+            continue;
+        }
+        args[f.name] = raw;
+    }
+    return args;
+}
+//# sourceMappingURL=param-fields.js.map

package/dist/v2/tools/param-fields.js.map

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

package/dist/v2/tools/self-host.d.ts

@@ -0,0 +1,7 @@
+import { type ToolRow } from "./tools-view.js";
+export declare function SelfHostToolsView(): import("react/jsx-runtime").JSX.Element;
+export declare function SelfHostToolDetailView({ name }: {
+    name: string;
+}): import("react/jsx-runtime").JSX.Element;
+export type { ToolRow };
+//# sourceMappingURL=self-host.d.ts.map

package/dist/v2/tools/self-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-host.d.ts","sourceRoot":"","sources":["../../../src/v2/tools/self-host.tsx"],"names":[],"mappings":"AAOA,OAAO,EAAa,KAAK,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1D,wBAAgB,iBAAiB,4CAMhC;AAED,wBAAgB,sBAAsB,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,2CA0ChE;AAED,YAAY,EAAE,OAAO,EAAE,CAAC"}