@stigmer/react 1.0.3 → 2.0.0

package/workflow/execution-inspector/derive-task-detail.js

@@ -0,0 +1,352 @@
+/**
+ * Pure derivation function that extracts rich per-task detail from
+ * the execution event stream and status snapshot.
+ *
+ * No React dependencies — independently testable and usable outside
+ * the inspector component.
+ *
+ * @since T05 (Runtime Inspector)
+ */
+import { WorkflowTaskKind } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/enum_pb";
+import { kindToDisplayName } from "../kind-metadata";
+import { taskKindToString } from "../workflow-graph-conversions";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const BIGINT_ZERO = BigInt(0);
+// ---------------------------------------------------------------------------
+// Main derivation
+// ---------------------------------------------------------------------------
+/**
+ * Derives rich per-task detail by joining the event stream with the
+ * status snapshot.
+ *
+ * Returns `null` when no data is available for the given task name
+ * (no events AND no snapshot entry).
+ */
+export function deriveTaskDetail(taskName, events, taskSnapshot, derivedState) {
+    const taskEvents = events.filter((e) => e.taskName === taskName);
+    if (taskEvents.length === 0 && !taskSnapshot && !derivedState) {
+        return null;
+    }
+    const buckets = bucketEvents(taskEvents);
+    const summary = buildSummary(taskSnapshot, derivedState, buckets);
+    const input = buildIO(taskSnapshot?.input, buckets.inputSummary, taskSnapshot?.artifactIds ?? []);
+    const output = buildIO(taskSnapshot?.output, buckets.outputSummary, []);
+    const snapshotMeta = taskSnapshot?.metadata
+        ? taskSnapshot.metadata
+        : undefined;
+    const error = buildError(buckets, snapshotMeta);
+    const retries = buildRetryHistory(buckets);
+    const taskKind = derivedState?.taskKind ??
+        buckets.taskKind ??
+        WorkflowTaskKind.workflow_task_kind_unspecified;
+    const agentCall = buildAgentCall(buckets, taskKind, snapshotMeta);
+    const approval = buildApproval(buckets, taskSnapshot?.output);
+    const status = derivedState?.status ?? "pending";
+    const displayName = kindToDisplayName(taskKindToString(taskKind));
+    return {
+        taskName,
+        taskKind,
+        displayName,
+        status,
+        summary,
+        input,
+        output,
+        error,
+        retries,
+        agentCall,
+        approval,
+        eventLog: taskEvents,
+    };
+}
+function bucketEvents(taskEvents) {
+    const buckets = {
+        taskKind: undefined,
+        starts: [],
+        completions: [],
+        failures: [],
+        retryings: [],
+        skipped: null,
+        agentStarted: null,
+        agentProgress: null,
+        agentCompleted: null,
+        approvalRequested: null,
+        approvalResolved: null,
+        inputSummary: null,
+        outputSummary: null,
+    };
+    for (const evt of taskEvents) {
+        const p = evt.payload;
+        switch (p.case) {
+            case "taskStarted":
+                buckets.taskKind ??= p.value.taskKind;
+                buckets.starts.push({
+                    attemptNumber: p.value.attemptNumber,
+                    occurredAt: evt.occurredAt,
+                    inputSummary: p.value.inputSummary,
+                });
+                if (p.value.inputSummary) {
+                    buckets.inputSummary = p.value.inputSummary;
+                }
+                break;
+            case "taskCompleted":
+                buckets.taskKind ??= p.value.taskKind;
+                buckets.completions.push({
+                    durationMs: Number(p.value.durationMs),
+                    costMicros: p.value.costMicros,
+                    tokensUsed: p.value.tokensUsed,
+                    outputSummary: p.value.outputSummary,
+                });
+                if (p.value.outputSummary) {
+                    buckets.outputSummary = p.value.outputSummary;
+                }
+                break;
+            case "taskFailed":
+                buckets.taskKind ??= p.value.taskKind;
+                buckets.failures.push({
+                    attemptNumber: p.value.attemptNumber,
+                    maxAttempts: p.value.maxAttempts,
+                    willRetry: p.value.willRetry,
+                    error: p.value.error,
+                    durationMs: Number(p.value.durationMs),
+                });
+                break;
+            case "taskSkipped":
+                buckets.taskKind ??= p.value.taskKind;
+                buckets.skipped = { reason: p.value.reason };
+                break;
+            case "taskRetrying":
+                buckets.retryings.push({
+                    failedAttempt: p.value.failedAttempt,
+                    nextAttempt: p.value.nextAttempt,
+                    delayMs: Number(p.value.delayMs),
+                });
+                break;
+            case "agentCallStarted":
+                buckets.agentStarted = {
+                    childExecutionId: p.value.childExecutionId,
+                    agentSlug: p.value.agentSlug,
+                    messageSummary: p.value.messageSummary,
+                };
+                break;
+            case "agentCallProgress":
+                buckets.agentProgress = {
+                    childExecutionId: p.value.childExecutionId,
+                    agentPhase: p.value.agentPhase,
+                    currentToolName: p.value.currentToolName,
+                    tokensConsumed: p.value.tokensConsumed,
+                    messagesCount: p.value.messagesCount,
+                    toolCallsCount: p.value.toolCallsCount,
+                };
+                break;
+            case "agentCallCompleted":
+                buckets.agentCompleted = {
+                    durationMs: Number(p.value.durationMs),
+                    tokensConsumed: p.value.tokensConsumed,
+                    costMicros: p.value.costMicros,
+                    error: p.value.error,
+                    agentPhase: p.value.agentPhase,
+                };
+                break;
+            case "approvalRequested":
+                buckets.approvalRequested = {
+                    prompt: p.value.prompt,
+                    approvers: [...p.value.approvers],
+                    timeoutSeconds: p.value.timeoutSeconds,
+                    outcomes: (p.value.outcomes ?? []).map((o) => ({ name: o.name, label: o.label })),
+                    formSchema: p.value.formSchema ? p.value.formSchema : null,
+                };
+                break;
+            case "approvalResolved":
+                buckets.approvalResolved = {
+                    action: p.value.action,
+                    resolvedBy: p.value.resolvedBy,
+                    comment: p.value.comment,
+                    waitDurationMs: Number(p.value.waitDurationMs),
+                };
+                break;
+        }
+    }
+    return buckets;
+}
+// ---------------------------------------------------------------------------
+// Section builders
+// ---------------------------------------------------------------------------
+function buildSummary(snapshot, derived, buckets) {
+    const startedAt = snapshot?.startedAt || buckets.starts[0]?.occurredAt || null;
+    const completedAt = snapshot?.completedAt || null;
+    const durationMs = derived?.durationMs ?? 0;
+    const costMicros = snapshot?.costMicros ?? derived?.costMicros ?? BIGINT_ZERO;
+    const inputTokens = snapshot?.inputTokens ?? BIGINT_ZERO;
+    const outputTokens = snapshot?.outputTokens ?? BIGINT_ZERO;
+    const totalTokens = inputTokens + outputTokens > BIGINT_ZERO
+        ? inputTokens + outputTokens
+        : derived?.tokensUsed ?? BIGINT_ZERO;
+    const attemptNumber = derived?.attemptNumber ?? buckets.starts.length;
+    return {
+        startedAt,
+        completedAt,
+        durationMs,
+        costMicros,
+        inputTokens,
+        outputTokens,
+        totalTokens,
+        attemptNumber,
+    };
+}
+function buildIO(snapshotData, eventSummary, artifactIds) {
+    if (snapshotData && Object.keys(snapshotData).length > 0) {
+        return {
+            data: snapshotData,
+            summary: eventSummary,
+            artifactIds,
+            source: "snapshot",
+        };
+    }
+    if (eventSummary && Object.keys(eventSummary).length > 0) {
+        return {
+            data: eventSummary,
+            summary: eventSummary,
+            artifactIds,
+            source: "event-summary",
+        };
+    }
+    return null;
+}
+function buildError(buckets, snapshotMetadata) {
+    if (buckets.failures.length === 0)
+        return null;
+    const latest = buckets.failures[buckets.failures.length - 1];
+    const category = typeof snapshotMetadata?.error_category === "string"
+        ? snapshotMetadata.error_category
+        : null;
+    const detail = typeof snapshotMetadata?.error_detail === "string"
+        ? snapshotMetadata.error_detail
+        : null;
+    return {
+        message: latest.error,
+        attemptNumber: latest.attemptNumber,
+        maxAttempts: latest.maxAttempts,
+        willRetry: latest.willRetry,
+        durationMs: latest.durationMs,
+        category,
+        detail,
+    };
+}
+function buildRetryHistory(buckets) {
+    if (buckets.starts.length <= 1 && buckets.failures.length === 0)
+        return null;
+    const attempts = [];
+    for (let i = 0; i < buckets.starts.length; i++) {
+        const start = buckets.starts[i];
+        const failure = buckets.failures.find((f) => f.attemptNumber === start.attemptNumber);
+        const completion = i === buckets.starts.length - 1 && buckets.completions.length > 0
+            ? buckets.completions[buckets.completions.length - 1]
+            : null;
+        const retry = buckets.retryings.find((r) => r.failedAttempt === start.attemptNumber);
+        attempts.push({
+            attemptNumber: start.attemptNumber,
+            status: failure ? "failed" : completion ? "completed" : "failed",
+            durationMs: failure ? failure.durationMs : completion ? completion.durationMs : 0,
+            error: failure ? failure.error : "",
+            delayBeforeMs: retry ? retry.delayMs : 0,
+            startedAt: start.occurredAt,
+        });
+    }
+    if (attempts.length <= 1 && buckets.failures.length === 0)
+        return null;
+    const currentAttempt = buckets.starts.length > 0
+        ? buckets.starts[buckets.starts.length - 1].attemptNumber
+        : 1;
+    return { attempts, currentAttempt };
+}
+function buildAgentCall(buckets, taskKind, snapshotMeta) {
+    if (buckets.agentStarted) {
+        const childExecutionId = buckets.agentStarted.childExecutionId ||
+            buckets.agentProgress?.childExecutionId ||
+            "";
+        return {
+            childExecutionId,
+            agentSlug: buckets.agentStarted.agentSlug,
+            agentPhase: String(buckets.agentCompleted?.agentPhase ?? buckets.agentProgress?.agentPhase ?? ""),
+            messagesCount: buckets.agentProgress?.messagesCount ?? 0,
+            toolCallsCount: buckets.agentProgress?.toolCallsCount ?? 0,
+            tokensConsumed: buckets.agentCompleted?.tokensConsumed ?? buckets.agentProgress?.tokensConsumed ?? BIGINT_ZERO,
+            costMicros: buckets.agentCompleted?.costMicros ?? BIGINT_ZERO,
+            error: buckets.agentCompleted?.error ?? "",
+            currentToolName: buckets.agentProgress?.currentToolName ?? "",
+        };
+    }
+    if (taskKind === WorkflowTaskKind.agent_call && snapshotMeta) {
+        const aexId = snapshotMeta.agent_execution_id;
+        if (typeof aexId === "string" && aexId) {
+            return {
+                childExecutionId: aexId,
+                agentSlug: typeof snapshotMeta.agent_slug === "string" ? snapshotMeta.agent_slug : "",
+                agentPhase: "",
+                messagesCount: 0,
+                toolCallsCount: typeof snapshotMeta.tool_call_count === "number" ? snapshotMeta.tool_call_count : 0,
+                tokensConsumed: BIGINT_ZERO,
+                costMicros: BIGINT_ZERO,
+                error: "",
+                currentToolName: "",
+            };
+        }
+    }
+    return null;
+}
+function buildApproval(buckets, taskOutput) {
+    if (!buckets.approvalRequested)
+        return null;
+    const req = buckets.approvalRequested;
+    const res = buckets.approvalResolved;
+    // The human_input task's output IS the canonical decision record: the
+    // runner persists the reviewer's full response ({ outcome, reviewer,
+    // responded_at, comment, form_data, auto_resolved }) as the task output,
+    // a google.protobuf.Struct, so every field survives. Prefer it, and fall
+    // back to the lightweight approval_resolved event for fields the output
+    // snapshot has not captured yet (the brief window after a decision is
+    // signalled but before the status snapshot refreshes).
+    const outputOutcome = readSnapshotString(taskOutput, "outcome");
+    const hasDecision = res !== null || outputOutcome !== "";
+    if (!hasDecision) {
+        return {
+            prompt: req.prompt,
+            approvers: req.approvers,
+            outcomes: req.outcomes,
+            formSchema: req.formSchema,
+            timeoutSeconds: req.timeoutSeconds,
+            decision: null,
+        };
+    }
+    return {
+        prompt: req.prompt,
+        approvers: req.approvers,
+        outcomes: req.outcomes,
+        formSchema: req.formSchema,
+        timeoutSeconds: req.timeoutSeconds,
+        decision: {
+            outcome: outputOutcome,
+            reviewer: readSnapshotString(taskOutput, "reviewer") || (res?.resolvedBy ?? ""),
+            respondedAt: readSnapshotString(taskOutput, "responded_at") || null,
+            comment: readSnapshotString(taskOutput, "comment") || (res?.comment ?? ""),
+            formData: readSnapshotObject(taskOutput, "form_data"),
+            waitDurationMs: res?.waitDurationMs ?? 0,
+            autoResolved: taskOutput?.["auto_resolved"] === true,
+        },
+    };
+}
+/** Reads a string field from a task-output Struct, or `""` when absent. */
+function readSnapshotString(obj, key) {
+    const value = obj?.[key];
+    return typeof value === "string" ? value : "";
+}
+/** Reads a nested object field from a task-output Struct, or `null`. */
+function readSnapshotObject(obj, key) {
+    const value = obj?.[key];
+    return value !== null && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : null;
+}
+//# sourceMappingURL=derive-task-detail.js.map

