@stigmer/protos 0.5.1 → 1.0.1

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

@@ -0,0 +1,1287 @@
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
+import type { ApprovalAction, ExecutionPhase } from "../../agentexecution/v1/enum_pb.js";
+import type { BudgetExceededPolicy, WorkflowTaskKind } from "../../workflow/v1/enum_pb.js";
+import type { JsonObject, Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file ai/stigmer/agentic/workflowexecution/v1/event.proto.
+ */
+export declare const file_ai_stigmer_agentic_workflowexecution_v1_event: GenFile;
+/**
+ * WorkflowExecutionEvent represents a single timestamped event in the execution
+ * timeline of a workflow run.
+ *
+ * @internal
+ * Events form an append-only log that captures the full history of an execution:
+ * what happened, when, and in what order. This complements the existing
+ * WorkflowExecutionStatus snapshot model (which answers "what is the current state?")
+ * by adding the temporal dimension ("what happened?").
+ *
+ * The event log enables:
+ * - Execution viewer timeline (T09) — ordered sequence of task transitions
+ * - Retry visibility — task_started + task_failed + task_retrying + task_started
+ *   tells the full story that a point-in-time snapshot cannot
+ * - Cost attribution — per-task cost/token breakdown over time
+ * - Audit trail — who approved what, when, with what decision
+ * - Agent subtrace context — lightweight progress summaries with child execution
+ *   references for drill-down (full agent stream fetched separately)
+ *
+ * Ordering:
+ * Events are ordered by sequence_number (monotonic per execution, assigned by
+ * the workflow-runner). Wall-clock occurred_at is informational; sequence_number
+ * is the authoritative ordering key.
+ *
+ * Production:
+ * The workflow-runner appends events alongside status updates via the
+ * updateStatus RPC. Events are persisted atomically with the status update.
+ *
+ * Consumption:
+ * - getEventLog RPC: paginated fetch for completed or in-progress executions
+ * - subscribeEvents RPC: real-time server-stream of incremental events
+ *
+ * @since T06 (Execution Event Stream Model)
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionEvent
+ */
+export type WorkflowExecutionEvent = Message<"ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionEvent"> & {
+    /**
+     * Unique event identifier.
+     *
+     * @internal
+     * Format: UUID v4, generated by the workflow-runner at event creation time.
+     * Used for deduplication on retries: (execution_id, event_id) is unique.
+     *
+     * @generated from field: string event_id = 1;
+     */
+    eventId: string;
+    /**
+     * Type of event that occurred.
+     *
+     * @internal
+     * Determines which oneof payload field is populated.
+     * Consumers should switch on event_type to extract the correct payload.
+     *
+     * @generated from field: ai.stigmer.agentic.workflowexecution.v1.WorkflowEventType event_type = 2;
+     */
+    eventType: WorkflowEventType;
+    /**
+     * Monotonically increasing sequence number within this execution.
+     *
+     * @internal
+     * Assigned by the workflow-runner, starting at 1 for the first event.
+     * Provides total ordering within a single execution without relying on
+     * clock synchronization. Used as the cursor for paginated event queries
+     * (getEventLog) and live-tail positioning (subscribeEvents).
+     *
+     * If the runner crashes and restarts, it queries getEventLog to recover
+     * the last sequence number before emitting new events.
+     *
+     * @generated from field: uint64 sequence_number = 3;
+     */
+    sequenceNumber: bigint;
+    /**
+     * ISO 8601 timestamp when the event occurred.
+     *
+     * @internal
+     * Wall-clock time from the workflow-runner. Informational — do not use
+     * for ordering (use sequence_number instead). Useful for:
+     * - Displaying human-readable timestamps in the execution viewer
+     * - Calculating task durations (task_completed.occurred_at - task_started.occurred_at)
+     * - Correlating with external system logs
+     *
+     * Format: "YYYY-MM-DDTHH:MM:SS.sssZ" (UTC, millisecond precision)
+     *
+     * @generated from field: string occurred_at = 4;
+     */
+    occurredAt: string;
+    /**
+     * Name of the task this event relates to, if applicable.
+     *
+     * @internal
+     * Empty for execution-level events (execution_started, execution_completed, etc.).
+     * Populated for task-level events (task_started, task_completed, agent_call_progress, etc.).
+     * Matches WorkflowTask.task_name in the status snapshot.
+     *
+     * Enables filtering events by task: "show me everything that happened for task X."
+     *
+     * @generated from field: string task_name = 5;
+     */
+    taskName: string;
+    /**
+     * Event-specific payload, discriminated by event_type.
+     *
+     * @internal
+     * Exactly one payload field is populated per event, corresponding to the
+     * event_type. Consumers must check event_type before accessing the payload
+     * to avoid reading the wrong oneof branch.
+     *
+     * @generated from oneof ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionEvent.payload
+     */
+    payload: {
+        /**
+         * @generated from field: ai.stigmer.agentic.workflowexecution.v1.ExecutionStartedPayload execution_started = 10;
+         */
+        value: ExecutionStartedPayload;
+        case: "executionStarted";
+    } | {
+        /**
+         * @generated from field: ai.stigmer.agentic.workflowexecution.v1.ExecutionCompletedPayload execution_completed = 11;
+         */
+        value: ExecutionCompletedPayload;
+        case: "executionCompleted";
+    } | {
+        /**
+         * @generated from field: ai.stigmer.agentic.workflowexecution.v1.ExecutionFailedPayload execution_failed = 12;
+         */
+        value: ExecutionFailedPayload;
+        case: "executionFailed";
+    } | {
+        /**
+         * @generated from field: ai.stigmer.agentic.workflowexecution.v1.ExecutionPausedPayload execution_paused = 13;
+         */
+        value: ExecutionPausedPayload;
+        case: "executionPaused";
+    } | {
+        /**
+         * @generated from field: ai.stigmer.agentic.workflowexecution.v1.ExecutionResumedPayload execution_resumed = 14;
+         */
+        value: ExecutionResumedPayload;
+        case: "executionResumed";
+    } | {
+        /**
+         * @generated from field: ai.stigmer.agentic.workflowexecution.v1.ExecutionCancelledPayload execution_cancelled = 15;
+         */
+        value: ExecutionCancelledPayload;
+        case: "executionCancelled";
+    } | {
+        /**
+         * @generated from field: ai.stigmer.agentic.workflowexecution.v1.ExecutionTerminatedPayload execution_terminated = 16;
+         */
+        value: ExecutionTerminatedPayload;
+        case: "executionTerminated";
+    } | {
+        /**
+         * @generated from field: ai.stigmer.agentic.workflowexecution.v1.TaskStartedPayload task_started = 20;
+         */
+        value: TaskStartedPayload;
+        case: "taskStarted";
+    } | {
+        /**
+         * @generated from field: ai.stigmer.agentic.workflowexecution.v1.TaskCompletedPayload task_completed = 21;
+         */
+        value: TaskCompletedPayload;
+        case: "taskCompleted";
+    } | {
+        /**
+         * @generated from field: ai.stigmer.agentic.workflowexecution.v1.TaskFailedPayload task_failed = 22;
+         */
+        value: TaskFailedPayload;
+        case: "taskFailed";
+    } | {
+        /**
+         * @generated from field: ai.stigmer.agentic.workflowexecution.v1.TaskSkippedPayload task_skipped = 23;
+         */
+        value: TaskSkippedPayload;
+        case: "taskSkipped";
+    } | {
+        /**
+         * @generated from field: ai.stigmer.agentic.workflowexecution.v1.TaskRetryingPayload task_retrying = 24;
+         */
+        value: TaskRetryingPayload;
+        case: "taskRetrying";
+    } | {
+        /**
+         * @generated from field: ai.stigmer.agentic.workflowexecution.v1.AgentCallStartedPayload agent_call_started = 30;
+         */
+        value: AgentCallStartedPayload;
+        case: "agentCallStarted";
+    } | {
+        /**
+         * @generated from field: ai.stigmer.agentic.workflowexecution.v1.AgentCallProgressPayload agent_call_progress = 31;
+         */
+        value: AgentCallProgressPayload;
+        case: "agentCallProgress";
+    } | {
+        /**
+         * @generated from field: ai.stigmer.agentic.workflowexecution.v1.AgentCallCompletedPayload agent_call_completed = 32;
+         */
+        value: AgentCallCompletedPayload;
+        case: "agentCallCompleted";
+    } | {
+        /**
+         * @generated from field: ai.stigmer.agentic.workflowexecution.v1.ApprovalRequestedPayload approval_requested = 40;
+         */
+        value: ApprovalRequestedPayload;
+        case: "approvalRequested";
+    } | {
+        /**
+         * @generated from field: ai.stigmer.agentic.workflowexecution.v1.ApprovalResolvedPayload approval_resolved = 41;
+         */
+        value: ApprovalResolvedPayload;
+        case: "approvalResolved";
+    } | {
+        /**
+         * @generated from field: ai.stigmer.agentic.workflowexecution.v1.BudgetCheckpointPayload budget_checkpoint = 50;
+         */
+        value: BudgetCheckpointPayload;
+        case: "budgetCheckpoint";
+    } | {
+        /**
+         * @generated from field: ai.stigmer.agentic.workflowexecution.v1.SignalReceivedPayload signal_received = 60;
+         */
+        value: SignalReceivedPayload;
+        case: "signalReceived";
+    } | {
+        /**
+         * @generated from field: ai.stigmer.agentic.workflowexecution.v1.EventEmittedPayload event_emitted = 61;
+         */
+        value: EventEmittedPayload;
+        case: "eventEmitted";
+    } | {
+        /**
+         * @generated from field: ai.stigmer.agentic.workflowexecution.v1.ArtifactCreatedPayload artifact_created = 70;
+         */
+        value: ArtifactCreatedPayload;
+        case: "artifactCreated";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionEvent.
+ * Use `create(WorkflowExecutionEventSchema)` to create a new message.
+ */
+export declare const WorkflowExecutionEventSchema: GenMessage<WorkflowExecutionEvent>;
+/**
+ * Payload for execution_started events.
+ *
+ * @internal
+ * Emitted once per execution when the runner picks up the workflow and
+ * transitions phase from PENDING to IN_PROGRESS.
+ *
+ * @since T06
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.ExecutionStartedPayload
+ */
+export type ExecutionStartedPayload = Message<"ai.stigmer.agentic.workflowexecution.v1.ExecutionStartedPayload"> & {
+    /**
+     * Total number of top-level tasks in the workflow definition.
+     * Enables progress calculation (completed_count / total_tasks).
+     *
+     * @generated from field: int32 total_tasks = 1;
+     */
+    totalTasks: number;
+    /**
+     * Workflow ID (wf_{slug}) resolved for this execution.
+     *
+     * @generated from field: string workflow_id = 2;
+     */
+    workflowId: string;
+    /**
+     * WorkflowInstance ID (wfi_{slug}) resolved for this execution.
+     *
+     * @generated from field: string workflow_instance_id = 3;
+     */
+    workflowInstanceId: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.ExecutionStartedPayload.
+ * Use `create(ExecutionStartedPayloadSchema)` to create a new message.
+ */
+export declare const ExecutionStartedPayloadSchema: GenMessage<ExecutionStartedPayload>;
+/**
+ * Payload for execution_completed events.
+ *
+ * @internal
+ * Emitted when all tasks have reached terminal states and the workflow
+ * produces its final output. This is the last event for a successful execution.
+ *
+ * @since T06
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.ExecutionCompletedPayload
+ */
+export type ExecutionCompletedPayload = Message<"ai.stigmer.agentic.workflowexecution.v1.ExecutionCompletedPayload"> & {
+    /**
+     * Final workflow output, truncated if exceeding size limits.
+     * The full output is available on WorkflowExecutionStatus.output.
+     *
+     * @generated from field: google.protobuf.Struct output_summary = 1;
+     */
+    outputSummary?: JsonObject;
+    /**
+     * Total wall-clock duration of the execution in milliseconds.
+     *
+     * @generated from field: int64 duration_ms = 2;
+     */
+    durationMs: bigint;
+    /**
+     * Aggregate cost across all tasks in micro-USD (1 USD = 1,000,000 micros).
+     *
+     * @generated from field: int64 total_cost_micros = 3;
+     */
+    totalCostMicros: bigint;
+    /**
+     * Aggregate token consumption across all LLM/agent tasks.
+     *
+     * @generated from field: int64 total_tokens = 4;
+     */
+    totalTokens: bigint;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.ExecutionCompletedPayload.
+ * Use `create(ExecutionCompletedPayloadSchema)` to create a new message.
+ */
+export declare const ExecutionCompletedPayloadSchema: GenMessage<ExecutionCompletedPayload>;
+/**
+ * Payload for execution_failed events.
+ *
+ * @internal
+ * Emitted when the workflow transitions to EXECUTION_FAILED. Contains the
+ * top-level error and a reference to the task that caused the failure.
+ *
+ * @since T06
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.ExecutionFailedPayload
+ */
+export type ExecutionFailedPayload = Message<"ai.stigmer.agentic.workflowexecution.v1.ExecutionFailedPayload"> & {
+    /**
+     * Human-readable error description.
+     * Same as WorkflowExecutionStatus.error.
+     *
+     * @generated from field: string error = 1;
+     */
+    error: string;
+    /**
+     * Name of the task that caused the failure, if applicable.
+     * Empty for workflow-level failures (e.g., budget exceeded, timeout).
+     *
+     * @generated from field: string failed_task_name = 2;
+     */
+    failedTaskName: string;
+    /**
+     * Total wall-clock duration before failure in milliseconds.
+     *
+     * @generated from field: int64 duration_ms = 3;
+     */
+    durationMs: bigint;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.ExecutionFailedPayload.
+ * Use `create(ExecutionFailedPayloadSchema)` to create a new message.
+ */
+export declare const ExecutionFailedPayloadSchema: GenMessage<ExecutionFailedPayload>;
+/**
+ * Payload for execution_paused events.
+ *
+ * @internal
+ * @since T06
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.ExecutionPausedPayload
+ */
+export type ExecutionPausedPayload = Message<"ai.stigmer.agentic.workflowexecution.v1.ExecutionPausedPayload"> & {
+    /**
+     * Human-readable reason for the pause, from PauseWorkflowExecutionInput.reason.
+     *
+     * @generated from field: string reason = 1;
+     */
+    reason: string;
+    /**
+     * Identity of the user or system that requested the pause.
+     *
+     * @generated from field: string paused_by = 2;
+     */
+    pausedBy: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.ExecutionPausedPayload.
+ * Use `create(ExecutionPausedPayloadSchema)` to create a new message.
+ */
+export declare const ExecutionPausedPayloadSchema: GenMessage<ExecutionPausedPayload>;
+/**
+ * Payload for execution_resumed events.
+ *
+ * @internal
+ * @since T06
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.ExecutionResumedPayload
+ */
+export type ExecutionResumedPayload = Message<"ai.stigmer.agentic.workflowexecution.v1.ExecutionResumedPayload"> & {
+    /**
+     * Identity of the user or system that resumed the execution.
+     *
+     * @generated from field: string resumed_by = 1;
+     */
+    resumedBy: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.ExecutionResumedPayload.
+ * Use `create(ExecutionResumedPayloadSchema)` to create a new message.
+ */
+export declare const ExecutionResumedPayloadSchema: GenMessage<ExecutionResumedPayload>;
+/**
+ * Payload for execution_cancelled events.
+ *
+ * @internal
+ * @since T06
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.ExecutionCancelledPayload
+ */
+export type ExecutionCancelledPayload = Message<"ai.stigmer.agentic.workflowexecution.v1.ExecutionCancelledPayload"> & {
+    /**
+     * Human-readable reason for cancellation, from CancelWorkflowExecutionInput.reason.
+     *
+     * @generated from field: string reason = 1;
+     */
+    reason: string;
+    /**
+     * Identity of the user or system that cancelled the execution.
+     *
+     * @generated from field: string cancelled_by = 2;
+     */
+    cancelledBy: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.ExecutionCancelledPayload.
+ * Use `create(ExecutionCancelledPayloadSchema)` to create a new message.
+ */
+export declare const ExecutionCancelledPayloadSchema: GenMessage<ExecutionCancelledPayload>;
+/**
+ * Payload for execution_terminated events.
+ *
+ * @internal
+ * @since T06
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.ExecutionTerminatedPayload
+ */
+export type ExecutionTerminatedPayload = Message<"ai.stigmer.agentic.workflowexecution.v1.ExecutionTerminatedPayload"> & {
+    /**
+     * Human-readable reason for termination.
+     *
+     * @generated from field: string reason = 1;
+     */
+    reason: string;
+    /**
+     * Identity of the user or system that terminated the execution.
+     *
+     * @generated from field: string terminated_by = 2;
+     */
+    terminatedBy: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.ExecutionTerminatedPayload.
+ * Use `create(ExecutionTerminatedPayloadSchema)` to create a new message.
+ */
+export declare const ExecutionTerminatedPayloadSchema: GenMessage<ExecutionTerminatedPayload>;
+/**
+ * Payload for task_started events.
+ *
+ * @internal
+ * Emitted when a task transitions from PENDING to IN_PROGRESS.
+ *
+ * @since T06
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.TaskStartedPayload
+ */
+export type TaskStartedPayload = Message<"ai.stigmer.agentic.workflowexecution.v1.TaskStartedPayload"> & {
+    /**
+     * Task kind from the workflow definition (e.g., agent_call, llm_call, http_call).
+     *
+     * @generated from field: ai.stigmer.agentic.workflow.v1.WorkflowTaskKind task_kind = 1;
+     */
+    taskKind: WorkflowTaskKind;
+    /**
+     * Truncated summary of the task input configuration.
+     * Full input is available on WorkflowTask.input in the status snapshot.
+     * Truncated to prevent event bloat from large Struct payloads.
+     *
+     * @generated from field: google.protobuf.Struct input_summary = 2;
+     */
+    inputSummary?: JsonObject;
+    /**
+     * For retry attempts: which attempt number this is (1 = first attempt).
+     *
+     * @generated from field: int32 attempt_number = 3;
+     */
+    attemptNumber: number;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.TaskStartedPayload.
+ * Use `create(TaskStartedPayloadSchema)` to create a new message.
+ */
+export declare const TaskStartedPayloadSchema: GenMessage<TaskStartedPayload>;
+/**
+ * Payload for task_completed events.
+ *
+ * @internal
+ * Emitted when a task transitions to WORKFLOW_TASK_COMPLETED.
+ *
+ * @since T06
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.TaskCompletedPayload
+ */
+export type TaskCompletedPayload = Message<"ai.stigmer.agentic.workflowexecution.v1.TaskCompletedPayload"> & {
+    /**
+     * Task kind for correlation with task_started.
+     *
+     * @generated from field: ai.stigmer.agentic.workflow.v1.WorkflowTaskKind task_kind = 1;
+     */
+    taskKind: WorkflowTaskKind;
+    /**
+     * Task execution duration in milliseconds.
+     *
+     * @generated from field: int64 duration_ms = 2;
+     */
+    durationMs: bigint;
+    /**
+     * Truncated summary of the task output.
+     * Full output is available on WorkflowTask.output in the status snapshot.
+     *
+     * @generated from field: google.protobuf.Struct output_summary = 3;
+     */
+    outputSummary?: JsonObject;
+    /**
+     * Cost incurred by this task in micro-USD (0 for non-LLM/non-agent tasks).
+     *
+     * @generated from field: int64 cost_micros = 4;
+     */
+    costMicros: bigint;
+    /**
+     * Tokens consumed by this task (0 for non-LLM/non-agent tasks).
+     *
+     * @generated from field: int64 tokens_used = 5;
+     */
+    tokensUsed: bigint;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.TaskCompletedPayload.
+ * Use `create(TaskCompletedPayloadSchema)` to create a new message.
+ */
+export declare const TaskCompletedPayloadSchema: GenMessage<TaskCompletedPayload>;
+/**
+ * Payload for task_failed events.
+ *
+ * @internal
+ * Emitted when a task transitions to WORKFLOW_TASK_FAILED.
+ * If the task will be retried, a task_retrying event follows this one.
+ *
+ * @since T06
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.TaskFailedPayload
+ */
+export type TaskFailedPayload = Message<"ai.stigmer.agentic.workflowexecution.v1.TaskFailedPayload"> & {
+    /**
+     * Task kind for correlation.
+     *
+     * @generated from field: ai.stigmer.agentic.workflow.v1.WorkflowTaskKind task_kind = 1;
+     */
+    taskKind: WorkflowTaskKind;
+    /**
+     * Human-readable error description.
+     *
+     * @generated from field: string error = 2;
+     */
+    error: string;
+    /**
+     * Which attempt this failure occurred on (1 = first attempt).
+     *
+     * @generated from field: int32 attempt_number = 3;
+     */
+    attemptNumber: number;
+    /**
+     * Maximum retry attempts configured for this task.
+     * 0 means no retries configured.
+     *
+     * @generated from field: int32 max_attempts = 4;
+     */
+    maxAttempts: number;
+    /**
+     * Whether the runner will retry this task after this failure.
+     * When true, a task_retrying event will follow.
+     *
+     * @generated from field: bool will_retry = 5;
+     */
+    willRetry: boolean;
+    /**
+     * Task execution duration for this attempt in milliseconds.
+     *
+     * @generated from field: int64 duration_ms = 6;
+     */
+    durationMs: bigint;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.TaskFailedPayload.
+ * Use `create(TaskFailedPayloadSchema)` to create a new message.
+ */
+export declare const TaskFailedPayloadSchema: GenMessage<TaskFailedPayload>;
+/**
+ * Payload for task_skipped events.
+ *
+ * @internal
+ * Emitted when a task transitions to WORKFLOW_TASK_SKIPPED due to
+ * conditional logic (switch_case evaluated to a different branch).
+ *
+ * @since T06
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.TaskSkippedPayload
+ */
+export type TaskSkippedPayload = Message<"ai.stigmer.agentic.workflowexecution.v1.TaskSkippedPayload"> & {
+    /**
+     * Task kind that was skipped.
+     *
+     * @generated from field: ai.stigmer.agentic.workflow.v1.WorkflowTaskKind task_kind = 1;
+     */
+    taskKind: WorkflowTaskKind;
+    /**
+     * Reason the task was skipped (e.g., "condition evaluated to false",
+     * "branch not selected").
+     *
+     * @generated from field: string reason = 2;
+     */
+    reason: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.TaskSkippedPayload.
+ * Use `create(TaskSkippedPayloadSchema)` to create a new message.
+ */
+export declare const TaskSkippedPayloadSchema: GenMessage<TaskSkippedPayload>;
+/**
+ * Payload for task_retrying events.
+ *
+ * @internal
+ * Emitted between a task_failed and the next task_started for the same task.
+ * Indicates the runner is scheduling a retry with optional backoff.
+ *
+ * @since T06
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.TaskRetryingPayload
+ */
+export type TaskRetryingPayload = Message<"ai.stigmer.agentic.workflowexecution.v1.TaskRetryingPayload"> & {
+    /**
+     * Which attempt failed, prompting this retry.
+     *
+     * @generated from field: int32 failed_attempt = 1;
+     */
+    failedAttempt: number;
+    /**
+     * Which attempt number will be tried next.
+     *
+     * @generated from field: int32 next_attempt = 2;
+     */
+    nextAttempt: number;
+    /**
+     * Delay before the retry starts, in milliseconds.
+     * 0 means immediate retry.
+     *
+     * @generated from field: int64 delay_ms = 3;
+     */
+    delayMs: bigint;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.TaskRetryingPayload.
+ * Use `create(TaskRetryingPayloadSchema)` to create a new message.
+ */
+export declare const TaskRetryingPayloadSchema: GenMessage<TaskRetryingPayload>;
+/**
+ * Payload for agent_call_started events.
+ *
+ * @internal
+ * Emitted when the workflow-runner creates a child AgentExecution for an
+ * agent_call task. The child_execution_id enables the UI to open a
+ * drill-down stream into the agent's execution.
+ *
+ * @since T06
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.AgentCallStartedPayload
+ */
+export type AgentCallStartedPayload = Message<"ai.stigmer.agentic.workflowexecution.v1.AgentCallStartedPayload"> & {
+    /**
+     * ID of the child AgentExecution (format: "aex_{ulid}").
+     * Use this to subscribe to the agent's execution stream for full detail.
+     *
+     * @generated from field: string child_execution_id = 1;
+     */
+    childExecutionId: string;
+    /**
+     * Agent slug being invoked (e.g., "customer-support-agent").
+     *
+     * @generated from field: string agent_slug = 2;
+     */
+    agentSlug: string;
+    /**
+     * The prompt/message sent to the agent.
+     * Truncated if exceeding size limits.
+     *
+     * @generated from field: string message_summary = 3;
+     */
+    messageSummary: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.AgentCallStartedPayload.
+ * Use `create(AgentCallStartedPayloadSchema)` to create a new message.
+ */
+export declare const AgentCallStartedPayloadSchema: GenMessage<AgentCallStartedPayload>;
+/**
+ * Payload for agent_call_progress events.
+ *
+ * @internal
+ * Periodic lightweight summary emitted while the child agent is running.
+ * Frequency is a runtime decision (T13) — typically on agent phase transitions
+ * or at regular intervals. The full agent stream with messages and tool calls
+ * is available via AgentExecution.subscribe using child_execution_id.
+ *
+ * @since T06
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.AgentCallProgressPayload
+ */
+export type AgentCallProgressPayload = Message<"ai.stigmer.agentic.workflowexecution.v1.AgentCallProgressPayload"> & {
+    /**
+     * ID of the child AgentExecution.
+     *
+     * @generated from field: string child_execution_id = 1;
+     */
+    childExecutionId: string;
+    /**
+     * Current phase of the child agent execution.
+     *
+     * @generated from field: ai.stigmer.agentic.agentexecution.v1.ExecutionPhase agent_phase = 2;
+     */
+    agentPhase: ExecutionPhase;
+    /**
+     * Name of the tool currently being executed, if any.
+     * Empty when the agent is generating text (not calling a tool).
+     *
+     * @generated from field: string current_tool_name = 3;
+     */
+    currentToolName: string;
+    /**
+     * Total tokens consumed by the agent so far.
+     *
+     * @generated from field: int64 tokens_consumed = 4;
+     */
+    tokensConsumed: bigint;
+    /**
+     * Total number of messages in the agent conversation so far.
+     *
+     * @generated from field: int32 messages_count = 5;
+     */
+    messagesCount: number;
+    /**
+     * Number of tool calls completed so far.
+     *
+     * @generated from field: int32 tool_calls_count = 6;
+     */
+    toolCallsCount: number;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.AgentCallProgressPayload.
+ * Use `create(AgentCallProgressPayloadSchema)` to create a new message.
+ */
+export declare const AgentCallProgressPayloadSchema: GenMessage<AgentCallProgressPayload>;
+/**
+ * Payload for agent_call_completed events.
+ *
+ * @internal
+ * Emitted when the child AgentExecution reaches a terminal phase.
+ *
+ * @since T06
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.AgentCallCompletedPayload
+ */
+export type AgentCallCompletedPayload = Message<"ai.stigmer.agentic.workflowexecution.v1.AgentCallCompletedPayload"> & {
+    /**
+     * ID of the child AgentExecution.
+     *
+     * @generated from field: string child_execution_id = 1;
+     */
+    childExecutionId: string;
+    /**
+     * Terminal phase of the child agent execution.
+     *
+     * @generated from field: ai.stigmer.agentic.agentexecution.v1.ExecutionPhase agent_phase = 2;
+     */
+    agentPhase: ExecutionPhase;
+    /**
+     * Duration of the agent execution in milliseconds.
+     *
+     * @generated from field: int64 duration_ms = 3;
+     */
+    durationMs: bigint;
+    /**
+     * Total tokens consumed by the agent.
+     *
+     * @generated from field: int64 tokens_consumed = 4;
+     */
+    tokensConsumed: bigint;
+    /**
+     * Cost incurred by the agent execution in micro-USD.
+     *
+     * @generated from field: int64 cost_micros = 5;
+     */
+    costMicros: bigint;
+    /**
+     * Error message if the agent failed. Empty on success.
+     *
+     * @generated from field: string error = 6;
+     */
+    error: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.AgentCallCompletedPayload.
+ * Use `create(AgentCallCompletedPayloadSchema)` to create a new message.
+ */
+export declare const AgentCallCompletedPayloadSchema: GenMessage<AgentCallCompletedPayload>;
+/**
+ * Payload for approval_requested events.
+ *
+ * @internal
+ * Emitted when a human_input task activates an approval gate, or when a
+ * child agent enters EXECUTION_WAITING_FOR_APPROVAL. Captures who can
+ * approve, the timeout, and the request context.
+ *
+ * @since T06
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.ApprovalRequestedPayload
+ */
+export type ApprovalRequestedPayload = Message<"ai.stigmer.agentic.workflowexecution.v1.ApprovalRequestedPayload"> & {
+    /**
+     * Human-readable prompt explaining what needs approval.
+     *
+     * @generated from field: string prompt = 1;
+     */
+    prompt: string;
+    /**
+     * List of user/role identifiers who can approve.
+     * Empty means any user with can_edit permission can approve.
+     *
+     * @generated from field: repeated string approvers = 2;
+     */
+    approvers: string[];
+    /**
+     * Timeout in seconds after which the approval expires.
+     * 0 means no timeout (waits indefinitely).
+     *
+     * @generated from field: int32 timeout_seconds = 3;
+     */
+    timeoutSeconds: number;
+    /**
+     * For agent tool approvals: the tool_call_id requiring approval.
+     * Empty for workflow-level human_input tasks.
+     *
+     * @generated from field: string tool_call_id = 4;
+     */
+    toolCallId: string;
+    /**
+     * For agent tool approvals: the child AgentExecution ID.
+     * Empty for workflow-level human_input tasks.
+     *
+     * @generated from field: string child_execution_id = 5;
+     */
+    childExecutionId: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.ApprovalRequestedPayload.
+ * Use `create(ApprovalRequestedPayloadSchema)` to create a new message.
+ */
+export declare const ApprovalRequestedPayloadSchema: GenMessage<ApprovalRequestedPayload>;
+/**
+ * Payload for approval_resolved events.
+ *
+ * @internal
+ * Emitted when an approval decision is made (approve, skip, or reject).
+ *
+ * @since T06
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.ApprovalResolvedPayload
+ */
+export type ApprovalResolvedPayload = Message<"ai.stigmer.agentic.workflowexecution.v1.ApprovalResolvedPayload"> & {
+    /**
+     * The decision that was made.
+     *
+     * @generated from field: ai.stigmer.agentic.agentexecution.v1.ApprovalAction action = 1;
+     */
+    action: ApprovalAction;
+    /**
+     * Identity of the user who made the decision.
+     *
+     * @generated from field: string resolved_by = 2;
+     */
+    resolvedBy: string;
+    /**
+     * Optional comment provided with the decision.
+     *
+     * @generated from field: string comment = 3;
+     */
+    comment: string;
+    /**
+     * Duration the approval was pending in milliseconds
+     * (from approval_requested to approval_resolved).
+     *
+     * @generated from field: int64 wait_duration_ms = 4;
+     */
+    waitDurationMs: bigint;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.ApprovalResolvedPayload.
+ * Use `create(ApprovalResolvedPayloadSchema)` to create a new message.
+ */
+export declare const ApprovalResolvedPayloadSchema: GenMessage<ApprovalResolvedPayload>;
+/**
+ * Payload for budget_checkpoint events.
+ *
+ * @internal
+ * Periodic snapshot of budget consumption emitted at task boundaries
+ * (after each cost-incurring task completes). Enables the execution viewer
+ * to render a cost timeline and budget utilization gauge.
+ *
+ * Emission frequency is a runtime decision (T13). Typical triggers:
+ * - After every agent_call or llm_call task completes
+ * - When a budget threshold is breached (e.g., 50%, 80%, 100%)
+ *
+ * All cost values are in micro-USD (1 USD = 1,000,000 micros), consistent
+ * with the WorkflowBudget.max_cost_micros field (T05).
+ *
+ * @since T06
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.BudgetCheckpointPayload
+ */
+export type BudgetCheckpointPayload = Message<"ai.stigmer.agentic.workflowexecution.v1.BudgetCheckpointPayload"> & {
+    /**
+     * Cumulative cost consumed so far in micro-USD.
+     *
+     * @generated from field: int64 cost_consumed_micros = 1;
+     */
+    costConsumedMicros: bigint;
+    /**
+     * Remaining cost budget in micro-USD.
+     * -1 if no cost budget is configured.
+     *
+     * @generated from field: int64 cost_remaining_micros = 2;
+     */
+    costRemainingMicros: bigint;
+    /**
+     * Cumulative tokens consumed so far.
+     *
+     * @generated from field: int64 tokens_consumed = 3;
+     */
+    tokensConsumed: bigint;
+    /**
+     * Remaining token budget.
+     * -1 if no token budget is configured.
+     *
+     * @generated from field: int64 tokens_remaining = 4;
+     */
+    tokensRemaining: bigint;
+    /**
+     * Whether this checkpoint was triggered by a threshold breach.
+     *
+     * @generated from field: bool threshold_breached = 5;
+     */
+    thresholdBreached: boolean;
+    /**
+     * The BudgetExceededPolicy that will be applied if breached.
+     * Only meaningful when threshold_breached is true.
+     *
+     * @generated from field: ai.stigmer.agentic.workflow.v1.BudgetExceededPolicy on_exceeded_policy = 6;
+     */
+    onExceededPolicy: BudgetExceededPolicy;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.BudgetCheckpointPayload.
+ * Use `create(BudgetCheckpointPayloadSchema)` to create a new message.
+ */
+export declare const BudgetCheckpointPayloadSchema: GenMessage<BudgetCheckpointPayload>;
+/**
+ * Payload for signal_received events.
+ *
+ * @internal
+ * Emitted when a listen task receives an external signal (via the sendSignal
+ * RPC or from another workflow's emit_event). Documents the signal arrival
+ * in the execution timeline.
+ *
+ * @since T06
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.SignalReceivedPayload
+ */
+export type SignalReceivedPayload = Message<"ai.stigmer.agentic.workflowexecution.v1.SignalReceivedPayload"> & {
+    /**
+     * Signal name matching the listen task's signal ID.
+     *
+     * @generated from field: string signal_name = 1;
+     */
+    signalName: string;
+    /**
+     * Signal payload (truncated if exceeding size limits).
+     *
+     * @generated from field: google.protobuf.Struct payload_summary = 2;
+     */
+    payloadSummary?: JsonObject;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.SignalReceivedPayload.
+ * Use `create(SignalReceivedPayloadSchema)` to create a new message.
+ */
+export declare const SignalReceivedPayloadSchema: GenMessage<SignalReceivedPayload>;
+/**
+ * Payload for event_emitted events.
+ *
+ * @internal
+ * Emitted when an emit_event task publishes a CloudEvent. Documents the
+ * emission in the execution timeline. The full CloudEvents envelope is
+ * available in the task output.
+ *
+ * @since T06
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.EventEmittedPayload
+ */
+export type EventEmittedPayload = Message<"ai.stigmer.agentic.workflowexecution.v1.EventEmittedPayload"> & {
+    /**
+     * CloudEvents type identifier from the EmitEventSpec.
+     *
+     * @generated from field: string event_type = 1;
+     */
+    eventType: string;
+    /**
+     * CloudEvents source identifier.
+     *
+     * @generated from field: string event_source = 2;
+     */
+    eventSource: string;
+    /**
+     * CloudEvents subject identifier.
+     *
+     * @generated from field: string event_subject = 3;
+     */
+    eventSubject: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.EventEmittedPayload.
+ * Use `create(EventEmittedPayloadSchema)` to create a new message.
+ */
+export declare const EventEmittedPayloadSchema: GenMessage<EventEmittedPayload>;
+/**
+ * Payload for artifact_created events.
+ *
+ * @internal
+ * Emitted when a task output is persisted as an artifact, either because
+ * it exceeded the auto-promotion size threshold (256KB) or because the
+ * workflow author explicitly declared artifact persistence (Phase 1).
+ *
+ * The artifact_id can be used with the Artifact.get() and
+ * Artifact.getDownloadUrl() RPCs to retrieve or download the content.
+ *
+ * @since T07 (Artifact Store)
+ *
+ * @generated from message ai.stigmer.agentic.workflowexecution.v1.ArtifactCreatedPayload
+ */
+export type ArtifactCreatedPayload = Message<"ai.stigmer.agentic.workflowexecution.v1.ArtifactCreatedPayload"> & {
+    /**
+     * ID of the created artifact (format: "art_{unique-suffix}").
+     * Use this to fetch metadata via Artifact.get() or download
+     * content via Artifact.getDownloadUrl().
+     *
+     * @generated from field: string artifact_id = 1;
+     */
+    artifactId: string;
+    /**
+     * Human-readable name of the artifact.
+     *
+     * @generated from field: string display_name = 2;
+     */
+    displayName: string;
+    /**
+     * MIME content type of the artifact payload.
+     *
+     * @generated from field: string content_type = 3;
+     */
+    contentType: string;
+    /**
+     * Size of the artifact content in bytes.
+     *
+     * @generated from field: int64 size_bytes = 4;
+     */
+    sizeBytes: bigint;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflowexecution.v1.ArtifactCreatedPayload.
+ * Use `create(ArtifactCreatedPayloadSchema)` to create a new message.
+ */
+export declare const ArtifactCreatedPayloadSchema: GenMessage<ArtifactCreatedPayload>;
+/**
+ * WorkflowEventType categorizes execution events for filtering and dispatch.
+ *
+ * @internal
+ * Values are grouped by concern with numeric gaps for future additions:
+ * - 1–9: Execution lifecycle
+ * - 11–19: Task lifecycle
+ * - 21–29: Agent call
+ * - 31–39: Human input / approval
+ * - 41–49: Budget
+ * - 51–59: Signals and emitted events
+ *
+ * @since T06 (Execution Event Stream Model)
+ *
+ * @generated from enum ai.stigmer.agentic.workflowexecution.v1.WorkflowEventType
+ */
+export declare enum WorkflowEventType {
+    /**
+     * @generated from enum value: workflow_event_type_unspecified = 0;
+     */
+    workflow_event_type_unspecified = 0,
+    /**
+     * Workflow execution began processing.
+     * Emitted when phase transitions from PENDING to IN_PROGRESS.
+     * Payload: ExecutionStartedPayload.
+     *
+     * @generated from enum value: execution_started = 1;
+     */
+    execution_started = 1,
+    /**
+     * Workflow execution completed successfully.
+     * Terminal event — no more events will follow for this execution.
+     * Payload: ExecutionCompletedPayload.
+     *
+     * @generated from enum value: execution_completed = 2;
+     */
+    execution_completed = 2,
+    /**
+     * Workflow execution failed.
+     * Terminal event — no more events will follow for this execution.
+     * Payload: ExecutionFailedPayload.
+     *
+     * @generated from enum value: execution_failed = 3;
+     */
+    execution_failed = 3,
+    /**
+     * Workflow execution was paused by user or system.
+     * Non-terminal — execution can be resumed.
+     * Payload: ExecutionPausedPayload.
+     *
+     * @generated from enum value: execution_paused = 4;
+     */
+    execution_paused = 4,
+    /**
+     * Workflow execution was resumed after a pause.
+     * Payload: ExecutionResumedPayload.
+     *
+     * @generated from enum value: execution_resumed = 5;
+     */
+    execution_resumed = 5,
+    /**
+     * Workflow execution was cancelled by user.
+     * Terminal event.
+     * Payload: ExecutionCancelledPayload.
+     *
+     * @generated from enum value: execution_cancelled = 6;
+     */
+    execution_cancelled = 6,
+    /**
+     * Workflow execution was force-terminated.
+     * Terminal event.
+     * Payload: ExecutionTerminatedPayload.
+     *
+     * @generated from enum value: execution_terminated = 7;
+     */
+    execution_terminated = 7,
+    /**
+     * A workflow task began execution.
+     * Payload: TaskStartedPayload.
+     *
+     * @generated from enum value: task_started = 11;
+     */
+    task_started = 11,
+    /**
+     * A workflow task completed successfully.
+     * Payload: TaskCompletedPayload.
+     *
+     * @generated from enum value: task_completed = 12;
+     */
+    task_completed = 12,
+    /**
+     * A workflow task failed.
+     * Payload: TaskFailedPayload.
+     *
+     * @generated from enum value: task_failed = 13;
+     */
+    task_failed = 13,
+    /**
+     * A workflow task was skipped due to conditional logic.
+     * Payload: TaskSkippedPayload.
+     *
+     * @generated from enum value: task_skipped = 14;
+     */
+    task_skipped = 14,
+    /**
+     * A workflow task is being retried after a failure.
+     * Payload: TaskRetryingPayload.
+     *
+     * @generated from enum value: task_retrying = 15;
+     */
+    task_retrying = 15,
+    /**
+     * A child AgentExecution was created for an agent_call task.
+     * Payload: AgentCallStartedPayload.
+     *
+     * @generated from enum value: agent_call_started = 21;
+     */
+    agent_call_started = 21,
+    /**
+     * Periodic progress summary for a running agent_call task.
+     * Payload: AgentCallProgressPayload.
+     *
+     * @generated from enum value: agent_call_progress = 22;
+     */
+    agent_call_progress = 22,
+    /**
+     * The child AgentExecution for an agent_call task finished.
+     * Payload: AgentCallCompletedPayload.
+     *
+     * @generated from enum value: agent_call_completed = 23;
+     */
+    agent_call_completed = 23,
+    /**
+     * An approval gate was activated (human_input task or agent tool approval).
+     * Payload: ApprovalRequestedPayload.
+     *
+     * @generated from enum value: approval_requested = 31;
+     */
+    approval_requested = 31,
+    /**
+     * An approval decision was made.
+     * Payload: ApprovalResolvedPayload.
+     *
+     * @generated from enum value: approval_resolved = 32;
+     */
+    approval_resolved = 32,
+    /**
+     * Periodic snapshot of budget consumption vs. remaining capacity.
+     * Payload: BudgetCheckpointPayload.
+     *
+     * @generated from enum value: budget_checkpoint = 41;
+     */
+    budget_checkpoint = 41,
+    /**
+     * An external signal was received by a listen task.
+     * Payload: SignalReceivedPayload.
+     *
+     * @generated from enum value: signal_received = 51;
+     */
+    signal_received = 51,
+    /**
+     * The workflow published a CloudEvent via an emit_event task.
+     * Payload: EventEmittedPayload.
+     *
+     * @generated from enum value: event_emitted = 52;
+     */
+    event_emitted = 52,
+    /**
+     * A task output was persisted as an artifact (auto-promoted or explicit).
+     * Payload: ArtifactCreatedPayload.
+     *
+     * @generated from enum value: artifact_created = 53;
+     */
+    artifact_created = 53
+}
+/**
+ * Describes the enum ai.stigmer.agentic.workflowexecution.v1.WorkflowEventType.
+ */
+export declare const WorkflowEventTypeSchema: GenEnum<WorkflowEventType>;