@cadraos/sdk 0.3.14-p46.3 → 0.3.14

package/dist/kanban/engine/index.d.cts

@@ -316,6 +316,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.
      *
@@ -378,6 +383,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>;
 }
 /**
  * Who performed a transition / stage-run (server-engine side).
@@ -495,6 +512,23 @@ interface ApplyTransitionInput {
     contextPatch?: Record<string, unknown>;
     /** Execution UUID to stamp on the card (handler advances). */
     executionUuid?: string;
+    /**
+     * p46 (P46-002, F8): set ONLY by `engine.hostMove` (a move the external host
+     * made — e.g. a Jira drag mirrored by the sync). A host-aware adapter, inside
+     * the same card lock as the `fromLane` CAS, (1) refuses the move with a
+     * `HostFenceError` while the card has any `host.*` op `pending` (D19 — never
+     * mistake our own half-done move for a human one), (2) writes `externalMeta`,
+     * then (3) moves. Adapters that don't know it ignore it (optional, additive).
+     */
+    hostObservation?: {
+        externalMeta?: Record<string, unknown>;
+        /**
+         * ISO time the host state was READ. The fence also refuses the move when a
+         * `host.*` op for the card settled (done/failed) after this instant — the
+         * read may predate our own write landing in the host.
+         */
+        observedAt?: string;
+    };
 }
 
 /**
@@ -866,6 +900,16 @@ interface KanbanStorageAdapter {
      * config and passes it as `initialLane`.
      */
     createCard(input: CreateCardServerInput): Promise<KanbanCard>;
+    /**
+     * p46 (P46-002) OPTIONAL: the card with this `externalRef` on this board, or
+     * null. When present, `engine.createCard({externalRef})` looks it up first and
+     * returns an existing card WITHOUT dispatching (exactly-once create per issue
+     * key). A host that stores `externalRef` SHOULD also make `createCard` itself
+     * idempotent on `(boardConfigUuid, externalRef)` (unique index + `ON CONFLICT
+     * DO NOTHING` → return the existing row) for the lookup/insert race. Hosts
+     * without external refs (crm/yobo) omit it.
+     */
+    getCardByExternalRef?(boardConfigUuid: string, externalRef: string): Promise<KanbanCard | null>;
     /**
      * Patch a card's mutable fields.
      */
@@ -1632,6 +1676,16 @@ declare class TransitionConflictError extends Error {
     readonly code = "transition_conflict";
     constructor(message?: string);
 }
+/**
+ * p46 (P46-002, D19/F8): thrown by a host-aware adapter's `applyTransition`
+ * when a HOST move (`move.hostObservation` set) targets a card that still has
+ * a `host.*` outbox op `pending` — Cadra's own half-done write to the host must
+ * never be mistaken for a human move. The sync skips the card this pass.
+ */
+declare class HostFenceError extends Error {
+    readonly code = "host_fence";
+    constructor(message?: string);
+}
 /**
  * Thrown by `listDueCards` when a `DueRule.kind` is not in the closed
  * vocabulary (design §6 — fail closed; never silently return everything).
@@ -1650,11 +1704,15 @@ interface InMemoryOp {
     status: "pending" | "done" | "failed";
     attempts: number;
     lastError?: string;
+    /** ISO time the op reached `done`/`failed` (p46 P46-002 host fence). */
+    settledAt?: string;
 }
 declare class InMemoryStorageAdapter implements KanbanStorageAdapter {
     private cards;
     private logs;
     private runs;
+    /** Lane KEY the card was in when each run was (re)claimed (idemKey → lane). */
+    private runLanes;
     private handoffs;
     private ops;
     private handoffSeq;
@@ -1681,6 +1739,7 @@ declare class InMemoryStorageAdapter implements KanbanStorageAdapter {
     });
     listCards(boardConfigUuid: string): Promise<KanbanCard[]>;
     getCard(cardId: string): Promise<KanbanCard | null>;
