@50arms/plugin-sdk 0.0.0-stage → 0.2.53

package/dist/card-kit.d.ts

@@ -0,0 +1,1942 @@
+declare module "@danxbot/card-kit@1" {
+  import { PagedWindow, SortValue } from '@50arms/ui';
+  import * as react from 'react';
+  import { ReactNode } from 'react';
+  export { Link, useNavigate } from 'react-router';
+
+  const BOARD_ID: unique symbol;
+  const CARD_ID: unique symbol;
+  type BoardId = number & {
+      readonly [BOARD_ID]: true;
+  };
+  type CardId = number & {
+      readonly [CARD_ID]: true;
+  };
+  type CardRef = string;
+  const BOARD_REF_NUM: unique symbol;
+  const PLAN_REF_NUM: unique symbol;
+  type BoardRefNum = number & {
+      readonly [BOARD_REF_NUM]: true;
+  };
+  type PlanRefNum = number & {
+      readonly [PLAN_REF_NUM]: true;
+  };
+
+  interface ViaKey {
+      id: number;
+      name: string;
+  }
+
+  type CardTypeKey = string;
+  type MirrorProviderId = "trello" | "slack" | "asana";
+  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;
+  }
+  type StatusReasonId = string;
+  type StatusReasonValues = Record<string, string | number | boolean | null | StatusReason | ProfileNameMessage | StatusReasonSentences | StatusReasonLines | StatusReasonList>;
+  interface ProfileNameMessage {
+      id: ProfileNameId;
+      values: StatusReasonValues;
+  }
+  type StatusReasonList = ListValue<string | number | StatusReason | ProfileNameMessage>;
+  interface StatusReasonLines {
+      lines: StatusReason[];
+  }
+  interface StatusReasonSentences {
+      sentences: StatusReason[];
+  }
+  interface StatusReason {
+      id: StatusReasonId;
+      values: StatusReasonValues;
+  }
+  type PacingLimit = "five_hour" | "weekly" | "spend";
+  type ProvenanceSourceKind = "card" | "comment" | "session_thread" | "problem" | "url";
+  type ProvenancePartyKind = "person" | "agent";
+  type ResourceType = "plan" | "problem" | "issue" | "plan_record" | "plan_section" | "design" | "decision";
+  interface ResourceRef {
+      type: ResourceType;
+      id: string;
+  }
+  type RiskScore = "R0" | "R1" | "R2" | "R3" | "R4";
+
+  type IssueStatus$1 = "Review" | "ToDo" | "In Progress" | "Backlog" | "Done" | "Cancelled";
+  type EffortLevelName = "min" | "very_low" | "low" | "medium" | "high" | "very_high" | "max";
+  type IssueProblemType = "design" | "question" | "action" | "decision_review";
+  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}`;
+  type IssueAssignmentMode = "automated" | "manual";
+  type StartCommitError = "no_repo" | "not_github_repo" | "no_token" | "github_refused" | "github_unreachable" | "unreadable_tip" | "unexpected";
+  interface IssueV2 {
+      id: CardId;
+      ref: CardRef;
+      rev: number;
+      board_id: BoardId;
+      schema_version: number;
+      type: CardTypeKey;
+      title: string;
+      description: string;
+      summary: string | null;
+      pull_request_url: string | null;
+      risk_score: RiskScore | null;
+      risk_reason: string | null;
+      risk_raise_reason: string | null;
+      start_commit_sha: string | null;
+      start_commit_at: string | null;
+      start_commit_error: StartCommitError | null;
+      start_commit_error_detail: string | null;
+      parent_id: CardId | null;
+      parent_ref: CardRef | null;
+      effort_level: EffortLevelName;
+      downward_rung: EffortLevelName | null;
+      source_type: string;
+      list_id: string | null;
+      assigned_agent: string | null;
+      priority: number;
+      created_at: string;
+      updated_at: string;
+      deleted_at: string | null;
+      ready_at: string | null;
+      started_at: string | null;
+      completed_at: string | null;
+      cancelled_at: string | null;
+      archived_at: string | null;
+      wake_at: string | null;
+      wake_action: "ready" | "review" | null;
+      dispatch_id: string | null;
+      dispatch_started_at: string | null;
+      dispatch_kind: IssueDispatchKind | null;
+      assignment_mode: IssueAssignmentMode;
+      card_branch: string | null;
+      last_commit_sha: string | null;
+      card_branch_retired_at: string | null;
+      card_branch_retired_reason: string | null;
+      card_branch_retired_by: string | null;
+      chat_session_uuid: string | null;
+      slack_session_uuid: string | null;
+      blocked_at: string | null;
+      blocked_reason: string | null;
+      blocked_by: string | null;
+      blocked_via_key_id: number | null;
+      blocked_via_key_name: string | null;
+      blocked_team_agent_id: number | null;
+      open_problem_count: number;
+      triage_ice_total: number | null;
+      triage_ice_i: number | null;
+      triage_ice_c: number | null;
+      triage_ice_e: number | null;
+      triage_confidence: number | null;
+      triage_last_status: string;
+      triage_last_explain: string;
+      terminal_derived: boolean;
+      in_progress_derived: boolean;
+      dispatchable_derived: boolean;
+      triage_enabled: boolean;
+      content_hash: string;
+  }
+  interface IssueDisplayV2 extends IssueV2 {
+      status_derived: IssueStatus$1;
+  }
+  interface CommentResourceTag {
+      tag: string;
+      resource_type: ResourceType | null;
+      resource_id: string | null;
+  }
+  interface AuthorV2 {
+      name: string;
+      kind: "agent" | "person";
+      avatar_url: string | null;
+      reason: StatusReason | null;
+      team_agent_id: number | null;
+  }
+  type CommentReplyStateName = "sent" | "seen" | "responded";
+  type CommentRecipientV2 = {
+      kind: "agent";
+      by: AuthorV2;
+      reachability: CommentReachabilityV2;
+  } | {
+      kind: "none";
+      waiting_on: {
+          kind: "plan";
+          id: PlanRefNum;
+          ref: string;
+          name: string;
+      } | {
+          kind: "card";
+          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: ReplyRecipientV2;
+      reply_comment_id: number | null;
+  }
+  type ChecklistItemStatus$1 = "incomplete" | "failing" | "passing" | "cancelled" | "deferred";
+  interface ChecklistV2 {
+      id: number;
+      issue_id: CardId;
+      ordinal: number;
+      name: string;
+      created_at: string;
+      updated_at: string;
+      deleted_at: string | null;
+  }
+  interface ChecklistItemV2 {
+      id: number;
+      checklist_id: number;
+      ordinal: number;
+      label: string;
+      detail: string;
+      status: ChecklistItemStatus$1;
+      created_at: string;
+      updated_at: string;
+      deleted_at: string | null;
+  }
+  interface ChecklistWithItemsV2 extends ChecklistV2 {
+      items: ChecklistItemV2[];
+  }
+  type ThumbnailStatus = "ready" | "not_image" | "failed" | "pending";
+  interface IssueAttachmentV2 {
+      id: number;
+      issue_id: CardId;
+      source_type: string;
+      external_id: string;
+      url: string;
+      filename: string;
+      mime: string;
+      is_primary: boolean;
+      thumbnail_status: ThumbnailStatus;
+      thumbnail_url: string | null;
+      thumbnail_error: string | null;
+      created_at: string;
+      updated_at: string;
+      deleted_at: string | null;
+  }
+  type QualityGateStatus = "pending" | "pass" | "fail" | "skipped";
+  type GateRoundReviewerKind = "session" | "dispatch" | "person";
+  type GateRoundVerdict = "pass" | "fail" | "retry" | "skipped";
+  interface GateRoundV2 {
+      id: number;
+      number: number;
+      reviewed_ref: string | null;
+      reviewer_kind: GateRoundReviewerKind;
+      reviewer_name: string;
+      by: AuthorV2;
+      via_key: {
+          id: number;
+          name: string;
+      } | null;
+      reviewer_dispatch_id: string | null;
+      review_grade: EffortLevelName | null;
+      model: string | null;
+      effort: string | null;
+      verdict: GateRoundVerdict;
+      summary: string;
+      recorded_at: string;
+  }
+  interface ProvenanceRecordV2 {
+      id: number;
+      quote: string | null;
+      reasoning: string | null;
+      source: ProvenanceSourceV2 | null;
+      recorded_by: AuthorV2;
+      recorded_at: string;
+  }
+  interface ProvenanceSourceV2 {
+      kind: ProvenanceSourceKind;
+      ref: string;
+      card_id: CardRef | null;
+      author: AuthorV2 | null;
+      at: string | null;
+  }
+
+  type QualityGatePhase = "plan" | "code";
+  type ControlValue = boolean | string;
+  type WorkMarkResourceType = "plan" | "problem" | "issue" | "plan_record" | "plan_section" | "design" | "decision";
+  interface WorkMarkResource extends ResourceRef {
+      type: WorkMarkResourceType;
+  }
+
+  type ControlSource = "card" | "plan" | "board" | "team" | "system";
+  interface ControlFallback {
+      readonly value: ControlValue;
+      readonly source: Exclude<ControlSource, "card">;
+  }
+
+  type ActorKind = "person" | "system" | "dispatch_agent" | "worker" | "agent_profile" | "plan_session" | "unresolved";
+  interface ActorRef {
+      kind: ActorKind;
+      name: string;
+      reason: StatusReason | ProfileName | null;
+  }
+
+  type DocsPromotionStatus = "running" | "drafted" | "failed" | "landing" | "landed" | "superseded" | "waiting";
+
+  type DocsLandStage = "direct" | "resolving" | "needs_person" | "pull_request";
+
+  type DocsLandWorker = {
+      kind: "dispatch";
+      dispatch_id: string;
+  } | {
+      kind: "session";
+      session_id: string;
+      plan_id: PlanRefNum;
+  };
+  interface DocsLandWire {
+      land_stage: DocsLandStage | null;
+      land_conflict_files: string[] | null;
+      land_reason: string | null;
+      land_worker: DocsLandWorker | null;
+      land_problem_ref_num: number | null;
+      land_pull_request_url: string | null;
+  }
+
+  interface DocsReviewView extends DocsLandWire {
+      plan_id: PlanRefNum;
+      repo_name: string;
+      attempt: number;
+      status: DocsPromotionStatus;
+      summary: string;
+      head_sha: string;
+      change_counts: {
+          added: number;
+          changed: number;
+          removed: number;
+      } | null;
+      landed_sha: string | null;
+      failure_reason: string | null;
+      waiting_board_id: BoardRefNum | null;
+      approve_solution_id: number;
+      withdraw_solution_id: number;
+      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";
+
+  interface DesignOptionGroup {
+      key: string;
+      label: string;
+      options: string[];
+      multiple: boolean;
+      recommended: string[];
+  }
+  type OptionSelection = Record<string, string[]>;
+
+  interface SolutionContent {
+      title: string;
+      body: string;
+      pro: string;
+      con: string;
+      recommended: boolean;
+  }
+  type DecisionReviewChoiceKind = "accept" | "revert" | "restore" | "reject";
+
+  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;
+  } | {
+      kind: "decision";
+      index: number;
+  } | {
+      kind: "label";
+      text: string;
+  };
+  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[];
+      checklist: string[];
+      browser_check: BrowserCheckStatus;
+      browser_check_note: string;
+      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 {
+      ref_num: number;
+      design_no: number;
+      title: string;
+      created_by: string;
+      created_at: string;
+      archived_at: string | null;
+      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 V2CopyDecisionApproval {
+      action: DecisionApprovalAction;
+      by_email: string | null;
+      by_name: string;
+      at: string;
+  }
+  interface V2CopyDecisionVersion {
+      version_no: number;
+      action: DecisionRecordAction;
+      title: string;
+      text: string;
+      kind: DecisionRecordKind;
+      impact: number;
+      confidence: number;
+      made_by: DecisionMadeBy;
+      made_by_email: string | null;
+      made_by_name: string | null;
+      made_by_team_agent: string | null;
+      provenance: V2CopyProvenanceRecord[];
+      author: string;
+      team_agent: string | null;
+      created_at: string;
+      approvals: V2CopyDecisionApproval[];
+  }
+  interface V2CopyDecisionRecord {
+      ref_num: number;
+      versions: V2CopyDecisionVersion[];
+  }
+  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;
+      status: QualityGateStatus;
+      message: string;
+      completed_at: string | null;
+      budget_started_at: string;
+      rounds: V2CopyGateRound[];
+      reviewed_ref: string | null;
+      decided_by: string | null;
+      owed: boolean;
+  }
+  type V2CopyGateRound = Omit<GateRoundV2, "id" | "by" | "via_key">;
+  interface V2CopySolution extends SolutionContent {
+      removed: boolean;
+      design_index: number | null;
+      decision_choice: V2CopyDecisionChoice | null;
+      steps: V2CopyStep[];
+  }
+  interface V2CopyDecisionChoice {
+      kind: DecisionReviewChoiceKind;
+      version_no: number;
+  }
+  interface V2CopyDecisionReview {
+      record_index: number;
+      answered_version_no: number | null;
+  }
+  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;
+      provenance: V2CopyProvenanceRecord | null;
+  }
+  interface V2CopyProvenanceParty {
+      kind: ProvenancePartyKind;
+      email: string | null;
+      team_agent: string | null;
+      name: string;
+  }
+  interface V2CopyProvenanceSource {
+      kind: ProvenanceSourceKind;
+      ref: string;
+      comment_index: number | null;
+      problem_index: number | null;
+      card_linked: boolean;
+      author: V2CopyProvenanceParty | null;
+      at: string | null;
+  }
+  interface V2CopyProvenanceRecord {
+      quote: string | null;
+      reasoning: string | null;
+      source: V2CopyProvenanceSource | null;
+      recorded_by: V2CopyProvenanceParty;
+      recorded_at: string;
+  }
+  interface V2CopyProblem {
+      ref_num: number;
+      statement: string;
+      context: string | null;
+      type: IssueProblemType;
+      summary: string | null;
+      design_element: string | null;
+      decision_review: V2CopyDecisionReview | 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[];
+      decision_records: V2CopyDecisionRecord[];
+      created_tags: V2CopyCommentTag[];
+      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;
+      until: string;
+  }
+
+  interface AgentIdentity {
+      id: number;
+      name: string;
+      avatar_url: string | null;
+  }
+  type AssignedAgentKind = "person" | "session" | "worker" | "label";
+
+  interface UsageTokenCounts {
+      input: number;
+      output: number;
+      cacheRead: number;
+      cacheWrite: number;
+  }
+  interface UsageSlice {
+      tokens: UsageTokenCounts;
+      costUsd: number;
+  }
+  interface UsageTotals extends UsageTokenCounts {
+      cacheWrite5m: number;
+      cacheWrite1h: number;
+      cacheWriteUnsplit: number;
+  }
+  interface UsageModelRow extends UsageSlice {
+      model: string | null;
+  }
+  type UsageKind = "work" | "operator-session" | `gate:${string}` | "triage" | "maintenance" | "chat" | "other";
+  interface UsageKindRow extends UsageSlice {
+      kind: UsageKind;
+      label: string;
+  }
+  type UsageSubagentTypeKey = "main" | "unknown" | "unattributed" | `agent:${string}`;
+  interface UsageSubagentTypeRow extends UsageSlice {
+      key: UsageSubagentTypeKey;
+      label: string;
+      sourceCount: number;
+  }
+  interface UsageTiming {
+      apiMs: number;
+      agentMs: number;
+      linesAdded: number;
+      linesRemoved: number;
+  }
+  interface UsageActivity {
+      activeMinutes: number;
+      agentMinutes: number;
+      tokens: number;
+      costUsd: number;
+      tokensPerMinute: number;
+      measuredSince: number;
+  }
+  interface UsageSummary {
+      totals: UsageTotals;
+      costUsd: number;
+      byModel: UsageModelRow[];
+      byKind: UsageKindRow[];
+      bySubagentType: UsageSubagentTypeRow[];
+      dispatchCount: number;
+      operatorAttributionSince: number | null;
+      timing: UsageTiming;
+      timingMeasuredSince: number | null;
+      activity: UsageActivity | null;
+  }
+  type UsageErrorCode = "unattributable_dispatch" | "usage_inconsistent";
+  interface UsageError {
+      error: {
+          code: UsageErrorCode;
+          message: string;
+          dispatchId: string;
+      };
+  }
+  type CardUsage = UsageSummary | UsageError | null;
+  interface DesignSourceFile {
+      path: string;
+      content: string;
+  }
+
+  interface CommentTagOption extends CommentResourceTag {
+      name: string | null;
+      card_id: CardRef | null;
+  }
+  interface RelationPageView {
+      readonly limit: number;
+      readonly total: number;
+      readonly next_cursor: string | null;
+  }
+
+  interface DescendantNeedsYouView {
+      readonly card_id: CardRef;
+      readonly card_title: string;
+      readonly card_status: string;
+      readonly problems: readonly {
+          readonly ref_num: number;
+          readonly type: IssueProblemType;
+          readonly statement: string;
+          readonly created_at: string;
+      }[];
+  }
+
+  interface ReadinessBlocker {
+      worker_id: string;
+      incomplete_count: number;
+      items: {
+          id: string;
+          label: string;
+          label_message: StatusReason;
+          reason: string;
+          reason_message: StatusReason;
+          status: string;
+      }[];
+  }
+
+  type DispatchKeyRefusal = {
+      reason: "role_exceeds_owner";
+      missingPermissions: readonly string[];
+  } | {
+      reason: "owner_terms_not_accepted";
+  } | {
+      reason: "owner_not_member";
+  } | {
+      reason: "profile_role_missing";
+  };
+
+  interface DispatchKeyBlocker {
+      worker_id: string;
+      owner_user_id: number;
+      owner_username: string;
+      reason: DispatchKeyRefusal["reason"];
+      detail: string;
+  }
+
+  type PreGateHold = {
+      kind: "awaiting_person";
+  } | {
+      kind: "repo_designs_setting_up";
+      plan: {
+          id: number;
+          name: string;
+      };
+  } | {
+      kind: "repo_designs_off";
+  } | {
+      kind: "board_needs_repo";
+  } | {
+      kind: "decided_by_person";
+      gate: string;
+      decided_by: string;
+  };
+
+  type PickerRouting = "gate" | "queued" | "not_queued" | "skip" | "terminal_or_container";
+  interface DispatchableExplainView {
+      id: CardRef;
+      dispatchable: boolean;
+      self_dispatchable: boolean;
+      ancestor_blocked: boolean;
+      next_pre_gate: string | null;
+      pre_gate_hold: PreGateHold | null;
+      pre_gate_hold_reason: StatusReason | null;
+      blocking_gates: {
+          gate: string;
+          detail: string;
+      }[];
+      picker_routing: PickerRouting;
+      dispatch_key_blockers: DispatchKeyBlocker[];
+      worker_readiness_blockers: ReadinessBlocker[];
+      agent_wait: StatusReason | null;
+  }
+  interface BuildGradeView {
+      readonly grade: string;
+      readonly model: string;
+      readonly effort: string;
+  }
+
+  type IssueStatus = "Review" | "ToDo" | "In Progress" | "Backlog" | "Done" | "Cancelled";
+  interface InheritedBlockedViewV2 {
+      id: string;
+      reason: string;
+  }
+  interface WaitingOnViewV2 {
+      by: string[];
+      reason: string;
+      timestamp: string;
+  }
+  interface DependencyPullRequestViewV2 {
+      pull_request_url: string;
+      merged: boolean;
+      holding: boolean;
+      branch: string | null;
+  }
+  interface ConflictEntryViewV2 {
+      id: string;
+      reason: string;
+  }
+  interface IceViewV2 {
+      total: number | null;
+      i: number | null;
+      c: number | null;
+      e: number | null;
+  }
+  interface TriageHistoryEntryViewV2 {
+      timestamp: string;
+      status: string;
+      explain: string;
+      ice: IceViewV2;
+      confidence: number | null;
+  }
+  interface TriageViewV2 {
+      last_status: string;
+      last_explain: string;
+      ice: IceViewV2;
+      confidence: number | null;
+      history: TriageHistoryEntryViewV2[];
+  }
+  interface RetroTestViewV2 {
+      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 RetroViewV2 {
+      good: string;
+      bad: string;
+      correctable_danxbot_problem: boolean;
+      correctable_danxbot_problem_description: string;
+      action_item_ids: string[];
+      commits: string[];
+      tests: RetroTestViewV2[];
+      commit_url_base?: string | null;
+  }
+  interface AttachmentViewV2 {
+      id: number;
+      source: SourceOrigin;
+      url: string;
+      filename: string;
+      mime: string;
+      is_primary: boolean;
+      thumbnail_status: ThumbnailStatus;
+      thumbnail_url: string | null;
+      thumbnail_error: string | null;
+      created_at: string;
+  }
+  interface AttachmentPreviewV2 {
+      id: number;
+      url: string;
+      thumbnail_url: string | null;
+      filename: string;
+      mime: string;
+  }
+  interface AcItemViewV2 {
+      check_item_id: string;
+      title: string;
+      checked: boolean;
+  }
+  type ChecklistItemStatus = "incomplete" | "failing" | "passing" | "cancelled" | "deferred";
+  interface ChecklistItemView {
+      id: number;
+      label: string;
+      detail: string;
+      status: ChecklistItemStatus;
+  }
+  interface ChecklistView {
+      id: number;
+      name: string;
+      items: ChecklistItemView[];
+  }
+  type DesignDecisionOutcome = "rejected" | "approved" | "changes_requested";
+  interface ChecklistHistoryViewV2 {
+      action: "create" | "rename" | "remove" | "add_item" | "update_item" | "remove_item";
+      checklist: string;
+      item: string | null;
+      changed: "status" | "label" | "detail" | null;
+  }
+  interface LatestWorkDispatchViewV2 {
+      dispatch_id: string;
+      started_at_ms: number;
+      completed_at_ms: number | null;
+      status: string;
+      usage_input: number;
+      usage_output: number;
+      assigned_worker_id: string | null;
+  }
+  interface ChildAssignmentViewV2 {
+      agent: string;
+      agent_repo_copy: RepoProfileCopy | null;
+      issue_id: string;
+      issue_title: string;
+  }
+  type IssueViewV2 = {
+    comments?: undefined | (Array<{
+    id: string;
+    rev: number;
+    author: string;
+    by: AuthorV2;
+    timestamp: string;
+    text: string;
+    updated_at: string;
+    origin: "" | "trello" | "slack" | "asana" | "danxbot";
+    via_key?: undefined | null | ViaKey;
+    metadata?: unknown;
+    answers_decision_id?: undefined | null | number;
+    tags: Array<{ kind: "problem"; ref: number; } | { kind: "design"; ref: number; } | { kind: "decision"; ref: number; }>;
+    resource_tags: Array<CommentResourceTag>;
+    reply_to_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";
+    url: string;
+    filename: string;
+    mime: string;
+    is_primary: boolean;
+    thumbnail_status: "ready" | "not_image" | "failed" | "pending";
+    thumbnail_url: null | string;
+    thumbnail_error: null | string;
+    created_at: string;
+  }>);
+    triage?: undefined | TriageViewV2;
+    title: string;
+    description?: undefined | string;
+    status: "Cancelled" | "Review" | "ToDo" | "In Progress" | "Backlog" | "Done";
+    type: string;
+    priority: number;
+    id: string;
+    parent_id: null | string;
+    rev: number;
+    created_at: number;
+    updated_at: number;
+    assigned_agent: null | string;
+    content_hash: string;
+    retro?: undefined | RetroViewV2;
+    stored_row?: undefined | IssueDisplayV2;
+    stored_checklists?: undefined | Array<ChecklistWithItemsV2>;
+    stored_attachments?: undefined | Array<IssueAttachmentV2>;
+    retro_commit_shas?: undefined | Array<string>;
+    code_gates?: undefined | Array<CodeGateStatus>;
+    deleted_at?: undefined | null | number;
+    dispatchable_derived?: undefined | false | true;
+    blocked?: undefined | null | { at: string; reason: string; by: AuthorV2 | null; };
+    board_id?: undefined | BoardRefNum;
+    ready_at?: undefined | null | string;
+    archived_at?: undefined | null | string;
+    completed_at?: undefined | null | string;
+    cancelled_at?: undefined | null | string;
+    wake_at?: undefined | null | string;
+    wake_action?: undefined | null | "review" | "ready";
+    assigned_agent_name?: undefined | null | string;
+    assigned_agent_team_agent?: undefined | null | AgentIdentity;
+    resolved_list_id?: undefined | string;
+    list_name?: undefined | string;
+    list_color?: undefined | null | string;
+    list_emoji?: undefined | null | string;
+    refs?: undefined | Array<CardRefViewV2>;
+    parent_title?: undefined | null | string;
+    parent_type?: undefined | null | string;
+    parent_created_at?: undefined | null | number;
+    parent_updated_at?: undefined | null | number;
+    parent_blocked?: undefined | null | false | true;
+    parent_open_problem_count?: undefined | null | number;
+    projection_error?: undefined | null | string;
+    summary?: undefined | null | string;
+    pull_request_url?: undefined | null | string;
+    risk_score?: undefined | null | "R0" | "R1" | "R2" | "R3" | "R4";
+    risk_reason?: undefined | null | string;
+    risk_raise_reason?: undefined | null | string;
+    start_commit?: undefined | null | { at: string; sha: string | null; error: "no_repo" | "not_github_repo" | "no_token" | "github_refused" | "github_unreachable" | "unreadable_tip" | "unexpected" | null; error_detail: string | null; };
+    problem_total?: undefined | number;
+    decision_record_total?: undefined | number;
+    decision_record_page?: undefined | DecisionRecordPage;
+    decision_record_approved_total?: undefined | number;
+    lane_header?: undefined | false | true;
+    design_count?: undefined | number;
+    open_action_count?: undefined | number;
+    open_problem_count?: undefined | number;
+    ac?: undefined | Array<AcItemViewV2>;
+    triage_enabled?: undefined | false | true;
+    dispatch?: undefined | null | { started_at: string | null; };
+    dispatch_kind?: undefined | null | "work" | "triage" | "recovery" | "flesh-out" | "chat" | "main-sync-repair" | "worktree-maintenance" | "manual" | "landing" | `gate-${string}`;
+    assignment_mode?: undefined | "manual" | "automated";
+    assigned_agent_kind?: undefined | null | "person" | "session" | "worker" | "label";
+    assigned_agent_pause?: undefined | null | HolderAgentPause;
+    assigned_agent_repo_copy?: undefined | null | RepoProfileCopy;
+    latest_work_dispatch?: undefined | null | LatestWorkDispatchViewV2;
+    usage?: undefined | null | UsageSummary | UsageError;
+    effort_level?: undefined | "min" | "very_low" | "low" | "medium" | "high" | "very_high" | "max";
+    build_grade?: undefined | BuildGradeView;
+    downward_rung?: undefined | null | "min" | "very_low" | "low" | "medium" | "high" | "very_high" | "max";
+    waiting_on_gate?: undefined | null | WaitingOnViewV2;
+    waiting_on_dep_ids?: undefined | Record<string, number>;
+    dependency_pull_requests?: undefined | Record<string, DependencyPullRequestViewV2>;
+    conflict_on?: undefined | Array<ConflictEntryViewV2>;
+    conflict_on_reverse?: undefined | Array<ConflictEntryViewV2>;
+    conflict_on_partners?: undefined | Record<string, { status: IssueStatus; title: string; }>;
+    conflict_dep_ids?: undefined | Record<string, number>;
+    conflict_on_active_count?: undefined | number;
+    children?: undefined | Array<string>;
+    descendant_ids?: undefined | Array<string>;
+    descendant_needs_you?: undefined | Array<DescendantNeedsYouView>;
+    blocked_descendants?: undefined | Array<InheritedBlockedViewV2>;
+    child_assignments?: undefined | Array<ChildAssignmentViewV2>;
+    ac_total?: undefined | number;
+    ac_done?: undefined | number;
+    ac_items?: undefined | (Array<{ title: string; status: "incomplete" | "failing" | "passing" | "cancelled" | "deferred"; }>);
+    comments_count?: undefined | number;
+    unread_comments_count?: undefined | number;
+    unread_decision_comment_counts?: undefined | Record<string, number>;
+    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>;
+    has_retro?: undefined | false | true;
+    primary_attachment?: undefined | null | AttachmentPreviewV2;
+    in_progress_derived?: undefined | false | true;
+    waiting_on?: undefined | false | true;
+    waiting_on_reason?: undefined | null | string;
+    waiting_on_by?: undefined | Array<string>;
+    triage_ice_total?: undefined | null | number;
+    triage_ice_i?: undefined | null | number;
+    triage_ice_c?: undefined | null | number;
+    triage_ice_e?: undefined | null | number;
+    triage_confidence?: undefined | null | number;
+    triage_last_explain?: undefined | string;
+    triage_last_status?: undefined | string;
+    triage_last_decision_at?: undefined | null | string;
+    next_pre_gate?: undefined | null | string;
+    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<{
+    action: "created" | "changed" | "deleted" | "restored";
+    title: string;
+    kind: "design" | "business_rule" | "architecture" | "other";
+    made_by: "agent" | "human";
+    approved: boolean;
+    impact: number;
+    confidence: number;
+    rev: number;
+    created_at: string;
+    updated_at: string;
+    deleted_at: null | string;
+    author: string;
+    by: AuthorV2;
+    text: string;
+    via_key: null | ViaKey;
+    ref: string;
+    ref_num: number;
+    current_version: number;
+    approval: DecisionApprovalState;
+    record_created_at: string;
+    made_by_user_id: null | number;
+    made_by_name: null | string;
+    made_by_author: AuthorV2;
+    made_by_is_writer: boolean;
+    provenance: Array<ProvenanceRecordV2>;
+    comment_count: number;
+    unread_comment_count: number;
+    versions?: undefined | (Array<{
+    action: "created" | "changed" | "deleted" | "restored";
+    title: string;
+    kind: "design" | "business_rule" | "architecture" | "other";
+    made_by: "agent" | "human";
+    impact: number;
+    confidence: number;
+    id: number;
+    created_at: string;
+    author: string;
+    by: AuthorV2;
+    text: string;
+    via_key: null | ViaKey;
+    ref: string;
+    approval: DecisionApprovalState;
+    made_by_user_id: null | number;
+    made_by_name: null | string;
+    made_by_author: AuthorV2;
+    made_by_is_writer: boolean;
+    provenance: Array<ProvenanceRecordV2>;
+    version_no: number;
+  }>);
+    approvals?: undefined | (Array<{
+    action: "approve" | "unapprove";
+    at: string;
+    id: number;
+    ref: string;
+    version_no: number;
+    by_user_id: null | number;
+    by_name: string;
+  }>);
+  }>);
+    decision_record_versions?: undefined | (Array<{
+    action: "created" | "changed" | "deleted" | "restored";
+    title: string;
+    kind: "design" | "business_rule" | "architecture" | "other";
+    made_by: "agent" | "human";
+    impact: number;
+    confidence: number;
+    id: number;
+    created_at: string;
+    author: string;
+    by: AuthorV2;
+    text: string;
+    via_key: null | ViaKey;
+    ref: string;
+    approval: DecisionApprovalState;
+    made_by_user_id: null | number;
+    made_by_name: null | string;
+    made_by_author: AuthorV2;
+    made_by_is_writer: boolean;
+    provenance: Array<ProvenanceRecordV2>;
+    version_no: number;
+  }>);
+    decision_record_approvals?: undefined | (Array<{
+    action: "approve" | "unapprove";
+    at: string;
+    id: number;
+    ref: string;
+    version_no: number;
+    by_user_id: null | number;
+    by_name: string;
+  }>);
+    work_marks?: undefined | Array<{
+    id: number;
+    via_key_id: number;
+    resource: WorkMarkResource;
+    note: string;
+    by: AuthorV2;
+    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: "rejected" | "approved" | "awaiting_review" | "changes_requested";
+    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: "rejected" | "approved" | "changes_requested";
+    note: null | string;
+    decided_by: string;
+    decided_by_ref: ActorRef;
+    created_at: string;
+    options: null | OptionSelection;
+  }>);
+  }>);
+    pull_request_reviews?: undefined | (Array<{
+    id: number;
+    kind: "comment" | "review" | "thread";
+    author_login: string;
+    state: null | "approved" | "changes_requested" | "commented" | "dismissed";
+    body: string;
+    html_url: string;
+    path: null | string;
+    line: null | number;
+    resolved: null | false | true;
+    occurred_at: 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: undefined | string;
+    priority: undefined | number;
+    name: string;
+    id: string;
+    blocked: boolean;
+    summary: undefined | null | string;
+    open_problem_count: number;
+    waiting_on: boolean;
+    waiting_on_by_card: boolean;
+    waiting_on_ids: Array<string>;
+    conflict_on_ids: Array<string>;
+    board_id: BoardRefNum;
+  }>);
+    plans?: undefined | Array<{
+    id: PlanRefNum;
+    ref: string;
+    name: string;
+  }>;
+    mirrors?: undefined | (Array<{
+    target_type: "trello" | "slack" | "asana";
+    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">;
+    description_unreadable: boolean;
+    target_ref: string;
+    target_label: string;
+    last_synced_at: number;
+    logo_url: string;
+  }>);
+    history?: undefined | (Array<{
+    id: string;
+    timestamp: string;
+    actor: string;
+    actor_ref: ActorRef;
+    via_key: undefined | null | ViaKey;
+    event: "created" | "blocked" | "activity" | "status_change" | "unblocked" | "field_change" | "dependency_added" | "dependency_removed" | "conflict_added" | "conflict_removed";
+    label: undefined | StatusReason;
+    from: undefined | "Cancelled" | "Review" | "ToDo" | "In Progress" | "Backlog" | "Done";
+    to: undefined | "Cancelled" | "Review" | "ToDo" | "In Progress" | "Backlog" | "Done";
+    note: undefined | string;
+    field: undefined | string;
+    value_before: undefined | null | string;
+    value_after: undefined | null | string;
+    target: undefined | string;
+    checklist: undefined | ChecklistHistoryViewV2;
+  }>);
+    controls?: undefined | (Array<{
+    key: string;
+    scope: "board" | "team" | "plan" | "card";
+    scope_id: string;
+    value: null | string | false | true;
+    source: "board" | "team" | "plan" | "card" | "system" | "inherit";
+    base_hash: string;
+    kind: "boolean" | "enum" | "branch" | "markdown" | "seconds" | "months";
+    options: null | Array<string>;
+    description: string;
+    system_default: string | false | true;
+    fallback: null | ControlFallback;
+    overridable: boolean;
+    default_changed: boolean;
+  }>);
+    comments_page?: undefined | RelationPageView;
+    agent_notes_page?: undefined | RelationPageView;
+    decision_record_versions_page?: undefined | RelationPageView;
+    decision_record_approvals_page?: undefined | RelationPageView;
+    history_page?: undefined | RelationPageView;
+    problems?: undefined | Array<ProblemViewV2>;
+    subtree?: undefined | Array<IssueViewV2>;
+    quality_gates?: undefined | Array<QualityGateChipV2> | Array<QualityGateViewV2>;
+  };
+  interface QualityGateChipV2 {
+      gate: string;
+      phase: QualityGatePhase;
+      status: "pending" | "pass" | "fail" | "skipped";
+  }
+  type QualityGateViewV2 = {
+    gate: string;
+    decision_note: string;
+    status: "pending" | "pass" | "fail" | "skipped";
+    completed_at: null | string;
+    message: string;
+    reviewed_ref: null | string;
+    decided_by: null | string;
+    budget_started_at: string;
+    rounds: Array<GateRoundV2>;
+    phase: "plan" | "code";
+  };
+  type ProblemViewV2 = {
+    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;
+    solution_title: null | string;
+    outcome: "answered" | "rejected";
+    freeform: null | string;
+    note: null | string;
+    decided_by: string;
+    decided_by_ref: ActorRef;
+    decided_at: string;
+    retracted_at: null | string;
+    relayed_by_session: null | string;
+    provenance: null | ProvenanceRecordV2;
+    content_hash: string;
+  }>;
+    issue_id: string;
+    feedback_consent: boolean;
+    choice_locked: boolean;
+    docs_review: null | DocsReviewView;
+    docs_land: boolean;
+    needs_person: boolean;
+    statement: string;
+    context: null | string;
+    design_element: null | string;
+    solutions: Array<SolutionViewV2>;
+    decision_review?: undefined | (Array<{
+    problem_ref_num: number;
+    record_ref: string;
+    answered_version_no: null | number;
+    choices: Array<{ solution_id: number; kind: DecisionReviewChoiceKind; version_no: number; title: string; }>;
+    versions?: undefined | (Array<{
+    action: "created" | "changed" | "deleted" | "restored";
+    title: string;
+    kind: "design" | "business_rule" | "architecture" | "other";
+    made_by: "agent" | "human";
+    impact: number;
+    confidence: number;
+    id: number;
+    created_at: string;
+    author: string;
+    by: AuthorV2;
+    text: string;
+    via_key: null | ViaKey;
+    ref: string;
+    approval: DecisionApprovalState;
+    made_by_user_id: null | number;
+    made_by_name: null | string;
+    made_by_author: AuthorV2;
+    made_by_is_writer: boolean;
+    provenance: Array<ProvenanceRecordV2>;
+    version_no: number;
+  }>);
+  }>);
+  };
+  type SolutionViewV2 = {
+    title: string;
+    id: number;
+    content_hash: string;
+    body: string;
+    steps_hash: string;
+    steps: Array<{
+    id: number;
+    solution_id: number;
+    parent_step_id: null | number;
+    label: string;
+    title: string;
+    description: null | string;
+    content_hash: string;
+    checked_at: null | string;
+    checked_by: null | string;
+    steps: Array<SolutionStepViewV2>;
+  }>;
+    removed: boolean;
+    pro: string;
+    con: string;
+    recommended: boolean;
+    design?: undefined | (Array<{
+    ref_num: number;
+    design_no: number;
+    title: string;
+    created_by: string;
+    created_at: string;
+    archived_at: null | string;
+    review_state: "rejected" | "approved" | "awaiting_review" | "changes_requested";
+    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: "rejected" | "approved" | "changes_requested";
+    note: null | string;
+    decided_by: string;
+    decided_by_ref: ActorRef;
+    created_at: string;
+    options: null | OptionSelection;
+  }>);
+  }>);
+  };
+  interface SolutionStepViewV2 {
+      id: number;
+      solution_id: number;
+      parent_step_id: number | null;
+      label: string;
+      title: string;
+      description: string | null;
+      content_hash: string;
+      checked_at: string | null;
+      checked_by: string | null;
+      steps: SolutionStepViewV2[];
+  }
+  interface DecisionViewV2 {
+      id: number;
+      solution_id: number | null;
+      solution_title: string | null;
+      outcome: DecisionOutcome;
+      freeform: string | null;
+      note: string | null;
+      decided_by: string;
+      decided_by_ref: ActorRef;
+      decided_at: string;
+      retracted_at: string | null;
+      relayed_by_session: string | null;
+      provenance: ProvenanceRecordV2 | null;
+      content_hash: string;
+  }
+  interface CardRefViewV2 {
+      source: "danxbot" | MirrorProviderId;
+      ref: string;
+      url: string;
+  }
+
+  interface CodeGateStatus {
+      gate: string;
+      status: QualityGateStatus;
+  }
+
+  type ConnectionState = "connecting" | "connected" | "disconnected";
+  interface LiveQueryResult<T> {
+      data: T | null;
+      loading: boolean;
+      refreshing?: boolean;
+      error: Error | null;
+      connection: ConnectionState;
+      refetch: () => void;
+  }
+
+  function useIssueDetail(id: string): LiveQueryResult<IssueViewV2>;
+
+  type TransitionAction = "ready" | "unready" | "pickup" | "rollback_pickup" | "gate_release" | "gate_repin" | "claim_repin" | "landing_hold" | "complete" | "cancel" | "block" | "unblock" | "archive" | "snooze" | "coerce" | "reopen";
+
+  interface ChildProgress {
+      done: number;
+      total: number;
+  }
+  interface CardStatusPresentation {
+      label: string;
+      icon: string;
+      reason: string | null;
+      live: boolean;
+      isContainer: boolean;
+      childProgress: ChildProgress | null;
+  }
+  type SnoozePresentation = {
+      active: false;
+  } | {
+      active: true;
+      wakeAt: string;
+      wakeAction: "ready" | "review";
+  };
+  interface GateBreakdownEntry {
+      gate: string;
+      label: string;
+      status: GateVerdict;
+  }
+  const defaultNewCardPriority: () => number;
+  type GateVerdict = QualityGateViewV2["status"];
+
+  type LifecycleAction = Extract<TransitionAction, "ready" | "unready" | "complete" | "cancel" | "reopen">;
+
+  interface CardEditPatch {
+      title?: string;
+      description?: string;
+      summary?: string | null;
+      pull_request_url?: string | null;
+      priority?: number;
+      type?: CardTypeKey;
+      parent_id?: string | null;
+      effort_level?: EffortLevelName;
+      content_hash?: string;
+  }
+  function editCard(id: string, patch: CardEditPatch): Promise<void>;
+  function transitionCard(id: string, action: LifecycleAction | "unblock" | "archive"): Promise<void>;
+  type PriorityPlacement = {
+      side: "after" | "before";
+      id: string;
+  } | {
+      edge: "top" | "bottom";
+  };
+  interface DetachedDispatch {
+      dispatchId: string;
+      stop: "requested" | "unreachable";
+  }
+  type ProblemCard = Pick<IssueViewV2, "id"> & Partial<Pick<IssueViewV2, "problems" | "open_problem_count">>;
+
+  interface LaneMoveRequest {
+      issueId: string;
+      lane: IssueStatus$1;
+      placement: PriorityPlacement | null;
+  }
+  type BoardMoveResult = {
+      ok: true;
+      reason: null;
+      updatedAt: number;
+      detachedDispatch: DetachedDispatch | null;
+  } | {
+      ok: false;
+      reason: string;
+      updatedAt: null;
+  };
+
+  interface CardMutation {
+      pending: string | null;
+      run: (key: string, failureTitle: string, op: () => Promise<void>) => Promise<boolean>;
+  }
+  function useCardMutation(): CardMutation;
+
+  type PlanWire = number | {
+      name: string;
+  } | null;
+
+  interface NewCardInput {
+      board: BoardRefNum;
+      type: CardTypeKey;
+      title: string;
+      priority: number;
+      plan: PlanWire;
+      description: string;
+  }
+  function createCard(input: NewCardInput): Promise<string>;
+  type HideableLane = "Cancelled" | "Backlog";
+  interface LaneVisibility {
+      isShown: (lane: IssueStatus$1) => boolean;
+      setShown: (lane: HideableLane, shown: boolean) => void;
+  }
+
+  type LaneSortField = "title" | "id" | "priority" | "updated_at" | "created_at";
+  type LaneSort = SortValue<LaneSortField>;
+  type LaneSorts = Readonly<Record<IssueStatus$1, LaneSort>>;
+  interface LaneSortState {
+      readonly sorts: LaneSorts;
+      readonly setSort: (lane: IssueStatus$1, sort: LaneSort) => void;
+  }
+
+  type BoardScope = {
+      readonly kind: "board";
+      readonly board: BoardRefNum;
+      readonly boards: readonly BoardRefNum[];
+  } | {
+      readonly kind: "plan";
+      readonly planId: number;
+      readonly boards: readonly BoardRefNum[];
+  };
+  type BoardLaneWindows = Readonly<Record<IssueStatus$1, PagedWindow<IssueViewV2>>>;
+  type LaneLeafTotals = Readonly<Record<IssueStatus$1, number | null>>;
+  interface BoardLaneState {
+      readonly scope: BoardScope;
+      readonly windows: BoardLaneWindows;
+      readonly leafTotals: LaneLeafTotals;
+      readonly visibility: LaneVisibility;
+      readonly sorts: LaneSorts;
+      readonly setSort: LaneSortState["setSort"];
+      readonly openCount: number | null;
+  }
+  function useBoardLaneState(scope: BoardScope): BoardLaneState;
+
+  function useCardsOfType(scope: BoardScope, type: string): LiveQueryResult<readonly IssueViewV2[]>;
+
+  function boardCardPath(cardId: string): string;
+  function planCardPath(planId: number, cardId: string, planSearch?: string): string;
+  function planPathFromCard(planId: number, cardSearch?: string): string;
+
+  function CardLink({ id, className, onNavigate }: {
+      id: string;
+      className?: string;
+      onNavigate?: () => void;
+  }): react.JSX.Element;
+
+  function EditableTitle({ card }: {
+      card: IssueViewV2;
+  }): react.JSX.Element;
+
+  function EditableSummary({ card }: {
+      card: IssueViewV2;
+  }): react.JSX.Element;
+
+  function EditableContext({ card }: {
+      card: IssueViewV2;
+  }): react.JSX.Element;
+
+  function ChecklistsSection({ card, mutation }: {
+      card: IssueViewV2;
+      mutation: CardMutation;
+  }): react.JSX.Element;
+
+  interface ProblemAttention {
+      problem: ProblemViewV2;
+      solutions: SolutionViewV2[];
+      removedSolutionIds: ReadonlySet<number>;
+      decisions: DecisionViewV2[];
+      choiceLocked: boolean;
+  }
+
+  interface ProblemsSectionProps {
+      card: ProblemCard;
+      problems: ProblemAttention[];
+      canAnswer: boolean;
+      designGatePending: boolean;
+      mutation: CardMutation;
+  }
+
+  function ProblemsSection({ cardId, ...rest }: {
+      cardId: IssueViewV2["id"];
+  } & Omit<ProblemsSectionProps, "card">): react.JSX.Element;
+
+  function DependenciesSection({ card, mutation }: {
+      card: IssueViewV2;
+      mutation: CardMutation;
+  }): react.JSX.Element;
+
+  function ChildrenSection({ card }: {
+      card: IssueViewV2;
+  }): react.JSX.Element;
+
+  function ParentField({ card, mutation }: {
+      card: IssueViewV2;
+      mutation: CardMutation;
+  }): react.JSX.Element;
+
+  function PlansField({ card, mutation }: {
+      card: IssueViewV2;
+      mutation: CardMutation;
+  }): react.JSX.Element;
+
+  function GatesSection({ card }: {
+      card: IssueViewV2;
+  }): react.JSX.Element;
+
+  interface ActivityProps {
+      card: IssueViewV2;
+      mutation: CardMutation;
+      onFocusProblem?: (problemRefNum: number) => void;
+  }
+  function ActivityTab(props: ActivityProps): react.JSX.Element;
+
+  type ShownAttachment = AttachmentViewV2 & {
+      pending: boolean;
+  };
+  interface AttachmentActions {
+      attachments: ShownAttachment[];
+      add: (files: readonly File[]) => void;
+      replace: (id: number, file: File) => void;
+      rename: (id: number, filename: string) => void;
+      setCover: (id: number) => void;
+      remove: (id: number) => void;
+  }
+  function useAttachmentActions(card: Pick<IssueViewV2, "id" | "attachments">): AttachmentActions;
+
+  interface AttachmentViewer {
+      open: (attachmentId: number) => void;
+      element: ReactNode;
+  }
+
+  function AttachmentsTab({ cardId, actions, viewer, }: {
+      cardId: string;
+      actions: AttachmentActions;
+      viewer: AttachmentViewer;
+  }): react.JSX.Element;
+
+  function RetroTab({ retro }: {
+      retro: RetroViewV2;
+  }): react.JSX.Element;
+
+  interface AttentionZoneProps {
+      card: IssueViewV2;
+      mutation: CardMutation;
+  }
+  function AttentionZone({ card, mutation }: AttentionZoneProps): react.JSX.Element;
+
+  interface CardActionsMenuProps {
+      card: IssueViewV2;
+      mutation: CardMutation;
+  }
+  function CardActionsMenu({ card, mutation }: CardActionsMenuProps): react.JSX.Element;
+
+  interface WorkStateInput {
+      terminal: boolean;
+      container: boolean;
+      assignedAgent: string | null;
+      assignedAgentName: string | null;
+      assignedAgentTeamAgent: {
+          id: number;
+          name: string;
+          avatar_url: string | null;
+      } | null;
+      assignedAgentKind: AssignedAgentKind | null;
+      assignedAgentRepoCopy: RepoProfileCopy | null;
+      assignedAgentPause: HolderAgentPause | null;
+      heldSince: string | null;
+      blocked: {
+          reason: string;
+          by: AuthorV2 | null;
+          at: string;
+      } | null;
+      waitingOn: readonly string[];
+      conflictIds: readonly string[];
+      conflictActive: number;
+  }
+
+  interface WorkStateControlProps {
+      cardId: string;
+      input: WorkStateInput;
+      size?: "sm" | "2xs";
+      onOpenHold?: () => void;
+      onOpenDependencies?: () => void;
+      assignee?: boolean;
+  }
+  function WorkStateControl({ cardId, input, size, onOpenHold, onOpenDependencies, assignee }: WorkStateControlProps): react.JSX.Element | null;
+
+  interface ControlProps {
+      card: IssueViewV2;
+      mutation: CardMutation;
+  }
+  function PriorityControl({ card, mutation }: ControlProps): react.JSX.Element;
+  function EffortControl({ card, mutation }: ControlProps): react.JSX.Element;
+  function TypeControl({ card, mutation }: ControlProps): react.JSX.Element;
+  function StatusControl({ card, mutation }: ControlProps): react.JSX.Element;
+
+  interface StandardCardPageProps {
+      card: IssueViewV2;
+      mutation: CardMutation;
+  }
+  function StandardCardPage({ card, mutation }: StandardCardPageProps): react.JSX.Element;
+
+  interface CardFaceAc {
+      total: number;
+      byStatus: Record<ChecklistItemStatus, number>;
+      items?: NonNullable<IssueViewV2["ac_items"]>;
+  }
+  interface CardFaceModel {
+      id: string;
+      title: string;
+      type: CardTypeKey;
+      priority: number;
+      statusName: IssueStatus$1;
+      status: CardStatusPresentation;
+      list: CardFaceList | null;
+      to: string;
+      parent: {
+          id: string;
+          title: string | null;
+          to: string;
+      } | null;
+      needsHuman: {
+          questions: number;
+          actions: number;
+      };
+      work: WorkStateInput;
+      snooze: SnoozePresentation;
+      effort: EffortLevelName | null;
+      planGates: readonly GateBreakdownEntry[];
+      codeGates: readonly GateBreakdownEntry[];
+      ac: CardFaceAc;
+      commentsCount: number;
+      unreadCommentsCount: number;
+      hasRetro: boolean;
+      onPullRequest: boolean;
+      childrenCount: number;
+      childrenDetail?: NonNullable<IssueViewV2["children_detail"]>;
+      triage: {
+          lastDecisionAt: string | null;
+          confidence: number | null;
+          iceTotal: number | null;
+          iceI: number | null;
+          iceC: number | null;
+          iceE: number | null;
+      };
+      agent: {
+          childAssignments: readonly ChildAssignmentViewV2[];
+          dispatchKind?: IssueDispatchKind | null;
+          latestWorkDispatch: LatestWorkDispatchViewV2 | null;
+      };
+      usage: CardUsage;
+      createdAt: string | number;
+      updatedAt: string | number;
+  }
+  type CardFaceList = {
+    name: string;
+    id: string;
+    color: string;
+    emoji: string;
+  };
+
+  type CardFaceStatusMark = {
+      kind: "labelled";
+  } | {
+      kind: "lane";
+      laneListId: string | null;
+  };
+  interface CardFaceProps {
+      card: CardFaceModel;
+      renderTitle: (props: {
+          className: string;
+          describedBy: string;
+      }) => ReactNode;
+      trailing?: ReactNode;
+      statusMark: CardFaceStatusMark;
+      cover?: ReactNode;
+      inParentBox?: boolean;
+  }
+  function CardFace({ card, renderTitle, trailing, statusMark, cover, inParentBox }: CardFaceProps): react.JSX.Element;
+
+  function CardBoard({ state, cardPath, }: {
+      state: BoardLaneState;
+      cardPath?: (cardId: string) => string;
+  }): react.JSX.Element;
+
+  type CardViewProps = StandardCardPageProps;
+  interface CardListViewProps {
+      readonly scope: BoardScope;
+      readonly cardPath: (cardId: string) => string;
+  }
+
+  function requestBoardMove(req: LaneMoveRequest): Promise<BoardMoveResult>;
+
+  export { ActivityTab, AttachmentsTab, AttentionZone, CardActionsMenu, CardBoard, CardFace, CardLink, ChecklistsSection, ChildrenSection, DependenciesSection, EditableContext, EditableSummary, EditableTitle, EffortControl, GatesSection, ParentField, PlansField, PriorityControl, ProblemsSection, RetroTab, StandardCardPage, StatusControl, TypeControl, WorkStateControl, boardCardPath, createCard, defaultNewCardPriority, editCard, planCardPath, planPathFromCard, requestBoardMove, transitionCard, useAttachmentActions, useBoardLaneState, useIssueDetail as useCard, useCardMutation, useCardsOfType };
+  export type { AttachmentActions, BoardLaneState, BoardMoveResult, BoardScope, CardEditPatch, CardFaceProps, CardListViewProps, CardMutation, CardViewProps, IssueViewV2, LaneMoveRequest, LiveQueryResult, NewCardInput, StandardCardPageProps };
+}