@cadraos/sdk 0.3.13 → 0.3.14-p102.2

package/dist/chat/index.d.cts

@@ -1312,6 +1312,8 @@ interface Artifact$1 {
     mimeType: string;
     /** Download URL */
     url: string;
+    /** Thumbnail URL (images) — chat renders this instead of the full-size `url` */
+    thumbnailUrl?: string;
     /** When the artifact was created (ISO string) */
     createdAt?: string;
 }
@@ -3724,7 +3726,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.
  *
@@ -3816,6 +3828,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.
      *
@@ -3878,6 +3895,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/chat/index.d.ts

@@ -1312,6 +1312,8 @@ interface Artifact$1 {
     mimeType: string;
     /** Download URL */
     url: string;
+    /** Thumbnail URL (images) — chat renders this instead of the full-size `url` */
+    thumbnailUrl?: string;
     /** When the artifact was created (ISO string) */
     createdAt?: string;
 }
@@ -3724,7 +3726,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.
  *
@@ -3816,6 +3828,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.
      *
@@ -3878,6 +3895,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/chat/index.js

@@ -3669,6 +3669,7 @@ function createDefaultAdapter(config) {
         filename: a.filename,
         mimeType: a.mimeType,
         url: a.url,
+        ...a.thumbnailUrl ? { thumbnailUrl: a.thumbnailUrl } : {},
         createdAt: a.createdAt
       }));
     },
@@ -5507,7 +5508,9 @@ function useAgentChat(options) {
                 args: {},
                 result: {
                   success: true,
-                  images: [{ url: artifact.url }]
+                  images: [
+                    artifact.thumbnailUrl ? { url: artifact.url, thumbnailUrl: artifact.thumbnailUrl } : { url: artifact.url }
+                  ]
                 },
                 status: "completed"
               }));