@stigmer/protos 0.0.68 → 0.0.70

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

@@ -12,6 +12,7 @@ export declare const file_ai_stigmer_agentic_workflowexecution_v1_api: GenFile;
 /**
  * WorkflowExecution represents a single runtime invocation of a WorkflowInstance.
  *
+ * @internal
  * WorkflowExecution is the "Execution" layer in the Template→Instance→Execution pattern.
  * It captures the complete lifecycle of a workflow run, from initial trigger through
  * task-by-task execution to final completion or failure.
@@ -32,13 +33,6 @@ export declare const file_ai_stigmer_agentic_workflowexecution_v1_api: GenFile;
  *       - Tasks: [validate_email: COMPLETED, create_account: IN_PROGRESS, send_welcome: PENDING]
  *       - Progress: 1/3 tasks completed
  *
- * Use Cases:
- * - Track workflow execution progress in real-time
- * - Debug failed workflows with full execution history
- * - Audit workflow runs for compliance and analysis
- * - Monitor workflow performance and duration
- * - Retry failed executions with same inputs
- *
  * Separation of Concerns:
  * - User Inputs (spec): workflow_instance_id, trigger_message, trigger_metadata, runtime_env
  * - System State (status): phase, tasks, output, timestamps, errors
@@ -53,6 +47,8 @@ export declare const file_ai_stigmer_agentic_workflowexecution_v1_api: GenFile;
 export type WorkflowExecution = Message<"ai.stigmer.agentic.workflowexecution.v1.WorkflowExecution"> & {
     /**
      * API version for this resource type.
+     *
+     * @internal
      * Format: 'agentic.stigmer.ai/v1'
      * Validated as const to ensure version consistency across all workflow execution resources.
      *
@@ -61,6 +57,8 @@ export type WorkflowExecution = Message<"ai.stigmer.agentic.workflowexecution.v1
     apiVersion: string;
     /**
      * Resource kind identifier.
+     *
+     * @internal
      * Must be exactly 'WorkflowExecution' to match the message name.
      * Validated as const for type safety and resource identification.
      *
@@ -68,13 +66,14 @@ export type WorkflowExecution = Message<"ai.stigmer.agentic.workflowexecution.v1
      */
     kind: string;
     /**
-     * Standard resource metadata including name, id, slug, labels, tags, and annotations.
+     * Resource metadata including name, organization, visibility, and labels.
      *
+     * @internal
      * All workflow executions belong to an organization. Visibility (public/private)
      * is typically PRIVATE for executions since they contain runtime data.
      *
      * Naming Pattern:
-     * - ID Format: "wfx-abc123xyz456" (auto-generated, unique)
+     * - ID Format: "wfx_abc123xyz456" (auto-generated, unique)
      * - Name Format: "{workflow_instance_name}-{timestamp}" (e.g., "prod-deploy-20250111-143022")
      * - Slug Format: Same as name, URL-safe
      *
@@ -88,6 +87,7 @@ export type WorkflowExecution = Message<"ai.stigmer.agentic.workflowexecution.v1
     /**
      * User-provided inputs and configuration for this workflow execution.
      *
+     * @internal
      * Contains:
      * - workflow_instance_id: Which WorkflowInstance to execute (required)
      * - trigger_message: Input message or payload for the workflow (optional)
@@ -99,7 +99,7 @@ export type WorkflowExecution = Message<"ai.stigmer.agentic.workflowexecution.v1
      *
      * Example:
      * spec {
-     *   workflow_instance_id: "wfi-customer-onboarding-prod"
+     *   workflow_instance_id: "wfi_customer-onboarding-prod"
      *   trigger_message: "New customer: customer-email@example.com"
      *   trigger_metadata: {
      *     "source": "api"
@@ -118,6 +118,7 @@ export type WorkflowExecution = Message<"ai.stigmer.agentic.workflowexecution.v1
     /**
      * System-managed execution state and results.
      *
+     * @internal
      * Contains:
      * - phase: Current lifecycle phase (PENDING → IN_PROGRESS → COMPLETED/FAILED/CANCELLED)
      * - tasks: List of workflow tasks with their execution state (source of truth for progress)
@@ -125,7 +126,7 @@ export type WorkflowExecution = Message<"ai.stigmer.agentic.workflowexecution.v1
      * - error: Error message (only for FAILED executions)
      * - started_at: Timestamp when execution started
      * - completed_at: Timestamp when execution finished (COMPLETED/FAILED/CANCELLED)
-     * - temporal_workflow_id: Correlation ID for Temporal workflow engine
+     * - temporal_workflow_id: Correlation ID for workflow engine
      *
      * The status is continuously updated by the workflow execution engine as the workflow progresses.
      * Users can read status but cannot modify it - it reflects the actual execution state.
@@ -158,6 +159,7 @@ export declare const WorkflowExecutionSchema: GenMessage<WorkflowExecution>;
 /**
  * WorkflowExecutionStatus contains all system-managed execution state and results.
  *
+ * @internal
  * Everything populated during or after execution goes here, not in spec.
  * This message follows the standard pattern: audit information at field 99, custom fields at 1-98.
  *
@@ -181,7 +183,9 @@ export declare const WorkflowExecutionSchema: GenMessage<WorkflowExecution>;
  */
 export type WorkflowExecutionStatus = Message<"ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionStatus"> & {
     /**
-     * Standard audit information (created_at, updated_at, created_by, etc.)
+     * Standard audit information including timestamps and created-by identity.
+     *
+     * @internal
      * Always at field 99 for consistency across all Stigmer API resources.
      *
      * Contains:
@@ -189,26 +193,13 @@ export type WorkflowExecutionStatus = Message<"ai.stigmer.agentic.workflowexecut
      * - updated_at: Last time status was updated (ISO 8601 timestamp)
      * - created_by: User or system that created this execution
      *
-     * Example:
-     * audit {
-     *   created_at: "2025-01-11T14:30:22Z"
-     *   updated_at: "2025-01-11T14:32:15Z"
-     *   created_by: "usr-john-doe"
-     * }
-     *
      * @generated from field: ai.stigmer.commons.apiresource.ApiResourceAudit audit = 99;
      */
     audit?: ApiResourceAudit;
     /**
      * Current execution lifecycle phase.
      *
-     * Phases:
-     * - EXECUTION_PENDING: Execution created, waiting to start
-     * - EXECUTION_IN_PROGRESS: Actively executing tasks
-     * - EXECUTION_COMPLETED: Successfully completed all tasks
-     * - EXECUTION_FAILED: Failed during execution (see error field)
-     * - EXECUTION_CANCELLED: Cancelled by user or system
-     *
+     * @internal
      * Phase Transitions:
      * PENDING → IN_PROGRESS → COMPLETED
      *        ↓              ↘ FAILED
@@ -226,8 +217,9 @@ export type WorkflowExecutionStatus = Message<"ai.stigmer.agentic.workflowexecut
      */
     phase: ExecutionPhase;
     /**
-     * Workflow tasks with their execution state (source of truth for progress).
+     * Workflow tasks with their individual execution state.
      *
+     * @internal
      * Tasks represent the atomic units of work within the workflow.
      * Each task has:
      * - task_id: Unique identifier within this execution
@@ -249,42 +241,13 @@ export type WorkflowExecutionStatus = Message<"ai.stigmer.agentic.workflowexecut
      * - Progress percentage: (completed_tasks / total_tasks) * 100
      * - Current task: tasks.find(status == IN_PROGRESS)
      *
-     * Use Cases:
-     * - Display task-level progress in UI (which tasks are done, which are running)
-     * - Calculate overall progress (no need to store total_tasks/completed_tasks)
-     * - Debug task failures (inspect task inputs, outputs, errors)
-     * - Retry individual failed tasks (if workflow supports partial retry)
-     * - Audit task execution for compliance
-     *
-     * Example:
-     * tasks: [
-     *   {
-     *     task_id: "task-1"
-     *     task_name: "validate_email"
-     *     task_type: WORKFLOW_TASK_API_CALL
-     *     status: WORKFLOW_TASK_COMPLETED
-     *     started_at: "2025-01-11T14:30:23Z"
-     *     completed_at: "2025-01-11T14:30:23.450Z"
-     *     output: { "valid": true, "domain": "example.com" }
-     *   }
-     *   {
-     *     task_id: "task-2"
-     *     task_name: "create_account"
-     *     task_type: WORKFLOW_TASK_AGENT_INVOCATION
-     *     status: WORKFLOW_TASK_IN_PROGRESS
-     *     started_at: "2025-01-11T14:30:24Z"
-     *   }
-     * ]
-     *
      * @generated from field: repeated ai.stigmer.agentic.workflowexecution.v1.WorkflowTask tasks = 2;
      */
     tasks: WorkflowTask[];
     /**
-     * Workflow output (JSON structure).
-     *
-     * Contains the final result or payload produced by the workflow.
-     * Only populated when phase == EXECUTION_COMPLETED.
+     * Final workflow output, populated only when phase is EXECUTION_COMPLETED.
      *
+     * @internal
      * The output structure is workflow-specific and defined by the Workflow template.
      * Common patterns:
      * - API response data (e.g., created user ID, order confirmation)
@@ -292,23 +255,14 @@ export type WorkflowExecutionStatus = Message<"ai.stigmer.agentic.workflowexecut
      * - Links to generated artifacts (reports, files)
      * - Summary statistics (items processed, duration)
      *
-     * Example (customer onboarding workflow):
-     * output: {
-     *   "customer_id": "cus-abc123"
-     *   "account_created": true
-     *   "welcome_email_sent": true
-     *   "trial_activated": true
-     *   "trial_expires_at": "2025-02-10T14:30:22Z"
-     * }
-     *
      * @generated from field: google.protobuf.Struct output = 3;
      */
     output?: JsonObject;
     /**
-     * Error message if execution failed.
+     * Error message, populated only when phase is EXECUTION_FAILED.
      *
+     * @internal
      * Contains a human-readable description of what went wrong.
-     * Only populated when phase == EXECUTION_FAILED.
      *
      * Error message includes:
      * - What failed (which task or workflow step)
@@ -317,60 +271,45 @@ export type WorkflowExecutionStatus = Message<"ai.stigmer.agentic.workflowexecut
      *
      * For detailed debugging, inspect tasks[].error for task-specific error messages.
      *
-     * Example:
-     * error: "Task 'create_account' failed: API rate limit exceeded (429). Retry after 60 seconds."
-     *
      * @generated from field: string error = 4;
      */
     error: string;
     /**
-     * ISO 8601 timestamp when execution started.
-     *
-     * Set when the workflow execution engine begins processing this execution.
-     * This is when phase transitions from PENDING to IN_PROGRESS.
+     * ISO 8601 timestamp when execution started processing.
      *
+     * @internal
+     * Set when phase transitions from PENDING to IN_PROGRESS.
      * Format: "YYYY-MM-DDTHH:MM:SSZ" (UTC timezone)
-     * Example: "2025-01-11T14:30:22Z"
-     *
-     * Used for:
-     * - Calculating execution duration (completed_at - started_at)
-     * - Sorting executions by start time
-     * - Detecting stuck executions (started but not completed after X hours)
      *
      * @generated from field: string started_at = 5;
      */
     startedAt: string;
     /**
-     * ISO 8601 timestamp when execution completed, failed, or was cancelled.
+     * ISO 8601 timestamp when execution reached a terminal state.
      *
+     * @internal
      * Set when the workflow reaches a terminal state:
      * - EXECUTION_COMPLETED: Successfully finished
      * - EXECUTION_FAILED: Failed during execution
      * - EXECUTION_CANCELLED: Cancelled by user or system
      *
      * Not set for PENDING or IN_PROGRESS executions.
-     *
      * Format: "YYYY-MM-DDTHH:MM:SSZ" (UTC timezone)
-     * Example: "2025-01-11T14:35:47Z"
-     *
-     * Used for:
-     * - Calculating execution duration (completed_at - started_at)
-     * - Retention policies (delete completed executions after 30 days)
-     * - SLA monitoring (alert if execution takes longer than expected)
      *
      * @generated from field: string completed_at = 6;
      */
     completedAt: string;
     /**
-     * Temporal workflow ID (if using Temporal as execution engine).
+     * Correlation ID for the underlying workflow engine.
      *
-     * This is the workflow ID in the Temporal workflow engine, used for:
+     * @internal
+     * This is the workflow ID in Temporal, used for:
      * - Correlation between Stigmer and Temporal (for debugging)
      * - Querying Temporal directly (for advanced troubleshooting)
      * - Signaling or cancelling Temporal workflows
      *
      * Format: Typically "{workflow_instance_id}-{execution_id}" or a UUID
-     * Example: "wfi-prod-deploy-wfx-abc123xyz456" or "temporal-wf-uuid-12345"
+     * Example: "wfi_prod-deploy-wfx_abc123xyz456" or "temporal-wf-uuid-12345"
      *
      * This field is optional and only relevant when Temporal is used as the execution engine.
      * Other workflow engines (Step Functions, Argo, etc.) may use different correlation IDs.
@@ -379,21 +318,20 @@ export type WorkflowExecutionStatus = Message<"ai.stigmer.agentic.workflowexecut
      */
     temporalWorkflowId: string;
     /**
-     * Pending approvals from child agent tool executions (HITL).
+     * Pending approvals from child agent tool executions.
      *
+     * @internal
      * Populated when workflow tasks invoke agents that enter
      * EXECUTION_WAITING_FOR_APPROVAL phase. This surfaces all approval
      * requests at the workflow level for UI visibility.
      *
-     * ## Full-Replace Protocol
-     *
+     * Full-Replace Protocol:
      * The workflow-runner always sends the complete set of pending approvals
      * via UpdateStatus. The server replaces the stored list unconditionally:
      * - Non-empty list: child agent(s) need approval
      * - Empty list: all approvals resolved, clear the field
      *
-     * ## Parallel Agents
-     *
+     * Parallel Agents:
      * When multiple child agents run in parallel, entries from different children
      * accumulate in this list. Each entry's child_agent_execution_id distinguishes
      * the source.
@@ -408,9 +346,9 @@ export type WorkflowExecutionStatus = Message<"ai.stigmer.agentic.workflowexecut
  */
 export declare const WorkflowExecutionStatusSchema: GenMessage<WorkflowExecutionStatus>;
 /**
- * WorkflowPendingApproval wraps a PendingApproval from a child agent execution
- * with the routing information needed for workflow-level approval forwarding.
+ * WorkflowPendingApproval pairs approval details with routing information for workflow-level forwarding.
  *
+ * @internal
  * PendingApproval is an agentexecution domain type — it describes what tool
  * needs approval. WorkflowPendingApproval adds the workflow-level concern:
  * which child agent execution the approval should be forwarded to.
@@ -419,14 +357,15 @@ export declare const WorkflowExecutionStatusSchema: GenMessage<WorkflowExecution
  */
 export type WorkflowPendingApproval = Message<"ai.stigmer.agentic.workflowexecution.v1.WorkflowPendingApproval"> & {
     /**
-     * The approval details projected from the child agent's tool call state.
+     * Approval details from the child agent's tool call.
      *
      * @generated from field: ai.stigmer.agentic.agentexecution.v1.PendingApproval approval = 1;
      */
     approval?: PendingApproval;
     /**
-     * Child agent execution to forward the approval to.
+     * ID of the child agent execution to forward the approval decision to.
      *
+     * @internal
      * Set by the workflow-runner when surfacing child agent approvals
      * at the workflow level. WorkflowExecution.SubmitApproval uses this
      * to route the decision to the correct AgentExecution.SubmitApproval RPC.
@@ -445,6 +384,7 @@ export declare const WorkflowPendingApprovalSchema: GenMessage<WorkflowPendingAp
 /**
  * WorkflowTask represents a single task within a workflow execution.
  *
+ * @internal
  * Tasks are the atomic units of work in a workflow. Each task:
  * - Has a specific type (agent invocation, API call, approval, conditional, etc.)
  * - Receives input parameters from the workflow context or previous tasks
@@ -458,26 +398,13 @@ export declare const WorkflowPendingApprovalSchema: GenMessage<WorkflowPendingAp
  * 3. Task executes its logic (invoke agent, call API, etc.)
  * 4. Task completes successfully (COMPLETED) or fails (FAILED) or is skipped (SKIPPED)
  *
- * Task Types and Examples:
- * - WORKFLOW_TASK_AGENT_INVOCATION: Invoke an AI agent with a prompt
- * - WORKFLOW_TASK_API_CALL: Call an external API (REST, GraphQL, gRPC)
- * - WORKFLOW_TASK_APPROVAL: Wait for human approval before proceeding
- * - WORKFLOW_TASK_CONDITIONAL: Evaluate a condition to decide next steps
- * - WORKFLOW_TASK_PARALLEL: Execute multiple sub-tasks in parallel
- * - WORKFLOW_TASK_TRANSFORM: Transform data between tasks (map, filter, aggregate)
- *
- * Use Cases:
- * - Display task-level progress in UI (task list with checkmarks)
- * - Debug workflow failures (which task failed, what was the input/output)
- * - Retry individual tasks (if workflow engine supports partial retry)
- * - Monitor task performance (which tasks take longest)
- *
  * @generated from message ai.stigmer.agentic.workflowexecution.v1.WorkflowTask
  */
 export type WorkflowTask = Message<"ai.stigmer.agentic.workflowexecution.v1.WorkflowTask"> & {
     /**
      * Unique task identifier within this workflow execution.
      *
+     * @internal
      * Format: Typically "task-{number}" or a descriptive slug
      * Examples: "task-1", "task-validate-email", "task-send-notification"
      *
@@ -490,15 +417,10 @@ export type WorkflowTask = Message<"ai.stigmer.agentic.workflowexecution.v1.Work
     /**
      * Human-readable task name.
      *
+     * @internal
      * Describes what this task does in plain language.
      * Used in UI to show task progress and in logs for debugging.
      *
-     * Examples:
-     * - "Validate customer email"
-     * - "Create Stripe account"
-     * - "Send welcome email"
-     * - "Wait for admin approval"
-     *
      * Naming conventions:
      * - Use verb phrases (validate, create, send, wait)
      * - Be specific about what's being operated on
@@ -510,15 +432,8 @@ export type WorkflowTask = Message<"ai.stigmer.agentic.workflowexecution.v1.Work
     /**
      * Type of task (agent invocation, API call, approval, etc.).
      *
-     * Determines how the task is executed by the workflow engine:
-     * - WORKFLOW_TASK_AGENT_INVOCATION: Calls an AI agent with a prompt, waits for response
-     * - WORKFLOW_TASK_API_CALL: Makes HTTP/gRPC API call to external service
-     * - WORKFLOW_TASK_APPROVAL: Pauses workflow, waits for human approval
-     * - WORKFLOW_TASK_CONDITIONAL: Evaluates condition, branches to different paths
-     * - WORKFLOW_TASK_PARALLEL: Executes multiple sub-tasks concurrently
-     * - WORKFLOW_TASK_TRANSFORM: Transforms data using expressions or scripts
-     * - WORKFLOW_TASK_CUSTOM: Custom task logic defined by plugins
-     *
+     * @internal
+     * Determines how the task is executed by the workflow engine.
      * The task_type influences:
      * - How task.input is structured (different types expect different input schemas)
      * - How task.output is produced (different types produce different outputs)
@@ -530,35 +445,12 @@ export type WorkflowTask = Message<"ai.stigmer.agentic.workflowexecution.v1.Work
      */
     taskType: WorkflowTaskType;
     /**
-     * Task input parameters (JSON structure).
+     * Task input parameters, structured as JSON.
      *
+     * @internal
      * Contains the configuration and data needed for this task to execute.
      * The structure varies by task_type.
      *
-     * Examples by task type:
-     *
-     * WORKFLOW_TASK_AGENT_INVOCATION:
-     * input: {
-     *   "agent_instance_id": "agi-customer-support"
-     *   "prompt": "Analyze customer feedback: {{workflow.input.feedback}}"
-     *   "max_tokens": 500
-     * }
-     *
-     * WORKFLOW_TASK_API_CALL:
-     * input: {
-     *   "method": "POST"
-     *   "url": "https://api.stripe.com/v1/customers"
-     *   "headers": { "Authorization": "Bearer {{env.STRIPE_API_KEY}}" }
-     *   "body": { "email": "{{workflow.input.email}}" }
-     * }
-     *
-     * WORKFLOW_TASK_APPROVAL:
-     * input: {
-     *   "approvers": ["usr-admin-1", "usr-admin-2"]
-     *   "message": "Approve account creation for {{workflow.input.email}}?"
-     *   "timeout_hours": 24
-     * }
-     *
      * Input can reference:
      * - Workflow inputs: {{workflow.input.field_name}}
      * - Previous task outputs: {{tasks.task-1.output.field_name}}
@@ -568,54 +460,19 @@ export type WorkflowTask = Message<"ai.stigmer.agentic.workflowexecution.v1.Work
      */
     input?: JsonObject;
     /**
-     * Task output results (JSON structure).
+     * Task output results, populated only when status is WORKFLOW_TASK_COMPLETED.
      *
+     * @internal
      * Contains the data produced by this task after successful execution.
-     * Only populated when status == WORKFLOW_TASK_COMPLETED.
-     *
      * Output can be referenced by subsequent tasks using: {{tasks.this-task-id.output.field_name}}
      *
-     * Examples by task type:
-     *
-     * WORKFLOW_TASK_AGENT_INVOCATION:
-     * output: {
-     *   "agent_execution_id": "agx-abc123"
-     *   "response": "The customer feedback is positive overall..."
-     *   "sentiment": "positive"
-     *   "confidence": 0.92
-     * }
-     *
-     * WORKFLOW_TASK_API_CALL:
-     * output: {
-     *   "status_code": 200
-     *   "body": {
-     *     "id": "cus_abc123"
-     *     "email": "customer@example.com"
-     *     "created": 1704988800
-     *   }
-     * }
-     *
-     * WORKFLOW_TASK_APPROVAL:
-     * output: {
-     *   "approved": true
-     *   "approved_by": "usr-admin-1"
-     *   "approved_at": "2025-01-11T15:22:33Z"
-     *   "comment": "Looks good, approved"
-     * }
-     *
      * @generated from field: google.protobuf.Struct output = 5;
      */
     output?: JsonObject;
     /**
      * Current task execution status.
      *
-     * Statuses:
-     * - WORKFLOW_TASK_PENDING: Task not yet started (waiting for dependencies)
-     * - WORKFLOW_TASK_IN_PROGRESS: Task is currently executing
-     * - WORKFLOW_TASK_COMPLETED: Task finished successfully
-     * - WORKFLOW_TASK_FAILED: Task failed during execution (see error field)
-     * - WORKFLOW_TASK_SKIPPED: Task was skipped (conditional logic, early exit)
-     *
+     * @internal
      * Status Transitions:
      * PENDING → IN_PROGRESS → COMPLETED
      *        ↓              ↘ FAILED
@@ -627,47 +484,31 @@ export type WorkflowTask = Message<"ai.stigmer.agentic.workflowexecution.v1.Work
      */
     status: WorkflowTaskStatus;
     /**
-     * ISO 8601 timestamp when task started executing.
+     * ISO 8601 timestamp when the task started executing.
      *
+     * @internal
      * Set when task status changes from PENDING to IN_PROGRESS.
-     *
      * Format: "YYYY-MM-DDTHH:MM:SSZ" (UTC timezone)
-     * Example: "2025-01-11T14:30:23Z"
-     *
-     * Used for:
-     * - Calculating task duration (completed_at - started_at)
-     * - Detecting stuck tasks (started but not completed after X minutes)
-     * - Performance analysis (which tasks are slow)
      *
      * @generated from field: string started_at = 7;
      */
     startedAt: string;
     /**
-     * ISO 8601 timestamp when task completed, failed, or was skipped.
-     *
-     * Set when task reaches a terminal state:
-     * - WORKFLOW_TASK_COMPLETED: Successfully finished
-     * - WORKFLOW_TASK_FAILED: Failed during execution
-     * - WORKFLOW_TASK_SKIPPED: Skipped by conditional logic
+     * ISO 8601 timestamp when the task reached a terminal state.
      *
+     * @internal
+     * Set when task reaches COMPLETED, FAILED, or SKIPPED.
      * Not set for PENDING or IN_PROGRESS tasks.
-     *
      * Format: "YYYY-MM-DDTHH:MM:SSZ" (UTC timezone)
-     * Example: "2025-01-11T14:30:27.450Z"
-     *
-     * Used for:
-     * - Calculating task duration (completed_at - started_at)
-     * - SLA monitoring (alert if task takes longer than expected)
-     * - Performance benchmarking (average task duration over time)
      *
      * @generated from field: string completed_at = 8;
      */
     completedAt: string;
     /**
-     * Error message if task failed.
+     * Error message, populated only when status is WORKFLOW_TASK_FAILED.
      *
+     * @internal
      * Contains a human-readable description of why the task failed.
-     * Only populated when status == WORKFLOW_TASK_FAILED.
      *
      * Error message includes:
      * - What operation failed (API call, agent invocation, etc.)
@@ -675,21 +516,13 @@ export type WorkflowTask = Message<"ai.stigmer.agentic.workflowexecution.v1.Work
      * - Error details (status code, exception message, stacktrace)
      * - How to fix it (if known)
      *
-     * Examples:
-     * - "API call failed: 429 Too Many Requests. Retry after 60 seconds."
-     * - "Agent invocation failed: Agent execution timeout after 300 seconds."
-     * - "Approval task failed: Timeout after 24 hours with no approval."
-     *
-     * For detailed debugging, also check:
-     * - task.input (what parameters were used)
-     * - task.metadata (retry count, execution context)
-     *
      * @generated from field: string error = 9;
      */
     error: string;
     /**
-     * Task metadata (arbitrary JSON data).
+     * Task-specific metadata as arbitrary JSON.
      *
+     * @internal
      * Contains task-specific information that doesn't fit in other fields.
      * Used for:
      * - Retry count (how many times this task was retried)
@@ -698,31 +531,6 @@ export type WorkflowTask = Message<"ai.stigmer.agentic.workflowexecution.v1.Work
      * - Approval history (who approved, when, comments)
      * - Performance metrics (execution time, memory usage)
      *
-     * Examples:
-     *
-     * Agent invocation task:
-     * metadata: {
-     *   "agent_execution_id": "agx-abc123"
-     *   "retry_count": 0
-     *   "tokens_used": 450
-     * }
-     *
-     * API call task:
-     * metadata: {
-     *   "retry_count": 2
-     *   "response_headers": {
-     *     "x-ratelimit-remaining": "98"
-     *     "x-request-id": "req-xyz789"
-     *   }
-     * }
-     *
-     * Approval task:
-     * metadata: {
-     *   "approval_history": [
-     *     { "user": "usr-admin-1", "action": "approved", "timestamp": "2025-01-11T15:22:33Z" }
-     *   ]
-     * }
-     *
      * @generated from field: google.protobuf.Struct metadata = 10;
      */
     metadata?: JsonObject;

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

@@ -1 +1 @@
-{"version":3,"file":"api_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/workflowexecution/v1/api_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,0IAA0I;AAC1I,oBAAoB;AAYpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,kDAAkD,EAAE,MAAM,qCAAqC,CAAC;AAEzG,OAAO,EAAE,iDAAiD,EAAE,MAAM,WAAW,CAAC;AAE9E,OAAO,EAAE,iDAAiD,EAAE,MAAM,WAAW,CAAC;AAE9E,OAAO,EAAE,4CAA4C,EAAE,MAAM,0CAA0C,CAAC;AAExG,OAAO,EAAE,0CAA0C,EAAE,MAAM,wCAAwC,CAAC;AACpG,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AACrF,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAGrE;;GAEG;AACH,MAAM,CAAC,MAAM,gDAAgD,GAAY,aAAa,CACpF,QAAQ,CAAC,g6DAAg6D,EAAE,CAAC,kDAAkD,EAAE,iDAAiD,EAAE,iDAAiD,EAAE,4CAA4C,EAAE,0CAA0C,EAAE,0BAA0B,EAAE,2BAA2B,CAAC,CAAC,CAAC;AAoJ5tE;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAkC,aAAa,CACjF,WAAW,CAAC,gDAAgD,EAAE,CAAC,CAAC,CAAC;AAkQnE;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAwC,aAAa,CAC7F,WAAW,CAAC,gDAAgD,EAAE,CAAC,CAAC,CAAC;AAkCnE;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAwC,aAAa,CAC7F,WAAW,CAAC,gDAAgD,EAAE,CAAC,CAAC,CAAC;AAySnE;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6B,aAAa,CACvE,WAAW,CAAC,gDAAgD,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"api_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/workflowexecution/v1/api_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,0IAA0I;AAC1I,oBAAoB;AAYpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,kDAAkD,EAAE,MAAM,qCAAqC,CAAC;AAEzG,OAAO,EAAE,iDAAiD,EAAE,MAAM,WAAW,CAAC;AAE9E,OAAO,EAAE,iDAAiD,EAAE,MAAM,WAAW,CAAC;AAE9E,OAAO,EAAE,4CAA4C,EAAE,MAAM,0CAA0C,CAAC;AAExG,OAAO,EAAE,0CAA0C,EAAE,MAAM,wCAAwC,CAAC;AACpG,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AACrF,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAGrE;;GAEG;AACH,MAAM,CAAC,MAAM,gDAAgD,GAAY,aAAa,CACpF,QAAQ,CAAC,g6DAAg6D,EAAE,CAAC,kDAAkD,EAAE,iDAAiD,EAAE,iDAAiD,EAAE,4CAA4C,EAAE,0CAA0C,EAAE,0BAA0B,EAAE,2BAA2B,CAAC,CAAC,CAAC;AAqJ5tE;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAkC,aAAa,CACjF,WAAW,CAAC,gDAAgD,EAAE,CAAC,CAAC,CAAC;AAmMnE;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAwC,aAAa,CAC7F,WAAW,CAAC,gDAAgD,EAAE,CAAC,CAAC,CAAC;AAmCnE;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAwC,aAAa,CAC7F,WAAW,CAAC,gDAAgD,EAAE,CAAC,CAAC,CAAC;AAsKnE;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6B,aAAa,CACvE,WAAW,CAAC,gDAAgD,EAAE,CAAC,CAAC,CAAC"}