@camerontaylor/paseo-protocol 0.11.2-fork.2 → 0.12.0-fork.1

package/dist/paseo-tool-presentation/catalog.d.ts

@@ -0,0 +1,309 @@
+/**
+ * One entry per Paseo MCP tool: the timeline label, the context shown after it,
+ * and how the expanded details lay out the call.
+ *
+ * Labels are fixed text so truncation never hides them. Actions read verb-first
+ * ("Send message"); the context goes in the summary.
+ */
+type ToolInput = Readonly<Record<string, unknown>>;
+/** `targetAgent` is the target agent's title when known, else its ID. */
+export type PaseoToolContext = (input: ToolInput, targetAgent: string | undefined) => unknown;
+export interface PaseoToolDetailSpec {
+    promptField?: string;
+    inputOrder?: readonly string[];
+    outputFields?: readonly string[];
+}
+export interface PaseoToolEntry {
+    label: string;
+    context?: PaseoToolContext;
+    detail?: PaseoToolDetailSpec;
+}
+export declare const PASEO_TOOL_CATALOG: {
+    create_agent: {
+        label: string;
+        context: PaseoToolContext;
+        detail: {
+            promptField: string;
+            inputOrder: readonly ["title", "agentId", "provider", "workspaceId", "cwd", "sessionMode", "modeId", "background", "notifyOnFinish", "internal", "settings", "labels"];
+            outputFields: string[];
+        };
+    };
+    send_agent_prompt: {
+        label: string;
+        context: PaseoToolContext;
+        detail: {
+            promptField: string;
+            inputOrder: readonly ["title", "agentId", "provider", "workspaceId", "cwd", "sessionMode", "modeId", "background", "notifyOnFinish", "internal", "settings", "labels"];
+            outputFields: string[];
+        };
+    };
+    get_agent_status: {
+        label: string;
+        context: PaseoToolContext;
+        detail: {
+            inputOrder: string[];
+        };
+    };
+    get_agent_activity: {
+        label: string;
+        context: PaseoToolContext;
+        detail: {
+            inputOrder: string[];
+        };
+    };
+    list_agents: {
+        label: string;
+        detail: {
+            inputOrder: string[];
+        };
+    };
+    update_agent: {
+        label: string;
+        context: PaseoToolContext;
+        detail: {
+            inputOrder: readonly ["title", "agentId", "provider", "workspaceId", "cwd", "sessionMode", "modeId", "background", "notifyOnFinish", "internal", "settings", "labels"];
+        };
+    };
+    set_agent_mode: {
+        label: string;
+        context: PaseoToolContext;
+        detail: {
+            inputOrder: string[];
+        };
+    };
+    cancel_agent: {
+        label: string;
+        context: PaseoToolContext;
+        detail: {
+            inputOrder: string[];
+        };
+    };
+    archive_agent: {
+        label: string;
+        context: PaseoToolContext;
+        detail: {
+            inputOrder: string[];
+        };
+    };
+    kill_agent: {
+        label: string;
+        context: PaseoToolContext;
+        detail: {
+            inputOrder: string[];
+        };
+    };
+    list_pending_permissions: {
+        label: string;
+    };
+    respond_to_permission: {
+        label: string;
+        context: PaseoToolContext;
+        detail: {
+            inputOrder: string[];
+        };
+    };
+    create_workspace: {
+        label: string;
+        context: PaseoToolContext;
+        detail: {
+            inputOrder: readonly ["title", "workspaceId", "projectId", "isolation", "path", "mode", "worktreeSlug", "branchName", "baseBranch", "branch", "prNumber", "forge"];
+            outputFields: string[];
+        };
+    };
+    list_workspaces: {
+        label: string;
+    };
+    rename_workspace: {
+        label: string;
+        context: PaseoToolContext;
+        detail: {
+            inputOrder: string[];
+        };
+    };
+    archive_workspace: {
+        label: string;
+        context: PaseoToolContext;
+        detail: {
+            inputOrder: string[];
+            outputFields: string[];
+        };
+    };
+    list_workspace_scripts: {
+        label: string;
+        detail: {
+            inputOrder: string[];
+        };
+    };
+    start_workspace_script: {
+        label: string;
+        context: PaseoToolContext;
+        detail: {
+            inputOrder: string[];
+        };
+    };
+    stop_workspace_script: {
+        label: string;
+        context: PaseoToolContext;
+        detail: {
+            inputOrder: string[];
+        };
+    };
+    create_terminal: {
+        label: string;
+        context: PaseoToolContext;
+        detail: {
+            inputOrder: string[];
+        };
+    };
+    list_terminals: {
+        label: string;
+        detail: {
+            inputOrder: string[];
+        };
+    };
+    capture_terminal: {
+        label: string;
+        context: PaseoToolContext;
+        detail: {
+            inputOrder: string[];
+        };
+    };
+    send_terminal_keys: {
+        label: string;
+        context: PaseoToolContext;
+        detail: {
+            inputOrder: string[];
+        };
+    };
+    kill_terminal: {
+        label: string;
+        context: PaseoToolContext;
+        detail: {
+            inputOrder: string[];
+        };
+    };
+    create_schedule: {
+        label: string;
+        context: PaseoToolContext;
+        detail: {
+            promptField: string;
+            inputOrder: readonly ["name", "id", "cron", "timezone", "provider", "cwd", "isolation", "maxRuns", "expiresIn", "clearExpires"];
+            outputFields: readonly ["id", "status", "nextRunAt", "expiresAt"];
+        };
+    };
+    create_heartbeat: {
+        label: string;
+        context: PaseoToolContext;
+        detail: {
+            promptField: string;
+            inputOrder: readonly ["name", "id", "cron", "timezone", "provider", "cwd", "isolation", "maxRuns", "expiresIn", "clearExpires"];
+            outputFields: readonly ["id", "status", "nextRunAt", "expiresAt"];
+        };
+    };
+    update_schedule: {
+        label: string;
+        context: PaseoToolContext;
+        detail: {
+            promptField: string;
+            inputOrder: readonly ["name", "id", "cron", "timezone", "provider", "cwd", "isolation", "maxRuns", "expiresIn", "clearExpires"];
+        };
+    };
+    list_schedules: {
+        label: string;
+    };
+    inspect_schedule: {
+        label: string;
+        context: PaseoToolContext;
+        detail: {
+            inputOrder: string[];
+        };
+    };
+    schedule_logs: {
+        label: string;
+        context: PaseoToolContext;
+        detail: {
+            inputOrder: string[];
+        };
+    };
+    run_schedule_once: {
+        label: string;
+        context: PaseoToolContext;
+        detail: {
+            inputOrder: string[];
+        };
+    };
+    pause_schedule: {
+        label: string;
+        context: PaseoToolContext;
+        detail: {
+            inputOrder: string[];
+        };
+    };
+    resume_schedule: {
+        label: string;
+        context: PaseoToolContext;
+        detail: {
+            inputOrder: string[];
+        };
+    };
+    delete_schedule: {
+        label: string;
+        context: PaseoToolContext;
+        detail: {
+            inputOrder: string[];
+        };
+    };
+    delete_heartbeat: {
+        label: string;
+        context: PaseoToolContext;
+        detail: {
+            inputOrder: string[];
+        };
+    };
+    list_providers: {
+        label: string;
+    };
+    list_models: {
+        label: string;
+        context: PaseoToolContext;
+        detail: {
+            inputOrder: string[];
+        };
+    };
+    list_profiles: {
+        label: string;
+    };
+    inspect_provider: {
+        label: string;
+        context: PaseoToolContext;
+        detail: {
+            inputOrder: string[];
+        };
+    };
+    browser_list_tabs: PaseoToolEntry;
+    browser_new_tab: PaseoToolEntry;
+    browser_close_tab: PaseoToolEntry;
+    browser_navigate: PaseoToolEntry;
+    browser_back: PaseoToolEntry;
+    browser_forward: PaseoToolEntry;
+    browser_reload: PaseoToolEntry;
+    browser_snapshot: PaseoToolEntry;
+    browser_screenshot: PaseoToolEntry;
+    browser_click: PaseoToolEntry;
+    browser_hover: PaseoToolEntry;
+    browser_drag: PaseoToolEntry;
+    browser_fill: PaseoToolEntry;
+    browser_select: PaseoToolEntry;
+    browser_type: PaseoToolEntry;
+    browser_keypress: PaseoToolEntry;
+    browser_upload: PaseoToolEntry;
+    browser_wait: PaseoToolEntry;
+    browser_scroll: PaseoToolEntry;
+    browser_resize: PaseoToolEntry;
+    browser_logs: PaseoToolEntry;
+    browser_evaluate: PaseoToolEntry;
+};
+export type PaseoToolName = keyof typeof PASEO_TOOL_CATALOG;
+export declare function getPaseoToolEntry(leafName: string): PaseoToolEntry | undefined;
+export {};
+//# sourceMappingURL=catalog.d.ts.map

