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

package/dist/messages.js

@@ -1,4 +1,5 @@
 import { AgentMessageSchema } from "./agent-message.js";
+import { HostsListRequestSchema, HostsAddRequestSchema, HostsUpdateRequestSchema, HostsRemoveRequestSchema, HostsLinkOpenRequestSchema, HostsRouteOpenRequestSchema, HostsRouteFrameRequestSchema, HostsRouteCloseRequestSchema, HostsListResponseSchema, HostsChangedSchema, HostsAddResponseSchema, HostsUpdateResponseSchema, HostsRemoveResponseSchema, HostsLinkOpenResponseSchema, HostsRouteOpenResponseSchema, HostsRouteFrameSchema, HostsRouteClosedSchema, } from "./hosts.js";
 import { PluginRegistryIdentitySchema } from "./plugin-registry.js";
 import { AgentProfileSchema, AgentSkillSelectionSchema } from "./agent-profile.js";
 export { AgentProfileSchema, AgentSkillSelectionSchema, } from "./agent-profile.js";
@@ -73,6 +74,9 @@ const MutableBrowserToolsConfigSchema = z
 const MutableRelayConfigSchema = z
     .object({
     enabled: z.boolean(),
+    // COMPAT(relayProtectedSecurity): added in v0.13.0, keep optional while old daemons are supported.
+    // When true the daemon admits only relay sessions that negotiated protected endpoint security.
+    requireProtectedSecurity: z.boolean().optional(),
 })
     .passthrough();
 export const MutableDaemonConfigSchema = z
@@ -1038,7 +1042,7 @@ export const ReviewAttachmentSchema = z.object({
     type: z.literal("review"),
     mimeType: z.literal("application/paseo-review"),
     cwd: z.string(),
-    mode: z.enum(["uncommitted", "base"]),
+    mode: z.enum(["uncommitted", "base", "all"]),
     baseRef: z.string().nullable().optional(),
     comments: z.array(ReviewAttachmentCommentSchema),
 });