+    getCardByExternalRef(boardConfigUuid: string, externalRef: string): Promise<KanbanCard | null>;
     createCard(input: CreateCardServerInput): Promise<KanbanCard>;
     updateCard(cardId: string, patch: {
         title?: string;
@@ -1702,6 +1761,7 @@ declare class InMemoryStorageAdapter implements KanbanStorageAdapter {
         created: boolean;
         run: StageRun;
     }>;
+    private recordRunLane;
     /**
      * A stranded stage-run the next `beginStageRun` may re-claim (design §10): a
      * `failed` run (dispatch threw), or a `queued` run older than `staleQueuedMs`
@@ -2384,9 +2444,38 @@ interface BatchCompleteResult {
      */
     noop: number;
 }
+/** Options for {@link KanbanEngine.hostMove} (p46 P46-002, D22 + F8). */
+interface HostMoveOptions {
+    /**
+     * The lane the HOST SYNC observed the card in at the start of its pass. The
+     * move is a CAS on it — never a re-read: a Cadra move committed between the
+     * sync's read and this apply makes the move fail (`TransitionConflictError`)
+     * instead of silently moving the card back.
+     */
+    expectedFromLane: string;
+    /** Host facts written with the move inside the adapter's card lock. */
+    externalMeta?: Record<string, unknown>;
+    /**
+     * ISO time the sync READ the host state. The adapter fence then also refuses
+     * the move if a `host.*` op for this card settled after it (our own write may
+     * have landed after the read). Strongly recommended for a polling sync.
+     */
+    observedAt?: string;
+}
 interface KanbanEngine {
     createCard(boardConfigUuid: string, input: CreateCardInput): Promise<KanbanCard>;
     transition(cardId: string, toLane?: string, actor?: Actor): Promise<KanbanCard>;
+    /**
+     * p46 (P46-002, D22 + F8): mirror a move the EXTERNAL host made (a Jira drag)
+     * — the host owns the column, so NO manual edge is required. Keeps the CAS on
+     * `expectedFromLane`, logs `transitionId` = the matching edge id (any
+     * trigger) else `host:<from>-><to>`, passes `hostObservation` (the adapter's
+     * D19 fence + `externalMeta` write), writes `human_to_ai` on a
+     * non-automated → automated move (D5), and dispatches on entry.
+     * `toLane === card.lane` → no-op returning the card. Unknown lane → throws.
+     * Actor for Jira: `{ type: "system", id: "host:jira" }`.
+     */
+    hostMove(cardId: string, toLane: string, actor: Actor, opts: HostMoveOptions): Promise<KanbanCard>;
     runStage(cardId: string, stageId: string): Promise<{
         dispatched: boolean;
         executionUuid?: string;
@@ -2463,4 +2552,4 @@ interface KanbanLedgerEngine extends KanbanEngine {
 }
 declare function createEngine(options: CreateEngineOptions): KanbanLedgerEngine;
 
-export { ANSWERABLE_HANDOFF_KINDS, type Actor, type AdapterCapabilities, type AdapterFactory, type ApplyTransitionInput, type BatchCardCompletion, type BatchCardContext, type BatchCompleteResult, type BatchDispatchMeta, BoardConfigClient, type BoardConfigClientOptions, type BoardConfigHttp, CadraLifecycleSource, type CadraRunClient, CapabilitiesNotLoadedError, ConductorUnsupportedError, type ConformanceExpect, type ConformanceRunner, type CreateCardServerInput, type CreateEngineOptions, DEFAULT_BOARD_CEILING, type DueRule, type ExampleHostOptions, type FetchLike, HANDOFF_ANSWER_MAX_TEXT, HANDOFF_OUTPUT_MAX_BYTES, HANDOFF_PROMPT_PREAMBLE, HANDOFF_VERDICT_JSON_SCHEMA, HANDOFF_VERDICT_TASK_SUFFIX, type HandlerContext, type HandlerDispatchResult, type HandoffAnswer, HandoffAnswerError, type HandoffAnswerErrorCode, type HandoffDecision, type HandoffKind, type HandoffLedgerAdapter, type HandoffOption, type HandoffRecord, type HandoffState, type HandoffStatus, type HandoffV1, type HandoffVerdict, type HandoffVerdictKind, type HostRequest, type HostResponse, HttpAdapterError, HttpStorageAdapter, type HttpStorageAdapterConfig, type InMemoryOp, InMemoryStorageAdapter, type KanbanEngine, type KanbanLaneDispatch, type KanbanLaneHandoffMode, type KanbanLaneTrigger, type KanbanLedgerEngine, type KanbanStorageAdapter, type LaneHealth, type LaneHealthCheck, type LaneHealthReason, type LaneHealthState, type LifecycleRef, type LifecycleSource, type LifecycleSourceKind, NotScheduledLaneError, type ParseHandoffVerdictResult, type ResolveLifecycleRef, type ResolvedBoardConfig, type ResolvedLifecycle, type RunAgentInput, type RunDueStagesSummary, type RunRemoteAgentInput, type RunResult, type RunTeamInput, type Stage, type StageRun, type StageRunLedgerWrite, type StageRunStatus, type Transition, TransitionConflictError, type TransitionLogEntry, UnknownDueRuleError, WebhookDeliveryError, type WebhookDeliveryOptions, type WebhookSecret, createEngine, deliverWebhook, dispatchStageHandler, exampleHostHandler, hasHandoffLedger, hmacSign, isSafeHandoffUrl, mapDefinitionToBoard, parseHandoffVerdict, renderHandoffForPrompt, resolveAutoEdge, resolveManualEdge, runAdapterConformance, startExampleHost, toResolvedLifecycle };
+export { ANSWERABLE_HANDOFF_KINDS, type Actor, type AdapterCapabilities, type AdapterFactory, type ApplyTransitionInput, type BatchCardCompletion, type BatchCardContext, type BatchCompleteResult, type BatchDispatchMeta, BoardConfigClient, type BoardConfigClientOptions, type BoardConfigHttp, CadraLifecycleSource, type CadraRunClient, CapabilitiesNotLoadedError, ConductorUnsupportedError, type ConformanceExpect, type ConformanceRunner, type CreateCardServerInput, type CreateEngineOptions, DEFAULT_BOARD_CEILING, type DueRule, type ExampleHostOptions, type FetchLike, HANDOFF_ANSWER_MAX_TEXT, HANDOFF_OUTPUT_MAX_BYTES, HANDOFF_PROMPT_PREAMBLE, HANDOFF_VERDICT_JSON_SCHEMA, HANDOFF_VERDICT_TASK_SUFFIX, type HandlerContext, type HandlerDispatchResult, type HandoffAnswer, HandoffAnswerError, type HandoffAnswerErrorCode, type HandoffDecision, type HandoffKind, type HandoffLedgerAdapter, type HandoffOption, type HandoffRecord, type HandoffState, type HandoffStatus, type HandoffV1, type HandoffVerdict, type HandoffVerdictKind, HostFenceError, type HostMoveOptions, type HostRequest, type HostResponse, HttpAdapterError, HttpStorageAdapter, type HttpStorageAdapterConfig, type InMemoryOp, InMemoryStorageAdapter, type KanbanEngine, type KanbanLaneDispatch, type KanbanLaneHandoffMode, type KanbanLaneTrigger, type KanbanLedgerEngine, type KanbanStorageAdapter, type LaneHealth, type LaneHealthCheck, type LaneHealthReason, type LaneHealthState, type LifecycleRef, type LifecycleSource, type LifecycleSourceKind, NotScheduledLaneError, type ParseHandoffVerdictResult, type ResolveLifecycleRef, type ResolvedBoardConfig, type ResolvedLifecycle, type RunAgentInput, type RunDueStagesSummary, type RunRemoteAgentInput, type RunResult, type RunTeamInput, type Stage, type StageRun, type StageRunLedgerWrite, type StageRunStatus, type Transition, TransitionConflictError, type TransitionLogEntry, UnknownDueRuleError, WebhookDeliveryError, type WebhookDeliveryOptions, type WebhookSecret, createEngine, deliverWebhook, dispatchStageHandler, exampleHostHandler, hasHandoffLedger, hmacSign, isSafeHandoffUrl, mapDefinitionToBoard, parseHandoffVerdict, renderHandoffForPrompt, resolveAutoEdge, resolveManualEdge, runAdapterConformance, startExampleHost, toResolvedLifecycle };

package/dist/kanban/engine/index.d.ts

@@ -316,6 +316,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.
      *
@@ -378,6 +383,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>;
 }
 /**
  * Who performed a transition / stage-run (server-engine side).
@@ -495,6 +512,23 @@ interface ApplyTransitionInput {
     contextPatch?: Record<string, unknown>;
     /** Execution UUID to stamp on the card (handler advances). */
     executionUuid?: string;
+    /**
+     * p46 (P46-002, F8): set ONLY by `engine.hostMove` (a move the external host
+     * made — e.g. a Jira drag mirrored by the sync). A host-aware adapter, inside
+     * the same card lock as the `fromLane` CAS, (1) refuses the move with a
+     * `HostFenceError` while the card has any `host.*` op `pending` (D19 — never
+     * mistake our own half-done move for a human one), (2) writes `externalMeta`,
+     * then (3) moves. Adapters that don't know it ignore it (optional, additive).
+     */
+    hostObservation?: {
+        externalMeta?: Record<string, unknown>;
+        /**
+         * ISO time the host state was READ. The fence also refuses the move when a
+         * `host.*` op for the card settled (done/failed) after this instant — the
+         * read may predate our own write landing in the host.
+         */
+        observedAt?: string;
+    };
 }
 
 /**
@@ -866,6 +900,16 @@ interface KanbanStorageAdapter {
      * config and passes it as `initialLane`.
      */
     createCard(input: CreateCardServerInput): Promise<KanbanCard>;
+    /**
+     * p46 (P46-002) OPTIONAL: the card with this `externalRef` on this board, or
+     * null. When present, `engine.createCard({externalRef})` looks it up first and
+     * returns an existing card WITHOUT dispatching (exactly-once create per issue
+     * key). A host that stores `externalRef` SHOULD also make `createCard` itself
+     * idempotent on `(boardConfigUuid, externalRef)` (unique index + `ON CONFLICT
+     * DO NOTHING` → return the existing row) for the lookup/insert race. Hosts
+     * without external refs (crm/yobo) omit it.
+     */
+    getCardByExternalRef?(boardConfigUuid: string, externalRef: string): Promise<KanbanCard | null>;
     /**
      * Patch a card's mutable fields.
      */
@@ -1632,6 +1676,16 @@ declare class TransitionConflictError extends Error {
     readonly code = "transition_conflict";
     constructor(message?: string);
 }
+/**
+ * p46 (P46-002, D19/F8): thrown by a host-aware adapter's `applyTransition`
+ * when a HOST move (`move.hostObservation` set) targets a card that still has
+ * a `host.*` outbox op `pending` — Cadra's own half-done write to the host must
+ * never be mistaken for a human move. The sync skips the card this pass.
+ */
+declare class HostFenceError extends Error {
+    readonly code = "host_fence";
+    constructor(message?: string);
+}
 /**
  * Thrown by `listDueCards` when a `DueRule.kind` is not in the closed
  * vocabulary (design §6 — fail closed; never silently return everything).
@@ -1650,11 +1704,15 @@ interface InMemoryOp {
     status: "pending" | "done" | "failed";
     attempts: number;
     lastError?: string;
+    /** ISO time the op reached `done`/`failed` (p46 P46-002 host fence). */
+    settledAt?: string;
 }
 declare class InMemoryStorageAdapter implements KanbanStorageAdapter {
     private cards;
     private logs;
     private runs;
+    /** Lane KEY the card was in when each run was (re)claimed (idemKey → lane). */
+    private runLanes;
     private handoffs;
     private ops;
     private handoffSeq;
@@ -1681,6 +1739,7 @@ declare class InMemoryStorageAdapter implements KanbanStorageAdapter {
     });
     listCards(boardConfigUuid: string): Promise<KanbanCard[]>;
     getCard(cardId: string): Promise<KanbanCard | null>;
