@camerontaylor/paseo-protocol 0.12.0-beta.1.fork.1 → 0.13.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/plugin-registry.d.ts

@@ -19,10 +19,22 @@ export declare const PluginRegistryArtifactSchema: z.ZodDiscriminatedUnion<[z.Zo
     commit: z.ZodString;
     pluginPath: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>], "kind">;
+/**
+ * Listing text in other languages, keyed by language tag such as `zh-CN`. A missing field falls back
+ * to the English `name` or `description`, which stay required so older clients keep working.
+ */
+export declare const PluginListingTranslationsSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
 export declare const PublishedPluginSchema: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
     description: z.ZodString;
+    translations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
     license: z.ZodOptional<z.ZodString>;
     categories: z.ZodArray<z.ZodString>;
     author: z.ZodObject<{
@@ -60,6 +72,10 @@ export declare const PublishedPluginDetailSchema: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
     description: z.ZodString;
+    translations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
     license: z.ZodOptional<z.ZodString>;
     categories: z.ZodArray<z.ZodString>;
     author: z.ZodObject<{
@@ -91,6 +107,7 @@ export declare const PublishedPluginDetailSchema: z.ZodObject<{
     publishedAt: z.ZodString;
     installs: z.ZodOptional<z.ZodNumber>;
     readme: z.ZodString;
+    overviewTranslations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, z.core.$strip>;
 export declare const PluginRegistryIndexSchema: z.ZodObject<{
     schemaVersion: z.ZodLiteral<1>;
@@ -107,6 +124,10 @@ export declare const PluginRegistryIndexSchema: z.ZodObject<{
         id: z.ZodString;
         name: z.ZodString;
         description: z.ZodString;
+        translations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
         license: z.ZodOptional<z.ZodString>;
         categories: z.ZodArray<z.ZodString>;
         author: z.ZodObject<{

package/dist/plugin-registry.js

@@ -25,10 +25,16 @@ export const PluginRegistryArtifactSchema = z.discriminatedUnion("kind", [
             .optional(),
     }),
 ]);
+/**
+ * Listing text in other languages, keyed by language tag such as `zh-CN`. A missing field falls back
+ * to the English `name` or `description`, which stay required so older clients keep working.
+ */
+export const PluginListingTranslationsSchema = z.record(z.string(), z.object({ name: z.string().optional(), description: z.string().optional() }));
 export const PublishedPluginSchema = z.object({
     id: PluginRegistryIdSchema,
     name: z.string(),
     description: z.string(),
+    translations: PluginListingTranslationsSchema.optional(),
     license: z.string().optional(),
     categories: z.array(z.string()),
     author: z.object({ github: z.string(), name: z.string().optional(), npm: z.string().optional() }),
@@ -49,7 +55,11 @@ export function pluginMediaKind(url) {
     const extension = new URL(url).pathname.split(".").pop()?.toLowerCase() ?? "";
     return VIDEO_EXTENSIONS.has(extension) ? "video" : "image";
 }
-export const PublishedPluginDetailSchema = PublishedPluginSchema.extend({ readme: z.string() });
+export const PublishedPluginDetailSchema = PublishedPluginSchema.extend({
+    readme: z.string(),
+    /** The overview in other languages, keyed like `translations`. Each one replaces `readme` whole. */
+    overviewTranslations: z.record(z.string(), z.string()).optional(),
+});
 export const PluginRegistryIndexSchema = z.object({
     schemaVersion: z.literal(1),
     registry: z.object({ name: z.string(), url: z.string().url() }),

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/schedule/rpc-schemas.d.ts

@@ -112,12 +112,12 @@ export declare const ScheduleCreateResponseSchema: z.ZodObject<{
         schedule: z.ZodNullable<z.ZodObject<{
             name: z.ZodNullable<z.ZodString>;
             id: z.ZodString;
-            updatedAt: z.ZodString;
             status: z.ZodEnum<{
                 completed: "completed";
                 active: "active";
                 paused: "paused";
             }>;
+            updatedAt: z.ZodString;
             createdAt: z.ZodString;
             cadence: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 type: z.ZodLiteral<"every">;
@@ -167,12 +167,12 @@ export declare const ScheduleListResponseSchema: z.ZodObject<{
         schedules: z.ZodArray<z.ZodObject<{
             name: z.ZodNullable<z.ZodString>;
             id: z.ZodString;
-            updatedAt: z.ZodString;
             status: z.ZodEnum<{
                 completed: "completed";
                 active: "active";
                 paused: "paused";
             }>;
+            updatedAt: z.ZodString;
             createdAt: z.ZodString;
             cadence: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 type: z.ZodLiteral<"every">;
@@ -314,12 +314,12 @@ export declare const SchedulePauseResponseSchema: z.ZodObject<{
         schedule: z.ZodNullable<z.ZodObject<{
             name: z.ZodNullable<z.ZodString>;
             id: z.ZodString;
-            updatedAt: z.ZodString;
             status: z.ZodEnum<{
                 completed: "completed";
                 active: "active";
                 paused: "paused";
             }>;
+            updatedAt: z.ZodString;
             createdAt: z.ZodString;
             cadence: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 type: z.ZodLiteral<"every">;
@@ -369,12 +369,12 @@ export declare const ScheduleResumeResponseSchema: z.ZodObject<{
         schedule: z.ZodNullable<z.ZodObject<{
             name: z.ZodNullable<z.ZodString>;
             id: z.ZodString;
-            updatedAt: z.ZodString;
             status: z.ZodEnum<{
                 completed: "completed";
                 active: "active";
                 paused: "paused";
             }>;
+            updatedAt: z.ZodString;
             createdAt: z.ZodString;
             cadence: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 type: z.ZodLiteral<"every">;

package/dist/schedule/types.d.ts

@@ -121,12 +121,12 @@ export type StoredSchedule = z.infer<typeof StoredScheduleSchema>;
 export declare const ScheduleSummarySchema: z.ZodObject<{
     name: z.ZodNullable<z.ZodString>;
     id: z.ZodString;
-    updatedAt: z.ZodString;
     status: z.ZodEnum<{
         completed: "completed";
         active: "active";
         paused: "paused";
     }>;
+    updatedAt: z.ZodString;
     createdAt: z.ZodString;
     cadence: z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"every">;

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;

package/dist/tool-call-display.js

@@ -1,5 +1,4 @@
-import { buildAgentMessageDisplay } from "./agent-message-display.js";
-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);
@@ -12,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;
     }
@@ -121,8 +114,20 @@ function buildUnknownDetailOverride(input) {
     return {};
 }
 export function buildToolCallDisplayModel(input) {
-    if (input.agentMessage) {
-        return { displayName: buildAgentMessageDisplay(input.agentMessage).displayName };
+    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);
@@ -130,7 +135,6 @@ export function buildToolCallDisplayModel(input) {
         canonicalDisplay.displayName ??
         humanizeToolName(input.name);
     const summary = unknownDetailOverride.summary ?? canonicalDisplay.summary;
-    const errorText = input.status === "failed" ? formatErrorText(input.error) : undefined;
     return {
         displayName,
         ...(summary ? { summary } : {}),