@@ -1244,6 +1248,8 @@ export const SendAgentMessageRequestSchema = z.object({
     text: z.string(),
     /** Opaque sender identity for agent-originated prompts. */
     sourceAgentId: z.string().min(1).optional(),
+    sourceAgentServerId: z.string().min(1).optional(),
+    sessionMode: z.string().optional(),
     messageId: z.string().optional(), // Client-provided ID for deduplication
     activeTurnBehavior: ActiveTurnBehaviorSchema.optional(),
     images: z.array(ImageAttachmentSchema).optional(),
@@ -1960,7 +1966,7 @@ const CheckoutErrorSchema = z.object({
     message: z.string(),
 });
 const CheckoutDiffCompareSchema = z.object({
-    mode: z.enum(["uncommitted", "base"]),
+    mode: z.enum(["uncommitted", "base", "all"]),
     baseRef: z.string().optional(),
     ignoreWhitespace: z.boolean().optional(),
 });
@@ -2522,6 +2528,11 @@ export const WorkspaceSetupStatusRequestSchema = z.object({
     workspaceId: z.string(),
     requestId: z.string(),
 });
+export const WorkspaceSetupSubscribeRequestSchema = z.object({
+    type: z.literal("workspace.setup.subscribe.request"),
+    workspaceId: z.string(),
+    requestId: z.string(),
+});
 export const WorkspaceSetupRunRequestSchema = z.object({
     type: z.literal("workspace.setup.run.request"),
     workspaceId: z.string(),
@@ -2712,6 +2723,10 @@ export const FileVersionSchema = z.discriminatedUnion("status", [
         size: z.number().int().nonnegative(),
         modifiedAt: z.string(),
         revision: z.string().optional(),
+        // Classified from the extension and the first bytes, so a client can choose how to open the
+        // file before reading it.
+        kind: z.enum(["text", "image", "binary"]).optional(),
+        mimeType: z.string().optional(),
     }),
     z.object({
         status: z.literal("missing"),
@@ -2742,6 +2757,8 @@ export const FileWriteRequestSchema = z.object({
     cwd: z.string(),
     path: z.string(),
     content: z.string(),
+    // COMPAT(fileByteWrites): added in v0.13.0. Daemons without the feature write `content` as text.
+    contentEncoding: z.enum(["utf-8", "base64"]).optional(),
     expectedModifiedAt: z.string(),
     expectedRevision: z.string().optional(),
     requestId: z.string(),
@@ -3086,6 +3103,14 @@ export const SubscriptionReleaseResponseSchema = z.object({
     payload: z.object({ requestId: z.string(), subscriptionId: z.string() }),
 });
 export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
+    HostsListRequestSchema,
+    HostsAddRequestSchema,
+    HostsUpdateRequestSchema,
+    HostsRemoveRequestSchema,
+    HostsLinkOpenRequestSchema,
+    HostsRouteOpenRequestSchema,
+    HostsRouteFrameRequestSchema,
+    HostsRouteCloseRequestSchema,
     BrowserHostRegisterRequestSchema,
     SubscriptionReleaseRequestSchema,
     SessionEventsSetSubscriptionRequestSchema,
@@ -3240,6 +3265,7 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     PaseoWorktreeArchiveRequestSchema,
     CreatePaseoWorktreeRequestSchema,
     WorkspaceSetupStatusRequestSchema,
+    WorkspaceSetupSubscribeRequestSchema,
     WorkspaceSetupRunRequestSchema,
     LegacyListAvailableEditorsRequestSchema,
     LegacyOpenInEditorRequestSchema,
@@ -3462,6 +3488,8 @@ export const ServerInfoStatusPayloadSchema = z
     serverId: z.string().trim().min(1),
     hostname: ServerInfoHostnameSchema.optional(),
     version: ServerInfoVersionSchema.optional(),
+    // Authenticated producer for host registration ownership, separate from admission authority.
+    sourceId: z.string().optional(),
     // COMPAT(sessionPermissions): optional while clients support older daemons.
     permissions: z.array(DaemonPermissionSchema).optional(),
     // COMPAT(desktopManaged): added in v0.1.X, remove optional parsing after 2027-01-16.
@@ -3483,6 +3511,8 @@ export const ServerInfoStatusPayloadSchema = z
         internalWorkspaces: z.boolean().optional(),
         backgroundWorkspaces: z.boolean().optional(),
         providersSnapshot: z.boolean().optional(),
+        connectedHosts: z.boolean().optional(),
+        hostMultiplexing: z.boolean().optional(),
         usageSources: z.boolean().optional(),
         usageReportsStreaming: z.boolean().optional(),
         // COMPAT(providersSnapshotCwd): added in v0.3.2, remove gate after 2027-02-10.
@@ -3584,6 +3614,8 @@ export const ServerInfoStatusPayloadSchema = z
         workspaceRecovery: z.boolean().optional(),
         // COMPAT(workspaceFileEditing): added in v0.2.0, remove after 2027-01-18 once daemon floor >= v0.2.0.
         workspaceFileEditing: z.boolean().optional(),
+        // COMPAT(fileByteWrites): added in v0.13.0, remove gate after 2027-04-20.
+        fileByteWrites: z.boolean().optional(),
         // COMPAT(companionStreamPortV1): added in v0.11.0-beta.3-fork, remove after 2027-04-01.
         // Deliberately not the source fork's `companionStream`/`artifactFeed` flags: a client
         // that saw those names would expect the source's flat companion RPC, which this
@@ -3622,6 +3654,9 @@ export const ServerInfoStatusPayloadSchema = z
         workspaceMarkUnread: z.boolean().optional(),
         // COMPAT(hubRelationship): added in v0.1.X, drop the gate when floor >= v0.1.X.
         hubRelationship: z.boolean().optional(),
+        // COMPAT(relayProtectedSecurity): added in v0.13.0. A capable daemon always advertises
+        // it; relay clients that negotiated legacy security reject the connection on seeing it.
+        relayProtectedSecurity: z.boolean().optional(),
         // COMPAT(projectGithubClone): added in v0.1.108, remove gate after 2027-01-15.
         projectGithubClone: z.boolean().optional(),
         // COMPAT(workspaceGithubRepositorySearch): added in v0.1.108, remove gate after 2027-01-15.
@@ -3656,9 +3691,12 @@ export const ServerInfoStatusPayloadSchema = z
         selectiveAgentTimeline: z.boolean().optional(),
         explicitEventSubscriptions: z.boolean().optional(),
         ownedSubscriptions: z.boolean().optional(),
+        workspaceSetupObservation: z.boolean().optional(),
+        workspaceSortTimes: z.boolean().optional(),
         // COMPAT(canonicalSubmittedPrompts): added in v0.2.6, remove gate after 2027-01-30.
         canonicalSubmittedPrompts: z.boolean().optional(),
         agentMessageProvenance: z.boolean().optional(),
+        agentMessageBatching: z.boolean().optional(),
         // COMPAT(agentTurnIdentity): accept peers that observed pre-release v0.2.6 through 2027-01-31.
         agentTurnIdentity: z.boolean().optional(),
         // COMPAT(stableProjectIdentity): added in v0.1.109, remove gate after 2027-01-15.
@@ -3673,6 +3711,7 @@ export const ServerInfoStatusPayloadSchema = z
         fsEntryDuplicate: z.boolean().optional(),
         // COMPAT(checkoutDiscardChanges): added in v0.3.0, remove gate after 2027-02-08.
         checkoutDiscardChanges: z.boolean().optional(),
+        checkoutDiffAll: z.boolean().optional(),
         // COMPAT(agentProfiles): added in v0.3.2, remove gate after 2027-02-11.
         // An older daemon parses its persisted config strictly, so writing
         // agentProfiles to one is silently dropped. The client hides the feature
@@ -3937,6 +3976,8 @@ export const WorkspaceDescriptorPayloadSchema = z
     projectCustomIconRevision: z.string().nullable().optional(),
     projectRootPath: z.string(),
     workspaceDirectory: z.string().optional(),
+    // COMPAT(workspaceSetupObservation): added in v0.12.0, remove optional after 2027-04-19.
+    setupStatus: z.enum(["running", "completed", "failed", "blocked"]).nullable().optional(),
     // COMPAT(worktreeSlug): added in v0.2.6, remove optional after 2027-01-31.
     // Present only for Paseo-owned worktrees; this is the basename of their root directory.
     worktreeSlug: z.string().optional(),
@@ -3968,6 +4009,8 @@ export const WorkspaceDescriptorPayloadSchema = z
         .nullish()
         .transform((value) => value ?? null),
     activityAt: z.string().nullable(),
+    createdAt: z.string().optional(),
+    lastUserMessageAt: z.string().nullable().optional(),
     diffStat: z
         .object({
         additions: z.number(),
@@ -4297,6 +4340,15 @@ export const WorkspaceSetupSnapshotSchema = z.object({
     })
         .optional(),
 });
+export const WorkspaceSetupSubscribeResponseSchema = z.object({
+    type: z.literal("workspace.setup.subscribe.response"),
+    payload: z.object({
+        requestId: z.string(),
+        subscriptionId: z.string().optional(),
+        workspaceId: z.string(),
+        snapshot: WorkspaceSetupSnapshotSchema.nullable(),
+    }),
+});
 export const WorkspaceSetupRunResponseMessageSchema = z.object({
     type: z.literal("workspace.setup.run.response"),
     payload: z.object({
@@ -4854,6 +4906,7 @@ export const SendAgentMessageResponseMessageSchema = z.object({
         requestId: z.string(),
         agentId: z.string(),
         accepted: z.boolean(),
+        deliveryStatus: z.literal("queued").optional(),
         error: z.string().nullable(),
     }),
 });
@@ -6074,14 +6127,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 +6147,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(),
@@ -6530,6 +6589,15 @@ export const AgentSkillsImportLegacySelectionResponseSchema = z.object({
     }),
 });
 export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
+    HostsListResponseSchema,
+    HostsChangedSchema,
+    HostsAddResponseSchema,
+    HostsUpdateResponseSchema,
+    HostsRemoveResponseSchema,
+    HostsLinkOpenResponseSchema,
+    HostsRouteOpenResponseSchema,
+    HostsRouteFrameSchema,
+    HostsRouteClosedSchema,
     AgentCompanionUpdateEntryResponseMessageSchema,
     AgentArtifactsScanResponseMessageSchema,
     BrowserHostRegisterResponseSchema,
@@ -6590,6 +6658,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     ScriptStatusUpdateMessageSchema,
     WorkspaceSetupProgressMessageSchema,
     WorkspaceSetupStatusResponseMessageSchema,
+    WorkspaceSetupSubscribeResponseSchema,
     WorkspaceSetupRunResponseMessageSchema,
     AgentStreamMessageSchema,
     AgentStatusMessageSchema,
@@ -6785,6 +6854,11 @@ export const WSPongMessageSchema = z.object({
 });
 export const WSHelloMessageSchema = z.object({
     type: z.literal("hello"),
+    sessionPermissions: z.array(DaemonPermissionSchema).optional(),
+    routed: z.boolean().optional(),
+    producer: z
+        .object({ serverId: z.string().min(1).max(256), sourceId: z.string().min(1).max(1024) })
+        .optional(),
     clientId: z.string().min(1),
     clientType: z.enum(["mobile", "browser", "cli", "mcp", "hub"]),
     protocolVersion: z.number().int(),

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