refactor: add descriptive comments for various response payload interfaces

frontend/src/api/generated/activity/activity.ts

@@ -31,6 +31,7 @@ import { customFetch } from "../../mutator";
 type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 
 /**
+ * List activity events visible to the calling actor.
  * @summary List Activity
  */
 export type listActivityApiV1ActivityGetResponse200 = {
@@ -241,6 +242,7 @@ export function useListActivityApiV1ActivityGet<
 }
 
 /**
+ * List task-comment feed items for accessible boards.
  * @summary List Task Comment Feed
  */
 export type listTaskCommentFeedApiV1ActivityTaskCommentsGetResponse200 = {
@@ -489,6 +491,7 @@ export function useListTaskCommentFeedApiV1ActivityTaskCommentsGet<
 }
 
 /**
+ * Stream task-comment events for accessible boards.
  * @summary Stream Task Comment Feed
  */
 export type streamTaskCommentFeedApiV1ActivityTaskCommentsStreamGetResponse200 =

frontend/src/api/generated/agent/agent.ts

@@ -66,6 +66,7 @@ import { customFetch } from "../../mutator";
 type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 
 /**
+ * List boards visible to the authenticated agent.
  * @summary List Boards
  */
 export type listBoardsApiV1AgentBoardsGetResponse200 = {
@@ -276,6 +277,7 @@ export function useListBoardsApiV1AgentBoardsGet<
 }
 
 /**
+ * Return a board if the authenticated agent can access it.
  * @summary Get Board
  */
 export type getBoardApiV1AgentBoardsBoardIdGetResponse200 = {
@@ -478,6 +480,7 @@ export function useGetBoardApiV1AgentBoardsBoardIdGet<
 }
 
 /**
+ * List agents, optionally filtered to a board.
  * @summary List Agents
  */
 export type listAgentsApiV1AgentAgentsGetResponse200 = {
@@ -688,6 +691,7 @@ export function useListAgentsApiV1AgentAgentsGet<
 }
 
 /**
+ * Create an agent on the caller's board.
  * @summary Create Agent
  */
 export type createAgentApiV1AgentAgentsPostResponse200 = {
@@ -805,6 +809,7 @@ export const useCreateAgentApiV1AgentAgentsPost = <
   );
 };
 /**
+ * List tasks on a board with optional status and assignment filters.
  * @summary List Tasks
  */
 export type listTasksApiV1AgentBoardsBoardIdTasksGetResponse200 = {
@@ -1037,6 +1042,7 @@ export function useListTasksApiV1AgentBoardsBoardIdTasksGet<
 }
 
 /**
+ * Create a task on the board as the lead agent.
  * @summary Create Task
  */
 export type createTaskApiV1AgentBoardsBoardIdTasksPostResponse200 = {
@@ -1163,6 +1169,7 @@ export const useCreateTaskApiV1AgentBoardsBoardIdTasksPost = <
   );
 };
 /**
+ * Update a task after board-level access checks.
  * @summary Update Task
  */
 export type updateTaskApiV1AgentBoardsBoardIdTasksTaskIdPatchResponse200 = {
@@ -1303,6 +1310,7 @@ export const useUpdateTaskApiV1AgentBoardsBoardIdTasksTaskIdPatch = <
   );
 };
 /**
+ * List comments for a task visible to the authenticated agent.
  * @summary List Task Comments
  */
 export type listTaskCommentsApiV1AgentBoardsBoardIdTasksTaskIdCommentsGetResponse200 =
@@ -1636,6 +1644,7 @@ export function useListTaskCommentsApiV1AgentBoardsBoardIdTasksTaskIdCommentsGet
 }
 
 /**
+ * Create a task comment on behalf of the authenticated agent.
  * @summary Create Task Comment
  */
 export type createTaskCommentApiV1AgentBoardsBoardIdTasksTaskIdCommentsPostResponse200 =
@@ -1795,6 +1804,7 @@ export const useCreateTaskCommentApiV1AgentBoardsBoardIdTasksTaskIdCommentsPost
     );
   };
 /**
+ * List board memory entries with optional chat filtering.
  * @summary List Board Memory
  */
 export type listBoardMemoryApiV1AgentBoardsBoardIdMemoryGetResponse200 = {
@@ -2057,6 +2067,7 @@ export function useListBoardMemoryApiV1AgentBoardsBoardIdMemoryGet<
 }
 
 /**
+ * Create a board memory entry.
  * @summary Create Board Memory
  */
 export type createBoardMemoryApiV1AgentBoardsBoardIdMemoryPostResponse200 = {
@@ -2196,6 +2207,7 @@ export const useCreateBoardMemoryApiV1AgentBoardsBoardIdMemoryPost = <
   );
 };
 /**
+ * List approvals for a board.
  * @summary List Approvals
  */
 export type listApprovalsApiV1AgentBoardsBoardIdApprovalsGetResponse200 = {
@@ -2463,6 +2475,7 @@ export function useListApprovalsApiV1AgentBoardsBoardIdApprovalsGet<
 }
 
 /**
+ * Create a board approval request.
  * @summary Create Approval
  */
 export type createApprovalApiV1AgentBoardsBoardIdApprovalsPostResponse200 = {
@@ -2602,6 +2615,7 @@ export const useCreateApprovalApiV1AgentBoardsBoardIdApprovalsPost = <
   );
 };
 /**
+ * Apply onboarding updates for a board.
  * @summary Update Onboarding
  */
 export type updateOnboardingApiV1AgentBoardsBoardIdOnboardingPostResponse200 = {
@@ -2763,6 +2777,7 @@ export const useUpdateOnboardingApiV1AgentBoardsBoardIdOnboardingPost = <
   );
 };
 /**
+ * Send a direct nudge message to a board agent.
  * @summary Nudge Agent
  */
 export type nudgeAgentApiV1AgentBoardsBoardIdAgentsAgentIdNudgePostResponse200 =
@@ -2918,6 +2933,7 @@ export const useNudgeAgentApiV1AgentBoardsBoardIdAgentsAgentIdNudgePost = <
   );
 };
 /**
+ * Record heartbeat status for the authenticated agent.
  * @summary Agent Heartbeat
  */
 export type agentHeartbeatApiV1AgentHeartbeatPostResponse200 = {
@@ -3037,6 +3053,7 @@ export const useAgentHeartbeatApiV1AgentHeartbeatPost = <
   );
 };
 /**
+ * Fetch the target agent's SOUL.md content from the gateway.
  * @summary Get Agent Soul
  */
 export type getAgentSoulApiV1AgentBoardsBoardIdAgentsAgentIdSoulGetResponse200 =
@@ -3320,6 +3337,7 @@ export function useGetAgentSoulApiV1AgentBoardsBoardIdAgentsAgentIdSoulGet<
 }
 
 /**
+ * Update an agent's SOUL.md content in DB and gateway.
  * @summary Update Agent Soul
  */
 export type updateAgentSoulApiV1AgentBoardsBoardIdAgentsAgentIdSoulPutResponse200 =
@@ -3480,6 +3498,7 @@ export const useUpdateAgentSoulApiV1AgentBoardsBoardIdAgentsAgentIdSoulPut = <
   );
 };
 /**
+ * Route a lead's ask-user request through the gateway main agent.
  * @summary Ask User Via Gateway Main
  */
 export type askUserViaGatewayMainApiV1AgentBoardsBoardIdGatewayMainAskUserPostResponse200 =
@@ -3636,6 +3655,7 @@ export const useAskUserViaGatewayMainApiV1AgentBoardsBoardIdGatewayMainAskUserPo
     );
   };
 /**
+ * Send a gateway-main message to a single board lead agent.
  * @summary Message Gateway Board Lead
  */
 export type messageGatewayBoardLeadApiV1AgentGatewayBoardsBoardIdLeadMessagePostResponse200 =
