@stigmer/protos 0.0.34

package/ai/stigmer/agentic/workflowexecution/v1/io_pb.js

@@ -0,0 +1,211 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts"
+// @generated from file ai/stigmer/agentic/workflowexecution/v1/io.proto (package ai.stigmer.agentic.workflowexecution.v1, syntax proto3)
+/* eslint-disable */
+import { enumDesc, fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv1";
+import { file_ai_stigmer_agentic_agentexecution_v1_enum } from "../../agentexecution/v1/enum_pb";
+import { file_ai_stigmer_agentic_workflowexecution_v1_api } from "./api_pb";
+import { file_ai_stigmer_agentic_workflowexecution_v1_enum } from "./enum_pb";
+import { file_buf_validate_validate } from "../../../../../buf/validate/validate_pb";
+import { file_google_protobuf_struct } from "@bufbuild/protobuf/wkt";
+/**
+ * Describes the file ai/stigmer/agentic/workflowexecution/v1/io.proto.
+ */
+export const file_ai_stigmer_agentic_workflowexecution_v1_io = /*@__PURE__*/ fileDesc("CjBhaS9zdGlnbWVyL2FnZW50aWMvd29ya2Zsb3dleGVjdXRpb24vdjEvaW8ucHJvdG8SJ2FpLnN0aWdtZXIuYWdlbnRpYy53b3JrZmxvd2V4ZWN1dGlvbi52MSIsChNXb3JrZmxvd0V4ZWN1dGlvbklkEhUKBXZhbHVlGAEgASgJQga6SAPIAQEiIwoKV29ya2Zsb3dJZBIVCgV2YWx1ZRgBIAEoCUIGukgDyAEBInkKFVdvcmtmbG93RXhlY3V0aW9uTGlzdBITCgt0b3RhbF9wYWdlcxgBIAEoBRJLCgdlbnRyaWVzGAIgAygLMjouYWkuc3RpZ21lci5hZ2VudGljLndvcmtmbG93ZXhlY3V0aW9uLnYxLldvcmtmbG93RXhlY3V0aW9uIpwBCh1MaXN0V29ya2Zsb3dFeGVjdXRpb25zUmVxdWVzdBIRCglwYWdlX3NpemUYASABKAUSEgoKcGFnZV90b2tlbhgCIAEoCRJGCgVwaGFzZRgDIAEoDjI3LmFpLnN0aWdtZXIuYWdlbnRpYy53b3JrZmxvd2V4ZWN1dGlvbi52MS5FeGVjdXRpb25QaGFzZRIMCgR0YWdzGAQgAygJIm0KJ0xpc3RXb3JrZmxvd0V4ZWN1dGlvbnNCeVdvcmtmbG93UmVxdWVzdBIbCgt3b3JrZmxvd19pZBgBIAEoCUIGukgDyAEBEhEKCXBhZ2Vfc2l6ZRgCIAEoBRISCgpwYWdlX3Rva2VuGAMgASgJIp0BCiJXb3JrZmxvd0V4ZWN1dGlvblVwZGF0ZVN0YXR1c0lucHV0Eh0KDGV4ZWN1dGlvbl9pZBgBIAEoCUIHukgEcgIQARJYCgZzdGF0dXMYAiABKAsyQC5haS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3dleGVjdXRpb24udjEuV29ya2Zsb3dFeGVjdXRpb25TdGF0dXNCBrpIA8gBASK+AQobU3VibWl0V29ya2Zsb3dBcHByb3ZhbElucHV0Eh0KDGV4ZWN1dGlvbl9pZBgBIAEoCUIHukgEcgIQARIdCgx0b29sX2NhbGxfaWQYAiABKAlCB7pIBHICEAESUAoGYWN0aW9uGAMgASgOMjQuYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLkFwcHJvdmFsQWN0aW9uQgq6SAeCAQQQASAAEg8KB2NvbW1lbnQYBCABKAkiQQohU3Vic2NyaWJlV29ya2Zsb3dFeGVjdXRpb25SZXF1ZXN0EhwKDGV4ZWN1dGlvbl9pZBgBIAEoCUIGukgDyAEBIokCChdXb3JrZmxvd0V4ZWN1dGlvblVwZGF0ZRJaCgt1cGRhdGVfdHlwZRgBIAEoDjI7LmFpLnN0aWdtZXIuYWdlbnRpYy53b3JrZmxvd2V4ZWN1dGlvbi52MS5Xb3JrZmxvd1VwZGF0ZVR5cGVCCLpIBYIBAhABEk0KCWV4ZWN1dGlvbhgCIAEoCzI6LmFpLnN0aWdtZXIuYWdlbnRpYy53b3JrZmxvd2V4ZWN1dGlvbi52MS5Xb3JrZmxvd0V4ZWN1dGlvbhJDCgR0YXNrGAMgASgLMjUuYWkuc3RpZ21lci5hZ2VudGljLndvcmtmbG93ZXhlY3V0aW9uLnYxLldvcmtmbG93VGFzayJDChxDYW5jZWxXb3JrZmxvd0V4ZWN1dGlvbklucHV0EhMKAmlkGAEgASgJQge6SARyAhABEg4KBnJlYXNvbhgCIAEoCSJGCh9UZXJtaW5hdGVXb3JrZmxvd0V4ZWN1dGlvbklucHV0EhMKAmlkGAEgASgJQge6SARyAhABEg4KBnJlYXNvbhgCIAEoCSJECh1SZWNvdmVyV29ya2Zsb3dFeGVjdXRpb25JbnB1dBITCgJpZBgBIAEoCUIHukgEcgIQARIOCgZyZWFzb24YAiABKAkiQgobUGF1c2VXb3JrZmxvd0V4ZWN1dGlvbklucHV0EhMKAmlkGAEgASgJQge6SARyAhABEg4KBnJlYXNvbhgCIAEoCSIzChxSZXN1bWVXb3JrZmxvd0V4ZWN1dGlvbklucHV0EhMKAmlkGAEgASgJQge6SARyAhABIpEBCg9TZW5kU2lnbmFsSW5wdXQSHQoMZXhlY3V0aW9uX2lkGAEgASgJQge6SARyAhABEhwKC3NpZ25hbF9uYW1lGAIgASgJQge6SARyAhABEigKB3BheWxvYWQYAyABKAsyFy5nb29nbGUucHJvdG9idWYuU3RydWN0EhcKD2lkZW1wb3RlbmN5X2tleRgEIAEoCSrzAQoSV29ya2Zsb3dVcGRhdGVUeXBlEiQKIHdvcmtmbG93X3VwZGF0ZV90eXBlX3Vuc3BlY2lmaWVkEAASHAoYd2ZfdXBkYXRlX3N0YXR1c19jaGFuZ2VkEAESGgoWd2ZfdXBkYXRlX3Rhc2tfc3RhcnRlZBACEhwKGHdmX3VwZGF0ZV90YXNrX2NvbXBsZXRlZBADEhkKFXdmX3VwZGF0ZV90YXNrX2ZhaWxlZBAEEiEKHXdmX3VwZGF0ZV9leGVjdXRpb25fY29tcGxldGVkEAUSIQodd2ZfdXBkYXRlX2V4ZWN1dGlvbl9jYW5jZWxsZWQQBmIGcHJvdG8z", [file_ai_stigmer_agentic_agentexecution_v1_enum, file_ai_stigmer_agentic_workflowexecution_v1_api, file_ai_stigmer_agentic_workflowexecution_v1_enum, file_buf_validate_validate, file_google_protobuf_struct]);
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionId.
+ * Use `create(WorkflowExecutionIdSchema)` to create a new message.
+ */
+export const WorkflowExecutionIdSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflowexecution_v1_io, 0);
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.WorkflowId.
+ * Use `create(WorkflowIdSchema)` to create a new message.
+ */
+export const WorkflowIdSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflowexecution_v1_io, 1);
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionList.
+ * Use `create(WorkflowExecutionListSchema)` to create a new message.
+ */
+export const WorkflowExecutionListSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflowexecution_v1_io, 2);
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.ListWorkflowExecutionsRequest.
+ * Use `create(ListWorkflowExecutionsRequestSchema)` to create a new message.
+ */
+export const ListWorkflowExecutionsRequestSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflowexecution_v1_io, 3);
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.ListWorkflowExecutionsByWorkflowRequest.
+ * Use `create(ListWorkflowExecutionsByWorkflowRequestSchema)` to create a new message.
+ */
+export const ListWorkflowExecutionsByWorkflowRequestSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflowexecution_v1_io, 4);
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionUpdateStatusInput.
+ * Use `create(WorkflowExecutionUpdateStatusInputSchema)` to create a new message.
+ */
+export const WorkflowExecutionUpdateStatusInputSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflowexecution_v1_io, 5);
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.SubmitWorkflowApprovalInput.
+ * Use `create(SubmitWorkflowApprovalInputSchema)` to create a new message.
+ */
+export const SubmitWorkflowApprovalInputSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflowexecution_v1_io, 6);
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.SubscribeWorkflowExecutionRequest.
+ * Use `create(SubscribeWorkflowExecutionRequestSchema)` to create a new message.
+ */
+export const SubscribeWorkflowExecutionRequestSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflowexecution_v1_io, 7);
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionUpdate.
+ * Use `create(WorkflowExecutionUpdateSchema)` to create a new message.
+ */
+export const WorkflowExecutionUpdateSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflowexecution_v1_io, 8);
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.CancelWorkflowExecutionInput.
+ * Use `create(CancelWorkflowExecutionInputSchema)` to create a new message.
+ */
+export const CancelWorkflowExecutionInputSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflowexecution_v1_io, 9);
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.TerminateWorkflowExecutionInput.
+ * Use `create(TerminateWorkflowExecutionInputSchema)` to create a new message.
+ */
+export const TerminateWorkflowExecutionInputSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflowexecution_v1_io, 10);
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.RecoverWorkflowExecutionInput.
+ * Use `create(RecoverWorkflowExecutionInputSchema)` to create a new message.
+ */
+export const RecoverWorkflowExecutionInputSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflowexecution_v1_io, 11);
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.PauseWorkflowExecutionInput.
+ * Use `create(PauseWorkflowExecutionInputSchema)` to create a new message.
+ */
+export const PauseWorkflowExecutionInputSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflowexecution_v1_io, 12);
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.ResumeWorkflowExecutionInput.
+ * Use `create(ResumeWorkflowExecutionInputSchema)` to create a new message.
+ */
+export const ResumeWorkflowExecutionInputSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflowexecution_v1_io, 13);
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.SendSignalInput.
+ * Use `create(SendSignalInputSchema)` to create a new message.
+ */
+export const SendSignalInputSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflowexecution_v1_io, 14);
+/**
+ * WorkflowUpdateType defines the type of workflow execution update event.
+ *
+ * Used by WorkflowExecutionUpdate to indicate what changed in the execution.
+ * Helps clients apply efficient delta updates instead of re-rendering entire UI.
+ *
+ * Event Sequence Example:
+ * 1. wf_update_status_changed (PENDING → IN_PROGRESS)
+ * 2. wf_update_task_started (task-1 started)
+ * 3. wf_update_task_completed (task-1 completed)
+ * 4. wf_update_task_started (task-2 started)
+ * 5. wf_update_task_completed (task-2 completed)
+ * 6. wf_update_execution_completed (workflow done)
+ *
+ * @generated from enum ai.stigmer.agentic.workflowexecution.v1.WorkflowUpdateType
+ */
+export var WorkflowUpdateType;
+(function (WorkflowUpdateType) {
+    /**
+     * Unspecified update type (invalid, should never be used).
+     *
+     * @generated from enum value: workflow_update_type_unspecified = 0;
+     */
+    WorkflowUpdateType[WorkflowUpdateType["workflow_update_type_unspecified"] = 0] = "workflow_update_type_unspecified";
+    /**
+     * Workflow execution phase changed.
+     *
+     * Triggered when status.phase transitions:
+     * - PENDING → IN_PROGRESS (execution started)
+     * - IN_PROGRESS → COMPLETED (execution succeeded)
+     * - IN_PROGRESS → FAILED (execution failed)
+     * - IN_PROGRESS → CANCELLED (execution cancelled)
+     *
+     * UI Impact: Update status badge, progress indicator
+     *
+     * @generated from enum value: wf_update_status_changed = 1;
+     */
+    WorkflowUpdateType[WorkflowUpdateType["wf_update_status_changed"] = 1] = "wf_update_status_changed";
+    /**
+     * A workflow task started executing.
+     *
+     * Triggered when task status changes from PENDING to IN_PROGRESS.
+     *
+     * Update includes:
+     * - task.status = WORKFLOW_TASK_IN_PROGRESS
+     * - task.started_at = current timestamp
+     *
+     * UI Impact: Show spinner/loading indicator for this task
+     *
+     * @generated from enum value: wf_update_task_started = 2;
+     */
+    WorkflowUpdateType[WorkflowUpdateType["wf_update_task_started"] = 2] = "wf_update_task_started";
+    /**
+     * A workflow task completed successfully.
+     *
+     * Triggered when task status changes from IN_PROGRESS to COMPLETED.
+     *
+     * Update includes:
+     * - task.status = WORKFLOW_TASK_COMPLETED
+     * - task.output = task results
+     * - task.completed_at = current timestamp
+     * - execution.completed_tasks incremented
+     *
+     * UI Impact: Show checkmark, display task output, update progress bar
+     *
+     * @generated from enum value: wf_update_task_completed = 3;
+     */
+    WorkflowUpdateType[WorkflowUpdateType["wf_update_task_completed"] = 3] = "wf_update_task_completed";
+    /**
+     * A workflow task failed.
+     *
+     * Triggered when task status changes from IN_PROGRESS to FAILED.
+     *
+     * Update includes:
+     * - task.status = WORKFLOW_TASK_FAILED
+     * - task.error = error message
+     * - task.completed_at = current timestamp
+     * - execution.completed_tasks incremented
+     *
+     * UI Impact: Show error icon, display error message, may trigger workflow failure
+     *
+     * @generated from enum value: wf_update_task_failed = 4;
+     */
+    WorkflowUpdateType[WorkflowUpdateType["wf_update_task_failed"] = 4] = "wf_update_task_failed";
+    /**
+     * Workflow execution completed successfully.
+     *
+     * Triggered when all tasks completed and workflow produces final output.
+     *
+     * Update includes:
+     * - execution.status.phase = EXECUTION_COMPLETED
+     * - execution.status.output = workflow results
+     * - execution.status.completed_at = current timestamp
+     *
+     * UI Impact: Show success badge, display final output, enable download/export
+     *
+     * Note: This is a terminal event - no more updates will follow.
+     *
+     * @generated from enum value: wf_update_execution_completed = 5;
+     */
+    WorkflowUpdateType[WorkflowUpdateType["wf_update_execution_completed"] = 5] = "wf_update_execution_completed";
+    /**
+     * Workflow execution was cancelled.
+     *
+     * Triggered when user or system cancels the execution.
+     *
+     * Update includes:
+     * - execution.status.phase = EXECUTION_CANCELLED
+     * - execution.status.completed_at = current timestamp
+     *
+     * UI Impact: Show cancelled badge, grey out in-progress tasks
+     *
+     * Note: This is a terminal event - no more updates will follow.
+     *
+     * @generated from enum value: wf_update_execution_cancelled = 6;
+     */
+    WorkflowUpdateType[WorkflowUpdateType["wf_update_execution_cancelled"] = 6] = "wf_update_execution_cancelled";
+})(WorkflowUpdateType || (WorkflowUpdateType = {}));
+/**
+ * Describes the enum ai.stigmer.agentic.workflowexecution.v1.WorkflowUpdateType.
+ */
+export const WorkflowUpdateTypeSchema = /*@__PURE__*/ enumDesc(file_ai_stigmer_agentic_workflowexecution_v1_io, 0);
+//# sourceMappingURL=io_pb.js.map

