feat(agents): agent runs in inbox

frontend/src/app/workspaces/[workspaceId]/inbox/page.tsx

@@ -15,6 +15,7 @@ export default function InboxPage() {
 
   const {
     sessions,
+    groups,
     selectedId,
     setSelectedId,
     isLoading: inboxIsLoading,
@@ -55,6 +56,7 @@ export default function InboxPage() {
   return (
     <ActivityLayout
       sessions={sessions}
+      groups={groups}
       selectedId={selectedId}
       onSelect={setSelectedId}
       isLoading={inboxIsLoading}

frontend/src/client/schemas.gen.ts

@@ -14113,6 +14113,16 @@ distinguish multiple files.`,
   description: "A URL to an image.",
 } as const
 
+export const $InboxGroup = {
+  type: "string",
+  enum: ["review_required", "running", "error", "completed"],
+  title: "InboxGroup",
+  description: `Display groups for inbox items.
+
+Groups are derived from approval state and live workflow execution status,
+so membership cannot be expressed as a pure SQL filter.`,
+} as const
+
 export const $InboxItemRead = {
   properties: {
     id: {
@@ -14167,6 +14177,18 @@ export const $InboxItemRead = {
       ],
       description: "Associated workflow",
     },
+    created_by: {
+      anyOf: [
+        {
+          $ref: "#/components/schemas/UserSummary",
+        },
+        {
+          type: "null",
+        },
+      ],
+      description:
+        "User who created the source entity (None for automation-initiated items)",
+    },
     source_id: {
       type: "string",
       format: "uuid",
@@ -14218,7 +14240,7 @@ export const $InboxItemStatus = {
 
 export const $InboxItemType = {
   type: "string",
-  enum: ["approval"],
+  enum: ["approval", "agent_run"],
   title: "InboxItemType",
   description: "Types of inbox items.",
 } as const
@@ -25770,6 +25792,50 @@ export const $UserScopesRead = {
   description: "Read schema for a user's effective scopes.",
 } as const
 
+export const $UserSummary = {
+  properties: {
+    id: {
+      type: "string",
+      format: "uuid",
+      title: "Id",
+      description: "User ID",
+    },
+    email: {
+      type: "string",
+      title: "Email",
+      description: "User email",
+    },
+    first_name: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "First Name",
+      description: "User first name",
+    },
+    last_name: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Last Name",
+      description: "User last name",
+    },
+  },
+  type: "object",
+  required: ["id", "email"],
+  title: "UserSummary",
+  description: "Summary of a user for inbox item context.",
+} as const
+
 export const $UserUpdate = {
   properties: {
     password: {

frontend/src/client/services.gen.ts

@@ -7968,6 +7968,8 @@ export const inboxGetPendingCount = (
  * @param data.reverse
  * @param data.orderBy Column name to order by (created_at, updated_at, status)
  * @param data.sort Sort direction (asc or desc)
+ * @param data.search Case-insensitive search on item title
+ * @param data.group Filter items to a single display group
  * @returns CursorPaginatedResponse_InboxItemRead_ Successful Response
  * @throws ApiError
  */
@@ -7986,6 +7988,8 @@ export const inboxListItems = (
       reverse: data.reverse,
       order_by: data.orderBy,
       sort: data.sort,
+      search: data.search,
+      group: data.group,
     },
     errors: {
       422: "Validation Error",

frontend/src/client/types.gen.ts

@@ -4271,6 +4271,14 @@ export type ImageUrl = {
   readonly identifier: string
 }
 
+/**
+ * Display groups for inbox items.
+ *
+ * Groups are derived from approval state and live workflow execution status,
+ * so membership cannot be expressed as a pure SQL filter.
+ */
+export type InboxGroup = "review_required" | "running" | "error" | "completed"
+
 /**
  * Read model for inbox items.
  */
@@ -4311,6 +4319,10 @@ export type InboxItemRead = {
    * Associated workflow
    */
   workflow?: WorkflowSummary | null
+  /**
+   * User who created the source entity (None for automation-initiated items)
+   */
+  created_by?: UserSummary | null
   /**
    * ID of the source entity
    */
@@ -4335,7 +4347,7 @@ export type InboxItemStatus = "pending" | "completed" | "failed"
 /**
  * Types of inbox items.
  */
-export type InboxItemType = "approval"
+export type InboxItemType = "approval" | "agent_run"
 
 /**
  * Count of pending inbox items that require attention.
@@ -7799,6 +7811,28 @@ export type UserScopesRead = {
   scopes: Array<string>
 }
 
+/**
+ * Summary of a user for inbox item context.
+ */
+export type UserSummary = {
+  /**
+   * User ID
+   */
+  id: string
+  /**
+   * User email
+   */
+  email: string
+  /**
+   * User first name
+   */
+  first_name?: string | null
+  /**
+   * User last name
+   */
+  last_name?: string | null
+}
+
 export type UserUpdate = {
   password?: string | null
   email?: string | null
@@ -11309,12 +11343,20 @@ export type InboxGetPendingCountResponse = InboxPendingCount
 
 export type InboxListItemsData = {
   cursor?: string | null
+  /**
+   * Filter items to a single display group
+   */
+  group?: InboxGroup | null
   limit?: number
   /**
    * Column name to order by (created_at, updated_at, status)
    */
   orderBy?: string | null
   reverse?: boolean
+  /**
+   * Case-insensitive search on item title
+   */
+  search?: string | null
   /**
    * Sort direction (asc or desc)
    */