busa-sdk 0.40.0 → 0.40.1

package/dist/airapp.d.ts

@@ -1,4 +1,4 @@
-import { t as BusabaseClient } from "./client-CWlHll4H.js";
+import { t as BusabaseClient } from "./client-DbETz_5k.js";
 //#region src/airapp.d.ts
 type NodeChangeRequestInput = Parameters<BusabaseClient["nodes"]["createChangeRequest"]>[0];
 type NodeOperationInput = NodeChangeRequestInput["operations"][number];

package/dist/{client-CWlHll4H.d.ts → client-DbETz_5k.d.ts}

@@ -7014,7 +7014,25 @@ declare const cloudContract: {
         role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
       }, z.core.$strip>>>>;
       body: z.ZodString;
-      mentionsAi: z.ZodBoolean;
+      mentions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodEnum<{
+          agent: "agent";
+          member: "member";
+        }>;
+        targetId: z.ZodString;
+        label: z.ZodString;
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+        dispatchStatus: z.ZodEnum<{
+          failed: "failed";
+          linked: "linked";
+          not_applicable: "not_applicable";
+          queued: "queued";
+        }>;
+        sessionId: z.ZodNullable<z.ZodString>;
+        error: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>>>;
       createdAt: z.ZodString;
       updatedAt: z.ZodString;
     }, z.core.$strip>>, import("@orpc/contract").MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
