@stigmer/protos 0.5.0 → 1.0.0

package/ai/stigmer/agentic/workflowexecution/v1/io_pb.d.ts

@@ -1,7 +1,9 @@
 import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
 import type { ApprovalAction } from "../../agentexecution/v1/enum_pb.js";
-import type { WorkflowExecution, WorkflowExecutionStatus, WorkflowTask } from "./api_pb.js";
+import type { WorkflowExecution, WorkflowExecutionStatus } from "./api_pb.js";
 import type { ExecutionPhase } from "./enum_pb.js";
+import type { WorkflowEventType, WorkflowExecutionEvent } from "./event_pb.js";
+import type { Duration, Timestamp } from "@bufbuild/protobuf/wkt";
 import type { JsonObject, Message } from "@bufbuild/protobuf";
 /**
  * Describes the file ai/stigmer/agentic/workflowexecution/v1/io.proto.
@@ -208,6 +210,27 @@ export type WorkflowExecutionUpdateStatusInput = Message<"ai.stigmer.agentic.wor
      * @generated from field: ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionStatus status = 2;
      */
     status?: WorkflowExecutionStatus;
+    /**
+     * Execution events to append to the event log alongside this status update.
+     *
+     * @internal
+     * Append-only: events are added to the persistent event log, never replaced.
+     * This contrasts with status.tasks which uses full-replace protocol.
+     *
+     * The workflow-runner appends events atomically with each status update,
+     * ensuring the event log stays consistent with the status snapshot.
+     * Events must have monotonically increasing sequence_numbers — the handler
+     * rejects batches where any event's sequence_number is <= the current
+     * highest persisted sequence for this execution.
+     *
+     * Empty list means no new events (backward compatible — existing runners
+     * that do not yet emit events continue to work without changes).
+     *
+     * @since T06 (Execution Event Stream Model)
+     *
+     * @generated from field: repeated ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionEvent events = 10;
+     */
+    events: WorkflowExecutionEvent[];
 };
 /**
  * Describes the message ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionUpdateStatusInput.
@@ -271,17 +294,29 @@ export type SubmitWorkflowApprovalInput = Message<"ai.stigmer.agentic.workflowex
  */
 export declare const SubmitWorkflowApprovalInputSchema: GenMessage<SubmitWorkflowApprovalInput>;
 /**
- * SubscribeWorkflowExecutionRequest subscribes to real-time execution updates.
+ * SubmitWorkflowTaskApprovalInput submits a human reviewer's decision for a
+ * workflow-level human_input task.
  *
  * @internal
- * Opens a server-side streaming RPC that pushes WorkflowExecution updates
- * as the execution progresses. Stream closes when execution reaches a terminal state.
+ * Unlike submitApproval (which forwards agent-level tool approvals to a child
+ * AgentExecution), this RPC resolves workflow-level human_input tasks. The handler:
  *
- * @generated from message ai.stigmer.agentic.workflowexecution.v1.SubscribeWorkflowExecutionRequest
+ * 1. Validates that the named task exists in the execution and is a human_input task
+ * 2. Validates the outcome against the task's configured outcomes (if any)
+ * 3. Constructs the Temporal signal name ("human_input_{task_name}")
+ * 4. Builds the signal payload matching HumanInputSignalPayload
+ * 5. Sends the signal via SignalWithStart for race-proof delivery
+ *
+ * The reviewer's decision (outcome + form_data) becomes the task output after
+ * the workflow-runner receives and processes the signal.
+ *
+ * @since T13b (Java/Cloud Backend Parity)
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.SubmitWorkflowTaskApprovalInput
  */
