@danxbot/plugin-sdk 0.2.28 → 0.2.31

package/dist/card-kit.d.ts

@@ -4,6 +4,15 @@ declare module "@danxbot/card-kit@1" {
   import { ReactNode } from 'react';
   export { Link, useNavigate } from 'react-router';
 
+  interface DesignOptionGroup {
+      key: string;
+      label: string;
+      options: string[];
+      multiple: boolean;
+      recommended: string[];
+  }
+  type OptionSelection = Record<string, string[]>;
+
   type CardTypeKey = string;
   interface RepoProfileCopy {
       shipped: string;
@@ -34,10 +43,11 @@ declare module "@danxbot/card-kit@1" {
       id: StatusReasonId;
       values: StatusReasonValues;
   }
+  type PacingLimit = "five_hour" | "weekly" | "spend";
 
   type IssueStatus$1 = "Review" | "ToDo" | "In Progress" | "Backlog" | "Done" | "Cancelled";
   type EffortLevelName = "min" | "very_low" | "low" | "medium" | "high" | "very_high" | "max";
-  type IssueAuthoredProblemType = "question" | "action";
+  type IssueProblemType = "question" | "action" | "design";
   type DecisionOutcome = "answered" | "rejected";
   type IssueDependencyKind = "depends_on" | "conflict_on";
   type IssueDispatchKind = "work" | "triage" | "recovery" | "flesh-out" | "chat" | "main-sync-repair" | "worktree-maintenance" | "manual" | "landing" | `gate-${string}`;
@@ -102,7 +112,6 @@ declare module "@danxbot/card-kit@1" {
       status_derived: IssueStatus$1;
       in_progress_derived: boolean;
       dispatchable_derived: boolean;
-      self_dispatchable_derived: boolean;
       triage_enabled: boolean;
       content_hash: string;
   }
@@ -117,6 +126,7 @@ declare module "@danxbot/card-kit@1" {
   type CommentRecipientV2 = {
       kind: "agent";
       by: AuthorV2;
+      reachability: CommentReachabilityV2;
   } | {
       kind: "none";
       waiting_on: {
@@ -128,9 +138,32 @@ declare module "@danxbot/card-kit@1" {
           id: string;
       };
   };
+  type CommentReachabilityV2 = {
+      state: "listening";
+  } | {
+      state: "busy";
+  } | {
+      state: "compacting";
+      since: string;
+  } | {
+      state: "listener_down";
+  } | {
+      state: "paused_by_agent";
+      reason: string;
+  } | {
+      state: "usage_limit";
+      limit: PacingLimit;
+      until: string;
+  };
+  type ReplyRecipientV2 = {
+      kind: "agent";
+      by: AuthorV2;
+  } | Extract<CommentRecipientV2, {
+      kind: "none";
+  }>;
   interface CommentReplyStateV2 {
       state: CommentReplyStateName;
-      recipient: CommentRecipientV2;
+      recipient: ReplyRecipientV2;
       reply_comment_id: number | null;
   }
   type ChecklistItemStatus$1 = "incomplete" | "failing" | "passing" | "cancelled" | "deferred";
@@ -199,6 +232,230 @@ declare module "@danxbot/card-kit@1" {
       reason: StatusReason | ProfileName | null;
   }
 
+  type ListType = "archived" | "review" | "ready" | "in_progress" | "completed" | "cancelled";
+
+  interface SolutionContent {
+      title: string;
+      body: string;
+      pro: string;
+      con: string;
+      recommended: boolean;
+  }
+
+  interface V2CopyComment {
+      author: string;
+      text: string;
+      metadata: unknown | null;
+      answers_decision: V2CopyDecisionRef | null;
+      tags: V2CopyCommentTag[];
+      team_agent: string | null;
+      author_email: string | null;
+      created_at: string;
+      updated_at: string;
+  }
+  interface V2CopyDecisionRef {
+      problem: number;
+      decision: number;
+  }
+  type V2CopyCommentTag = {
+      kind: "problem";
+      index: number;
+  } | {
+      kind: "design";
+      index: number;
+  };
+  interface V2CopyBlobRef {
+      sha256: string;
+      size: number;
+  }
+  interface V2CopyAttachment {
+      filename: string;
+      primary: boolean;
+      created_at: string;
+      updated_at: string;
+      blob: V2CopyBlobRef;
+  }
+  interface V2CopyDesignRevision {
+      revision_no: number;
+      target: string;
+      design_dir: string;
+      source_files: {
+          path: string;
+          content: string;
+      }[];
+      option_groups: DesignOptionGroup[];
+      built_from_commit: string;
+      note: string;
+      created_by: string;
+      created_at: string;
+      bundle: {
+          blob: V2CopyBlobRef;
+      } | null;
+      screenshot: {
+          blob: V2CopyBlobRef;
+      } | null;
+  }
+  interface V2CopyDesignDecision {
+      revision_no: number;
+      outcome: DesignDecisionOutcome;
+      note: string | null;
+      decided_by: string;
+      created_at: string;
+      retracted_at: string | null;
+      options: OptionSelection | null;
+  }
+  interface V2CopyDesign {
+      design_no: number;
+      title: string;
+      created_by: string;
+      created_at: string;
+      revisions: V2CopyDesignRevision[];
+      decisions: V2CopyDesignDecision[];
+  }
+  interface V2CopyControlOverride {
+      key: string;
+      value: unknown;
+  }
+  interface V2CopyAgentNote {
+      author: string;
+      text: string;
+      team_agent: string | null;
+      metadata: Record<string, unknown> | null;
+      ordinal: number;
+      created_at: string;
+      updated_at: string;
+  }
+  interface V2CopyAc {
+      title: string;
+      checked: boolean;
+  }
+  interface V2CopyChecklist {
+      name: string;
+      items: V2CopyChecklistItem[];
+  }
+  interface V2CopyChecklistItem {
+      label: string;
+      detail: string;
+      status: ChecklistItemStatus$1;
+  }
+  interface V2CopyDependency {
+      kind: IssueDependencyKind;
+      target_id: string;
+      reason: string;
+  }
+  interface V2CopyRetro {
+      good: string;
+      bad: string;
+      correctable_danxbot_problem: boolean;
+      correctable_danxbot_problem_description: string;
+      action_item_ids: string[];
+      commits: {
+          sha: string;
+          subject: string;
+      }[];
+      tests: V2CopyRetroTest[];
+  }
+  interface V2CopyRetroTest {
+      name: string;
+      kind: "group" | "e2e";
+      num_tests: number;
+      num_assertions: number | null;
+      num_passing_tests: number;
+      num_passing_assertions: number | null;
+      duration_ms: number;
+  }
+  interface V2CopyMirror {
+      target_type: MirrorProviderId;
+      target_ref: string;
+      target_url: string;
+      source_ref: string;
+  }
+  type SourceMirrorLocation = Record<MirrorProviderId, string | null>;
+  interface V2CopyQualityGate {
+      gate: string;
+      decision_note: string;
+      effort_level: EffortLevelName | null;
+      status: QualityGateStatus;
+      message: string;
+      completed_at: string | null;
+      attempts: number;
+      reviewed_ref: string | null;
+      decided_by: string | null;
+      owed: boolean;
+  }
+  interface V2CopySolution extends SolutionContent {
+      removed: boolean;
+      design_index: number | null;
+      steps: V2CopyStep[];
+  }
+  interface V2CopyStep {
+      title: string;
+      description: string | null;
+      steps: V2CopyStep[];
+  }
+  interface V2CopyDecision {
+      solution_index: number | null;
+      outcome: DecisionOutcome;
+      freeform: string | null;
+      note: string | null;
+      decided_by: string;
+      decided_at: string;
+      retracted_at: string | null;
+  }
+  interface V2CopyProblem {
+      statement: string;
+      context: string | null;
+      type: IssueProblemType;
+      summary: string | null;
+      design_element: string | null;
+      removed: boolean;
+      solutions: V2CopySolution[];
+      decisions: V2CopyDecision[];
+  }
+  interface V2CopyIssue {
+      id: string;
+      parent_id: string | null;
+      type: CardTypeKey;
+      title: string;
+      description: string;
+      summary: string | null;
+      priority: number;
+      effort_level: EffortLevelName | null;
+      assigned_agent: string | null;
+      ready_at: string | null;
+      completed_at: string | null;
+      cancelled_at: string | null;
+      archived_at: string | null;
+      blocked_at: string | null;
+      blocked_reason: string | null;
+      ac: V2CopyAc[];
+      checklists: V2CopyChecklist[];
+      comments: V2CopyComment[];
+      agent_notes: V2CopyAgentNote[];
+      dependencies: V2CopyDependency[];
+      retro: V2CopyRetro | null;
+      mirrors: V2CopyMirror[];
+      quality_gates: V2CopyQualityGate[];
+      problems: V2CopyProblem[];
+      triage_enabled: boolean;
+      attachments: V2CopyAttachment[];
+      designs: V2CopyDesign[];
+      list_name: string | null;
+      list_type: ListType | null;
+      control_overrides: V2CopyControlOverride[];
+      unknown_fields: V2CopyUnknownField[];
+  }
+  interface V2CopyUnknownField {
+      path: string;
+      value: unknown;
+  }
+  interface V2CopyPayload {
+      schema_version: number;
+      issues: V2CopyIssue[];
+      source_mirror_location: SourceMirrorLocation;
+      blobs: Record<string, string>;
+  }
+
   interface HolderAgentPause {
       reason: string;
       since: string;
@@ -247,6 +504,14 @@ declare module "@danxbot/card-kit@1" {
       linesAdded: number;
       linesRemoved: number;
   }
+  interface UsageActivity {
+      activeMinutes: number;
+      agentMinutes: number;
+      tokens: number;
+      costUsd: number;
+      tokensPerMinute: number;
+      measuredSince: number;
+  }
   interface UsageSummary {
       totals: UsageTotals;
       costUsd: number;
@@ -257,6 +522,7 @@ declare module "@danxbot/card-kit@1" {
       operatorAttributionSince: number | null;
       timing: UsageTiming;
       timingMeasuredSince: number | null;
+      activity: UsageActivity | null;
   }
   type UsageErrorCode = "unattributable_dispatch" | "usage_inconsistent";
   interface UsageError {
@@ -339,7 +605,7 @@ declare module "@danxbot/card-kit@1" {
       detail: string;
   }
 
-  type PickerRouting = "gate" | "work" | "orchestrated" | "skip" | "terminal_or_container";
+  type PickerRouting = "gate" | "queued" | "not_queued" | "skip" | "terminal_or_container";
   interface DispatchableExplainView {
       id: string;
       dispatchable: boolean;
@@ -359,148 +625,6 @@ declare module "@danxbot/card-kit@1" {
       agent_wait: StatusReason | null;
   }
 
-  interface SolutionContent {
-      title: string;
-      body: string;
-      pro: string;
-      con: string;
-      recommended: boolean;
-  }
-
-  interface V2CopyComment {
-      author: string;
-      text: string;
-  }
-  interface V2CopyAgentNote {
-      author: string;
-      text: string;
-      metadata: Record<string, unknown> | null;
-      ordinal: number;
-      created_at: string;
-      updated_at: string;
-  }
-  interface V2CopyAc {
-      title: string;
-      checked: boolean;
-  }
-  interface V2CopyChecklist {
-      name: string;
-      items: V2CopyChecklistItem[];
-  }
-  interface V2CopyChecklistItem {
-      label: string;
-      detail: string;
-      status: ChecklistItemStatus$1;
-  }
-  interface V2CopyDependency {
-      kind: IssueDependencyKind;
-      target_id: string;
-      reason: string;
-  }
-  interface V2CopyRetro {
-      good: string;
-      bad: string;
-      correctable_danxbot_problem: boolean;
-      correctable_danxbot_problem_description: string;
-      action_item_ids: string[];
-      commits: {
-          sha: string;
-          subject: string;
-      }[];
-      tests: V2CopyRetroTest[];
-  }
-  interface V2CopyRetroTest {
-      name: string;
-      kind: "group" | "e2e";
-      num_tests: number;
-      num_assertions: number | null;
-      num_passing_tests: number;
-      num_passing_assertions: number | null;
-      duration_ms: number;
-  }
-  interface V2CopyMirror {
-      target_type: MirrorProviderId;
-      target_ref: string;
-      target_url: string;
-      source_ref: string;
-  }
-  type SourceMirrorLocation = Record<MirrorProviderId, string | null>;
-  interface V2CopyQualityGate {
-      gate: string;
-      decision_note: string;
-      effort_level: EffortLevelName | null;
-      status: QualityGateStatus;
-      message: string;
-      completed_at: string | null;
-      attempts: number;
-      reviewed_ref: string | null;
-      decided_by: string | null;
-  }
-  interface V2CopySolution extends SolutionContent {
-      removed: boolean;
-      steps: V2CopyStep[];
-  }
-  interface V2CopyStep {
-      title: string;
-      description: string | null;
-      steps: V2CopyStep[];
-  }
-  interface V2CopyDecision {
-      solution_index: number | null;
-      outcome: DecisionOutcome;
-      freeform: string | null;
-      note: string | null;
-      decided_by: string;
-      decided_at: string;
-      retracted_at: string | null;
-  }
-  interface V2CopyProblem {
-      statement: string;
-      context: string | null;
-      type: IssueAuthoredProblemType;
-      summary: string | null;
-      removed: boolean;
-      solutions: V2CopySolution[];
-      decisions: V2CopyDecision[];
-  }
-  interface V2CopyIssue {
-      id: string;
-      parent_id: string | null;
-      type: CardTypeKey;
-      title: string;
-      description: string;
-      summary: string | null;
-      priority: number;
-      effort_level: EffortLevelName | null;
-      assigned_agent: string | null;
-      ready_at: string | null;
-      completed_at: string | null;
-      cancelled_at: string | null;
-      archived_at: string | null;
-      blocked_at: string | null;
-      blocked_reason: string | null;
-      ac: V2CopyAc[];
-      checklists: V2CopyChecklist[];
-      comments: V2CopyComment[];
-      agent_notes: V2CopyAgentNote[];
-      dependencies: V2CopyDependency[];
-      retro: V2CopyRetro | null;
-      mirrors: V2CopyMirror[];
-      quality_gates: V2CopyQualityGate[];
-      problems: V2CopyProblem[];
-      triage_enabled: boolean;
-      unknown_fields: V2CopyUnknownField[];
-  }
-  interface V2CopyUnknownField {
-      path: string;
-      value: unknown;
-  }
-  interface V2CopyPayload {
-      schema_version: number;
-      issues: V2CopyIssue[];
-      source_mirror_location: SourceMirrorLocation;
-  }
-
   type IssueStatus = "Review" | "ToDo" | "In Progress" | "Backlog" | "Done" | "Cancelled";
   interface InheritedBlockedViewV2 {
       id: string;
@@ -590,6 +714,7 @@ declare module "@danxbot/card-kit@1" {
       name: string;
       items: ChecklistItemView[];
   }
+  type DesignDecisionOutcome = "rejected" | "changes_requested" | "approved";
   interface ChecklistHistoryViewV2 {
       action: "create" | "rename" | "remove" | "add_item" | "update_item" | "remove_item";
       checklist: string;
@@ -720,6 +845,7 @@ declare module "@danxbot/card-kit@1" {
     ac_items?: undefined | (Array<{ title: string; status: "incomplete" | "failing" | "passing" | "cancelled" | "deferred"; }>);
     comments_count?: undefined | number;
     agent_notes_count?: undefined | number;
+    comment_recipient?: undefined | { kind: "agent"; by: AuthorV2; reachability: CommentReachabilityV2; } | { kind: "none"; waiting_on: { kind: "plan"; id: number; name: string; } | { kind: "card"; id: string; }; };
     has_retro?: undefined | false | true;
     primary_attachment?: undefined | null | AttachmentPreviewV2;
     in_progress_derived?: undefined | false | true;
@@ -758,6 +884,7 @@ declare module "@danxbot/card-kit@1" {
     review_state: "rejected" | "awaiting_review" | "changes_requested" | "approved";
     revision_count: number;
     latest_revision_no: number;
+    chosen_options: null | OptionSelection;
     revisions?: undefined | (Array<{
     revision_no: number;
     target: string;
@@ -770,6 +897,7 @@ declare module "@danxbot/card-kit@1" {
     bundle_bytes: null | number;
     bundle_available: boolean;
     screenshot_available: boolean;
+    option_groups: Array<DesignOptionGroup>;
     source_files?: undefined | Array<DesignSourceFile>;
   }>);
     decisions?: undefined | (Array<{
@@ -780,6 +908,7 @@ declare module "@danxbot/card-kit@1" {
     decided_by: string;
     decided_by_ref: ActorRef;
     created_at: string;
+    options: null | OptionSelection;
   }>);
   }>);
     pull_request_reviews?: undefined | (Array<{
@@ -915,9 +1044,11 @@ declare module "@danxbot/card-kit@1" {
     feedback_consent: boolean;
     choice_locked: boolean;
     comment_count: number;
+    needs_person: boolean;
     issue_id: string;
     statement: string;
     context: null | string;
+    design_element: null | string;
     solutions: Array<SolutionViewV2>;
   };
   type SolutionViewV2 = {
@@ -952,6 +1083,7 @@ declare module "@danxbot/card-kit@1" {
     review_state: "rejected" | "awaiting_review" | "changes_requested" | "approved";
     revision_count: number;
     latest_revision_no: number;
+    chosen_options: null | OptionSelection;
     revisions?: undefined | (Array<{
     revision_no: number;
     target: string;
@@ -964,6 +1096,7 @@ declare module "@danxbot/card-kit@1" {
     bundle_bytes: null | number;
     bundle_available: boolean;
     screenshot_available: boolean;
+    option_groups: Array<DesignOptionGroup>;
     source_files?: undefined | Array<DesignSourceFile>;
   }>);
     decisions?: undefined | (Array<{
@@ -974,6 +1107,7 @@ declare module "@danxbot/card-kit@1" {
     decided_by: string;
     decided_by_ref: ActorRef;
     created_at: string;
+    options: null | OptionSelection;
   }>);
   }>);
   };

package/dist/cli.js

@@ -5891,7 +5891,7 @@ var CARD_KIT_LIBRARY = "@danxbot/card-kit";
 var PLUGIN_RUNTIME_LIBRARIES = [
   { name: "react", major: 19 },
   { name: "react-dom", major: 19 },
-  { name: "@danxbot/ui", major: 27 },
+  { name: "@danxbot/ui", major: 28 },
   { name: CARD_KIT_LIBRARY, major: CARD_KIT_MAJOR }
 ];
 var PLUGIN_RUNTIME_SPECIFIERS = [

package/dist/publish.js

@@ -5886,7 +5886,7 @@ var CARD_KIT_LIBRARY = "@danxbot/card-kit";
 var PLUGIN_RUNTIME_LIBRARIES = [
   { name: "react", major: 19 },
   { name: "react-dom", major: 19 },
-  { name: "@danxbot/ui", major: 27 },
+  { name: "@danxbot/ui", major: 28 },
   { name: CARD_KIT_LIBRARY, major: CARD_KIT_MAJOR }
 ];
 var PLUGIN_RUNTIME_SPECIFIERS = [

package/dist/vite.js

@@ -4,7 +4,7 @@ var CARD_KIT_LIBRARY = "@danxbot/card-kit";
 var PLUGIN_RUNTIME_LIBRARIES = [
   { name: "react", major: 19 },
   { name: "react-dom", major: 19 },
-  { name: "@danxbot/ui", major: 27 },
+  { name: "@danxbot/ui", major: 28 },
   { name: CARD_KIT_LIBRARY, major: CARD_KIT_MAJOR }
 ];
 var PLUGIN_RUNTIME_SPECIFIERS = [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danxbot/plugin-sdk",
-  "version": "0.2.28",
+  "version": "0.2.31",
   "description": "SDK for building 50 Arms card-type plugins (DX-5170): the card kit's type declarations, a Vite preset that builds a plugin against the app's shared runtime and writes its manifest, and the danx-plugin CLI.",
   "license": "MIT",
   "type": "module",
@@ -33,7 +33,7 @@
     "node": ">=20"
   },
   "peerDependencies": {
-    "@danxbot/ui": "^27.0.0",
+    "@danxbot/ui": "^28.0.0",
     "@types/react": "^19.0.0",
     "react": "^19.0.0",
     "react-router": "^7.0.0",
@@ -46,7 +46,7 @@
     "test": "vitest run"
   },
   "devDependencies": {
-    "@danxbot/ui": "27.46.0",
+    "@danxbot/ui": "28.0.0",
     "@types/node": "^22.0.0",
     "@types/react": "^19.2.2",
     "esbuild": "^0.25.0",