@graph8/sdk 0.251.0 → 0.260.0

package/docs/api/work.d.ts

@@ -0,0 +1,2298 @@
+/* Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. */
+
+/**
+ * Types for `g8.api.work` (Work): 59 operations.
+ *
+ * For reading. In code, import from the package instead:
+ *   import type { ApiInput, ApiOutput, G8Contract } from "@graph8/sdk";
+ *   type In = ApiInput<"add_work_custom_emoji_work_custom_emoji_post">;
+ *
+ * Reference with examples: work.md
+ */
+/* eslint-disable */
+
+/** `g8.api.work.<member>` -> the operationId it calls. */
+export interface WorkMembers {
+  addWorkCustomEmoji: "add_work_custom_emoji_work_custom_emoji_post";
+  addWorkPulseNote: "add_work_pulse_note_work_pulse_post";
+  archiveWorkAgent: "archive_work_agent_work_agents__agent_id__delete";
+  createWorkAgent: "create_work_agent_work_agents_post";
+  createWorkChannel: "create_work_channel_work_channels_post";
+  createWorkMessage: "create_work_message_work_messages_post";
+  createWorkProject: "create_work_project_work_projects_post";
+  createWorkRoutine: "create_work_routine_work_routines_post";
+  deleteWorkChannel: "delete_work_channel_work_channels__channel_id__delete";
+  deleteWorkMessage: "delete_work_message_work_messages__message_id__delete";
+  deleteWorkProject: "delete_work_project_work_projects__project_id__delete";
+  deleteWorkRoutine: "delete_work_routine_work_routines__routine_id__delete";
+  editWorkMemory: "edit_work_memory_work_memory_put";
+  editWorkMessage: "edit_work_message_work_messages__message_id__patch";
+  forwardWorkMessage: "forward_work_message_work_messages__message_id__forward_post";
+  getWorkAgent: "get_work_agent_work_agents__agent_id__get";
+  getWorkAgentPolicy: "get_work_agent_policy_work_agents_policy_get";
+  getWorkAttachmentLink: "get_work_attachment_link_work_attachments__attachment_id__get";
+  getWorkChannelCanvas: "get_work_channel_canvas_work_channels__channel_id__canvas_get";
+  getWorkDailyBrief: "get_work_daily_brief_work_preferences_daily_brief_get";
+  getWorkInboxDispositions: "get_work_inbox_dispositions_work_inbox_dispositions_get";
+  getWorkMemory: "get_work_memory_work_memory_get";
+  getWorkMessage: "get_work_message_work_messages__message_id__get";
+  getWorkOversight: "get_work_oversight_work_oversight_get";
+  getWorkReadMarkers: "get_work_read_markers_work_read_markers_get";
+  getWorkRoom: "get_work_room_work_room_get";
+  getWorkTeamHistory: "get_work_team_history_work_team_hq_history_get";
+  getWorkTeamLeaderboard: "get_work_team_leaderboard_work_team_hq_leaderboard_get";
+  listAvailableWorkChannels: "list_available_work_channels_work_channels_available_get";
+  listWorkActivity: "list_work_activity_work_activity_get";
+  listWorkAgentExecutionIdentities: "list_work_agent_execution_identities_work_agents_execution_identities_get";
+  listWorkAgents: "list_work_agents_work_agents_get";
+  listWorkChannels: "list_work_channels_work_channels_get";
+  listWorkConversationEvents: "list_work_conversation_events_work_conversations__conversation_id__events_get";
+  listWorkConversationFiles: "list_work_conversation_files_work_conversations__conversation_id__files_get";
+  listWorkConversationMessages: "list_work_conversation_messages_work_conversations__conversation_id__messages_get";
+  listWorkItemHistory: "list_work_item_history_work_work_items_history_get";
+  listWorkItems: "list_work_items_work_work_items_get";
+  listWorkRecentActivity: "list_work_recent_activity_work_team_hq_recent_activity_get";
+  listWorkRoutineRuns: "list_work_routine_runs_work_routines__routine_id__runs_get";
+  listWorkRoutines: "list_work_routines_work_routines_get";
+  listWorkTeamReceipts: "list_work_team_receipts_work_team_hq_receipts_get";
+  moveWorkMemory: "move_work_memory_work_memory_move_post";
+  promoteWorkSignal: "promote_work_signal_work_signals_promote_post";
+  reactToWorkMessage: "react_to_work_message_work_messages__message_id__reaction_put";
+  runWorkRoutineNow: "run_work_routine_now_work_routines__routine_id__run_post";
+  saveWorkChannelCanvas: "save_work_channel_canvas_work_channels__channel_id__canvas_post";
+  searchWork: "search_work_work_search_get";
+  setWorkChannelPurpose: "set_work_channel_purpose_work_channels__channel_id__purpose_put";
+  setWorkDailyBrief: "set_work_daily_brief_work_preferences_daily_brief_post";
+  setWorkInboxDisposition: "set_work_inbox_disposition_work_inbox_dispositions_post";
+  setWorkPulseReaction: "set_work_pulse_reaction_work_pulse__note_id__reaction_post";
+  setWorkReadMarkers: "set_work_read_markers_work_read_markers_post";
+  setWorkSidebarPreferences: "set_work_sidebar_preferences_work_sidebar_preferences_post";
+  setWorkSignalState: "set_work_signal_state_work_signals_state_post";
+  updateWorkAgent: "update_work_agent_work_agents__agent_id__patch";
+  updateWorkChannel: "update_work_channel_work_channels__channel_id__patch";
+  updateWorkProject: "update_work_project_work_projects__project_id__patch";
+  updateWorkRoutine: "update_work_routine_work_routines__routine_id__patch";
+}
+
+/** Input and output of every `g8.api.work` operation, keyed by operationId. */
+export interface WorkOperations {
+  /**
+   * POST /work/custom-emoji
+   * Add Work Custom Emoji
+   * tier: write · scope: work:write
+   */
+  add_work_custom_emoji_work_custom_emoji_post: {
+    input: {
+    headers?: {
+      /** Retry-safety key. Replaying one returns the ORIGINAL result with `duplicate: true` instead of writing twice. Omit it and the server mints a single-use key, which means a retried request writes again — send your own for anything you may retry. */
+      "Idempotency-Key"?: string | null;
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: WorkCustomEmojiRequest;
+  };
+    output: ApiResponse_WorkCustomEmojiResult_;
+  };
+  /**
+   * POST /work/pulse
+   * Add Work Pulse Note
+   * tier: write · scope: work:write
+   */
+  add_work_pulse_note_work_pulse_post: {
+    input: {
+    headers?: {
+      /** Retry-safety key. Replaying one returns the ORIGINAL result with `duplicate: true` instead of writing twice. Omit it and the server mints a single-use key, which means a retried request writes again — send your own for anything you may retry. */
+      "Idempotency-Key"?: string | null;
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: WorkPulseNoteRequest;
+  };
+    output: ApiResponse_WorkPulseNote_;
+  };
+  /**
+   * DELETE /work/agents/{agent_id}
+   * Archive Work Agent
+   * tier: destructive · scope: work:delete
+   */
+  archive_work_agent_work_agents__agent_id__delete: {
+    input: {
+    path: {
+      /** Agent id */
+      agent_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WorkAgentArchived_;
+  };
+  /**
+   * POST /work/agents
+   * Create Work Agent
+   * tier: write · scope: work:write
+   */
+  create_work_agent_work_agents_post: {
+    input: {
+    headers?: {
+      /** Retry-safety key (a UUID). Replaying one returns the ORIGINAL agent instead of creating a second. Omit it and the server mints one, so a retried request creates again. */
+      "Idempotency-Key"?: string | null;
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: WorkAgentProfileRequest;
+  };
+    output: ApiResponse_WorkAgentCreated_;
+  };
+  /**
+   * POST /work/channels
+   * Create Work Channel
+   * tier: write · scope: work:write
+   */
+  create_work_channel_work_channels_post: {
+    input: {
+    headers?: {
+      /** Retry-safety key. Replaying one returns the ORIGINAL result with `duplicate: true` instead of writing twice. Omit it and the server mints a single-use key, which means a retried request writes again — send your own for anything you may retry. */
+      "Idempotency-Key"?: string | null;
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: WorkChannelCreateRequest;
+  };
+    output: ApiResponse_WorkChannelWriteResult_;
+  };
+  /**
+   * POST /work/messages
+   * Create Work Message
+   * tier: write · scope: work:write
+   */
+  create_work_message_work_messages_post: {
+    input: {
+    headers?: {
+      /** Retry-safety key. Replaying one returns the ORIGINAL result with `duplicate: true` instead of writing twice. Omit it and the server mints a single-use key, which means a retried request writes again — send your own for anything you may retry. */
+      "Idempotency-Key"?: string | null;
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: WorkMessageCreateRequest;
+  };
+    output: ApiResponse_WorkMessage_;
+  };
+  /**
+   * POST /work/projects
+   * Create Work Project
+   * tier: write · scope: work:write
+   */
+  create_work_project_work_projects_post: {
+    input: {
+    headers?: {
+      /** Retry-safety key. Replaying one returns the ORIGINAL result with `duplicate: true` instead of writing twice. Omit it and the server mints a single-use key, which means a retried request writes again — send your own for anything you may retry. */
+      "Idempotency-Key"?: string | null;
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: WorkProjectCreateRequest;
+  };
+    output: ApiResponse_WorkProjectWriteResult_;
+  };
+  /**
+   * POST /work/routines
+   * Create Work Routine
+   * tier: write · scope: work:write
+   */
+  create_work_routine_work_routines_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: WorkRoutineCreateRequest;
+  };
+    output: ApiResponse_WorkRoutineEnvelope_;
+  };
+  /**
+   * DELETE /work/channels/{channel_id}
+   * Delete Work Channel
+   * tier: destructive · scope: work:delete
+   */
+  delete_work_channel_work_channels__channel_id__delete: {
+    input: {
+    path: {
+      /** Channel id or slug */
+      channel_id: string;
+    };
+    headers?: {
+      /** Retry-safety key. Replaying one returns the ORIGINAL result with `duplicate: true` instead of writing twice. Omit it and the server mints a single-use key, which means a retried request writes again — send your own for anything you may retry. */
+      "Idempotency-Key"?: string | null;
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: WorkChannelDeleteRequest;
+  };
+    output: ApiResponse_WorkChannelWriteResult_;
+  };
+  /**
+   * DELETE /work/messages/{message_id}
+   * Delete Work Message
+   * tier: destructive · scope: work:delete
+   */
+  delete_work_message_work_messages__message_id__delete: {
+    input: {
+    path: {
+      /** Message id */
+      message_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WorkMessage_;
+  };
+  /**
+   * DELETE /work/projects/{project_id}
+   * Delete Work Project
+   * tier: destructive · scope: work:delete
+   */
+  delete_work_project_work_projects__project_id__delete: {
+    input: {
+    path: {
+      /** Project id */
+      project_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: WorkProjectDeleteRequest | null;
+  };
+    output: ApiResponse_WorkProjectDeleted_;
+  };
+  /**
+   * DELETE /work/routines/{routine_id}
+   * Delete Work Routine
+   * tier: destructive · scope: work:delete
+   */
+  delete_work_routine_work_routines__routine_id__delete: {
+    input: {
+    path: {
+      /** Routine id */
+      routine_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WorkRoutineDeleted_;
+  };
+  /**
+   * PUT /work/memory
+   * Edit Work Memory
+   * tier: write · scope: work:write
+   */
+  edit_work_memory_work_memory_put: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: WorkMemoryEditRequest;
+  };
+    output: ApiResponse_WorkMemoryNote_;
+  };
+  /**
+   * PATCH /work/messages/{message_id}
+   * Edit Work Message
+   * tier: write · scope: work:write
+   */
+  edit_work_message_work_messages__message_id__patch: {
+    input: {
+    path: {
+      /** Message id */
+      message_id: string;
+    };
+    headers?: {
+      /** Retry-safety key. Replaying one returns the ORIGINAL result with `duplicate: true` instead of writing twice. Omit it and the server mints a single-use key, which means a retried request writes again — send your own for anything you may retry. */
+      "Idempotency-Key"?: string | null;
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: WorkMessageEditRequest;
+  };
+    output: ApiResponse_WorkMessage_;
+  };
+  /**
+   * POST /work/messages/{message_id}/forward
+   * Forward Work Message
+   * tier: write · scope: work:write
+   */
+  forward_work_message_work_messages__message_id__forward_post: {
+    input: {
+    path: {
+      /** Message id */
+      message_id: string;
+    };
+    headers?: {
+      /** Retry-safety key. Replaying one returns the ORIGINAL result with `duplicate: true` instead of writing twice. Omit it and the server mints a single-use key, which means a retried request writes again — send your own for anything you may retry. */
+      "Idempotency-Key"?: string | null;
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: WorkMessageForwardRequest;
+  };
+    output: ApiResponse_WorkMessage_;
+  };
+  /**
+   * GET /work/agents/{agent_id}
+   * Get Work Agent
+   * tier: read · scope: work:read
+   */
+  get_work_agent_work_agents__agent_id__get: {
+    input: {
+    path: {
+      /** Agent id */
+      agent_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WorkAgentProfile_;
+  };
+  /**
+   * GET /work/agents/policy
+   * Get Work Agent Policy
+   * tier: read · scope: work:read
+   */
+  get_work_agent_policy_work_agents_policy_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WorkAgentPolicy_;
+  };
+  /**
+   * GET /work/attachments/{attachment_id}
+   * Get Work Attachment Link
+   * tier: read · scope: work:read
+   */
+  get_work_attachment_link_work_attachments__attachment_id__get: {
+    input: {
+    path: {
+      /** Attachment id */
+      attachment_id: string;
+    };
+    query?: {
+      /** Force a download rather than inline rendering */
+      download?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WorkAttachmentLink_;
+  };
+  /**
+   * GET /work/channels/{channel_id}/canvas
+   * Get Work Channel Canvas
+   * tier: read · scope: work:read
+   */
+  get_work_channel_canvas_work_channels__channel_id__canvas_get: {
+    input: {
+    path: {
+      /** Channel id or slug */
+      channel_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WorkCanvas_;
+  };
+  /**
+   * GET /work/preferences/daily-brief
+   * Get Work Daily Brief
+   * tier: read · scope: work:read
+   */
+  get_work_daily_brief_work_preferences_daily_brief_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WorkDailyBriefSettings_;
+  };
+  /**
+   * GET /work/inbox-dispositions
+   * Get Work Inbox Dispositions
+   * tier: read · scope: work:read
+   */
+  get_work_inbox_dispositions_work_inbox_dispositions_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WorkInboxDispositions_;
+  };
+  /**
+   * GET /work/memory
+   * Get Work Memory
+   * tier: read · scope: work:read
+   */
+  get_work_memory_work_memory_get: {
+    input: {
+    query?: {
+      /** `personal`, `agent` or `team` */
+      scope?: "personal" | "agent" | "team";
+      /** Required for, and only for, `agent` scope */
+      agent_id?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WorkMemoryPage_;
+  };
+  /**
+   * GET /work/messages/{message_id}
+   * Get Work Message
+   * tier: read · scope: work:read
+   */
+  get_work_message_work_messages__message_id__get: {
+    input: {
+    path: {
+      /** Message id */
+      message_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WorkMessage_;
+  };
+  /**
+   * GET /work/oversight
+   * Get Work Oversight
+   * tier: read · scope: work:read
+   */
+  get_work_oversight_work_oversight_get: {
+    input: {
+    query?: {
+      /** Maximum rows PER GROUP */
+      limit?: number;
+      /** How far back autonomous fixes are read */
+      fix_window_hours?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WorkOversight_;
+  };
+  /**
+   * GET /work/read-markers
+   * Get Work Read Markers
+   * tier: read · scope: work:read
+   */
+  get_work_read_markers_work_read_markers_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WorkReadMarkers_;
+  };
+  /**
+   * GET /work/room
+   * Get Work Room
+   * tier: read · scope: work:read
+   */
+  get_work_room_work_room_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WorkRoom_;
+  };
+  /**
+   * GET /work/team-hq/history
+   * Get Work Team History
+   * tier: read · scope: work:read
+   */
+  get_work_team_history_work_team_hq_history_get: {
+    input: {
+    query?: {
+      /** Window size in days; clamped to 3-31 */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WorkTeamHqHistory_;
+  };
+  /**
+   * GET /work/team-hq/leaderboard
+   * Get Work Team Leaderboard
+   * tier: read · scope: work:read
+   */
+  get_work_team_leaderboard_work_team_hq_leaderboard_get: {
+    input: {
+    query?: {
+      /** `day` or `month` */
+      period?: "day" | "month";
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WorkTeamHqLeaderboard_;
+  };
+  /**
+   * GET /work/channels/available
+   * List Available Work Channels
+   * tier: read · scope: work:read
+   */
+  list_available_work_channels_work_channels_available_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WorkAvailableChannelList_;
+  };
+  /**
+   * GET /work/activity
+   * List Work Activity
+   * tier: read · scope: work:read
+   */
+  list_work_activity_work_activity_get: {
+    input: {
+    query?: {
+      /** Page size; clamped to the server maximum */
+      limit?: number | null;
+      /** Opaque cursor from a previous page */
+      cursor?: string | null;
+      /** `human`, `agent`, `runner` or `system` */
+      actor?: string | null;
+      /** Only this agent's activity */
+      agentId?: string | null;
+      /** message, conversation, approval, execution, workflow, canvas or configuration */
+      category?: string | null;
+      /** Only this conversation */
+      conversation?: string | null;
+      /** requested, changed, approved, completed, failed or recorded */
+      consequence?: string | null;
+      /** ISO timestamp; inclusive lower bound */
+      from?: string | null;
+      /** ISO timestamp; inclusive upper bound */
+      to?: string | null;
+      /** Free text */
+      q?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WorkActivityPage_;
+  };
+  /**
+   * GET /work/agents/execution-identities
+   * List Work Agent Execution Identities
+   * tier: read · scope: work:read
+   */
+  list_work_agent_execution_identities_work_agents_execution_identities_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WorkAgentExecutionIdentities_;
+  };
+  /**
+   * GET /work/agents
+   * List Work Agents
+   * tier: read · scope: work:read
+   */
+  list_work_agents_work_agents_get: {
+    input: {
+    query?: {
+      /** Page size */
+      limit?: number;
+      /** `next_cursor` from the previous page */
+      after?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WorkAgentProfilePage_;
+  };
+  /**
+   * GET /work/channels
+   * List Work Channels
+   * tier: read · scope: work:read
+   */
+  list_work_channels_work_channels_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WorkChannelList_;
+  };
+  /**
+   * GET /work/conversations/{conversation_id}/events
+   * List Work Conversation Events
+   * tier: read · scope: work:read
+   */
+  list_work_conversation_events_work_conversations__conversation_id__events_get: {
+    input: {
+    path: {
+      /** Channel name, channel id, or direct-message id */
+      conversation_id: string;
+    };
+    query?: {
+      /** Page size; clamped to the server maximum */
+      limit?: number;
+      /** Opaque cursor from a previous page */
+      cursor?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WorkEventPage_;
+  };
+  /**
+   * GET /work/conversations/{conversation_id}/files
+   * List Work Conversation Files
+   * tier: read · scope: work:read
+   */
+  list_work_conversation_files_work_conversations__conversation_id__files_get: {
+    input: {
+    path: {
+      /** Channel name, channel id, or direct-message id */
+      conversation_id: string;
+    };
+    query?: {
+      /** Page size; clamped to the server maximum */
+      limit?: number;
+      /** Opaque cursor from a previous page */
+      cursor?: string | null;
+      /** Filter by filename */
+      query?: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WorkMessagePage_;
+  };
+  /**
+   * GET /work/conversations/{conversation_id}/messages
+   * List Work Conversation Messages
+   * tier: read · scope: work:read
+   */
+  list_work_conversation_messages_work_conversations__conversation_id__messages_get: {
+    input: {
+    path: {
+      /** Channel name, channel id, or direct-message id */
+      conversation_id: string;
+    };
+    query?: {
+      /** Page size; clamped to the server maximum */
+      limit?: number;
+      /** Opaque cursor from a previous page */
+      cursor?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WorkMessagePage_;
+  };
+  /**
+   * GET /work/work-items/history
+   * List Work Item History
+   * tier: read · scope: work:read
+   */
+  list_work_item_history_work_work_items_history_get: {
+    input: {
+    query?: {
+      /** Maximum rows returned */
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WorkItemList_;
+  };
+  /**
+   * GET /work/work-items
+   * List Work Items
+   * tier: read · scope: work:read
+   */
+  list_work_items_work_work_items_get: {
+    input: {
+    query?: {
+      /** Maximum rows returned */
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WorkItemList_;
+  };
+  /**
+   * GET /work/team-hq/recent-activity
+   * List Work Recent Activity
+   * tier: read · scope: work:read
+   */
+  list_work_recent_activity_work_team_hq_recent_activity_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WorkTickerEvents_;
+  };
+  /**
+   * GET /work/routines/{routine_id}/runs
+   * List Work Routine Runs
+   * tier: billable · scope: work:run
+   */
+  list_work_routine_runs_work_routines__routine_id__runs_get: {
+    input: {
+    path: {
+      /** Routine id */
+      routine_id: string;
+    };
+    query?: {
+      /** Maximum runs returned */
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WorkRoutineRunList_;
+  };
+  /**
+   * GET /work/routines
+   * List Work Routines
+   * tier: read · scope: work:read
+   */
+  list_work_routines_work_routines_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WorkRoutineList_;
+  };
+  /**
+   * GET /work/team-hq/receipts
+   * List Work Team Receipts
+   * tier: read · scope: work:read
+   */
+  list_work_team_receipts_work_team_hq_receipts_get: {
+    input: {
+    query: {
+      /** The rep whose recent moments to list */
+      email: string;
+      /** Max events; clamped to 1-50 */
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WorkTickerEvents_;
+  };
+  /**
+   * POST /work/memory/move
+   * Move Work Memory
+   * tier: write · scope: work:write
+   */
+  move_work_memory_work_memory_move_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: WorkMemoryMoveRequest;
+  };
+    output: ApiResponse_WorkMemoryNote_;
+  };
+  /**
+   * POST /work/signals/promote
+   * Promote Work Signal
+   * tier: billable · scope: work:run
+   */
+  promote_work_signal_work_signals_promote_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: WorkSignalPromoteRequest;
+  };
+    output: ApiResponse_WorkSignalPromoted_;
+  };
+  /**
+   * PUT /work/messages/{message_id}/reaction
+   * React To Work Message
+   * tier: write · scope: work:write
+   */
+  react_to_work_message_work_messages__message_id__reaction_put: {
+    input: {
+    path: {
+      /** Message id */
+      message_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: WorkMessageReactionRequest;
+  };
+    output: ApiResponse_WorkMessage_;
+  };
+  /**
+   * POST /work/routines/{routine_id}/run
+   * Run Work Routine Now
+   * tier: write · scope: work:write
+   */
+  run_work_routine_now_work_routines__routine_id__run_post: {
+    input: {
+    path: {
+      /** Routine id */
+      routine_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: WorkRoutineRunNowRequest | null;
+  };
+    output: ApiResponse_WorkRoutineRunResult_;
+  };
+  /**
+   * POST /work/channels/{channel_id}/canvas
+   * Save Work Channel Canvas
+   * tier: write · scope: work:write
+   */
+  save_work_channel_canvas_work_channels__channel_id__canvas_post: {
+    input: {
+    path: {
+      /** Channel id or slug */
+      channel_id: string;
+    };
+    headers?: {
+      /** Retry-safety key. Replaying one returns the ORIGINAL result with `duplicate: true` instead of writing twice. Omit it and the server mints a single-use key, which means a retried request writes again — send your own for anything you may retry. */
+      "Idempotency-Key"?: string | null;
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: WorkCanvasSaveRequest;
+  };
+    output: ApiResponse_WorkCanvas_;
+  };
+  /**
+   * GET /work/search
+   * Search Work
+   * tier: read · scope: work:read
+   */
+  search_work_work_search_get: {
+    input: {
+    query: {
+      /** Search text */
+      q: string;
+      /** Maximum hits; clamped to the server maximum */
+      limit?: number;
+      /** Channel name or direct-message id to search within */
+      conversation?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_WorkSearchResults_;
+  };
+  /**
+   * PUT /work/channels/{channel_id}/purpose
+   * Set Work Channel Purpose
+   * tier: write · scope: work:write
+   */
+  set_work_channel_purpose_work_channels__channel_id__purpose_put: {
+    input: {
+    path: {
+      /** Channel id or slug */
+      channel_id: string;
+    };
+    headers?: {
+      /** Retry-safety key. Replaying one returns the ORIGINAL result with `duplicate: true` instead of writing twice. Omit it and the server mints a single-use key, which means a retried request writes again — send your own for anything you may retry. */
+      "Idempotency-Key"?: string | null;
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: WorkChannelPurposeRequest;
+  };
+    output: ApiResponse_WorkChannelWriteResult_;
+  };
+  /**
+   * POST /work/preferences/daily-brief
+   * Set Work Daily Brief
+   * tier: write · scope: work:write
+   */
+  set_work_daily_brief_work_preferences_daily_brief_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: WorkDailyBriefSettingsRequest;
+  };
+    output: ApiResponse_WorkDailyBriefSettings_;
+  };
+  /**
+   * POST /work/inbox-dispositions
+   * Set Work Inbox Disposition
+   * tier: write · scope: work:write
+   */
+  set_work_inbox_disposition_work_inbox_dispositions_post: {
+    input: {
+    headers?: {
+      /** Retry-safety key. Replaying one returns the ORIGINAL result with `duplicate: true` instead of writing twice. Omit it and the server mints a single-use key, which means a retried request writes again — send your own for anything you may retry. */
+      "Idempotency-Key"?: string | null;
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: WorkInboxDispositionRequest;
+  };
+    output: ApiResponse_WorkInboxDisposition_;
+  };
+  /**
+   * POST /work/pulse/{note_id}/reaction
+   * Set Work Pulse Reaction
+   * tier: write · scope: work:write
+   */
+  set_work_pulse_reaction_work_pulse__note_id__reaction_post: {
+    input: {
+    path: {
+      /** Pulse note id */
+      note_id: string;
+    };
+    headers?: {
+      /** Retry-safety key. Replaying one returns the ORIGINAL result with `duplicate: true` instead of writing twice. Omit it and the server mints a single-use key, which means a retried request writes again — send your own for anything you may retry. */
+      "Idempotency-Key"?: string | null;
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: WorkPulseReactionRequest;
+  };
+    output: ApiResponse_WorkPulseReaction_;
+  };
+  /**
+   * POST /work/read-markers
+   * Set Work Read Markers
+   * tier: write · scope: work:write
+   */
+  set_work_read_markers_work_read_markers_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: WorkReadMarkersRequest;
+  };
+    output: ApiResponse_WorkReadMarkers_;
+  };
+  /**
+   * POST /work/sidebar-preferences
+   * Set Work Sidebar Preferences
+   * tier: write · scope: work:write
+   */
+  set_work_sidebar_preferences_work_sidebar_preferences_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: WorkSidebarPreferencesRequest;
+  };
+    output: ApiResponse_WorkSidebarPreferences_;
+  };
+  /**
+   * POST /work/signals/state
+   * Set Work Signal State
+   * tier: write · scope: work:write
+   */
+  set_work_signal_state_work_signals_state_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: WorkSignalStateRequest;
+  };
+    output: ApiResponse_WorkSignalState_;
+  };
+  /**
+   * PATCH /work/agents/{agent_id}
+   * Update Work Agent
+   * tier: write · scope: work:write
+   */
+  update_work_agent_work_agents__agent_id__patch: {
+    input: {
+    path: {
+      /** Agent id */
+      agent_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: WorkAgentProfileEditRequest;
+  };
+    output: ApiResponse_WorkAgentProfile_;
+  };
+  /**
+   * PATCH /work/channels/{channel_id}
+   * Update Work Channel
+   * tier: write · scope: work:write
+   */
+  update_work_channel_work_channels__channel_id__patch: {
+    input: {
+    path: {
+      /** Channel id or slug */
+      channel_id: string;
+    };
+    headers?: {
+      /** Retry-safety key. Replaying one returns the ORIGINAL result with `duplicate: true` instead of writing twice. Omit it and the server mints a single-use key, which means a retried request writes again — send your own for anything you may retry. */
+      "Idempotency-Key"?: string | null;
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: WorkChannelSettingsRequest;
+  };
+    output: ApiResponse_WorkChannelWriteResult_;
+  };
+  /**
+   * PATCH /work/projects/{project_id}
+   * Update Work Project
+   * tier: write · scope: work:write
+   */
+  update_work_project_work_projects__project_id__patch: {
+    input: {
+    path: {
+      /** Project id */
+      project_id: string;
+    };
+    headers?: {
+      /** Retry-safety key. Replaying one returns the ORIGINAL result with `duplicate: true` instead of writing twice. Omit it and the server mints a single-use key, which means a retried request writes again — send your own for anything you may retry. */
+      "Idempotency-Key"?: string | null;
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: WorkProjectUpdateRequest;
+  };
+    output: ApiResponse_WorkProjectWriteResult_;
+  };
+  /**
+   * PATCH /work/routines/{routine_id}
+   * Update Work Routine
+   * tier: write · scope: work:write
+   */
+  update_work_routine_work_routines__routine_id__patch: {
+    input: {
+    path: {
+      /** Routine id */
+      routine_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: WorkRoutinePatchRequest;
+  };
+    output: ApiResponse_WorkRoutineEnvelope_;
+  };
+}
+
+// 122 schemas referenced above (the same as G8Contract.<Name>).
+
+export interface ApiResponse_WorkActivityPage_ {
+  data: WorkActivityPage;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkAgentArchived_ {
+  data: WorkAgentArchived;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkAgentCreated_ {
+  data: WorkAgentCreated;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkAgentExecutionIdentities_ {
+  data: WorkAgentExecutionIdentities;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkAgentPolicy_ {
+  data: WorkAgentPolicy;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkAgentProfilePage_ {
+  data: WorkAgentProfilePage;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkAgentProfile_ {
+  data: WorkAgentProfile;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkAttachmentLink_ {
+  data: WorkAttachmentLink;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkAvailableChannelList_ {
+  data: WorkAvailableChannelList;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkCanvas_ {
+  data: WorkCanvas;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkChannelList_ {
+  data: WorkChannelList;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkChannelWriteResult_ {
+  data: WorkChannelWriteResult;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkCustomEmojiResult_ {
+  data: WorkCustomEmojiResult;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkDailyBriefSettings_ {
+  data: WorkDailyBriefSettings;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkEventPage_ {
+  data: WorkEventPage;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkInboxDisposition_ {
+  data: WorkInboxDisposition;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkInboxDispositions_ {
+  data: WorkInboxDispositions;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkItemList_ {
+  data: WorkItemList;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkMemoryNote_ {
+  data: WorkMemoryNote;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkMemoryPage_ {
+  data: WorkMemoryPage;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkMessagePage_ {
+  data: WorkMessagePage;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkMessage_ {
+  data: WorkMessage;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkOversight_ {
+  data: WorkOversight;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkProjectDeleted_ {
+  data: WorkProjectDeleted;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkProjectWriteResult_ {
+  data: WorkProjectWriteResult;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkPulseNote_ {
+  data: WorkPulseNote;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkPulseReaction_ {
+  data: WorkPulseReaction;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkReadMarkers_ {
+  data: WorkReadMarkers;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkRoom_ {
+  data: WorkRoom;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkRoutineDeleted_ {
+  data: WorkRoutineDeleted;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkRoutineEnvelope_ {
+  data: WorkRoutineEnvelope;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkRoutineList_ {
+  data: WorkRoutineList;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkRoutineRunList_ {
+  data: WorkRoutineRunList;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkRoutineRunResult_ {
+  data: WorkRoutineRunResult;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkSearchResults_ {
+  data: WorkSearchResults;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkSidebarPreferences_ {
+  data: WorkSidebarPreferences;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkSignalPromoted_ {
+  data: WorkSignalPromoted;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkSignalState_ {
+  data: WorkSignalState;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkTeamHqHistory_ {
+  data: WorkTeamHqHistory;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkTeamHqLeaderboard_ {
+  data: WorkTeamHqLeaderboard;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_WorkTickerEvents_ {
+  data: WorkTickerEvents;
+  pagination?: PaginationMeta | null;
+}
+
+export interface PaginationMeta {
+  /** Whether there are more pages */
+  has_next: boolean;
+  /** Items per page */
+  limit: number;
+  /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
+  next_cursor?: string | null;
+  /** Current page number (1-indexed) */
+  page: number;
+  /** Total number of items */
+  total: number;
+}
+
+/** One entry in the Work activity feed. */
+export interface WorkActivityEntry {
+  /** `human`, `agent`, `runner` or `system` */
+  actor?: string | null;
+  /** message, conversation, approval, execution, workflow, canvas or configuration */
+  category?: string | null;
+  /** requested, changed, approved, completed, failed or recorded */
+  consequence?: string | null;
+  /** Activity entry id */
+  id?: string | null;
+  [key: string]: unknown;
+}
+
+/** One page of the activity feed, scoped to what this credential may read. */
+export interface WorkActivityPage {
+  /** Activity entries, newest first */
+  events?: Array<WorkActivityEntry>;
+  /** Whether older entries remain */
+  has_more?: boolean;
+  /** Opaque cursor for the next page */
+  next_cursor?: string | null;
+}
+
+/** An archived Work agent. */
+export interface WorkAgentArchived {
+  /** The agent that was archived */
+  agent_id: string;
+  /** True once archived */
+  archived?: boolean;
+}
+
+/** A newly created Work agent and its first conversation. */
+export interface WorkAgentCreated {
+  /** Agent id */
+  agent_id?: string | null;
+  /** The agent's conversation session id */
+  session_id?: string | null;
+  [key: string]: unknown;
+}
+
+/** Identities a Work agent may execute as. */
+export interface WorkAgentExecutionIdentities {
+  /** Execution identities */
+  items?: Array<Record<string, unknown>> | null;
+  /** Identities that could not be resolved */
+  warnings?: Array<string> | null;
+  [key: string]: unknown;
+}
+
+/** What this caller may do with Work agents. */
+export interface WorkAgentPolicy {
+  /** May create a private agent */
+  can_create?: boolean | null;
+  /** May create an organization-wide agent */
+  can_share_organization?: boolean | null;
+  [key: string]: unknown;
+}
+
+/** One Work agent profile as the caller may see it. */
+export interface WorkAgentProfile {
+  /** Agent id */
+  agent_id?: string | null;
+  /** Avatar glyph */
+  avatar?: string | null;
+  /** Whether this caller may edit it */
+  can_edit?: boolean | null;
+  /** Instructions */
+  description?: string | null;
+  /** Agent name */
+  name?: string | null;
+  /** Owner identity */
+  owner_id?: string | null;
+  /** Role */
+  role?: string | null;
+  /** Last edit time */
+  updated_at?: string | null;
+  /** Profile version; send it back to edit */
+  version?: number | null;
+  /** `private` or `organization` */
+  visibility?: string | null;
+  [key: string]: unknown;
+}
+
+/** A versioned profile edit. Mirrors ``work.agent_profile_router.AgentProfileEdit``. */
+export interface WorkAgentProfileEditRequest {
+  /** The `version` you read; a stale one is a 409 */
+  expected_version: number;
+  /** The full new profile */
+  profile: WorkAgentProfileRequest;
+}
+
+/** One page of visible Work agents. */
+export interface WorkAgentProfilePage {
+  /** Agents on this page */
+  items?: Array<WorkAgentProfile>;
+  /** Pass as `after` for the next page */
+  next_cursor?: string | null;
+}
+
+/** A Work agent's profile. Mirrors ``work.agent_profiles.AgentProfileInput``. */
+export interface WorkAgentProfileRequest {
+  /** Avatar glyph */
+  avatar?: "spark" | "compass" | "chart" | "code" | "pen" | "search" | "shield" | "bolt";
+  /** The agent's instructions */
+  description: string;
+  /** Agent name */
+  name: string;
+  /** Role shown beside the name */
+  role?: string;
+  /** `private` to its owner, or shared with the `organization` */
+  visibility?: "private" | "organization";
+}
+
+/** A short-lived download link for one attachment. */
+export interface WorkAttachmentLink {
+  /** Stored attachment metadata */
+  attachment?: Record<string, unknown>;
+  /** Seconds until the URL stops working */
+  expires_in: number;
+  /** Time-limited download URL */
+  url: string;
+}
+
+/**
+ * A channel of this organization the caller is not currently part of.
+ *
+ * An `open` channel carries its description and member count; a `private` one
+ * answers with identity only, so nothing about the room itself leaks.
+ */
+export interface WorkAvailableChannel {
+  /** Present for `open` channels only */
+  description?: string | null;
+  /** Human-readable name */
+  displayName?: string | null;
+  /** Channel id */
+  id?: string | null;
+  /** Present for `open` channels only */
+  memberCount?: number | null;
+  /** Channel slug */
+  name?: string | null;
+  /** `open` or `private` */
+  visibility?: string | null;
+  [key: string]: unknown;
+}
+
+/** The organization's channels the caller is not in. */
+export interface WorkAvailableChannelList {
+  /** Channels the caller is not part of */
+  channels?: Array<WorkAvailableChannel>;
+}
+
+/** One channel's Canvas document. */
+export interface WorkCanvas {
+  /** Channel the canvas belongs to */
+  channelId?: string | null;
+  /** Canvas content */
+  content?: string | null;
+  /** Current revision id */
+  revisionId?: string | null;
+  [key: string]: unknown;
+}
+
+/**
+ * One channel canvas replacement, by CONTENT.
+ *
+ * The channel is named by the path, the author by the session, the
+ * idempotency key by the header — this body carries only the markdown. An
+ * empty string is a legal canvas (it clears the document); the 100k ceiling
+ * is the gateway's own. Server-owned fields are refused by name rather than
+ * swallowed by `extra="forbid"`, matching every other Work write DTO: a
+ * client that believes it is choosing the author must be told it is not.
+ */
+export interface WorkCanvasSaveRequest {
+  baseRevisionId?: string | null;
+  content: string;
+}
+
+/** One Work channel as the room stores it. */
+export interface WorkChannel {
+  /** When the channel was archived, if it is */
+  archivedAt?: string | null;
+  /** Creation timestamp */
+  createdAt?: string | null;
+  /** Identity that created the channel */
+  createdBy?: string | null;
+  /** Channel description */
+  description?: string | null;
+  /** Human-readable name shown in the sidebar */
+  displayName?: string | null;
+  /** Channel id (uuid5 of `{org}:{name}` — the room address) */
+  id?: string | null;
+  /** `stream` or `forum` */
+  kind?: string | null;
+  /** Seated member identities */
+  memberUserIds?: Array<string> | null;
+  /** Slug, unique per organization. Renaming the display name never moves the room. */
+  name?: string | null;
+  /** Seated agent ids */
+  participantAgentIds?: Array<string> | null;
+  /** True for a built-in channel (`#work`, `#signals`) */
+  system?: boolean | null;
+  /** `open` (self-serve joinable) or `private` (invite only) */
+  visibility?: string | null;
+  [key: string]: unknown;
+}
+
+/**
+ * One channel a person is creating.
+ *
+ * Carries what the channel IS and who is seated in it — never who is creating
+ * it. The creator, the organization and the signing identity all come from the
+ * authenticated session in `work/router.py`, and `Idempotency-Key` comes from
+ * the header. `SERVER_OWNED_MESSAGE_FIELDS` is reused verbatim for the refusal
+ * because the danger is identical: `create_work_event` turns whatever
+ * `actor_id`/`org_id` it is handed into the signing key AND the `g8_actor` /
+ * `g8_org` tags.
+ */
+export interface WorkChannelCreateRequest {
+  description?: string | null;
+  displayName?: string | null;
+  kind?: "stream" | "forum";
+  memberUserIds?: Array<string>;
+  name: string;
+  participantAgentIds?: Array<string>;
+  /** One of `work/channel_templates.py`'s ids. Seats its specialists and seeds its Canvas. */
+  templateId?: string | null;
+  /** A Temporary channel's lifetime in seconds; absent means Permanent. */
+  ttlSeconds?: number | null;
+  visibility?: "open" | "private";
+}
+
+export interface WorkChannelDeleteRequest {
+  confirmationName: string;
+}
+
+/** The channels this credential may read. */
+export interface WorkChannelList {
+  /** Channels visible to the caller */
+  channels?: Array<WorkChannel>;
+}
+
+/**
+ * The purpose one channel is being given, or `null` to clear it.
+ *
+ * Required-but-nullable on purpose: `{}` would be ambiguous between "clear it"
+ * and "I forgot the field", and this operation reassigns state on channels the
+ * caller did not name, so it may not act on an ambiguity.
+ */
+export interface WorkChannelPurposeRequest {
+  purpose: string | null;
+}
+
+/**
+ * The fields of one channel a person is changing.
+ *
+ * **Field PRESENCE is the contract, not field value.** An omitted field keeps
+ * whatever the channel already has; a field present with `null` clears it
+ * where clearing is meaningful (`description`) and is refused where it is not.
+ * That is the port of the gateway's `Object.hasOwn(input, …)` checks, and it
+ * is why `provided_fields` — not the values — is what the router hands the
+ * service.
+ */
+export interface WorkChannelSettingsRequest {
+  agentResponsePolicy?: ("mention_required" | "proactive") | null;
+  archived?: boolean | null;
+  confirmAgentAccess?: boolean;
+  description?: string | null;
+  displayName?: string | null;
+  memberUserIds?: Array<string>;
+  participantAgentIds?: Array<string>;
+  visibility?: ("open" | "private") | null;
+}
+
+/** The result of one channel write, with its idempotent-replay marker. */
+export interface WorkChannelWriteResult {
+  /** Present when `templateId` seeded a Canvas */
+  canvasSeeded?: boolean | null;
+  /** The channel as stored after the write */
+  channel?: WorkChannel | null;
+  /** True when an Idempotency-Key replay returned the original result */
+  duplicate?: boolean | null;
+  [key: string]: unknown;
+}
+
+/**
+ * One organization-wide custom emoji.
+ *
+ * The URL is constrained to `https:` on purpose and refused rather than
+ * coerced. A custom emoji is rendered by every member's browser in every
+ * channel that uses it, so an `http:` or `javascript:` URL here is not a
+ * formatting problem — it is a stored payload with an audience.
+ */
+export interface WorkCustomEmojiRequest {
+  shortcode: string;
+  url: string;
+}
+
+/** The organization's custom emoji after one registration. */
+export interface WorkCustomEmojiResult {
+  /** Every custom emoji the organization now has */
+  customEmojis?: Array<Record<string, unknown>> | null;
+  /** True when an Idempotency-Key replay returned the original result */
+  duplicate?: boolean | null;
+  /** The room event the write appended */
+  event?: Record<string, unknown> | null;
+  [key: string]: unknown;
+}
+
+/** This principal's daily-brief schedule and, on a read, its delivery status. */
+export interface WorkDailyBriefSettings {
+  /** The stored schedule */
+  settings?: Record<string, unknown> | null;
+  /** Delivery status (`latestBrief`, `lastBriefDate`, `nextDueAt`, `reason`). Returned on the read only; null on the write */
+  status?: Record<string, unknown> | null;
+  [key: string]: unknown;
+}
+
+/**
+ * When this person wants their daily brief.
+ *
+ * The timezone is the one field that is REFUSED rather than defaulted. A
+ * brief is a scheduled send, and an unrecognised zone has no defensible
+ * fallback: guessing UTC delivers somebody's morning brief at midnight,
+ * silently, forever. `weekdays` and `localTime` do have a defensible default
+ * (weekdays at 08:00) and take it, which is the gateway's split too.
+ */
+export interface WorkDailyBriefSettingsRequest {
+  enabled?: boolean;
+  localTime?: string | null;
+  timezone: string;
+  weekdays?: Array<number> | null;
+}
+
+/** One signed Work event from the conversation ledger. */
+export interface WorkEvent {
+  /** Event creation time */
+  created_at?: number | null;
+  /** Event id */
+  id?: string | null;
+  /** Event kind number */
+  kind?: number | null;
+  [key: string]: unknown;
+}
+
+/** One page of a conversation's chat events, newest first. */
+export interface WorkEventPage {
+  /** True when the caller's own clear watermark hides everything older */
+  cleared_behind?: boolean | null;
+  /** The conversation these events belong to */
+  conversation_id: string;
+  /** Events the caller may read */
+  events?: Array<WorkEvent>;
+  /** Whether older stored rows remain */
+  has_more?: boolean;
+  /** Opaque cursor for the next page */
+  next_cursor?: string | null;
+}
+
+/** One conversation's Inbox state after a write. */
+export interface WorkInboxDisposition {
+  /** The disposition as stored */
+  disposition?: Record<string, unknown> | null;
+  /** True when an Idempotency-Key replay returned the original result */
+  duplicate?: boolean | null;
+  [key: string]: unknown;
+}
+
+/**
+ * One conversation moving between the Inbox's three states.
+ *
+ * `latest_activity_at` is the conversation boundary the decision was made at,
+ * not a timestamp of the decision: a newer inbound message must re-activate a
+ * snoozed or archived conversation without erasing the record that somebody
+ * once set it aside. That is why the state is stored per conversation rather
+ * than as a flag on the conversation itself.
+ */
+export interface WorkInboxDispositionRequest {
+  channel: string;
+  conversationKey: string;
+  latestActivityAt: number;
+  rootId: string;
+  snoozedUntil?: string | null;
+  state: "active" | "snoozed" | "archived";
+}
+
+/** This principal's Inbox states, keyed by conversation. */
+export interface WorkInboxDispositions {
+  /** Conversation key -> `active`, `snoozed` or `archived` */
+  dispositions?: Record<string, unknown> | null;
+  [key: string]: unknown;
+}
+
+/** One unit of agent work on the All Work board. */
+export interface WorkItem {
+  /** Due date, when one is set */
+  dueAt?: string | null;
+  /** Work item id */
+  id?: string | null;
+  /** Identity the item is assigned to */
+  ownerUserId?: string | null;
+  /** Priority band */
+  priority?: string | null;
+  /** Lifecycle status */
+  status?: string | null;
+  /** What the work is */
+  title?: string | null;
+  [key: string]: unknown;
+}
+
+/** A page of work items. */
+export interface WorkItemList {
+  /** Work items visible to the caller */
+  work_items?: Array<WorkItem>;
+}
+
+/** Replace one memory topic. Mirrors ``work.memory_router.MemoryEdit``. */
+export interface WorkMemoryEditRequest {
+  /** Required for, and only for, `agent` scope */
+  agent_id?: string | null;
+  /** The new content */
+  content: string;
+  /** The `revision` you read, or null when the topic is new */
+  expected_revision: string | null;
+  /** `personal`, `agent` or `team` */
+  scope?: "personal" | "agent" | "team";
+  /** The topic to replace */
+  topic: "profile" | "goals" | "decisions" | "feedback" | "corrections" | "entities";
+}
+
+/** Move one topic between scopes. Mirrors ``work.memory_router.MemoryMove``. */
+export interface WorkMemoryMoveRequest {
+  /** Where it should go */
+  destination: WorkMemoryScope;
+  /** The destination topic's revision, or null when it is empty */
+  destination_revision: string | null;
+  /** Where the topic is now */
+  source: WorkMemoryScope;
+  /** The source topic's current revision */
+  source_revision: string;
+  /** The topic to move */
+  topic: "profile" | "goals" | "decisions" | "feedback" | "corrections" | "entities";
+}
+
+/** One memory topic. */
+export interface WorkMemoryNote {
+  /** Content */
+  content?: string | null;
+  /** Revision; send it back to edit or move */
+  revision?: string | null;
+  /** Stored size */
+  size_bytes?: number | null;
+  /** Topic */
+  topic?: string | null;
+  /** Last write time */
+  updated_at?: string | null;
+  [key: string]: unknown;
+}
+
+/** Every topic in one memory scope. */
+export interface WorkMemoryPage {
+  /** The agent, for `agent` scope */
+  agent_id?: string | null;
+  /** Whether this caller may edit this scope */
+  can_edit?: boolean | null;
+  /** The topics */
+  entries?: Array<WorkMemoryNote> | null;
+  /** The scope read */
+  scope?: string | null;
+  [key: string]: unknown;
+}
+
+/** Which memory to act on. Mirrors ``work.memory.MemorySelection``. */
+export interface WorkMemoryScope {
+  /** Required for, and only for, `agent` scope */
+  agent_id?: string | null;
+  /** `personal`, `agent` or `team` */
+  scope?: "personal" | "agent" | "team";
+}
+
+/** One stored Work message. */
+export interface WorkMessage {
+  /** Resolved author — always the authenticated principal, never a request field */
+  author?: Record<string, unknown> | null;
+  /** Conversation address — a channel NAME or a direct-message id */
+  channel?: string | null;
+  /** Creation timestamp */
+  createdAt?: string | null;
+  /** Rich-text document, normalized server-side */
+  document?: Record<string, unknown> | null;
+  /** Message id */
+  id?: string | null;
+  /** Plain-text projection of the document */
+  text?: string | null;
+  [key: string]: unknown;
+}
+
+/**
+ * One message a person is sending into a Work channel.
+ *
+ * Carries what is being said and where — never who is saying it. The author,
+ * the organization and the signing identity all come from the authenticated
+ * session in `work/router.py`; `Idempotency-Key` comes from the header.
+ */
+export interface WorkMessageCreateRequest {
+  attachmentIds?: Array<string>;
+  channel: string;
+  document?: Record<string, unknown> | null;
+  mentionAgentIds?: Array<string>;
+  mentionUserIds?: Array<string>;
+  message?: string | null;
+  parentMessageId?: string | null;
+  projectId?: string | null;
+  rootMessageId?: string | null;
+}
+
+/** New words for a message the caller wrote. Never who wrote it, or where. */
+export interface WorkMessageEditRequest {
+  document?: Record<string, unknown> | null;
+  expected_revision?: number;
+  text?: string | null;
+}
+
+export interface WorkMessageForwardRequest {
+  channel: string;
+}
+
+/** One page of a conversation's messages, newest first. */
+export interface WorkMessagePage {
+  /** True when the caller's own clear watermark hides everything older */
+  cleared_behind?: boolean | null;
+  /** The conversation these messages belong to */
+  conversation_id: string;
+  /** Whether older stored rows remain */
+  has_more?: boolean;
+  /** Messages the caller may read */
+  messages?: Array<WorkMessage>;
+  /** Opaque cursor for the next page */
+  next_cursor?: string | null;
+}
+
+export interface WorkMessageReactionRequest {
+  active: boolean;
+  emoji: string;
+}
+
+/**
+ * What needs a person: approvals, blocked work and unattended fixes.
+ *
+ * Each group carries its own state, so one failed read never blanks the others
+ * and an empty list always says which of "nothing here", "we could not find
+ * out" and "nothing is recorded for this workspace" it means.
+ */
+export type WorkOversight = Record<string, unknown>;
+
+/** One project: a named unit of work attached to a channel. */
+export interface WorkProject {
+  /** Channel the project belongs to */
+  channel?: string | null;
+  /** Ownership identity of whoever created it */
+  createdBy?: string | null;
+  /** Project description; null when cleared */
+  description?: string | null;
+  /** Project id, minted server-side */
+  id?: string | null;
+  /** Project name */
+  name?: string | null;
+  /** `active`, `paused`, `completed` or `archived` */
+  status?: string | null;
+  [key: string]: unknown;
+}
+
+/**
+ * One project a person is creating, in one channel.
+ *
+ * `channel` is the channel NAME — a project belongs to a room, and the room
+ * decides who may create one. The identifier is minted server-side and the
+ * creator comes from the session; `SERVER_OWNED_MESSAGE_FIELDS` refuses a
+ * body that tries to assert either, by name rather than by `extra="forbid"`.
+ */
+export interface WorkProjectCreateRequest {
+  channel: string;
+  description?: string | null;
+  name: string;
+  status?: "active" | "paused" | "completed" | "archived";
+}
+
+/** Auditable project tombstone input. */
+export interface WorkProjectDeleteRequest {
+  reason?: string;
+}
+
+/** A project tombstone readback. What survives is named, not implied. */
+export interface WorkProjectDeleted {
+  /** Action receipts KEPT, for the same reason */
+  action_receipts_preserved?: number | null;
+  /** True once the tombstone is in place */
+  deleted?: boolean | null;
+  /** When the tombstone was written */
+  deleted_at?: string | null;
+  /** Messages KEPT: deleting a project does not delete its conversation */
+  messages_preserved?: number | null;
+  /** The project that was tombstoned */
+  project_id?: string | null;
+  [key: string]: unknown;
+}
+
+/**
+ * One project being changed. Field PRESENCE is the contract.
+ *
+ * `channel` is absent on purpose: a project's channel is where its messages
+ * and receipts already point, so moving one would strand them. Renaming,
+ * re-describing and moving its status are what this accepts.
+ */
+export interface WorkProjectUpdateRequest {
+  description?: string | null;
+  name?: string | null;
+  status?: ("active" | "paused" | "completed" | "archived") | null;
+}
+
+/** The result of one project write, with its idempotent-replay marker. */
+export interface WorkProjectWriteResult {
+  /** Id of the room event the write appended */
+  compatibilityEventId?: string | null;
+  /** True when an Idempotency-Key replay returned the original result rather than writing again */
+  duplicate?: boolean | null;
+  /** The project as stored after the write */
+  project?: WorkProject | null;
+  [key: string]: unknown;
+}
+
+/** One posted pulse update. */
+export interface WorkPulseNote {
+  /** True when an Idempotency-Key replay returned the original result */
+  duplicate?: boolean | null;
+  /** The room event carrying the note */
+  event?: Record<string, unknown> | null;
+  [key: string]: unknown;
+}
+
+/** One pulse update — the room's org-wide, channel-less status note. */
+export interface WorkPulseNoteRequest {
+  content: string;
+  replyToEventId?: string | null;
+}
+
+/** The upvote that now stands on a pulse note. */
+export interface WorkPulseReaction {
+  /** True when the request asked for the state already stored */
+  duplicate?: boolean | null;
+  /** The room event, or null when taking back an upvote nobody had left nothing to write */
+  event?: Record<string, unknown> | null;
+  /** The state that now stands */
+  reacted?: boolean | null;
+  [key: string]: unknown;
+}
+
+/**
+ * Upvote one pulse note, or take the upvote back.
+ *
+ * `reacted` is the DESIRED state, not a toggle. A toggle would make the
+ * outcome depend on what the client believed the current state was, which is
+ * exactly the assumption two open tabs break; asserting the target state lets
+ * the server short-circuit a request that asks for the state it is already in.
+ */
+export interface WorkPulseReactionRequest {
+  reacted: boolean;
+}
+
+/**
+ * How far this person has read ONE conversation.
+ *
+ * `last_read_at` is the conversation's `latestAt` boundary the reader was
+ * shown, in unix seconds — the same clock `WorkInboxDispositionRequest`
+ * keeps in `latest_activity_at` — not the instant they looked. A newer
+ * inbound message therefore lights the badge again on its own: the
+ * comparison is `latestAt > lastReadAt`, and nothing has to un-mark anything.
+ *
+ * Seconds are not a total order: `post_message` truncates event timestamps
+ * to whole seconds, so a message that lands in the SAME second as the one
+ * the reader saw would compare equal and pass as read. `last_read_id` — the
+ * id of the newest message the reader was shown — is the tiebreaker: at an
+ * equal second, only a matching id counts as read (Codex on #16589).
+ */
+export interface WorkReadMarkerRequest {
+  channel: string;
+  conversationKey: string;
+  lastReadAt: number;
+  lastReadId?: string | null;
+  rootId: string;
+}
+
+/** This principal's read markers, keyed by conversation. */
+export interface WorkReadMarkers {
+  /** Conversation key -> the point this principal has read to */
+  markers?: Record<string, unknown> | null;
+  [key: string]: unknown;
+}
+
+/**
+ * A batch of read markers — one request per room opened, not per thread.
+ *
+ * Opening a channel with four waiting threads reads all four at once; four
+ * round trips racing one read-modify-write of the same JSONB value is the
+ * write pattern the org lock exists to serialize, so the batch is the unit.
+ * Bounded so a runaway client cannot hand the server a map to merge.
+ */
+export interface WorkReadMarkersRequest {
+  markers: Array<WorkReadMarkerRequest>;
+}
+
+/** The canonical Work room, scoped and bounded for whoever asked for it. */
+export interface WorkRoom {
+  /** Agent roster available in this workspace */
+  agents?: Array<Record<string, unknown>> | null;
+  /** Per-collection counts of what the caller can see */
+  counts?: Record<string, unknown> | null;
+  /** Organization member directory, for turning an actor id into a name */
+  members?: Array<Record<string, unknown>> | null;
+  /** Channels, direct messages, messages, events and per-viewer state the caller may read */
+  room?: Record<string, unknown> | null;
+  /** What was left out of the bounded read, and the cursors to resume from */
+  truncation?: Record<string, unknown> | null;
+  [key: string]: unknown;
+}
+
+/** One scheduled or event-triggered Work routine. */
+export interface WorkRoutine {
+  /** Agent that runs the routine */
+  agentId?: string | null;
+  /** Conversation the routine posts into */
+  deliveryConversationId?: string | null;
+  /** Whether the routine is active */
+  enabled?: boolean | null;
+  /** Routine id */
+  id?: string | null;
+  /** What the agent is asked to do each run */
+  instruction?: string | null;
+  /** When the routine last ran */
+  lastRunAt?: string | null;
+  /** How the last run ended */
+  lastStatus?: string | null;
+  /** Local run time, for `schedule` routines */
+  localTime?: string | null;
+  /** IANA timezone the local time is read in */
+  timezone?: string | null;
+  /** Routine title */
+  title?: string | null;
+  /** `schedule` or `event` */
+  triggerKind?: string | null;
+  /** Schedule weekdays (0-6), for `schedule` routines */
+  weekdays?: Array<number> | null;
+  [key: string]: unknown;
+}
+
+/** One routine to create. Identity is never expressible here. */
+export interface WorkRoutineCreateRequest {
+  /** Agent that runs the routine */
+  agentId: string;
+  /** Conversation the routine posts into; must be readable by the caller */
+  deliveryConversationId: string;
+  /** Whether the routine starts active */
+  enabled?: boolean;
+  /** Optional event-handling policy */
+  eventPolicy?: Record<string, unknown> | null;
+  /** What the agent is asked to do each run */
+  instruction: string;
+  /** Local run time `HH:MM`, for `schedule` routines */
+  localTime?: string | null;
+  /** IANA timezone the local time is read in */
+  timezone?: string;
+  /** What the routine is called */
+  title: string;
+  /** Trigger config, for `event` routines */
+  trigger?: Record<string, unknown> | null;
+  /** `schedule` or `event` */
+  triggerKind?: string;
+  /** Days to run on (0-6), for `schedule` routines */
+  weekdays?: Array<number> | null;
+}
+
+/** Confirmation that one routine is gone. */
+export interface WorkRoutineDeleted {
+  /** Always true; the operation is idempotent */
+  deleted?: boolean;
+  /** The routine that was deleted */
+  id: string;
+}
+
+/** One routine, as the create and update operations return it. */
+export interface WorkRoutineEnvelope {
+  /** The routine as stored after the write */
+  routine: WorkRoutine;
+}
+
+/** Every routine in this organization's workspace. */
+export interface WorkRoutineList {
+  /** Routines, with recent event activity folded in */
+  routines?: Array<WorkRoutine>;
+}
+
+/** Changes to one routine. Omitted fields keep their stored value. */
+export interface WorkRoutinePatchRequest {
+  /** Agent that runs the routine */
+  agentId?: string | null;
+  /** Re-point delivery; the new conversation must also be readable */
+  deliveryConversationId?: string | null;
+  /** Turn the routine on or off */
+  enabled?: boolean | null;
+  /** Optional event-handling policy */
+  eventPolicy?: Record<string, unknown> | null;
+  /** What the agent is asked to do each run */
+  instruction?: string | null;
+  /** Local run time `HH:MM` */
+  localTime?: string | null;
+  /** IANA timezone the local time is read in */
+  timezone?: string | null;
+  /** What the routine is called */
+  title?: string | null;
+  /** Trigger config, for `event` routines */
+  trigger?: Record<string, unknown> | null;
+  /** `schedule` or `event` */
+  triggerKind?: string | null;
+  /** Days to run on (0-6) */
+  weekdays?: Array<number> | null;
+}
+
+/** One entry in a routine's run ledger. */
+export interface WorkRoutineRun {
+  /** Run id */
+  id?: string | null;
+  /** When the run started */
+  startedAt?: string | null;
+  /** How the run ended, or that it is still going */
+  status?: string | null;
+  [key: string]: unknown;
+}
+
+/** The event-run ledger for one routine — telemetry only. */
+export interface WorkRoutineRunList {
+  /** Runs, newest first */
+  runs?: Array<WorkRoutineRun>;
+}
+
+/** An optional sample event to run an `event` routine against. */
+export interface WorkRoutineRunNowRequest {
+  /** Example event payload; treated as data, never as instructions. `event` routines only. */
+  sampleEvent?: Record<string, unknown> | null;
+}
+
+/**
+ * A run-now receipt: what was posted, and where to watch it finish.
+ *
+ * The run is asynchronous — the instruction is posted immediately and the
+ * agent answers in the background — so this returns the ledger id to poll
+ * rather than the answer. ``status`` is ``running`` here and moves to ``ok``
+ * or ``failed`` on the row this points at.
+ */
+export interface WorkRoutineRunResult {
+  /** Where it was posted */
+  conversationId?: string | null;
+  /** The message the run posted */
+  messageId?: string | null;
+  /** Ledger id of this manual run */
+  runId?: string | null;
+  /** Developer API path to poll for this run's outcome */
+  runsPath?: string | null;
+  /** When the run started */
+  startedAt?: string | null;
+  /** Always `running` on this response */
+  status?: string | null;
+  [key: string]: unknown;
+}
+
+/** One search hit — a message or an event, with its conversation. */
+export interface WorkSearchHit {
+  /** Conversation the hit belongs to */
+  conversation?: string | null;
+  /** Message or event id */
+  id?: string | null;
+  /** Matched text */
+  text?: string | null;
+  [key: string]: unknown;
+}
+
+/** Everything this credential may read that matches the query. */
+export interface WorkSearchResults {
+  /** Ranked hits, capped by the server maximum */
+  hits?: Array<WorkSearchHit>;
+  /** The query that was run, as the server normalized it */
+  query: string;
+}
+
+/** This principal's stored sidebar ordering. */
+export interface WorkSidebarPreferences {
+  /** The ordering as stored */
+  preferences?: Record<string, unknown> | null;
+  [key: string]: unknown;
+}
+
+/**
+ * How this person wants their own sidebar ordered.
+ *
+ * Both halves are required and closed-vocabulary, exactly as
+ * `normalizeSidebarSortMode` requires them (`index.ts:10838`): a partial
+ * write would leave the other half at whatever a previous client wrote and
+ * make the response a lie about the stored state.
+ */
+export interface WorkSidebarPreferencesRequest {
+  channels: "alpha" | "recent";
+  directMessages: "alpha" | "recent";
+}
+
+/** Turn one revenue signal into an accountable Work turn. */
+export interface WorkSignalPromoteRequest {
+  signalEventId: string;
+}
+
+/** The message a signal promotion sent into `#work`. */
+export interface WorkSignalPromoted {
+  /** True when this signal had already been promoted */
+  duplicate?: boolean | null;
+  /** The stored message that carries the turn */
+  message?: Record<string, unknown> | null;
+  [key: string]: unknown;
+}
+
+/** One revenue signal after being snoozed or dismissed. */
+export interface WorkSignalState {
+  /** True when the signal already held the requested state */
+  duplicate?: boolean | null;
+  /** The room event the write appended */
+  event?: Record<string, unknown> | null;
+  [key: string]: unknown;
+}
+
+/** Snooze or dismiss one revenue signal. */
+export interface WorkSignalStateRequest {
+  action: "snooze" | "dismiss";
+  signalEventId: string;
+}
+
+/** Per-rep daily series behind the board's sparklines, deltas and streaks. */
+export interface WorkTeamHqHistory {
+  /** The dates in the window, oldest first */
+  days?: Array<string> | null;
+  /** Per-rep series; null for a day that was not measured (a gap is not a zero) */
+  reps?: Array<Record<string, unknown>> | null;
+  /** `live`, `cached` or `unavailable` */
+  source?: string | null;
+  [key: string]: unknown;
+}
+
+/** One Team HQ board over the organization's own SDR analytics. */
+export interface WorkTeamHqLeaderboard {
+  /** Columns that failed to measure; absent from every row rather than zero */
+  degradedMetrics?: Array<string> | null;
+  /** When this response was built */
+  generatedAt?: string | null;
+  /** Per role-group goals, or null */
+  goals?: Record<string, unknown> | null;
+  /** When the rows were measured; null when unavailable */
+  measuredAt?: string | null;
+  /** `day` or `month` */
+  period?: string | null;
+  /** One row per rep */
+  rows?: Array<Record<string, unknown>> | null;
+  /** `live`, `cached`, `partial` or `unavailable` */
+  source?: string | null;
+  [key: string]: unknown;
+}
+
+/** Team HQ ticker moments, newest first. */
+export interface WorkTickerEvents {
+  /** Moments, newest first */
+  events?: Array<Record<string, unknown>> | null;
+  /** `live` for the receipts drill-down */
+  source?: string | null;
+  [key: string]: unknown;
+}