@stigmer/protos 0.0.69 → 0.0.71

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

@@ -9,7 +9,9 @@ export declare const AgentExecutionCommandController: {
     readonly methods: {
         /**
          * Create and trigger a new agent execution.
-         * Session is optional - can be provided or auto-created from agent_id.
+         * Session is optional — can be provided or auto-created from agent_id.
+         *
+         * @internal
          * Authorization is handled in handler:
          *   - If session_id provided: checks can_create_execution_in on session
          *   - If session_id NOT provided: checks can_create_execution_in on organization
@@ -23,7 +25,9 @@ export declare const AgentExecutionCommandController: {
             readonly kind: any;
         };
         /**
-         * Update an execution with full state.
+         * Update an agent execution.
+         *
+         * @internal
          * Used by users to update execution configuration (spec fields).
          * No individual field updates - always provide complete state.
          *
@@ -36,9 +40,12 @@ export declare const AgentExecutionCommandController: {
             readonly kind: any;
         };
         /**
-         * Update execution status during agent execution.
-         * Used by agent-runner to send progressive status updates (messages, tool_calls, phase, etc.)
-         * This RPC is optimized for frequent status updates and merges status fields with existing state.
+         * Update an agent execution's status.
+         *
+         * @internal
+         * System-level RPC used by agent-runner to send progressive status updates
+         * (messages, tool_calls, phase, etc.). Optimized for frequent status updates
+         * and merges status fields with existing state.
          *
          * @generated from rpc ai.stigmer.agentic.agentexecution.v1.AgentExecutionCommandController.updateStatus
          */
@@ -49,7 +56,7 @@ export declare const AgentExecutionCommandController: {
             readonly kind: any;
         };
         /**
-         * Delete an execution.
+         * Delete an agent execution by ID.
          *
          * @generated from rpc ai.stigmer.agentic.agentexecution.v1.AgentExecutionCommandController.delete
          */
@@ -60,7 +67,7 @@ export declare const AgentExecutionCommandController: {
             readonly kind: any;
         };
         /**
-         * Submit approval decision for a pending tool call (HITL Phase 1).
+         * Submit an approval decision for a pending tool call.
          *
          * ## Preconditions
          *
@@ -74,6 +81,8 @@ export declare const AgentExecutionCommandController: {
          * - SKIP: Tool returns skip message to LLM, execution continues to IN_PROGRESS
          * - REJECT: Execution fails with rejection error, phase becomes FAILED
          *
+         * @internal
+         *
          * ## State Transitions
          *
          * On success:
@@ -106,10 +115,11 @@ export declare const AgentExecutionCommandController: {
         /**
          * Cancel a running agent execution gracefully.
          *
-         * Sends a cancellation signal to the agent execution via Temporal's CancelWorkflow API.
-         * The agent can handle the cancellation signal to save checkpoint and clean up
-         * before transitioning to the CANCELLED phase.
+         * Sends a cancellation signal to the agent execution. The agent can handle
+         * the cancellation signal to save checkpoint and clean up before
+         * transitioning to the CANCELLED phase.
          *
+         * @internal
          * Temporal Equivalent: `temporal workflow cancel --workflow-id <id>`
          *
          * ## Behavior
@@ -156,10 +166,11 @@ export declare const AgentExecutionCommandController: {
         /**
          * Terminate an agent execution immediately.
          *
-         * Force-stops the agent execution via Temporal's TerminateWorkflow API without
-         * allowing cleanup. Unlike cancel, the agent cannot respond to termination -
-         * it is stopped immediately. Use this for stuck or unresponsive agents.
+         * Force-stops the agent execution without allowing cleanup. Unlike cancel,
+         * the agent cannot respond to termination - it is stopped immediately.
+         * Use this for stuck or unresponsive agents.
          *
+         * @internal
          * Temporal Equivalent: `temporal workflow terminate --workflow-id <id>`
          *
          * ## Behavior
@@ -214,11 +225,12 @@ export declare const AgentExecutionCommandController: {
         /**
          * Recover a failed agent execution from the last checkpoint.
          *
-         * Resumes execution from the last LangGraph checkpoint using Temporal's
-         * ResetWorkflow API. Completed work is preserved - successful tool calls
-         * are NOT re-executed.
+         * Resumes execution from the last checkpoint. Completed work is preserved -
+         * successful tool calls are NOT re-executed.
          *
+         * @internal
          * Temporal Equivalent: `temporal workflow reset --workflow-id <id> --type LastWorkflowTask`
+         * Uses LangGraph checkpoint for state restoration.
          *
          * ## Behavior
          *
@@ -270,6 +282,8 @@ export declare const AgentExecutionCommandController: {
          * Temporarily stops the agent at its current checkpoint. Unlike cancel,
          * the execution is NOT terminal and can be resumed later from where it left off.
          *
+         * @internal
+         *
          * ## Behavior
          *
          * 1. Validates execution exists and is in a pausable phase
@@ -327,6 +341,8 @@ export declare const AgentExecutionCommandController: {
          * re-invokes with the same thread_id, loading from LangGraph checkpoint
          * and continuing from where it left off.
          *
+         * @internal
+         *
          * ## Behavior
          *
          * 1. Validates execution is in EXECUTION_PAUSED phase
@@ -375,6 +391,8 @@ export declare const AgentExecutionCommandController: {
          * The returned storage_key can be used in Attachment.storage_key when
          * creating the execution.
          *
+         * @internal
+         *
          * ## Authorization
          *
          * This endpoint does not require authorization. The storage_key returned

package/ai/stigmer/agentic/agentexecution/v1/command_connect.js

@@ -14,7 +14,9 @@ export const AgentExecutionCommandController = {
     methods: {
         /**
          * Create and trigger a new agent execution.
-         * Session is optional - can be provided or auto-created from agent_id.
+         * Session is optional — can be provided or auto-created from agent_id.
+         *
+         * @internal
          * Authorization is handled in handler:
          *   - If session_id provided: checks can_create_execution_in on session
          *   - If session_id NOT provided: checks can_create_execution_in on organization
@@ -28,7 +30,9 @@ export const AgentExecutionCommandController = {
             kind: MethodKind.Unary,
         },
         /**
-         * Update an execution with full state.
+         * Update an agent execution.
+         *
+         * @internal
          * Used by users to update execution configuration (spec fields).
          * No individual field updates - always provide complete state.
          *
@@ -41,9 +45,12 @@ export const AgentExecutionCommandController = {
             kind: MethodKind.Unary,
         },
         /**
-         * Update execution status during agent execution.
-         * Used by agent-runner to send progressive status updates (messages, tool_calls, phase, etc.)
-         * This RPC is optimized for frequent status updates and merges status fields with existing state.
+         * Update an agent execution's status.
+         *
+         * @internal
+         * System-level RPC used by agent-runner to send progressive status updates
+         * (messages, tool_calls, phase, etc.). Optimized for frequent status updates
+         * and merges status fields with existing state.
          *
          * @generated from rpc ai.stigmer.agentic.agentexecution.v1.AgentExecutionCommandController.updateStatus
          */
@@ -54,7 +61,7 @@ export const AgentExecutionCommandController = {
             kind: MethodKind.Unary,
         },
         /**
-         * Delete an execution.
+         * Delete an agent execution by ID.
          *
          * @generated from rpc ai.stigmer.agentic.agentexecution.v1.AgentExecutionCommandController.delete
          */
@@ -65,7 +72,7 @@ export const AgentExecutionCommandController = {
             kind: MethodKind.Unary,
         },
         /**
-         * Submit approval decision for a pending tool call (HITL Phase 1).
+         * Submit an approval decision for a pending tool call.
          *
          * ## Preconditions
          *
@@ -79,6 +86,8 @@ export const AgentExecutionCommandController = {
          * - SKIP: Tool returns skip message to LLM, execution continues to IN_PROGRESS
          * - REJECT: Execution fails with rejection error, phase becomes FAILED
          *
+         * @internal
+         *
          * ## State Transitions
          *
          * On success:
@@ -111,10 +120,11 @@ export const AgentExecutionCommandController = {
         /**
          * Cancel a running agent execution gracefully.
          *
-         * Sends a cancellation signal to the agent execution via Temporal's CancelWorkflow API.
-         * The agent can handle the cancellation signal to save checkpoint and clean up
-         * before transitioning to the CANCELLED phase.
+         * Sends a cancellation signal to the agent execution. The agent can handle
+         * the cancellation signal to save checkpoint and clean up before
+         * transitioning to the CANCELLED phase.
          *
+         * @internal
          * Temporal Equivalent: `temporal workflow cancel --workflow-id <id>`
          *
          * ## Behavior
@@ -161,10 +171,11 @@ export const AgentExecutionCommandController = {
         /**
          * Terminate an agent execution immediately.
          *
-         * Force-stops the agent execution via Temporal's TerminateWorkflow API without
-         * allowing cleanup. Unlike cancel, the agent cannot respond to termination -
-         * it is stopped immediately. Use this for stuck or unresponsive agents.
+         * Force-stops the agent execution without allowing cleanup. Unlike cancel,
+         * the agent cannot respond to termination - it is stopped immediately.
+         * Use this for stuck or unresponsive agents.
          *
+         * @internal
          * Temporal Equivalent: `temporal workflow terminate --workflow-id <id>`
          *
          * ## Behavior
@@ -219,11 +230,12 @@ export const AgentExecutionCommandController = {
         /**
          * Recover a failed agent execution from the last checkpoint.
          *
-         * Resumes execution from the last LangGraph checkpoint using Temporal's
-         * ResetWorkflow API. Completed work is preserved - successful tool calls
-         * are NOT re-executed.
+         * Resumes execution from the last checkpoint. Completed work is preserved -
+         * successful tool calls are NOT re-executed.
          *
+         * @internal
          * Temporal Equivalent: `temporal workflow reset --workflow-id <id> --type LastWorkflowTask`
+         * Uses LangGraph checkpoint for state restoration.
          *
          * ## Behavior
          *
@@ -275,6 +287,8 @@ export const AgentExecutionCommandController = {
          * Temporarily stops the agent at its current checkpoint. Unlike cancel,
          * the execution is NOT terminal and can be resumed later from where it left off.
          *
+         * @internal
+         *
          * ## Behavior
          *
          * 1. Validates execution exists and is in a pausable phase
@@ -332,6 +346,8 @@ export const AgentExecutionCommandController = {
          * re-invokes with the same thread_id, loading from LangGraph checkpoint
          * and continuing from where it left off.
          *
+         * @internal
+         *
          * ## Behavior
          *
          * 1. Validates execution is in EXECUTION_PAUSED phase
@@ -380,6 +396,8 @@ export const AgentExecutionCommandController = {
          * The returned storage_key can be used in Attachment.storage_key when
          * creating the execution.
          *
+         * @internal
+         *
          * ## Authorization
          *
          * This endpoint does not require authorization. The storage_key returned

package/ai/stigmer/agentic/agentexecution/v1/command_connect.js.map

@@ -1 +1 @@
-{"version":3,"file":"command_connect.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/agentexecution/v1/command_connect.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,wIAAwI;AACxI,oBAAoB;AACpB,cAAc;AAGd,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIhD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC7C,QAAQ,EAAE,sEAAsE;IAChF,OAAO,EAAE;QACP;;;;;;;;WAQG;QACH,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,CAAC,EAAE,cAAc;YACjB,CAAC,EAAE,cAAc;YACjB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;WAMG;QACH,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,CAAC,EAAE,cAAc;YACjB,CAAC,EAAE,cAAc;YACjB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;WAMG;QACH,YAAY,EAAE;YACZ,IAAI,EAAE,cAAc;YACpB,CAAC,EAAE,+BAA+B;YAClC,CAAC,EAAE,cAAc;YACjB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;WAIG;QACH,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,CAAC,EAAE,aAAa;YAChB,CAAC,EAAE,cAAc;YACjB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAqCG;QACH,cAAc,EAAE;YACd,IAAI,EAAE,gBAAgB;YACtB,CAAC,EAAE,mBAAmB;YACtB,CAAC,EAAE,cAAc;YACjB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WA2CG;QACH,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,CAAC,EAAE,yBAAyB;YAC5B,CAAC,EAAE,cAAc;YACjB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAmDG;QACH,SAAS,EAAE;YACT,IAAI,EAAE,WAAW;YACjB,CAAC,EAAE,4BAA4B;YAC/B,CAAC,EAAE,cAAc;YACjB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WA8CG;QACH,OAAO,EAAE;YACP,IAAI,EAAE,SAAS;YACf,CAAC,EAAE,0BAA0B;YAC7B,CAAC,EAAE,cAAc;YACjB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAiDG;QACH,KAAK,EAAE;YACL,IAAI,EAAE,OAAO;YACb,CAAC,EAAE,wBAAwB;YAC3B,CAAC,EAAE,cAAc;YACjB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAyCG;QACH,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,CAAC,EAAE,yBAAyB;YAC5B,CAAC,EAAE,cAAc;YACjB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAkCG;QACH,gBAAgB,EAAE;YAChB,IAAI,EAAE,kBAAkB;YACxB,CAAC,EAAE,uBAAuB;YAC1B,CAAC,EAAE,wBAAwB;YAC3B,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;KACF;CACO,CAAC"}
+{"version":3,"file":"command_connect.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/agentexecution/v1/command_connect.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,wIAAwI;AACxI,oBAAoB;AACpB,cAAc;AAGd,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIhD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC7C,QAAQ,EAAE,sEAAsE;IAChF,OAAO,EAAE;QACP;;;;;;;;;;WAUG;QACH,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,CAAC,EAAE,cAAc;YACjB,CAAC,EAAE,cAAc;YACjB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;WAQG;QACH,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,CAAC,EAAE,cAAc;YACjB,CAAC,EAAE,cAAc;YACjB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;WASG;QACH,YAAY,EAAE;YACZ,IAAI,EAAE,cAAc;YACpB,CAAC,EAAE,+BAA+B;YAClC,CAAC,EAAE,cAAc;YACjB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;WAIG;QACH,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,CAAC,EAAE,aAAa;YAChB,CAAC,EAAE,cAAc;YACjB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAuCG;QACH,cAAc,EAAE;YACd,IAAI,EAAE,gBAAgB;YACtB,CAAC,EAAE,mBAAmB;YACtB,CAAC,EAAE,cAAc;YACjB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WA4CG;QACH,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,CAAC,EAAE,yBAAyB;YAC5B,CAAC,EAAE,cAAc;YACjB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAoDG;QACH,SAAS,EAAE;YACT,IAAI,EAAE,WAAW;YACjB,CAAC,EAAE,4BAA4B;YAC/B,CAAC,EAAE,cAAc;YACjB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WA+CG;QACH,OAAO,EAAE;YACP,IAAI,EAAE,SAAS;YACf,CAAC,EAAE,0BAA0B;YAC7B,CAAC,EAAE,cAAc;YACjB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAmDG;QACH,KAAK,EAAE;YACL,IAAI,EAAE,OAAO;YACb,CAAC,EAAE,wBAAwB;YAC3B,CAAC,EAAE,cAAc;YACjB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WA2CG;QACH,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,CAAC,EAAE,yBAAyB;YAC5B,CAAC,EAAE,cAAc;YACjB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAoCG;QACH,gBAAgB,EAAE;YAChB,IAAI,EAAE,kBAAkB;YACxB,CAAC,EAAE,uBAAuB;YAC1B,CAAC,EAAE,wBAAwB;YAC3B,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;KACF;CACO,CAAC"}

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

@@ -15,7 +15,9 @@ export declare const file_ai_stigmer_agentic_agentexecution_v1_command: GenFile;
 export declare const AgentExecutionCommandController: GenService<{
     /**
      * Create and trigger a new agent execution.
-     * Session is optional - can be provided or auto-created from agent_id.
+     * Session is optional — can be provided or auto-created from agent_id.
+     *
+     * @internal
      * Authorization is handled in handler:
      *   - If session_id provided: checks can_create_execution_in on session
      *   - If session_id NOT provided: checks can_create_execution_in on organization
@@ -28,7 +30,9 @@ export declare const AgentExecutionCommandController: GenService<{
         output: typeof AgentExecutionSchema;
     };
     /**
-     * Update an execution with full state.
+     * Update an agent execution.
+     *
+     * @internal
      * Used by users to update execution configuration (spec fields).
      * No individual field updates - always provide complete state.
      *
@@ -40,9 +44,12 @@ export declare const AgentExecutionCommandController: GenService<{
         output: typeof AgentExecutionSchema;
     };
     /**
-     * Update execution status during agent execution.
-     * Used by agent-runner to send progressive status updates (messages, tool_calls, phase, etc.)
-     * This RPC is optimized for frequent status updates and merges status fields with existing state.
+     * Update an agent execution's status.
+     *
+     * @internal
+     * System-level RPC used by agent-runner to send progressive status updates
+     * (messages, tool_calls, phase, etc.). Optimized for frequent status updates
+     * and merges status fields with existing state.
      *
      * @generated from rpc ai.stigmer.agentic.agentexecution.v1.AgentExecutionCommandController.updateStatus
      */
@@ -52,7 +59,7 @@ export declare const AgentExecutionCommandController: GenService<{
         output: typeof AgentExecutionSchema;
     };
     /**
-     * Delete an execution.
+     * Delete an agent execution by ID.
      *
      * @generated from rpc ai.stigmer.agentic.agentexecution.v1.AgentExecutionCommandController.delete
      */
@@ -62,7 +69,7 @@ export declare const AgentExecutionCommandController: GenService<{
         output: typeof AgentExecutionSchema;
     };
     /**
-     * Submit approval decision for a pending tool call (HITL Phase 1).
+     * Submit an approval decision for a pending tool call.
      *
      * ## Preconditions
      *
@@ -76,6 +83,8 @@ export declare const AgentExecutionCommandController: GenService<{
      * - SKIP: Tool returns skip message to LLM, execution continues to IN_PROGRESS
      * - REJECT: Execution fails with rejection error, phase becomes FAILED
      *
+     * @internal
+     *
      * ## State Transitions
      *
      * On success:
@@ -107,10 +116,11 @@ export declare const AgentExecutionCommandController: GenService<{
     /**
      * Cancel a running agent execution gracefully.
      *
-     * Sends a cancellation signal to the agent execution via Temporal's CancelWorkflow API.
-     * The agent can handle the cancellation signal to save checkpoint and clean up
-     * before transitioning to the CANCELLED phase.
+     * Sends a cancellation signal to the agent execution. The agent can handle
+     * the cancellation signal to save checkpoint and clean up before
+     * transitioning to the CANCELLED phase.
      *
+     * @internal
      * Temporal Equivalent: `temporal workflow cancel --workflow-id <id>`
      *
      * ## Behavior
@@ -156,10 +166,11 @@ export declare const AgentExecutionCommandController: GenService<{
     /**
      * Terminate an agent execution immediately.
      *
-     * Force-stops the agent execution via Temporal's TerminateWorkflow API without
-     * allowing cleanup. Unlike cancel, the agent cannot respond to termination -
-     * it is stopped immediately. Use this for stuck or unresponsive agents.
+     * Force-stops the agent execution without allowing cleanup. Unlike cancel,
+     * the agent cannot respond to termination - it is stopped immediately.
+     * Use this for stuck or unresponsive agents.
      *
+     * @internal
      * Temporal Equivalent: `temporal workflow terminate --workflow-id <id>`
      *
      * ## Behavior
@@ -213,11 +224,12 @@ export declare const AgentExecutionCommandController: GenService<{
     /**
      * Recover a failed agent execution from the last checkpoint.
      *
-     * Resumes execution from the last LangGraph checkpoint using Temporal's
-     * ResetWorkflow API. Completed work is preserved - successful tool calls
-     * are NOT re-executed.
+     * Resumes execution from the last checkpoint. Completed work is preserved -
+     * successful tool calls are NOT re-executed.
      *
+     * @internal
      * Temporal Equivalent: `temporal workflow reset --workflow-id <id> --type LastWorkflowTask`
+     * Uses LangGraph checkpoint for state restoration.
      *
      * ## Behavior
      *
@@ -268,6 +280,8 @@ export declare const AgentExecutionCommandController: GenService<{
      * Temporarily stops the agent at its current checkpoint. Unlike cancel,
      * the execution is NOT terminal and can be resumed later from where it left off.
      *
+     * @internal
+     *
      * ## Behavior
      *
      * 1. Validates execution exists and is in a pausable phase
@@ -324,6 +338,8 @@ export declare const AgentExecutionCommandController: GenService<{
      * re-invokes with the same thread_id, loading from LangGraph checkpoint
      * and continuing from where it left off.
      *
+     * @internal
+     *
      * ## Behavior
      *
      * 1. Validates execution is in EXECUTION_PAUSED phase
@@ -371,6 +387,8 @@ export declare const AgentExecutionCommandController: GenService<{
      * The returned storage_key can be used in Attachment.storage_key when
      * creating the execution.
      *
+     * @internal
+     *
      * ## Authorization
      *
      * This endpoint does not require authorization. The storage_key returned

package/ai/stigmer/agentic/agentexecution/v1/command_pb.js.map

@@ -1 +1 @@
-{"version":3,"file":"command_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/agentexecution/v1/command_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,wIAAwI;AACxI,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,6CAA6C,EAAE,MAAM,UAAU,CAAC;AAEzE,OAAO,EAAE,4CAA4C,EAAE,MAAM,SAAS,CAAC;AAEvE,OAAO,EAAE,sCAAsC,EAAE,MAAM,oCAAoC,CAAC;AAC5F,OAAO,EAAE,uDAAuD,EAAE,MAAM,qDAAqD,CAAC;AAC9H,OAAO,EAAE,gEAAgE,EAAE,MAAM,8DAA8D,CAAC;AAEhJ;;GAEG;AACH,MAAM,CAAC,MAAM,iDAAiD,GAAY,aAAa,CACrF,QAAQ,CAAC,8wFAA8wF,EAAE,CAAC,6CAA6C,EAAE,4CAA4C,EAAE,sCAAsC,EAAE,uDAAuD,EAAE,gEAAgE,CAAC,CAAC,CAAC;AAE7hG;;;;;GAKG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAwYvC,aAAa,CAChB,WAAW,CAAC,iDAAiD,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"command_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/agentexecution/v1/command_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,wIAAwI;AACxI,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,6CAA6C,EAAE,MAAM,UAAU,CAAC;AAEzE,OAAO,EAAE,4CAA4C,EAAE,MAAM,SAAS,CAAC;AAEvE,OAAO,EAAE,sCAAsC,EAAE,MAAM,oCAAoC,CAAC;AAC5F,OAAO,EAAE,uDAAuD,EAAE,MAAM,qDAAqD,CAAC;AAC9H,OAAO,EAAE,gEAAgE,EAAE,MAAM,8DAA8D,CAAC;AAEhJ;;GAEG;AACH,MAAM,CAAC,MAAM,iDAAiD,GAAY,aAAa,CACrF,QAAQ,CAAC,8wFAA8wF,EAAE,CAAC,6CAA6C,EAAE,4CAA4C,EAAE,sCAAsC,EAAE,uDAAuD,EAAE,gEAAgE,CAAC,CAAC,CAAC;AAE7hG;;;;;GAKG;AACH,MAAM,CAAC,MAAM,+BAA+B,GA0ZvC,aAAa,CAChB,WAAW,CAAC,iDAAiD,EAAE,CAAC,CAAC,CAAC"}

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

@@ -37,35 +37,37 @@ export declare const file_ai_stigmer_agentic_agentexecution_v1_enum: GenFile;
  */
 export declare enum ExecutionPhase {
     /**
+     * Default value, not a valid execution phase.
+     *
      * @generated from enum value: EXECUTION_PHASE_UNSPECIFIED = 0;
      */
     EXECUTION_PHASE_UNSPECIFIED = 0,
     /**
-     * Waiting to start
+     * Execution is queued and waiting for a worker to start processing.
      *
      * @generated from enum value: EXECUTION_PENDING = 1;
      */
     EXECUTION_PENDING = 1,
     /**
-     * Currently executing
+     * Execution is actively running — the agent is processing and producing output.
      *
      * @generated from enum value: EXECUTION_IN_PROGRESS = 2;
      */
     EXECUTION_IN_PROGRESS = 2,
     /**
-     * Successfully completed
+     * Execution finished successfully and the agent produced a final response.
      *
      * @generated from enum value: EXECUTION_COMPLETED = 3;
      */
     EXECUTION_COMPLETED = 3,
     /**
-     * Failed with error
+     * Execution encountered an unexpected error and could not finish.
      *
      * @generated from enum value: EXECUTION_FAILED = 4;
      */
     EXECUTION_FAILED = 4,
     /**
-     * Cancelled by user
+     * Execution was gracefully stopped by the user before it finished.
      *
      * @generated from enum value: EXECUTION_CANCELLED = 5;
      */
@@ -166,29 +168,31 @@ export declare const ExecutionPhaseSchema: GenEnum<ExecutionPhase>;
  */
 export declare enum MessageType {
     /**
+     * Default value, not a valid message type.
+     *
      * @generated from enum value: MESSAGE_TYPE_UNSPECIFIED = 0;
      */
     MESSAGE_TYPE_UNSPECIFIED = 0,
     /**
-     * User message
+     * A message sent by the user to the agent.
      *
      * @generated from enum value: MESSAGE_HUMAN = 1;
      */
     MESSAGE_HUMAN = 1,
     /**
-     * AI assistant message
+     * A response generated by the AI agent.
      *
      * @generated from enum value: MESSAGE_AI = 2;
      */
     MESSAGE_AI = 2,
     /**
-     * Tool call result
+     * The result returned by a tool after execution.
      *
      * @generated from enum value: MESSAGE_TOOL = 3;
      */
     MESSAGE_TOOL = 3,
     /**
-     * System message
+     * A system-generated message injected by the platform (e.g., budget warnings, summarization notices).
      *
      * @generated from enum value: MESSAGE_SYSTEM = 4;
      */
@@ -222,29 +226,31 @@ export declare const MessageTypeSchema: GenEnum<MessageType>;
  */
 export declare enum ToolCallStatus {
     /**
+     * Default value, not a valid tool call status.
+     *
      * @generated from enum value: TOOL_CALL_STATUS_UNSPECIFIED = 0;
      */
     TOOL_CALL_STATUS_UNSPECIFIED = 0,
     /**
-     * Waiting to execute
+     * Tool call is queued and waiting to execute.
      *
      * @generated from enum value: TOOL_CALL_PENDING = 1;
      */
     TOOL_CALL_PENDING = 1,
     /**
-     * Currently executing
+     * Tool is currently executing.
      *
      * @generated from enum value: TOOL_CALL_RUNNING = 2;
      */
     TOOL_CALL_RUNNING = 2,
     /**
-     * Successfully completed
+     * Tool executed successfully and returned a result.
      *
      * @generated from enum value: TOOL_CALL_COMPLETED = 3;
      */
     TOOL_CALL_COMPLETED = 3,
     /**
-     * Failed with error
+     * Tool execution failed with an error.
      *
      * @generated from enum value: TOOL_CALL_FAILED = 4;
      */
@@ -296,29 +302,31 @@ export declare const ToolCallStatusSchema: GenEnum<ToolCallStatus>;
  */
 export declare enum TodoStatus {
     /**
+     * Default value, not a valid todo status.
+     *
      * @generated from enum value: TODO_STATUS_UNSPECIFIED = 0;
      */
     TODO_STATUS_UNSPECIFIED = 0,
     /**
-     * Not started
+     * Task has not been started yet.
      *
      * @generated from enum value: TODO_PENDING = 1;
      */
     TODO_PENDING = 1,
     /**
-     * Currently being worked on
+     * Task is currently being worked on by the agent.
      *
      * @generated from enum value: TODO_IN_PROGRESS = 2;
      */
     TODO_IN_PROGRESS = 2,
     /**
-     * Successfully completed
+     * Task was completed successfully.
      *
      * @generated from enum value: TODO_COMPLETED = 3;
      */
     TODO_COMPLETED = 3,
     /**
-     * Cancelled/no longer needed
+     * Task was cancelled and is no longer needed.
      *
      * @generated from enum value: TODO_CANCELLED = 4;
      */
@@ -351,29 +359,31 @@ export declare const TodoStatusSchema: GenEnum<TodoStatus>;
  */
 export declare enum SubAgentStatus {
     /**
+     * Default value, not a valid sub-agent status.
+     *
      * @generated from enum value: SUB_AGENT_STATUS_UNSPECIFIED = 0;
      */
     SUB_AGENT_STATUS_UNSPECIFIED = 0,
     /**
-     * Waiting to start
+     * Sub-agent invocation is queued and waiting to start.
      *
      * @generated from enum value: SUB_AGENT_PENDING = 1;
      */
     SUB_AGENT_PENDING = 1,
     /**
-     * Currently executing
+     * Sub-agent is actively executing its delegated task.
      *
      * @generated from enum value: SUB_AGENT_IN_PROGRESS = 2;
      */
     SUB_AGENT_IN_PROGRESS = 2,
     /**
-     * Successfully completed
+     * Sub-agent finished its task successfully and returned a result.
      *
      * @generated from enum value: SUB_AGENT_COMPLETED = 3;
      */
     SUB_AGENT_COMPLETED = 3,
     /**
-     * Failed with error
+     * Sub-agent encountered an error and could not complete its task.
      *
      * @generated from enum value: SUB_AGENT_FAILED = 4;
      */
@@ -409,17 +419,19 @@ export declare const SubAgentStatusSchema: GenEnum<SubAgentStatus>;
  */
 export declare enum ExecutionArtifactKind {
     /**
+     * Default value, not a valid artifact kind.
+     *
      * @generated from enum value: EXECUTION_ARTIFACT_KIND_UNSPECIFIED = 0;
      */
     UNSPECIFIED = 0,
     /**
-     * Single file
+     * A single file published by the agent.
      *
      * @generated from enum value: EXECUTION_ARTIFACT_KIND_FILE = 1;
      */
     FILE = 1,
     /**
-     * Directory (stored as ZIP)
+     * A directory published by the agent, archived as a ZIP file for download.
      *
      * @generated from enum value: EXECUTION_ARTIFACT_KIND_DIRECTORY = 2;
      */
@@ -443,17 +455,19 @@ export declare const ExecutionArtifactKindSchema: GenEnum<ExecutionArtifactKind>
  */
 export declare enum SummarizationSource {
     /**
+     * Default value, not a valid summarization source.
+     *
      * @generated from enum value: SUMMARIZATION_SOURCE_UNSPECIFIED = 0;
      */
     SUMMARIZATION_SOURCE_UNSPECIFIED = 0,
     /**
-     * Triggered at the start of a graph invocation (abefore_agent)
+     * Summarization triggered at the start of processing, when resuming a conversation that already exceeds the token threshold.
      *
      * @generated from enum value: graph_start = 1;
      */
     graph_start = 1,
     /**
-     * Triggered mid-execution before a model call (awrap_model_call)
+     * Summarization triggered mid-execution, when accumulated tool responses push context past the token threshold.
      *
      * @generated from enum value: mid_execution = 2;
      */
@@ -492,6 +506,8 @@ export declare const SummarizationSourceSchema: GenEnum<SummarizationSource>;
  */
 export declare enum ToolCallStreamingSource {
     /**
+     * No active streaming, or streaming has completed.
+     *
      * @generated from enum value: TOOL_CALL_STREAMING_SOURCE_UNSPECIFIED = 0;
      */
     UNSPECIFIED = 0,