botmux 2.88.0 → 2.89.0

package/dist/im/lark/workflows-card.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Workflows dashboard card.
+ *
+ * The list view is compact, paginated, refreshable, and read-only except for
+ * per-row detail entry. The detail view exposes cancel and back actions.
+ *
+ * Cancel callbacks block on Route B and then refetch because a workflow can
+ * land in its terminal state asynchronously. If refetch fails or the row
+ * disappears, the card falls back to a cancelled-state synth so the user still
+ * gets a usable detail view, possibly stale for one render. Failures return
+ * toast-only.
+ *
+ * Security:
+ *  - `invokerOpenId` pins callbacks to the admin who opened the card.
+ *  - sender union_id never lands on `action.value`.
+ *  - command entry and callbacks both enforce the dashboard admin gate.
+ *  - row ids are routing keys only; Route B still enforces row ownership.
+ *  - cancel re-runs the model availability matrix and owner-routability check
+ *    before POSTing.
+ */
+import type { WorkflowRunDetailDto, WorkflowRunInput } from '../../dashboard/workflow-card-model.js';
+import type { DaemonClient } from '../../dashboard/daemon-internal-client.js';
+import { type Locale } from '../../i18n/index.js';
+import type { CardActionData } from './card-handler.js';
+export declare const WORKFLOWS_ACTION_REFRESH: "dash_workflows_refresh";
+export declare const WORKFLOWS_ACTION_PAGE: "dash_workflows_page";
+export declare const WORKFLOWS_ACTION_DETAIL: "dash_workflows_detail";
+export declare const WORKFLOWS_ACTION_CANCEL: "dash_workflows_cancel";
+export declare const WORKFLOWS_ACTION_BACK_TO_LIST: "dash_workflows_back_to_list";
+export interface BuildWorkflowsCardOpts {
+    invokerOpenId: string;
+    locale: Locale;
+    /** 1-based page index. Caller clamps; this just renders what's given. */
+    page: number;
+    /** Page size override, threaded through every button value. */
+    pageSize?: number;
+    /** Navigation origin. `'overview'` means this card was opened via
+     *  `/dashboard overview` → goto workflows; the footer renders an extra
+     *  "🔙 返回总览" button, and every button.value carries `origin=overview`
+     *  to keep that affordance across rebuilds. Undefined → standalone card. */
+    origin?: 'overview';
+    /** Dashboard scope. `'global'` means `/dashboard` shows workflow runs
+     *  from every bot, and cancel callbacks route by the run's true owner. */
+    scope?: 'global';
+}
+/** Build the workflows list card JSON. Pure (paginates + renders).
+ *  Server-side listRuns order is preserved verbatim — no client-side resort.
+ *  See module docblock for the rationale. */
+export declare function buildWorkflowsCard(rows: ReadonlyArray<WorkflowRunInput>, opts: BuildWorkflowsCardOpts, nowMs: number): string;
+/** Options for the detail card. */
+export interface BuildWorkflowsDetailCardOpts {
+    invokerOpenId: string;
+    locale: Locale;
+    /** Override `Date.now()` so the relative-time formatter is deterministic in tests. */
+    nowMs?: number;
+    /** Overview drilldown nav state — threaded into the "🔙 返回" button so the
+     *  list rebuilt by `BACK_TO_LIST` is still drilldown-shaped (5/page +
+     *  return-to-overview). Detail itself does NOT render a return-to-overview
+     *  button. */
+    origin?: 'overview';
+    pageSize?: number;
+    /** Source list page. Detail actions round-trip this so BACK_TO_LIST restores
+     *  the page that opened the detail card. */
+    sourcePage?: number;
+    /** Dashboard scope. Threaded into cancel/back buttons. */
+    scope?: 'global';
+}
+/**
+ * Build the workflow detail card: run metadata, optional node progress, cancel
+ * action, and back action.
+ *
+ * The cancel button is disabled when EITHER:
+ *   - `computeActionAvailability(status).cancel.enabled === false`
+ *     (terminal status: succeeded / failed / cancelled), OR
+ *   - `chatBinding.larkAppId` is missing — no routable owner for Route B to
+ *     proxy to. The `runCancel` helper would 409 `needs_cli_cancel` here, so
+ *     we fail-closed at the UI layer too.
+ * Both disabled reasons surface as inline notes next to the button.
+ */
+export declare function buildWorkflowsDetailCard(detail: WorkflowRunDetailDto, opts: BuildWorkflowsDetailCardOpts): string;
+/** ─── Handler ─────────────────────────────────────────────────────────── */
+export interface WorkflowsCardHandlerDeps {
+    getOwnerOpenId?: (larkAppId: string) => string | undefined;
+    getDashboardAdminOpenIds?: (larkAppId: string) => ReadonlyArray<string> | undefined;
+    createClient: (larkAppId: string) => DaemonClient;
+    locale?: Locale;
+    /** Override `Date.now()` so tests are deterministic. */
+    nowMs?: () => number;
+}
+export interface WorkflowsCardHandlerResult {
+    toast?: {
+        type: 'info' | 'success' | 'error';
+        content: string;
+    };
+    card?: {
+        type: 'raw';
+        data: Record<string, unknown>;
+    };
+}
+/** Dispatch a `dash_workflows_*` action callback. */
+export declare function handleWorkflowsCardAction(data: CardActionData, larkAppId: string, deps: WorkflowsCardHandlerDeps): Promise<WorkflowsCardHandlerResult>;
+//# sourceMappingURL=workflows-card.d.ts.map

package/dist/im/lark/workflows-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows-card.d.ts","sourceRoot":"","sources":["../../../src/im/lark/workflows-card.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EACV,oBAAoB,EAEpB,gBAAgB,EAEjB,MAAM,wCAAwC,CAAC;AAMhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AAC9E,OAAO,EAAE,KAAK,MAAM,EAAK,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,eAAO,MAAM,wBAAwB,EAAG,wBAAiC,CAAC;AAC1E,eAAO,MAAM,qBAAqB,EAAG,qBAA8B,CAAC;AACpE,eAAO,MAAM,uBAAuB,EAAG,uBAAgC,CAAC;AACxE,eAAO,MAAM,uBAAuB,EAAG,uBAAgC,CAAC;AACxE,eAAO,MAAM,6BAA6B,EAAG,6BAAsC,CAAC;AAgDpF,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;gFAG4E;IAC5E,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB;8EAC0E;IAC1E,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAkDD;;6CAE6C;AAC7C,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,aAAa,CAAC,gBAAgB,CAAC,EACrC,IAAI,EAAE,sBAAsB,EAC5B,KAAK,EAAE,MAAM,GACZ,MAAM,CA6KR;AAiDD,mCAAmC;AACnC,MAAM,WAAW,4BAA4B;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;kBAGc;IACd,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;gDAC4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,4BAA4B,GACjC,MAAM,CAwNR;AAyBD,8EAA8E;AAE9E,MAAM,WAAW,wBAAwB;IACvC,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC3D,wBAAwB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACpF,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,YAAY,CAAC;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;CACvD;AAcD,qDAAqD;AACrD,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,cAAc,EACpB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,0BAA0B,CAAC,CA0MrC"}