@getpaseo/protocol 0.1.96 → 0.1.97-beta.2

package/dist/messages.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { TerminalActivitySchema } from "./terminal-activity.js";
 import { CLIENT_CAPS } from "./client-capabilities.js";
 import { AGENT_LIFECYCLE_STATUSES } from "./agent-lifecycle.js";
 import { MAX_EXPLICIT_AGENT_TITLE_CHARS } from "@getpaseo/protocol/agent-title-limits";
@@ -57,6 +58,7 @@ export const MutableDaemonConfigSchema = z
     providers: z.record(z.string(), MutableDaemonProviderConfigSchema).default({}),
     metadataGeneration: MutableMetadataGenerationConfigSchema.default({ providers: [] }),
     autoArchiveAfterMerge: z.boolean().default(false),
+    enableTerminalAgentHooks: z.boolean().default(false),
     appendSystemPrompt: z.string().default(""),
     terminalProfiles: z.array(TerminalProfileSchema).optional(),
 })
@@ -69,6 +71,7 @@ export const MutableDaemonConfigPatchSchema = z
         .optional(),
     metadataGeneration: MutableMetadataGenerationConfigSchema.partial().optional(),
     autoArchiveAfterMerge: z.boolean().optional(),
+    enableTerminalAgentHooks: z.boolean().optional(),
     appendSystemPrompt: z.string().optional(),
     terminalProfiles: z.array(TerminalProfileSchema).optional(),
 })