package/workflow/execution-inspector/derive-task-detail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive-task-detail.js","sourceRoot":"","sources":["../../../src/workflow/execution-inspector/derive-task-detail.ts"],"names":[],"mappings":"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"}

package/workflow/execution-inspector/index.d.ts

@@ -0,0 +1,4 @@
+export { ExecutionInspector, type ExecutionInspectorProps } from "./ExecutionInspector";
+export { useExecutionTaskDetail, type UseExecutionTaskDetailReturn } from "./useExecutionTaskDetail";
+export { deriveTaskDetail, type TaskDetail, type TaskDetailSummary, type TaskDetailIO, type TaskDetailError, type TaskDetailRetryHistory, type TaskDetailRetryAttempt, type TaskDetailAgentCall, type TaskDetailApproval, type TaskDetailApprovalDecision, } from "./derive-task-detail";
+//# sourceMappingURL=index.d.ts.map

package/workflow/execution-inspector/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/workflow/execution-inspector/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,EAAE,sBAAsB,EAAE,KAAK,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AACrG,OAAO,EACL,gBAAgB,EAChB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,GAChC,MAAM,sBAAsB,CAAC"}

package/workflow/execution-inspector/index.js

@@ -0,0 +1,4 @@
+export { ExecutionInspector } from "./ExecutionInspector";
+export { useExecutionTaskDetail } from "./useExecutionTaskDetail";
+export { deriveTaskDetail, } from "./derive-task-detail";
+//# sourceMappingURL=index.js.map

