@getpaseo/server 0.1.3 → 0.1.6

package/dist/server/shared/messages.js

@@ -156,6 +156,21 @@ const ToolCallDetailPayloadSchema = z.discriminatedUnion("type", [
         type: z.literal("search"),
         query: z.string(),
     }),
+    z.object({
+        type: z.literal("worktree_setup"),
+        worktreePath: z.string(),
+        branchName: z.string(),
+        log: z.string(),
+        commands: z.array(z.object({
+            index: z.number().int().positive(),
+            command: z.string(),
+            cwd: z.string(),
+            status: z.enum(["running", "completed", "failed"]),
+            exitCode: z.number().nullable(),
+            durationMs: z.number().nonnegative().optional(),
+        })),
+        truncated: z.boolean().optional(),
+    }),
     z.object({
         type: z.literal("unknown"),
         input: UnknownValueSchema,
@@ -390,15 +405,22 @@ export const FetchAgentsRequestMessageSchema = z.object({
     filter: z
         .object({
         labels: z.record(z.string()).optional(),
+        projectKeys: z.array(z.string()).optional(),
+        statuses: z.array(AgentStatusSchema).optional(),
+        includeArchived: z.boolean().optional(),
+        requiresAttention: z.boolean().optional(),
     })
         .optional(),
-});
-export const FetchAgentsGroupedByProjectRequestMessageSchema = z.object({
-    type: z.literal("fetch_agents_grouped_by_project_request"),
-    requestId: z.string(),
-    filter: z
+    sort: z
+        .array(z.object({
+        key: z.enum(["status_priority", "created_at", "updated_at", "title"]),
+        direction: z.enum(["asc", "desc"]),
+    }))
+        .optional(),
+    page: z
         .object({
-        labels: z.record(z.string()).optional(),
+        limit: z.number().int().positive().max(1000),
+        cursor: z.string().min(1).optional(),
     })
         .optional(),
 });
@@ -513,21 +535,20 @@ export const RestartServerRequestMessageSchema = z.object({
     reason: z.string().optional(),
     requestId: z.string(),
 });
-export const InitializeAgentRequestMessageSchema = z.object({
-    type: z.literal("initialize_agent_request"),
+export const AgentTimelineCursorSchema = z.object({
+    epoch: z.string(),
+    seq: z.number().int().nonnegative(),
+});
+export const FetchAgentTimelineRequestMessageSchema = z.object({
+    type: z.literal("fetch_agent_timeline_request"),
     agentId: z.string(),
     requestId: z.string(),
-});
-export const InitializeAgentResponseMessageSchema = z.object({
-    // Response shares the same type literal as the request for simple requestId matching
-    type: z.literal("initialize_agent_request"),
-    payload: z.object({
-        agentId: z.string(),
-        agentStatus: z.string().optional(),
-        timelineSize: z.number().optional(),
-        requestId: z.string(),
-        error: z.string().optional(),
-    }),
+    direction: z.enum(["tail", "before", "after"]).optional(),
+    cursor: AgentTimelineCursorSchema.optional(),
+    // 0 means "all matching rows for this query window".
+    limit: z.number().int().nonnegative().optional(),
+    // Default should be projected for app timeline loading.
+    projection: z.enum(["projected", "canonical"]).optional(),
 });
 export const SetAgentModeRequestMessageSchema = z.object({
     type: z.literal("set_agent_mode_request"),
@@ -591,6 +612,9 @@ export const SetVoiceModeResponseMessageSchema = z.object({
         agentId: z.string().nullable(),
         accepted: z.boolean(),
         error: z.string().nullable(),
+        reasonCode: z.string().optional(),
+        retryable: z.boolean().optional(),
+        missingModelIds: z.array(z.string()).optional(),
     }),
 });
 export const AgentPermissionResponseMessageSchema = z.object({
@@ -675,6 +699,13 @@ export const ValidateBranchRequestSchema = z.object({
     branchName: z.string(),
     requestId: z.string(),
 });
+export const BranchSuggestionsRequestSchema = z.object({
+    type: z.literal("branch_suggestions_request"),
+    cwd: z.string(),
+    query: z.string().optional(),
+    limit: z.number().int().min(1).max(200).optional(),
+    requestId: z.string(),
+});
 export const PaseoWorktreeListRequestSchema = z.object({
     type: z.literal("paseo_worktree_list_request"),
     cwd: z.string().optional(),
@@ -794,6 +825,14 @@ export const ListTerminalsRequestSchema = z.object({
     cwd: z.string(),
     requestId: z.string(),
 });
+export const SubscribeTerminalsRequestSchema = z.object({
+    type: z.literal("subscribe_terminals_request"),
+    cwd: z.string(),
+});
+export const UnsubscribeTerminalsRequestSchema = z.object({
+    type: z.literal("unsubscribe_terminals_request"),
+    cwd: z.string(),
+});
 export const CreateTerminalRequestSchema = z.object({
     type: z.literal("create_terminal_request"),
     cwd: z.string(),
@@ -830,12 +869,24 @@ export const KillTerminalRequestSchema = z.object({
     terminalId: z.string(),
     requestId: z.string(),
 });
+export const AttachTerminalStreamRequestSchema = z.object({
+    type: z.literal("attach_terminal_stream_request"),
+    terminalId: z.string(),
+    resumeOffset: z.number().int().nonnegative().optional(),
+    rows: z.number().int().positive().optional(),
+    cols: z.number().int().positive().optional(),
+    requestId: z.string(),
+});
+export const DetachTerminalStreamRequestSchema = z.object({
+    type: z.literal("detach_terminal_stream_request"),
+    streamId: z.number().int().nonnegative(),
+    requestId: z.string(),
+});
 export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     VoiceAudioChunkMessageSchema,
     AbortRequestMessageSchema,
     AudioPlayedMessageSchema,
     FetchAgentsRequestMessageSchema,
-    FetchAgentsGroupedByProjectRequestMessageSchema,
     FetchAgentRequestMessageSchema,
     SubscribeAgentUpdatesMessageSchema,
     UnsubscribeAgentUpdatesMessageSchema,
@@ -858,7 +909,7 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     RefreshAgentRequestMessageSchema,
     CancelAgentRequestMessageSchema,
     RestartServerRequestMessageSchema,
-    InitializeAgentRequestMessageSchema,
+    FetchAgentTimelineRequestMessageSchema,
     SetAgentModeRequestMessageSchema,
     SetAgentModelRequestMessageSchema,
     SetAgentThinkingRequestMessageSchema,
@@ -873,6 +924,7 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     CheckoutPrCreateRequestSchema,
     CheckoutPrStatusRequestSchema,
     ValidateBranchRequestSchema,
+    BranchSuggestionsRequestSchema,
     PaseoWorktreeListRequestSchema,
     PaseoWorktreeArchiveRequestSchema,
     FileExplorerRequestSchema,
@@ -885,11 +937,15 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     ExecuteCommandRequestSchema,
     RegisterPushTokenMessageSchema,
     ListTerminalsRequestSchema,
+    SubscribeTerminalsRequestSchema,
+    UnsubscribeTerminalsRequestSchema,
     CreateTerminalRequestSchema,
     SubscribeTerminalRequestSchema,
     UnsubscribeTerminalRequestSchema,
     TerminalInputSchema,
     KillTerminalRequestSchema,
+    AttachTerminalStreamRequestSchema,
+    DetachTerminalStreamRequestSchema,
 ]);
 // ============================================================================
 // Session Outbound Messages (Session emits these)
@@ -951,6 +1007,13 @@ export const DictationStreamAckMessageSchema = z.object({
         ackSeq: z.number().int(),
     }),
 });
+export const DictationStreamFinishAcceptedMessageSchema = z.object({
+    type: z.literal("dictation_stream_finish_accepted"),
+    payload: z.object({
+        dictationId: z.string(),
+        timeoutMs: z.number().int().positive(),
+    }),
+});
 export const DictationStreamPartialMessageSchema = z.object({
     type: z.literal("dictation_stream_partial"),
     payload: z.object({
@@ -972,9 +1035,58 @@ export const DictationStreamErrorMessageSchema = z.object({
         dictationId: z.string(),
         error: z.string(),
         retryable: z.boolean(),
+        reasonCode: z.string().optional(),
+        missingModelIds: z.array(z.string()).optional(),
         debugRecordingPath: z.string().optional(),
     }),
 });
+export const ServerCapabilityStateSchema = z.object({
+    enabled: z.boolean(),
+    reason: z.string(),
+});
+export const ServerVoiceCapabilitiesSchema = z.object({
+    dictation: ServerCapabilityStateSchema,
+    voice: ServerCapabilityStateSchema,
+});
+export const ServerCapabilitiesSchema = z
+    .object({
+    voice: ServerVoiceCapabilitiesSchema.optional(),
+})
+    .passthrough();
+const ServerInfoHostnameSchema = z
+    .unknown()
+    .transform((value) => {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+});
+const ServerCapabilitiesFromUnknownSchema = z
+    .unknown()
+    .optional()
+    .transform((value) => {
+    if (value === undefined) {
+        return undefined;
+    }
+    const parsed = ServerCapabilitiesSchema.safeParse(value);
+    if (!parsed.success) {
+        return undefined;
+    }
+    return parsed.data;
+});
+export const ServerInfoStatusPayloadSchema = z
+    .object({
+    status: z.literal("server_info"),
+    serverId: z.string().trim().min(1),
+    hostname: ServerInfoHostnameSchema.optional(),
+    capabilities: ServerCapabilitiesFromUnknownSchema,
+})
+    .passthrough()
+    .transform((payload) => ({
+    ...payload,
+    hostname: payload.hostname ?? null,
+}));
 export const StatusMessageSchema = z.object({
     type: z.literal("status"),
     payload: z
@@ -1107,16 +1219,9 @@ export const AgentStreamMessageSchema = z.object({
         agentId: z.string(),
         event: AgentStreamEventPayloadSchema,
         timestamp: z.string(),
-    }),
-});
-export const AgentStreamSnapshotMessageSchema = z.object({
-    type: z.literal("agent_stream_snapshot"),
-    payload: z.object({
-        agentId: z.string(),
-        events: z.array(z.object({
-            event: AgentStreamEventPayloadSchema,
-            timestamp: z.string(),
-        })),
+        // Present for timeline events. Maps 1:1 to canonical in-memory timeline rows.
+        seq: z.number().int().nonnegative().optional(),
+        epoch: z.string().optional(),
     }),
 });
 export const AgentStatusMessageSchema = z.object({
@@ -1137,30 +1242,59 @@ export const FetchAgentsResponseMessageSchema = z.object({
     type: z.literal("fetch_agents_response"),
     payload: z.object({
         requestId: z.string(),
-        agents: z.array(AgentSnapshotPayloadSchema),
+        entries: z.array(z.object({
+            agent: AgentSnapshotPayloadSchema,
+            project: ProjectPlacementPayloadSchema,
+        })),
+        pageInfo: z.object({
+            nextCursor: z.string().nullable(),
+            prevCursor: z.string().nullable(),
+            hasMore: z.boolean(),
+        }),
     }),
 });
-const ProjectGroupedAgentEntryPayloadSchema = z.object({
-    agent: AgentSnapshotPayloadSchema,
-    checkout: ProjectCheckoutLitePayloadSchema,
-});
-const ProjectGroupPayloadSchema = z.object({
-    projectKey: z.string(),
-    projectName: z.string(),
-    agents: z.array(ProjectGroupedAgentEntryPayloadSchema),
-});
-export const FetchAgentsGroupedByProjectResponseMessageSchema = z.object({
-    type: z.literal("fetch_agents_grouped_by_project_response"),
+export const FetchAgentResponseMessageSchema = z.object({
+    type: z.literal("fetch_agent_response"),
     payload: z.object({
         requestId: z.string(),
-        groups: z.array(ProjectGroupPayloadSchema),
+        agent: AgentSnapshotPayloadSchema.nullable(),
+        error: z.string().nullable(),
     }),
 });
-export const FetchAgentResponseMessageSchema = z.object({
-    type: z.literal("fetch_agent_response"),
+const AgentTimelineSeqRangeSchema = z.object({
+    startSeq: z.number().int().nonnegative(),
+    endSeq: z.number().int().nonnegative(),
+});
+export const AgentTimelineEntryPayloadSchema = z.object({
+    provider: AgentProviderSchema,
+    item: AgentTimelineItemPayloadSchema,
+    timestamp: z.string(),
+    seqStart: z.number().int().nonnegative(),
+    seqEnd: z.number().int().nonnegative(),
+    sourceSeqRanges: z.array(AgentTimelineSeqRangeSchema),
+    collapsed: z.array(z.enum(["assistant_merge", "tool_lifecycle"])),
+});
+export const FetchAgentTimelineResponseMessageSchema = z.object({
+    type: z.literal("fetch_agent_timeline_response"),
     payload: z.object({
         requestId: z.string(),
-        agent: AgentSnapshotPayloadSchema.nullable(),
+        agentId: z.string(),
+        direction: z.enum(["tail", "before", "after"]),
+        projection: z.enum(["projected", "canonical"]),
+        epoch: z.string(),
+        reset: z.boolean(),
+        staleCursor: z.boolean(),
+        gap: z.boolean(),
+        window: z.object({
+            minSeq: z.number().int().nonnegative(),
+            maxSeq: z.number().int().nonnegative(),
+            nextSeq: z.number().int().nonnegative(),
+        }),
+        startCursor: AgentTimelineCursorSchema.nullable(),
+        endCursor: AgentTimelineCursorSchema.nullable(),
+        hasOlder: z.boolean(),
+        hasNewer: z.boolean(),
+        entries: z.array(AgentTimelineEntryPayloadSchema),
         error: z.string().nullable(),
     }),
 });
@@ -1356,6 +1490,14 @@ export const ValidateBranchResponseSchema = z.object({
         requestId: z.string(),
     }),
 });
+export const BranchSuggestionsResponseSchema = z.object({
+    type: z.literal("branch_suggestions_response"),
+    payload: z.object({
+        branches: z.array(z.string()),
+        error: z.string().nullable(),
+        requestId: z.string(),
+    }),
+});
 const PaseoWorktreeSchema = z.object({
     worktreePath: z.string(),
     branchName: z.string().nullable().optional(),
@@ -1525,6 +1667,13 @@ export const ListTerminalsResponseSchema = z.object({
         requestId: z.string(),
     }),
 });
+export const TerminalsChangedSchema = z.object({
+    type: z.literal("terminals_changed"),
+    payload: z.object({
+        cwd: z.string(),
+        terminals: z.array(TerminalInfoSchema.omit({ cwd: true })),
+    }),
+});
 export const CreateTerminalResponseSchema = z.object({
     type: z.literal("create_terminal_response"),
     payload: z.object({
@@ -1557,27 +1706,54 @@ export const KillTerminalResponseSchema = z.object({
         requestId: z.string(),
     }),
 });
+export const AttachTerminalStreamResponseSchema = z.object({
+    type: z.literal("attach_terminal_stream_response"),
+    payload: z.object({
+        terminalId: z.string(),
+        streamId: z.number().int().nonnegative().nullable(),
+        replayedFrom: z.number().int().nonnegative(),
+        currentOffset: z.number().int().nonnegative(),
+        earliestAvailableOffset: z.number().int().nonnegative(),
+        reset: z.boolean(),
+        error: z.string().nullable(),
+        requestId: z.string(),
+    }),
+});
+export const DetachTerminalStreamResponseSchema = z.object({
+    type: z.literal("detach_terminal_stream_response"),
+    payload: z.object({
+        streamId: z.number().int().nonnegative(),
+        success: z.boolean(),
+        requestId: z.string(),
+    }),
+});
+export const TerminalStreamExitSchema = z.object({
+    type: z.literal("terminal_stream_exit"),
+    payload: z.object({
+        streamId: z.number().int().nonnegative(),
+        terminalId: z.string(),
+    }),
+});
 export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     ActivityLogMessageSchema,
     AssistantChunkMessageSchema,
     AudioOutputMessageSchema,
     TranscriptionResultMessageSchema,
     DictationStreamAckMessageSchema,
+    DictationStreamFinishAcceptedMessageSchema,
     DictationStreamPartialMessageSchema,
     DictationStreamFinalMessageSchema,
     DictationStreamErrorMessageSchema,
     StatusMessageSchema,
     PongMessageSchema,
     RpcErrorMessageSchema,
-    InitializeAgentResponseMessageSchema,
     ArtifactMessageSchema,
     AgentUpdateMessageSchema,
     AgentStreamMessageSchema,
-    AgentStreamSnapshotMessageSchema,
     AgentStatusMessageSchema,
     FetchAgentsResponseMessageSchema,
-    FetchAgentsGroupedByProjectResponseMessageSchema,
     FetchAgentResponseMessageSchema,
+    FetchAgentTimelineResponseMessageSchema,
     SendAgentMessageResponseMessageSchema,
     SetVoiceModeResponseMessageSchema,
     SetAgentModeResponseMessageSchema,
@@ -1599,6 +1775,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     CheckoutPrCreateResponseSchema,
     CheckoutPrStatusResponseSchema,
     ValidateBranchResponseSchema,
+    BranchSuggestionsResponseSchema,
     PaseoWorktreeListResponseSchema,
     PaseoWorktreeArchiveResponseSchema,
     FileExplorerResponseSchema,
@@ -1611,10 +1788,14 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     ListCommandsResponseSchema,
     ExecuteCommandResponseSchema,
     ListTerminalsResponseSchema,
+    TerminalsChangedSchema,
     CreateTerminalResponseSchema,
     SubscribeTerminalResponseSchema,
     TerminalOutputSchema,
     KillTerminalResponseSchema,
+    AttachTerminalStreamResponseSchema,
+    DetachTerminalStreamResponseSchema,
+    TerminalStreamExitSchema,
 ]);
 // ============================================================================
 // WebSocket Level Messages (wraps session messages)
@@ -1672,4 +1853,11 @@ export function wrapSessionMessage(sessionMsg) {
         message: sessionMsg,
     };
 }
+export function parseServerInfoStatusPayload(payload) {
+    const parsed = ServerInfoStatusPayloadSchema.safeParse(payload);
+    if (!parsed.success) {
+        return null;
+    }
+    return parsed.data;
+}
 //# sourceMappingURL=messages.js.map