@stigmer/protos 0.0.34

package/ai/stigmer/agentic/agentexecution/v1/enum_pb.d.ts

@@ -0,0 +1,526 @@
+import type { GenEnum, GenFile } from "@bufbuild/protobuf/codegenv1";
+/**
+ * Describes the file ai/stigmer/agentic/agentexecution/v1/enum.proto.
+ */
+export declare const file_ai_stigmer_agentic_agentexecution_v1_enum: GenFile;
+/**
+ * ExecutionPhase defines the lifecycle phase of an agent execution.
+ *
+ * Phase Transitions:
+ *
+ * Normal flow:
+ * EXECUTION_PENDING → EXECUTION_IN_PROGRESS → EXECUTION_COMPLETED
+ *
+ * Failure flow:
+ * EXECUTION_PENDING → EXECUTION_IN_PROGRESS → EXECUTION_FAILED
+ *
+ * Termination flow (platform-initiated stop):
+ * EXECUTION_IN_PROGRESS → EXECUTION_TERMINATED
+ *
+ * Approval flow (HITL):
+ * EXECUTION_IN_PROGRESS → EXECUTION_WAITING_FOR_APPROVAL → EXECUTION_IN_PROGRESS
+ *
+ * Pause/Resume flow:
+ * EXECUTION_IN_PROGRESS → EXECUTION_PAUSED → EXECUTION_IN_PROGRESS
+ *
+ * Terminal States:
+ * - EXECUTION_COMPLETED: Agent finished successfully
+ * - EXECUTION_FAILED: Agent encountered an unexpected error
+ * - EXECUTION_TERMINATED: Platform stopped the agent (stall, budget, or force-kill)
+ * - EXECUTION_CANCELLED: User gracefully stopped the agent
+ *
+ * Non-Terminal States:
+ * - EXECUTION_WAITING_FOR_APPROVAL: Awaiting user approval for tool
+ * - EXECUTION_PAUSED: Temporarily paused, can be resumed
+ *
+ * @generated from enum ai.stigmer.agentic.agentexecution.v1.ExecutionPhase
+ */
+export declare enum ExecutionPhase {
+    /**
+     * @generated from enum value: EXECUTION_PHASE_UNSPECIFIED = 0;
+     */
+    EXECUTION_PHASE_UNSPECIFIED = 0,
+    /**
+     * Waiting to start
+     *
+     * @generated from enum value: EXECUTION_PENDING = 1;
+     */
+    EXECUTION_PENDING = 1,
+    /**
+     * Currently executing
+     *
+     * @generated from enum value: EXECUTION_IN_PROGRESS = 2;
+     */
+    EXECUTION_IN_PROGRESS = 2,
+    /**
+     * Successfully completed
+     *
+     * @generated from enum value: EXECUTION_COMPLETED = 3;
+     */
+    EXECUTION_COMPLETED = 3,
+    /**
+     * Failed with error
+     *
+     * @generated from enum value: EXECUTION_FAILED = 4;
+     */
+    EXECUTION_FAILED = 4,
+    /**
+     * Cancelled by user
+     *
+     * @generated from enum value: EXECUTION_CANCELLED = 5;
+     */
+    EXECUTION_CANCELLED = 5,
+    /**
+     * Execution was stopped by the platform.
+     *
+     * Unlike CANCELLED (user-initiated graceful stop) and FAILED (unexpected
+     * error), TERMINATED means the platform intentionally stopped this
+     * execution — either via automated safety mechanisms or user-initiated
+     * force-kill.
+     *
+     * Terminal state — execution will not change phases again.
+     *
+     * When this phase is reached:
+     * - completed_at timestamp is set
+     * - error field contains the termination reason
+     *
+     * Trigger paths:
+     * - Internal (activity-level): stall timeout (agent unresponsive),
+     *   tool-call budget exhausted (GraphRecursionError). LangGraph
+     *   checkpoint is valid; the user can continue via follow-up message.
+     * - External (Terminate RPC): user or system force-kills the Temporal
+     *   workflow. LangGraph checkpoint may be incomplete.
+     *
+     * Use Cases:
+     * - Agent stalled — no events for the configured timeout
+     * - Agent exhausted its tool-call budget (recursion limit)
+     * - Force-stop stuck agents that don't respond to cancellation
+     * - Kill agents consuming excessive resources
+     *
+     * Terminated vs Cancelled vs Failed:
+     * - Terminated: Platform stopped it (automated or force-kill)
+     * - Cancelled: User gracefully stopped it (checkpoint saved)
+     * - Failed: Something broke unexpectedly (exception, crash)
+     *
+     * @since Agent Execution Lifecycle
+     *
+     * @generated from enum value: EXECUTION_TERMINATED = 8;
+     */
+    EXECUTION_TERMINATED = 8,
+    /**
+     * Blocked on tool approval (HITL Phase 1).
+     *
+     * The agent has encountered a tool that requires user approval before execution.
+     * When in this phase:
+     * - status.pending_approval contains details about the tool awaiting approval
+     * - User must call SubmitApproval RPC to continue
+     *
+     * This is NOT a terminal state - execution resumes after approval decision:
+     * - APPROVE: Tool executes, phase returns to EXECUTION_IN_PROGRESS
+     * - SKIP: Tool returns skip message, phase returns to EXECUTION_IN_PROGRESS
+     * - REJECT: Execution fails, phase transitions to EXECUTION_FAILED
+     *
+     * UI should show distinct treatment for this phase (e.g., approval dialog).
+     *
+     * @generated from enum value: EXECUTION_WAITING_FOR_APPROVAL = 6;
+     */
+    EXECUTION_WAITING_FOR_APPROVAL = 6,
+    /**
+     * Execution was paused by user and can be resumed.
+     *
+     * The execution was temporarily stopped at a checkpoint and can continue
+     * from where it left off. Unlike CANCELLED, the execution is not terminal.
+     *
+     * Pause flow:
+     * EXECUTION_IN_PROGRESS → EXECUTION_PAUSED
+     *
+     * Resume flow:
+     * EXECUTION_PAUSED → EXECUTION_IN_PROGRESS
+     *
+     * NOT a terminal state - execution can be resumed.
+     *
+     * When this phase is reached:
+     * - Running activities are gracefully cancelled
+     * - LangGraph checkpoints are saved (thread_id preserved)
+     * - No completed_at timestamp (execution is not finished)
+     *
+     * Resume behavior:
+     * - Activity is re-invoked with same thread_id
+     * - LangGraph loads from checkpoint automatically
+     * - Execution continues from where it was paused
+     *
+     * @since Gap A3 (Pause/Resume Propagation)
+     *
+     * @generated from enum value: EXECUTION_PAUSED = 7;
+     */
+    EXECUTION_PAUSED = 7
+}
+/**
+ * Describes the enum ai.stigmer.agentic.agentexecution.v1.ExecutionPhase.
+ */
+export declare const ExecutionPhaseSchema: GenEnum<ExecutionPhase>;
+/**
+ * MessageType defines the type of message in the conversation.
+ *
+ * @generated from enum ai.stigmer.agentic.agentexecution.v1.MessageType
+ */
+export declare enum MessageType {
+    /**
+     * @generated from enum value: MESSAGE_TYPE_UNSPECIFIED = 0;
+     */
+    MESSAGE_TYPE_UNSPECIFIED = 0,
+    /**
+     * User message
+     *
+     * @generated from enum value: MESSAGE_HUMAN = 1;
+     */
+    MESSAGE_HUMAN = 1,
+    /**
+     * AI assistant message
+     *
+     * @generated from enum value: MESSAGE_AI = 2;
+     */
+    MESSAGE_AI = 2,
+    /**
+     * Tool call result
+     *
+     * @generated from enum value: MESSAGE_TOOL = 3;
+     */
+    MESSAGE_TOOL = 3,
+    /**
+     * System message
+     *
+     * @generated from enum value: MESSAGE_SYSTEM = 4;
+     */
+    MESSAGE_SYSTEM = 4
+}
+/**
+ * Describes the enum ai.stigmer.agentic.agentexecution.v1.MessageType.
+ */
+export declare const MessageTypeSchema: GenEnum<MessageType>;
+/**
+ * ToolCallStatus defines the status of a tool call.
+ *
+ * Status Transitions:
+ *
+ * Normal flow (no approval required):
+ * TOOL_CALL_PENDING → TOOL_CALL_RUNNING → TOOL_CALL_COMPLETED
+ *
+ * Failure flow:
+ * TOOL_CALL_PENDING → TOOL_CALL_RUNNING → TOOL_CALL_FAILED
+ *
+ * Approval flow (HITL):
+ * TOOL_CALL_PENDING → TOOL_CALL_WAITING_APPROVAL → TOOL_CALL_RUNNING → TOOL_CALL_COMPLETED
+ *                                                ↘ TOOL_CALL_SKIPPED (if user skips)
+ *
+ * Terminal States:
+ * - TOOL_CALL_COMPLETED: Tool executed successfully
+ * - TOOL_CALL_FAILED: Tool execution failed
+ * - TOOL_CALL_SKIPPED: User chose to skip this tool (HITL)
+ *
+ * @generated from enum ai.stigmer.agentic.agentexecution.v1.ToolCallStatus
+ */
+export declare enum ToolCallStatus {
+    /**
+     * @generated from enum value: TOOL_CALL_STATUS_UNSPECIFIED = 0;
+     */
+    TOOL_CALL_STATUS_UNSPECIFIED = 0,
+    /**
+     * Waiting to execute
+     *
+     * @generated from enum value: TOOL_CALL_PENDING = 1;
+     */
+    TOOL_CALL_PENDING = 1,
+    /**
+     * Currently executing
+     *
+     * @generated from enum value: TOOL_CALL_RUNNING = 2;
+     */
+    TOOL_CALL_RUNNING = 2,
+    /**
+     * Successfully completed
+     *
+     * @generated from enum value: TOOL_CALL_COMPLETED = 3;
+     */
+    TOOL_CALL_COMPLETED = 3,
+    /**
+     * Failed with error
+     *
+     * @generated from enum value: TOOL_CALL_FAILED = 4;
+     */
+    TOOL_CALL_FAILED = 4,
+    /**
+     * Blocked on user approval (HITL Phase 1).
+     *
+     * The tool requires user consent before execution. This status is set when:
+     * - Tool has requires_approval=true (from approval policy chain)
+     * - AgentExecutionSpec.auto_approve_all is false
+     *
+     * While in this status:
+     * - ToolCall.approval_message contains the approval prompt
+     * - ToolCall.approval_requested_at is set
+     * - ExecutionPhase is EXECUTION_WAITING_FOR_APPROVAL
+     *
+     * Transitions:
+     * - APPROVE → TOOL_CALL_RUNNING → TOOL_CALL_COMPLETED/FAILED
+     * - SKIP → TOOL_CALL_SKIPPED
+     * - REJECT → Execution fails (tool remains in WAITING_APPROVAL)
+     *
+     * @generated from enum value: TOOL_CALL_WAITING_APPROVAL = 5;
+     */
+    TOOL_CALL_WAITING_APPROVAL = 5,
+    /**
+     * User skipped this tool (HITL Phase 1).
+     *
+     * Terminal state indicating the user chose not to execute this tool.
+     * When a tool is skipped:
+     * - The LLM receives a message: "Tool '{name}' was skipped by user"
+     * - Execution continues without this tool's result
+     * - The LLM can adapt its plan accordingly
+     *
+     * This is a terminal state - the tool will not be retried.
+     * Unlike FAILED, SKIPPED is an intentional user decision, not an error.
+     *
+     * @generated from enum value: TOOL_CALL_SKIPPED = 6;
+     */
+    TOOL_CALL_SKIPPED = 6
+}
+/**
+ * Describes the enum ai.stigmer.agentic.agentexecution.v1.ToolCallStatus.
+ */
+export declare const ToolCallStatusSchema: GenEnum<ToolCallStatus>;
+/**
+ * TodoStatus defines the status of a todo item.
+ *
+ * @generated from enum ai.stigmer.agentic.agentexecution.v1.TodoStatus
+ */
+export declare enum TodoStatus {
+    /**
+     * @generated from enum value: TODO_STATUS_UNSPECIFIED = 0;
+     */
+    TODO_STATUS_UNSPECIFIED = 0,
+    /**
+     * Not started
+     *
+     * @generated from enum value: TODO_PENDING = 1;
+     */
+    TODO_PENDING = 1,
+    /**
+     * Currently being worked on
+     *
+     * @generated from enum value: TODO_IN_PROGRESS = 2;
+     */
+    TODO_IN_PROGRESS = 2,
+    /**
+     * Successfully completed
+     *
+     * @generated from enum value: TODO_COMPLETED = 3;
+     */
+    TODO_COMPLETED = 3,
+    /**
+     * Cancelled/no longer needed
+     *
+     * @generated from enum value: TODO_CANCELLED = 4;
+     */
+    TODO_CANCELLED = 4
+}
+/**
+ * Describes the enum ai.stigmer.agentic.agentexecution.v1.TodoStatus.
+ */
+export declare const TodoStatusSchema: GenEnum<TodoStatus>;
+/**
+ * SubAgentStatus defines the status of a sub-agent execution.
+ *
+ * Status Transitions:
+ *
+ * Normal flow:
+ * SUB_AGENT_PENDING → SUB_AGENT_IN_PROGRESS → SUB_AGENT_COMPLETED
+ *
+ * Failure flow:
+ * SUB_AGENT_IN_PROGRESS → SUB_AGENT_FAILED
+ *
+ * Cancellation flow (parent cancelled while sub-agent active):
+ * SUB_AGENT_IN_PROGRESS → SUB_AGENT_CANCELLED
+ *
+ * Terminal States:
+ * - SUB_AGENT_COMPLETED: Sub-agent finished successfully
+ * - SUB_AGENT_FAILED: Sub-agent encountered an error
+ * - SUB_AGENT_CANCELLED: Parent execution was cancelled while sub-agent was active
+ *
+ * @generated from enum ai.stigmer.agentic.agentexecution.v1.SubAgentStatus
+ */
+export declare enum SubAgentStatus {
+    /**
+     * @generated from enum value: SUB_AGENT_STATUS_UNSPECIFIED = 0;
+     */
+    SUB_AGENT_STATUS_UNSPECIFIED = 0,
+    /**
+     * Waiting to start
+     *
+     * @generated from enum value: SUB_AGENT_PENDING = 1;
+     */
+    SUB_AGENT_PENDING = 1,
+    /**
+     * Currently executing
+     *
+     * @generated from enum value: SUB_AGENT_IN_PROGRESS = 2;
+     */
+    SUB_AGENT_IN_PROGRESS = 2,
+    /**
+     * Successfully completed
+     *
+     * @generated from enum value: SUB_AGENT_COMPLETED = 3;
+     */
+    SUB_AGENT_COMPLETED = 3,
+    /**
+     * Failed with error
+     *
+     * @generated from enum value: SUB_AGENT_FAILED = 4;
+     */
+    SUB_AGENT_FAILED = 4,
+    /**
+     * Parent execution was cancelled while this sub-agent was active.
+     *
+     * When a parent execution is cancelled (via user action or system timeout),
+     * all active sub-agents transition to this terminal state. This prevents
+     * sub-agents from remaining in IN_PROGRESS indefinitely in persisted status.
+     *
+     * When this status is reached:
+     * - completed_at timestamp is set
+     * - error field contains: "Cancelled: parent execution was cancelled"
+     *
+     * @since Sub-Agent Execution Streamline
+     *
+     * @generated from enum value: SUB_AGENT_CANCELLED = 5;
+     */
+    SUB_AGENT_CANCELLED = 5
+}
+/**
+ * Describes the enum ai.stigmer.agentic.agentexecution.v1.SubAgentStatus.
+ */
+export declare const SubAgentStatusSchema: GenEnum<SubAgentStatus>;
+/**
+ * ExecutionArtifactKind defines the type of artifact published by an agent.
+ *
+ * When an agent publishes a file, it's stored as-is.
+ * When an agent publishes a directory, it's archived as a ZIP file.
+ *
+ * @generated from enum ai.stigmer.agentic.agentexecution.v1.ExecutionArtifactKind
+ */
+export declare enum ExecutionArtifactKind {
+    /**
+     * @generated from enum value: EXECUTION_ARTIFACT_KIND_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * Single file
+     *
+     * @generated from enum value: EXECUTION_ARTIFACT_KIND_FILE = 1;
+     */
+    FILE = 1,
+    /**
+     * Directory (stored as ZIP)
+     *
+     * @generated from enum value: EXECUTION_ARTIFACT_KIND_DIRECTORY = 2;
+     */
+    DIRECTORY = 2
+}
+/**
+ * Describes the enum ai.stigmer.agentic.agentexecution.v1.ExecutionArtifactKind.
+ */
+export declare const ExecutionArtifactKindSchema: GenEnum<ExecutionArtifactKind>;
+/**
+ * SummarizationSource identifies what triggered a context summarization event.
+ *
+ * Context summarization can be triggered at two points during execution:
+ * - At graph start, when resuming a conversation that already exceeds the threshold
+ * - Mid-execution, when accumulated tool responses push context past the threshold
+ *
+ * This distinction enables the CLI to render appropriate notifications and
+ * allows monitoring to track compaction frequency by trigger type.
+ *
+ * @generated from enum ai.stigmer.agentic.agentexecution.v1.SummarizationSource
+ */
+export declare enum SummarizationSource {
+    /**
+     * @generated from enum value: SUMMARIZATION_SOURCE_UNSPECIFIED = 0;
+     */
+    SUMMARIZATION_SOURCE_UNSPECIFIED = 0,
+    /**
+     * Triggered at the start of a graph invocation (abefore_agent)
+     *
+     * @generated from enum value: graph_start = 1;
+     */
+    graph_start = 1,
+    /**
+     * Triggered mid-execution before a model call (awrap_model_call)
+     *
+     * @generated from enum value: mid_execution = 2;
+     */
+    mid_execution = 2
+}
+/**
+ * Describes the enum ai.stigmer.agentic.agentexecution.v1.SummarizationSource.
+ */
+export declare const SummarizationSourceSchema: GenEnum<SummarizationSource>;
+/**
+ * ApprovalAction represents the user's decision on an approval request.
+ *
+ * ## Action Semantics
+ *
+ * - APPROVE: Execute the tool normally, continue execution
+ * - SKIP: Return "skipped by user" message to LLM, continue execution
+ * - REJECT: Fail the execution immediately with rejection error
+ *
+ * ## LLM Behavior on Skip
+ *
+ * When a tool is skipped, the LLM receives a message like:
+ * "Tool 'delete_repository' was skipped by user. Please proceed without this operation."
+ * This allows the LLM to adapt its plan while preserving execution continuity.
+ *
+ * ## Usage
+ *
+ * Used in:
+ * - ToolCall.approval_action: Records the decision made
+ * - SubmitApprovalInput.action: User's submitted decision
+ *
+ * @generated from enum ai.stigmer.agentic.agentexecution.v1.ApprovalAction
+ */
+export declare enum ApprovalAction {
+    /**
+     * Unspecified action (invalid, should never be used).
+     * SubmitApproval RPC rejects this value.
+     *
+     * @generated from enum value: APPROVAL_ACTION_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * Execute the tool normally.
+     * Tool transitions from WAITING_APPROVAL to RUNNING, then executes.
+     * Execution phase returns to IN_PROGRESS.
+     *
+     * @generated from enum value: APPROVAL_ACTION_APPROVE = 1;
+     */
+    APPROVE = 1,
+    /**
+     * Skip tool execution, continue without it.
+     * Tool transitions to SKIPPED status.
+     * LLM receives: "Tool '{name}' was skipped by user. Please proceed without this operation."
+     * Execution continues - this is NOT a failure.
+     *
+     * @generated from enum value: APPROVAL_ACTION_SKIP = 2;
+     */
+    SKIP = 2,
+    /**
+     * Reject tool execution, fail the entire execution.
+     * Execution phase transitions to FAILED.
+     * Error message includes rejection reason from user's comment.
+     *
+     * @generated from enum value: APPROVAL_ACTION_REJECT = 3;
+     */
+    REJECT = 3
+}
+/**
+ * Describes the enum ai.stigmer.agentic.agentexecution.v1.ApprovalAction.
+ */
+export declare const ApprovalActionSchema: GenEnum<ApprovalAction>;