@@ -7028,7 +7046,15 @@ declare const cloudContract: {
       subjectId: z.ZodString;
       authorId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
       body: z.ZodString;
-      mentionsAi: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+      mentions: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+          agent: "agent";
+          member: "member";
+        }>;
+        id: z.ZodString;
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+      }, z.core.$strip>>>>;
     }, z.core.$strip>, z.ZodObject<{
       id: z.ZodString;
       subjectType: z.ZodEnum<{
@@ -7051,7 +7077,25 @@ declare const cloudContract: {
         role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
       }, z.core.$strip>>>>;
       body: z.ZodString;
-      mentionsAi: z.ZodBoolean;
+      mentions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodEnum<{
+          agent: "agent";
+          member: "member";
+        }>;
+        targetId: z.ZodString;
+        label: z.ZodString;
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+        dispatchStatus: z.ZodEnum<{
+          failed: "failed";
+          linked: "linked";
+          not_applicable: "not_applicable";
+          queued: "queued";
+        }>;
+        sessionId: z.ZodNullable<z.ZodString>;
+        error: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>>>;
       createdAt: z.ZodString;
       updatedAt: z.ZodString;
     }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
@@ -7515,7 +7559,25 @@ declare const cloudContract: {
           role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$strip>>>>;
         body: z.ZodString;
-        mentionsAi: z.ZodBoolean;
+        mentions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+          id: z.ZodString;
+          type: z.ZodEnum<{
+            agent: "agent";
+            member: "member";
+          }>;
+          targetId: z.ZodString;
+          label: z.ZodString;
+          start: z.ZodNumber;
+          end: z.ZodNumber;
+          dispatchStatus: z.ZodEnum<{
+            failed: "failed";
+            linked: "linked";
+            not_applicable: "not_applicable";
+            queued: "queued";
+          }>;
+          sessionId: z.ZodNullable<z.ZodString>;
+          error: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
       }, z.core.$strip>>;
@@ -25074,6 +25136,34 @@ interface ReviewVO {
   visibleOperationHeads: Record<string, string>;
   createdAt: string;
 }
+type CommentMentionTargetType = "member" | "agent";
+/**
+ * Dispatch state of one mention BEFORE a session exists. Once `linked`, the
+ * agent session owns running/waiting/done/failed — it is never mirrored here.
+ */
+type CommentMentionDispatchStatus = "not_applicable" | "queued" | "linked" | "failed";
+/**
+ * One mention as the composer submits it. `start`/`end` are UTF-16 code unit
+ * offsets into the comment body (see the contract schema for why).
+ */
+interface CommentMentionInputDTO {
+  type: CommentMentionTargetType;
+  id: string;
+  start: number;
+  end: number;
+}
+interface CommentMentionVO {
+  id: string;
+  type: CommentMentionTargetType;
+  targetId: string;
+  /** Server-resolved display name; falls back to the raw target id. */
+  label: string;
+  start: number;
+  end: number;
+  dispatchStatus: CommentMentionDispatchStatus;
+  sessionId: string | null;
+  error: string | null;
+}
 interface CommentVO {
   id: string;
   subjectType: CommentSubjectType;
@@ -25085,7 +25175,7 @@ interface CommentVO {
   authorId: string;
   author?: UserRefVO | null;
   body: string;
-  mentionsAi: boolean;
+  mentions: CommentMentionVO[];
   createdAt: string;
   updatedAt: string;
 }
@@ -25233,4 +25323,4 @@ declare function resolveConfig(config?: BusabaseConfig): ResolvedConfig;
  */
 declare function createBusabaseClient(config?: BusabaseConfig): BusabaseClient;
 //#endregion
-export { FileTreeReadFileVO as $, SearchResultKind as A, AttachmentRef as At, VaultRuntimeEnv as B, NodeSearchResultVO as C, VIEW_FIELD_MIN_WIDTH as Ct, ReviewVO as D, ViewSortVO as Dt, OperationVO as E, ViewFilterVO as Et, VaultAccessPolicy as F, CREATABLE_NODE_TYPES as Ft, AssetDetailVO as G, VaultSettingsVO as H, VaultEnvironment as I, CreatableNodeType as It, AssetVO as J, AssetTextStatus as K, VaultItemInput as L, NodeType as Lt, SourceAttributionVO as M, cloudContract as Mt, UserRefVO as N, NodeIcon as Nt, ReviewVerdict as O, ViewType as Ot, UpdateVaultSettingsDTO as P, NodeIconSchema as Pt, FileTreeNodeVO as Q, VaultItemKind as R, OperationKind as Rt, LookupRollup as S, VIEW_FIELD_MAX_WIDTH as St, OperationStatus as T, ViewFilterOperator as Tt, FileNodeMetadata as U, VaultScopeType as V, FileNodeVO as W, GrepResultVO as X, GrepInputDTO as Y, FileTreeFileVO as Z, ChangeRequestVO as _, GalleryCardSize as _t, createBusabaseClient as a, FormPageSourceVO as at, CommitVO as b, RecordLinkVO as bt, AuditAction as c, FormThemeVO as ct, ChangeRequestBatchFailureVO as d, ListFormsVO as dt, NodeDetailVO as et, ChangeRequestCountsVO as f, SubmitFormDTO as ft, ChangeRequestTargetType as g, BaseVO as gt, ChangeRequestStatus as h, BaseFieldVO as ht, ResolvedConfig as i, FormFieldBindingVO as it, SearchResultVO as j, CloudContract as jt, SearchResponseVO as k, ViewVO as kt, AuditEventVO as l, FormVO as lt, ChangeRequestReviewBatchResultVO as m, AssetAttachmentRef as mt, BusabaseConfig as n, CreateFormDTO as nt, resolveConfig as o, FormShareVO as ot, ChangeRequestMergeBatchResultVO as p, UpdateFormDTO as pt, AssetUsageVO as q, DEFAULT_BASE_URL as r, FormBoundFieldVO as rt, AgentTaskVO as s, FormSubmitResultVO as st, BusabaseClient as t, ActivityItemVO as tt, BusabaseSourceChannel as u, ListFormsDTO as ut, CommentSubjectType as v, GalleryCoverFit as vt, NodeVO as w, ViewConfigVO as wt, FieldType as x, RecordVO as xt, CommentVO as y, GanttScale as yt, VaultItemVO as z };
+export { GrepInputDTO as $, OperationVO as A, ViewFilterVO as At, VaultEnvironment as B, CreatableNodeType as Bt, CommentVO as C, GanttScale as Ct, NodeSearchResultVO as D, VIEW_FIELD_MIN_WIDTH as Dt, LookupRollup as E, VIEW_FIELD_MAX_WIDTH as Et, SearchResultVO as F, CloudContract as Ft, VaultScopeType as G, VaultItemKind as H, OperationKind as Ht, SourceAttributionVO as I, cloudContract as It, FileNodeVO as J, VaultSettingsVO as K, UserRefVO as L, NodeIcon as Lt, ReviewVerdict as M, ViewType as Mt, SearchResponseVO as N, ViewVO as Nt, NodeVO as O, ViewConfigVO as Ot, SearchResultKind as P, AttachmentRef as Pt, AssetVO as Q, UpdateVaultSettingsDTO as R, NodeIconSchema as Rt, CommentSubjectType as S, GalleryCoverFit as St, FieldType as T, RecordVO as Tt, VaultItemVO as U, VaultItemInput as V, NodeType as Vt, VaultRuntimeEnv as W, AssetTextStatus as X, AssetDetailVO as Y, AssetUsageVO as Z, ChangeRequestVO as _, UpdateFormDTO as _t, createBusabaseClient as a, ActivityItemVO as at, CommentMentionTargetType as b, BaseVO as bt, AuditAction as c, FormFieldBindingVO as ct, ChangeRequestBatchFailureVO as d, FormSubmitResultVO as dt, GrepResultVO as et, ChangeRequestCountsVO as f, FormThemeVO as ft, ChangeRequestTargetType as g, SubmitFormDTO as gt, ChangeRequestStatus as h, ListFormsVO as ht, ResolvedConfig as i, NodeDetailVO as it, ReviewVO as j, ViewSortVO as jt, OperationStatus as k, ViewFilterOperator as kt, AuditEventVO as l, FormPageSourceVO as lt, ChangeRequestReviewBatchResultVO as m, ListFormsDTO as mt, BusabaseConfig as n, FileTreeNodeVO as nt, resolveConfig as o, CreateFormDTO as ot, ChangeRequestMergeBatchResultVO as p, FormVO as pt, FileNodeMetadata as q, DEFAULT_BASE_URL as r, FileTreeReadFileVO as rt, AgentTaskVO as s, FormBoundFieldVO as st, BusabaseClient as t, FileTreeFileVO as tt, BusabaseSourceChannel as u, FormShareVO as ut, CommentMentionDispatchStatus as v, AssetAttachmentRef as vt, CommitVO as w, RecordLinkVO as wt, CommentMentionVO as x, GalleryCardSize as xt, CommentMentionInputDTO as y, BaseFieldVO as yt, VaultAccessPolicy as z, CREATABLE_NODE_TYPES as zt };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { $ as FileTreeReadFileVO, A as SearchResultKind, At as AttachmentRef, B as VaultRuntimeEnv, C as NodeSearchResultVO, Ct as VIEW_FIELD_MIN_WIDTH, D as ReviewVO, Dt as ViewSortVO, E as OperationVO, Et as ViewFilterVO, F as VaultAccessPolicy, Ft as CREATABLE_NODE_TYPES, G as AssetDetailVO, H as VaultSettingsVO, I as VaultEnvironment, It as CreatableNodeType, J as AssetVO, K as AssetTextStatus, L as VaultItemInput, Lt as NodeType, M as SourceAttributionVO, Mt as cloudContract, N as UserRefVO, Nt as NodeIcon, O as ReviewVerdict, Ot as ViewType, P as UpdateVaultSettingsDTO, Pt as NodeIconSchema, Q as FileTreeNodeVO, R as VaultItemKind, Rt as OperationKind, S as LookupRollup, St as VIEW_FIELD_MAX_WIDTH, T as OperationStatus, Tt as ViewFilterOperator, U as FileNodeMetadata, V as VaultScopeType, W as FileNodeVO, X as GrepResultVO, Y as GrepInputDTO, Z as FileTreeFileVO, _ as ChangeRequestVO, _t as GalleryCardSize, a as createBusabaseClient, at as FormPageSourceVO, b as CommitVO, bt as RecordLinkVO, c as AuditAction, ct as FormThemeVO, d as ChangeRequestBatchFailureVO, dt as ListFormsVO, et as NodeDetailVO, f as ChangeRequestCountsVO, ft as SubmitFormDTO, g as ChangeRequestTargetType, gt as BaseVO, h as ChangeRequestStatus, ht as BaseFieldVO, i as ResolvedConfig, it as FormFieldBindingVO, j as SearchResultVO, jt as CloudContract, k as SearchResponseVO, kt as ViewVO, l as AuditEventVO, lt as FormVO, m as ChangeRequestReviewBatchResultVO, mt as AssetAttachmentRef, n as BusabaseConfig, nt as CreateFormDTO, o as resolveConfig, ot as FormShareVO, p as ChangeRequestMergeBatchResultVO, pt as UpdateFormDTO, q as AssetUsageVO, r as DEFAULT_BASE_URL, rt as FormBoundFieldVO, s as AgentTaskVO, st as FormSubmitResultVO, t as BusabaseClient, tt as ActivityItemVO, u as BusabaseSourceChannel, ut as ListFormsDTO, v as CommentSubjectType, vt as GalleryCoverFit, w as NodeVO, wt as ViewConfigVO, x as FieldType, xt as RecordVO, y as CommentVO, yt as GanttScale, z as VaultItemVO } from "./client-CWlHll4H.js";
+import { $ as GrepInputDTO, A as OperationVO, At as ViewFilterVO, B as VaultEnvironment, Bt as CreatableNodeType, C as CommentVO, Ct as GanttScale, D as NodeSearchResultVO, Dt as VIEW_FIELD_MIN_WIDTH, E as LookupRollup, Et as VIEW_FIELD_MAX_WIDTH, F as SearchResultVO, Ft as CloudContract, G as VaultScopeType, H as VaultItemKind, Ht as OperationKind, I as SourceAttributionVO, It as cloudContract, J as FileNodeVO, K as VaultSettingsVO, L as UserRefVO, Lt as NodeIcon, M as ReviewVerdict, Mt as ViewType, N as SearchResponseVO, Nt as ViewVO, O as NodeVO, Ot as ViewConfigVO, P as SearchResultKind, Pt as AttachmentRef, Q as AssetVO, R as UpdateVaultSettingsDTO, Rt as NodeIconSchema, S as CommentSubjectType, St as GalleryCoverFit, T as FieldType, Tt as RecordVO, U as VaultItemVO, V as VaultItemInput, Vt as NodeType, W as VaultRuntimeEnv, X as AssetTextStatus, Y as AssetDetailVO, Z as AssetUsageVO, _ as ChangeRequestVO, _t as UpdateFormDTO, a as createBusabaseClient, at as ActivityItemVO, b as CommentMentionTargetType, bt as BaseVO, c as AuditAction, ct as FormFieldBindingVO, d as ChangeRequestBatchFailureVO, dt as FormSubmitResultVO, et as GrepResultVO, f as ChangeRequestCountsVO, ft as FormThemeVO, g as ChangeRequestTargetType, gt as SubmitFormDTO, h as ChangeRequestStatus, ht as ListFormsVO, i as ResolvedConfig, it as NodeDetailVO, j as ReviewVO, jt as ViewSortVO, k as OperationStatus, kt as ViewFilterOperator, l as AuditEventVO, lt as FormPageSourceVO, m as ChangeRequestReviewBatchResultVO, mt as ListFormsDTO, n as BusabaseConfig, nt as FileTreeNodeVO, o as resolveConfig, ot as CreateFormDTO, p as ChangeRequestMergeBatchResultVO, pt as FormVO, q as FileNodeMetadata, r as DEFAULT_BASE_URL, rt as FileTreeReadFileVO, s as AgentTaskVO, st as FormBoundFieldVO, t as BusabaseClient, tt as FileTreeFileVO, u as BusabaseSourceChannel, ut as FormShareVO, v as CommentMentionDispatchStatus, vt as AssetAttachmentRef, w as CommitVO, wt as RecordLinkVO, x as CommentMentionVO, xt as GalleryCardSize, y as CommentMentionInputDTO, yt as BaseFieldVO, z as VaultAccessPolicy, zt as CREATABLE_NODE_TYPES } from "./client-DbETz_5k.js";
 import { z } from "zod";
 //#region src/url.d.ts
 /**
@@ -426,4 +426,4 @@ declare class Busabase {
   }>>>>;
 }
 //#endregion
-export { type ActivityItemVO, type AgentTaskVO, type FileTreeFileVO as AirAppFileVO, type FileTreeFileVO as DriveFileVO, type FileTreeFileVO, type FileTreeFileVO as SkillFileVO, type FileTreeReadFileVO as AirAppReadFileVO, type FileTreeReadFileVO as DriveReadFileVO, type FileTreeReadFileVO, type FileTreeReadFileVO as SkillReadFileVO, type FileTreeNodeVO as AirAppVO, type FileTreeNodeVO as DriveVO, type FileTreeNodeVO, type FileTreeNodeVO as SkillVO, type AssetAttachmentRef, type AssetDetailVO, type AssetTextStatus, type AssetUsageVO, type AssetVO, type AttachmentRef, type AuditAction, type AuditEventVO, type BaseFieldVO, type BaseVO, Busabase, type BusabaseAssetsClient, BusabaseChangeRequestsClient, type BusabaseClient, type BusabaseConfig, type BusabaseRecordsClient, type BusabaseSourceChannel, CREATABLE_NODE_TYPES, type ChangeRequestBatchFailureVO, type ChangeRequestCountsVO, type ChangeRequestMergeBatchResultVO, type ChangeRequestReviewBatchResultVO, type ChangeRequestStatus, type ChangeRequestTargetType, type ChangeRequestVO, type CloudContract, type CommentSubjectType, type CommentVO, type CommitVO, type CreatableNodeType, type CreateFormDTO, DEFAULT_BASE_URL, type FieldType, type FileNodeMetadata, type FileNodeVO, type FormBoundFieldVO, type FormFieldBindingVO, type FormPageSourceVO, type FormShareVO, type FormSubmitResultVO, type FormThemeVO, type FormVO, type GalleryCardSize, type GalleryCoverFit, type GanttScale, type ListFormsDTO, type ListFormsVO, type LookupRollup, type NodeDetailVO, type NodeIcon, type NodeIconSchema, type NodeSearchResultVO, type NodeType, type NodeVO, type NodeWebUrlInput, type OperationKind, type OperationStatus, type OperationVO, type RecordByFieldInput, type RecordLinkVO, type RecordVO, type ResolvedConfig, type ReviewVO, type ReviewVerdict, type SearchResponseVO, type SearchResultKind, type SearchResultVO, type SourceAttributionVO, type SubmitFormDTO, type UpdateFormDTO, type UpdateVaultSettingsDTO, type UserRefVO, type VIEW_FIELD_MAX_WIDTH, type VIEW_FIELD_MIN_WIDTH, type VaultAccessPolicy, type VaultEnvironment, type VaultItemInput, type VaultItemKind, type VaultItemVO, type VaultRuntimeEnv, type VaultScopeType, type VaultSettingsVO, type ViewConfigVO, type ViewFilterOperator, type ViewFilterVO, type ViewSortVO, type ViewType, type ViewVO, cloudContract, createBusabaseClient, getRecordByField, grepAssets, nodeWebUrl, normalizeBaseUrl, resolveConfig, toFilesOnlyGrepResult, toUnifiedFilesGrepInput };
+export { type ActivityItemVO, type AgentTaskVO, type FileTreeFileVO as AirAppFileVO, type FileTreeFileVO as DriveFileVO, type FileTreeFileVO, type FileTreeFileVO as SkillFileVO, type FileTreeReadFileVO as AirAppReadFileVO, type FileTreeReadFileVO as DriveReadFileVO, type FileTreeReadFileVO, type FileTreeReadFileVO as SkillReadFileVO, type FileTreeNodeVO as AirAppVO, type FileTreeNodeVO as DriveVO, type FileTreeNodeVO, type FileTreeNodeVO as SkillVO, type AssetAttachmentRef, type AssetDetailVO, type AssetTextStatus, type AssetUsageVO, type AssetVO, type AttachmentRef, type AuditAction, type AuditEventVO, type BaseFieldVO, type BaseVO, Busabase, type BusabaseAssetsClient, BusabaseChangeRequestsClient, type BusabaseClient, type BusabaseConfig, type BusabaseRecordsClient, type BusabaseSourceChannel, CREATABLE_NODE_TYPES, type ChangeRequestBatchFailureVO, type ChangeRequestCountsVO, type ChangeRequestMergeBatchResultVO, type ChangeRequestReviewBatchResultVO, type ChangeRequestStatus, type ChangeRequestTargetType, type ChangeRequestVO, type CloudContract, type CommentMentionDispatchStatus, type CommentMentionInputDTO, type CommentMentionTargetType, type CommentMentionVO, type CommentSubjectType, type CommentVO, type CommitVO, type CreatableNodeType, type CreateFormDTO, DEFAULT_BASE_URL, type FieldType, type FileNodeMetadata, type FileNodeVO, type FormBoundFieldVO, type FormFieldBindingVO, type FormPageSourceVO, type FormShareVO, type FormSubmitResultVO, type FormThemeVO, type FormVO, type GalleryCardSize, type GalleryCoverFit, type GanttScale, type ListFormsDTO, type ListFormsVO, type LookupRollup, type NodeDetailVO, type NodeIcon, type NodeIconSchema, type NodeSearchResultVO, type NodeType, type NodeVO, type NodeWebUrlInput, type OperationKind, type OperationStatus, type OperationVO, type RecordByFieldInput, type RecordLinkVO, type RecordVO, type ResolvedConfig, type ReviewVO, type ReviewVerdict, type SearchResponseVO, type SearchResultKind, type SearchResultVO, type SourceAttributionVO, type SubmitFormDTO, type UpdateFormDTO, type UpdateVaultSettingsDTO, type UserRefVO, type VIEW_FIELD_MAX_WIDTH, type VIEW_FIELD_MIN_WIDTH, type VaultAccessPolicy, type VaultEnvironment, type VaultItemInput, type VaultItemKind, type VaultItemVO, type VaultRuntimeEnv, type VaultScopeType, type VaultSettingsVO, type ViewConfigVO, type ViewFilterOperator, type ViewFilterVO, type ViewSortVO, type ViewType, type ViewVO, cloudContract, createBusabaseClient, getRecordByField, grepAssets, nodeWebUrl, normalizeBaseUrl, resolveConfig, toFilesOnlyGrepResult, toUnifiedFilesGrepInput };

package/dist/index.js

@@ -1404,6 +1404,55 @@ const commentSubjectTypeSchema = z.enum([
 	"operation",
 	"commit"
 ]);
+/**
+* Who a mention points at. `member` tags a person; `agent` names a launchable
+* Agent target and is what actually starts a session.
+*/
+const commentMentionTargetTypeSchema = z.enum(["member", "agent"]);
+/**
+* Dispatch lifecycle of ONE mention row, before a session exists.
+*
+* `not_applicable` is every member row (a person is not dispatched to).
+* Once `linked`, running/waiting/done/failed belongs to the agent session,
+* never to a second status column here.
+*/
+const commentMentionDispatchStatusSchema = z.enum([
+	"not_applicable",
+	"queued",
+	"linked",
+	"failed"
+]);
+/**
+* One mention as the composer submits it.
+*
+* `start`/`end` are **UTF-16 code unit** offsets into `body` — the same unit
+* `<textarea>` selection APIs and `String.prototype.slice` use, so nothing has
+* to convert at the UI boundary. A label containing an astral-plane character
+* (an emoji in a display name) therefore spans two units per visible glyph;
+* the server rejects a span that would split a surrogate pair.
+*
+* No `label` here on purpose: the client never supplies identity. The server
+* resolves the display name from the member/catalog it already trusts.
+*/
+const commentMentionInputSchema = z.object({
+	type: commentMentionTargetTypeSchema,
+	/** Member/actor id, or launchable agent slug (`claude-acp`, `buda:<agentId>`). */
+	id: z.string().min(1),
+	start: z.number().int().min(0),
+	end: z.number().int().min(0)
+});
+const commentMentionSchema = z.object({
+	id: z.string(),
+	type: commentMentionTargetTypeSchema,
+	targetId: z.string(),
+	/** Server-resolved display name. Falls back to the raw target id. */
+	label: z.string(),
+	start: z.number().int(),
+	end: z.number().int(),
+	dispatchStatus: commentMentionDispatchStatusSchema,
+	sessionId: z.string().nullable(),
+	error: z.string().nullable()
+});
 const commentSchema = z.object({
 	id: z.string(),
 	subjectType: commentSubjectTypeSchema,
@@ -1415,7 +1464,7 @@ const commentSchema = z.object({
 	authorId: z.string(),
 	author: userRefSchema.nullable().optional().default(null),
 	body: z.string(),
-	mentionsAi: z.boolean(),
+	mentions: z.array(commentMentionSchema).default([]),
 	createdAt: z.string(),
 	updatedAt: z.string()
 });
@@ -1653,7 +1702,12 @@ const commentSubjectInputSchema = z.object({
 const createCommentInputSchema = commentSubjectInputSchema.extend({
 	authorId: z.string().optional().default("local-admin"),
 	body: z.string().trim().min(1),
-	mentionsAi: z.boolean().optional().default(false)
+	/**
+	* Structured mentions, owned by the composer. Never inferred from the body by
+	* regex: display names contain spaces and collide with ordinary prose, so
+	* "ask codex about this" must not invoke Codex.
+	*/
+	mentions: z.array(commentMentionInputSchema).optional().default([])
 });
 const listInputSchema = z.object({ limit: z.coerce.number().int().min(1).max(100).optional().default(50) }).optional().default({ limit: 50 });
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "busa-sdk",
-  "version": "0.40.0",
+  "version": "0.40.1",
   "description": "Typed TypeScript/JavaScript SDK for the Busabase OpenAPI REST API. Talks to a local or remote `busabase server` (or Busabase Cloud). Short-name alias for busabase-sdk.",
   "license": "MIT",
   "homepage": "https://github.com/busabase/busabase/tree/main/apps/busabase-sdk",