@kammcs/buildit-mcp 0.2.0 → 0.8.0

package/dist/api/generated/schemas.js

@@ -2,7 +2,7 @@
  * Tolerant schemas for the agent API's responses: unknown fields are kept, unknown enum values pass, and string formats aren't checked, because the API's v1 only grows.
  *
  * GENERATED by scripts/generate.ts from openapi/openapi.json (agent API
- * 1.2.0). Do not edit: change the contract, then run
+ * 1.9.0). Do not edit: change the contract, then run
  * `npm run generate`.
  */
 import { z } from 'zod';
@@ -10,14 +10,43 @@ import { z } from 'zod';
 function openEnum(_values) {
     return z.string();
 }
+export const AckSessionEventsRequestSchema = z.looseObject({ cursor: z.number() });
+export const AckSessionEventsResponseSchema = z.looseObject({
+    acked: z.number(),
+    cursor: z.number(),
+});
+export const AgentRefSchema = z.string();
 export const AllowedTransitionSchema = z.looseObject({
     to: z.string(),
     required_fields: z.array(z.string()),
     admins_only: z.boolean(),
 });
+export const AnswerSessionResponseRequestSchema = z.looseObject({
+    status: openEnum(['accepted', 'rejected']),
+    note: z.string().optional(),
+    revision: z.number(),
+});
+export const ApprovalFieldSchema = z.looseObject({
+    key: z.string(),
+    value: z.string(),
+    cut: z.number().optional(),
+});
+export const ApprovalRuleEntrySchema = z.looseObject({
+    toolName: z.string(),
+    ruleContent: z.string().optional(),
+});
+export const CapabilitySchema = z.string();
+export const CapabilityInSchema = z.string();
+export const CardAnswerSchema = z.union([
+    z.looseObject({ action: z.string() }),
+    z.looseObject({ inputs: z.record(z.string(), z.union([z.string(), z.array(z.string())])) }),
+]);
 export const ChannelNameSchema = z.string();
 export const ChannelRefSchema = z.string();
 export const ChannelVisibilitySchema = openEnum(['public', 'private']);