package/dist/paseo-tool-presentation/catalog.js

@@ -0,0 +1,315 @@
+/**
+ * One entry per Paseo MCP tool: the timeline label, the context shown after it,
+ * and how the expanded details lay out the call.
+ *
+ * Labels are fixed text so truncation never hides them. Actions read verb-first
+ * ("Send message"); the context goes in the summary.
+ */
+const WORKSPACE_FIELDS = [
+    "title",
+    "workspaceId",
+    "projectId",
+    "isolation",
+    "path",
+    "mode",
+    "worktreeSlug",
+    "branchName",
+    "baseBranch",
+    "branch",
+    "prNumber",
+    "forge",
+];
+const AGENT_FIELDS = [
+    "title",
+    "agentId",
+    "provider",
+    "workspaceId",
+    "cwd",
+    "sessionMode",
+    "modeId",
+    "background",
+    "notifyOnFinish",
+    "internal",
+    "settings",
+    "labels",
+];
+const AUTOMATION_FIELDS = [
+    "name",
+    "id",
+    "cron",
+    "timezone",
+    "provider",
+    "cwd",
+    "isolation",
+    "maxRuns",
+    "expiresIn",
+    "clearExpires",
+];
+const BROWSER_FIELDS = [
+    "browserId",
+    "url",
+    "ref",
+    "sourceRef",
+    "targetRef",
+    "value",
+    "text",
+    "key",
+    "button",
+    "doubleClick",
+    "modifiers",
+    "filePaths",
+    "fullPage",
+    "maxEntries",
+    "timeoutMs",
+    "deltaX",
+    "deltaY",
+    "width",
+    "height",
+    "function",
+];
+const AUTOMATION_OUTPUT = ["id", "status", "nextRunAt", "expiresAt"];
+function field(...keys) {
+    return (input) => keys.map((key) => input[key]).find(isPresent);
+}
+function targetAgent() {
+    return (_input, agent) => agent;
+}
+function fieldOrTargetAgent(key) {
+    return (input, agent) => (isPresent(input[key]) ? input[key] : agent);
+}
+function workspaceContext() {
+    return (input) => [input.title, input.branchName, input.branch, baseName(input.path)].find(isPresent);
+}
+function viewportContext() {
+    return (input) => typeof input.width === "number" && typeof input.height === "number"
+        ? `${input.width}×${input.height}`
+        : undefined;
+}
+function isPresent(value) {
+    if (typeof value === "string")
+        return value.trim().length > 0;
+    if (Array.isArray(value))
+        return value.length > 0;
+    return typeof value === "number";
+}
+function baseName(value) {
+    if (typeof value !== "string")
+        return undefined;
+    return value.split(/[\\/]/).findLast((segment) => segment.length > 0);
+}
+function browser(label, context) {
+    return { label, ...(context ? { context } : {}), detail: { inputOrder: BROWSER_FIELDS } };
+}
+export const PASEO_TOOL_CATALOG = {
+    // Agents
+    create_agent: {
+        label: "Create agent",
+        context: field("title", "initialPrompt"),
+        detail: {
+            promptField: "initialPrompt",
+            inputOrder: AGENT_FIELDS,
+            outputFields: ["agentId", "status", "currentModeId", "cwd"],
+        },
+    },
+    send_agent_prompt: {
+        label: "Send message",
+        context: field("prompt"),
+        detail: {
+            promptField: "prompt",
+            inputOrder: AGENT_FIELDS,
+            outputFields: ["status", "lastMessage", "permission"],
+        },
+    },
+    get_agent_status: {
+        label: "Check agent",
+        context: targetAgent(),
+        detail: { inputOrder: ["agentId"] },
+    },
+    get_agent_activity: {
+        label: "Read agent activity",
+        context: targetAgent(),
+        detail: { inputOrder: ["agentId", "limit"] },
+    },
+    list_agents: {
+        label: "List agents",
+        detail: { inputOrder: ["cwd", "statuses", "sinceHours", "limit", "includeArchived"] },
+    },
+    update_agent: {
+        label: "Update agent",
+        context: fieldOrTargetAgent("name"),
+        detail: { inputOrder: AGENT_FIELDS },
+    },
+    set_agent_mode: {
+        label: "Set agent mode",
+        context: field("modeId"),
+        detail: { inputOrder: ["agentId", "modeId"] },
+    },
+    cancel_agent: {
+        label: "Cancel agent",
+        context: targetAgent(),
+        detail: { inputOrder: ["agentId"] },
+    },
+    archive_agent: {
+        label: "Archive agent",
+        context: targetAgent(),
+        detail: { inputOrder: ["agentId"] },
+    },
+    kill_agent: { label: "Kill agent", context: targetAgent(), detail: { inputOrder: ["agentId"] } },
+    list_pending_permissions: { label: "List permissions" },
+    respond_to_permission: {
+        label: "Respond to permission",
+        context: targetAgent(),
+        detail: { inputOrder: ["agentId", "requestId", "response"] },
+    },
+    // Workspaces and scripts
+    create_workspace: {
+        label: "Create workspace",
+        context: workspaceContext(),
+        detail: { inputOrder: WORKSPACE_FIELDS, outputFields: ["workspaceId", "projectId"] },
+    },
+    list_workspaces: { label: "List workspaces" },
+    rename_workspace: {
+        label: "Rename workspace",
+        context: field("title"),
+        detail: { inputOrder: ["title", "workspaceId"] },
+    },
+    archive_workspace: {
+        label: "Archive workspace",
+        context: field("workspaceId"),
+        detail: {
+            inputOrder: ["workspaceId"],
+            outputFields: ["workspaceId", "archivedAgentIds", "removedDirectory"],
+        },
+    },
+    list_workspace_scripts: { label: "List scripts", detail: { inputOrder: ["workspaceId"] } },
+    start_workspace_script: {
+        label: "Start script",
+        context: field("scriptName"),
+        detail: { inputOrder: ["workspaceId", "scriptName"] },
+    },
+    stop_workspace_script: {
+        label: "Stop script",
+        context: field("scriptName"),
+        detail: { inputOrder: ["workspaceId", "scriptName"] },
+    },
+    // Terminals
+    create_terminal: {
+        label: "Create terminal",
+        context: field("name", "command"),
+        detail: { inputOrder: ["cwd", "workspaceId", "name", "command"] },
+    },
+    list_terminals: { label: "List terminals", detail: { inputOrder: ["cwd", "all"] } },
+    capture_terminal: {
+        label: "Read terminal",
+        context: field("terminalId"),
+        detail: { inputOrder: ["terminalId", "lines"] },
+    },
+    send_terminal_keys: {
+        label: "Send keys",
+        context: field("keys"),
+        detail: { inputOrder: ["terminalId", "keys", "literal"] },
+    },
+    kill_terminal: {
+        label: "Kill terminal",
+        context: field("terminalId"),
+        detail: { inputOrder: ["terminalId"] },
+    },
+    // Schedules and heartbeats
+    create_schedule: {
+        label: "Create schedule",
+        context: field("name", "cron"),
+        detail: {
+            promptField: "prompt",
+            inputOrder: AUTOMATION_FIELDS,
+            outputFields: AUTOMATION_OUTPUT,
+        },
+    },
+    create_heartbeat: {
+        label: "Create heartbeat",
+        context: field("name", "cron"),
+        detail: {
+            promptField: "prompt",
+            inputOrder: AUTOMATION_FIELDS,
+            outputFields: AUTOMATION_OUTPUT,
+        },
+    },
+    update_schedule: {
+        label: "Update schedule",
+        context: field("name", "id"),
+        detail: { promptField: "prompt", inputOrder: AUTOMATION_FIELDS },
+    },
+    list_schedules: { label: "List schedules" },
+    inspect_schedule: {
+        label: "Inspect schedule",
+        context: field("id"),
+        detail: { inputOrder: ["id"] },
+    },
+    schedule_logs: {
+        label: "Read schedule logs",
+        context: field("id"),
+        detail: { inputOrder: ["id"] },
+    },
+    run_schedule_once: {
+        label: "Run schedule",
+        context: field("id"),
+        detail: { inputOrder: ["id"] },
+    },
+    pause_schedule: { label: "Pause schedule", context: field("id"), detail: { inputOrder: ["id"] } },
+    resume_schedule: {
+        label: "Resume schedule",
+        context: field("id"),
+        detail: { inputOrder: ["id"] },
+    },
+    delete_schedule: {
+        label: "Delete schedule",
+        context: field("id"),
+        detail: { inputOrder: ["id"] },
+    },
+    delete_heartbeat: {
+        label: "Delete heartbeat",
+        context: field("id"),
+        detail: { inputOrder: ["id"] },
+    },
+    // Providers
+    list_providers: { label: "List providers" },
+    list_models: {
+        label: "List models",
+        context: field("provider"),
+        detail: { inputOrder: ["provider"] },
+    },
+    list_profiles: { label: "List profiles" },
+    inspect_provider: {
+        label: "Inspect provider",
+        context: field("provider"),
+        detail: { inputOrder: ["provider", "cwd", "settings"] },
+    },
+    // Browser
+    browser_list_tabs: browser("List browser tabs"),
+    browser_new_tab: browser("Open browser tab", field("url")),
+    browser_close_tab: browser("Close browser tab", field("browserId")),
+    browser_navigate: browser("Navigate", field("url")),
+    browser_back: browser("Go back"),
+    browser_forward: browser("Go forward"),
+    browser_reload: browser("Reload page"),
+    browser_snapshot: browser("Snapshot page"),
+    browser_screenshot: browser("Take screenshot"),
+    browser_click: browser("Click element", field("ref")),
+    browser_hover: browser("Hover element", field("ref")),
+    browser_drag: browser("Drag element", field("sourceRef")),
+    browser_fill: browser("Fill field", field("ref")),
+    browser_select: browser("Select option", field("value", "ref")),
+    browser_type: browser("Type text", field("text")),
+    browser_keypress: browser("Press key", field("key")),
+    browser_upload: browser("Upload files", field("filePaths")),
+    browser_wait: browser("Wait for page", field("text", "url")),
+    browser_scroll: browser("Scroll page"),
+    browser_resize: browser("Resize browser", viewportContext()),
+    browser_logs: browser("Read browser logs"),
+    browser_evaluate: browser("Run JavaScript", field("function")),
+};
+export function getPaseoToolEntry(leafName) {
+    return Object.prototype.hasOwnProperty.call(PASEO_TOOL_CATALOG, leafName)
+        ? PASEO_TOOL_CATALOG[leafName]
+        : undefined;
+}
+//# sourceMappingURL=catalog.js.map

package/dist/paseo-tool-presentation/detail-sections.d.ts

@@ -0,0 +1,15 @@
+export interface PaseoToolDetailField {
+    label: string;
+    value: string;
+}
+export type PaseoToolDetailSection = {
+    kind: "prose";
+    title: string;
+    text: string;
+} | {
+    kind: "fields";
+    title: string;
+    fields: PaseoToolDetailField[];
+};
+export declare function buildPaseoToolDetailSections(toolName: string, input: unknown, output: unknown): PaseoToolDetailSection[] | null;
+//# sourceMappingURL=detail-sections.d.ts.map