-export type SubscribeWorkflowExecutionRequest = Message<"ai.stigmer.agentic.workflowexecution.v1.SubscribeWorkflowExecutionRequest"> & {
+export type SubmitWorkflowTaskApprovalInput = Message<"ai.stigmer.agentic.workflowexecution.v1.SubmitWorkflowTaskApprovalInput"> & {
     /**
-     * Execution ID to subscribe to.
+     * ID of the workflow execution containing the human_input task.
      *
      * @internal
      * Format: "wfx_{unique-suffix}"
@@ -289,55 +324,86 @@ export type SubscribeWorkflowExecutionRequest = Message<"ai.stigmer.agentic.work
      * @generated from field: string execution_id = 1;
      */
     executionId: string;
-};
-/**
- * Describes the message ai.stigmer.agentic.workflowexecution.v1.SubscribeWorkflowExecutionRequest.
- * Use `create(SubscribeWorkflowExecutionRequestSchema)` to create a new message.
- */
-export declare const SubscribeWorkflowExecutionRequestSchema: GenMessage<SubscribeWorkflowExecutionRequest>;
-/**
- * WorkflowExecutionUpdate represents a real-time execution update event.
- *
- * @internal
- * Reserved for future WebSocket/SSE streaming implementations.
- * Currently not used by subscribe() RPC (which sends full WorkflowExecution).
- *
- * @generated from message ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionUpdate
- */
-export type WorkflowExecutionUpdate = Message<"ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionUpdate"> & {
     /**
-     * Type of update that occurred.
+     * Name of the human_input task to respond to.
+     *
+     * @internal
+     * Must match a task in the workflow whose kind is human_input and whose
+     * current status is WORKFLOW_TASK_IN_PROGRESS (waiting for signal).
+     * The handler constructs the signal name as "human_input_{task_name}".
+     *
+     * @generated from field: string task_name = 2;
+     */
+    taskName: string;
+    /**
+     * Outcome selected by the reviewer.
+     *
+     * @internal
+     * If the human_input task defines custom outcomes, this must match one of
+     * the configured outcome names (e.g., "approve", "deny", "needs_revision").
+     * If no custom outcomes are defined, must be "approve" or "deny".
+     *
+     * @generated from field: string outcome = 3;
+     */
+    outcome: string;
+    /**
+     * Form data collected from the reviewer's response form.
      *
      * @internal
-     * Determines which fields in this message are populated.
+     * Populated when the human_input task defines a form_schema. The form data
+     * is delivered to the Go runner as-is and becomes part of the task output.
+     * Validation against the form_schema is a runtime concern (Go runner side).
      *
-     * @generated from field: ai.stigmer.agentic.workflowexecution.v1.WorkflowUpdateType update_type = 1;
+     * @generated from field: google.protobuf.Struct form_data = 4;
      */
-    updateType: WorkflowUpdateType;
+    formData?: JsonObject;
     /**
-     * Updated execution state (full or partial).
+     * Identity of the reviewer submitting the decision.
      *
      * @internal
-     * May contain only changed fields. Clients should merge with cached state.
+     * Typically the authenticated user's identity. Stored in the task output
+     * for audit trail purposes.
      *
-     * @generated from field: ai.stigmer.agentic.workflowexecution.v1.WorkflowExecution execution = 2;
+     * @generated from field: string reviewer = 5;
      */
-    execution?: WorkflowExecution;
+    reviewer: string;
     /**
-     * Updated task, populated only for task-related update types.
+     * Optional comment from the reviewer, stored in the audit trail.
+     *
+     * @generated from field: string comment = 6;
+     */
+    comment: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.SubmitWorkflowTaskApprovalInput.
+ * Use `create(SubmitWorkflowTaskApprovalInputSchema)` to create a new message.
+ */
+export declare const SubmitWorkflowTaskApprovalInputSchema: GenMessage<SubmitWorkflowTaskApprovalInput>;
+/**
+ * SubscribeWorkflowExecutionRequest subscribes to real-time execution updates.
+ *
+ * @internal
+ * Opens a server-side streaming RPC that pushes WorkflowExecution updates
+ * as the execution progresses. Stream closes when execution reaches a terminal state.
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.SubscribeWorkflowExecutionRequest
+ */
+export type SubscribeWorkflowExecutionRequest = Message<"ai.stigmer.agentic.workflowexecution.v1.SubscribeWorkflowExecutionRequest"> & {
+    /**
+     * Execution ID to subscribe to.
      *
      * @internal
-     * Provides direct access to the changed task without searching execution.status.tasks[].
+     * Format: "wfx_{unique-suffix}"
      *
-     * @generated from field: ai.stigmer.agentic.workflowexecution.v1.WorkflowTask task = 3;
+     * @generated from field: string execution_id = 1;
      */
-    task?: WorkflowTask;
+    executionId: string;
 };
 /**
- * Describes the message ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionUpdate.
- * Use `create(WorkflowExecutionUpdateSchema)` to create a new message.
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.SubscribeWorkflowExecutionRequest.
+ * Use `create(SubscribeWorkflowExecutionRequestSchema)` to create a new message.
  */
-export declare const WorkflowExecutionUpdateSchema: GenMessage<WorkflowExecutionUpdate>;
+export declare const SubscribeWorkflowExecutionRequestSchema: GenMessage<SubscribeWorkflowExecutionRequest>;
 /**
  * CancelWorkflowExecutionInput requests graceful cancellation of a workflow execution.
  *
@@ -571,79 +637,519 @@ export type SendSignalInput = Message<"ai.stigmer.agentic.workflowexecution.v1.S
  */
 export declare const SendSignalInputSchema: GenMessage<SendSignalInput>;
 /**
- * WorkflowUpdateType defines the type of workflow execution update event.
+ * GetEventLogRequest fetches the paginated event log for a workflow execution.
  *
  * @internal
- * Used by WorkflowExecutionUpdate to indicate what changed in the execution.
+ * Returns events ordered by sequence_number ascending. Supports cursor-based
+ * pagination via after_sequence and optional filtering by event type or task.
  *
- * @generated from enum ai.stigmer.agentic.workflowexecution.v1.WorkflowUpdateType
+ * Use Cases:
+ *
+ * 1. Execution Viewer Timeline (T09):
+ *    - UI loads execution state via get(), then fetches event log for timeline
+ *    - Initial load: after_sequence = 0, page_size = 100
+ *    - Subsequent pages: after_sequence = latest_sequence from previous response
+ *
+ * 2. Task Drill-Down:
+ *    - User clicks a task in the viewer to see its full history
+ *    - Filter by task_name to get only events for that task
+ *
+ * 3. Cost Analysis:
+ *    - Filter by budget_checkpoint events to chart cost over time
+ *
+ * @since T06 (Execution Event Stream Model)
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.GetEventLogRequest
  */
-export declare enum WorkflowUpdateType {
+export type GetEventLogRequest = Message<"ai.stigmer.agentic.workflowexecution.v1.GetEventLogRequest"> & {
+    /**
+     * Execution ID to fetch events for.
+     *
+     * @internal
+     * Format: "wfx_{unique-suffix}"
+     *
+     * @generated from field: string execution_id = 1;
+     */
+    executionId: string;
     /**
-     * Unspecified update type (invalid).
+     * Return events with sequence_number strictly greater than this value.
      *
      * @internal
-     * Exists only for proto3 zero-value semantics.
+     * Cursor-based pagination: set to 0 for the first page, then to
+     * latest_sequence from the previous response for subsequent pages.
+     * Also used by subscribeEvents for replay + live tail positioning.
      *
-     * @generated from enum value: workflow_update_type_unspecified = 0;
+     * @generated from field: uint64 after_sequence = 2;
      */
-    workflow_update_type_unspecified = 0,
+    afterSequence: bigint;
     /**
-     * Workflow execution phase changed.
+     * Optional filter: return only events of these types.
      *
      * @internal
-     * Triggered when status.phase transitions to a new value.
+     * When empty, all event types are returned. When populated, only events
+     * whose event_type matches one of the specified values are included.
+     * Useful for filtering to only task lifecycle events, or only budget events.
      *
-     * @generated from enum value: wf_update_status_changed = 1;
+     * @generated from field: repeated ai.stigmer.agentic.workflowexecution.v1.WorkflowEventType event_types = 3;
      */
-    wf_update_status_changed = 1,
+    eventTypes: WorkflowEventType[];
     /**
-     * A workflow task started executing.
+     * Optional filter: return only events for this task.
      *
      * @internal
-     * Triggered when task status changes from PENDING to IN_PROGRESS.
+     * When empty, events for all tasks (and execution-level events) are returned.
+     * When populated, only events where task_name matches are included.
+     * Execution-level events (empty task_name) are excluded when this filter is set.
      *
-     * @generated from enum value: wf_update_task_started = 2;
+     * @generated from field: string task_name = 4;
      */
-    wf_update_task_started = 2,
+    taskName: string;
     /**
-     * A workflow task completed successfully.
+     * Maximum number of events to return per page.
      *
      * @internal
-     * Triggered when task status changes from IN_PROGRESS to COMPLETED.
+     * Default: 100. Maximum: 500 (backend enforces this limit).
+     * Events are always returned in sequence_number ascending order.
+     *
+     * @generated from field: int32 page_size = 5;
+     */
+    pageSize: number;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.GetEventLogRequest.
+ * Use `create(GetEventLogRequestSchema)` to create a new message.
+ */
+export declare const GetEventLogRequestSchema: GenMessage<GetEventLogRequest>;
+/**
+ * GetEventLogResponse contains a page of execution events.
+ *
+ * @internal
+ * @since T06 (Execution Event Stream Model)
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.GetEventLogResponse
+ */
+export type GetEventLogResponse = Message<"ai.stigmer.agentic.workflowexecution.v1.GetEventLogResponse"> & {
+    /**
+     * Events in this page, ordered by sequence_number ascending.
      *
-     * @generated from enum value: wf_update_task_completed = 3;
+     * @generated from field: repeated ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionEvent events = 1;
      */
-    wf_update_task_completed = 3,
+    events: WorkflowExecutionEvent[];
     /**
-     * A workflow task failed.
+     * Whether more events exist after the last event in this response.
+     * When false, the client has reached the end of the current event log.
+     * For in-progress executions, more events may appear later.
+     *
+     * @generated from field: bool has_more = 2;
+     */
+    hasMore: boolean;
+    /**
+     * Highest sequence_number returned in this response.
+     * Use as after_sequence in the next request for cursor-based pagination.
+     * 0 when events is empty.
+     *
+     * @generated from field: uint64 latest_sequence = 3;
+     */
+    latestSequence: bigint;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.GetEventLogResponse.
+ * Use `create(GetEventLogResponseSchema)` to create a new message.
+ */
+export declare const GetEventLogResponseSchema: GenMessage<GetEventLogResponse>;
+/**
+ * SubscribeEventsRequest opens a real-time event stream for a workflow execution.
+ *
+ * @internal
+ * Unlike subscribe() which streams full WorkflowExecution snapshots, this
+ * streams individual WorkflowExecutionEvent messages as they occur.
+ * Lightweight and incremental — suitable for the execution viewer timeline.
+ *
+ * Replay + Live Tail:
+ * When after_sequence is set, the server first replays persisted events
+ * with sequence_number > after_sequence, then switches to live streaming.
+ * This enables seamless reconnection without missing events.
+ *
+ * Stream Lifecycle:
+ * 1. Client sends SubscribeEventsRequest with execution_id
+ * 2. Server validates authorization
+ * 3. If after_sequence > 0: Server replays missed events
+ * 4. Server streams new events in real-time as they occur
+ * 5. Server closes stream when execution reaches a terminal phase
+ * 6. Client can close stream early (e.g., user navigates away)
+ *
+ * @since T06 (Execution Event Stream Model)
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.SubscribeEventsRequest
+ */
+export type SubscribeEventsRequest = Message<"ai.stigmer.agentic.workflowexecution.v1.SubscribeEventsRequest"> & {
+    /**
+     * Execution ID to subscribe to.
      *
      * @internal
-     * Triggered when task status changes from IN_PROGRESS to FAILED.
+     * Format: "wfx_{unique-suffix}"
      *
-     * @generated from enum value: wf_update_task_failed = 4;
+     * @generated from field: string execution_id = 1;
      */
-    wf_update_task_failed = 4,
+    executionId: string;
     /**
-     * Workflow execution completed successfully.
+     * Resume from this sequence number (replay + live tail).
      *
      * @internal
-     * Terminal event - no more updates will follow.
+     * 0 = start from the beginning (replay all events then live tail).
+     * N = replay events with sequence_number > N, then live tail.
      *
-     * @generated from enum value: wf_update_execution_completed = 5;
+     * Use the latest_sequence from a previous getEventLog response or
+     * the last received event's sequence_number for reconnection.
+     *
+     * @generated from field: uint64 after_sequence = 2;
      */
-    wf_update_execution_completed = 5,
+    afterSequence: bigint;
     /**
-     * Workflow execution was cancelled.
+     * Optional filter: stream only events of these types.
      *
      * @internal
-     * Terminal event - no more updates will follow.
+     * When empty, all event types are streamed.
+     * Applied to both replayed and live events.
+     *
+     * @generated from field: repeated ai.stigmer.agentic.workflowexecution.v1.WorkflowEventType event_types = 3;
+     */
+    eventTypes: WorkflowEventType[];
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.SubscribeEventsRequest.
+ * Use `create(SubscribeEventsRequestSchema)` to create a new message.
+ */
+export declare const SubscribeEventsRequestSchema: GenMessage<SubscribeEventsRequest>;
+/**
+ * GetExecutionSummaryRequest fetches aggregated execution statistics for an organization.
+ *
+ * @since T14 (Dashboard Integration)
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.GetExecutionSummaryRequest
+ */
+export type GetExecutionSummaryRequest = Message<"ai.stigmer.agentic.workflowexecution.v1.GetExecutionSummaryRequest"> & {
+    /**
+     * Organization slug to scope the summary.
+     *
+     * @generated from field: string org = 1;
+     */
+    org: string;
+    /**
+     * Time window for aggregation.
+     *
+     * Defaults to LAST_7D when unspecified.
+     *
+     * @generated from field: ai.stigmer.agentic.workflowexecution.v1.SummaryTimeWindow time_window = 2;
+     */
+    timeWindow: SummaryTimeWindow;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.GetExecutionSummaryRequest.
+ * Use `create(GetExecutionSummaryRequestSchema)` to create a new message.
+ */
+export declare const GetExecutionSummaryRequestSchema: GenMessage<GetExecutionSummaryRequest>;
+/**
+ * ExecutionSummary contains aggregated statistics for workflow executions.
+ *
+ * All counts, costs, and durations are scoped to the requested time window.
+ *
+ * @since T14 (Dashboard Integration)
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.ExecutionSummary
+ */
+export type ExecutionSummary = Message<"ai.stigmer.agentic.workflowexecution.v1.ExecutionSummary"> & {
+    /**
+     * Number of executions currently in a non-terminal phase (PENDING, IN_PROGRESS, PAUSED).
+     *
+     * @generated from field: int32 active_count = 1;
+     */
+    activeCount: number;
+    /**
+     * Execution counts broken down by phase.
+     *
+     * Keys are ExecutionPhase enum values (as int32).
+     * Only phases with at least one execution are included.
+     *
+     * @generated from field: map<int32, int32> phase_counts = 2;
+     */
+    phaseCounts: {
+        [key: number]: number;
+    };
+    /**
+     * Aggregate cost across all executions in the time window.
+     *
+     * @generated from field: ai.stigmer.agentic.workflowexecution.v1.WorkflowCostSummary total_cost = 3;
+     */
+    totalCost?: WorkflowCostSummary;
+    /**
+     * Mean execution duration (from started_at to completed_at) for completed executions.
+     *
+     * Zero when no completed executions exist in the window.
+     *
+     * @generated from field: google.protobuf.Duration avg_duration = 4;
+     */
+    avgDuration?: Duration;
+    /**
+     * Workflows with the highest failure count in the time window, ranked descending.
+     *
+     * Capped at 10 entries.
+     *
+     * @generated from field: repeated ai.stigmer.agentic.workflowexecution.v1.WorkflowFailureRank top_failing_workflows = 5;
+     */
+    topFailingWorkflows: WorkflowFailureRank[];
+    /**
+     * Per-workflow cost breakdown, ranked by total_cost descending.
+     *
+     * Capped at 10 entries.
+     *
+     * @generated from field: repeated ai.stigmer.agentic.workflowexecution.v1.WorkflowCostBreakdown cost_by_workflow = 6;
+     */
+    costByWorkflow: WorkflowCostBreakdown[];
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.ExecutionSummary.
+ * Use `create(ExecutionSummarySchema)` to create a new message.
+ */
+export declare const ExecutionSummarySchema: GenMessage<ExecutionSummary>;
+/**
+ * WorkflowCostSummary aggregates token and dollar costs.
+ *
+ * @since T14 (Dashboard Integration)
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.WorkflowCostSummary
+ */
+export type WorkflowCostSummary = Message<"ai.stigmer.agentic.workflowexecution.v1.WorkflowCostSummary"> & {
+    /**
+     * @generated from field: double total_cost_usd = 1;
+     */
+    totalCostUsd: number;
+    /**
+     * @generated from field: int64 total_input_tokens = 2;
+     */
+    totalInputTokens: bigint;
+    /**
+     * @generated from field: int64 total_output_tokens = 3;
+     */
+    totalOutputTokens: bigint;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.WorkflowCostSummary.
+ * Use `create(WorkflowCostSummarySchema)` to create a new message.
+ */
+export declare const WorkflowCostSummarySchema: GenMessage<WorkflowCostSummary>;
+/**
+ * WorkflowFailureRank represents a workflow and its failure count within a time window.
+ *
+ * @since T14 (Dashboard Integration)
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.WorkflowFailureRank
+ */
+export type WorkflowFailureRank = Message<"ai.stigmer.agentic.workflowexecution.v1.WorkflowFailureRank"> & {
+    /**
+     * @generated from field: string workflow_slug = 1;
+     */
+    workflowSlug: string;
+    /**
+     * @generated from field: string workflow_name = 2;
+     */
+    workflowName: string;
+    /**
+     * @generated from field: int32 failure_count = 3;
+     */
+    failureCount: number;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.WorkflowFailureRank.
+ * Use `create(WorkflowFailureRankSchema)` to create a new message.
+ */
+export declare const WorkflowFailureRankSchema: GenMessage<WorkflowFailureRank>;
+/**
+ * WorkflowCostBreakdown represents per-workflow cost aggregation.
+ *
+ * @since T14 (Dashboard Integration)
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.WorkflowCostBreakdown
+ */
+export type WorkflowCostBreakdown = Message<"ai.stigmer.agentic.workflowexecution.v1.WorkflowCostBreakdown"> & {
+    /**
+     * @generated from field: string workflow_slug = 1;
+     */
+    workflowSlug: string;
+    /**
+     * @generated from field: string workflow_name = 2;
+     */
+    workflowName: string;
+    /**
+     * @generated from field: double total_cost_usd = 3;
+     */
+    totalCostUsd: number;
+    /**
+     * @generated from field: int32 execution_count = 4;
+     */
+    executionCount: number;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.WorkflowCostBreakdown.
+ * Use `create(WorkflowCostBreakdownSchema)` to create a new message.
+ */
+export declare const WorkflowCostBreakdownSchema: GenMessage<WorkflowCostBreakdown>;
+/**
+ * ListPendingApprovalsRequest fetches workflow executions that have active
+ * human_input tasks awaiting reviewer decisions.
+ *
+ * @since T14 (Dashboard Integration)
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.ListPendingApprovalsRequest
+ */
+export type ListPendingApprovalsRequest = Message<"ai.stigmer.agentic.workflowexecution.v1.ListPendingApprovalsRequest"> & {
+    /**
+     * Organization slug to scope the query.
+     *
+     * @generated from field: string org = 1;
+     */
+    org: string;
+    /**
+     * Maximum number of pending approvals to return per page.
+     *
+     * Default: 20. Maximum: 100.
+     *
+     * @generated from field: int32 page_size = 2;
+     */
+    pageSize: number;
+    /**
+     * Opaque pagination token from a previous response.
+     *
+     * @generated from field: string page_token = 3;
+     */
+    pageToken: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.ListPendingApprovalsRequest.
+ * Use `create(ListPendingApprovalsRequestSchema)` to create a new message.
+ */
+export declare const ListPendingApprovalsRequestSchema: GenMessage<ListPendingApprovalsRequest>;
+/**
+ * PendingApproval represents a single human_input task awaiting a reviewer decision.
+ *
+ * @since T14 (Dashboard Integration)
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.PendingApproval
+ */
+export type PendingApproval = Message<"ai.stigmer.agentic.workflowexecution.v1.PendingApproval"> & {
+    /**
+     * Workflow execution containing the pending task.
+     *
+     * @generated from field: string execution_id = 1;
+     */
+    executionId: string;
+    /**
+     * Human-readable workflow name for display.
+     *
+     * @generated from field: string workflow_name = 2;
+     */
+    workflowName: string;
+    /**
+     * Name of the human_input task awaiting response.
+     *
+     * @generated from field: string task_name = 3;
+     */
+    taskName: string;
+    /**
+     * Identity of the user or system that triggered the execution.
+     *
+     * @generated from field: string requester = 4;
+     */
+    requester: string;
+    /**
+     * When the approval was requested (task entered waiting state).
+     *
+     * @generated from field: google.protobuf.Timestamp requested_at = 5;
+     */
+    requestedAt?: Timestamp;
+    /**
+     * When the approval times out (if a timeout policy is configured).
+     *
+     * Zero value when no timeout is configured.
+     *
+     * @generated from field: google.protobuf.Timestamp timeout_at = 6;
+     */
+    timeoutAt?: Timestamp;
+    /**
+     * Optional JSON Schema for the approval form.
+     *
+     * When present, the reviewer is expected to fill in form data
+     * that conforms to this schema before submitting the decision.
+     *
+     * @generated from field: google.protobuf.Struct form_schema = 7;
+     */
+    formSchema?: JsonObject;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.PendingApproval.
+ * Use `create(PendingApprovalSchema)` to create a new message.
+ */
+export declare const PendingApprovalSchema: GenMessage<PendingApproval>;
+/**
+ * PendingApprovalsList contains a paginated list of pending approvals.
+ *
+ * @since T14 (Dashboard Integration)
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.PendingApprovalsList
+ */
+export type PendingApprovalsList = Message<"ai.stigmer.agentic.workflowexecution.v1.PendingApprovalsList"> & {
+    /**
+     * @generated from field: repeated ai.stigmer.agentic.workflowexecution.v1.PendingApproval entries = 1;
+     */
+    entries: PendingApproval[];
+    /**
+     * Total number of pending approvals matching the query (across all pages).
+     *
+     * @generated from field: int32 total_count = 2;
+     */
+    totalCount: number;
+    /**
+     * Pagination token for the next page. Empty when no more pages exist.
      *
-     * @generated from enum value: wf_update_execution_cancelled = 6;
+     * @generated from field: string next_page_token = 3;
+     */
+    nextPageToken: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.PendingApprovalsList.
+ * Use `create(PendingApprovalsListSchema)` to create a new message.
+ */
+export declare const PendingApprovalsListSchema: GenMessage<PendingApprovalsList>;
+/**
+ * SummaryTimeWindow controls the time range for aggregated dashboard queries.
+ *
+ * @since T14 (Dashboard Integration)
+ *
+ * @generated from enum ai.stigmer.agentic.workflowexecution.v1.SummaryTimeWindow
+ */
+export declare enum SummaryTimeWindow {
+    /**
+     * @generated from enum value: SUMMARY_TIME_WINDOW_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: SUMMARY_TIME_WINDOW_LAST_24H = 1;
+     */
+    LAST_24H = 1,
+    /**
+     * @generated from enum value: SUMMARY_TIME_WINDOW_LAST_7D = 2;
+     */
+    LAST_7D = 2,
+    /**
+     * @generated from enum value: SUMMARY_TIME_WINDOW_LAST_30D = 3;
+     */
+    LAST_30D = 3,
+    /**
+     * @generated from enum value: SUMMARY_TIME_WINDOW_ALL_TIME = 4;
      */
-    wf_update_execution_cancelled = 6
+    ALL_TIME = 4
 }
 /**
- * Describes the enum ai.stigmer.agentic.workflowexecution.v1.WorkflowUpdateType.
+ * Describes the enum ai.stigmer.agentic.workflowexecution.v1.SummaryTimeWindow.
  */
-export declare const WorkflowUpdateTypeSchema: GenEnum<WorkflowUpdateType>;
+export declare const SummaryTimeWindowSchema: GenEnum<SummaryTimeWindow>;