package/ai/stigmer/agentic/workflowexecution/v1/io_pb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/workflowexecution/v1/io_pb.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,391 @@
+/**
+ * WorkflowExecutionQueryController handles read operations (Get, List, Subscribe) for WorkflowExecution resources.
+ *
+ * This service follows the Command-Query Separation (CQS) pattern:
+ * - CommandController: Write operations (create, update, delete)
+ * - QueryController: Read operations (get, list, search, subscribe)
+ *
+ * Authorization:
+ * - get: Standard authorization - user must have "get" permission on the specific WorkflowExecution
+ * - list: Custom authorization - filters results based on user's owner scope and permissions
+ * - list_by_workflow: Custom authorization - verifies user has access to the Workflow/WorkflowInstance
+ * - subscribe: Standard authorization - user must have "get" permission to subscribe to updates
+ *
+ * Service Options:
+ * - api_resource_kind: workflow_execution - Links this service to the WorkflowExecution resource
+ *
+ * @generated from service ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionQueryController
+ */
+export declare const WorkflowExecutionQueryController: {
+    readonly typeName: "ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionQueryController";
+    readonly methods: {
+        /**
+         * Get a single workflow execution by ID.
+         *
+         * Retrieves the complete WorkflowExecution resource including:
+         * - spec: User inputs (workflow_instance_id, trigger_message, etc.)
+         * - status: Current execution state (phase, tasks, progress_events, output/error)
+         * - metadata: Resource identification (id, name, labels, tags)
+         *
+         * Authorization:
+         * Standard authorization checks that user has "get" permission on the WorkflowExecution.
+         * Permission is granted if:
+         * - User created the execution (metadata.audit.created_by matches user)
+         * - User has organization-level "workflow_execution:get" permission
+         * - User has explicit permission via IamPolicy
+         *
+         * Use Cases:
+         *
+         * 1. View Execution Details:
+         * - User clicks on an execution in the UI
+         * - UI calls get() to fetch full details
+         * - UI displays execution status, tasks, progress, output/error
+         *
+         * 2. Poll for Completion:
+         * - Client triggers execution via create()
+         * - Client periodically calls get() to check if phase is terminal
+         * - Client retrieves output when phase == EXECUTION_COMPLETED
+         *
+         * 3. Debug Failed Execution:
+         * - User sees execution failed
+         * - User calls get() to inspect status.error and status.tasks
+         * - User checks status.tasks[] for task-level execution details
+         *
+         * 4. Retry Failed Execution:
+         * - User calls get() to retrieve failed execution's spec
+         * - User creates new execution with same spec values
+         * - New execution retries with identical inputs
+         *
+         * Error Cases:
+         *
+         * - NOT_FOUND:
+         *   - No WorkflowExecution exists with the given ID
+         *
+         * - PERMISSION_DENIED:
+         *   - User doesn't have "get" permission on this WorkflowExecution
+         *   - WorkflowExecution belongs to different organization
+         *
+         * Example Request:
+         * {
+         *   "value": "wfx-abc123xyz456"
+         * }
+         *
+         * Example Response:
+         * {
+         *   "api_version": "agentic.stigmer.ai/v1",
+         *   "kind": "WorkflowExecution",
+         *   "metadata": {
+         *     "id": "wfx-abc123xyz456",
+         *     "name": "customer-onboarding-20250111-143022",
+         *     "org": "acme"
+         *   },
+         *   "spec": {
+         *     "workflow_instance_id": "wfi-customer-onboarding-prod",
+         *     "trigger_message": "New signup: john.doe@example.com"
+         *   },
+         *   "status": {
+         *     "phase": 2,  // EXECUTION_IN_PROGRESS
+         *     "total_tasks": 3,
+         *     "completed_tasks": 1,
+         *     "tasks": [ ... ],
+         *     "started_at": "2025-01-11T14:30:22Z"
+         *   }
+         * }
+         *
+         * @generated from rpc ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionQueryController.get
+         */
+        readonly get: {
+            readonly name: "get";
+            readonly I: any;
+            readonly O: any;
+            readonly kind: any;
+        };
+        /**
+         * List workflow executions with pagination and optional filtering.
+         *
+         * Returns a paginated list of WorkflowExecution resources that the user has access to.
+         * Results are automatically filtered based on user's permissions and owner scope.
+         *
+         * Authorization:
+         * Custom authorization filters results to only include executions the user can access:
+         * - Organization users: Only executions in their organization
+         * - Users with cross-org access: Public executions from other orgs
+         *
+         * Pagination:
+         * - page_size: Maximum number of results to return (default: 50, max: 100)
+         * - page_token: Opaque token from previous response for next page
+         * - Returns total_pages count for UI pagination
+         *
+         * Filtering:
+         * - phase: Filter by execution phase (PENDING, IN_PROGRESS, COMPLETED, FAILED, CANCELLED)
+         * - tags: Filter by resource tags (AND logic - must match all tags)
+         *
+         * Sorting:
+         * Results are sorted by created_at descending (newest first).
+         *
+         * Use Cases:
+         *
+         * 1. Execution History Dashboard:
+         * - UI displays list of all recent executions
+         * - User can filter by status (show only failed, show only in-progress)
+         * - User can page through historical executions
+         *
+         * 2. Monitor Active Executions:
+         * - UI calls list(phase=EXECUTION_IN_PROGRESS) to show running executions
+         * - UI displays progress for each execution (completed_tasks / total_tasks)
+         * - UI refreshes list periodically to show updates
+         *
+         * 3. Audit and Compliance:
+         * - Admin lists all executions for a time period
+         * - Admin filters by tags (environment, team, project)
+         * - Admin exports execution history for audit logs
+         *
+         * 4. Debug and Troubleshooting:
+         * - Developer lists failed executions (phase=EXECUTION_FAILED)
+         * - Developer inspects error messages and retry patterns
+         * - Developer identifies systematic failures
+         *
+         * Error Cases:
+         *
+         * - INVALID_ARGUMENT:
+         *   - page_size is negative or exceeds maximum
+         *   - Invalid page_token (expired, corrupted)
+         *
+         * Example Request (Filter for failed executions):
+         * {
+         *   "page_size": 20,
+         *   "phase": 4,  // EXECUTION_FAILED
+         *   "tags": ["environment:production"]
+         * }
+         *
+         * Example Response:
+         * {
+         *   "total_pages": 3,
+         *   "entries": [
+         *     {
+         *       "metadata": { "id": "wfx-failed-1", ... },
+         *       "status": { "phase": 4, "error": "Task failed: API timeout", ... }
+         *     },
+         *     {
+         *       "metadata": { "id": "wfx-failed-2", ... },
+         *       "status": { "phase": 4, "error": "Task failed: Rate limit", ... }
+         *     }
+         *   ]
+         * }
+         *
+         * @generated from rpc ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionQueryController.list
+         */
+        readonly list: {
+            readonly name: "list";
+            readonly I: any;
+            readonly O: any;
+            readonly kind: any;
+        };
+        /**
+         * List all executions for a specific Workflow or WorkflowInstance.
+         *
+         * Returns executions filtered by a specific Workflow ID.
+         * This is useful for viewing execution history of a particular workflow.
+         *
+         * Authorization:
+         * Custom authorization verifies:
+         * 1. User has access to the referenced Workflow or WorkflowInstance
+         * 2. Results are filtered to only include executions user can access
+         *
+         * Pagination:
+         * - page_size: Maximum number of results to return (default: 50, max: 100)
+         * - page_token: Opaque token from previous response for next page
+         *
+         * Sorting:
+         * Results are sorted by created_at descending (newest first).
+         *
+         * Use Cases:
+         *
+         * 1. Workflow Execution History:
+         * - User views a Workflow in the UI
+         * - UI calls listByWorkflow(workflow_id) to show all executions
+         * - UI displays timeline of executions with success/failure indicators
+         *
+         * 2. Performance Analysis:
+         * - Developer wants to analyze workflow performance over time
+         * - Developer calls listByWorkflow() to get all executions
+         * - Developer calculates average duration, success rate, failure patterns
+         *
+         * 3. Retry Analysis:
+         * - User sees failed execution
+         * - User calls listByWorkflow() to see if other executions also failed
+         * - User determines if failure is systematic or one-off
+         *
+         * 4. Workflow Testing:
+         * - Developer tests a workflow with multiple executions
+         * - Developer calls listByWorkflow() to see all test runs
+         * - Developer compares outputs across executions
+         *
+         * Error Cases:
+         *
+         * - INVALID_ARGUMENT:
+         *   - workflow_id is empty or invalid format
+         *   - page_size is negative or exceeds maximum
+         *
+         * - PERMISSION_DENIED:
+         *   - User doesn't have access to the referenced Workflow/WorkflowInstance
+         *
+         * - NOT_FOUND:
+         *   - No Workflow or WorkflowInstance exists with the given ID
+         *
+         * Example Request:
+         * {
+         *   "workflow_id": "wfi-customer-onboarding-prod",
+         *   "page_size": 50
+         * }
+         *
+         * Example Response:
+         * {
+         *   "total_pages": 5,
+         *   "entries": [
+         *     {
+         *       "metadata": { "id": "wfx-latest", "created_at": "2025-01-11T14:30:22Z" },
+         *       "status": { "phase": 3, ... }  // COMPLETED
+         *     },
+         *     {
+         *       "metadata": { "id": "wfx-previous", "created_at": "2025-01-11T10:15:00Z" },
+         *       "status": { "phase": 4, ... }  // FAILED
+         *     }
+         *   ]
+         * }
+         *
+         * @generated from rpc ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionQueryController.listByWorkflow
+         */
+        readonly listByWorkflow: {
+            readonly name: "listByWorkflow";
+            readonly I: any;
+            readonly O: any;
+            readonly kind: any;
+        };
+        /**
+         * Subscribe to real-time updates for a specific workflow execution (server streaming).
+         *
+         * Opens a bidirectional stream that pushes WorkflowExecution updates as they occur.
+         * Client receives updates when:
+         * - Execution phase changes (PENDING → IN_PROGRESS → COMPLETED)
+         * - Tasks start or complete
+         * - Progress events are appended
+         * - Output or error fields are set
+         *
+         * Authorization:
+         * Standard authorization checks that user has "get" permission on the WorkflowExecution.
+         * This is the same permission check as get() RPC.
+         *
+         * Stream Lifecycle:
+         * 1. Client sends SubscribeWorkflowExecutionRequest with execution_id
+         * 2. Server validates authorization
+         * 3. Server sends initial WorkflowExecution (current state)
+         * 4. Server streams updates as execution progresses
+         * 5. Server closes stream when execution reaches terminal state (COMPLETED/FAILED/CANCELLED)
+         * 6. Client can close stream early (e.g., user navigates away from page)
+         *
+         * Update Frequency:
+         * - Updates are sent immediately when execution state changes
+         * - No polling necessary (server pushes updates)
+         * - Typical update latency: < 100ms
+         *
+         * Use Cases:
+         *
+         * 1. Real-Time Progress Monitoring:
+         * - User triggers an execution from UI
+         * - UI subscribes to execution updates
+         * - UI displays live progress: tasks completing, progress bar updating
+         * - UI shows final output when execution completes
+         *
+         * 2. Long-Running Workflow Monitoring:
+         * - Workflow takes hours to complete (e.g., data processing)
+         * - UI subscribes and shows live progress
+         * - User can leave page, come back, and reconnect to same execution
+         *
+         * 3. Debugging with Live Updates:
+         * - Developer triggers test execution
+         * - Developer subscribes to watch execution progress
+         * - Developer sees exactly which task is running and when failures occur
+         *
+         * 4. Multi-User Collaboration:
+         * - Multiple users watching same execution
+         * - All users receive same updates simultaneously
+         * - All users see consistent view of execution state
+         *
+         * Stream Message Format:
+         * Each message is a complete WorkflowExecution resource with updated status.
+         *
+         * Error Cases:
+         *
+         * - NOT_FOUND:
+         *   - No WorkflowExecution exists with the given ID
+         *
+         * - PERMISSION_DENIED:
+         *   - User doesn't have "get" permission on this WorkflowExecution
+         *
+         * - DEADLINE_EXCEEDED:
+         *   - Client timeout (client should reconnect)
+         *
+         * - UNAVAILABLE:
+         *   - Server unavailable (client should retry with backoff)
+         *
+         * Example Request:
+         * {
+         *   "execution_id": "wfx-abc123xyz456"
+         * }
+         *
+         * Example Stream (sequence of messages):
+         *
+         * Message 1 (initial state):
+         * {
+         *   "metadata": { "id": "wfx-abc123xyz456" },
+         *   "status": {
+         *     "phase": 1,  // EXECUTION_PENDING
+         *     "total_tasks": 3,
+         *     "completed_tasks": 0
+         *   }
+         * }
+         *
+         * Message 2 (execution started):
+         * {
+         *   "metadata": { "id": "wfx-abc123xyz456" },
+         *   "status": {
+         *     "phase": 2,  // EXECUTION_IN_PROGRESS
+         *     "started_at": "2025-01-11T14:30:22Z"
+         *   }
+         * }
+         *
+         * Message 3 (task 1 completed):
+         * {
+         *   "metadata": { "id": "wfx-abc123xyz456" },
+         *   "status": {
+         *     "phase": 2,  // EXECUTION_IN_PROGRESS
+         *     "completed_tasks": 1,
+         *     "tasks": [
+         *       { "task_id": "task-1", "status": 3, "output": { ... } }
+         *     ]
+         *   }
+         * }
+         *
+         * Message 4 (execution completed):
+         * {
+         *   "metadata": { "id": "wfx-abc123xyz456" },
+         *   "status": {
+         *     "phase": 3,  // EXECUTION_COMPLETED
+         *     "completed_tasks": 3,
+         *     "output": { ... },
+         *     "completed_at": "2025-01-11T14:35:47Z"
+         *   }
+         * }
+         * [Stream closes]
+         *
+         * @generated from rpc ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionQueryController.subscribe
+         */
+        readonly subscribe: {
+            readonly name: "subscribe";
+            readonly I: any;
+            readonly O: any;
+            readonly kind: any;
+        };
+    };
+};