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

package/dist/messages.js

@@ -6074,14 +6074,15 @@ export const UsageProblemSchema = z.discriminatedUnion("kind", [
     }),
     z.object({ kind: z.literal("no_quota"), detail: z.string() }),
 ]);
+const AvailableUsageReportSchema = z.object({
+    status: z.literal("available"),
+    planLabel: z.string().optional(),
+    windows: z.array(ProviderUsageWindowSchema),
+    balances: z.array(ProviderUsageBalanceSchema).optional(),
+    details: z.array(ProviderUsageDetailSchema).optional(),
+});
 export const UsageReportSchema = z.discriminatedUnion("status", [
-    z.object({
-        status: z.literal("available"),
-        planLabel: z.string().optional(),
-        windows: z.array(ProviderUsageWindowSchema),
-        balances: z.array(ProviderUsageBalanceSchema).optional(),
-        details: z.array(ProviderUsageDetailSchema).optional(),
-    }),
+    AvailableUsageReportSchema,
     z.object({ status: z.literal("unavailable"), problem: UsageProblemSchema }),
     z.object({ status: z.literal("error"), error: z.string() }),
 ]);
@@ -6093,6 +6094,11 @@ export const UsageReportEntrySchema = z.object({
     sourceLabel: z.string(),
     icon: z.string().optional(),
     report: UsageReportSchema,
+    // Successful completion time; fetchedAt remains the attempt timestamp for ordering.
+    successfulAt: z.string().optional(),
+    lastSuccessful: z
+        .object({ fetchedAt: z.string(), report: AvailableUsageReportSchema })
+        .optional(),
     loginErrors: z
         .array(z.object({
         harness: z.string(),

package/dist/paseo-tool-call-detail.d.ts

@@ -1,15 +1,2 @@
-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;
+export { buildPaseoToolDetailSections, type PaseoToolDetailField, type PaseoToolDetailSection, } from "./paseo-tool-presentation/index.js";
 //# sourceMappingURL=paseo-tool-call-detail.d.ts.map

package/dist/paseo-tool-call-detail.js

@@ -1,307 +1,3 @@
-import { getPaseoToolLeafName } from "./tool-name-normalization.js";
-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 TOOL_SPECS = {
-    create_workspace: {
-        inputOrder: WORKSPACE_FIELDS,
-        outputFields: ["workspaceId", "projectId"],
-    },
-    list_workspaces: {},
-    archive_workspace: {
-        inputOrder: ["workspaceId"],
-        outputFields: ["workspaceId", "archivedAgentIds", "removedDirectory"],
-    },
-    rename_workspace: { inputOrder: ["title", "workspaceId"] },
-    create_agent: {
-        promptField: "initialPrompt",
-        inputOrder: AGENT_FIELDS,
-        outputFields: ["agentId", "status", "currentModeId", "cwd"],
-    },
-    send_agent_prompt: {
-        promptField: "prompt",
-        inputOrder: AGENT_FIELDS,
-        outputFields: ["status", "lastMessage", "permission"],
-    },
-    get_agent_status: { inputOrder: ["agentId"] },
-    list_agents: { inputOrder: ["cwd", "statuses", "sinceHours", "limit", "includeArchived"] },
-    cancel_agent: { inputOrder: ["agentId"] },
-    archive_agent: { inputOrder: ["agentId"] },
-    kill_agent: { inputOrder: ["agentId"] },
-    update_agent: { inputOrder: AGENT_FIELDS },
-    get_agent_activity: { inputOrder: ["agentId", "limit"] },
-    set_agent_mode: { inputOrder: ["agentId", "modeId"] },
-    list_workspace_scripts: { inputOrder: ["workspaceId"] },
-    start_workspace_script: { inputOrder: ["workspaceId", "scriptName"] },
-    stop_workspace_script: { inputOrder: ["workspaceId", "scriptName"] },
-    list_terminals: { inputOrder: ["cwd", "all"] },
-    create_terminal: { inputOrder: ["cwd", "workspaceId", "name", "command"] },
-    kill_terminal: { inputOrder: ["terminalId"] },
-    capture_terminal: { inputOrder: ["terminalId", "lines"] },
-    send_terminal_keys: { inputOrder: ["terminalId", "keys", "literal"] },
-    create_schedule: {
-        promptField: "prompt",
-        inputOrder: AUTOMATION_FIELDS,
-        outputFields: ["id", "status", "nextRunAt", "expiresAt"],
-    },
-    create_heartbeat: {
-        promptField: "prompt",
-        inputOrder: AUTOMATION_FIELDS,
-        outputFields: ["id", "status", "nextRunAt", "expiresAt"],
-    },
-    delete_heartbeat: { inputOrder: ["id"] },
-    list_schedules: {},
-    inspect_schedule: { inputOrder: ["id"] },
-    pause_schedule: { inputOrder: ["id"] },
-    resume_schedule: { inputOrder: ["id"] },
-    delete_schedule: { inputOrder: ["id"] },
-    update_schedule: { promptField: "prompt", inputOrder: AUTOMATION_FIELDS },
-    schedule_logs: { inputOrder: ["id"] },
-    run_schedule_once: { inputOrder: ["id"] },
-    list_providers: {},
-    list_models: { inputOrder: ["provider"] },
-    list_profiles: {},
-    inspect_provider: { inputOrder: ["provider", "cwd", "settings"] },
-    list_pending_permissions: {},
-    respond_to_permission: { inputOrder: ["agentId", "requestId", "response"] },
-    browser_list_tabs: {},
-    browser_new_tab: { inputOrder: BROWSER_FIELDS },
-    browser_snapshot: { inputOrder: BROWSER_FIELDS },
-    browser_click: { inputOrder: BROWSER_FIELDS },
-    browser_fill: { inputOrder: BROWSER_FIELDS },
-    browser_wait: { inputOrder: BROWSER_FIELDS },
-    browser_type: { inputOrder: BROWSER_FIELDS },
-    browser_keypress: { inputOrder: BROWSER_FIELDS },
-    browser_navigate: { inputOrder: BROWSER_FIELDS },
-    browser_back: { inputOrder: BROWSER_FIELDS },
-    browser_forward: { inputOrder: BROWSER_FIELDS },
-    browser_reload: { inputOrder: BROWSER_FIELDS },
-    browser_screenshot: { inputOrder: BROWSER_FIELDS },
-    browser_upload: { inputOrder: BROWSER_FIELDS },
-    browser_hover: { inputOrder: BROWSER_FIELDS },
-    browser_select: { inputOrder: BROWSER_FIELDS },
-    browser_drag: { inputOrder: BROWSER_FIELDS },
-    browser_logs: { inputOrder: BROWSER_FIELDS },
-    browser_evaluate: { inputOrder: BROWSER_FIELDS },
-    browser_scroll: { inputOrder: BROWSER_FIELDS },
-    browser_resize: { inputOrder: BROWSER_FIELDS },
-    browser_close_tab: { inputOrder: BROWSER_FIELDS },
-};
-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 = TOOL_SPECS[leafName] ?? {};
-    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;
-}
+// COMPAT(paseoToolCallDetail): added in v0.12.0, remove after 2027-04-19 once plugins have migrated to paseo-tool-presentation/index.
+export { buildPaseoToolDetailSections, } from "./paseo-tool-presentation/index.js";
 //# sourceMappingURL=paseo-tool-call-detail.js.map

package/dist/paseo-tool-presentation/agent-message.d.ts

@@ -0,0 +1,10 @@
+import type { AgentMessage } from "../agent-message.js";
+import type { ToolCallDetail } from "../agent-types.js";
+export interface AgentMessageDisplay {
+    displayName: string;
+    summary?: string;
+    detail: ToolCallDetail;
+}
+/** Presentation shared by clients; never used to encode provider prompts. */
+export declare function buildAgentMessageDisplay(message: AgentMessage): AgentMessageDisplay;
+//# sourceMappingURL=agent-message.d.ts.map

package/dist/paseo-tool-presentation/agent-message.js

@@ -0,0 +1,22 @@
+import { toSummaryText } from "./summary-text.js";
+/** Events read noun-first ("Agent finished"); the sender goes in the summary. */
+const EVENT_LABELS = {
+    message: "Message received",
+    finished: "Agent finished",
+    errored: "Agent errored",
+    "permission-required": "Agent needs permission",
+    closed: "Agent closed",
+};
+/** Presentation shared by clients; never used to encode provider prompts. */
+export function buildAgentMessageDisplay(message) {
+    const summary = toSummaryText(message.sender.title ?? message.sender.id);
+    return {
+        displayName: EVENT_LABELS[message.event],
+        ...(summary ? { summary } : {}),
+        detail: {
+            type: "plain_text",
+            text: `From agent: ${message.sender.id}\n\n${message.text}`,
+        },
+    };
+}
+//# sourceMappingURL=agent-message.js.map

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