package/workflow/execution-inspector/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/workflow/execution-inspector/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAgC,MAAM,sBAAsB,CAAC;AACxF,OAAO,EAAE,sBAAsB,EAAqC,MAAM,0BAA0B,CAAC;AACrG,OAAO,EACL,gBAAgB,GAUjB,MAAM,sBAAsB,CAAC"}

package/workflow/execution-inspector/useExecutionTaskDetail.d.ts

@@ -0,0 +1,38 @@
+import type { WorkflowExecutionEvent } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/event_pb";
+import type { WorkflowTask } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/api_pb";
+import type { DerivedTaskState } from "../../internal/store/workflow-execution-event-store";
+import { type TaskDetail } from "./derive-task-detail";
+/** Return value of {@link useExecutionTaskDetail}. */
+export interface UseExecutionTaskDetailReturn {
+    /** Rich per-task detail, or `null` when no task is selected or no data exists. */
+    readonly detail: TaskDetail | null;
+}
+/**
+ * Data hook that derives rich per-task detail for the runtime inspector.
+ *
+ * Joins the event stream (for timeline data) with the execution status
+ * snapshot (for full I/O) to produce a `TaskDetail` for the selected task.
+ *
+ * Returns `null` when `selectedTaskName` is null or no data exists for
+ * the selected task.
+ *
+ * @example
+ * ```tsx
+ * const { detail } = useExecutionTaskDetail({
+ *   selectedTaskName: "classify_input",
+ *   events,
+ *   taskStates,
+ *   taskSnapshots: execution?.status?.tasks,
+ * });
+ * if (detail) {
+ *   // Render tabs based on detail.input, detail.error, etc.
+ * }
+ * ```
+ */
+export declare function useExecutionTaskDetail(options: {
+    readonly selectedTaskName: string | null;
+    readonly events: readonly WorkflowExecutionEvent[];
+    readonly taskStates: ReadonlyMap<string, DerivedTaskState>;
+    readonly taskSnapshots?: readonly WorkflowTask[];
+}): UseExecutionTaskDetailReturn;
+//# sourceMappingURL=useExecutionTaskDetail.d.ts.map

