@camerontaylor/paseo-protocol 0.12.0-beta.1.fork.1 → 0.12.0-fork.1

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

package/dist/paseo-tool-presentation/detail-sections.js

@@ -0,0 +1,161 @@
+import { getPaseoToolLeafName } from "../tool-name-normalization.js";
+import { getPaseoToolEntry } from "./catalog.js";
+const FIELD_LABELS = {
+    agentId: "Agent",
+    archivedAgentIds: "Archived agents",
+    baseBranch: "Base branch",
+    branchName: "New branch",
+    browserId: "Browser tab",
+    clearExpires: "Clear expiry",
+    currentModeId: "Current mode",
+    cwd: "Working directory",
+    deltaX: "Horizontal delta",
+    deltaY: "Vertical delta",
+    doubleClick: "Double click",
+    expiresIn: "Expires in",
+    expiresAt: "Expires",
+    filePaths: "Files",
+    fullPage: "Full page",
+    initialPrompt: "Prompt",
+    id: "ID",
+    lastMessage: "Last message",
+    maxEntries: "Maximum entries",
+    maxRuns: "Maximum runs",
+    modeId: "Mode",
+    newMode: "New mode",
+    nextRunAt: "Next run",
+    notifyOnFinish: "Notify on finish",
+    internal: "Internal",
+    prNumber: "Change request",
+    projectId: "Project",
+    removedDirectory: "Removed directory",
+    requestId: "Request",
+    scriptName: "Script",
+    sessionMode: "Session mode",
+    sinceHours: "Since (hours)",
+    sourceRef: "Source",
+    targetRef: "Target",
+    terminalId: "Terminal",
+    thinkingOptionId: "Thinking",
+    timeoutMs: "Timeout (ms)",
+    updateCount: "Updates",
+    workspaceId: "Workspace",
+    worktreeSlug: "Worktree",
+};
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function humanizeKey(key) {
+    const known = FIELD_LABELS[key];
+    if (known)
+        return known;
+    const words = key
+        .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
+        .replace(/[._-]+/g, " ")
+        .split(" ")
+        .filter(Boolean);
+    const sentence = words.join(" ").toLowerCase();
+    return `${sentence[0]?.toUpperCase() ?? ""}${sentence.slice(1)}`;
+}
+function formatValue(value, depth = 0) {
+    if (value === null)
+        return "None";
+    if (value === undefined)
+        return "";
+    if (typeof value === "boolean")
+        return value ? "Yes" : "No";
+    if (typeof value === "string" || typeof value === "number" || typeof value === "bigint") {
+        return String(value);
+    }
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return "None";
+        return value.map((item) => `• ${indentMultiline(formatValue(item, depth + 1), 2)}`).join("\n");
+    }
+    if (isRecord(value)) {
+        const entries = Object.entries(value).filter(([, child]) => child !== undefined);
+        if (entries.length === 0)
+            return "None";
+        return entries
+            .map(([key, child]) => {
+            const formatted = formatValue(child, depth + 1);
+            return `${humanizeKey(key)}: ${indentMultiline(formatted, 2)}`;
+        })
+            .join("\n");
+    }
+    return String(value);
+}
+function indentMultiline(value, spaces) {
+    const indentation = " ".repeat(spaces);
+    return value.replace(/\n/g, `\n${indentation}`);
+}
+function orderedEntries(value, order = [], omittedKey, includedKeys) {
+    const included = includedKeys ? new Set(includedKeys) : null;
+    const keys = Object.keys(value).filter((key) => key !== omittedKey && value[key] !== undefined && (!included || included.has(key)));
+    const rank = new Map(order.map((key, index) => [key, index]));
+    keys.sort((left, right) => {
+        const leftRank = rank.get(left) ?? Number.MAX_SAFE_INTEGER;
+        const rightRank = rank.get(right) ?? Number.MAX_SAFE_INTEGER;
+        return leftRank - rightRank || left.localeCompare(right);
+    });
+    return keys.map((key) => [key, value[key]]);
+}
+function fieldsFromValue(value, order, omittedKey, includedKeys) {
+    if (value === null || value === undefined)
+        return [];
+    if (!isRecord(value)) {
+        const formatted = formatValue(value);
+        return formatted ? [{ label: "Value", value: formatted }] : [];
+    }
+    return orderedEntries(value, order, omittedKey, includedKeys).map(([key, child]) => ({
+        label: humanizeKey(key),
+        value: formatValue(child),
+    }));
+}
+function parseJsonText(value) {
+    if (typeof value !== "string")
+        return undefined;
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+function unwrapMcpResult(output) {
+    if (!isRecord(output))
+        return output;
+    if (output.structuredContent !== undefined) {
+        return output.structuredContent;
+    }
+    if (Array.isArray(output.content) && output.content.length === 1) {
+        const item = output.content[0];
+        if (isRecord(item) && item.type === "text") {
+            return parseJsonText(item.text) ?? item.text;
+        }
+    }
+    return output;
+}
+export function buildPaseoToolDetailSections(toolName, input, output) {
+    const leafName = getPaseoToolLeafName(toolName);
+    if (!leafName)
+        return null;
+    const spec = getPaseoToolEntry(leafName)?.detail ?? {};
+    const sections = [];
+    if (spec.promptField && isRecord(input)) {
+        const prompt = input[spec.promptField];
+        if (typeof prompt === "string" && prompt.length > 0) {
+            sections.push({ kind: "prose", title: "Prompt", text: prompt });
+        }
+    }
+    const inputFields = fieldsFromValue(input, spec.inputOrder, spec.promptField);
+    if (inputFields.length > 0) {
+        sections.push({ kind: "fields", title: "Details", fields: inputFields });
+    }
+    const outputFields = fieldsFromValue(unwrapMcpResult(output), spec.outputFields, undefined, spec.outputFields);
+    if (outputFields.length > 0) {
+        sections.push({ kind: "fields", title: "Result", fields: outputFields });
+    }
+    return sections;
+}
+//# sourceMappingURL=detail-sections.js.map

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

@@ -0,0 +1,22 @@
+import type { ToolCallDetail } from "../agent-types.js";
+import { type PaseoToolName } from "./catalog.js";
+export { buildAgentMessageDisplay, type AgentMessageDisplay } from "./agent-message.js";
+export { buildPaseoToolDetailSections, type PaseoToolDetailField, type PaseoToolDetailSection, } from "./detail-sections.js";
+export { MAX_SUMMARY_CHARS } from "./summary-text.js";
+export type { PaseoToolName };
+export interface PaseoToolDisplayInput {
+    toolName: string;
+    detail: ToolCallDetail;
+    /** Title of the agent named by the call's `agentId`, when the caller knows it. */
+    targetAgentTitle?: string;
+}
+export interface PaseoToolDisplay {
+    displayName: string;
+    summary?: string;
+}
+export declare const PASEO_TOOL_NAMES: readonly PaseoToolName[];
+/** Returns null for tools outside the Paseo namespace. */
+export declare function buildPaseoToolDisplay(input: PaseoToolDisplayInput): PaseoToolDisplay | null;
+/** The agent a Paseo call acts on, so callers can resolve its title. */
+export declare function getPaseoToolTargetAgentId(toolName: string, detail: ToolCallDetail | undefined): string | null;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,62 @@
+import { getPaseoToolLeafName, isPaseoToolName } from "../tool-name-normalization.js";
+import { getPaseoToolEntry, PASEO_TOOL_CATALOG } from "./catalog.js";
+import { toSummaryText } from "./summary-text.js";
+export { buildAgentMessageDisplay } from "./agent-message.js";
+export { buildPaseoToolDetailSections, } from "./detail-sections.js";
+export { MAX_SUMMARY_CHARS } from "./summary-text.js";
+export const PASEO_TOOL_NAMES = Object.keys(PASEO_TOOL_CATALOG);
+/** Returns null for tools outside the Paseo namespace. */
+export function buildPaseoToolDisplay(input) {
+    const leafName = paseoLeafName(input.toolName);
+    if (!leafName)
+        return null;
+    const entry = getPaseoToolEntry(leafName);
+    if (!entry)
+        return { displayName: humanizeLeafName(leafName) };
+    const toolInput = readToolInput(input.detail);
+    const targetAgent = input.targetAgentTitle ?? readString(toolInput.agentId);
+    const summary = formatContext(entry.context?.(toolInput, targetAgent));
+    return { displayName: entry.label, ...(summary ? { summary } : {}) };
+}
+/** The agent a Paseo call acts on, so callers can resolve its title. */
+export function getPaseoToolTargetAgentId(toolName, detail) {
+    if (!detail || !paseoLeafName(toolName))
+        return null;
+    return readString(readToolInput(detail).agentId) ?? null;
+}
+function paseoLeafName(toolName) {
+    return isPaseoToolName(toolName) ? getPaseoToolLeafName(toolName) : null;
+}
+function readToolInput(detail) {
+    if (detail.type !== "unknown")
+        return {};
+    const value = detail.input;
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        ? value
+        : {};
+}
+function readString(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function formatContext(value) {
+    if (typeof value === "string")
+        return toSummaryText(value);
+    if (typeof value === "number")
+        return String(value);
+    if (Array.isArray(value)) {
+        const [first, ...rest] = value;
+        const head = typeof first === "string" ? toSummaryText(first) : undefined;
+        if (!head)
+            return undefined;
+        return rest.length > 0 ? `${head} +${rest.length}` : head;
+    }
+    return undefined;
+}
+function humanizeLeafName(leafName) {
+    const sentence = leafName
+        .replace(/[._-]+/g, " ")
+        .trim()
+        .toLowerCase();
+    return `${sentence[0]?.toUpperCase() ?? ""}${sentence.slice(1)}`;
+}
+//# sourceMappingURL=index.js.map

package/dist/paseo-tool-presentation/summary-text.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Prompts and results can be one enormous line. Summaries are capped here so no
+ * consumer relies on its renderer to clip them.
+ */
+export declare const MAX_SUMMARY_CHARS = 120;
+export declare function toSummaryText(value: string): string | undefined;
+//# sourceMappingURL=summary-text.d.ts.map

package/dist/paseo-tool-presentation/summary-text.js

@@ -0,0 +1,22 @@
+/**
+ * Prompts and results can be one enormous line. Summaries are capped here so no
+ * consumer relies on its renderer to clip them.
+ */
+export const MAX_SUMMARY_CHARS = 120;
+// Bounds the whitespace scan: inputs can be megabytes.
+const SCAN_WINDOW_CHARS = MAX_SUMMARY_CHARS * 4;
+export function toSummaryText(value) {
+    const isPartial = value.length > SCAN_WINDOW_CHARS;
+    const collapsed = value.slice(0, SCAN_WINDOW_CHARS).replace(/\s+/g, " ").trim();
+    if (!collapsed)
+        return undefined;
+    if (collapsed.length <= MAX_SUMMARY_CHARS && !isPartial)
+        return collapsed;
+    const kept = dropTrailingHighSurrogate(collapsed.slice(0, MAX_SUMMARY_CHARS - 1)).trimEnd();
+    return `${kept}…`;
+}
+function dropTrailingHighSurrogate(text) {
+    const last = text.charCodeAt(text.length - 1);
+    return last >= 0xd800 && last <= 0xdbff ? text.slice(0, -1) : text;
+}
+//# sourceMappingURL=summary-text.js.map

package/dist/provider-icon-names.js

@@ -1,4 +1,5 @@
 export const BUILTIN_PROVIDER_ICON_NAMES = [
+    "antigravity",
     "claude",
     "codex",
     "copilot",
@@ -21,6 +22,7 @@ export const ACP_PROVIDER_ICON_NAMES = [
     "crow-cli",
     "cursor",
     "deepagents",
+    "devin",
     "dimcode",
     "dirac",
     "factory-droid",
@@ -30,6 +32,7 @@ export const ACP_PROVIDER_ICON_NAMES = [
     "glm-acp-agent",
     "goose",
     "grok",
+    "hermes",
     "hoplite",
     "junie",
     "kilo",

package/dist/tool-call-display.d.ts

@@ -1,6 +1,8 @@
 import type { ToolCallTimelineItem } from "./agent-types.js";
 export type ToolCallDisplayInput = Pick<ToolCallTimelineItem, "name" | "status" | "error" | "metadata" | "detail" | "agentMessage"> & {
     cwd?: string;
+    /** Title of the agent a Paseo call targets, when the caller knows it. */
+    targetAgentTitle?: string;
 };
 export interface ToolCallDisplayModel {
     displayName: string;