@@ -3792,6 +3812,7 @@ export const useMessageGatewayBoardLeadApiV1AgentGatewayBoardsBoardIdLeadMessage
     );
   };
 /**
+ * Broadcast a gateway-main message to multiple board leads.
  * @summary Broadcast Gateway Lead Message
  */
 export type broadcastGatewayLeadMessageApiV1AgentGatewayLeadsBroadcastPostResponse200 =

frontend/src/api/generated/agents/agents.ts

@@ -39,6 +39,7 @@ import { customFetch } from "../../mutator";
 type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 
 /**
+ * List agents visible to the active organization admin.
  * @summary List Agents
  */
 export type listAgentsApiV1AgentsGetResponse200 = {
@@ -246,6 +247,7 @@ export function useListAgentsApiV1AgentsGet<
 }
 
 /**
+ * Create and provision an agent.
  * @summary Create Agent
  */
 export type createAgentApiV1AgentsPostResponse200 = {
@@ -363,6 +365,7 @@ export const useCreateAgentApiV1AgentsPost = <
   );
 };
 /**
+ * Stream agent updates as SSE events.
  * @summary Stream Agents
  */
 export type streamAgentsApiV1AgentsStreamGetResponse200 = {
@@ -574,6 +577,7 @@ export function useStreamAgentsApiV1AgentsStreamGet<
 }
 
 /**
+ * Get a single agent by id.
  * @summary Get Agent
  */
 export type getAgentApiV1AgentsAgentIdGetResponse200 = {
@@ -773,6 +777,7 @@ export function useGetAgentApiV1AgentsAgentIdGet<
 }
 
 /**
+ * Update agent metadata and optionally reprovision.
  * @summary Update Agent
  */
 export type updateAgentApiV1AgentsAgentIdPatchResponse200 = {
@@ -933,6 +938,7 @@ export const useUpdateAgentApiV1AgentsAgentIdPatch = <
   );
 };
 /**
+ * Delete an agent and clean related task state.
  * @summary Delete Agent
  */
 export type deleteAgentApiV1AgentsAgentIdDeleteResponse200 = {
@@ -1049,6 +1055,7 @@ export const useDeleteAgentApiV1AgentsAgentIdDelete = <
   );
 };
 /**
+ * Record a heartbeat for a specific agent.
  * @summary Heartbeat Agent
  */
 export type heartbeatAgentApiV1AgentsAgentIdHeartbeatPostResponse200 = {
@@ -1176,6 +1183,7 @@ export const useHeartbeatAgentApiV1AgentsAgentIdHeartbeatPost = <
   );
 };
 /**
+ * Heartbeat an existing agent or create/provision one if needed.
  * @summary Heartbeat Or Create Agent
  */
 export type heartbeatOrCreateAgentApiV1AgentsHeartbeatPostResponse200 = {

frontend/src/api/generated/approvals/approvals.ts

@@ -35,6 +35,7 @@ import { customFetch } from "../../mutator";
 type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 
 /**
+ * List approvals for a board, optionally filtering by status.
  * @summary List Approvals
  */
 export type listApprovalsApiV1BoardsBoardIdApprovalsGetResponse200 = {
@@ -287,6 +288,7 @@ export function useListApprovalsApiV1BoardsBoardIdApprovalsGet<
 }
 
 /**
+ * Create an approval for a board.
  * @summary Create Approval
  */
 export type createApprovalApiV1BoardsBoardIdApprovalsPostResponse200 = {
@@ -414,6 +416,7 @@ export const useCreateApprovalApiV1BoardsBoardIdApprovalsPost = <
   );
 };
 /**
+ * Stream approval updates for a board using server-sent events.
  * @summary Stream Approvals
  */
 export type streamApprovalsApiV1BoardsBoardIdApprovalsStreamGetResponse200 = {
@@ -696,6 +699,7 @@ export function useStreamApprovalsApiV1BoardsBoardIdApprovalsStreamGet<
 }
 
 /**
+ * Update an approval's status and resolution timestamp.
  * @summary Update Approval
  */
 export type updateApprovalApiV1BoardsBoardIdApprovalsApprovalIdPatchResponse200 =

frontend/src/api/generated/auth/auth.ts

@@ -19,6 +19,7 @@ import { customFetch } from "../../mutator";
 type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 
 /**
+ * Return the authenticated user profile from token claims.
  * @summary Bootstrap User
  */
 export type bootstrapUserApiV1AuthBootstrapPostResponse200 = {

frontend/src/api/generated/board-group-memory/board-group-memory.ts

@@ -36,6 +36,7 @@ import { customFetch } from "../../mutator";
 type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 
 /**
+ * List board-group memory entries for a specific group.
  * @summary List Board Group Memory
  */
 export type listBoardGroupMemoryApiV1BoardGroupsGroupIdMemoryGetResponse200 = {
@@ -328,6 +329,7 @@ export function useListBoardGroupMemoryApiV1BoardGroupsGroupIdMemoryGet<
 }
 
 /**
+ * Create a board-group memory entry and notify chat recipients.
  * @summary Create Board Group Memory
  */
 export type createBoardGroupMemoryApiV1BoardGroupsGroupIdMemoryPostResponse200 =
@@ -477,6 +479,7 @@ export const useCreateBoardGroupMemoryApiV1BoardGroupsGroupIdMemoryPost = <
   );
 };
 /**
+ * Stream memory entries for a board group via server-sent events.
  * @summary Stream Board Group Memory
  */
 export type streamBoardGroupMemoryApiV1BoardGroupsGroupIdMemoryStreamGetResponse200 =
@@ -798,6 +801,7 @@ export function useStreamBoardGroupMemoryApiV1BoardGroupsGroupIdMemoryStreamGet<
 }
 
 /**
+ * List memory entries for the board's linked group.
  * @summary List Board Group Memory For Board
  */
 export type listBoardGroupMemoryForBoardApiV1BoardsBoardIdGroupMemoryGetResponse200 =
@@ -1119,6 +1123,7 @@ export function useListBoardGroupMemoryForBoardApiV1BoardsBoardIdGroupMemoryGet<
 }
 
 /**
+ * Create a group memory entry from a board context and notify recipients.
  * @summary Create Board Group Memory For Board
  */
 export type createBoardGroupMemoryForBoardApiV1BoardsBoardIdGroupMemoryPostResponse200 =
@@ -1275,6 +1280,7 @@ export const useCreateBoardGroupMemoryForBoardApiV1BoardsBoardIdGroupMemoryPost
     );
   };
 /**
+ * Stream memory entries for the board's linked group.
  * @summary Stream Board Group Memory For Board
  */
 export type streamBoardGroupMemoryForBoardApiV1BoardsBoardIdGroupMemoryStreamGetResponse200 =

frontend/src/api/generated/board-groups/board-groups.ts