package/workflow/execution-inspector/useExecutionTaskDetail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useExecutionTaskDetail.d.ts","sourceRoot":"","sources":["../../../src/workflow/execution-inspector/useExecutionTaskDetail.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kEAAkE,CAAC;AAC/G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gEAAgE,CAAC;AACnG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qDAAqD,CAAC;AAC5F,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEzE,sDAAsD;AACtD,MAAM,WAAW,4BAA4B;IAC3C,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACnD,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC3D,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;CAClD,GAAG,4BAA4B,CAa/B"}

package/workflow/execution-inspector/useExecutionTaskDetail.js

@@ -0,0 +1,37 @@
+"use client";
+import { useMemo } from "react";
+import { deriveTaskDetail } from "./derive-task-detail";
+/**
+ * Data hook that derives rich per-task detail for the runtime inspector.
+ *
+ * Joins the event stream (for timeline data) with the execution status
+ * snapshot (for full I/O) to produce a `TaskDetail` for the selected task.
+ *
+ * Returns `null` when `selectedTaskName` is null or no data exists for
+ * the selected task.
+ *
+ * @example
+ * ```tsx
+ * const { detail } = useExecutionTaskDetail({
+ *   selectedTaskName: "classify_input",
+ *   events,
+ *   taskStates,
+ *   taskSnapshots: execution?.status?.tasks,
+ * });
+ * if (detail) {
+ *   // Render tabs based on detail.input, detail.error, etc.
+ * }
+ * ```
+ */
+export function useExecutionTaskDetail(options) {
+    const { selectedTaskName, events, taskStates, taskSnapshots } = options;
+    const detail = useMemo(() => {
+        if (!selectedTaskName)
+            return null;
+        const snapshot = taskSnapshots?.find((t) => t.taskName === selectedTaskName);
+        const derived = taskStates.get(selectedTaskName);
+        return deriveTaskDetail(selectedTaskName, events, snapshot, derived);
+    }, [selectedTaskName, events, taskStates, taskSnapshots]);
+    return { detail };
+}
+//# sourceMappingURL=useExecutionTaskDetail.js.map

