@50arms/plugin-sdk 0.2.56 → 0.2.59

package/dist/card-kit.d.ts

@@ -28,20 +28,20 @@ declare module "@danxbot/card-kit@1" {
   }
 
   type CardTypeKey = string;
-  type MirrorProviderId = "trello" | "slack" | "asana";
+  type MirrorProviderId = "trello" | "slack" | "asana" | "linear";
   type SourceOrigin = "danxbot" | MirrorProviderId | "";
-  interface RepoProfileCopy {
-      shipped: string;
-      repo: string;
-  }
-  type ProfileNameId = string;
-  type ProfileName = StatusReason | ProfileNameMessage;
 
   type ListType$1 = "and" | "or" | "semicolon";
   interface ListValue<Item> {
       list: readonly Item[];
       type?: ListType$1;
   }
+  interface RepoProfileCopy {
+      shipped: string;
+      repo: string;
+  }
+  type ProfileNameId = string;
+  type ProfileName = StatusReason | ProfileNameMessage;
   type StatusReasonId = string;
   type StatusReasonValues = Record<string, string | number | boolean | null | StatusReason | ProfileNameMessage | StatusReasonSentences | StatusReasonLines | StatusReasonList>;
   interface ProfileNameMessage {
@@ -59,16 +59,56 @@ declare module "@danxbot/card-kit@1" {
       id: StatusReasonId;
       values: StatusReasonValues;
   }
-  type PacingLimit = "five_hour" | "weekly" | "spend";
+  type DecisionRecordKind = "business_rule" | "architecture" | "design" | "other";
+  type DecisionRecordAction = "created" | "changed" | "deleted" | "restored";
+  type DecisionMadeBy = "human" | "agent";
+  type DecisionApprovalAction = "approve" | "unapprove";
   type ProvenanceSourceKind = "card" | "comment" | "session_thread" | "problem" | "url";
-  type ProvenancePartyKind = "person" | "agent";
-  type ResourceType = "plan" | "problem" | "issue" | "plan_record" | "plan_section" | "design" | "decision";
+  type ProvenancePartyKind = "agent" | "person";
+
+  interface DecisionApprovalState {
+      approved: boolean;
+      by_user_id: number | null;
+      by_name: string | null;
+      at: string | null;
+  }
+  interface DecisionContentView {
+      action: DecisionRecordAction;
+      title: string;
+      text: string;
+      kind: DecisionRecordKind;
+      impact: number;
+      confidence: number;
+      made_by: DecisionMadeBy;
+      made_by_user_id: number | null;
+      made_by_name: string | null;
+      made_by_author: AuthorV2;
+      made_by_is_writer: boolean;
+      provenance: ProvenanceRecordV2[];
+      author: string;
+      by: AuthorV2;
+      via_key: ViaKey | null;
+      created_at: string;
+  }
+  interface DecisionVersionView extends DecisionContentView {
+      id: number;
+      record_id: number;
+      ref: string;
+      version_no: number;
+      approval: DecisionApprovalState;
+  }
+  interface DecisionRecordPage {
+      offset: number;
+      target_found: boolean | null;
+  }
+  type PacingLimit = "five_hour" | "weekly" | "spend";
+  type ResourceType = "plan" | "design" | "problem" | "issue" | "plan_record" | "plan_section" | "decision";
   interface ResourceRef {
       type: ResourceType;
       id: string;
   }
   type RiskScore = "R0" | "R1" | "R2" | "R3" | "R4";
-  type WorkMarkResourceType = "plan" | "problem" | "issue" | "plan_record" | "plan_section" | "design" | "decision";
+  type WorkMarkResourceType = "plan" | "design" | "problem" | "issue" | "plan_record" | "plan_section" | "decision";
   interface WorkMarkResource extends ResourceRef {
       type: WorkMarkResourceType;
   }
@@ -130,21 +170,6 @@ declare module "@danxbot/card-kit@1" {
       compare_url: string | null;
       updated_at: string;
   }
-  type DecisionRecordKind = "design" | "business_rule" | "architecture" | "other";
-  type DecisionRecordAction = "created" | "changed" | "deleted" | "restored";
-  type DecisionMadeBy = "agent" | "human";
-  type DecisionApprovalAction = "approve" | "unapprove";
-
-  interface DecisionApprovalState {
-      approved: boolean;
-      by_user_id: number | null;
-      by_name: string | null;
-      at: string | null;
-  }
-  interface DecisionRecordPage {
-      offset: number;
-      target_found: boolean | null;
-  }
   type BrowserCheckStatus = "checked" | "not_checked" | "not_recorded";
 
   type ListType = "archived" | "review" | "ready" | "in_progress" | "completed" | "cancelled";
@@ -275,6 +300,7 @@ declare module "@danxbot/card-kit@1" {
   }
   interface V2CopyDecisionVersion {
       version_no: number;
+      quality_gate_round: V2CopyRoundRef | null;
       action: DecisionRecordAction;
       title: string;
       text: string;
@@ -301,8 +327,13 @@ declare module "@danxbot/card-kit@1" {
   }
   interface V2CopyChecklist {
       name: string;
+      quality_gate_round: V2CopyRoundRef | null;
       items: V2CopyChecklistItem[];
   }
+  interface V2CopyRoundRef {
+      gate: string;
+      number: number;
+  }
   interface V2CopyChecklistItem {
       label: string;
       detail: string;
@@ -353,7 +384,7 @@ declare module "@danxbot/card-kit@1" {
       decided_by: string | null;
       owed: boolean;
   }
-  type V2CopyGateRound = Omit<GateRoundV2, "id" | "by" | "via_key">;
+  type V2CopyGateRound = Omit<GateRoundV2, "id" | "by" | "via_key" | "decision_versions">;
   interface V2CopySolution extends SolutionContent {
       removed: boolean;
       design_index: number | null;
@@ -466,7 +497,7 @@ declare module "@danxbot/card-kit@1" {
   interface HolderAgentPause {
       reason: string;
       since: string;
-      until: string;
+      until: string | null;
   }
 
   interface AgentIdentity {
@@ -545,6 +576,14 @@ declare module "@danxbot/card-kit@1" {
       content: string;
   }
 
+  type NotificationText = {
+      kind: "reason";
+      reason: StatusReason;
+  } | {
+      kind: "external";
+      text: string;
+  };
+
   type PreGateHold = {
       kind: "awaiting_person";
   } | {
@@ -645,11 +684,24 @@ declare module "@danxbot/card-kit@1" {
           gate: string;
           detail: string;
       }[];
+      runnable_review: string | null;
       picker_routing: PickerRouting;
       dispatch_key_blockers: DispatchKeyBlocker[];
       worker_readiness_blockers: ReadinessBlocker[];
       agent_wait: StatusReason | null;
   }
+  type CardContextCategoryKey = "comments" | "checklists" | "content" | "agent_notes" | "problems" | "decisions" | "designs";
+  type PlanContextCategoryKey = "comments" | "architecture" | "records" | "notes" | "open_cards";
+  type ContextCategoryKey = CardContextCategoryKey | PlanContextCategoryKey;
+  interface ContextCategorySize {
+      key: ContextCategoryKey;
+      tokens: number;
+      items: number;
+  }
+  interface ContextSize {
+      total_tokens: number;
+      categories: ContextCategorySize[];
+  }
   interface BuildGradeView {
       readonly grade: string;
       readonly model: string;
@@ -747,6 +799,7 @@ declare module "@danxbot/card-kit@1" {
   interface ChecklistView {
       id: number;
       name: string;
+      quality_gate_round_id: number | null;
       items: ChecklistItemView[];
   }
   type DesignDecisionOutcome = "approved" | "changes_requested" | "rejected";
@@ -781,23 +834,23 @@ declare module "@danxbot/card-kit@1" {
     messages: Array<string>;
     reduced?: undefined | true;
     reduced_text?: undefined | null | string;
-    reply_to_removed?: undefined | true;
+    parent_removed?: undefined | true;
     updated_at: string;
-    origin: "" | "trello" | "slack" | "asana" | "danxbot";
+    origin: "" | "trello" | "slack" | "asana" | "linear" | "danxbot";
     via_key?: undefined | null | ViaKey;
     metadata?: unknown;
     answers_decision_id?: undefined | null | number;
     sign_off?: undefined | null | CommentSignOffViewV2;
     tags: Array<{ kind: "problem"; ref: number; } | { kind: "design"; ref: number; } | { kind: "decision"; ref: number; }>;
     resource_tags: Array<CommentResourceTag>;
-    reply_to_comment_id: null | number;
+    parent_comment_id: null | number;
     reply_phase: null | "ack" | "reply";
     reply_state: null | CommentReplyStateV2;
   }>);
     checklists?: undefined | Array<ChecklistView>;
     attachments?: undefined | (Array<{
     id: number;
-    source: "" | "trello" | "slack" | "asana" | "danxbot";
+    source: "" | "trello" | "slack" | "asana" | "linear" | "danxbot";
     url: string;
     filename: string;
     mime: string;
@@ -807,11 +860,64 @@ declare module "@danxbot/card-kit@1" {
     thumbnail_error: null | string;
     created_at: string;
   }>);
-    title: string;
     description?: undefined | string;
-    status: "Cancelled" | "Review" | "ToDo" | "In Progress" | "Backlog" | "Done";
     type: string;
+    title: string;
+    status: "Cancelled" | "Review" | "ToDo" | "In Progress" | "Backlog" | "Done";
     priority: number;
+    agent_notes?: undefined | (Array<{
+    id: string;
+    author: string;
+    by: AuthorV2;
+    via_key: null | ViaKey;
+    timestamp: string;
+    updated_at: string;
+    text: string;
+    metadata: unknown;
+  }>);
+    designs?: undefined | (Array<{
+    ref_num: number;
+    design_no: number;
+    title: string;
+    created_by: string;
+    created_at: string;
+    archived_at: null | string;
+    review_state: "approved" | "awaiting_review" | "changes_requested" | "rejected";
+    revision_count: number;
+    latest_revision_no: number;
+    chosen_options: null | OptionSelection;
+    comment_count?: undefined | number;
+    unread_comment_count?: undefined | number;
+    revisions?: undefined | (Array<{
+    revision_no: number;
+    target: string;
+    design_dir: string;
+    built_from_commit: string;
+    note: string;
+    created_by: string;
+    created_by_ref: ActorRef;
+    created_at: string;
+    bundle_bytes: null | number;
+    bundle_available: boolean;
+    screenshot_available: boolean;
+    option_groups: Array<DesignOptionGroup>;
+    checklist: Array<string>;
+    browser_check: "checked" | "not_checked" | "not_recorded";
+    browser_check_note: string;
+    source_files?: undefined | Array<DesignSourceFile>;
+  }>);
+    decisions?: undefined | (Array<{
+    decision_id: number;
+    revision_no: number;
+    outcome: "approved" | "changes_requested" | "rejected";
+    note: null | string;
+    comment_id: number;
+    decided_by: string;
+    decided_by_ref: ActorRef;
+    created_at: string;
+    options: null | OptionSelection;
+  }>);
+  }>);
     id: string;
     parent_id: null | string;
     rev: number;
@@ -896,6 +1002,8 @@ declare module "@danxbot/card-kit@1" {
     comments_count?: undefined | number;
     unread_comments_count?: undefined | number;
     unread_decision_comment_counts?: undefined | Record<string, number>;
+    context_size?: undefined | ContextSize;
+    content_compaction?: undefined | null | { requested_at: string; } & { status: "waiting" | "working"; ended_at: null; failure_reason: null; } | { requested_at: string; } & { status: "done"; ended_at: string; failure_reason: null; } | { requested_at: string; } & { status: "failed"; ended_at: string; failure_reason: NotificationText; };
     agent_notes_count?: undefined | number;
     comment_recipient?: undefined | { kind: "agent"; by: AuthorV2; reachability: CommentReachabilityV2; } | { kind: "none"; waiting_on: { kind: "plan"; id: PlanRefNum; ref: string; name: string; } | { kind: "card"; id: string; }; };
     comment_tags?: undefined | Array<CommentTagOption>;
@@ -914,27 +1022,18 @@ declare module "@danxbot/card-kit@1" {
     triage_last_status?: undefined | string;
     triage_last_decision_at?: undefined | null | string;
     next_pre_gate?: undefined | null | string;
+    review_runnable?: undefined | false | true;
     dispatchable_explain?: undefined | DispatchableExplainView;
     copy_payload?: undefined | V2CopyPayload;
     copy_issue?: undefined | V2CopyIssue;
-    agent_notes?: undefined | (Array<{
-    id: string;
-    author: string;
-    by: AuthorV2;
-    via_key: null | ViaKey;
-    timestamp: string;
-    updated_at: string;
-    text: string;
-    metadata: unknown;
-  }>);
     decision_records?: undefined | (Array<{
-    title: string;
-    kind: "design" | "business_rule" | "architecture" | "other";
-    action: "created" | "changed" | "deleted" | "restored";
-    made_by: "agent" | "human";
+    made_by: "human" | "agent";
+    kind: "business_rule" | "architecture" | "design" | "other";
     approved: boolean;
     impact: number;
     confidence: number;
+    title: string;
+    action: "created" | "changed" | "deleted" | "restored";
     rev: number;
     created_at: string;
     updated_at: string;
@@ -956,12 +1055,12 @@ declare module "@danxbot/card-kit@1" {
     comment_count: number;
     unread_comment_count: number;
     versions?: undefined | (Array<{
-    title: string;
-    kind: "design" | "business_rule" | "architecture" | "other";
-    action: "created" | "changed" | "deleted" | "restored";
-    made_by: "agent" | "human";
+    made_by: "human" | "agent";
+    kind: "business_rule" | "architecture" | "design" | "other";
     impact: number;
     confidence: number;
+    title: string;
+    action: "created" | "changed" | "deleted" | "restored";
     id: number;
     created_at: string;
     author: string;
@@ -988,12 +1087,12 @@ declare module "@danxbot/card-kit@1" {
   }>);
   }>);
     decision_record_versions?: undefined | (Array<{
-    title: string;
-    kind: "design" | "business_rule" | "architecture" | "other";
-    action: "created" | "changed" | "deleted" | "restored";
-    made_by: "agent" | "human";
+    made_by: "human" | "agent";
+    kind: "business_rule" | "architecture" | "design" | "other";
     impact: number;
     confidence: number;
+    title: string;
+    action: "created" | "changed" | "deleted" | "restored";
     id: number;
     created_at: string;
     author: string;
@@ -1027,48 +1126,13 @@ declare module "@danxbot/card-kit@1" {
     started_at: string;
     expires_at: string;
   }>;
-    designs?: undefined | (Array<{
-    ref_num: number;
-    design_no: number;
-    title: string;
-    created_by: string;
-    created_at: string;
-    archived_at: null | string;
-    review_state: "approved" | "awaiting_review" | "changes_requested" | "rejected";
-    revision_count: number;
-    latest_revision_no: number;
-    chosen_options: null | OptionSelection;
-    comment_count?: undefined | number;
-    unread_comment_count?: undefined | number;
-    revisions?: undefined | (Array<{
-    revision_no: number;
-    target: string;
-    design_dir: string;
-    built_from_commit: string;
-    note: string;
-    created_by: string;
-    created_by_ref: ActorRef;
-    created_at: string;
-    bundle_bytes: null | number;
-    bundle_available: boolean;
-    screenshot_available: boolean;
-    option_groups: Array<DesignOptionGroup>;
-    checklist: Array<string>;
-    browser_check: "checked" | "not_checked" | "not_recorded";
-    browser_check_note: string;
-    source_files?: undefined | Array<DesignSourceFile>;
-  }>);
-    decisions?: undefined | (Array<{
-    decision_id: number;
-    revision_no: number;
-    outcome: "approved" | "changes_requested" | "rejected";
-    note: null | string;
-    comment_id: number;
-    decided_by: string;
-    decided_by_ref: ActorRef;
-    created_at: string;
-    options: null | OptionSelection;
-  }>);
+    gate_follow_ups?: undefined | (Array<{
+    id: number;
+    label: string;
+    gate: string;
+    round: number;
+    stacked_to: null | string;
+    stacked_at: null | string;
   }>);
     pull_request_reviews?: undefined | (Array<{
     id: number;
@@ -1083,16 +1147,9 @@ declare module "@danxbot/card-kit@1" {
     occurred_at: string;
   }>);
     changed_fields?: undefined | Array<string>;
-    code_review_items?: undefined | Array<{
-    gate_name: string;
-    title: string;
-    description: string;
-    status: string;
-    reasoning: string;
-  }>;
     children_detail?: undefined | (Array<{
-    status: "Cancelled" | "Review" | "ToDo" | "In Progress" | "Backlog" | "Done";
     type: string;
+    status: "Cancelled" | "Review" | "ToDo" | "In Progress" | "Backlog" | "Done";
     priority: number;
     name: string;
     id: string;
@@ -1111,18 +1168,17 @@ declare module "@danxbot/card-kit@1" {
     name: string;
   }>;
     mirrors?: undefined | (Array<{
-    target_type: "trello" | "slack" | "asana";
+    target_type: "trello" | "slack" | "asana" | "linear";
     target_url: string;
     sync_state: "synced" | "out_of_sync" | "error" | "dead" | "unavailable" | "diverged";
     dead_reason: "" | "deleted" | "archived";
     source_ref: string;
     last_error: null | StatusReason;
-    owed: Array<"comments" | "checklists" | "attachments" | "title" | "description" | "status" | "type" | "priority" | "parent_child" | "dependencies" | "card_create" | "card_delete">;
+    owed: Array<"comments" | "checklists" | "attachments" | "description" | "type" | "title" | "status" | "priority" | "parent_child" | "dependencies" | "card_create" | "card_delete">;
     description_unreadable: boolean;
     target_ref: string;
     target_label: string;
     last_synced_at: number;
-    logo_url: string;
   }>);
     history?: undefined | (Array<{
     id: string;
@@ -1186,13 +1242,6 @@ declare module "@danxbot/card-kit@1" {
     type: "design" | "question" | "action" | "decision_review";
     open: boolean;
     ordinal: number;
-    created_at: string;
-    updated_at: string;
-    content_hash: string;
-    summary: null | string;
-    ref_num: number;
-    comment_count: number;
-    unread_comment_count: number;
     decisions: Array<{
     id: number;
     solution_id: null | number;
@@ -1208,6 +1257,13 @@ declare module "@danxbot/card-kit@1" {
     provenance: null | ProvenanceRecordV2;
     content_hash: string;
   }>;
+    created_at: string;
+    updated_at: string;
+    content_hash: string;
+    summary: null | string;
+    ref_num: number;
+    comment_count: number;
+    unread_comment_count: number;
     issue_id: string;
     feedback_consent: boolean;
     choice_locked: boolean;
@@ -1225,12 +1281,12 @@ declare module "@danxbot/card-kit@1" {
     answered_version_no: null | number;
     choices: Array<{ solution_id: number; kind: DecisionReviewChoiceKind; version_no: number; title: string; }>;
     versions?: undefined | (Array<{
-    title: string;
-    kind: "design" | "business_rule" | "architecture" | "other";
-    action: "created" | "changed" | "deleted" | "restored";
-    made_by: "agent" | "human";
+    made_by: "human" | "agent";
+    kind: "business_rule" | "architecture" | "design" | "other";
     impact: number;
     confidence: number;
+    title: string;
+    action: "created" | "changed" | "deleted" | "restored";
     id: number;
     created_at: string;
     author: string;
@@ -1500,6 +1556,7 @@ declare module "@danxbot/card-kit@1" {
       issue_id: CardId;
       ordinal: number;
       name: string;
+      quality_gate_round_id: number | null;
       created_at: string;
       updated_at: string;
       deleted_at: string | null;
@@ -1556,6 +1613,7 @@ declare module "@danxbot/card-kit@1" {
       verdict: GateRoundVerdict;
       summary: string;
       recorded_at: string;
+      decision_versions: DecisionVersionView[];
   }
   interface ProvenanceRecordV2 {
       id: number;
@@ -1708,7 +1766,7 @@ declare module "@danxbot/card-kit@1" {
   function planCardPath(planId: number, cardId: string, planSearch?: string): string;
   function planPathFromCard(planId: number, cardSearch?: string): string;
 
-  function CardLink({ id, className, onNavigate }: {
+  function CardLink({ id, className, onNavigate, }: {
       id: string;
       className?: string;
       onNavigate?: () => void;
@@ -1726,7 +1784,7 @@ declare module "@danxbot/card-kit@1" {
       card: IssueViewV2;
   }): react.JSX.Element;
 
-  function ChecklistsSection({ card, mutation }: {
+  function ChecklistsSection({ card, mutation, }: {
       card: IssueViewV2;
       mutation: CardMutation;
   }): react.JSX.Element;
@@ -1751,7 +1809,7 @@ declare module "@danxbot/card-kit@1" {
       cardId: IssueViewV2["id"];
   } & Omit<ProblemsSectionProps, "card">): react.JSX.Element;
 
-  function DependenciesSection({ card, mutation }: {
+  function DependenciesSection({ card, mutation, }: {
       card: IssueViewV2;
       mutation: CardMutation;
   }): react.JSX.Element;
@@ -1760,12 +1818,12 @@ declare module "@danxbot/card-kit@1" {
       card: IssueViewV2;
   }): react.JSX.Element;
 
-  function ParentField({ card, mutation }: {
+  function ParentField({ card, mutation, }: {
       card: IssueViewV2;
       mutation: CardMutation;
   }): react.JSX.Element;
 
-  function PlansField({ card, mutation }: {
+  function PlansField({ card, mutation, }: {
       card: IssueViewV2;
       mutation: CardMutation;
   }): react.JSX.Element;
@@ -1853,7 +1911,7 @@ declare module "@danxbot/card-kit@1" {
       onOpenDependencies?: () => void;
       assignee?: boolean;
   }
-  function WorkStateControl({ cardId, input, size, onOpenHold, onOpenDependencies, assignee }: WorkStateControlProps): react.JSX.Element | null;
+  function WorkStateControl({ cardId, input, size, onOpenHold, onOpenDependencies, assignee, }: WorkStateControlProps): react.JSX.Element | null;
 
   interface ControlProps {
       card: IssueViewV2;
@@ -1884,11 +1942,7 @@ declare module "@danxbot/card-kit@1" {
       status: CardStatusPresentation;
       list: CardFaceList | null;
       to: string;
-      parent: {
-          id: string;
-          title: string | null;
-          to: string;
-      } | null;
+      cardPath: (cardId: string) => string;
       needsHuman: {
           questions: number;
           actions: number;
@@ -1944,7 +1998,7 @@ declare module "@danxbot/card-kit@1" {
       cover?: ReactNode;
       inParentBox?: boolean;
   }
-  function CardFace({ card, renderTitle, trailing, statusMark, cover, inParentBox }: CardFaceProps): react.JSX.Element;
+  function CardFace({ card, renderTitle, trailing, statusMark, cover, }: CardFaceProps): react.JSX.Element;
 
   function CardBoard({ state, cardPath, }: {
       state: BoardLaneState;