@kammcs/buildit-mcp 0.7.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.8.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';
@@ -35,6 +35,8 @@ 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())])) }),
@@ -55,6 +57,7 @@ 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']),
@@ -86,6 +89,7 @@ export const EntityKindSchema = openEnum([
     'response',
     'agent',
     'approval',
+    'handoff',
 ]);
 export const EstimateSchema = z.number();
 export const EstimateScaleSchema = openEnum(['none', 'points', 'tshirt']);
@@ -186,6 +190,7 @@ export const RateLimitsSchema = z.looseObject({
     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']);
@@ -270,6 +275,7 @@ export const ConnectStartRequestSchema = z.looseObject({
     machine: z.string(),
     label: z.string(),
     projects: z.array(ProjectRefSchema),
+    capabilities: z.array(CapabilityInSchema).optional(),
 });
 export const ConnectStartResponseSchema = z.looseObject({
     device_code: DeviceCodeSchema,
@@ -459,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'),
@@ -593,6 +601,7 @@ export const ErrorSchema = z.looseObject({
                     'connect_pending_per_address',
                     'session_typing_per_minute',
                     'session_approvals_per_minute',
+                    'session_handoffs_per_minute',
                 ]),
             }),
         }),
@@ -730,6 +739,7 @@ export const ErrorSchema = z.looseObject({
                     'projects_off',
                     'not_in_channel',
                     'archived',
+                    'item_deleted',
                 ]),
             }),
         }),
@@ -751,6 +761,50 @@ export const ErrorSchema = z.looseObject({
             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({
@@ -814,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(),
@@ -915,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(),
@@ -982,6 +1041,10 @@ export const SessionApprovalSchema = z.looseObject({
     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(),
@@ -996,6 +1059,29 @@ export const SessionCardResponseSchema = z.looseObject({
     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({
@@ -1063,6 +1149,9 @@ 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(),
@@ -1280,6 +1369,7 @@ export const CreateItemRequestSchema = z.looseObject({
     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(),
@@ -1314,6 +1404,17 @@ export const FieldDefSchema = z.looseObject({
     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,
@@ -1341,6 +1442,7 @@ export const ItemSummarySchema = z.looseObject({
     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(),
@@ -1526,6 +1628,13 @@ export const SessionApprovalOutcomeSchema = z.looseObject({
     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,
@@ -1586,6 +1695,8 @@ export const SessionResponseSchema = z.looseObject({
         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,
@@ -1605,10 +1716,29 @@ export const SessionThreadSchema = z.looseObject({
         status: SessionItemStatusSchema.nullable(),
     })
         .nullable(),
-    bound_reason: openEnum(['posted', 'routed', 'handed', 'assigned', 'mentioned']),
+    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,
@@ -1641,6 +1771,7 @@ export const UpdateItemRequestSchema = z.looseObject({
     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(),
@@ -1827,6 +1958,29 @@ export const SessionCardResponseEventSchema = z.looseObject({
     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(),
@@ -1836,6 +1990,77 @@ export const SessionEventDataSchema = z.looseObject({
     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,
@@ -1843,13 +2068,23 @@ export const SessionItemAssignedDataSchema = z.looseObject({
     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']),
+    reason: openEnum([
+        'unassigned',
+        'reassigned',
+        'moved',
+        'deleted',
+        'owner_left',
+        'agent_deleted',
+        'declined',
+        'handoff_expired',
+    ]),
     user: SessionEventUserSchema.nullable(),
 });
 export const SessionMentionDataSchema = z.looseObject({
@@ -1913,6 +2148,7 @@ export const ItemDetailSchema = z.looseObject({
     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(),
@@ -1948,6 +2184,7 @@ export const ItemSearchResultSchema = z.looseObject({
     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(),
@@ -1971,6 +2208,22 @@ 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,
@@ -2062,6 +2315,7 @@ export const SessionCardClosedDataSchema = z.looseObject({
     private: z.unknown(),
     plan: SessionPlanOutcomeSchema.optional(),
     approval: SessionApprovalOutcomeSchema.optional(),
+    handoff: SessionHandoffOutcomeSchema.optional(),
 });
 export const SessionCardClosedEventSchema = z.looseObject({
     v: z.literal(1),
@@ -2081,6 +2335,7 @@ export const SessionEventSchema = z.union([
     SessionMentionEventSchema,
     SessionItemAssignedEventSchema,
     SessionItemUnassignedEventSchema,
+    SessionChildDoneEventSchema,
 ]);
 export const SessionEventsResponseSchema = z.looseObject({
     events: z.array(SessionEventSchema),