@cadraos/sdk 0.3.13 → 0.3.14-p102.1

package/dist/index.d.cts

@@ -2795,7 +2795,17 @@ interface KanbanLane {
      * a tick fans out ⌈cap / chunkSize⌉ runs. Ignored for `per-card`/`event` lanes.
      */
     chunkSize?: number;
+    /**
+     * p46 Handoff contract, OPT-IN per lane (D1). Absent ⇒ `off` (existing boards
+     * are byte-identical). `verdict` ⇒ the engine sends
+     * `HANDOFF_VERDICT_JSON_SCHEMA` as the run's `context.outputSchema` and a
+     * completion MUST carry a valid verdict (else the run fails with a FAILED
+     * handoff). Active only on hosts whose adapter implements the ledger group.
+     */
+    handoff?: KanbanLaneHandoffMode;
 }
+/** Per-lane Handoff mode (p46 D1). */
+type KanbanLaneHandoffMode = "off" | "verdict";
 /**
  * A declared edge between two lanes in the lifecycle.
  *
@@ -2887,6 +2897,11 @@ interface KanbanCard {
     configVersion?: number;
     /** Arbitrary shared context carried across transitions. */
     sharedContext?: Record<string, unknown>;
+    /**
+     * p46 (P46-002): the card's id in an external host (a Jira issue key).
+     * Absent on native / crm / yobo cards.
+     */
+    externalRef?: string;
     /**
      * Execution UUID of the card's current/last run, if any.
      *
@@ -2949,6 +2964,18 @@ interface CreateCardInput {
      * in the lifecycle's initial lane.
      */
     lane?: string;
+    /**
+     * p46 (P46-002): the card's id in an EXTERNAL host (a Jira issue key, e.g.
+     * `CAD-231`). Optional. When set, a card is created at most ONCE per
+     * `(boardConfigUuid, externalRef)`: a repeat create returns the existing card
+     * and dispatches nothing. Hosts that don't store it simply ignore it.
+     */
+    externalRef?: string;
+    /**
+     * p46 (P46-002): opaque host facts stored with the card (Jira `statusId`,
+     * `mover`, `detached`, …). Passed through to `adapter.createCard` untouched.
+     */
+    externalMeta?: Record<string, unknown>;
 }
 /**
  * Input for transitioning a card to another lane.

package/dist/index.d.ts

@@ -2795,7 +2795,17 @@ interface KanbanLane {
      * a tick fans out ⌈cap / chunkSize⌉ runs. Ignored for `per-card`/`event` lanes.
      */
     chunkSize?: number;
+    /**
+     * p46 Handoff contract, OPT-IN per lane (D1). Absent ⇒ `off` (existing boards
+     * are byte-identical). `verdict` ⇒ the engine sends
+     * `HANDOFF_VERDICT_JSON_SCHEMA` as the run's `context.outputSchema` and a
+     * completion MUST carry a valid verdict (else the run fails with a FAILED
+     * handoff). Active only on hosts whose adapter implements the ledger group.
+     */
+    handoff?: KanbanLaneHandoffMode;
 }
+/** Per-lane Handoff mode (p46 D1). */
+type KanbanLaneHandoffMode = "off" | "verdict";
 /**
  * A declared edge between two lanes in the lifecycle.
  *
@@ -2887,6 +2897,11 @@ interface KanbanCard {
     configVersion?: number;
     /** Arbitrary shared context carried across transitions. */
     sharedContext?: Record<string, unknown>;
+    /**
+     * p46 (P46-002): the card's id in an external host (a Jira issue key).
+     * Absent on native / crm / yobo cards.
+     */
+    externalRef?: string;
     /**
      * Execution UUID of the card's current/last run, if any.
      *
@@ -2949,6 +2964,18 @@ interface CreateCardInput {
      * in the lifecycle's initial lane.
      */
     lane?: string;
+    /**
+     * p46 (P46-002): the card's id in an EXTERNAL host (a Jira issue key, e.g.
+     * `CAD-231`). Optional. When set, a card is created at most ONCE per
+     * `(boardConfigUuid, externalRef)`: a repeat create returns the existing card
+     * and dispatches nothing. Hosts that don't store it simply ignore it.
+     */
+    externalRef?: string;
+    /**
+     * p46 (P46-002): opaque host facts stored with the card (Jira `statusId`,
+     * `mover`, `detached`, …). Passed through to `adapter.createCard` untouched.
+     */
+    externalMeta?: Record<string, unknown>;
 }
 /**
  * Input for transitioning a card to another lane.