+    getCardByExternalRef(boardConfigUuid: string, externalRef: string): Promise<KanbanCard | null>;
     createCard(input: CreateCardServerInput): Promise<KanbanCard>;
     updateCard(cardId: string, patch: {
         title?: string;
@@ -1702,6 +1761,7 @@ declare class InMemoryStorageAdapter implements KanbanStorageAdapter {
         created: boolean;
         run: StageRun;
     }>;
+    private recordRunLane;
     /**
      * A stranded stage-run the next `beginStageRun` may re-claim (design §10): a
      * `failed` run (dispatch threw), or a `queued` run older than `staleQueuedMs`
@@ -2384,9 +2444,38 @@ interface BatchCompleteResult {
      */
     noop: number;
 }
+/** Options for {@link KanbanEngine.hostMove} (p46 P46-002, D22 + F8). */
+interface HostMoveOptions {
+    /**
+     * The lane the HOST SYNC observed the card in at the start of its pass. The
+     * move is a CAS on it — never a re-read: a Cadra move committed between the
+     * sync's read and this apply makes the move fail (`TransitionConflictError`)
+     * instead of silently moving the card back.
+     */
+    expectedFromLane: string;
+    /** Host facts written with the move inside the adapter's card lock. */
+    externalMeta?: Record<string, unknown>;
+    /**
+     * ISO time the sync READ the host state. The adapter fence then also refuses
+     * the move if a `host.*` op for this card settled after it (our own write may
+     * have landed after the read). Strongly recommended for a polling sync.
+     */
+    observedAt?: string;
+}
 interface KanbanEngine {
     createCard(boardConfigUuid: string, input: CreateCardInput): Promise<KanbanCard>;
     transition(cardId: string, toLane?: string, actor?: Actor): Promise<KanbanCard>;
+    /**
+     * p46 (P46-002, D22 + F8): mirror a move the EXTERNAL host made (a Jira drag)
+     * — the host owns the column, so NO manual edge is required. Keeps the CAS on
+     * `expectedFromLane`, logs `transitionId` = the matching edge id (any
+     * trigger) else `host:<from>-><to>`, passes `hostObservation` (the adapter's
+     * D19 fence + `externalMeta` write), writes `human_to_ai` on a
+     * non-automated → automated move (D5), and dispatches on entry.
+     * `toLane === card.lane` → no-op returning the card. Unknown lane → throws.
+     * Actor for Jira: `{ type: "system", id: "host:jira" }`.
+     */
+    hostMove(cardId: string, toLane: string, actor: Actor, opts: HostMoveOptions): Promise<KanbanCard>;
     runStage(cardId: string, stageId: string): Promise<{
         dispatched: boolean;
         executionUuid?: string;
@@ -2463,4 +2552,4 @@ interface KanbanLedgerEngine extends KanbanEngine {
 }
 declare function createEngine(options: CreateEngineOptions): KanbanLedgerEngine;
 
-export { ANSWERABLE_HANDOFF_KINDS, type Actor, type AdapterCapabilities, type AdapterFactory, type ApplyTransitionInput, type BatchCardCompletion, type BatchCardContext, type BatchCompleteResult, type BatchDispatchMeta, BoardConfigClient, type BoardConfigClientOptions, type BoardConfigHttp, CadraLifecycleSource, type CadraRunClient, CapabilitiesNotLoadedError, ConductorUnsupportedError, type ConformanceExpect, type ConformanceRunner, type CreateCardServerInput, type CreateEngineOptions, DEFAULT_BOARD_CEILING, type DueRule, type ExampleHostOptions, type FetchLike, HANDOFF_ANSWER_MAX_TEXT, HANDOFF_OUTPUT_MAX_BYTES, HANDOFF_PROMPT_PREAMBLE, HANDOFF_VERDICT_JSON_SCHEMA, HANDOFF_VERDICT_TASK_SUFFIX, type HandlerContext, type HandlerDispatchResult, type HandoffAnswer, HandoffAnswerError, type HandoffAnswerErrorCode, type HandoffDecision, type HandoffKind, type HandoffLedgerAdapter, type HandoffOption, type HandoffRecord, type HandoffState, type HandoffStatus, type HandoffV1, type HandoffVerdict, type HandoffVerdictKind, type HostRequest, type HostResponse, HttpAdapterError, HttpStorageAdapter, type HttpStorageAdapterConfig, type InMemoryOp, InMemoryStorageAdapter, type KanbanEngine, type KanbanLaneDispatch, type KanbanLaneHandoffMode, type KanbanLaneTrigger, type KanbanLedgerEngine, type KanbanStorageAdapter, type LaneHealth, type LaneHealthCheck, type LaneHealthReason, type LaneHealthState, type LifecycleRef, type LifecycleSource, type LifecycleSourceKind, NotScheduledLaneError, type ParseHandoffVerdictResult, type ResolveLifecycleRef, type ResolvedBoardConfig, type ResolvedLifecycle, type RunAgentInput, type RunDueStagesSummary, type RunRemoteAgentInput, type RunResult, type RunTeamInput, type Stage, type StageRun, type StageRunLedgerWrite, type StageRunStatus, type Transition, TransitionConflictError, type TransitionLogEntry, UnknownDueRuleError, WebhookDeliveryError, type WebhookDeliveryOptions, type WebhookSecret, createEngine, deliverWebhook, dispatchStageHandler, exampleHostHandler, hasHandoffLedger, hmacSign, isSafeHandoffUrl, mapDefinitionToBoard, parseHandoffVerdict, renderHandoffForPrompt, resolveAutoEdge, resolveManualEdge, runAdapterConformance, startExampleHost, toResolvedLifecycle };
+export { ANSWERABLE_HANDOFF_KINDS, type Actor, type AdapterCapabilities, type AdapterFactory, type ApplyTransitionInput, type BatchCardCompletion, type BatchCardContext, type BatchCompleteResult, type BatchDispatchMeta, BoardConfigClient, type BoardConfigClientOptions, type BoardConfigHttp, CadraLifecycleSource, type CadraRunClient, CapabilitiesNotLoadedError, ConductorUnsupportedError, type ConformanceExpect, type ConformanceRunner, type CreateCardServerInput, type CreateEngineOptions, DEFAULT_BOARD_CEILING, type DueRule, type ExampleHostOptions, type FetchLike, HANDOFF_ANSWER_MAX_TEXT, HANDOFF_OUTPUT_MAX_BYTES, HANDOFF_PROMPT_PREAMBLE, HANDOFF_VERDICT_JSON_SCHEMA, HANDOFF_VERDICT_TASK_SUFFIX, type HandlerContext, type HandlerDispatchResult, type HandoffAnswer, HandoffAnswerError, type HandoffAnswerErrorCode, type HandoffDecision, type HandoffKind, type HandoffLedgerAdapter, type HandoffOption, type HandoffRecord, type HandoffState, type HandoffStatus, type HandoffV1, type HandoffVerdict, type HandoffVerdictKind, HostFenceError, type HostMoveOptions, type HostRequest, type HostResponse, HttpAdapterError, HttpStorageAdapter, type HttpStorageAdapterConfig, type InMemoryOp, InMemoryStorageAdapter, type KanbanEngine, type KanbanLaneDispatch, type KanbanLaneHandoffMode, type KanbanLaneTrigger, type KanbanLedgerEngine, type KanbanStorageAdapter, type LaneHealth, type LaneHealthCheck, type LaneHealthReason, type LaneHealthState, type LifecycleRef, type LifecycleSource, type LifecycleSourceKind, NotScheduledLaneError, type ParseHandoffVerdictResult, type ResolveLifecycleRef, type ResolvedBoardConfig, type ResolvedLifecycle, type RunAgentInput, type RunDueStagesSummary, type RunRemoteAgentInput, type RunResult, type RunTeamInput, type Stage, type StageRun, type StageRunLedgerWrite, type StageRunStatus, type Transition, TransitionConflictError, type TransitionLogEntry, UnknownDueRuleError, WebhookDeliveryError, type WebhookDeliveryOptions, type WebhookSecret, createEngine, deliverWebhook, dispatchStageHandler, exampleHostHandler, hasHandoffLedger, hmacSign, isSafeHandoffUrl, mapDefinitionToBoard, parseHandoffVerdict, renderHandoffForPrompt, resolveAutoEdge, resolveManualEdge, runAdapterConformance, startExampleHost, toResolvedLifecycle };