yaml-flow 8.8.7 → 8.9.0

package/lib/board-live-cards-public-BT5HrgqZ.d.cts

@@ -1,529 +0,0 @@
-import { g as JournalStorage, K as KVStorage, B as BlobStorage, S as ScratchStorage, A as ArchiveFactory, f as QueueStorage, h as AtomicRelayLock, a as KindValueRef } from './storage-interface-D-iEiTJA.cjs';
-import { ExecutionRef } from './execution-refs.cjs';
-import { f as GraphEvent, G as GraphConfig } from './types-BBhqYGhE.cjs';
-
-/**
- * board-live-cards-lib — Pure logic library for the board-live-cards CLI.
- *
- * Merged from:
- *   board-live-cards-all-stores.ts
- *   board-live-cards-lib-types.ts
- *   board-live-cards-lib-board-status.ts
- *   board-live-cards-lib-card-handler.ts
- *   board-live-cards-cli-board-commands.ts
- *   board-live-cards-cli-card-commands.ts
- *   board-live-cards-cli-callbacks.ts
- *
- * Zero platform imports. All storage is injected via adapter interfaces.
- * Safe for Node, browser, and neutral (V8/PyMiniRacer) bundles.
- */
-
-interface LiveCard {
-    id: string;
-    [key: string]: unknown;
-}
-interface CardIndexEntry {
-    /** Storage-specific address (file path, Cosmos doc id, localStorage key). */
-    key: string;
-    /** Checksum of card content — computed by the adapter at write time. */
-    checksum: string;
-    updatedAt: string;
-}
-type CardIndex = Record<string, CardIndexEntry>;
-type CardChecksumIndex = Record<string, string>;
-interface CardStorageAdapter {
-    readIndex(): CardIndex | null;
-    writeIndex(index: CardIndex): void;
-    readCard(key: string): LiveCard | null;
-    /** Write card content; returns checksum of what was written. */
-    writeCard(key: string, card: LiveCard): string;
-    removeCard(key: string): void;
-    cardExists(key: string): boolean;
-    defaultCardKey(cardId: string): string;
-}
-interface CardStore {
-    readCard(id: string): LiveCard | null;
-    readCardKey(id: string): string | null;
-    readAllCards(): LiveCard[];
-    readChecksumIndex(): CardChecksumIndex;
-    changedSince(snapshotChecksumIndex: CardChecksumIndex): string[];
-}
-interface CardUpsertValidation {
-    ok: boolean;
-    error?: string;
-}
-interface CardAdminStore extends CardStore {
-    validateUpsert(id: string, cardKey: string): CardUpsertValidation;
-    writeCard(id: string, card: LiveCard, cardKey?: string): void;
-    patchCard(id: string, jsonPath: string, value: unknown): void;
-    removeCard(id: string): void;
-    readIndex(): CardIndex;
-}
-declare function createCardStore(adapter: CardStorageAdapter, onWarn?: (msg: string) => void): CardAdminStore;
-interface JournalEntry {
-    id: string;
-    event: GraphEvent;
-}
-interface JournalStorageAdapter {
-    readAllEntries(): JournalEntry[];
-    appendEntry(entry: JournalEntry): void;
-    generateId(): string;
-}
-declare const SNAPSHOT_SCHEMA_VERSION_V1 = "v1";
-declare const BOARD_GRAPH_KEY = "board/graph";
-interface StateSnapshotReadView {
-    version: string | null;
-    values: Record<string, unknown>;
-}
-type OutputStoreEvent = {
-    kind: 'computed_values';
-    cardId: string;
-    values: Record<string, unknown>;
-} | {
-    kind: 'data_object';
-    key: string;
-    payload: unknown;
-} | {
-    kind: 'status';
-    status: unknown;
-};
-interface BoardStatusCard {
-    name: string;
-    status: string;
-    error?: {
-        message: string;
-        code?: string;
-        at?: string;
-        source?: 'task-runtime' | 'source-fetch' | 'timeout' | 'unknown';
-    };
-    requires: string[];
-    requires_satisfied: string[];
-    requires_missing: string[];
-    provides_declared: string[];
-    provides_runtime: string[];
-    blocked_by: string[];
-    unblocks: string[];
-    runtime: {
-        attempt_count: number;
-        restart_count: number;
-        in_progress_since: string | null;
-        last_transition_at: string | null;
-        last_completed_at: string | null;
-        last_restarted_at: string | null;
-        status_age_ms: number | null;
-    };
-}
-interface BoardStatusObject {
-    schema_version: 'v1';
-    meta: {
-        board: {
-            path: string;
-        };
-    };
-    summary: {
-        card_count: number;
-        completed: number;
-        eligible: number;
-        pending: number;
-        blocked: number;
-        unresolved: number;
-        failed?: number;
-        in_progress?: number;
-        orphan_cards?: number;
-        topology?: {
-            edge_count: number;
-            max_fan_out_card: string | null;
-            max_fan_out: number;
-        };
-    };
-    cards: BoardStatusCard[];
-}
-declare const EMPTY_CONFIG: GraphConfig;
-
-/**
- * chat-storage-lib.ts
- *
- * ChatStorage interface + factories backed by JournalStorage (history) and
- * KVStorage (processing state and config).
- *
- * Platform-free — no node:fs or node:crypto imports.
- */
-
-type Awaitable<T> = T | Promise<T>;
-interface ChatRecord {
-    /** Journal entry id — also used as SSE cursor. */
-    id: string;
-    role: string;
-    text: string;
-    files: unknown[];
-    turn: string;
-    updated_at: string;
-}
-interface ChatConfig {
-    systemPrompt?: string;
-}
-interface ChatReadAfterResult {
-    records: ChatRecord[];
-    /** Pass as cursor on the next call. Null when the journal is empty. */
-    cursor: string | null;
-}
-interface ChatStorage {
-    /** Append a message; returns the new entry id (usable as a cursor). */
-    append(cardId: string, role: string, text: string, files?: unknown[], turn?: string): Awaitable<string>;
-    /** Read all messages in insertion order. */
-    readAll(cardId: string): Awaitable<ChatRecord[]>;
-    /**
-     * Read messages appended after cursor.
-     * Pass null to read from the beginning.
-     */
-    readAfter(cardId: string, cursor: string | null): Awaitable<ChatReadAfterResult>;
-    /** Remove all messages for this card. */
-    clear(cardId: string): Awaitable<void>;
-    setProcessing(cardId: string, active: boolean): Awaitable<void>;
-    isProcessing(cardId: string): Awaitable<boolean>;
-    getConfig(cardId: string): Awaitable<ChatConfig>;
-    setConfig(cardId: string, patch: Partial<ChatConfig>): Awaitable<void>;
-}
-/**
- * Create a ChatStorage backed by:
- *  - journalFactory(cardId) → JournalStorage  (one per-card journal for history)
- *  - kv                     → KVStorage       (shared processing flags + config)
- */
-declare function createChatStorage(journalFactory: (cardId: string) => JournalStorage, kv: KVStorage): ChatStorage;
-declare function createInMemoryChatStorage(): ChatStorage;
-
-interface BoardTaskCallback {
-    token: string;
-    via: ExecutionRef;
-}
-interface BoardCallbackTransport {
-    createCallback(token: string): BoardTaskCallback;
-}
-declare function createHttpBoardCallbackTransport(baseUrl: string): BoardCallbackTransport;
-declare function createInProcessBoardCallbackTransport(handlerKey: string): BoardCallbackTransport;
-declare function createLocalNodeBoardCallbackTransport(opts?: string | {
-    notifyChannel?: string;
-    boardRuntimeStoreRef?: string;
-    queueStoreRef?: string;
-}): BoardCallbackTransport;
-
-/**
- * board-live-cards-public.ts
- *
- * Platform-free public API layer for the board-live-cards system.
- *
- * ─────────────────────────────────────────────────────────────────────────────
- * LAYER DIAGRAM
- * ─────────────────────────────────────────────────────────────────────────────
- *
- *   board-live-cards-cli.ts       (THIN — arg parse → call public → print JSON)
- *           ↓ calls
- *   board-live-cards-public.ts    (THIS FILE — facade, all logic, no platform code)
- *           ↓ depends on injected
- *   board-live-cards-lib.ts       (pure domain — stores, graph, codecs)
- *
- * ─────────────────────────────────────────────────────────────────────────────
- * PLATFORM ADAPTERS  (injected into BoardPlatformAdapter)
- * ─────────────────────────────────────────────────────────────────────────────
- *
- *   Node/FS         createFsBoardPlatformAdapter(baseRef, cliDir)
- *   Azure Functions createAzureBoardPlatformAdapter(baseRef, containerClient, …)
- *   Firebase Fn     createFirebaseBoardPlatformAdapter(baseRef, firestoreDb, …)
- *   In-memory/test  createInMemoryBoardPlatformAdapter(baseRef)
- *
- * ─────────────────────────────────────────────────────────────────────────────
- * USAGE
- * ─────────────────────────────────────────────────────────────────────────────
- *
- *   const board = createBoardLiveCardsPublic(baseRef, adapter);
- *   const status = board.status();
- */
-
-type CommandInput = {
-    params?: Record<string, string | number | boolean>;
-    body?: unknown;
-};
-type CommandResult<T = undefined> = (T extends undefined ? {
-    status: 'success';
-} : {
-    status: 'success';
-    data: T;
-}) | {
-    status: 'fail';
-    error: string;
-} | {
-    status: 'error';
-    error: string;
-};
-interface BoardPlatformAdapter {
-    /**
-     * KV storage factory — scoped by namespace.
-     * Namespaces used by the public layer:
-     *   'state-snapshot'     — board graph snapshot (StateSnapshotStorageAdapter, built internally)
-     *   'config'             — board configuration (.task-executor, .chat-handler, .chat-handler-flow, .card-store-ref)
-     *   'card-upsert'        — card upsert dedup index
-     *   'execution-requests' — queued execution requests (keyed by journalId)
-     *   'card-runtime'       — card runtime state snapshots
-     *   'output'             — published board status + card computed outputs
-     */
-    kvStorage(namespace: string): KVStorage;
-    /**
-     * Build a KVStorage rooted at the given ref.
-     * Used by the public layer for both card store and outputs store routing.
-     *   FS:          createFsKvStorage(parseRef(ref).value)
-     *   localStorage: createLocalStorageKvStorage(parseRef(ref).value)
-     */
-    kvStorageForRef(ref: string): KVStorage;
-    /**
-     * Blob storage factory — scoped by namespace.
-     * Namespaces used by the public layer:
-     *   ''        — root-scoped blob access (for resolving arbitrary KindValueRef blobs)
-     */
-    blobStorage(namespace: string): BlobStorage;
-    blobStorageForRef(ref: string): BlobStorage;
-    chatStorageForRef(ref: string): ChatStorage;
-    /**
-     * Ephemeral scratch store for transient I/O staging (probe in/out/err,
-     * dispatchExecution argv/out/err). Default scope is board-local; if the
-     * config has a 'scratch-store-ref' set, scratchStorageForRef(ref) is used
-     * instead.
-     */
-    scratchStorage(): ScratchStorage;
-    scratchStorageForRef(ref: string): ScratchStorage;
-    /**
-     * Archive factory — long-lived tracking / audit store. Default scope is
-     * board-local; if the config has an 'archive-store-ref' set,
-     * archiveFactoryForRef(ref) is used instead so archives can live on a
-     * different backend / path than the main board runtime.
-     */
-    archiveFactory(): ArchiveFactory;
-    archiveFactoryForRef(ref: string): ArchiveFactory;
-    /**
-     * Journal storage adapter (append-only log).
-     * Uses the lib's JournalStorageAdapter interface.
-     * One journal per board — no namespace parameter needed.
-     */
-    journalAdapter(): JournalStorageAdapter;
-    journalAdapterForRef(ref: string): JournalStorageAdapter;
-    /**
-     * Queue storage lane resolved from an explicit queue store ref.
-     * The adapter chooses the backend from the ref; lane chooses the internal queue.
-     */
-    queueStorageForRef(ref: string, lane: string): QueueStorage;
-    /**
-     * AtomicRelayLock — non-blocking try-acquire with relay-on-busy semantics.
-     * Guards processAccumulatedEvents drain cycle.
-     *   FS:        proper-lockfile (createFsAtomicRelayLock)
-     *   Azure:     blob lease
-     *   Firestore: Firestore transaction + sentinel document
-     */
-    lock: AtomicRelayLock;
-    /**
-     * Adapter-owned callback transport used to build worker callback payloads.
-     * The board core treats callback delivery as a platform concern.
-     */
-    callbackTransport?: BoardCallbackTransport;
-    /**
-     * Generic execution dispatch — platform adapts ExecutionRef → actual transport.
-     * Public layer constructs fully-formed semantic args (source def, base_ref,
-     * callback token with selfRef baked in). Platform handles transport:
-      *   Node host adapter: may write args to temp file and may spawn a detached process
-     *   Azure: HTTP POST args as JSON body
-     *   Firebase: publishes args as pubsub message
-     */
-    dispatchExecution(ref: ExecutionRef, args: Record<string, unknown>): Promise<{
-        dispatched: boolean;
-        error?: string;
-    }>;
-    /**
-     * Whether dispatchExecution can accept a board-owned staged source output ref
-     * for this executor. When false/absent, the adapter keeps its legacy staging
-     * protocol such as scratch in/out refs for local process launch.
-     */
-    supportsDirectSourceOutput?(ref: ExecutionRef): boolean;
-    /**
-     * Resolve a blob ref to its string contents.
-     * The adapter handles the platform-specific lookup (e.g. absolute FS path vs board-relative key).
-     * Throws if the blob does not exist.
-     */
-    resolveBlob(ref: KindValueRef): string;
-    /**
-     * Compute a stable, deterministic content hash for any JSON-serializable value.
-     * Used for dedup indexes and snapshot versioning.
-     *   Node/FS: computeStableJsonHash (storage-fs-adapters)
-     *   Browser: Web Crypto subtle.digest or equivalent
-     */
-    hashFn(value: unknown): string;
-    /**
-     * Generate a random short ID (32 hex chars).
-     * Used for commit IDs and delivery tokens.
-     *   Node/FS: getHash(`${Date.now()}-${Math.random()}`).slice(0, 32)
-     *   Browser: crypto.randomUUID().replace(/-/g, '')
-     */
-    genId(): string;
-    /**
-     * Request an additional drain pass asynchronously (e.g. spawn a background process).
-     * Called as the relay continuation after each drain cycle so that events written
-     * during the cycle (e.g. task-completed appended by the card handler) are eventually
-     * processed even when the current process exits immediately after returning.
-     * Optional — if absent, no continuation is scheduled.
-     */
-    requestProcessAccumulated?(): void;
-    /**
-     * Optional cross-process board change notification publisher (named pipe, webhook, pubsub, etc.).
-     * Called once per drain cycle with the complete batch of notifications produced in that cycle.
-     */
-    publishBoardChangeNotifications?(notifications: BoardChangeNotification[]): void | Promise<void>;
-    /** Optional warn sink — defaults to no-op. */
-    onWarn?(msg: string): void;
-}
-interface BoardLiveCardsPublic {
-    init(input: CommandInput): CommandResult;
-    status(input: CommandInput): CommandResult<BoardStatusObject>;
-    getBoardRuntimeStoreRef(input: CommandInput): CommandResult<{
-        storeRef: string | null;
-    }>;
-    getCardStoreRef(input: CommandInput): CommandResult<{
-        storeRef: string;
-    }>;
-    getOutputsStoreRef(input: CommandInput): CommandResult<{
-        storeRef: string;
-    }>;
-    getScratchStoreRef(input: CommandInput): CommandResult<{
-        storeRef: string | null;
-    }>;
-    getChatStoreRef(input: CommandInput): CommandResult<{
-        storeRef: string | null;
-    }>;
-    getArtifactsStoreRef(input: CommandInput): CommandResult<{
-        storeRef: string | null;
-    }>;
-    getFetchedSourcesStoreRef(input: CommandInput): CommandResult<{
-        storeRef: string | null;
-    }>;
-    getConfig(input: CommandInput): CommandResult<{
-        value: unknown;
-    }>;
-    getOutputsDataObject(input: CommandInput): CommandResult;
-    getAllOutputsDataObjects(input: CommandInput): CommandResult<Record<string, unknown>>;
-    getOutputsComputedValues(input: CommandInput): CommandResult;
-    getAllOutputsComputedValues(input: CommandInput): CommandResult<Record<string, unknown>>;
-    getOutputsFetchedSources(input: CommandInput): CommandResult<Record<string, string>>;
-    getAllOutputsFetchedSources(input: CommandInput): CommandResult<Record<string, Record<string, string>>>;
-    removeCard(input: CommandInput): CommandResult;
-    addCardFiles(input: CommandInput): CommandResult<{
-        cardId: string;
-        files_added: Array<{
-            idx: number;
-            entry: unknown;
-        }>;
-        notified: true;
-    }>;
-    cardRefreshedNotify(input: CommandInput): CommandResult;
-    retrigger(input: CommandInput): CommandResult;
-    processAccumulatedEvents(input: CommandInput): Promise<CommandResult>;
-    upsertCard(input: CommandInput): CommandResult;
-    taskFailed(input: CommandInput): CommandResult;
-    taskProgress(input: CommandInput): CommandResult;
-    sourceDataFetched(input: CommandInput): CommandResult;
-    sourceDataFetchFailure(input: CommandInput): CommandResult;
-}
-type BoardChangeNotification = OutputStoreEvent | {
-    kind: 'card_refreshed';
-    cardId: string;
-    card: LiveCard;
-} | {
-    kind: 'card_removed';
-    cardId: string;
-};
-interface BoardLiveCardsPublicOptions {
-    boardRuntimeStoreRef?: string;
-    scratchStoreRef?: string;
-    taskExecutorRef?: ExecutionRef;
-    chatHandlerFlow?: unknown;
-}
-declare function createBoardLiveCardsPublic(baseRef: KindValueRef, adapter: BoardPlatformAdapter, options?: BoardLiveCardsPublicOptions): BoardLiveCardsPublic;
-interface BoardNonCorePlatformAdapter extends BoardPlatformAdapter {
-    /**
-     * Invoke a task executor subcommand and return stdout.
-     * Throws on transport failure, non-zero exit, or timeout.
-     */
-    invokeExecutor(ref: ExecutionRef, subcommand: string, opts?: {
-        timeout?: number;
-        input?: string;
-    }): Promise<string>;
-    /** Schema-only card validator (no executor invocation). */
-    validateSchema(card: Record<string, unknown>): {
-        ok: boolean;
-        errors: string[];
-    };
-    /** Absolute-path blob I/O for resolving arbitrary KindValueRef blobs. */
-    absoluteBlob: BlobStorage;
-    /**
-    * Default timeouts (ms) for executor request/response calls.
-     * Each field can also be overridden per-source via source_def.timeout.
-     *
-     *   validationMs — validate-source-def, validate-card-preflight (structural, fast). Default: 10_000.
-      *   preflightMs  — source preflight executor hooks (probe-source-preflight). Default: 60_000.
-     *   probeMs      — run-source-fetch in probe/simulation paths. Default: 60_000.
-     *   describeMs   — describe-capabilities introspection. Default: 10_000.
-     */
-    executorTimeouts?: {
-        validationMs?: number;
-        preflightMs?: number;
-        probeMs?: number;
-        describeMs?: number;
-    };
-}
-interface BoardLiveCardsNonCorePublic {
-    /** body: { "card-content": <card> } — card JSON arrives via stdin; validates schema + JSONata + provides refs + source_defs (executor, if configured) */
-    validateCardPreflight(input: CommandInput): Promise<CommandResult<{
-        cardId: string;
-        isValid: boolean;
-        issues: string[];
-    }>>;
-    /** body: { "card-content": <card>, "mock-projections"?: {} }; params: sourceIdx, outRef? — card JSON arrives via stdin; no board state needed */
-    probeSourcePreflight(input: CommandInput): Promise<CommandResult>;
-    /** body: { "card-content": <card>, "mock-projections"?: {} }; params: sourceIdx, outRef? — runs the real source fetch flow as a preflight */
-    runSourcePreflight(input: CommandInput): Promise<CommandResult<{
-        bindTo: string;
-        ok: boolean;
-        result: unknown;
-        issues: string[];
-    }>>;
-    /** body: { "card-content": <card>, "mock-fetched-sources"?: {}, "mock-requires"?: {} } — evaluates compute expressions with supplied data; no board state needed */
-    evalCardCompute(input: CommandInput): CommandResult<{
-        cardId: string;
-        ok: boolean;
-        computed_values: Record<string, unknown>;
-        errors: Array<{
-            bindTo: string;
-            error: string;
-        }>;
-    }>;
-    /** body: { "card-content": <card>, "mock-fetched-sources"?: {}, "mock-requires"?: {} } — full cycle: validate → resolve projections → probe sources → compute */
-    simulateCardCycle(input: CommandInput): Promise<CommandResult>;
-    /** no params needed */
-    describeTaskExecutorCapabilities(input: CommandInput): Promise<CommandResult>;
-    /**
-     * Write/update cards in the configured card store.
-     * body: { ops: Array<{ op: 'update', id: string, 'card-content': LiveCard }> }
-     */
-    updatesInCardStore(input: CommandInput): CommandResult;
-    /**
-     * Read cards from the configured card store by id.
-     * body: { ids: string[] }
-     */
-    readFromCardStore(input: CommandInput): CommandResult<{
-        cards: Array<{
-            id: string;
-            'card-content': LiveCard | null;
-        }>;
-    }>;
-}
-declare function createBoardLiveCardsNonCorePublic(baseRef: KindValueRef, adapter: BoardNonCorePlatformAdapter, opts?: {
-    boardRuntimeStoreRef?: string;
-    taskExecutorRef?: ExecutionRef;
-}): BoardLiveCardsNonCorePublic;
-
-export { type BoardChangeNotification as B, type CommandInput as C, EMPTY_CONFIG as E, type LiveCard as L, type StateSnapshotReadView as S, type CommandResult as a, type CardAdminStore as b, type BoardLiveCardsPublic as c, type BoardNonCorePlatformAdapter as d, type BoardPlatformAdapter as e, type ChatStorage as f, type ChatRecord as g, type ChatReadAfterResult as h, type ChatConfig as i, type BoardStatusObject as j, type BoardCallbackTransport as k, type BoardLiveCardsNonCorePublic as l, type CardChecksumIndex as m, type CardUpsertValidation as n, type CardIndex as o, BOARD_GRAPH_KEY as p, SNAPSHOT_SCHEMA_VERSION_V1 as q, createBoardLiveCardsNonCorePublic as r, createBoardLiveCardsPublic as s, createCardStore as t, createChatStorage as u, createHttpBoardCallbackTransport as v, createInMemoryChatStorage as w, createInProcessBoardCallbackTransport as x, createLocalNodeBoardCallbackTransport as y, type BoardLiveCardsPublicOptions as z };