package/workflow/execution-inspector/useExecutionTaskDetail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useExecutionTaskDetail.js","sourceRoot":"","sources":["../../../src/workflow/execution-inspector/useExecutionTaskDetail.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAIhC,OAAO,EAAE,gBAAgB,EAAmB,MAAM,sBAAsB,CAAC;AAQzE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAKtC;IACC,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;IAExE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAsB,EAAE;QAC7C,IAAI,CAAC,gBAAgB;YAAE,OAAO,IAAI,CAAC;QAEnC,MAAM,QAAQ,GAAG,aAAa,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,gBAAgB,CAAC,CAAC;QAC7E,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAEjD,OAAO,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC,EAAE,CAAC,gBAAgB,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC;IAE1D,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC"}

package/workflow/format-utils.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Shared formatting utilities for workflow execution metrics.
+ *
+ * Consolidates formatting logic previously duplicated across
+ * WorkflowExecutionViewer, WorkflowExecutionHeader,
+ * WorkflowExecutionCostPanel, WorkflowExecutionTaskPanel,
+ * and WorkflowExecutionTimelineEvent.
+ *
+ * @since T05 (Runtime Inspector)
+ */
+/**
+ * Formats a duration in milliseconds to a human-readable string.
+ *
+ * Output examples: `42ms`, `1.3s`, `2m 15s`, `1h 30m`
+ */
+export declare function formatDuration(ms: number): string;
+/**
+ * Formats a cost in micro-USD (1 USD = 1,000,000 micros) to a dollar string.
+ *
+ * Output examples: `$0.0012`, `$0.19`, `$4.50`
+ *
+ * Uses 4 decimal places for sub-cent amounts, 2 otherwise.
+ */
+export declare function formatMicroUsd(micros: bigint): string;
+/**
+ * Formats a token count to a human-readable abbreviated string.
+ *
+ * Output examples: `850`, `12.4K`, `1.5M`
+ */
+export declare function formatTokenCount(tokens: bigint): string;
+/**
+ * Formats a byte count to a human-readable string.
+ *
+ * Output examples: `128 B`, `4.2 KB`, `1.5 MB`
+ */
+export declare function formatBytes(bytes: bigint): string;
+/**
+ * Formats an ISO 8601 timestamp to a locale-aware time string (HH:MM:SS).
+ */
+export declare function formatTimestamp(iso: string): string;
+/**
+ * Formats a duration in whole seconds to a human-readable string.
+ *
+ * Unlike {@link formatDuration} (which takes milliseconds), this is for
+ * API responses that report durations in seconds (e.g., execution summaries).
+ *
+ * Output examples: `42s`, `3m`, `1h 30m`
+ */
+export declare function formatDurationSec(seconds: number): string;
+/**
+ * Builds a compact "duration · cost · tokens" chip string from metrics.
+ * Omits zero/absent values. Returns `null` if all values are empty.
+ *
+ * Output example: `1.3s · $0.19 · 12,400 tok`
+ */
+export declare function formatMetaChips(opts: {
+    readonly durationMs?: number;
+    readonly costMicros?: bigint;
+    readonly tokens?: bigint;
+}): string | null;
+//# sourceMappingURL=format-utils.d.ts.map