+export const CloseSessionApprovalRequestSchema = z.looseObject({
+    reason: openEnum(['answered_elsewhere', 'stale', 'interrupted', 'session_ended', 'expired']),
+});
 export const ColorSchema = z.string();
 export const CommentBodySchema = z.string();
 export const CompleteSprintRequestSchema = z.looseObject({
@@ -28,12 +57,14 @@ export const CustomValueInSchema = z
     .union([z.string(), z.number(), z.boolean(), z.array(z.string())])
     .nullable();
 export const DateSchema = z.string();
+export const DeclineSessionHandoffRequestSchema = z.looseObject({ reason: z.string() });
 export const DevelopmentBranchSchema = z.looseObject({
     name: z.string(),
     state: openEnum(['active', 'deleted']),
     repo: z.string(),
     url: z.string(),
 });
+export const DeviceCodeSchema = z.string();
 export const EmptyRequestSchema = z.looseObject({});
 export const EntityKindSchema = openEnum([
     'project',
@@ -55,6 +86,10 @@ export const EntityKindSchema = openEnum([
     'message',
     'plan',
     'route',
+    'response',
+    'agent',
+    'approval',
+    'handoff',
 ]);
 export const EstimateSchema = z.number();
 export const EstimateScaleSchema = openEnum(['none', 'points', 'tshirt']);
@@ -145,12 +180,17 @@ export const ProjectTemplateSchema = openEnum([
     'ops',
     'marketing',
 ]);
+export const QuestionCardSchema = z.record(z.string(), z.unknown());
 export const RateLimitsSchema = z.looseObject({
     requests_per_minute: z.number(),
     user_requests_per_minute: z.number(),
     writes_per_minute: z.number(),
     writes_per_day: z.number(),
     org_requests_per_minute: z.number(),
+    polls_per_minute: z.number().optional(),
+    typing_per_minute: z.number().optional(),
+    approvals_per_minute: z.number().optional(),
+    handoffs_per_minute: z.number().optional(),
 });
 export const ReleaseRefSchema = z.string();
 export const ReleaseStatusSchema = openEnum(['unreleased', 'released', 'archived']);
@@ -168,6 +208,19 @@ export const SearchMatchSchema = z.looseObject({
     title_highlight: z.string(),
     snippet: z.string().nullable(),
 });
+export const SessionCardSettingsSchema = z.looseObject({
+    visibility: openEnum(['shared', 'private', 'anonymous']),
+    results: openEnum(['live', 'on_close', 'hidden']),
+    mode: openEnum(['once', 'changeable']),
+    confirm: z.boolean(),
+});
+export const SessionRuleEntrySchema = z.looseObject({
+    toolName: z.string(),
+    ruleContent: z.string().optional(),
+});
+export const SessionStateSchema = openEnum(['online', 'offline']);
+export const SessionTextSchema = z.string();
+export const SessionTokenSchema = z.string();
 export const SprintRefSchema = z.string();
 export const SprintStateSchema = openEnum(['planned', 'active', 'completed']);
 export const StatusCategorySchema = openEnum(['not_started', 'started', 'done', 'canceled']);
@@ -178,6 +231,7 @@ export const TransitionMoveSchema = z.looseObject({
     required_fields: z.array(z.string()),
     admins_only: z.boolean(),
 });
+export const UserCodeSchema = z.string();
 export const UserRefSchema = z.string();
 export const UuidSchema = z.string();
 export const WorkflowRefSchema = z.string();
@@ -186,6 +240,20 @@ export const AddCommentRequestSchema = z.looseObject({
     idempotency_key: UuidSchema.optional(),
 });
 export const AddLinkRequestSchema = z.looseObject({ kind: LinkKindSchema, target: ItemRefSchema });
+export const AgentBriefSchema = z.looseObject({ id: UuidSchema, name: z.string() });
+export const ApprovalRuleSchema = z.union([
+    z.looseObject({
+        type: z.literal('addRules'),
+        rules: z.array(ApprovalRuleEntrySchema),
+        behavior: z.literal('allow'),
+        destination: z.literal('session'),
+    }),
+    z.looseObject({
+        type: z.literal('setMode'),
+        mode: z.literal('acceptEdits'),
+        destination: z.literal('session'),
+    }),
+]);
 export const ArchiveStatusArgsSchema = z.looseObject({
     project: ProjectRefSchema,
     workflow: WorkflowRefSchema.optional(),
@@ -200,6 +268,28 @@ export const BoardColumnSchema = z.looseObject({
     statuses: z.array(z.string()),
 });
 export const ChannelBriefSchema = z.looseObject({ id: UuidSchema, name: z.string() });
+export const CloseSessionCardResponseSchema = z.looseObject({ closed_at: TimestampSchema });
+export const ConnectPollRequestSchema = z.looseObject({ device_code: DeviceCodeSchema });
+export const ConnectStartRequestSchema = z.looseObject({
+    client: z.string(),
+    machine: z.string(),
+    label: z.string(),
+    projects: z.array(ProjectRefSchema),
+    capabilities: z.array(CapabilityInSchema).optional(),
+});
+export const ConnectStartResponseSchema = z.looseObject({
+    device_code: DeviceCodeSchema,
+    user_code: UserCodeSchema,
+    verification_uri: z.string(),
+    verification_uri_complete: z.string(),
+    interval: z.number(),
+    expires_in: z.number(),
+});
+export const ConnectedSessionSchema = z.looseObject({
+    id: UuidSchema,
+    label: z.string(),
+    projects: z.array(z.looseObject({ id: UuidSchema, key: ProjectKeySchema })),
+});
 export const CreateChannelRequestSchema = z.looseObject({
     name: ChannelNameSchema,
     description: z.string().optional(),
@@ -236,6 +326,11 @@ export const CreateSprintRequestSchema = z.looseObject({
     starts_on: DateSchema.optional(),
     ends_on: DateSchema.optional(),
 });
+export const CustomEmojiSchema = z.looseObject({
+    id: UuidSchema,
+    name: z.string(),
+    animated: z.boolean(),
+});
 export const CustomValuesInSchema = z.record(z.string(), CustomValueInSchema);
 export const DeleteItemArgsSchema = z.looseObject({ item: ItemRefSchema });
 export const DescriptionEditSchema = z.union([
@@ -343,7 +438,15 @@ export const ErrorSchema = z.looseObject({
             message: z.string(),
             hint: z.string().optional(),
             details: z.looseObject({
-                reason: openEnum(['admins_only', 'not_in_channel', 'not_reporter', 'guest', 'other']),
+                reason: openEnum([
+                    'admins_only',
+                    'not_in_channel',
+                    'not_reporter',
+                    'guest',
+                    'other',
+                    'agent_self_assign',
+                    'agent_assignee',
+                ]),
             }),
         }),
         z.looseObject({
@@ -362,7 +465,9 @@ export const ErrorSchema = z.looseObject({
             code: z.literal('method_not_allowed'),
             message: z.string(),
             hint: z.string().optional(),
-            details: z.looseObject({ allowed: z.array(openEnum(['GET', 'POST', 'PATCH', 'DELETE'])) }),
+            details: z.looseObject({
+                allowed: z.array(openEnum(['GET', 'POST', 'PUT', 'PATCH', 'DELETE'])),
+            }),
         }),
         z.looseObject({
             code: z.literal('conflict'),
@@ -490,6 +595,13 @@ export const ErrorSchema = z.looseObject({
                     'token_writes_per_day',
                     'org_requests_per_minute',
                     'user_requests_per_minute',
+                    'session_polls_per_minute',
+                    'connect_starts_per_hour',
+                    'connect_pending_grants',
+                    'connect_pending_per_address',
+                    'session_typing_per_minute',
+                    'session_approvals_per_minute',
+                    'session_handoffs_per_minute',
                 ]),
             }),
         }),
@@ -517,6 +629,182 @@ export const ErrorSchema = z.looseObject({
             hint: z.string().optional(),
             details: z.looseObject({ ref: z.string() }),
         }),
+        z.looseObject({
+            code: z.literal('session_token_required'),
+            message: z.string(),
+            hint: z.string().optional(),
+            details: z.looseObject({}),
+        }),
+        z.looseObject({
+            code: z.literal('agent_sessions_off'),
+            message: z.string(),
+            hint: z.string().optional(),
+            details: z.looseObject({}),
+        }),
+        z.looseObject({
+            code: z.literal('authorization_pending'),
+            message: z.string(),
+            hint: z.string().optional(),
+            details: z.looseObject({ interval: z.number() }),
+        }),
+        z.looseObject({
+            code: z.literal('slow_down'),
+            message: z.string(),
+            hint: z.string().optional(),
+            details: z.looseObject({ interval: z.number() }),
+        }),
+        z.looseObject({
+            code: z.literal('access_denied'),
+            message: z.string(),
+            hint: z.string().optional(),
+            details: z.looseObject({}),
+        }),
+        z.looseObject({
+            code: z.literal('expired_token'),
+            message: z.string(),
+            hint: z.string().optional(),
+            details: z.looseObject({}),
+        }),
+        z.looseObject({
+            code: z.literal('thread_other_session'),
+            message: z.string(),
+            hint: z.string().optional(),
+            details: z.looseObject({ thread_id: z.string() }),
+        }),
+        z.looseObject({
+            code: z.literal('card_invalid'),
+            message: z.string(),
+            hint: z.string().optional(),
+            details: z.looseObject({
+                errors: z.array(z.looseObject({ path: z.string(), message: z.string() })),
+            }),
+        }),
+        z.looseObject({
+            code: z.literal('card_closed'),
+            message: z.string(),
+            hint: z.string().optional(),
+            details: z.looseObject({ message_id: z.string() }),
+        }),
+        z.looseObject({
+            code: z.literal('response_changed'),
+            message: z.string(),
+            hint: z.string().optional(),
+            details: z.looseObject({ response_id: z.string(), revision: z.number() }),
+        }),
+        z.looseObject({
+            code: z.literal('not_own_message'),
+            message: z.string(),
+            hint: z.string().optional(),
+            details: z.looseObject({ message_id: z.string() }),
+        }),
+        z.looseObject({
+            code: z.literal('plan_awaits_owner'),
+            message: z.string(),
+            hint: z.string().optional(),
+            details: z.looseObject({ handle: z.string(), message_id: z.string() }),
+        }),
+        z.looseObject({
+            code: z.literal('plan_card_exists'),
+            message: z.string(),
+            hint: z.string().optional(),
+            details: z.looseObject({ handle: z.string(), message_id: z.string() }),
+        }),
+        z.looseObject({
+            code: z.literal('plan_card_required'),
+            message: z.string(),
+            hint: z.string().optional(),
+            details: z.looseObject({ handle: z.string() }),
+        }),
+        z.looseObject({
+            code: z.literal('thread_not_bound'),
+            message: z.string(),
+            hint: z.string().optional(),
+            details: z.looseObject({ thread_id: z.string() }),
+        }),
+        z.looseObject({
+            code: z.literal('thread_required'),
+            message: z.string(),
+            hint: z.string().optional(),
+            details: z.looseObject({ conversation_id: z.string() }),
+        }),
+        z.looseObject({
+            code: z.literal('outside_reach'),
+            message: z.string(),
+            hint: z.string().optional(),
+            details: z.looseObject({
+                thread_id: z.string().nullable(),
+                reason: openEnum([
+                    'session_ended',
+                    'session_projects',
+                    'projects_off',
+                    'not_in_channel',
+                    'archived',
+                    'item_deleted',
+                ]),
+            }),
+        }),
+        z.looseObject({
+            code: z.literal('plan_outside_thread'),
+            message: z.string(),
+            hint: z.string().optional(),
+            details: z.looseObject({ thread_id: z.string(), key: z.string() }),
+        }),
+        z.looseObject({
+            code: z.literal('approvals_off'),
+            message: z.string(),
+            hint: z.string().optional(),
+            details: z.looseObject({ by: openEnum(['agent', 'platform']) }),
+        }),
+        z.looseObject({
+            code: z.literal('too_many_open'),
+            message: z.string(),
+            hint: z.string().optional(),
+            details: z.looseObject({ open: z.number() }),
+        }),
+        z.looseObject({
+            code: z.literal('handoffs_off'),
+            message: z.string(),
+            hint: z.string().optional(),
+            details: z.looseObject({ by: openEnum(['platform']) }),
+        }),
+        z.looseObject({
+            code: z.literal('not_parent_session'),
+            message: z.string(),
+            hint: z.string().optional(),
+            details: z.looseObject({ item_id: z.string() }),
+        }),
+        z.looseObject({
+            code: z.literal('handoff_not_allowed'),
+            message: z.string(),
+            hint: z.string().optional(),
+            details: z.looseObject({
+                reason: openEnum([
+                    'needs_missing',
+                    'closed',
+                    'agent_assigned',
+                    'person_assigned',
+                    'other_session',
+                ]),
+            }),
+        }),
+        z.looseObject({
+            code: z.literal('handoff_exists'),
+            message: z.string(),
+            hint: z.string().optional(),
+            details: z.looseObject({ handoff_id: z.string() }),
+        }),
+        z.looseObject({
+            code: z.literal('no_target'),
+            message: z.string(),
+            hint: z.string().optional(),
+            details: z.looseObject({ needs: z.array(z.string()) }),
+        }),
+        z.looseObject({
+            code: z.literal('handoff_closed'),
+            message: z.string(),
+            hint: z.string().optional(),
+            details: z.looseObject({ handoff_id: z.string() }),
+        }),
     ]),
 });
 export const FeedbackSchema = z.looseObject({
@@ -580,6 +868,7 @@ export const ItemBriefSchema = z.looseObject({
     key: ItemKeySchema,
     title: z.string(),
 });
+export const ItemIdKeySchema = z.looseObject({ id: UuidSchema, key: z.string() });
 export const LabelSchema = z.looseObject({
     id: UuidSchema,
     name: z.string(),
@@ -647,6 +936,19 @@ export const PlanEffectSchema = z.looseObject({
     after: z.unknown(),
 });
 export const PlanningItemsRequestSchema = z.looseObject({ items: z.array(ItemRefSchema) });
+export const PostPlanCardRequestSchema = z.looseObject({
+    handle: PlanHandleSchema,
+    id: UuidSchema,
+    thread_id: UuidSchema.optional(),
+});
+export const PostSessionMessageRequestSchema = z.looseObject({
+    id: UuidSchema,
+    text: SessionTextSchema,
+    thread_id: UuidSchema.optional(),
+    reply_to_id: UuidSchema.optional(),
+    conversation_id: UuidSchema.optional(),
+    card: QuestionCardSchema.optional(),
+});
 export const ProjectBriefSchema = z.looseObject({
     id: UuidSchema,
     key: ProjectKeySchema,
@@ -668,6 +970,10 @@ export const ProjectTypeSchema = z.looseObject({
     color: ColorSchema.nullable(),
     workflow: z.looseObject({ id: UuidSchema, name: z.string() }),
 });
+export const ProposeSessionHandoffRequestSchema = z.looseObject({
+    id: UuidSchema,
+    item: ItemRefSchema,
+});
 export const RankPositionSchema = z.looseObject({
     before: ItemRefSchema.optional(),
     after: ItemRefSchema.optional(),
@@ -706,6 +1012,146 @@ export const ReleaseVersionRequestSchema = z.looseObject({
     move_open_to: ReleaseRefSchema.optional(),
 });
 export const RemoveLinkResponseSchema = z.looseObject({ id: UuidSchema, removed: z.boolean() });
+export const SessionApprovalSchema = z.looseObject({
+    id: UuidSchema,
+    status: openEnum([
+        'open',
+        'approved',
+        'approved_session',
+        'denied',
+        'expired',
+        'answered_elsewhere',
+        'stale',
+        'closed',
+    ]),
+    reason: openEnum([
+        'time',
+        'client',
+        'session_ended',
+        'unassigned',
+        'interrupted',
+        'deleted',
+        'removed',
+        'switched_off',
+    ]).optional(),
+    tool_name: z.string(),
+    thread_id: UuidSchema.nullable(),
+    created_at: TimestampSchema,
+    closes_at: TimestampSchema,
+    decided_at: TimestampSchema.optional(),
+});
+export const SessionBriefSchema = z.looseObject({ id: UuidSchema, label: z.string() });
+export const SessionCapabilitiesResponseSchema = z.looseObject({
+    capabilities: z.array(CapabilitySchema),
+    capabilities_detected: z.array(CapabilitySchema),
+});
+export const SessionCardMessageSchema = z.looseObject({
+    id: UuidSchema,
+    thread_id: UuidSchema.nullable(),
+});
+export const SessionCardResponseSchema = z.looseObject({
+    id: UuidSchema,
+    message_id: UuidSchema,
+    revision: z.number(),
+    status: openEnum(['recorded', 'accepted', 'rejected']),
+    answer: CardAnswerSchema,
+    note: z.string().nullable(),
+    created_at: TimestampSchema,
+    updated_at: TimestampSchema,
+});
+export const SessionChildItemSchema = z.looseObject({
+    id: UuidSchema,
+    key: z.string(),
+    title: z.string(),
+    status: z
+        .looseObject({ key: z.string().nullable(), name: z.string().nullable(), category: z.string() })
+        .nullable(),
+});
+export const SessionChildResultSchema = z.looseObject({
+    untrusted: z.literal(true),
+    message: z.looseObject({
+        id: UuidSchema,
+        author: z.looseObject({
+            kind: openEnum(['user', 'app', 'agent']),
+            id: UuidSchema.nullable(),
+            name: z.string(),
+        }),
+        from_owner: z.boolean(),
+        via_agent: z.string().nullable(),
+        text: z.string(),
+        created_at: TimestampSchema,
+    }),
+});
+export const SessionContextMessageSchema = z.looseObject({
+    id: UuidSchema,
+    author: z.looseObject({
+        kind: openEnum(['user', 'app', 'agent']),
+        id: UuidSchema.nullable(),
+        name: z.string(),
+    }),
+    from_owner: z.boolean(),
+    via_agent: z.string().nullable().optional(),
+    text: z.string(),
+    created_at: TimestampSchema,
+});
+export const SessionEventMessageSchema = z.looseObject({
+    id: UuidSchema,
+    thread_id: UuidSchema.nullable(),
+    reply_to_id: UuidSchema.nullable(),
+    text: z.string(),
+    mentions: z.array(UuidSchema),
+    has_card: z.boolean(),
+    created_at: TimestampSchema,
+    edited_at: TimestampSchema.nullable(),
+    via_agent: z.string().nullable().optional(),
+    forwarded: z.boolean(),
+    forwarded_from: z
+        .looseObject({
+        message_id: UuidSchema,
+        user: z.looseObject({ id: UuidSchema, name: z.string() }).nullable(),
+        app: z.looseObject({ id: UuidSchema, name: z.string() }).nullable(),
+    })
+        .nullable(),
+});
+export const SessionEventProjectSchema = z.looseObject({ id: UuidSchema, key: z.string() });
+export const SessionEventUserSchema = z.looseObject({
+    id: UuidSchema,
+    name: z.string(),
+    is_guest: z.boolean(),
+    locale: z.string().nullable(),
+});
+export const SessionHeartbeatRequestSchema = z.looseObject({ state: SessionStateSchema });
+export const SessionHeartbeatResponseSchema = z.looseObject({
+    state: SessionStateSchema,
+    last_seen_at: TimestampSchema,
+});
+export const SessionItemStatusSchema = z.looseObject({
+    id: UuidSchema,
+    key: z.string().nullable(),
+    name: z.string().nullable(),
+    category: z.string(),
+});
+export const SessionOwnerSchema = z.looseObject({ id: UuidSchema, name: z.string() });
+export const SessionRuleSchema = z.union([
+    z.looseObject({
+        type: z.literal('addRules'),
+        rules: z.array(SessionRuleEntrySchema),
+        behavior: z.literal('allow'),
+        destination: z.literal('session'),
+    }),
+    z.looseObject({
+        type: z.literal('setMode'),
+        mode: z.literal('acceptEdits'),
+        destination: z.literal('session'),
+    }),
+]);
+export const SessionTypingRequestSchema = z.looseObject({
+    thread_id: UuidSchema.nullable().optional(),
+    typing: z.boolean().optional(),
+});
+export const SetSessionCapabilitiesRequestSchema = z.looseObject({
+    detected: z.array(CapabilityInSchema),
+});
 export const SprintSchema = z.looseObject({
     id: UuidSchema,
     number: z.number(),
@@ -769,6 +1215,10 @@ export const UpdateReleaseRequestSchema = z.looseObject({
     target_date: DateSchema.nullable().optional(),
     released_on: DateSchema.optional(),
 });
+export const UpdateSessionMessageRequestSchema = z.looseObject({
+    text: SessionTextSchema.optional(),
+    card: QuestionCardSchema.nullable().optional(),
+});
 export const UserSchema = z.looseObject({
     id: UuidSchema,
     display_name: z.string(),
@@ -850,6 +1300,9 @@ export const WorkflowStatusSchema = z.looseObject({
     board_column: z.string().nullable(),
     allowed: z.array(AllowedTransitionSchema),
 });
+export const AnswerSessionResponseResponseSchema = z.looseObject({
+    response: SessionCardResponseSchema,
+});
 export const BulkPatchSchema = z.looseObject({
     status: NameRefSchema.optional(),
     assignee: UserRefSchema.nullable().optional(),
@@ -876,6 +1329,9 @@ export const ChannelSchema = z.looseObject({
     project: ProjectBriefSchema.nullable(),
     last_message_at: TimestampSchema.nullable(),
 });
+export const CloseSessionApprovalResponseSchema = z.looseObject({
+    approval: SessionApprovalSchema,
+});
 export const CommentSchema = z.looseObject({
     id: UuidSchema,
     author: UserSchema.nullable(),
@@ -894,6 +1350,14 @@ export const CompleteSprintResponseSchema = z.looseObject({
     carried_count: z.number(),
     carried_to: SprintBriefSchema.nullable(),
 });
+export const ConnectPollResponseSchema = z.looseObject({
+    token: SessionTokenSchema,
+    expires_at: TimestampSchema,
+    session: ConnectedSessionSchema,
+    agent: AgentBriefSchema,
+    owner: SessionOwnerSchema,
+    org: z.looseObject({ id: UuidSchema, name: z.string() }),
+});
 export const CreateItemRequestSchema = z.looseObject({
     project: ProjectRefSchema.optional(),
     type: NameRefSchema.optional(),
@@ -902,8 +1366,10 @@ export const CreateItemRequestSchema = z.looseObject({
     parent: ItemRefSchema.optional(),
     status: NameRefSchema.optional(),
     assignee: UserRefSchema.optional(),
+    assignee_agent: AgentRefSchema.optional(),
     priority: PrioritySchema.optional(),
     labels: z.array(LabelRefSchema).optional(),
+    needs: z.array(CapabilityInSchema).optional(),
     estimate: EstimateSchema.optional(),
     start_date: DateSchema.optional(),
     due_date: DateSchema.optional(),
@@ -937,6 +1403,18 @@ export const FieldDefSchema = z.looseObject({
     required_on_create: z.boolean(),
     position: z.number(),
 });
+export const GetSessionApprovalResponseSchema = z.looseObject({ approval: SessionApprovalSchema });
+export const HandoffOptionSchema = z.looseObject({
+    kind: openEnum(['session', 'agent']),
+    agent: AgentBriefSchema,
+    session: SessionBriefSchema.nullable(),
+    online: z.boolean(),
+});
+export const HandoffTargetSchema = z.looseObject({
+    kind: openEnum(['session', 'agent']),
+    agent: AgentBriefSchema,
+    session: SessionBriefSchema.nullable(),
+});
 export const HistoryEventSchema = z.looseObject({
     id: z.number(),
     at: TimestampSchema,
@@ -959,10 +1437,12 @@ export const ItemSummarySchema = z.looseObject({
     title: z.string(),
     priority: PrioritySchema,
     assignee: UserSchema.nullable(),
+    assignee_agent: AgentBriefSchema.nullable(),
     reporter: UserSchema.nullable(),
     parent: ItemBriefSchema.nullable(),
     initiative: InitiativeBriefSchema.nullable(),
     labels: z.array(LabelSchema),
+    needs: z.array(CapabilitySchema).optional(),
     estimate: z.number().nullable(),
     start_date: DateSchema.nullable(),
     due_date: DateSchema.nullable(),
@@ -983,6 +1463,7 @@ export const LinkedItemSchema = z.looseObject({
     title: z.string(),
     status: StatusBriefSchema,
 });
+export const ListEmojiResponseSchema = z.looseObject({ items: z.array(CustomEmojiSchema) });
 export const ListMembersResponseSchema = z.looseObject({
     items: z.array(OrgMemberSchema),
     next_cursor: z.string().nullable(),
@@ -1005,6 +1486,7 @@ export const MeResponseSchema = z.looseObject({
     token: z.looseObject({
         id: UuidSchema,
         name: z.string(),
+        kind: openEnum(['pat', 'session']).optional(),
         scopes: z.array(ScopeSchema),
         expires_at: TimestampSchema,
         created_at: TimestampSchema,
@@ -1047,6 +1529,9 @@ export const MessageSchema = z.looseObject({
     edited_at: TimestampSchema.nullable(),
     deleted: z.boolean(),
     via_agent: z.string().nullable(),
+    pinned: z.boolean(),
+    pinned_at: TimestampSchema.nullable(),
+    pinned_by: MessageAuthorSchema.nullable(),
 });
 export const PageSchema = z.looseObject({
     id: UuidSchema,
@@ -1088,6 +1573,18 @@ export const PlanPreviewSchema = z.looseObject({
     item_count: z.number(),
     warnings: z.array(z.string()),
 });
+export const PostSessionApprovalRequestSchema = z.looseObject({
+    id: UuidSchema,
+    thread_id: UuidSchema.nullable().optional(),
+    tool_name: z.string(),
+    tool_use_id: z.string().optional(),
+    agent: z.looseObject({ ref: z.string(), type: z.string().optional() }).optional(),
+    description: z.string().optional(),
+    fields: z.array(ApprovalFieldSchema),
+    more_fields: z.number().optional(),
+    suggestion: SessionRuleSchema.optional(),
+    wait_s: z.number(),
+});
 export const ProjectSummarySchema = z.looseObject({
     id: UuidSchema,
     key: ProjectKeySchema,
@@ -1106,6 +1603,143 @@ export const ReleaseItemsResponseSchema = z.looseObject({
     changed: z.array(ItemBriefSchema),
 });
 export const ReleaseResponseSchema = z.looseObject({ release: ReleaseSchema });
+export const SessionApprovalOutcomeSchema = z.looseObject({
+    id: UuidSchema,
+    outcome: openEnum([
+        'approved',
+        'approved_session',
+        'denied',
+        'expired',
+        'answered_elsewhere',
+        'stale',
+        'closed',
+    ]),
+    reason: openEnum([
+        'time',
+        'client',
+        'session_ended',
+        'unassigned',
+        'interrupted',
+        'deleted',
+        'removed',
+        'switched_off',
+    ]).optional(),
+    decided_by: UuidSchema.optional(),
+    decided_at: TimestampSchema.optional(),
+    rule: ApprovalRuleSchema.optional(),
+});
+export const SessionAssignedHandoffSchema = z.looseObject({
+    id: UuidSchema,
+    parent: ItemIdKeySchema,
+    from: z.looseObject({ agent: AgentBriefSchema, session: SessionBriefSchema.nullable() }),
+    needs: z.array(CapabilitySchema),
+    queued: z.boolean(),
+});
+export const SessionCardResponseDataSchema = z.looseObject({
+    channel: z.looseObject({ id: UuidSchema, name: z.string().nullable() }),
+    message: SessionCardMessageSchema,
+    card: SessionCardSettingsSchema,
+    response: z.looseObject({
+        id: UuidSchema,
+        revision: z.number(),
+        answer: CardAnswerSchema,
+        created_at: TimestampSchema,
+        updated_at: TimestampSchema,
+    }),
+    user: SessionEventUserSchema,
+    pseudonym: z.string().nullable(),
+    private: z.unknown(),
+});
+export const SessionEventItemSchema = z.looseObject({
+    id: UuidSchema,
+    key: z.string(),
+    title: z.string(),
+    type: z.looseObject({
+        id: UuidSchema.nullable(),
+        key: z.string().nullable(),
+        name: z.string().nullable(),
+    }),
+    status: SessionItemStatusSchema.nullable(),
+    created_at: TimestampSchema,
+    description_excerpt: z.string().optional(),
+    description_truncated: z.boolean().optional(),
+});
+export const SessionItemAssignmentSchema = z.looseObject({
+    agent: AgentBriefSchema,
+    owner: SessionOwnerSchema,
+    by: SessionEventUserSchema.nullable(),
+    at: TimestampSchema,
+});
+export const SessionItemContextSchema = z.looseObject({
+    untrusted: z.literal(true),
+    messages: z.array(SessionContextMessageSchema),
+});
+export const SessionMessageSchema = z.looseObject({
+    id: UuidSchema,
+    conversation_id: UuidSchema,
+    thread_id: UuidSchema.nullable(),
+    reply_to_id: UuidSchema.nullable(),
+    text: z.string(),
+    created_at: TimestampSchema,
+    session: SessionBriefSchema,
+});
+export const SessionResponseSchema = z.looseObject({
+    session: z.looseObject({
+        id: UuidSchema,
+        label: z.string(),
+        machine: z.string(),
+        client: z.string(),
+        scopes: z.array(ScopeSchema),
+        project_ids: z.array(UuidSchema),
+        channel_ids: z.array(UuidSchema),
+        approved_at: TimestampSchema,
+        last_seen_at: TimestampSchema.nullable(),
+        expires_at: TimestampSchema,
+        capabilities: z.array(CapabilitySchema).optional(),
+        capabilities_detected: z.array(CapabilitySchema).optional(),
+    }),
+    agent: AgentBriefSchema,
+    owner: SessionOwnerSchema,
+    org: z.looseObject({ id: UuidSchema, name: z.string() }),
+    dm: z.looseObject({ conversation_id: UuidSchema }),
+    poll_interval_s: z.number(),
+});
+export const SessionThreadSchema = z.looseObject({
+    thread_id: UuidSchema,
+    conversation_id: UuidSchema,
+    kind: openEnum(['dm', 'item']),
+    item: z
+        .looseObject({
+        id: UuidSchema,
+        key: z.string(),
+        title: z.string(),
+        status: SessionItemStatusSchema.nullable(),
+    })
+        .nullable(),
+    bound_reason: openEnum(['posted', 'routed', 'handed', 'assigned', 'mentioned', 'handoff']),
+    bound_at: TimestampSchema,
+    last_owner_message_at: TimestampSchema.nullable(),
+    open_cards: z.number(),
+    handoff: z
+        .looseObject({
+        id: UuidSchema,
+        role: openEnum(['target', 'asked']),
+        status: openEnum([
+            'proposed',
+            'cancelled',
+            'expired',
+            'stale',
+            'withdrawn',
+            'closed',
+            'handed',
+            'declined',
+            'ended',
+            'finished',
+        ]),
+    })
+        .nullable()
+        .optional(),
+});
 export const SprintItemsResponseSchema = z.looseObject({
     sprint: SprintSchema,
     changed: z.array(ItemBriefSchema),
@@ -1132,10 +1766,12 @@ export const UpdateItemRequestSchema = z.looseObject({
     status: NameRefSchema.optional(),
     parent: ItemRefSchema.nullable().optional(),
     assignee: UserRefSchema.nullable().optional(),
+    assignee_agent: AgentRefSchema.nullable().optional(),
     priority: PrioritySchema.optional(),
     labels: z.array(LabelRefSchema).optional(),
     add_labels: z.array(LabelRefSchema).optional(),
     remove_labels: z.array(LabelRefSchema).optional(),
+    needs: z.array(CapabilityInSchema).optional(),
     estimate: EstimateSchema.nullable().optional(),
     start_date: DateSchema.nullable().optional(),
     due_date: DateSchema.nullable().optional(),
@@ -1268,8 +1904,16 @@ export const ListProjectsResponseSchema = z.looseObject({
     items: z.array(ProjectSummarySchema),
     next_cursor: z.string().nullable(),
 });
+export const ListSessionThreadsResponseSchema = z.looseObject({
+    threads: z.array(SessionThreadSchema),
+});
 export const ListWorkTypesResponseSchema = z.looseObject({ items: z.array(WorkTypeSchema) });
 export const PageResponseSchema = z.looseObject({ page: PageSchema });
+export const PinnedMessageSchema = z.looseObject({
+    pinned_at: TimestampSchema,
+    pinned_by: MessageAuthorSchema.nullable(),
+    message: MessageSchema,
+});
 export const PlanResultSchema = z.union([
     z.looseObject({ action: z.literal('delete_item'), deleted: z.array(ItemBriefSchema) }),
     z.looseObject({
@@ -1284,11 +1928,174 @@ export const PlanResultSchema = z.union([
     z.looseObject({ action: z.literal('field_change'), field_id: UuidSchema }),
     z.looseObject({ action: z.literal('label_change'), label_id: UuidSchema }),
 ]);
+export const PostPlanCardResponseSchema = z.looseObject({
+    created: z.boolean(),
+    message: SessionMessageSchema,
+    plan: z.looseObject({ handle: PlanHandleSchema, expires_at: TimestampSchema }),
+});
+export const PostSessionApprovalResponseSchema = z.looseObject({
+    created: z.boolean(),
+    message: SessionMessageSchema,
+    approval: SessionApprovalSchema,
+});
+export const PostSessionMessageResponseSchema = z.looseObject({
+    created: z.boolean(),
+    message: SessionMessageSchema,
+});
 export const RankItemResponseSchema = z.looseObject({ item: ItemSummarySchema });
 export const SearchPagesResponseSchema = z.looseObject({
     items: z.array(PageSearchResultSchema),
     next_cursor: z.string().nullable(),
 });
+export const SessionCardResponseEventSchema = z.looseObject({
+    v: z.literal(1),
+    id: UuidSchema,
+    type: z.literal('card.response'),
+    created_at: TimestampSchema,
+    org: z.looseObject({ id: UuidSchema }),
+    app: z.looseObject({ id: UuidSchema, installation_id: UuidSchema }),
+    attempt: z.number(),
+    session: SessionBriefSchema,
+    data: SessionCardResponseDataSchema,
+});
+export const SessionChildDoneDataSchema = z.looseObject({
+    channel: z.looseObject({ id: UuidSchema, name: z.string().nullable() }),
+    project: SessionEventProjectSchema,
+    item: SessionEventItemSchema,
+    child: SessionChildItemSchema,
+    handoff: z.looseObject({
+        id: UuidSchema,
+        needs: z.array(CapabilitySchema),
+        target: z.looseObject({ agent: AgentBriefSchema, session: SessionBriefSchema.nullable() }),
+    }),
+    outcome: openEnum(['in_review', 'done', 'declined', 'ended']),
+    reason: openEnum([
+        'canceled',
+        'unassigned',
+        'reassigned',
+        'moved',
+        'deleted',
+        'owner_left',
+        'agent_deleted',
+        'expired',
+    ]).nullable(),
+    result: SessionChildResultSchema.nullable(),
+});
+export const SessionEventDataSchema = z.looseObject({
+    channel: z.looseObject({ id: UuidSchema, name: z.string().nullable() }).optional(),
+    message: SessionEventMessageSchema.optional(),
+    user: SessionEventUserSchema.nullable().optional(),
+    project: SessionEventProjectSchema.optional(),
+    item: SessionEventItemSchema.optional(),
+    assignment: SessionItemAssignmentSchema.nullable().optional(),
+    context: SessionItemContextSchema.optional(),
+});
+export const SessionHandoffSchema = z.looseObject({
+    id: UuidSchema,
+    item: ItemIdKeySchema,
+    parent: ItemIdKeySchema,
+    needs: z.array(CapabilitySchema),
+    status: openEnum([
+        'proposed',
+        'cancelled',
+        'expired',
+        'stale',
+        'withdrawn',
+        'closed',
+        'handed',
+        'declined',
+        'ended',
+        'finished',
+    ]),
+    card_message_id: UuidSchema.nullable(),
+    closes_at: TimestampSchema,
+    targets: z.array(HandoffOptionSchema),
+    target: HandoffTargetSchema.optional(),
+    queued: z.boolean().optional(),
+    outcome: openEnum(['applied', 'cancelled', 'expired', 'stale', 'withdrawn', 'closed']).optional(),
+    reason: openEnum([
+        'deleted',
+        'moved',
+        'closed',
+        'agent_assigned',
+        'person_assigned',
+        'other_session',
+        'parent_changed',
+        'no_target',
+        'session_ended',
+        'unassigned',
+        'removed',
+        'interrupted',
+        'switched_off',
+        'canceled',
+        'reassigned',
+        'owner_left',
+        'agent_deleted',
+        'expired',
+    ]).optional(),
+});
+export const SessionHandoffOutcomeSchema = z.looseObject({
+    id: UuidSchema,
+    item: ItemIdKeySchema,
+    outcome: openEnum(['applied', 'cancelled', 'expired', 'stale', 'withdrawn', 'closed']),
+    reason: openEnum([
+        'deleted',
+        'moved',
+        'closed',
+        'agent_assigned',
+        'person_assigned',
+        'other_session',
+        'parent_changed',
+        'no_target',
+        'session_ended',
+        'unassigned',
+        'removed',
+        'interrupted',
+        'switched_off',
+        'canceled',
+        'reassigned',
+        'owner_left',
+        'agent_deleted',
+        'expired',
+    ]).optional(),
+    target: HandoffTargetSchema.optional(),
+    queued: z.boolean().optional(),
+});
+export const SessionItemAssignedDataSchema = z.looseObject({
+    channel: z.looseObject({ id: UuidSchema, name: z.string().nullable() }),
+    project: SessionEventProjectSchema,
+    item: SessionEventItemSchema,
+    assignment: SessionItemAssignmentSchema,
+    context: SessionItemContextSchema,
+    user: SessionEventUserSchema.nullable(),
+    handoff: SessionAssignedHandoffSchema.optional(),
+});
+export const SessionItemUnassignedDataSchema = z.looseObject({
+    channel: z.looseObject({ id: UuidSchema, name: z.string().nullable() }),
+    project: SessionEventProjectSchema,
+    item: SessionEventItemSchema,
+    assignment: SessionItemAssignmentSchema.nullable(),
+    reason: openEnum([
+        'unassigned',
+        'reassigned',
+        'moved',
+        'deleted',
+        'owner_left',
+        'agent_deleted',
+        'declined',
+        'handoff_expired',
+    ]),
+    user: SessionEventUserSchema.nullable(),
+});
+export const SessionMentionDataSchema = z.looseObject({
+    channel: z.looseObject({ id: UuidSchema, name: z.string().nullable() }),
+    project: SessionEventProjectSchema,
+    item: SessionEventItemSchema,
+    assignment: SessionItemAssignmentSchema.nullable(),
+    context: SessionItemContextSchema,
+    message: SessionEventMessageSchema,
+    user: SessionEventUserSchema,
+});
 export const ThreadResponseSchema = z.looseObject({
     root: MessageSchema,
     replies: z.array(MessageSchema),
@@ -1304,6 +2111,7 @@ export const TransitionItemResponseSchema = z.looseObject({
     item: ItemSummarySchema,
     comment: CommentSchema.nullable(),
 });
+export const UpdateSessionMessageResponseSchema = z.looseObject({ message: SessionMessageSchema });
 export const WorkflowChangeArgsSchema = z.looseObject({
     project: ProjectRefSchema,
     workflow_def: WorkflowDefinitionSchema,
@@ -1335,10 +2143,12 @@ export const ItemDetailSchema = z.looseObject({
     title: z.string(),
     priority: PrioritySchema,
     assignee: UserSchema.nullable(),
+    assignee_agent: AgentBriefSchema.nullable(),
     reporter: UserSchema.nullable(),
     parent: ItemBriefSchema.nullable(),
     initiative: InitiativeBriefSchema.nullable(),
     labels: z.array(LabelSchema),
+    needs: z.array(CapabilitySchema).optional(),
     estimate: z.number().nullable(),
     start_date: DateSchema.nullable(),
     due_date: DateSchema.nullable(),
@@ -1369,10 +2179,12 @@ export const ItemSearchResultSchema = z.looseObject({
     title: z.string(),
     priority: PrioritySchema,
     assignee: UserSchema.nullable(),
+    assignee_agent: AgentBriefSchema.nullable(),
     reporter: UserSchema.nullable(),
     parent: ItemBriefSchema.nullable(),
     initiative: InitiativeBriefSchema.nullable(),
     labels: z.array(LabelSchema),
+    needs: z.array(CapabilitySchema).optional(),
     estimate: z.number().nullable(),
     start_date: DateSchema.nullable(),
     due_date: DateSchema.nullable(),
@@ -1392,6 +2204,78 @@ export const ItemSearchResultSchema = z.looseObject({
     description: z.string().optional(),
     custom: z.array(CustomFieldValueSchema).optional(),
 });
+export const ListPinsResponseSchema = z.looseObject({
+    items: z.array(PinnedMessageSchema),
+    next_cursor: z.string().nullable(),
+});
+export const ProposeSessionHandoffResponseSchema = z.looseObject({
+    handoff: SessionHandoffSchema,
+    created: z.boolean(),
+});
+export const SessionChildDoneEventSchema = z.looseObject({
+    v: z.literal(1),
+    id: UuidSchema,
+    type: z.literal('work_item.child_done'),
+    created_at: TimestampSchema,
+    org: z.looseObject({ id: UuidSchema }),
+    app: z.looseObject({ id: UuidSchema, installation_id: UuidSchema }),
+    attempt: z.number(),
+    session: SessionBriefSchema,
+    data: SessionChildDoneDataSchema,
+});
+export const SessionHandoffResponseSchema = z.looseObject({ handoff: SessionHandoffSchema });
+export const SessionItemAssignedEventSchema = z.looseObject({
+    v: z.literal(1),
+    id: UuidSchema,
+    type: z.literal('work_item.assigned'),
+    created_at: TimestampSchema,
+    org: z.looseObject({ id: UuidSchema }),
+    app: z.looseObject({ id: UuidSchema, installation_id: UuidSchema }),
+    attempt: z.number(),
+    session: SessionBriefSchema,
+    data: SessionItemAssignedDataSchema,
+});
+export const SessionItemUnassignedEventSchema = z.looseObject({
+    v: z.literal(1),
+    id: UuidSchema,
+    type: z.literal('work_item.unassigned'),
+    created_at: TimestampSchema,
+    org: z.looseObject({ id: UuidSchema }),
+    app: z.looseObject({ id: UuidSchema, installation_id: UuidSchema }),
+    attempt: z.number(),
+    session: SessionBriefSchema,
+    data: SessionItemUnassignedDataSchema,
+});
+export const SessionMentionEventSchema = z.looseObject({
+    v: z.literal(1),
+    id: UuidSchema,
+    type: z.literal('app.mentioned'),
+    created_at: TimestampSchema,
+    org: z.looseObject({ id: UuidSchema }),
+    app: z.looseObject({ id: UuidSchema, installation_id: UuidSchema }),
+    attempt: z.number(),
+    session: SessionBriefSchema,
+    data: SessionMentionDataSchema,
+});
+export const SessionMessageEventSchema = z.looseObject({
+    v: z.literal(1),
+    id: UuidSchema,
+    type: z.literal('message.posted'),
+    created_at: TimestampSchema,
+    org: z.looseObject({ id: UuidSchema }),
+    app: z.looseObject({ id: UuidSchema, installation_id: UuidSchema }),
+    attempt: z.number(),
+    session: SessionBriefSchema,
+    data: SessionEventDataSchema,
+});
+export const SessionPlanOutcomeSchema = z.looseObject({
+    handle: PlanHandleSchema,
+    action: PlanActionSchema,
+    outcome: openEnum(['applied', 'cancelled', 'stale', 'failed', 'expired', 'unknown']),
+    result: PlanResultSchema.optional(),
+    error: z.looseObject({ code: z.string(), message: z.string().optional() }).optional(),
+    changed: z.array(z.looseObject({ kind: z.string(), ref: z.string() })).optional(),
+});
 export const CreateItemResponseSchema = z.looseObject({
     item: ItemDetailSchema,
     created: z.boolean(),
@@ -1411,3 +2295,52 @@ export const SearchItemsResponseSchema = z.looseObject({
     items: z.array(ItemSearchResultSchema),
     next_cursor: z.string().nullable(),
 });
+export const SessionCardClosedDataSchema = z.looseObject({
+    channel: z.looseObject({ id: UuidSchema, name: z.string().nullable() }),
+    message: SessionCardMessageSchema,
+    card: SessionCardSettingsSchema,
+    closed_by: openEnum([
+        'time',
+        'app',
+        'owner',
+        'session_ended',
+        'deleted',
+        'removed',
+        'unassigned',
+        'switched_off',
+    ]),
+    closed_at: TimestampSchema,
+    respondents: z.number(),
+    counts: z.record(z.string(), z.unknown()).nullable(),
+    private: z.unknown(),
+    plan: SessionPlanOutcomeSchema.optional(),
+    approval: SessionApprovalOutcomeSchema.optional(),
+    handoff: SessionHandoffOutcomeSchema.optional(),
+});
+export const SessionCardClosedEventSchema = z.looseObject({
+    v: z.literal(1),
+    id: UuidSchema,
+    type: z.literal('card.closed'),
+    created_at: TimestampSchema,
+    org: z.looseObject({ id: UuidSchema }),
+    app: z.looseObject({ id: UuidSchema, installation_id: UuidSchema }),
+    attempt: z.number(),
+    session: SessionBriefSchema,
+    data: SessionCardClosedDataSchema,
+});
+export const SessionEventSchema = z.union([
+    SessionMessageEventSchema,
+    SessionCardResponseEventSchema,
+    SessionCardClosedEventSchema,
+    SessionMentionEventSchema,
+    SessionItemAssignedEventSchema,
+    SessionItemUnassignedEventSchema,
+    SessionChildDoneEventSchema,
+]);
+export const SessionEventsResponseSchema = z.looseObject({
+    events: z.array(SessionEventSchema),
+    cursor: z.number(),
+    more: z.boolean(),
+});
+/** The answer of an operation that returns no body (204). */
+export const NoContentSchema = z.undefined();