@getpaseo/server 0.1.2 → 0.1.4

package/dist/server/shared/messages.js

@@ -358,6 +358,13 @@ export const ArchiveAgentRequestMessageSchema = z.object({
     agentId: z.string(),
     requestId: z.string(),
 });
+export const UpdateAgentRequestMessageSchema = z.object({
+    type: z.literal("update_agent_request"),
+    agentId: z.string(),
+    name: z.string().optional(),
+    labels: z.record(z.string()).optional(),
+    requestId: z.string(),
+});
 export const SetVoiceModeMessageSchema = z.object({
     type: z.literal("set_voice_mode"),
     enabled: z.boolean(),
@@ -458,6 +465,7 @@ export const CreateAgentRequestMessageSchema = z.object({
     config: AgentSessionConfigSchema,
     worktreeName: z.string().optional(),
     initialPrompt: z.string().optional(),
+    outputSchema: z.record(z.unknown()).optional(),
     images: z.array(z.object({
         data: z.string(), // base64 encoded image
         mimeType: z.string(), // e.g., "image/jpeg", "image/png"
@@ -472,6 +480,10 @@ export const ListProviderModelsRequestMessageSchema = z.object({
     cwd: z.string().optional(),
     requestId: z.string(),
 });
+export const ListAvailableProvidersRequestMessageSchema = z.object({
+    type: z.literal("list_available_providers_request"),
+    requestId: z.string(),
+});
 export const SpeechModelsListRequestSchema = z.object({
     type: z.literal("speech_models_list_request"),
     requestId: z.string(),
@@ -501,21 +513,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"),
@@ -562,6 +573,15 @@ export const SetAgentThinkingResponseMessageSchema = z.object({
         error: z.string().nullable(),
     }),
 });
+export const UpdateAgentResponseMessageSchema = z.object({
+    type: z.literal("update_agent_response"),
+    payload: z.object({
+        requestId: z.string(),
+        agentId: z.string(),
+        accepted: z.boolean(),
+        error: z.string().nullable(),
+    }),
+});
 export const SetVoiceModeResponseMessageSchema = z.object({
     type: z.literal("set_voice_mode_response"),
     payload: z.object({
@@ -570,6 +590,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({
@@ -578,11 +601,6 @@ export const AgentPermissionResponseMessageSchema = z.object({
     requestId: z.string(),
     response: AgentPermissionResponseSchema,
 });
-export const GitDiffRequestSchema = z.object({
-    type: z.literal("git_diff_request"),
-    agentId: z.string(),
-    requestId: z.string(),
-});
 const CheckoutErrorCodeSchema = z.enum([
     "NOT_GIT_REPO",
     "NOT_ALLOWED",
@@ -659,6 +677,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(),
@@ -699,11 +724,6 @@ const ParsedDiffFileSchema = z.object({
     hunks: z.array(DiffHunkSchema),
     status: z.enum(["ok", "too_large", "binary"]).optional(),
 });
-export const HighlightedDiffRequestSchema = z.object({
-    type: z.literal("highlighted_diff_request"),
-    agentId: z.string(),
-    requestId: z.string(),
-});
 const FileExplorerEntrySchema = z.object({
     name: z.string(),
     path: z.string(),
@@ -819,6 +839,19 @@ 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,
@@ -830,6 +863,7 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     UnsubscribeAgentUpdatesMessageSchema,
     DeleteAgentRequestMessageSchema,
     ArchiveAgentRequestMessageSchema,
+    UpdateAgentRequestMessageSchema,
     SetVoiceModeMessageSchema,
     SendAgentMessageRequestSchema,
     WaitForFinishRequestSchema,
@@ -839,18 +873,18 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     DictationStreamCancelMessageSchema,
     CreateAgentRequestMessageSchema,
     ListProviderModelsRequestMessageSchema,
+    ListAvailableProvidersRequestMessageSchema,
     SpeechModelsListRequestSchema,
     SpeechModelsDownloadRequestSchema,
     ResumeAgentRequestMessageSchema,
     RefreshAgentRequestMessageSchema,
     CancelAgentRequestMessageSchema,
     RestartServerRequestMessageSchema,
-    InitializeAgentRequestMessageSchema,
+    FetchAgentTimelineRequestMessageSchema,
     SetAgentModeRequestMessageSchema,
     SetAgentModelRequestMessageSchema,
     SetAgentThinkingRequestMessageSchema,
     AgentPermissionResponseMessageSchema,
-    GitDiffRequestSchema,
     CheckoutStatusRequestSchema,
     SubscribeCheckoutDiffRequestSchema,
     UnsubscribeCheckoutDiffRequestSchema,
@@ -861,9 +895,9 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     CheckoutPrCreateRequestSchema,
     CheckoutPrStatusRequestSchema,
     ValidateBranchRequestSchema,
+    BranchSuggestionsRequestSchema,
     PaseoWorktreeListRequestSchema,
     PaseoWorktreeArchiveRequestSchema,
-    HighlightedDiffRequestSchema,
     FileExplorerRequestSchema,
     ProjectIconRequestSchema,
     FileDownloadTokenRequestSchema,
@@ -879,6 +913,8 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     UnsubscribeTerminalRequestSchema,
     TerminalInputSchema,
     KillTerminalRequestSchema,
+    AttachTerminalStreamRequestSchema,
+    DetachTerminalStreamRequestSchema,
 ]);
 // ============================================================================
 // Session Outbound Messages (Session emits these)
@@ -940,6 +976,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({
@@ -961,9 +1004,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
@@ -1096,16 +1188,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({
@@ -1153,6 +1238,43 @@ export const FetchAgentResponseMessageSchema = z.object({
         error: z.string().nullable(),
     }),
 });
+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(),
+        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(),
+    }),
+});
 export const SendAgentMessageResponseMessageSchema = z.object({
     type: z.literal("send_agent_message_response"),
     payload: z.object({
@@ -1169,6 +1291,7 @@ export const WaitForFinishResponseMessageSchema = z.object({
         status: z.enum(["idle", "error", "permission", "timeout"]),
         final: AgentSnapshotPayloadSchema.nullable(),
         error: z.string().nullable(),
+        lastMessage: z.string().nullable(),
     }),
 });
 export const AgentPermissionRequestMessageSchema = z.object({
@@ -1201,15 +1324,6 @@ export const AgentArchivedMessageSchema = z.object({
         requestId: z.string(),
     }),
 });
-export const GitDiffResponseSchema = z.object({
-    type: z.literal("git_diff_response"),
-    payload: z.object({
-        agentId: z.string(),
-        diff: z.string(),
-        error: z.string().nullable(),
-        requestId: z.string(),
-    }),
-});
 const AheadBehindSchema = z.object({
     ahead: z.number(),
     behind: z.number(),
@@ -1338,6 +1452,7 @@ export const CheckoutPrStatusResponseSchema = z.object({
     payload: z.object({
         cwd: z.string(),
         status: CheckoutPrStatusSchema.nullable(),
+        githubFeaturesEnabled: z.boolean(),
         error: CheckoutErrorSchema.nullable(),
         requestId: z.string(),
     }),
@@ -1352,6 +1467,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(),
@@ -1374,15 +1497,6 @@ export const PaseoWorktreeArchiveResponseSchema = z.object({
         requestId: z.string(),
     }),
 });
-export const HighlightedDiffResponseSchema = z.object({
-    type: z.literal("highlighted_diff_response"),
-    payload: z.object({
-        agentId: z.string(),
-        files: z.array(ParsedDiffFileSchema),
-        error: z.string().nullable(),
-        requestId: z.string(),
-    }),
-});
 export const FileExplorerResponseSchema = z.object({
     type: z.literal("file_explorer_response"),
     payload: z.object({
@@ -1431,6 +1545,20 @@ export const ListProviderModelsResponseMessageSchema = z.object({
         requestId: z.string(),
     }),
 });
+const ProviderAvailabilitySchema = z.object({
+    provider: AgentProviderSchema,
+    available: z.boolean(),
+    error: z.string().nullable().optional(),
+});
+export const ListAvailableProvidersResponseSchema = z.object({
+    type: z.literal("list_available_providers_response"),
+    payload: z.object({
+        providers: z.array(ProviderAvailabilitySchema),
+        error: z.string().nullable().optional(),
+        fetchedAt: z.string(),
+        requestId: z.string(),
+    }),
+});
 export const SpeechModelsListResponseSchema = z.object({
     type: z.literal("speech_models_list_response"),
     payload: z.object({
@@ -1548,38 +1676,66 @@ 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,
     SetAgentModelResponseMessageSchema,
     SetAgentThinkingResponseMessageSchema,
+    UpdateAgentResponseMessageSchema,
     WaitForFinishResponseMessageSchema,
     AgentPermissionRequestMessageSchema,
     AgentPermissionResolvedMessageSchema,
     AgentDeletedMessageSchema,
     AgentArchivedMessageSchema,
-    GitDiffResponseSchema,
     CheckoutStatusResponseSchema,
     SubscribeCheckoutDiffResponseSchema,
     CheckoutDiffUpdateSchema,
@@ -1590,13 +1746,14 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     CheckoutPrCreateResponseSchema,
     CheckoutPrStatusResponseSchema,
     ValidateBranchResponseSchema,
+    BranchSuggestionsResponseSchema,
     PaseoWorktreeListResponseSchema,
     PaseoWorktreeArchiveResponseSchema,
-    HighlightedDiffResponseSchema,
     FileExplorerResponseSchema,
     ProjectIconResponseSchema,
     FileDownloadTokenResponseSchema,
     ListProviderModelsResponseMessageSchema,
+    ListAvailableProvidersResponseSchema,
     SpeechModelsListResponseSchema,
     SpeechModelsDownloadResponseSchema,
     ListCommandsResponseSchema,
@@ -1606,6 +1763,9 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     SubscribeTerminalResponseSchema,
     TerminalOutputSchema,
     KillTerminalResponseSchema,
+    AttachTerminalStreamResponseSchema,
+    DetachTerminalStreamResponseSchema,
+    TerminalStreamExitSchema,
 ]);
 // ============================================================================
 // WebSocket Level Messages (wraps session messages)
@@ -1663,4 +1823,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