@kammcs/buildit-mcp 0.10.0 → 0.12.0

package/dist/api/generated/strict.js

@@ -2,7 +2,7 @@
  * Exact schemas for the agent API: closed objects and enums, patterns and bounds. The test fake uses them to check requests and its own responses against the contract; the server parses responses with the tolerant schemas.ts.
  *
  * GENERATED by scripts/generate.ts from openapi/openapi.json (agent API
- * 1.11.0). Do not edit: change the contract, then run
+ * 1.14.0). Do not edit: change the contract, then run
  * `npm run generate`.
  */
 import { z } from 'zod';
@@ -94,6 +94,7 @@ export const EntityKindSchema = z.enum([
     'approval',
     'handoff',
     'upload',
+    'request',
 ]);
 export const EstimateSchema = z.number().min(0).max(9999.99);
 export const EstimateScaleSchema = z.enum(['none', 'points', 'tshirt']);
@@ -1065,6 +1066,36 @@ export const ErrorSchema = z.strictObject({
                     .regex(new RegExp('^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$', 'u')),
             }),
         }),
+        z.strictObject({
+            code: z.literal('request_not_found'),
+            message: z.string().min(1),
+            hint: z.string().optional(),
+            details: z.strictObject({
+                request_id: z
+                    .string()
+                    .regex(new RegExp('^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$', 'u')),
+            }),
+        }),
+        z.strictObject({
+            code: z.literal('request_closed'),
+            message: z.string().min(1),
+            hint: z.string().optional(),
+            details: z.strictObject({
+                request_id: z
+                    .string()
+                    .regex(new RegExp('^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$', 'u')),
+            }),
+        }),
+        z.strictObject({
+            code: z.literal('request_result_private'),
+            message: z.string().min(1),
+            hint: z.string().optional(),
+            details: z.strictObject({
+                request_id: z
+                    .string()
+                    .regex(new RegExp('^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$', 'u')),
+            }),
+        }),
     ]),
 });
 export const FeedbackSchema = z.strictObject({
@@ -1204,6 +1235,7 @@ export const PostSessionMessageRequestSchema = z.strictObject({
     conversation_id: UuidSchema.optional(),
     card: QuestionCardSchema.optional(),
     files: z.array(UuidSchema).min(1).max(10).optional(),
+    request: UuidSchema.optional(),
 });
 export const PresignedPutSchema = z.strictObject({
     url: z.string(),
@@ -1372,6 +1404,17 @@ export const SessionLinkFileSchema = z.strictObject({
     duration_ms: z.int().min(1).optional(),
 });
 export const SessionOwnerSchema = z.strictObject({ id: UuidSchema, name: z.string() });
+export const SessionRequestChannelContextSchema = z.strictObject({
+    type: z.literal('channel'),
+    channel: z.strictObject({ id: UuidSchema, name: z.string().nullable() }),
+    from: TimestampSchema,
+    to: TimestampSchema,
+});
+export const SessionRequestThreadContextSchema = z.strictObject({
+    type: z.literal('thread'),
+    channel: z.strictObject({ id: UuidSchema, name: z.string().nullable(), dm: z.boolean() }),
+    thread_id: UuidSchema,
+});
 export const SessionRuleSchema = z.union([
     z.strictObject({
         type: z.literal('addRules'),
@@ -1776,39 +1819,11 @@ export const MeResponseSchema = z.strictObject({
     projects: z.array(ProjectBriefSchema),
     rate_limits: RateLimitsSchema,
 });
-export const MessageSchema = z.strictObject({
+export const MessageItemSchema = z.strictObject({
     id: UuidSchema,
-    channel_id: UuidSchema,
-    author: MessageAuthorSchema.nullable(),
-    kind: MessageKindSchema,
-    body: z.string(),
-    code: z.string().nullable(),
-    code_language: z.string().nullable(),
-    file: z
-        .strictObject({
-        id: UuidSchema,
-        name: z.string(),
-        type: z.string(),
-        duration_ms: z.int().min(1).nullable(),
-    })
-        .nullable(),
-    photos: z.array(z.strictObject({
-        id: UuidSchema,
-        name: z.string(),
-        type: z.string(),
-        alt: z.string().nullable(),
-        duration_ms: z.int().min(1).nullable(),
-    })),
-    mentions: z.array(UserSchema),
-    reply_count: z.int(),
-    last_reply_at: TimestampSchema.nullable(),
-    created_at: TimestampSchema,
-    edited_at: TimestampSchema.nullable(),
-    deleted: z.boolean(),
-    via_agent: z.string().nullable(),
-    pinned: z.boolean(),
-    pinned_at: TimestampSchema.nullable(),
-    pinned_by: MessageAuthorSchema.nullable(),
+    key: ItemKeySchema,
+    title: z.string(),
+    status: StatusBriefSchema,
 });
 export const PageSchema = z.strictObject({
     id: UuidSchema,
@@ -2012,6 +2027,21 @@ export const SessionMessageSchema = z.strictObject({
     created_at: TimestampSchema,
     session: SessionBriefSchema,
 });
+export const SessionRequestBriefContextSchema = z.strictObject({
+    type: z.literal('brief'),
+    project: SessionEventProjectSchema,
+    channel: z.strictObject({ id: UuidSchema, name: z.string().nullable() }),
+    from: TimestampSchema,
+    to: TimestampSchema,
+});
+export const SessionRequestItemContextSchema = z.strictObject({
+    type: z.literal('item'),
+    item: ItemIdKeySchema,
+});
+export const SessionRequestItemsContextSchema = z.strictObject({
+    type: z.literal('items'),
+    items: z.array(ItemIdKeySchema).min(1).max(20),
+});
 export const SessionResponseSchema = z.strictObject({
     session: z.strictObject({
         id: UuidSchema,
@@ -2235,10 +2265,6 @@ export const LinkSchema = z.strictObject({
     kind: LinkKindSchema,
     item: LinkedItemSchema.nullable(),
 });
-export const ListChannelMessagesResponseSchema = z.strictObject({
-    items: z.array(MessageSchema),
-    next_cursor: z.string().nullable(),
-});
 export const ListChannelsResponseSchema = z.strictObject({
     items: z.array(ChannelSchema),
     next_cursor: z.string().nullable(),
@@ -2259,12 +2285,42 @@ export const ListSessionThreadsResponseSchema = z.strictObject({
     threads: z.array(SessionThreadSchema).max(50),
 });
 export const ListWorkTypesResponseSchema = z.strictObject({ items: z.array(WorkTypeSchema) });
-export const PageResponseSchema = z.strictObject({ page: PageSchema });
-export const PinnedMessageSchema = z.strictObject({
-    pinned_at: TimestampSchema,
+export const MessageSchema = z.strictObject({
+    id: UuidSchema,
+    channel_id: UuidSchema,
+    author: MessageAuthorSchema.nullable(),
+    kind: MessageKindSchema,
+    body: z.string(),
+    code: z.string().nullable(),
+    code_language: z.string().nullable(),
+    file: z
+        .strictObject({
+        id: UuidSchema,
+        name: z.string(),
+        type: z.string(),
+        duration_ms: z.int().min(1).nullable(),
+    })
+        .nullable(),
+    photos: z.array(z.strictObject({
+        id: UuidSchema,
+        name: z.string(),
+        type: z.string(),
+        alt: z.string().nullable(),
+        duration_ms: z.int().min(1).nullable(),
+    })),
+    mentions: z.array(UserSchema),
+    reply_count: z.int(),
+    last_reply_at: TimestampSchema.nullable(),
+    created_at: TimestampSchema,
+    edited_at: TimestampSchema.nullable(),
+    deleted: z.boolean(),
+    via_agent: z.string().nullable(),
+    pinned: z.boolean(),
+    pinned_at: TimestampSchema.nullable(),
     pinned_by: MessageAuthorSchema.nullable(),
-    message: MessageSchema,
+    item: MessageItemSchema.optional(),
 });
+export const PageResponseSchema = z.strictObject({ page: PageSchema });
 export const PlanResultSchema = z.union([
     z.strictObject({ action: z.literal('delete_item'), deleted: z.array(ItemBriefSchema) }),
     z.strictObject({
@@ -2431,11 +2487,13 @@ export const SessionItemUnassignedDataSchema = z.strictObject({
     ]),
     user: SessionEventUserSchema.nullable(),
 });
-export const ThreadResponseSchema = z.strictObject({
-    root: MessageSchema,
-    replies: z.array(MessageSchema),
-    next_cursor: z.string().nullable(),
-});
+export const SessionRequestContextSchema = z.union([
+    SessionRequestChannelContextSchema,
+    SessionRequestThreadContextSchema,
+    SessionRequestItemContextSchema,
+    SessionRequestItemsContextSchema,
+    SessionRequestBriefContextSchema,
+]);
 export const TransitionItemRequestSchema = z.strictObject({
     status: NameRefSchema,
     comment: CommentBodySchema.optional(),
@@ -2539,10 +2597,15 @@ export const ItemSearchResultSchema = z.strictObject({
     description: z.string().optional(),
     custom: z.array(CustomFieldValueSchema).optional(),
 });
-export const ListPinsResponseSchema = z.strictObject({
-    items: z.array(PinnedMessageSchema),
+export const ListChannelMessagesResponseSchema = z.strictObject({
+    items: z.array(MessageSchema),
     next_cursor: z.string().nullable(),
 });
+export const PinnedMessageSchema = z.strictObject({
+    pinned_at: TimestampSchema,
+    pinned_by: MessageAuthorSchema.nullable(),
+    message: MessageSchema,
+});
 export const ProposeSessionHandoffResponseSchema = z.strictObject({
     handoff: SessionHandoffSchema,
     created: z.boolean(),
@@ -2605,6 +2668,37 @@ export const SessionPlanOutcomeSchema = z.strictObject({
     error: z.strictObject({ code: z.string(), message: z.string().optional() }).optional(),
     changed: z.array(z.strictObject({ kind: z.string(), ref: z.string() })).optional(),
 });
+export const SessionRequestDataSchema = z.strictObject({
+    request: z.strictObject({
+        id: UuidSchema,
+        kind: z.enum([
+            'catch_up',
+            'thread_to_items',
+            'triage',
+            'item_helper.spec',
+            'item_helper.subtasks',
+            'item_helper.estimate',
+            'item_helper.related',
+            'item_helper.stalled',
+        ]),
+        source: z.enum(['button', 'subscription']),
+        subscription_id: UuidSchema.nullable(),
+        created_at: TimestampSchema,
+        expires_at: TimestampSchema,
+    }),
+    requester: SessionEventUserSchema,
+    locale: z.string(),
+    time_zone: z.string(),
+    project: SessionEventProjectSchema.nullable(),
+    context: SessionRequestContextSchema,
+    result: z.strictObject({ place: z.enum(['dm', 'thread', 'item_thread']) }),
+    handed: z.strictObject({ from_session: SessionBriefSchema }).nullable(),
+});
+export const ThreadResponseSchema = z.strictObject({
+    root: MessageSchema,
+    replies: z.array(MessageSchema),
+    next_cursor: z.string().nullable(),
+});
 export const CreateItemResponseSchema = z.strictObject({
     item: ItemDetailSchema,
     created: z.boolean(),
@@ -2620,6 +2714,10 @@ export const GetItemResponseSchema = z.strictObject({
     feedback: FeedbackSchema.optional(),
 });
 export const ItemWriteResponseSchema = z.strictObject({ item: ItemDetailSchema });
+export const ListPinsResponseSchema = z.strictObject({
+    items: z.array(PinnedMessageSchema),
+    next_cursor: z.string().nullable(),
+});
 export const SearchItemsResponseSchema = z.strictObject({
     items: z.array(ItemSearchResultSchema),
     next_cursor: z.string().nullable(),
@@ -2679,6 +2777,17 @@ export const SessionMessageEventSchema = z.strictObject({
     session: SessionBriefSchema,
     data: SessionEventDataSchema,
 });
+export const SessionRequestEventSchema = z.strictObject({
+    v: z.literal(1),
+    id: UuidSchema,
+    type: z.literal('agent.request'),
+    created_at: TimestampSchema,
+    org: z.strictObject({ id: UuidSchema }),
+    app: z.strictObject({ id: UuidSchema, installation_id: UuidSchema }),
+    attempt: z.int().min(1),
+    session: SessionBriefSchema,
+    data: SessionRequestDataSchema,
+});
 export const SessionCardClosedEventSchema = z.strictObject({
     v: z.literal(1),
     id: UuidSchema,
@@ -2698,6 +2807,7 @@ export const SessionEventSchema = z.union([
     SessionItemAssignedEventSchema,
     SessionItemUnassignedEventSchema,
     SessionChildDoneEventSchema,
+    SessionRequestEventSchema,
 ]);
 export const SessionEventsResponseSchema = z.strictObject({
     events: z.array(SessionEventSchema),
@@ -2758,6 +2868,7 @@ export const QUERY_SCHEMAS = {
     get_workflow: z.strictObject({}),
     list_channel_messages: z.strictObject({
         since: TimestampSchema.optional(),
+        active_since: TimestampSchema.optional(),
         cursor: CursorSchema.optional(),
         limit: z.coerce.number().int().min(1).max(100).optional(),
     }),
@@ -2768,6 +2879,7 @@ export const QUERY_SCHEMAS = {
     }),
     list_comments: z.strictObject({
         order: z.enum(['asc', 'desc']).optional(),
+        since: TimestampSchema.optional(),
         cursor: CursorSchema.optional(),
         limit: z.coerce.number().int().min(1).max(100).optional(),
     }),

package/dist/channel/loop.js

@@ -13,6 +13,11 @@
  * `mention` (the owner mentioned it in the item's thread), `message` (the
  * owner's other replies in a thread it works in) and `item_unassigned`
  * (stop: it also stops "is writing" and the waiters of that thread).
+ * A request (`agent.request`, requests.ts) becomes `event="request"`, with
+ * its kind, context ids and the owner's language and time zone as
+ * attributes and a lead line written here from structured fields; only
+ * this session's, only the owner's, and once per request (a hand-on to
+ * another session writes a new event for the same request).
  * Session handoffs (handoffs.ts): an assignment that came by handoff is an
  * `item_assigned` with `handoff="true"`; `work_item.child_done` becomes
  * `child_done` (a subtask this session handed on is in review or done, was
@@ -51,6 +56,7 @@ import { ackSessionEvents, getSession, listSessionEvents, listSessionThreads, SE
 import { apiApprovalCloser } from './approvals.js';
 import { attachmentsBlock, forwardedFilesLead } from './attachment-blocks.js';
 import { AttachmentStore, filesServed } from './attachments.js';
+import { REQUEST_EVENT_TYPE, requestContent, } from './requests.js';
 import { ToolRing } from './tool-ring.js';
 import { CardWaiters, eventMessageId } from './waiters.js';
 /** The notification Claude Code reads as a channel event. */
@@ -63,6 +69,8 @@ const ENDED_NOTICES = {
 };
 /** How many item keys are remembered (key to id). */
 const ITEMS_MAX = 500;
+/** How many requests are remembered (id to kind and place), for reply's check. */
+const REQUESTS_MAX = 200;
 /**
  * What the loop and the channel tools (reply, ask, the plan cards) share:
  * the session, the thread of the latest message, the items seen in events,
@@ -129,6 +137,19 @@ export class ChannelState {
                 : [{ thread_id: this.lastDmThread, item: undefined }]),
         ];
     }
+    /** The requests this session was sent, by id (the oldest forgotten past REQUESTS_MAX). */
+    requests = new Map();
+    /** Remembers a request's kind and where its result goes. */
+    rememberRequest(id, request) {
+        const k = id.toLowerCase();
+        this.requests.delete(k);
+        this.requests.set(k, request);
+        if (this.requests.size > REQUESTS_MAX) {
+            const oldest = this.requests.keys().next().value;
+            if (oldest !== undefined)
+                this.requests.delete(oldest);
+        }
+    }
     /** The owner's locale, from their latest event (the cards' language). */
     ownerLocale;
     /**
@@ -533,6 +554,10 @@ export class ChannelLoop {
             return;
         }
         this.seen.add(event.id);
+        if (event.type === REQUEST_EVENT_TYPE) {
+            await this.deliverRequest(event, info);
+            return;
+        }
         if (event.type === 'card.response' || event.type === 'card.closed') {
             await this.deliverCard(event, info);
             return;
@@ -614,6 +639,51 @@ export class ChannelLoop {
         this.options.state.typing?.start(threadId);
         logger.info('channel message delivered', { event_id: event.id, message_id: message.id });
     }
+    /**
+     * A request (agent.request): the owner's tap on a "... with my agent"
+     * button, or a subscription they set up. Dropped when it is another
+     * session's (other_session), not the owner's (not_owner: the server sends
+     * only the owner's, and this checks again), a request already handed on
+     * (repeat: by request id, since a hand-on writes a new event), or a shape
+     * this version can't read (shape).
+     */
+    async deliverRequest(event, info) {
+        const { logger, state } = this.options;
+        if (event.session.id !== info.session.id) {
+            logger.warn('channel event dropped', { event_id: event.id, reason: 'other_session' });
+            return;
+        }
+        const { requester, request } = event.data;
+        if (requester.id !== info.owner.id || requester.is_guest) {
+            logger.warn('channel event dropped', { event_id: event.id, reason: 'not_owner' });
+            return;
+        }
+        const seenKey = `r:${request.id.toLowerCase()}`;
+        if (this.seen.has(seenKey)) {
+            logger.debug('channel event dropped', { event_id: event.id, reason: 'repeat' });
+            return;
+        }
+        const built = requestContent(event.data, {
+            owner: info.owner.name,
+            session: event.session.label,
+        });
+        if (!built.ok) {
+            logger.warn('channel event dropped', { event_id: event.id, reason: built.reason });
+            return;
+        }
+        this.seen.add(seenKey);
+        this.noteLocale({ locale: built.meta.locale });
+        await this.send({ content: built.content, meta: built.meta });
+        state.rememberRequest(built.requestId, {
+            kind: request.kind,
+            place: built.meta.result,
+        });
+        logger.info('request delivered', {
+            event_id: event.id,
+            request_id: built.requestId,
+            kind: request.kind,
+        });
+    }
     /** Sends one notification; a failure stops the loop (the page is not acknowledged). */
     async send(params) {
         try {