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

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,8 @@ export const ACP_PROVIDER_ICON_NAMES = [
     "glm-acp-agent",
     "goose",
     "grok",
+    "hermes",
+    "hoplite",
     "junie",
     "kilo",
     "kimi",

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"> & {
+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;

package/dist/tool-call-display.js

@@ -1,4 +1,4 @@
-import { getPaseoToolLeafName, isPaseoToolName } from "./tool-name-normalization.js";
+import { buildAgentMessageDisplay, buildPaseoToolDisplay, } from "./paseo-tool-presentation/index.js";
 import { stripCwdPrefix } from "./path-utils.js";
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -11,12 +11,6 @@ function humanizeToolName(name) {
     if (!trimmed) {
         return name;
     }
-    if (isPaseoToolName(trimmed)) {
-        const leaf = getPaseoToolLeafName(trimmed);
-        if (leaf) {
-            return humanizeToolName(leaf);
-        }
-    }
     if (/[:./]/.test(trimmed) || trimmed.includes("__")) {
         return trimmed;
     }
@@ -120,13 +114,27 @@ function buildUnknownDetailOverride(input) {
     return {};
 }
 export function buildToolCallDisplayModel(input) {
+    const errorText = input.status === "failed" ? formatErrorText(input.error) : undefined;
+    const paseoDisplay = input.agentMessage
+        ? buildAgentMessageDisplay(input.agentMessage)
+        : buildPaseoToolDisplay({
+            toolName: input.name,
+            detail: input.detail,
+            targetAgentTitle: input.targetAgentTitle,
+        });
+    if (paseoDisplay) {
+        return {
+            displayName: paseoDisplay.displayName,
+            ...(paseoDisplay.summary ? { summary: paseoDisplay.summary } : {}),
+            ...(errorText ? { errorText } : {}),
+        };
+    }
     const canonicalDisplay = buildCanonicalDetailDisplay(input);
     const unknownDetailOverride = buildUnknownDetailOverride(input);
     const displayName = unknownDetailOverride.displayName ??
         canonicalDisplay.displayName ??
         humanizeToolName(input.name);
     const summary = unknownDetailOverride.summary ?? canonicalDisplay.summary;
-    const errorText = input.status === "failed" ? formatErrorText(input.error) : undefined;
     return {
         displayName,
         ...(summary ? { summary } : {}),