@@ -39,6 +39,7 @@ import { customFetch } from "../../mutator";
 type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 
 /**
+ * List board groups in the active organization.
  * @summary List Board Groups
  */
 export type listBoardGroupsApiV1BoardGroupsGetResponse200 = {
@@ -250,6 +251,7 @@ export function useListBoardGroupsApiV1BoardGroupsGet<
 }
 
 /**
+ * Create a board group in the active organization.
  * @summary Create Board Group
  */
 export type createBoardGroupApiV1BoardGroupsPostResponse200 = {
@@ -368,6 +370,7 @@ export const useCreateBoardGroupApiV1BoardGroupsPost = <
   );
 };
 /**
+ * Get a board group by id.
  * @summary Get Board Group
  */
 export type getBoardGroupApiV1BoardGroupsGroupIdGetResponse200 = {
@@ -576,6 +579,7 @@ export function useGetBoardGroupApiV1BoardGroupsGroupIdGet<
 }
 
 /**
+ * Update a board group.
  * @summary Update Board Group
  */
 export type updateBoardGroupApiV1BoardGroupsGroupIdPatchResponse200 = {
@@ -703,6 +707,7 @@ export const useUpdateBoardGroupApiV1BoardGroupsGroupIdPatch = <
   );
 };
 /**
+ * Delete a board group.
  * @summary Delete Board Group
  */
 export type deleteBoardGroupApiV1BoardGroupsGroupIdDeleteResponse200 = {
@@ -825,6 +830,7 @@ export const useDeleteBoardGroupApiV1BoardGroupsGroupIdDelete = <
   );
 };
 /**
+ * Get a snapshot across boards in a group.
  * @summary Get Board Group Snapshot
  */
 export type getBoardGroupSnapshotApiV1BoardGroupsGroupIdSnapshotGetResponse200 =
@@ -1127,6 +1133,7 @@ export function useGetBoardGroupSnapshotApiV1BoardGroupsGroupIdSnapshotGet<
 }
 
 /**
+ * Apply heartbeat settings to agents in a board group.
  * @summary Apply Board Group Heartbeat
  */
 export type applyBoardGroupHeartbeatApiV1BoardGroupsGroupIdHeartbeatPostResponse200 =

frontend/src/api/generated/board-memory/board-memory.ts

@@ -34,6 +34,7 @@ import { customFetch } from "../../mutator";
 type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 
 /**
+ * List board memory entries, optionally filtering chat entries.
  * @summary List Board Memory
  */
 export type listBoardMemoryApiV1BoardsBoardIdMemoryGetResponse200 = {
@@ -281,6 +282,7 @@ export function useListBoardMemoryApiV1BoardsBoardIdMemoryGet<
 }
 
 /**
+ * Create a board memory entry and notify chat targets when needed.
  * @summary Create Board Memory
  */
 export type createBoardMemoryApiV1BoardsBoardIdMemoryPostResponse200 = {
@@ -408,6 +410,7 @@ export const useCreateBoardMemoryApiV1BoardsBoardIdMemoryPost = <
   );
 };
 /**
+ * Stream board memory events over server-sent events.
  * @summary Stream Board Memory
  */
 export type streamBoardMemoryApiV1BoardsBoardIdMemoryStreamGetResponse200 = {

frontend/src/api/generated/board-onboarding/board-onboarding.ts

@@ -36,6 +36,7 @@ import { customFetch } from "../../mutator";
 type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 
 /**
+ * Get the latest onboarding session for a board.
  * @summary Get Onboarding
  */
 export type getOnboardingApiV1BoardsBoardIdOnboardingGetResponse200 = {
@@ -274,6 +275,7 @@ export function useGetOnboardingApiV1BoardsBoardIdOnboardingGet<
 }
 
 /**
+ * Start onboarding and send instructions to the gateway main agent.
  * @summary Start Onboarding
  */
 export type startOnboardingApiV1BoardsBoardIdOnboardingStartPostResponse200 = {
@@ -415,6 +417,7 @@ export const useStartOnboardingApiV1BoardsBoardIdOnboardingStartPost = <
   );
 };
 /**
+ * Send a user onboarding answer to the gateway main agent.
  * @summary Answer Onboarding
  */
 export type answerOnboardingApiV1BoardsBoardIdOnboardingAnswerPostResponse200 =
@@ -564,6 +567,7 @@ export const useAnswerOnboardingApiV1BoardsBoardIdOnboardingAnswerPost = <
   );
 };
 /**
+ * Store onboarding updates submitted by the gateway main agent.
  * @summary Agent Onboarding Update
  */
 export type agentOnboardingUpdateApiV1BoardsBoardIdOnboardingAgentPostResponse200 =
@@ -738,6 +742,7 @@ export const useAgentOnboardingUpdateApiV1BoardsBoardIdOnboardingAgentPost = <
   );
 };
 /**
+ * Confirm onboarding results and provision the board lead agent.
  * @summary Confirm Onboarding
  */
 export type confirmOnboardingApiV1BoardsBoardIdOnboardingConfirmPostResponse200 =

frontend/src/api/generated/boards/boards.ts

@@ -38,6 +38,7 @@ import { customFetch } from "../../mutator";
 type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 
 /**
+ * List boards visible to the current organization member.
  * @summary List Boards
  */
 export type listBoardsApiV1BoardsGetResponse200 = {
@@ -245,6 +246,7 @@ export function useListBoardsApiV1BoardsGet<
 }
 
 /**
+ * Create a board in the active organization.
  * @summary Create Board
  */
 export type createBoardApiV1BoardsPostResponse200 = {
@@ -362,6 +364,7 @@ export const useCreateBoardApiV1BoardsPost = <
   );
 };
 /**
+ * Get a board by id.
  * @summary Get Board
  */
 export type getBoardApiV1BoardsBoardIdGetResponse200 = {
@@ -561,6 +564,7 @@ export function useGetBoardApiV1BoardsBoardIdGet<
 }
 
 /**
+ * Update mutable board properties.
  * @summary Update Board
  */
 export type updateBoardApiV1BoardsBoardIdPatchResponse200 = {
@@ -680,6 +684,7 @@ export const useUpdateBoardApiV1BoardsBoardIdPatch = <
   );
 };
 /**
+ * Delete a board and all dependent records.
  * @summary Delete Board
  */
 export type deleteBoardApiV1BoardsBoardIdDeleteResponse200 = {
@@ -796,6 +801,7 @@ export const useDeleteBoardApiV1BoardsBoardIdDelete = <
   );
 };
 /**
+ * Get a board snapshot view model.
  * @summary Get Board Snapshot
  */
 export type getBoardSnapshotApiV1BoardsBoardIdSnapshotGetResponse200 = {
@@ -1034,6 +1040,7 @@ export function useGetBoardSnapshotApiV1BoardsBoardIdSnapshotGet<
 }
 
 /**
+ * Get a grouped snapshot across related boards.
  * @summary Get Board Group Snapshot
  */
 export type getBoardGroupSnapshotApiV1BoardsBoardIdGroupSnapshotGetResponse200 =

frontend/src/api/generated/default/default.ts