@@ -516,6 +519,7 @@ export const AgentSnapshotPayloadSchema = z.object({
     id: z.string(),
     provider: AgentProviderSchema,
     cwd: z.string(),
+    workspaceId: z.string().optional(),
     model: z.string().nullable(),
     features: z.array(AgentFeatureSchema).optional(),
     thinkingOptionId: z.string().nullable().optional(),
@@ -624,6 +628,13 @@ export const ProjectRenameRequestSchema = z.object({
     customName: z.string().nullable(),
     requestId: z.string(),
 });
+export const WorkspaceTitleSetRequestSchema = z.object({
+    type: z.literal("workspace.title.set.request"),
+    workspaceId: z.string(),
+    // Null or empty string clears the title and reverts to the derived name.
+    title: z.string().nullable(),
+    requestId: z.string(),
+});
 export const SetVoiceModeMessageSchema = z.object({
     type: z.literal("set_voice_mode"),
     enabled: z.boolean(),
@@ -760,6 +771,7 @@ export const FetchWorkspacesRequestMessageSchema = z.object({
         .object({
         query: z.string().optional(),
         projectId: z.string().optional(),
+        // Unused: accepted so older clients still parse, but the server does not filter on it.
         idPrefix: z.string().optional(),
     })
         .optional(),
@@ -1085,6 +1097,17 @@ export const ProjectRenameResponseSchema = z.object({
     type: z.literal("project.rename.response"),
     payload: ProjectRenameResponsePayloadSchema,
 });
+export const WorkspaceTitleSetResponsePayloadSchema = z.object({
+    requestId: z.string(),
+    workspaceId: z.string(),
+    accepted: z.boolean(),
+    title: z.string().nullable(),
+    error: z.string().nullable(),
+});
+export const WorkspaceTitleSetResponseSchema = z.object({
+    type: z.literal("workspace.title.set.response"),
+    payload: WorkspaceTitleSetResponsePayloadSchema,
+});
 export const SetVoiceModeResponseMessageSchema = z.object({
     type: z.literal("set_voice_mode_response"),
     payload: z.object({
@@ -1304,6 +1327,22 @@ export const PaseoWorktreeArchiveRequestSchema = z.object({
     worktreePath: z.string().optional(),
     repoRoot: z.string().optional(),
     branchName: z.string().optional(),
+    // COMPAT(worktreeArchiveWorkspaceId): added in v0.1.97, drop the optional gate when floor >= v0.1.97.
+    // Explicit workspace record to archive. A directory can back multiple workspaces
+    // (Model B), so resolving the target by cwd alone picks the wrong record. When
+    // present the daemon archives this exact workspace; when absent it falls back to
+    // resolving by worktreePath, preferring the worktree-kind record on a cwd tie.
+    workspaceId: z.string().optional(),
+    // COMPAT(worktreeArchiveScope): added in v0.1.97, drop the gate when floor >= v0.1.97.
+    // Scope of the archive operation. "workspace" archives a single workspace record
+    // (today's default UI behavior). "worktree" archives every active workspace whose
+    // cwd resolves to the target directory, then removes the directory if it is
+    // Paseo-owned. Omitted/unknown values default to "workspace" for old-client safety.
+    scope: z.enum(["workspace", "worktree"]).optional().default("workspace"),
+    // COMPAT(worktreeDiskDeletion): added in v0.1.97, ignored as of v0.1.97
+    // (disk removal derived from scope + last-reference + ownership); field
+    // retained for wire parse-compat, drop when floor >= v0.1.97.
+    deleteWorktreeFromDisk: z.boolean().optional().default(false),
     requestId: z.string(),
 });
 export const FirstAgentContextSchema = z.object({
@@ -1343,6 +1382,7 @@ export const LegacyOpenInEditorRequestSchema = z.object({
 });
 export const OpenProjectRequestSchema = z.object({
     type: z.literal("open_project_request"),
+    // Path used only for workspace lookup/creation. Use the returned workspace.id for all subsequent references.
     cwd: z.string(),
     requestId: z.string(),
 });
@@ -1351,6 +1391,37 @@ export const ArchiveWorkspaceRequestSchema = z.object({
     workspaceId: z.string(),
     requestId: z.string(),
 });
+// Create a new workspace record. Unlike open_project, this never deduplicates by
+// directory: it always produces a fresh workspace. The source discriminates
+// between an existing local directory and a newly created paseo worktree.
+export const WorkspaceCreateRequestSchema = z.object({
+    type: z.literal("workspace.create.request"),
+    requestId: z.string(),
+    // Optional user-set title applied to the created workspace.
+    title: z.string().optional(),
+    // Optional prompt context for workspace-level name/branch generation.
+    firstAgentContext: FirstAgentContextSchema.optional(),
+    source: z.discriminatedUnion("kind", [
+        z.object({
+            kind: z.literal("directory"),
+            // Path of the existing checkout/directory to back the workspace.
+            path: z.string(),
+            projectId: z.string().optional(),
+        }),
+        z.object({
+            kind: z.literal("worktree"),
+            // The project whose repo the worktree is cut from.
+            cwd: z.string().optional(),
+            projectId: z.string().optional(),
+            action: z.enum(["branch-off", "checkout"]).optional(),
+            // Target branch name for checkout, or new branch name for branch-off.
+            refName: z.string().min(1).optional(),
+            baseBranch: z.string().optional(),
+            githubPrNumber: z.number().int().positive().optional(),
+            worktreeSlug: z.string().optional(),
+        }),
+    ]),
+});
 export const WorkspaceClearAttentionRequestSchema = z.object({
     type: z.literal("workspace.clear_attention.request"),
     workspaceId: z.union([z.string(), z.array(z.string())]),
@@ -1439,6 +1510,8 @@ export const ClientHeartbeatMessageSchema = z.object({
     type: z.literal("client_heartbeat"),
     deviceType: z.enum(["web", "mobile"]),
     focusedAgentId: z.string().nullable(),
+    // COMPAT(terminalFocusHeartbeat): added in v0.1.97, remove optional default after 2026-12-13 once old clients no longer send heartbeats without terminal focus.
+    focusedTerminalId: z.string().nullable().optional().default(null),
     lastActivityAt: z.string(),
     appVisible: z.boolean(),
     appVisibilityChangedAt: z.string().optional(),
@@ -1477,19 +1550,23 @@ export const RegisterPushTokenMessageSchema = z.object({
 export const ListTerminalsRequestSchema = z.object({
     type: z.literal("list_terminals_request"),
     cwd: z.string().optional(),
+    workspaceId: z.string().optional(),
     requestId: z.string(),
 });
 export const SubscribeTerminalsRequestSchema = z.object({
     type: z.literal("subscribe_terminals_request"),
     cwd: z.string(),
+    workspaceId: z.string().optional(),
 });
 export const UnsubscribeTerminalsRequestSchema = z.object({
     type: z.literal("unsubscribe_terminals_request"),
     cwd: z.string(),
+    workspaceId: z.string().optional(),
 });
 export const CreateTerminalRequestSchema = z.object({
     type: z.literal("create_terminal_request"),
     cwd: z.string(),
+    workspaceId: z.string().optional(),
     name: z.string().optional(),
     agentId: z.string().optional(),
     command: z.string().optional(),
@@ -1572,6 +1649,7 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     CloseItemsRequestMessageSchema,
     UpdateAgentRequestMessageSchema,
     ProjectRenameRequestSchema,
+    WorkspaceTitleSetRequestSchema,
     SetVoiceModeMessageSchema,
     SendAgentMessageRequestSchema,
     WaitForFinishRequestSchema,
@@ -1638,6 +1716,7 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     LegacyOpenInEditorRequestSchema,
     OpenProjectRequestSchema,
     ArchiveWorkspaceRequestSchema,
+    WorkspaceCreateRequestSchema,
     WorkspaceClearAttentionRequestSchema,
     FileExplorerRequestSchema,
     ProjectIconRequestSchema,
@@ -1835,6 +1914,8 @@ export const ServerInfoStatusPayloadSchema = z
         rewind: z.boolean().optional(),
         // COMPAT(checkoutRefresh): added in v0.1.86, remove gate after 2026-11-29.
         checkoutRefresh: z.boolean().optional(),
+        // COMPAT(workspaceMultiplicity): added in v0.1.97, drop the gate when floor >= v0.1.97
+        workspaceMultiplicity: z.boolean().optional(),
     })
         .optional(),
 })
@@ -2078,6 +2159,12 @@ export const WorkspaceDescriptorPayloadSchema = z
     // COMPAT(workspaces): keep legacy directory workspace kind parseable.
     workspaceKind: z.enum(["directory", "local_checkout", "checkout", "worktree"]),
     name: z.string(),
+    // COMPAT(workspaceTitles): added in v0.1.97, drop the optional gate when floor >= v0.1.97.
+    // When the user has titled a workspace, `name` carries the resolved value
+    // (title) and `title` mirrors the raw override so the rename UI can prefill
+    // its input and offer a "reset to branch name" action. Null means the name
+    // is derived from the branch/directory.
+    title: z.string().nullable().optional(),
     archivingAt: z.string().nullable().optional().default(null),
     status: WorkspaceStateBucketSchema,
     // Best-effort workspace status entry timestamp. Old daemons omit the
@@ -2178,12 +2265,26 @@ export const FetchRecentProviderSessionsResponseMessageSchema = z.object({
         filteredAlreadyImportedCount: z.number().int().nonnegative().optional(),
     }),
 });
+// COMPAT(workspaceProjects): added in v0.1.97, drop the optional gate when floor >= v0.1.97.
+// A project parent that has zero active workspaces. The sidebar renders it as an
+// empty project row so projects persist after their last workspace is archived.
+export const WorkspaceProjectDescriptorPayloadSchema = z.object({
+    projectId: z.string(),
+    projectDisplayName: z.string(),
+    projectCustomName: z.string().nullable().optional(),
+    projectRootPath: z.string(),
+    projectKind: z.enum(["git", "non_git", "directory"]),
+});
 export const FetchWorkspacesResponseMessageSchema = z.object({
     type: z.literal("fetch_workspaces_response"),
     payload: z.object({
         requestId: z.string(),
         subscriptionId: z.string().nullable().optional(),
         entries: z.array(WorkspaceDescriptorPayloadSchema),
+        // COMPAT(workspaceProjects): added in v0.1.97, drop the optional gate when floor >= v0.1.97.
+        // Project parents with no active workspaces. Old daemons omit it; old clients
+        // ignore it. Only populated on the first page (no cursor).
+        emptyProjects: z.array(WorkspaceProjectDescriptorPayloadSchema).optional().default([]),
         pageInfo: z.object({
             nextCursor: z.string().nullable(),
             prevCursor: z.string().nullable(),
@@ -2201,6 +2302,13 @@ export const WorkspaceUpdateMessageSchema = z.object({
         z.object({
             kind: z.literal("remove"),
             id: z.string(),
+            // COMPAT(workspaceProjects): added in v0.1.97, drop the optional gate when floor >= v0.1.97.
+            // When archiving this workspace leaves its project with no active
+            // workspaces, the daemon includes the now-empty project parent so the
+            // sidebar keeps rendering it without waiting for a full re-hydration. Old
+            // daemons omit it; old clients ignore it and surface the empty project on
+            // their next workspace fetch instead.
+            emptyProject: WorkspaceProjectDescriptorPayloadSchema.optional(),
         }),
     ]),
 });
@@ -2344,6 +2452,16 @@ export const ClearAgentAttentionResponseMessageSchema = z.object({
         agents: z.array(AgentSnapshotPayloadSchema),
     }),
 });
+export const WorkspaceCreateResponseSchema = z.object({
+    type: z.literal("workspace.create.response"),
+    payload: z.object({
+        workspace: WorkspaceDescriptorPayloadSchema.nullable(),
+        setupTerminalId: z.string().nullable(),
+        error: z.string().nullable(),
+        errorCode: z.string().optional(),
+        requestId: z.string(),
+    }),
+});
 export const WorkspaceClearAttentionResponseSchema = z.object({
     type: z.literal("workspace.clear_attention.response"),
     payload: z.object({
@@ -3192,7 +3310,9 @@ const TerminalInfoSchema = z.object({
     id: z.string(),
     name: z.string(),
     cwd: z.string(),
+    workspaceId: z.string().optional(),
     title: z.string().optional(),
+    activity: TerminalActivitySchema.nullable().optional(),
 });
 export const TerminalCellSchema = z.object({
     char: z.string(),
@@ -3300,6 +3420,19 @@ export const TerminalStreamExitSchema = z.object({
         terminalId: z.string(),
     }),
 });
+export const TerminalAttentionRequiredSchema = z.object({
+    type: z.literal("terminal_attention_required"),
+    payload: z.object({
+        serverId: z.string().optional(),
+        terminalId: z.string(),
+        cwd: z.string(),
+        workspaceId: z.string().optional(),
+        reason: z.enum(["finished", "needs_input"]),
+        title: z.string(),
+        body: z.string(),
+        shouldNotify: z.boolean(),
+    }),
+});
 export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     ActivityLogMessageSchema,
     AssistantChunkMessageSchema,
@@ -3335,6 +3468,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     FetchAgentTimelineResponseMessageSchema,
     CancelAgentResponseMessageSchema,
     ClearAgentAttentionResponseMessageSchema,
+    WorkspaceCreateResponseSchema,
     WorkspaceClearAttentionResponseSchema,
     SendAgentMessageResponseMessageSchema,
     SetVoiceModeResponseMessageSchema,
@@ -3351,6 +3485,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     AgentRewindResponseMessageSchema,
     UpdateAgentResponseMessageSchema,
     ProjectRenameResponseSchema,
+    WorkspaceTitleSetResponseSchema,
     WaitForFinishResponseMessageSchema,
     AgentPermissionRequestMessageSchema,
     AgentPermissionResolvedMessageSchema,
@@ -3406,6 +3541,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     KillTerminalResponseSchema,
     CaptureTerminalResponseSchema,
     TerminalStreamExitSchema,
+    TerminalAttentionRequiredSchema,
     ChatCreateResponseSchema,
     ChatListResponseSchema,
     ChatInspectResponseSchema,

package/dist/paseo-config-schema.d.ts

@@ -35,7 +35,7 @@ export declare const PaseoMetadataGenerationEntrySchema: z.ZodCatch<z.ZodObject<
     instructions: z.ZodOptional<z.ZodString>;
 }, z.ZodTypeAny, "passthrough">>>;
 export declare const PaseoMetadataGenerationSchema: z.ZodCatch<z.ZodObject<{
-    agentTitle: z.ZodOptional<z.ZodCatch<z.ZodObject<{
+    title: z.ZodOptional<z.ZodCatch<z.ZodObject<{
         instructions: z.ZodOptional<z.ZodString>;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
         instructions: z.ZodOptional<z.ZodString>;
@@ -64,7 +64,7 @@ export declare const PaseoMetadataGenerationSchema: z.ZodCatch<z.ZodObject<{
         instructions: z.ZodOptional<z.ZodString>;
     }, z.ZodTypeAny, "passthrough">>>>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-    agentTitle: z.ZodOptional<z.ZodCatch<z.ZodObject<{
+    title: z.ZodOptional<z.ZodCatch<z.ZodObject<{
         instructions: z.ZodOptional<z.ZodString>;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
         instructions: z.ZodOptional<z.ZodString>;
@@ -93,7 +93,7 @@ export declare const PaseoMetadataGenerationSchema: z.ZodCatch<z.ZodObject<{
         instructions: z.ZodOptional<z.ZodString>;
     }, z.ZodTypeAny, "passthrough">>>>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-    agentTitle: z.ZodOptional<z.ZodCatch<z.ZodObject<{
+    title: z.ZodOptional<z.ZodCatch<z.ZodObject<{
         instructions: z.ZodOptional<z.ZodString>;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
         instructions: z.ZodOptional<z.ZodString>;
@@ -150,7 +150,7 @@ export declare const PaseoConfigRawSchema: z.ZodObject<{
         port: z.ZodOptional<z.ZodUnknown>;
     }, z.ZodTypeAny, "passthrough">>>>;
     metadataGeneration: z.ZodOptional<z.ZodCatch<z.ZodObject<{
-        agentTitle: z.ZodOptional<z.ZodCatch<z.ZodObject<{
+        title: z.ZodOptional<z.ZodCatch<z.ZodObject<{
             instructions: z.ZodOptional<z.ZodString>;
         }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
             instructions: z.ZodOptional<z.ZodString>;
@@ -179,7 +179,7 @@ export declare const PaseoConfigRawSchema: z.ZodObject<{
             instructions: z.ZodOptional<z.ZodString>;
         }, z.ZodTypeAny, "passthrough">>>>;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        agentTitle: z.ZodOptional<z.ZodCatch<z.ZodObject<{
+        title: z.ZodOptional<z.ZodCatch<z.ZodObject<{
             instructions: z.ZodOptional<z.ZodString>;
         }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
             instructions: z.ZodOptional<z.ZodString>;
@@ -208,7 +208,7 @@ export declare const PaseoConfigRawSchema: z.ZodObject<{
             instructions: z.ZodOptional<z.ZodString>;
         }, z.ZodTypeAny, "passthrough">>>>;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        agentTitle: z.ZodOptional<z.ZodCatch<z.ZodObject<{
+        title: z.ZodOptional<z.ZodCatch<z.ZodObject<{
             instructions: z.ZodOptional<z.ZodString>;
         }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
             instructions: z.ZodOptional<z.ZodString>;
@@ -265,7 +265,7 @@ export declare const PaseoConfigRawSchema: z.ZodObject<{
         port: z.ZodOptional<z.ZodUnknown>;
     }, z.ZodTypeAny, "passthrough">>>>;
     metadataGeneration: z.ZodOptional<z.ZodCatch<z.ZodObject<{
-        agentTitle: z.ZodOptional<z.ZodCatch<z.ZodObject<{
+        title: z.ZodOptional<z.ZodCatch<z.ZodObject<{
             instructions: z.ZodOptional<z.ZodString>;
         }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
             instructions: z.ZodOptional<z.ZodString>;
@@ -294,7 +294,7 @@ export declare const PaseoConfigRawSchema: z.ZodObject<{
             instructions: z.ZodOptional<z.ZodString>;
         }, z.ZodTypeAny, "passthrough">>>>;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        agentTitle: z.ZodOptional<z.ZodCatch<z.ZodObject<{
+        title: z.ZodOptional<z.ZodCatch<z.ZodObject<{
             instructions: z.ZodOptional<z.ZodString>;
         }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
             instructions: z.ZodOptional<z.ZodString>;
@@ -323,7 +323,7 @@ export declare const PaseoConfigRawSchema: z.ZodObject<{
             instructions: z.ZodOptional<z.ZodString>;
         }, z.ZodTypeAny, "passthrough">>>>;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        agentTitle: z.ZodOptional<z.ZodCatch<z.ZodObject<{
+        title: z.ZodOptional<z.ZodCatch<z.ZodObject<{
             instructions: z.ZodOptional<z.ZodString>;
         }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
             instructions: z.ZodOptional<z.ZodString>;
@@ -380,7 +380,7 @@ export declare const PaseoConfigRawSchema: z.ZodObject<{
         port: z.ZodOptional<z.ZodUnknown>;
     }, z.ZodTypeAny, "passthrough">>>>;
     metadataGeneration: z.ZodOptional<z.ZodCatch<z.ZodObject<{
-        agentTitle: z.ZodOptional<z.ZodCatch<z.ZodObject<{
+        title: z.ZodOptional<z.ZodCatch<z.ZodObject<{
             instructions: z.ZodOptional<z.ZodString>;
         }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
             instructions: z.ZodOptional<z.ZodString>;
@@ -409,7 +409,7 @@ export declare const PaseoConfigRawSchema: z.ZodObject<{
             instructions: z.ZodOptional<z.ZodString>;
         }, z.ZodTypeAny, "passthrough">>>>;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        agentTitle: z.ZodOptional<z.ZodCatch<z.ZodObject<{
+        title: z.ZodOptional<z.ZodCatch<z.ZodObject<{
             instructions: z.ZodOptional<z.ZodString>;
         }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
             instructions: z.ZodOptional<z.ZodString>;
@@ -438,7 +438,7 @@ export declare const PaseoConfigRawSchema: z.ZodObject<{
             instructions: z.ZodOptional<z.ZodString>;
         }, z.ZodTypeAny, "passthrough">>>>;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        agentTitle: z.ZodOptional<z.ZodCatch<z.ZodObject<{
+        title: z.ZodOptional<z.ZodCatch<z.ZodObject<{
             instructions: z.ZodOptional<z.ZodString>;
         }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
             instructions: z.ZodOptional<z.ZodString>;
@@ -528,7 +528,7 @@ export declare const PaseoConfigSchema: z.ZodCatch<z.ZodObject<{} & {
         port: z.ZodOptional<z.ZodUnknown>;
     }, z.ZodTypeAny, "passthrough">>>>>>;
     metadataGeneration: z.ZodOptional<z.ZodCatch<z.ZodObject<{
-        agentTitle: z.ZodOptional<z.ZodCatch<z.ZodObject<{
+        title: z.ZodOptional<z.ZodCatch<z.ZodObject<{
             instructions: z.ZodOptional<z.ZodString>;
         }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
             instructions: z.ZodOptional<z.ZodString>;
@@ -557,7 +557,7 @@ export declare const PaseoConfigSchema: z.ZodCatch<z.ZodObject<{} & {
             instructions: z.ZodOptional<z.ZodString>;
         }, z.ZodTypeAny, "passthrough">>>>;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        agentTitle: z.ZodOptional<z.ZodCatch<z.ZodObject<{
+        title: z.ZodOptional<z.ZodCatch<z.ZodObject<{
             instructions: z.ZodOptional<z.ZodString>;
         }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
             instructions: z.ZodOptional<z.ZodString>;
@@ -586,7 +586,7 @@ export declare const PaseoConfigSchema: z.ZodCatch<z.ZodObject<{} & {
             instructions: z.ZodOptional<z.ZodString>;
         }, z.ZodTypeAny, "passthrough">>>>;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        agentTitle: z.ZodOptional<z.ZodCatch<z.ZodObject<{
+        title: z.ZodOptional<z.ZodCatch<z.ZodObject<{
             instructions: z.ZodOptional<z.ZodString>;
         }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
             instructions: z.ZodOptional<z.ZodString>;
@@ -646,7 +646,7 @@ export declare const PaseoConfigSchema: z.ZodCatch<z.ZodObject<{} & {
         port: z.ZodOptional<z.ZodUnknown>;
     }, z.ZodTypeAny, "passthrough">>>>>>;
     metadataGeneration: z.ZodOptional<z.ZodCatch<z.ZodObject<{
-        agentTitle: z.ZodOptional<z.ZodCatch<z.ZodObject<{
+        title: z.ZodOptional<z.ZodCatch<z.ZodObject<{
             instructions: z.ZodOptional<z.ZodString>;
         }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
             instructions: z.ZodOptional<z.ZodString>;
@@ -675,7 +675,7 @@ export declare const PaseoConfigSchema: z.ZodCatch<z.ZodObject<{} & {
             instructions: z.ZodOptional<z.ZodString>;
         }, z.ZodTypeAny, "passthrough">>>>;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        agentTitle: z.ZodOptional<z.ZodCatch<z.ZodObject<{
+        title: z.ZodOptional<z.ZodCatch<z.ZodObject<{
             instructions: z.ZodOptional<z.ZodString>;
         }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
             instructions: z.ZodOptional<z.ZodString>;
@@ -704,7 +704,7 @@ export declare const PaseoConfigSchema: z.ZodCatch<z.ZodObject<{} & {
             instructions: z.ZodOptional<z.ZodString>;
         }, z.ZodTypeAny, "passthrough">>>>;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        agentTitle: z.ZodOptional<z.ZodCatch<z.ZodObject<{
+        title: z.ZodOptional<z.ZodCatch<z.ZodObject<{
             instructions: z.ZodOptional<z.ZodString>;
         }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
             instructions: z.ZodOptional<z.ZodString>;
@@ -764,7 +764,7 @@ export declare const PaseoConfigSchema: z.ZodCatch<z.ZodObject<{} & {
         port: z.ZodOptional<z.ZodUnknown>;
     }, z.ZodTypeAny, "passthrough">>>>>>;
     metadataGeneration: z.ZodOptional<z.ZodCatch<z.ZodObject<{
-        agentTitle: z.ZodOptional<z.ZodCatch<z.ZodObject<{
+        title: z.ZodOptional<z.ZodCatch<z.ZodObject<{
             instructions: z.ZodOptional<z.ZodString>;
         }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
             instructions: z.ZodOptional<z.ZodString>;
@@ -793,7 +793,7 @@ export declare const PaseoConfigSchema: z.ZodCatch<z.ZodObject<{} & {
             instructions: z.ZodOptional<z.ZodString>;
         }, z.ZodTypeAny, "passthrough">>>>;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        agentTitle: z.ZodOptional<z.ZodCatch<z.ZodObject<{
+        title: z.ZodOptional<z.ZodCatch<z.ZodObject<{
             instructions: z.ZodOptional<z.ZodString>;
         }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
             instructions: z.ZodOptional<z.ZodString>;
@@ -822,7 +822,7 @@ export declare const PaseoConfigSchema: z.ZodCatch<z.ZodObject<{} & {
             instructions: z.ZodOptional<z.ZodString>;
         }, z.ZodTypeAny, "passthrough">>>>;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        agentTitle: z.ZodOptional<z.ZodCatch<z.ZodObject<{
+        title: z.ZodOptional<z.ZodCatch<z.ZodObject<{
             instructions: z.ZodOptional<z.ZodString>;
         }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
             instructions: z.ZodOptional<z.ZodString>;

package/dist/paseo-config-schema.js

@@ -33,11 +33,13 @@ export const PaseoMetadataGenerationEntrySchema = z
     .catch({});
 export const PaseoMetadataGenerationSchema = z
     .object({
-    agentTitle: PaseoMetadataGenerationEntrySchema.optional(),
+    title: PaseoMetadataGenerationEntrySchema.optional(),
     branchName: PaseoMetadataGenerationEntrySchema.optional(),
     commitMessage: PaseoMetadataGenerationEntrySchema.optional(),
     pullRequest: PaseoMetadataGenerationEntrySchema.optional(),
 })
+    // COMPAT(projectMetadataAgentTitle): `agentTitle` project metadata prompts were removed
+    // in v0.1.96; keep legacy paseo.json parseable until 2026-12-16.
     .passthrough()
     .catch({});
 export const PaseoConfigRawSchema = z

package/dist/terminal-activity.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+export declare const TERMINAL_ACTIVITY_STATES: readonly ["idle", "working", "attention"];
+export declare const TERMINAL_ACTIVITY_ATTENTION_REASONS: readonly ["finished", "needs_input"];
+export type TerminalActivityState = (typeof TERMINAL_ACTIVITY_STATES)[number];
+export type TerminalActivityAttentionReason = (typeof TERMINAL_ACTIVITY_ATTENTION_REASONS)[number];
+export declare const TerminalActivitySchema: z.ZodObject<{
+    state: z.ZodCatch<z.ZodEnum<["idle", "working", "attention"]>>;
+    attentionReason: z.ZodCatch<z.ZodOptional<z.ZodNullable<z.ZodEnum<["finished", "needs_input"]>>>>;
+    changedAt: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    state: "idle" | "working" | "attention";
+    changedAt: number;
+    attentionReason?: "finished" | "needs_input" | null | undefined;
+}, {
+    changedAt: number;
+    state?: unknown;
+    attentionReason?: unknown;
+}>;
+export type TerminalActivity = z.infer<typeof TerminalActivitySchema>;
+export type TerminalActivityStatusBucket = "running" | "needs_input" | "attention";
+export declare function deriveTerminalActivityStatusBucket(activity: TerminalActivity | null | undefined): TerminalActivityStatusBucket | null;
+//# sourceMappingURL=terminal-activity.d.ts.map

package/dist/terminal-activity.js

@@ -0,0 +1,25 @@
+import { z } from "zod";
+export const TERMINAL_ACTIVITY_STATES = ["idle", "working", "attention"];
+export const TERMINAL_ACTIVITY_ATTENTION_REASONS = ["finished", "needs_input"];
+export const TerminalActivitySchema = z.object({
+    // Forward-compat: a newer daemon may send a state this client doesn't know.
+    // Degrade unknown states to "idle" (no indicator, no notification) so the
+    // message still parses, instead of a strict enum rejecting the whole payload.
+    state: z.enum(TERMINAL_ACTIVITY_STATES).catch("idle"),
+    attentionReason: z.enum(TERMINAL_ACTIVITY_ATTENTION_REASONS).nullable().optional().catch(null),
+    changedAt: z.number(),
+});
+export function deriveTerminalActivityStatusBucket(activity) {
+    if (!activity)
+        return null;
+    if (activity.attentionReason === "needs_input")
+        return "needs_input";
+    if (activity.attentionReason === "finished")
+        return "attention";
+    if (activity.state === "working")
+        return "running";
+    if (activity.state === "attention")
+        return "needs_input";
+    return null;
+}
+//# sourceMappingURL=terminal-activity.js.map

package/dist/terminal-subscription-key.d.ts

@@ -0,0 +1,2 @@
+export declare function terminalSubscriptionKey(cwd: string, workspaceId: string | undefined): string;
+//# sourceMappingURL=terminal-subscription-key.d.ts.map

package/dist/terminal-subscription-key.js

@@ -0,0 +1,9 @@
+// A terminal directory subscription is scoped to a (cwd, workspaceId) pair, not
+// cwd alone: under Model B two workspaces can share a cwd, and each must track
+// and tear down its own live subscription without disturbing the other. An
+// absent workspaceId (old clients) keys to the cwd on its own. The `::`
+// separator cannot collide with a workspace id, which is always `wks_<hex>`.
+export function terminalSubscriptionKey(cwd, workspaceId) {
+    return workspaceId === undefined ? cwd : `${workspaceId}::${cwd}`;
+}
+//# sourceMappingURL=terminal-subscription-key.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getpaseo/protocol",
-  "version": "0.1.96",
+  "version": "0.1.97-beta.2",
   "description": "Paseo shared protocol schemas and wire types",
   "files": [
     "dist",