@stigmer/protos 3.12.3 → 3.12.4

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

@@ -12,19 +12,12 @@ export declare const file_ai_stigmer_agentic_workflowexecution_v1_io: GenFile;
 /**
  * WorkflowExecutionId wraps a workflow execution identifier.
  *
- * @internal
- * Using a wrapper (instead of a raw string) provides validation,
- * clear field naming, and extensibility.
- *
  * @generated from message ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionId
  */
 export type WorkflowExecutionId = Message<"ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionId"> & {
     /**
      * Workflow execution identifier.
      *
-     * @internal
-     * Format: "wfx_{unique-suffix}" (auto-generated by backend)
-     *
      * @generated from field: string value = 1;
      */
     value: string;
@@ -37,18 +30,12 @@ export declare const WorkflowExecutionIdSchema: GenMessage<WorkflowExecutionId>;
 /**
  * WorkflowId wraps a workflow or workflow instance identifier for filtering.
  *
- * @internal
- * Accepts either a Workflow ID (wf_{slug}) or WorkflowInstance ID (wfi_{slug}).
- *
  * @generated from message ai.stigmer.agentic.workflowexecution.v1.WorkflowId
  */
 export type WorkflowId = Message<"ai.stigmer.agentic.workflowexecution.v1.WorkflowId"> & {
     /**
      * Workflow or WorkflowInstance identifier.
      *
-     * @internal
-     * Can be either a Workflow ID (wf_{slug}) or WorkflowInstance ID (wfi_{slug}).
-     *
      * @generated from field: string value = 1;
      */
     value: string;
@@ -61,20 +48,12 @@ export declare const WorkflowIdSchema: GenMessage<WorkflowId>;
 /**
  * WorkflowExecutionList contains a paginated list of workflow executions.
  *
- * @internal
- * Returned by list operations (list, list_by_workflow).
- * Includes pagination metadata and the execution entries for the current page.
- *
  * @generated from message ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionList
  */
 export type WorkflowExecutionList = Message<"ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionList"> & {
     /**
      * Total number of pages available for this query.
      *
-     * @internal
-     * Calculated as: ceil(total_matching_executions / page_size).
-     * May change between requests if results are created or deleted.
-     *
      * @generated from field: int32 total_pages = 1;
      */
     totalPages: number;
@@ -93,46 +72,30 @@ export declare const WorkflowExecutionListSchema: GenMessage<WorkflowExecutionLi
 /**
  * ListWorkflowExecutionsRequest specifies parameters for listing workflow executions.
  *
- * @internal
- * Supports pagination and filtering by phase and tags.
- *
  * @generated from message ai.stigmer.agentic.workflowexecution.v1.ListWorkflowExecutionsRequest
  */
 export type ListWorkflowExecutionsRequest = Message<"ai.stigmer.agentic.workflowexecution.v1.ListWorkflowExecutionsRequest"> & {
     /**
      * Maximum number of executions to return per page.
      *
-     * @internal
-     * Default: 50. Maximum: 100 (backend enforces this limit).
-     *
      * @generated from field: int32 page_size = 1;
      */
     pageSize: number;
     /**
      * Opaque pagination token from a previous response.
      *
-     * @internal
-     * Empty on first request. When empty in a response, no more pages are available.
-     *
      * @generated from field: string page_token = 2;
      */
     pageToken: string;
     /**
      * Filter by execution phase.
      *
-     * @internal
-     * If not specified (or EXECUTION_PHASE_UNSPECIFIED), all phases are included.
-     *
      * @generated from field: ai.stigmer.agentic.workflowexecution.v1.ExecutionPhase phase = 3;
      */
     phase: ExecutionPhase;
     /**
      * Filter by resource tags (AND logic).
      *
-     * @internal
-     * Limits results to executions that have ALL specified tags.
-     * Tag format: "key:value" or "key" (for boolean tags).
-     *
      * @generated from field: repeated string tags = 4;
      */
     tags: string[];
@@ -171,12 +134,6 @@ export type ListWorkflowExecutionsRequest = Message<"ai.stigmer.agentic.workflow
      * only by the caller's view permissions, which for a member of several
      * organizations spans all of them.
      *
-     * @internal
-     * Optional by design: pre-existing callers rely on the permission-bounded
-     * behavior, and the OSS single-user edition treats org filtering as a
-     * no-op. Filtering happens in the query/list step of each edition's
-     * handler, never client-side.
-     *
      * @generated from field: string org = 8;
      */
     org: string;
@@ -189,28 +146,18 @@ export declare const ListWorkflowExecutionsRequestSchema: GenMessage<ListWorkflo
 /**
  * ListWorkflowExecutionsByWorkflowRequest lists executions for a specific workflow.
  *
- * @internal
- * Filters executions by Workflow or WorkflowInstance ID.
- * Unlike ListWorkflowExecutionsRequest (cross-workflow), this scopes to one workflow.
- *
  * @generated from message ai.stigmer.agentic.workflowexecution.v1.ListWorkflowExecutionsByWorkflowRequest
  */
 export type ListWorkflowExecutionsByWorkflowRequest = Message<"ai.stigmer.agentic.workflowexecution.v1.ListWorkflowExecutionsByWorkflowRequest"> & {
     /**
      * Workflow or WorkflowInstance ID to filter by.
      *
-     * @internal
-     * Can be either a Workflow ID (wf_{slug}) or WorkflowInstance ID (wfi_{slug}).
-     *
      * @generated from field: string workflow_id = 1;
      */
     workflowId: string;
     /**
      * Maximum number of executions to return per page.
      *
-     * @internal
-     * Default: 50. Maximum: 100 (backend enforces this limit).
-     *
      * @generated from field: int32 page_size = 2;
      */
     pageSize: number;
@@ -253,49 +200,24 @@ export declare const ListWorkflowExecutionsByWorkflowRequestSchema: GenMessage<L
 /**
  * Input for the updateStatus RPC.
  *
- * @internal
- * Contains only the execution ID and the status fields to be updated.
- * This avoids validation errors on incomplete metadata/spec fields.
- *
  * @generated from message ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionUpdateStatusInput
  */
 export type WorkflowExecutionUpdateStatusInput = Message<"ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionUpdateStatusInput"> & {
     /**
      * ID of the workflow execution to update.
      *
-     * @internal
-     * Format: "wex_abc123xyz456"
-     *
      * @generated from field: string execution_id = 1;
      */
     executionId: string;
     /**
      * Status fields to merge into the existing execution status.
      *
-     * @internal
-     * Only the fields present in this status object will be updated.
-     *
      * @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 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[];
@@ -304,20 +226,6 @@ export type WorkflowExecutionUpdateStatusInput = Message<"ai.stigmer.agentic.wor
      * pending_update_child_agent_execution_id. When false (default), the stored
      * list is preserved unchanged.
      *
-     * @internal
-     * Per-child merge (NOT full-replace): the write replaces the entries for the
-     * scoped child and preserves every sibling child's entries, so parallel child
-     * agents never clobber each other's approval gates. A scoped write with an
-     * empty incoming list clears just that child's entries. The guard still
-     * prevents concurrent event emissions (which don't include approvals) from
-     * disturbing active gates set by call-agent-status.
-     *
-     * Only call-agent-status.ts sets this to true — both when populating approvals
-     * from a child_approval_required signal and when clearing them after the child
-     * agent completes.
-     *
-     * @since Agent Call Live Experience (per-child merge since Workflow-Parent File Review)
-     *
      * @generated from field: bool update_pending_approvals = 11;
      */
     updatePendingApprovals: boolean;
@@ -327,12 +235,6 @@ export type WorkflowExecutionUpdateStatusInput = Message<"ai.stigmer.agentic.wor
      * semantics as update_pending_approvals. When false (default), the stored list
      * is preserved unchanged.
      *
-     * @internal
-     * Only call-agent-status.ts sets this to true — when surfacing a child's
-     * AWAITING_REVIEW change sets and when clearing them.
-     *
-     * @since Workflow-Parent File Review
-     *
      * @generated from field: bool update_pending_file_reviews = 12;
      */
     updatePendingFileReviews: boolean;
@@ -344,11 +246,6 @@ export type WorkflowExecutionUpdateStatusInput = Message<"ai.stigmer.agentic.wor
      * the clear case, where the scoped incoming list is empty (the child id is the
      * only way to know which child to clear).
      *
-     * @internal
-     * Format: AgentExecution.metadata.id (e.g., "aex_abc123xyz456").
-     *
-     * @since Workflow-Parent File Review
-     *
      * @generated from field: string pending_update_child_agent_execution_id = 13;
      */
     pendingUpdateChildAgentExecutionId: string;
@@ -361,48 +258,24 @@ export declare const WorkflowExecutionUpdateStatusInputSchema: GenMessage<Workfl
 /**
  * Input for the submitApproval RPC.
  *
- * @internal
- * Forwards an approval decision to a child AgentExecution that is waiting for
- * approval. The child execution ID is resolved from
- * status.pending_approval.child_agent_execution_id.
- *
- * Validation:
- * - execution_id: Required, must reference an existing WorkflowExecution
- * - tool_call_id: Required, must match status.pending_approval.tool_call_id
- * - action: Required, must be APPROVE, SKIP, REJECT, or APPROVE_ALL (not UNSPECIFIED)
- * - comment: Optional, stored in audit trail
- *
  * @generated from message ai.stigmer.agentic.workflowexecution.v1.SubmitWorkflowApprovalInput
  */
 export type SubmitWorkflowApprovalInput = Message<"ai.stigmer.agentic.workflowexecution.v1.SubmitWorkflowApprovalInput"> & {
     /**
      * ID of the workflow execution.
      *
-     * @internal
-     * Format: "wfx_abc123xyz456"
-     *
      * @generated from field: string execution_id = 1;
      */
     executionId: string;
     /**
      * ID of the tool call to approve, skip, or reject.
      *
-     * @internal
-     * Must match status.pending_approval.tool_call_id exactly.
-     *
      * @generated from field: string tool_call_id = 2;
      */
     toolCallId: string;
     /**
      * Approval decision: APPROVE, SKIP, REJECT, or APPROVE_ALL.
      *
-     * @internal
-     * Forwarded verbatim to the child's AgentExecution.SubmitApproval, so every
-     * ApprovalAction the child accepts is valid here — including APPROVE_ALL,
-     * whose run-lifetime lease is applied by the child and therefore scoped to
-     * that child agent execution (a parallel sibling's gates keep prompting).
-     * APPROVAL_ACTION_UNSPECIFIED (0) is rejected by validation.
-     *
      * @generated from field: ai.stigmer.agentic.agentexecution.v1.ApprovalAction action = 3;
      */
     action: ApprovalAction;
@@ -421,46 +294,24 @@ export declare const SubmitWorkflowApprovalInputSchema: GenMessage<SubmitWorkflo
 /**
  * Input for the WorkflowExecution.submitFileDecision RPC.
  *
- * @internal
- * Forwards a file-review keep/discard decision to a child AgentExecution whose
- * file-review gate is surfaced on the parent via status.pending_file_reviews.
- * Mirrors agentexecution.SubmitFileDecisionInput plus explicit routing: the UI
- * holds child_agent_execution_id from the surfaced reference, so routing is
- * explicit and does not depend on change_set_id being globally unique. The
- * handler validates the (child_agent_execution_id, change_set_id) pair is present
- * in status.pending_file_reviews before forwarding, then invokes
- * AgentExecution.submitFileDecision on the same thread so the caller identity
- * (reviewer_id) propagates.
- *
  * @generated from message ai.stigmer.agentic.workflowexecution.v1.SubmitWorkflowFileDecisionInput
  */
 export type SubmitWorkflowFileDecisionInput = Message<"ai.stigmer.agentic.workflowexecution.v1.SubmitWorkflowFileDecisionInput"> & {
     /**
      * ID of the workflow execution.
      *
-     * @internal
-     * Format: "wfx_abc123xyz456"
-     *
      * @generated from field: string execution_id = 1;
      */
     executionId: string;
     /**
      * ID of the child agent execution holding the file-review gate.
      *
-     * @internal
-     * Must match a WorkflowPendingFileReview.child_agent_execution_id in
-     * status.pending_file_reviews. Format: AgentExecution.metadata.id.
-     *
      * @generated from field: string child_agent_execution_id = 2;
      */
     childAgentExecutionId: string;
     /**
      * ID of the change set this decision targets.
      *
-     * @internal
-     * Must be listed under the matched child's WorkflowPendingFileReview.change_set_id
-     * and match a FileChangeSet.id on the child's status.file_change_sets.
-     *
      * @generated from field: string change_set_id = 3;
      */
     changeSetId: string;
@@ -518,81 +369,36 @@ export declare const SubmitWorkflowFileDecisionInputSchema: GenMessage<SubmitWor
  * SubmitWorkflowTaskApprovalInput submits a human reviewer's decision for a
  * workflow-level human_input task.
  *
- * @internal
- * Unlike submitApproval (which forwards agent-level tool approvals to a child
- * AgentExecution), this RPC resolves workflow-level human_input tasks. The handler:
- *
- * 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 runner receives and processes the signal.
- *
- * @since T13b (Java/Cloud Backend Parity)
- *
  * @generated from message ai.stigmer.agentic.workflowexecution.v1.SubmitWorkflowTaskApprovalInput
  */
 export type SubmitWorkflowTaskApprovalInput = Message<"ai.stigmer.agentic.workflowexecution.v1.SubmitWorkflowTaskApprovalInput"> & {
     /**
      * ID of the workflow execution containing the human_input task.
      *
-     * @internal
-     * Format: "wfx_{unique-suffix}"
-     *
      * @generated from field: string execution_id = 1;
      */
     executionId: string;
     /**
      * 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
-     * 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: google.protobuf.Struct form_data = 4;
      */
     formData?: JsonObject;
     /**
      * Identity of the reviewer submitting the decision.
      *
-     * @internal
-     * Attribution contract:
-     * - Interactive clients (web console, CLI, SDKs) MUST leave this empty.
-     *   The server attributes the decision from the authenticated caller —
-     *   a client-supplied identity is spoofable and is overridden for human
-     *   callers.
-     * - Machine-account callers MAY set it for delegated attribution, e.g.
-     *   a channel broker submitting a decision on behalf of an external
-     *   reviewer (Slack user) where the caller identity is the service
-     *   account and this field is the only truthful source.
-     * Stored in the task output and the approval_resolved event for audit.
-     *
      * @generated from field: string reviewer = 5;
      */
     reviewer: string;
@@ -611,19 +417,12 @@ export declare const SubmitWorkflowTaskApprovalInputSchema: GenMessage<SubmitWor
 /**
  * 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
-     * Format: "wfx_{unique-suffix}"
-     *
      * @generated from field: string execution_id = 1;
      */
     executionId: string;
@@ -636,25 +435,12 @@ export declare const SubscribeWorkflowExecutionRequestSchema: GenMessage<Subscri
 /**
  * CancelWorkflowExecutionInput requests graceful cancellation of a workflow execution.
  *
- * @internal
- * Sends a cancellation signal to the workflow engine, allowing the workflow code
- * to perform cleanup before transitioning to EXECUTION_CANCELLED phase.
- *
- * Preconditions:
- * - Execution must be in EXECUTION_PENDING or EXECUTION_IN_PROGRESS phase
- * - User must have can_edit permission
- *
- * Idempotent: if already cancelled, returns current state as a no-op.
- *
  * @generated from message ai.stigmer.agentic.workflowexecution.v1.CancelWorkflowExecutionInput
  */
 export type CancelWorkflowExecutionInput = Message<"ai.stigmer.agentic.workflowexecution.v1.CancelWorkflowExecutionInput"> & {
     /**
      * Workflow execution ID to cancel.
      *
-     * @internal
-     * Format: "wfx_{ulid}"
-     *
      * @generated from field: string id = 1;
      */
     id: string;
@@ -673,25 +459,12 @@ export declare const CancelWorkflowExecutionInputSchema: GenMessage<CancelWorkfl
 /**
  * TerminateWorkflowExecutionInput requests immediate termination of a workflow execution.
  *
- * @internal
- * Force-kills the workflow without allowing cleanup. Unlike cancellation,
- * the workflow code cannot respond to termination.
- *
- * Preconditions:
- * - Execution must be in EXECUTION_PENDING or EXECUTION_IN_PROGRESS phase
- * - User must have can_edit permission
- *
- * Idempotent: if already terminated, returns current state as a no-op.
- *
  * @generated from message ai.stigmer.agentic.workflowexecution.v1.TerminateWorkflowExecutionInput
  */
 export type TerminateWorkflowExecutionInput = Message<"ai.stigmer.agentic.workflowexecution.v1.TerminateWorkflowExecutionInput"> & {
     /**
      * Workflow execution ID to terminate.
      *
-     * @internal
-     * Format: "wfx_{ulid}"
-     *
      * @generated from field: string id = 1;
      */
     id: string;
@@ -714,30 +487,12 @@ export declare const TerminateWorkflowExecutionInputSchema: GenMessage<Terminate
  * skipped (their outputs restored into workflow context), and execution resumes
  * from the first incomplete or failed task.
  *
- * @internal
- * Terminates the existing Temporal orchestrator and child workflows, recreates
- * the ExecutionContext with freshly resolved environment variables, and starts a
- * new orchestrator with recoveryMode enabled. The workflow engine reads completed
- * task outputs from the persisted event log, skips those tasks (emitting
- * task_skipped events), and begins execution at the first non-completed task.
- * Event sequence numbers continue from the high-water mark of the previous run.
- *
- * Preconditions:
- * - Execution must be in EXECUTION_FAILED phase
- * - TERMINATED and CANCELLED executions cannot be recovered
- * - User must have can_edit permission
- *
- * Idempotent: if recovery is already in progress, returns current state as a no-op.
- *
  * @generated from message ai.stigmer.agentic.workflowexecution.v1.RecoverWorkflowExecutionInput
  */
 export type RecoverWorkflowExecutionInput = Message<"ai.stigmer.agentic.workflowexecution.v1.RecoverWorkflowExecutionInput"> & {
     /**
      * Workflow execution ID to recover (must be in FAILED phase).
      *
-     * @internal
-     * Format: "wfx_{ulid}"
-     *
      * @generated from field: string id = 1;
      */
     id: string;
@@ -756,21 +511,12 @@ export declare const RecoverWorkflowExecutionInputSchema: GenMessage<RecoverWork
 /**
  * PauseWorkflowExecutionInput requests temporarily pausing a workflow execution.
  *
- * @internal
- * Pauses the workflow at its current checkpoint. The execution is NOT terminal
- * and can be resumed later via the resume RPC.
- *
- * @since Gap A3 (Pause/Resume Propagation)
- *
  * @generated from message ai.stigmer.agentic.workflowexecution.v1.PauseWorkflowExecutionInput
  */
 export type PauseWorkflowExecutionInput = Message<"ai.stigmer.agentic.workflowexecution.v1.PauseWorkflowExecutionInput"> & {
     /**
      * Workflow execution ID to pause (must be in PENDING or IN_PROGRESS phase).
      *
-     * @internal
-     * Format: "wfx_{ulid}"
-     *
      * @generated from field: string id = 1;
      */
     id: string;
@@ -789,21 +535,12 @@ export declare const PauseWorkflowExecutionInputSchema: GenMessage<PauseWorkflow
 /**
  * ResumeWorkflowExecutionInput requests resuming a paused workflow execution.
  *
- * @internal
- * Continues execution from the checkpoint where it was paused.
- * Execution must be in EXECUTION_PAUSED phase.
- *
- * @since Gap A3 (Pause/Resume Propagation)
- *
  * @generated from message ai.stigmer.agentic.workflowexecution.v1.ResumeWorkflowExecutionInput
  */
 export type ResumeWorkflowExecutionInput = Message<"ai.stigmer.agentic.workflowexecution.v1.ResumeWorkflowExecutionInput"> & {
     /**
      * Workflow execution ID to resume (must be in PAUSED phase).
      *
-     * @internal
-     * Format: "wfx_{ulid}"
-     *
      * @generated from field: string id = 1;
      */
     id: string;
@@ -816,34 +553,18 @@ export declare const ResumeWorkflowExecutionInputSchema: GenMessage<ResumeWorkfl
 /**
  * SendSignalInput delivers a named signal to a workflow execution.
  *
- * @internal
- * Sends a signal to a running or pending workflow execution, typically to unblock
- * a LISTEN task. Uses race-proof delivery internally (SignalWithStart).
- *
- * Preconditions:
- * - Execution must be in EXECUTION_PENDING or EXECUTION_IN_PROGRESS phase
- * - User must have can_edit permission
- *
- * @since Gap B1 (Signal-With-Start)
- *
  * @generated from message ai.stigmer.agentic.workflowexecution.v1.SendSignalInput
  */
 export type SendSignalInput = Message<"ai.stigmer.agentic.workflowexecution.v1.SendSignalInput"> & {
     /**
      * Workflow execution ID to send the signal to.
      *
-     * @internal
-     * Format: "wfx_{ulid}"
-     *
      * @generated from field: string execution_id = 1;
      */
     executionId: string;
     /**
      * Signal name matching the workflow's LISTEN task signal ID.
      *
-     * @internal
-     * Case-sensitive, follows snake_case convention.
-     *
      * @generated from field: string signal_name = 2;
      */
     signalName: string;
@@ -856,20 +577,6 @@ export type SendSignalInput = Message<"ai.stigmer.agentic.workflowexecution.v1.S
     /**
      * Optional idempotency key for deduplication of signal delivery.
      *
-     * @internal
-     * When provided, a signal whose key was already DELIVERED (within a 24-hour
-     * window anchored at delivery) is rejected with ALREADY_EXISTS instead of
-     * being re-delivered; nothing is cached or replayed. A same-key request
-     * whose delivery is currently in flight is rejected with ABORTED — a
-     * retryable conflict, unlike ALREADY_EXISTS. A FAILED delivery frees the
-     * key (immediately on a clean failure, within a short in-flight hold after
-     * a crash), so retrying a failed attempt with the same key works — the
-     * scenario idempotency keys exist for. Both editions enforce this
-     * identically. Keys are scoped to the organization to prevent cross-org
-     * collisions.
-     *
-     * @since Gap B2 (Event Dedupe)
-     *
      * @generated from field: string idempotency_key = 4;
      */
     idempotencyKey: string;
@@ -882,78 +589,36 @@ export declare const SendSignalInputSchema: GenMessage<SendSignalInput>;
 /**
  * GetEventLogRequest fetches the paginated event log for a workflow execution.
  *
- * @internal
- * Returns events ordered by sequence_number ascending. Supports cursor-based
- * pagination via after_sequence and optional filtering by event type or task.
- *
- * 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 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;
     /**
      * Return events with sequence_number strictly greater than this value.
      *
-     * @internal
-     * 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 field: uint64 after_sequence = 2;
      */
     afterSequence: bigint;
     /**
      * Optional filter: return only events of these types.
      *
-     * @internal
-     * 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 field: repeated ai.stigmer.agentic.workflowexecution.v1.WorkflowEventType event_types = 3;
      */
     eventTypes: WorkflowEventType[];
     /**
      * Optional filter: return only events for this task.
      *
-     * @internal
-     * 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 field: string task_name = 4;
      */
     taskName: string;
     /**
      * Maximum number of events to return per page.
      *
-     * @internal
-     * 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;
@@ -966,9 +631,6 @@ 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"> & {
@@ -1003,58 +665,24 @@ 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
-     * Format: "wfx_{unique-suffix}"
-     *
      * @generated from field: string execution_id = 1;
      */
     executionId: string;
     /**
      * Resume from this sequence number (replay + live tail).
      *
-     * @internal
-     * 0 = start from the beginning (replay all events then live tail).
-     * N = replay events with sequence_number > N, then live tail.
-     *
-     * 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;
      */
     afterSequence: bigint;
     /**
      * Optional filter: stream only events of these types.
      *
-     * @internal
-     * 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[];