package/workflow/format-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-utils.d.ts","sourceRoot":"","sources":["../../src/workflow/format-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAUjD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAcnD;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAUzD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,MAAM,GAAG,IAAI,CAMhB"}

package/workflow/format-utils.js

@@ -0,0 +1,127 @@
+/**
+ * Shared formatting utilities for workflow execution metrics.
+ *
+ * Consolidates formatting logic previously duplicated across
+ * WorkflowExecutionViewer, WorkflowExecutionHeader,
+ * WorkflowExecutionCostPanel, WorkflowExecutionTaskPanel,
+ * and WorkflowExecutionTimelineEvent.
+ *
+ * @since T05 (Runtime Inspector)
+ */
+const BIGINT_ZERO = BigInt(0);
+/**
+ * Formats a duration in milliseconds to a human-readable string.
+ *
+ * Output examples: `42ms`, `1.3s`, `2m 15s`, `1h 30m`
+ */
+export function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    const s = ms / 1000;
+    if (s < 60)
+        return `${s.toFixed(1)}s`;
+    const m = Math.floor(s / 60);
+    const rem = Math.round(s % 60);
+    if (m < 60)
+        return rem > 0 ? `${m}m ${rem}s` : `${m}m`;
+    const h = Math.floor(m / 60);
+    const remM = m % 60;
+    return remM > 0 ? `${h}h ${remM}m` : `${h}h`;
+}
+/**
+ * Formats a cost in micro-USD (1 USD = 1,000,000 micros) to a dollar string.
+ *
+ * Output examples: `$0.0012`, `$0.19`, `$4.50`
+ *
+ * Uses 4 decimal places for sub-cent amounts, 2 otherwise.
+ */
+export function formatMicroUsd(micros) {
+    const val = Number(micros) / 1_000_000;
+    if (val < 0.01)
+        return `$${val.toFixed(4)}`;
+    return `$${val.toFixed(2)}`;
+}
+/**
+ * Formats a token count to a human-readable abbreviated string.
+ *
+ * Output examples: `850`, `12.4K`, `1.5M`
+ */
+export function formatTokenCount(tokens) {
+    const n = Number(tokens);
+    if (n >= 1_000_000)
+        return `${(n / 1_000_000).toFixed(1)}M`;
+    if (n >= 1_000)
+        return `${(n / 1_000).toFixed(1)}K`;
+    return n.toLocaleString();
+}
+/**
+ * Formats a byte count to a human-readable string.
+ *
+ * Output examples: `128 B`, `4.2 KB`, `1.5 MB`
+ */
+export function formatBytes(bytes) {
+    const n = Number(bytes);
+    if (n < 1024)
+        return `${n} B`;
+    if (n < 1024 * 1024)
+        return `${(n / 1024).toFixed(1)} KB`;
+    return `${(n / (1024 * 1024)).toFixed(1)} MB`;
+}
+/**
+ * Formats an ISO 8601 timestamp to a locale-aware time string (HH:MM:SS).
+ */
+export function formatTimestamp(iso) {
+    if (!iso)
+        return "";
+    try {
+        const d = new Date(iso);
+        if (Number.isNaN(d.getTime()))
+            return iso;
+        return d.toLocaleTimeString(undefined, {
+            hour: "2-digit",
+            minute: "2-digit",
+            second: "2-digit",
+            hour12: false,
+        });
+    }
+    catch {
+        return iso;
+    }
+}
+/**
+ * Formats a duration in whole seconds to a human-readable string.
+ *
+ * Unlike {@link formatDuration} (which takes milliseconds), this is for
+ * API responses that report durations in seconds (e.g., execution summaries).
+ *
+ * Output examples: `42s`, `3m`, `1h 30m`
+ */
+export function formatDurationSec(seconds) {
+    if (seconds < 60)
+        return `${Math.round(seconds)}s`;
+    if (seconds < 3600) {
+        const m = Math.floor(seconds / 60);
+        const rem = Math.round(seconds % 60);
+        return rem > 0 ? `${m}m ${rem}s` : `${m}m`;
+    }
+    const h = Math.floor(seconds / 3600);
+    const m = Math.floor((seconds % 3600) / 60);
+    return m > 0 ? `${h}h ${m}m` : `${h}h`;
+}
+/**
+ * Builds a compact "duration · cost · tokens" chip string from metrics.
+ * Omits zero/absent values. Returns `null` if all values are empty.
+ *
+ * Output example: `1.3s · $0.19 · 12,400 tok`
+ */
+export function formatMetaChips(opts) {
+    const parts = [];
+    if (opts.durationMs && opts.durationMs > 0)
+        parts.push(formatDuration(opts.durationMs));
+    if (opts.costMicros && opts.costMicros > BIGINT_ZERO)
+        parts.push(formatMicroUsd(opts.costMicros));
+    if (opts.tokens && opts.tokens > BIGINT_ZERO)
+        parts.push(`${opts.tokens.toLocaleString()} tok`);
+    return parts.length > 0 ? parts.join(" · ") : null;
+}
+//# sourceMappingURL=format-utils.js.map