@@ -28,6 +28,7 @@ import { customFetch } from "../../mutator";
 type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 
 /**
+ * Lightweight liveness probe endpoint.
  * @summary Health
  */
 export type healthHealthGetResponse200 = {
@@ -189,6 +190,7 @@ export function useHealthHealthGet<
 }
 
 /**
+ * Alias liveness probe endpoint for platform compatibility.
  * @summary Healthz
  */
 export type healthzHealthzGetResponse200 = {
@@ -354,6 +356,7 @@ export function useHealthzHealthzGet<
 }
 
 /**
+ * Readiness probe endpoint for service orchestration checks.
  * @summary Readyz
  */
 export type readyzReadyzGetResponse200 = {

frontend/src/api/generated/gateways/gateways.ts

@@ -24,13 +24,13 @@ import type {
   GatewayCommandsResponse,
   GatewayCreate,
   GatewayRead,
+  GatewayResolveQuery,
   GatewaySessionHistoryResponse,
   GatewaySessionMessageRequest,
   GatewaySessionResponse,
   GatewaySessionsResponse,
   GatewayTemplatesSyncResult,
   GatewayUpdate,
-  GatewaysStatusApiV1GatewaysStatusGetParams,
   GatewaysStatusResponse,
   GetGatewaySessionApiV1GatewaysSessionsSessionIdGetParams,
   GetSessionHistoryApiV1GatewaysSessionsSessionIdHistoryGetParams,
@@ -48,6 +48,7 @@ import { customFetch } from "../../mutator";
 type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 
 /**
+ * Return gateway connectivity and session status.
  * @summary Gateways Status
  */
 export type gatewaysStatusApiV1GatewaysStatusGetResponse200 = {
@@ -73,48 +74,36 @@ export type gatewaysStatusApiV1GatewaysStatusGetResponse =
   | gatewaysStatusApiV1GatewaysStatusGetResponseSuccess
   | gatewaysStatusApiV1GatewaysStatusGetResponseError;
 
-export const getGatewaysStatusApiV1GatewaysStatusGetUrl = (
-  params?: GatewaysStatusApiV1GatewaysStatusGetParams,
-) => {
-  const normalizedParams = new URLSearchParams();
-
-  Object.entries(params || {}).forEach(([key, value]) => {
-    if (value !== undefined) {
-      normalizedParams.append(key, value === null ? "null" : value.toString());
-    }
-  });
-
-  const stringifiedParams = normalizedParams.toString();
-
-  return stringifiedParams.length > 0
-    ? `/api/v1/gateways/status?${stringifiedParams}`
-    : `/api/v1/gateways/status`;
+export const getGatewaysStatusApiV1GatewaysStatusGetUrl = () => {
+  return `/api/v1/gateways/status`;
 };
 
 export const gatewaysStatusApiV1GatewaysStatusGet = async (
-  params?: GatewaysStatusApiV1GatewaysStatusGetParams,
+  gatewayResolveQuery: GatewayResolveQuery,
   options?: RequestInit,
 ): Promise<gatewaysStatusApiV1GatewaysStatusGetResponse> => {
   return customFetch<gatewaysStatusApiV1GatewaysStatusGetResponse>(
-    getGatewaysStatusApiV1GatewaysStatusGetUrl(params),
+    getGatewaysStatusApiV1GatewaysStatusGetUrl(),
     {
       ...options,
       method: "GET",
+      headers: { "Content-Type": "application/json", ...options?.headers },
+      body: JSON.stringify(gatewayResolveQuery),
     },
   );
 };
 
 export const getGatewaysStatusApiV1GatewaysStatusGetQueryKey = (
-  params?: GatewaysStatusApiV1GatewaysStatusGetParams,
+  gatewayResolveQuery?: GatewayResolveQuery,
 ) => {
-  return [`/api/v1/gateways/status`, ...(params ? [params] : [])] as const;
+  return [`/api/v1/gateways/status`, gatewayResolveQuery] as const;
 };
 
 export const getGatewaysStatusApiV1GatewaysStatusGetQueryOptions = <
   TData = Awaited<ReturnType<typeof gatewaysStatusApiV1GatewaysStatusGet>>,
   TError = HTTPValidationError,
 >(
-  params?: GatewaysStatusApiV1GatewaysStatusGetParams,
+  gatewayResolveQuery: GatewayResolveQuery,
   options?: {
     query?: Partial<
       UseQueryOptions<
@@ -130,12 +119,15 @@ export const getGatewaysStatusApiV1GatewaysStatusGetQueryOptions = <
 
   const queryKey =
     queryOptions?.queryKey ??
-    getGatewaysStatusApiV1GatewaysStatusGetQueryKey(params);
+    getGatewaysStatusApiV1GatewaysStatusGetQueryKey(gatewayResolveQuery);
 
   const queryFn: QueryFunction<
     Awaited<ReturnType<typeof gatewaysStatusApiV1GatewaysStatusGet>>
   > = ({ signal }) =>
-    gatewaysStatusApiV1GatewaysStatusGet(params, { signal, ...requestOptions });
+    gatewaysStatusApiV1GatewaysStatusGet(gatewayResolveQuery, {
+      signal,
+      ...requestOptions,
+    });
 
   return { queryKey, queryFn, ...queryOptions } as UseQueryOptions<
     Awaited<ReturnType<typeof gatewaysStatusApiV1GatewaysStatusGet>>,
@@ -154,7 +146,7 @@ export function useGatewaysStatusApiV1GatewaysStatusGet<
   TData = Awaited<ReturnType<typeof gatewaysStatusApiV1GatewaysStatusGet>>,
   TError = HTTPValidationError,
 >(
-  params: undefined | GatewaysStatusApiV1GatewaysStatusGetParams,
+  gatewayResolveQuery: GatewayResolveQuery,
   options: {
     query: Partial<
       UseQueryOptions<
@@ -181,7 +173,7 @@ export function useGatewaysStatusApiV1GatewaysStatusGet<
   TData = Awaited<ReturnType<typeof gatewaysStatusApiV1GatewaysStatusGet>>,
   TError = HTTPValidationError,
 >(
-  params?: GatewaysStatusApiV1GatewaysStatusGetParams,
+  gatewayResolveQuery: GatewayResolveQuery,
   options?: {
     query?: Partial<
       UseQueryOptions<
@@ -208,7 +200,7 @@ export function useGatewaysStatusApiV1GatewaysStatusGet<
   TData = Awaited<ReturnType<typeof gatewaysStatusApiV1GatewaysStatusGet>>,
   TError = HTTPValidationError,
 >(
-  params?: GatewaysStatusApiV1GatewaysStatusGetParams,
+  gatewayResolveQuery: GatewayResolveQuery,
   options?: {
     query?: Partial<
       UseQueryOptions<
@@ -231,7 +223,7 @@ export function useGatewaysStatusApiV1GatewaysStatusGet<
   TData = Awaited<ReturnType<typeof gatewaysStatusApiV1GatewaysStatusGet>>,
   TError = HTTPValidationError,
 >(
-  params?: GatewaysStatusApiV1GatewaysStatusGetParams,
+  gatewayResolveQuery: GatewayResolveQuery,
   options?: {
     query?: Partial<
       UseQueryOptions<
@@ -247,7 +239,7 @@ export function useGatewaysStatusApiV1GatewaysStatusGet<
   queryKey: DataTag<QueryKey, TData, TError>;
 } {
   const queryOptions = getGatewaysStatusApiV1GatewaysStatusGetQueryOptions(
-    params,
+    gatewayResolveQuery,
     options,
   );
 
@@ -260,6 +252,7 @@ export function useGatewaysStatusApiV1GatewaysStatusGet<
 }
 
 /**
+ * List sessions for a gateway associated with a board.
  * @summary List Gateway Sessions
  */
 export type listGatewaySessionsApiV1GatewaysSessionsGetResponse200 = {
@@ -492,6 +485,7 @@ export function useListGatewaySessionsApiV1GatewaysSessionsGet<
 }
 
 /**
+ * Get a specific gateway session by key.
  * @summary Get Gateway Session
  */
 export type getGatewaySessionApiV1GatewaysSessionsSessionIdGetResponse200 = {
@@ -774,6 +768,7 @@ export function useGetGatewaySessionApiV1GatewaysSessionsSessionIdGet<
 }
 
 /**
+ * Fetch chat history for a gateway session.
  * @summary Get Session History
  */
 export type getSessionHistoryApiV1GatewaysSessionsSessionIdHistoryGetResponse200 =
@@ -1081,6 +1076,7 @@ export function useGetSessionHistoryApiV1GatewaysSessionsSessionIdHistoryGet<
 }
 
 /**
+ * Send a message into a specific gateway session.
  * @summary Send Gateway Session Message
  */
 export type sendGatewaySessionMessageApiV1GatewaysSessionsSessionIdMessagePostResponse200 =
@@ -1278,6 +1274,7 @@ export const useSendGatewaySessionMessageApiV1GatewaysSessionsSessionIdMessagePo
     );
   };
 /**
+ * Return supported gateway protocol methods and events.
  * @summary Gateway Commands
  */
 export type gatewayCommandsApiV1GatewaysCommandsGetResponse200 = {
@@ -1452,6 +1449,7 @@ export function useGatewayCommandsApiV1GatewaysCommandsGet<
 }
 
 /**
+ * List gateways for the caller's organization.
  * @summary List Gateways
  */
 export type listGatewaysApiV1GatewaysGetResponse200 = {
@@ -1662,6 +1660,7 @@ export function useListGatewaysApiV1GatewaysGet<
 }
 
 /**
+ * Create a gateway and provision or refresh its main agent.
  * @summary Create Gateway
  */
 export type createGatewayApiV1GatewaysPostResponse200 = {
@@ -1779,6 +1778,7 @@ export const useCreateGatewayApiV1GatewaysPost = <
   );
 };
 /**
+ * Return one gateway by id for the caller's organization.
  * @summary Get Gateway
  */
 export type getGatewayApiV1GatewaysGatewayIdGetResponse200 = {
@@ -1986,6 +1986,7 @@ export function useGetGatewayApiV1GatewaysGatewayIdGet<
 }
 
 /**
+ * Patch a gateway and refresh the main-agent provisioning state.
  * @summary Update Gateway
  */
 export type updateGatewayApiV1GatewaysGatewayIdPatchResponse200 = {
@@ -2113,6 +2114,7 @@ export const useUpdateGatewayApiV1GatewaysGatewayIdPatch = <
   );
 };
 /**
+ * Delete a gateway in the caller's organization.
  * @summary Delete Gateway
  */
 export type deleteGatewayApiV1GatewaysGatewayIdDeleteResponse200 = {
@@ -2232,6 +2234,7 @@ export const useDeleteGatewayApiV1GatewaysGatewayIdDelete = <
   );
 };
 /**
+ * Sync templates for a gateway and optionally rotate runtime settings.
  * @summary Sync Gateway Templates
  */
 export type syncGatewayTemplatesApiV1GatewaysGatewayIdTemplatesSyncPostResponse200 =

frontend/src/api/generated/metrics/metrics.ts

@@ -28,6 +28,7 @@ import { customFetch } from "../../mutator";
 type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
 
 /**
+ * Return dashboard KPIs and time-series data for accessible boards.
  * @summary Dashboard Metrics
  */
 export type dashboardMetricsApiV1MetricsDashboardGetResponse200 = {

frontend/src/api/generated/model/activityEventRead.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Serialized activity event payload returned by activity endpoints.
+ */
 export interface ActivityEventRead {
   id: string;
   event_type: string;

frontend/src/api/generated/model/activityTaskCommentFeedItemRead.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Denormalized task-comment feed item enriched with task and board fields.
+ */
 export interface ActivityTaskCommentFeedItemRead {
   id: string;
   created_at: string;

frontend/src/api/generated/model/agentCreate.ts

@@ -7,6 +7,9 @@
 import type { AgentCreateHeartbeatConfig } from "./agentCreateHeartbeatConfig";
 import type { AgentCreateIdentityProfile } from "./agentCreateIdentityProfile";
 
+/**
+ * Payload for creating a new agent.
+ */
 export interface AgentCreate {
   board_id?: string | null;
   /** @minLength 1 */

frontend/src/api/generated/model/agentHeartbeat.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Heartbeat status payload sent by agents.
+ */
 export interface AgentHeartbeat {
   status?: string | null;
 }

frontend/src/api/generated/model/agentHeartbeatCreate.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Heartbeat payload used to create an agent lazily.
+ */
 export interface AgentHeartbeatCreate {
   status?: string | null;
   /** @minLength 1 */

frontend/src/api/generated/model/agentNudge.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Nudge message payload for pinging an agent.
+ */
 export interface AgentNudge {
   /** @minLength 1 */
   message: string;

frontend/src/api/generated/model/agentRead.ts

@@ -7,6 +7,9 @@
 import type { AgentReadHeartbeatConfig } from "./agentReadHeartbeatConfig";
 import type { AgentReadIdentityProfile } from "./agentReadIdentityProfile";
 
+/**
+ * Public agent representation returned by the API.
+ */
 export interface AgentRead {
   board_id?: string | null;
   /** @minLength 1 */

frontend/src/api/generated/model/agentUpdate.ts

@@ -7,6 +7,9 @@
 import type { AgentUpdateHeartbeatConfig } from "./agentUpdateHeartbeatConfig";
 import type { AgentUpdateIdentityProfile } from "./agentUpdateIdentityProfile";
 
+/**
+ * Payload for patching an existing agent.
+ */
 export interface AgentUpdate {
   board_id?: string | null;
   is_gateway_main?: boolean | null;

frontend/src/api/generated/model/approvalCreate.ts

@@ -8,6 +8,9 @@ import type { ApprovalCreatePayload } from "./approvalCreatePayload";
 import type { ApprovalCreateRubricScores } from "./approvalCreateRubricScores";
 import type { ApprovalCreateStatus } from "./approvalCreateStatus";
 
+/**
+ * Payload for creating a new approval request.
+ */
 export interface ApprovalCreate {
   action_type: string;
   task_id?: string | null;

frontend/src/api/generated/model/approvalRead.ts

@@ -8,6 +8,9 @@ import type { ApprovalReadPayload } from "./approvalReadPayload";
 import type { ApprovalReadRubricScores } from "./approvalReadRubricScores";
 import type { ApprovalReadStatus } from "./approvalReadStatus";
 
+/**
+ * Approval payload returned from read endpoints.
+ */
 export interface ApprovalRead {
   action_type: string;
   task_id?: string | null;

frontend/src/api/generated/model/approvalUpdate.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Payload for mutating approval status.
+ */
 export interface ApprovalUpdate {
   status?: "pending" | "approved" | "rejected" | null;
 }

frontend/src/api/generated/model/blockedTaskDetail.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Error detail payload listing blocking dependency task identifiers.
+ */
 export interface BlockedTaskDetail {
   message: string;
   blocked_by_task_ids?: string[];

frontend/src/api/generated/model/blockedTaskError.ts

@@ -6,6 +6,9 @@
  */
 import type { BlockedTaskDetail } from "./blockedTaskDetail";
 
+/**
+ * Top-level blocked-task error response envelope.
+ */
 export interface BlockedTaskError {
   detail: BlockedTaskDetail;
 }

frontend/src/api/generated/model/boardCreate.ts

@@ -6,10 +6,13 @@
  */
 import type { BoardCreateSuccessMetrics } from "./boardCreateSuccessMetrics";
 
+/**
+ * Payload for creating a board.
+ */
 export interface BoardCreate {
   name: string;
   slug: string;
-  gateway_id: string;
+  gateway_id?: string | null;
   board_group_id?: string | null;
   board_type?: string;
   objective?: string | null;

frontend/src/api/generated/model/boardGroupBoardSnapshot.ts

@@ -8,6 +8,9 @@ import type { BoardGroupBoardSnapshotTaskCounts } from "./boardGroupBoardSnapsho
 import type { BoardGroupTaskSummary } from "./boardGroupTaskSummary";
 import type { BoardRead } from "./boardRead";
 
+/**
+ * Board-level rollup embedded within a board-group snapshot.
+ */
 export interface BoardGroupBoardSnapshot {
   board: BoardRead;
   task_counts?: BoardGroupBoardSnapshotTaskCounts;

frontend/src/api/generated/model/boardGroupCreate.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Payload for creating a board group.
+ */
 export interface BoardGroupCreate {
   name: string;
   slug: string;

frontend/src/api/generated/model/boardGroupHeartbeatApply.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Request payload for heartbeat policy updates.
+ */
 export interface BoardGroupHeartbeatApply {
   every: string;
   target?: string | null;

frontend/src/api/generated/model/boardGroupHeartbeatApplyResult.ts

@@ -6,6 +6,9 @@
  */
 import type { BoardGroupHeartbeatApplyResultRequested } from "./boardGroupHeartbeatApplyResultRequested";
 
+/**
+ * Result payload describing agents updated by a heartbeat request.
+ */
 export interface BoardGroupHeartbeatApplyResult {
   board_group_id: string;
   requested: BoardGroupHeartbeatApplyResultRequested;

frontend/src/api/generated/model/boardGroupMemoryCreate.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Payload for creating a board-group memory entry.
+ */
 export interface BoardGroupMemoryCreate {
   /** @minLength 1 */
   content: string;

frontend/src/api/generated/model/boardGroupMemoryRead.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Serialized board-group memory entry returned from read endpoints.
+ */
 export interface BoardGroupMemoryRead {
   id: string;
   board_group_id: string;

frontend/src/api/generated/model/boardGroupRead.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Board-group payload returned from read endpoints.
+ */
 export interface BoardGroupRead {
   name: string;
   slug: string;

frontend/src/api/generated/model/boardGroupSnapshot.ts

@@ -7,6 +7,9 @@
 import type { BoardGroupBoardSnapshot } from "./boardGroupBoardSnapshot";
 import type { BoardGroupRead } from "./boardGroupRead";
 
+/**
+ * Top-level board-group snapshot response payload.
+ */
 export interface BoardGroupSnapshot {
   group?: BoardGroupRead | null;
   boards?: BoardGroupBoardSnapshot[];

frontend/src/api/generated/model/boardGroupTaskSummary.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Task summary row used inside board-group snapshot responses.
+ */
 export interface BoardGroupTaskSummary {
   id: string;
   board_id: string;

frontend/src/api/generated/model/boardGroupUpdate.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Payload for partial board-group updates.
+ */
 export interface BoardGroupUpdate {
   name?: string | null;
   slug?: string | null;

frontend/src/api/generated/model/boardMemoryCreate.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Payload for creating a board memory entry.
+ */
 export interface BoardMemoryCreate {
   /** @minLength 1 */
   content: string;

frontend/src/api/generated/model/boardMemoryRead.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Serialized board memory entry returned from read endpoints.
+ */
 export interface BoardMemoryRead {
   id: string;
   board_id: string;

frontend/src/api/generated/model/boardOnboardingAgentComplete.ts

@@ -7,13 +7,17 @@
 import type { BoardOnboardingAgentCompleteSuccessMetrics } from "./boardOnboardingAgentCompleteSuccessMetrics";
 import type { BoardOnboardingLeadAgentDraft } from "./boardOnboardingLeadAgentDraft";
 import type { BoardOnboardingUserProfile } from "./boardOnboardingUserProfile";
+import { BoardOnboardingAgentCompleteStatus } from "./boardOnboardingAgentCompleteStatus";
 
+/**
+ * Complete onboarding draft produced by the onboarding assistant.
+ */
 export interface BoardOnboardingAgentComplete {
   board_type: string;
   objective?: string | null;
   success_metrics?: BoardOnboardingAgentCompleteSuccessMetrics;
   target_date?: string | null;
-  status: "complete";
+  status: BoardOnboardingAgentCompleteStatus;
   user_profile?: BoardOnboardingUserProfile | null;
   lead_agent?: BoardOnboardingLeadAgentDraft | null;
 }

frontend/src/api/generated/model/boardOnboardingAgentCompleteStatus.ts

@@ -0,0 +1,13 @@
+/**
+ * Generated by orval v8.2.0 🍺
+ * Do not edit manually.
+ * Mission Control API
+ * OpenAPI spec version: 0.1.0
+ */
+
+export type BoardOnboardingAgentCompleteStatus =
+  (typeof BoardOnboardingAgentCompleteStatus)[keyof typeof BoardOnboardingAgentCompleteStatus];
+
+export const BoardOnboardingAgentCompleteStatus = {
+  complete: "complete",
+} as const;

frontend/src/api/generated/model/boardOnboardingAgentQuestion.ts

@@ -6,6 +6,9 @@
  */
 import type { BoardOnboardingQuestionOption } from "./boardOnboardingQuestionOption";
 
+/**
+ * Question payload emitted by the onboarding assistant.
+ */
 export interface BoardOnboardingAgentQuestion {
   /** @minLength 1 */
   question: string;

frontend/src/api/generated/model/boardOnboardingAnswer.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * User answer payload for a single onboarding question.
+ */
 export interface BoardOnboardingAnswer {
   /** @minLength 1 */
   answer: string;

frontend/src/api/generated/model/boardOnboardingConfirm.ts

@@ -6,6 +6,9 @@
  */
 import type { BoardOnboardingConfirmSuccessMetrics } from "./boardOnboardingConfirmSuccessMetrics";
 
+/**
+ * Payload used to confirm generated onboarding draft fields.
+ */
 export interface BoardOnboardingConfirm {
   board_type: string;
   objective?: string | null;

frontend/src/api/generated/model/boardOnboardingLeadAgentDraft.ts

@@ -6,6 +6,9 @@
  */
 import type { BoardOnboardingLeadAgentDraftIdentityProfile } from "./boardOnboardingLeadAgentDraftIdentityProfile";
 
+/**
+ * Editable lead-agent draft configuration.
+ */
 export interface BoardOnboardingLeadAgentDraft {
   name?: string | null;
   identity_profile?: BoardOnboardingLeadAgentDraftIdentityProfile;

frontend/src/api/generated/model/boardOnboardingQuestionOption.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Selectable option for an onboarding question.
+ */
 export interface BoardOnboardingQuestionOption {
   /** @minLength 1 */
   id: string;

frontend/src/api/generated/model/boardOnboardingRead.ts

@@ -7,6 +7,9 @@
 import type { BoardOnboardingAgentComplete } from "./boardOnboardingAgentComplete";
 import type { BoardOnboardingReadMessages } from "./boardOnboardingReadMessages";
 
+/**
+ * Stored onboarding session state returned by API endpoints.
+ */
 export interface BoardOnboardingRead {
   id: string;
   board_id: string;

frontend/src/api/generated/model/boardOnboardingStart.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Start signal for initializing onboarding conversation.
+ */
 export interface BoardOnboardingStart {
   [key: string]: unknown;
 }

frontend/src/api/generated/model/boardOnboardingUserProfile.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * User-profile preferences gathered during onboarding.
+ */
 export interface BoardOnboardingUserProfile {
   preferred_name?: string | null;
   pronouns?: string | null;

frontend/src/api/generated/model/boardRead.ts

@@ -6,6 +6,9 @@
  */
 import type { BoardReadSuccessMetrics } from "./boardReadSuccessMetrics";
 
+/**
+ * Board payload returned from read endpoints.
+ */
 export interface BoardRead {
   name: string;
   slug: string;

frontend/src/api/generated/model/boardSnapshot.ts

@@ -10,6 +10,9 @@ import type { BoardMemoryRead } from "./boardMemoryRead";
 import type { BoardRead } from "./boardRead";
 import type { TaskCardRead } from "./taskCardRead";
 
+/**
+ * Aggregated board payload used by board snapshot endpoints.
+ */
 export interface BoardSnapshot {
   board: BoardRead;
   tasks: TaskCardRead[];

frontend/src/api/generated/model/boardUpdate.ts

@@ -6,6 +6,9 @@
  */
 import type { BoardUpdateSuccessMetrics } from "./boardUpdateSuccessMetrics";
 
+/**
+ * Payload for partial board updates.
+ */
 export interface BoardUpdate {
   name?: string | null;
   slug?: string | null;

frontend/src/api/generated/model/dashboardKpis.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Topline dashboard KPI summary values.
+ */
 export interface DashboardKpis {
   active_agents: number;
   tasks_in_progress: number;

frontend/src/api/generated/model/dashboardMetrics.ts

@@ -9,6 +9,9 @@ import type { DashboardMetricsRange } from "./dashboardMetricsRange";
 import type { DashboardSeriesSet } from "./dashboardSeriesSet";
 import type { DashboardWipSeriesSet } from "./dashboardWipSeriesSet";
 
+/**
+ * Complete dashboard metrics response payload.
+ */
 export interface DashboardMetrics {
   range: DashboardMetricsRange;
   generated_at: string;

frontend/src/api/generated/model/dashboardMetricsApiV1MetricsDashboardGetParams.ts

@@ -4,8 +4,8 @@
  * Mission Control API
  * OpenAPI spec version: 0.1.0
  */
-import type { DashboardMetricsApiV1MetricsDashboardGetRange } from "./dashboardMetricsApiV1MetricsDashboardGetRange";
+import type { DashboardMetricsApiV1MetricsDashboardGetRangeKey } from "./dashboardMetricsApiV1MetricsDashboardGetRangeKey";
 
 export type DashboardMetricsApiV1MetricsDashboardGetParams = {
-  range?: DashboardMetricsApiV1MetricsDashboardGetRange;
+  range_key?: DashboardMetricsApiV1MetricsDashboardGetRangeKey;
 };

frontend/src/api/generated/model/dashboardMetricsApiV1MetricsDashboardGetRangeKey.ts

@@ -0,0 +1,14 @@
+/**
+ * Generated by orval v8.2.0 🍺
+ * Do not edit manually.
+ * Mission Control API
+ * OpenAPI spec version: 0.1.0
+ */
+
+export type DashboardMetricsApiV1MetricsDashboardGetRangeKey =
+  (typeof DashboardMetricsApiV1MetricsDashboardGetRangeKey)[keyof typeof DashboardMetricsApiV1MetricsDashboardGetRangeKey];
+
+export const DashboardMetricsApiV1MetricsDashboardGetRangeKey = {
+  "24h": "24h",
+  "7d": "7d",
+} as const;

frontend/src/api/generated/model/dashboardRangeSeries.ts

@@ -8,6 +8,9 @@ import type { DashboardRangeSeriesBucket } from "./dashboardRangeSeriesBucket";
 import type { DashboardRangeSeriesRange } from "./dashboardRangeSeriesRange";
 import type { DashboardSeriesPoint } from "./dashboardSeriesPoint";
 
+/**
+ * Series payload for a single range/bucket combination.
+ */
 export interface DashboardRangeSeries {
   range: DashboardRangeSeriesRange;
   bucket: DashboardRangeSeriesBucket;

frontend/src/api/generated/model/dashboardSeriesPoint.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Single numeric time-series point.
+ */
 export interface DashboardSeriesPoint {
   period: string;
   value: number;

frontend/src/api/generated/model/dashboardSeriesSet.ts

@@ -6,6 +6,9 @@
  */
 import type { DashboardRangeSeries } from "./dashboardRangeSeries";
 
+/**
+ * Primary vs comparison pair for generic series metrics.
+ */
 export interface DashboardSeriesSet {
   primary: DashboardRangeSeries;
   comparison: DashboardRangeSeries;

frontend/src/api/generated/model/dashboardWipPoint.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Work-in-progress point split by task status buckets.
+ */
 export interface DashboardWipPoint {
   period: string;
   inbox: number;

frontend/src/api/generated/model/dashboardWipRangeSeries.ts

@@ -8,6 +8,9 @@ import type { DashboardWipPoint } from "./dashboardWipPoint";
 import type { DashboardWipRangeSeriesBucket } from "./dashboardWipRangeSeriesBucket";
 import type { DashboardWipRangeSeriesRange } from "./dashboardWipRangeSeriesRange";
 
+/**
+ * WIP series payload for a single range/bucket combination.
+ */
 export interface DashboardWipRangeSeries {
   range: DashboardWipRangeSeriesRange;
   bucket: DashboardWipRangeSeriesBucket;

frontend/src/api/generated/model/dashboardWipSeriesSet.ts

@@ -6,6 +6,9 @@
  */
 import type { DashboardWipRangeSeries } from "./dashboardWipRangeSeries";
 
+/**
+ * Primary vs comparison pair for WIP status series metrics.
+ */
 export interface DashboardWipSeriesSet {
   primary: DashboardWipRangeSeries;
   comparison: DashboardWipRangeSeries;

frontend/src/api/generated/model/gatewayCommandsResponse.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Gateway command catalog and protocol metadata.
+ */
 export interface GatewayCommandsResponse {
   protocol_version: number;
   methods: string[];

frontend/src/api/generated/model/gatewayCreate.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Payload for creating a gateway configuration.
+ */
 export interface GatewayCreate {
   name: string;
   url: string;

frontend/src/api/generated/model/gatewayLeadBroadcastBoardResult.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Per-board result entry for a lead broadcast operation.
+ */
 export interface GatewayLeadBroadcastBoardResult {
   board_id: string;
   lead_agent_id?: string | null;

frontend/src/api/generated/model/gatewayLeadBroadcastRequest.ts

@@ -6,6 +6,9 @@
  */
 import type { GatewayLeadBroadcastRequestKind } from "./gatewayLeadBroadcastRequestKind";
 
+/**
+ * Request payload for broadcasting a message to multiple board leads.
+ */
 export interface GatewayLeadBroadcastRequest {
   kind?: GatewayLeadBroadcastRequestKind;
   correlation_id?: string | null;

frontend/src/api/generated/model/gatewayLeadBroadcastResponse.ts

@@ -6,6 +6,9 @@
  */
 import type { GatewayLeadBroadcastBoardResult } from "./gatewayLeadBroadcastBoardResult";
 
+/**
+ * Aggregate response for a lead broadcast operation.
+ */
 export interface GatewayLeadBroadcastResponse {
   ok?: boolean;
   sent?: number;

frontend/src/api/generated/model/gatewayLeadMessageRequest.ts

@@ -6,6 +6,9 @@
  */
 import type { GatewayLeadMessageRequestKind } from "./gatewayLeadMessageRequestKind";
 
+/**
+ * Request payload for sending a message to a board lead agent.
+ */
 export interface GatewayLeadMessageRequest {
   kind?: GatewayLeadMessageRequestKind;
   correlation_id?: string | null;

frontend/src/api/generated/model/gatewayLeadMessageResponse.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Response payload for a lead-message dispatch attempt.
+ */
 export interface GatewayLeadMessageResponse {
   ok?: boolean;
   board_id: string;

frontend/src/api/generated/model/gatewayMainAskUserRequest.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Request payload for asking the end user via a main gateway agent.
+ */
 export interface GatewayMainAskUserRequest {
   correlation_id?: string | null;
   /** @minLength 1 */

frontend/src/api/generated/model/gatewayMainAskUserResponse.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Response payload for user-question dispatch via gateway main agent.
+ */
 export interface GatewayMainAskUserResponse {
   ok?: boolean;
   board_id: string;

frontend/src/api/generated/model/gatewayRead.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Gateway payload returned from read endpoints.
+ */
 export interface GatewayRead {
   name: string;
   url: string;

frontend/src/api/generated/model/gatewayResolveQuery.ts

@@ -0,0 +1,16 @@
+/**
+ * Generated by orval v8.2.0 🍺
+ * Do not edit manually.
+ * Mission Control API
+ * OpenAPI spec version: 0.1.0
+ */
+
+/**
+ * Query parameters used to resolve which gateway to target.
+ */
+export interface GatewayResolveQuery {
+  board_id?: string | null;
+  gateway_url?: string | null;
+  gateway_token?: string | null;
+  gateway_main_session_key?: string | null;
+}

frontend/src/api/generated/model/gatewaySessionHistoryResponse.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Gateway session history response payload.
+ */
 export interface GatewaySessionHistoryResponse {
   history: unknown[];
 }

frontend/src/api/generated/model/gatewaySessionMessageRequest.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Request payload for sending a message into a gateway session.
+ */
 export interface GatewaySessionMessageRequest {
   /** @minLength 1 */
   content: string;

frontend/src/api/generated/model/gatewaySessionResponse.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Single gateway session response payload.
+ */
 export interface GatewaySessionResponse {
   session: unknown;
 }

frontend/src/api/generated/model/gatewaySessionsResponse.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Gateway sessions list response payload.
+ */
 export interface GatewaySessionsResponse {
   sessions: unknown[];
   main_session_key?: string | null;

frontend/src/api/generated/model/gatewayTemplatesSyncError.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Per-agent error entry from a gateway template sync operation.
+ */
 export interface GatewayTemplatesSyncError {
   agent_id?: string | null;
   agent_name?: string | null;

frontend/src/api/generated/model/gatewayTemplatesSyncResult.ts

@@ -6,6 +6,9 @@
  */
 import type { GatewayTemplatesSyncError } from "./gatewayTemplatesSyncError";
 
+/**
+ * Summary payload returned by gateway template sync endpoints.
+ */
 export interface GatewayTemplatesSyncResult {
   gateway_id: string;
   include_main: boolean;

frontend/src/api/generated/model/gatewayUpdate.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Payload for partial gateway updates.
+ */
 export interface GatewayUpdate {
   name?: string | null;
   url?: string | null;

frontend/src/api/generated/model/gatewaysStatusResponse.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Aggregated gateway status response including session metadata.
+ */
 export interface GatewaysStatusResponse {
   connected: boolean;
   gateway_url: string;

frontend/src/api/generated/model/index.ts

@@ -49,6 +49,7 @@ export * from "./boardGroupUpdate";
 export * from "./boardMemoryCreate";
 export * from "./boardMemoryRead";
 export * from "./boardOnboardingAgentComplete";
+export * from "./boardOnboardingAgentCompleteStatus";
 export * from "./boardOnboardingAgentCompleteSuccessMetrics";
 export * from "./boardOnboardingAgentQuestion";
 export * from "./boardOnboardingAnswer";
@@ -73,6 +74,7 @@ export * from "./dashboardKpis";
 export * from "./dashboardMetrics";
 export * from "./dashboardMetricsApiV1MetricsDashboardGetParams";
 export * from "./dashboardMetricsApiV1MetricsDashboardGetRange";
+export * from "./dashboardMetricsApiV1MetricsDashboardGetRangeKey";
 export * from "./dashboardMetricsRange";
 export * from "./dashboardRangeSeries";
 export * from "./dashboardRangeSeriesBucket";
@@ -100,6 +102,7 @@ export * from "./gatewayLeadMessageResponse";
 export * from "./gatewayMainAskUserRequest";
 export * from "./gatewayMainAskUserResponse";
 export * from "./gatewayRead";
+export * from "./gatewayResolveQuery";
 export * from "./gatewaySessionHistoryResponse";
 export * from "./gatewaySessionMessageRequest";
 export * from "./gatewaySessionResponse";

frontend/src/api/generated/model/okResponse.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Standard success response payload.
+ */
 export interface OkResponse {
   ok?: boolean;
 }

frontend/src/api/generated/model/organizationActiveUpdate.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Payload for switching the active organization context.
+ */
 export interface OrganizationActiveUpdate {
   organization_id: string;
 }

frontend/src/api/generated/model/organizationBoardAccessRead.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Board access payload returned from read endpoints.
+ */
 export interface OrganizationBoardAccessRead {
   id: string;
   board_id: string;

frontend/src/api/generated/model/organizationBoardAccessSpec.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Board access specification used in member/invite mutation payloads.
+ */
 export interface OrganizationBoardAccessSpec {
   board_id: string;
   can_read?: boolean;

frontend/src/api/generated/model/organizationCreate.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Payload for creating a new organization.
+ */
 export interface OrganizationCreate {
   name: string;
 }

frontend/src/api/generated/model/organizationInviteAccept.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Payload for accepting an organization invite token.
+ */
 export interface OrganizationInviteAccept {
   token: string;
 }

frontend/src/api/generated/model/organizationInviteCreate.ts

@@ -6,6 +6,9 @@
  */
 import type { OrganizationBoardAccessSpec } from "./organizationBoardAccessSpec";
 
+/**
+ * Payload for creating an organization invite.
+ */
 export interface OrganizationInviteCreate {
   invited_email: string;
   role?: string;

frontend/src/api/generated/model/organizationInviteRead.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Organization invite payload returned from read endpoints.
+ */
 export interface OrganizationInviteRead {
   id: string;
   organization_id: string;

frontend/src/api/generated/model/organizationListItem.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Organization list row for current user memberships.
+ */
 export interface OrganizationListItem {
   id: string;
   name: string;

frontend/src/api/generated/model/organizationMemberAccessUpdate.ts

@@ -6,6 +6,9 @@
  */
 import type { OrganizationBoardAccessSpec } from "./organizationBoardAccessSpec";
 
+/**
+ * Payload for replacing organization member access permissions.
+ */
 export interface OrganizationMemberAccessUpdate {
   all_boards_read?: boolean;
   all_boards_write?: boolean;

frontend/src/api/generated/model/organizationMemberRead.ts

@@ -7,6 +7,9 @@
 import type { OrganizationBoardAccessRead } from "./organizationBoardAccessRead";
 import type { OrganizationUserRead } from "./organizationUserRead";
 
+/**
+ * Organization member payload including board-level access overrides.
+ */
 export interface OrganizationMemberRead {
   id: string;
   organization_id: string;

frontend/src/api/generated/model/organizationMemberUpdate.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Payload for partial updates to organization member role.
+ */
 export interface OrganizationMemberUpdate {
   role?: string | null;
 }

frontend/src/api/generated/model/organizationRead.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Organization payload returned by read endpoints.
+ */
 export interface OrganizationRead {
   id: string;
   name: string;

frontend/src/api/generated/model/organizationUserRead.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Embedded user fields included in organization member payloads.
+ */
 export interface OrganizationUserRead {
   id: string;
   email?: string | null;

frontend/src/api/generated/model/soulUpdateRequest.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Payload for updating an agent SOUL document.
+ */
 export interface SoulUpdateRequest {
   content: string;
   source_url?: string | null;

frontend/src/api/generated/model/soulsDirectoryMarkdownResponse.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Response payload containing rendered markdown for a soul.
+ */
 export interface SoulsDirectoryMarkdownResponse {
   handle: string;
   slug: string;

frontend/src/api/generated/model/soulsDirectorySearchResponse.ts

@@ -6,6 +6,9 @@
  */
 import type { SoulsDirectorySoulRef } from "./soulsDirectorySoulRef";
 
+/**
+ * Response wrapper for directory search results.
+ */
 export interface SoulsDirectorySearchResponse {
   items: SoulsDirectorySoulRef[];
 }

frontend/src/api/generated/model/soulsDirectorySoulRef.ts

@@ -5,6 +5,9 @@
  * OpenAPI spec version: 0.1.0
  */
 
+/**
+ * Reference metadata for a soul entry in the directory index.
+ */
 export interface SoulsDirectorySoulRef {
   handle: string;
   slug: string;