@stigmer/protos 0.0.68 → 0.0.70

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

@@ -8,7 +8,10 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_ai_stigmer_agentic_workflow_v1_api: GenFile;
 /**
- * Workflow represents a workflow orchestration definition.
+ * Workflow defines a multi-step task orchestration with sequential, parallel, and conditional execution.
+ *
+ * @internal
+ * Uses Graphton configuration for state management.
  *
  * @generated from message ai.stigmer.agentic.workflow.v1.Workflow
  */
@@ -26,21 +29,19 @@ export type Workflow = Message<"ai.stigmer.agentic.workflow.v1.Workflow"> & {
      */
     kind: string;
     /**
-     * Standard resource metadata including name, id, labels, and tags.
-     * Workflows belong to an organization and can be PUBLIC or PRIVATE.
-     * Reference format: "org/slug" (e.g., "stigmer/deploy", "acme/onboarding")
+     * Resource metadata including name, organization, visibility, and labels.
      *
      * @generated from field: ai.stigmer.commons.apiresource.ApiResourceMetadata metadata = 3;
      */
     metadata?: ApiResourceMetadata;
     /**
-     * Workflow-specific configuration.
+     * Configurable properties: document metadata, tasks, and environment variables.
      *
      * @generated from field: ai.stigmer.agentic.workflow.v1.WorkflowSpec spec = 4;
      */
     spec?: WorkflowSpec;
     /**
-     * System-managed status containing audit information and default instance ID.
+     * System-managed state including audit trail and default instance ID.
      *
      * @generated from field: ai.stigmer.agentic.workflow.v1.WorkflowStatus status = 5;
      */

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

@@ -1 +1 @@
-{"version":3,"file":"api_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/workflow/v1/api_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,wHAAwH;AACxH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,wCAAwC,EAAE,MAAM,WAAW,CAAC;AAErE,OAAO,EAAE,0CAA0C,EAAE,MAAM,aAAa,CAAC;AAEzE,OAAO,EAAE,4CAA4C,EAAE,MAAM,0CAA0C,CAAC;AACxG,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAGrF;;GAEG;AACH,MAAM,CAAC,MAAM,uCAAuC,GAAY,aAAa,CAC3E,QAAQ,CAAC,6fAA6f,EAAE,CAAC,wCAAwC,EAAE,0CAA0C,EAAE,4CAA4C,EAAE,0BAA0B,CAAC,CAAC,CAAC;AA8C5qB;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAyB,aAAa,CAC/D,WAAW,CAAC,uCAAuC,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"api_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/workflow/v1/api_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,wHAAwH;AACxH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,wCAAwC,EAAE,MAAM,WAAW,CAAC;AAErE,OAAO,EAAE,0CAA0C,EAAE,MAAM,aAAa,CAAC;AAEzE,OAAO,EAAE,4CAA4C,EAAE,MAAM,0CAA0C,CAAC;AACxG,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAGrF;;GAEG;AACH,MAAM,CAAC,MAAM,uCAAuC,GAAY,aAAa,CAC3E,QAAQ,CAAC,6fAA6f,EAAE,CAAC,wCAAwC,EAAE,0CAA0C,EAAE,4CAA4C,EAAE,0BAA0B,CAAC,CAAC,CAAC;AA+C5qB;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAyB,aAAa,CAC/D,WAAW,CAAC,uCAAuC,EAAE,CAAC,CAAC,CAAC"}

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

@@ -8,6 +8,8 @@ export declare const WorkflowCommandController: {
     readonly methods: {
         /**
          * Create or update a workflow.
+         *
+         * @internal
          * The authorization and state-operation are determined depending on whether the workflow
          * is going to be created or updated which is determined as part of the request execution.
          *
@@ -20,8 +22,9 @@ export declare const WorkflowCommandController: {
             readonly kind: any;
         };
         /**
-         * Create a new workflow.
+         * Create a workflow.
          *
+         * @internal
          * Authorization:
          * - Organization-scoped workflows: Caller must have can_create_workflow permission in the organization
          * - Platform-scoped workflows: Caller must be a platform operator (handled automatically by common auth step)

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

@@ -13,6 +13,8 @@ export const WorkflowCommandController = {
     methods: {
         /**
          * Create or update a workflow.
+         *
+         * @internal
          * The authorization and state-operation are determined depending on whether the workflow
          * is going to be created or updated which is determined as part of the request execution.
          *
@@ -25,8 +27,9 @@ export const WorkflowCommandController = {
             kind: MethodKind.Unary,
         },
         /**
-         * Create a new workflow.
+         * Create a workflow.
          *
+         * @internal
          * Authorization:
          * - Organization-scoped workflows: Caller must have can_create_workflow permission in the organization
          * - Platform-scoped workflows: Caller must be a platform operator (handled automatically by common auth step)

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

@@ -1 +1 @@
-{"version":3,"file":"command_connect.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/workflow/v1/command_connect.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,4HAA4H;AAC5H,oBAAoB;AACpB,cAAc;AAGd,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,QAAQ,EAAE,0DAA0D;IACpE,OAAO,EAAE;QACP;;;;;;WAMG;QACH,KAAK,EAAE;YACL,IAAI,EAAE,OAAO;YACb,CAAC,EAAE,QAAQ;YACX,CAAC,EAAE,QAAQ;YACX,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;WAQG;QACH,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,CAAC,EAAE,QAAQ;YACX,CAAC,EAAE,QAAQ;YACX,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;WAIG;QACH,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,CAAC,EAAE,QAAQ;YACX,CAAC,EAAE,QAAQ;YACX,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;WAIG;QACH,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,CAAC,EAAE,UAAU;YACb,CAAC,EAAE,QAAQ;YACX,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;KACF;CACO,CAAC"}
+{"version":3,"file":"command_connect.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/workflow/v1/command_connect.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,4HAA4H;AAC5H,oBAAoB;AACpB,cAAc;AAGd,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,QAAQ,EAAE,0DAA0D;IACpE,OAAO,EAAE;QACP;;;;;;;;WAQG;QACH,KAAK,EAAE;YACL,IAAI,EAAE,OAAO;YACb,CAAC,EAAE,QAAQ;YACX,CAAC,EAAE,QAAQ;YACX,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;WASG;QACH,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,CAAC,EAAE,QAAQ;YACX,CAAC,EAAE,QAAQ;YACX,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;WAIG;QACH,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,CAAC,EAAE,QAAQ;YACX,CAAC,EAAE,QAAQ;YACX,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;WAIG;QACH,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,CAAC,EAAE,UAAU;YACb,CAAC,EAAE,QAAQ;YACX,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;KACF;CACO,CAAC"}

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

@@ -13,6 +13,8 @@ export declare const file_ai_stigmer_agentic_workflow_v1_command: GenFile;
 export declare const WorkflowCommandController: GenService<{
     /**
      * Create or update a workflow.
+     *
+     * @internal
      * The authorization and state-operation are determined depending on whether the workflow
      * is going to be created or updated which is determined as part of the request execution.
      *
@@ -24,8 +26,9 @@ export declare const WorkflowCommandController: GenService<{
         output: typeof WorkflowSchema;
     };
     /**
-     * Create a new workflow.
+     * Create a workflow.
      *
+     * @internal
      * Authorization:
      * - Organization-scoped workflows: Caller must have can_create_workflow permission in the organization
      * - Platform-scoped workflows: Caller must be a platform operator (handled automatically by common auth step)

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

@@ -1 +1 @@
-{"version":3,"file":"command_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/workflow/v1/command_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,4HAA4H;AAC5H,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,uCAAuC,EAAE,MAAM,UAAU,CAAC;AAEnE,OAAO,EAAE,sCAAsC,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,uDAAuD,EAAE,MAAM,qDAAqD,CAAC;AAC9H,OAAO,EAAE,gEAAgE,EAAE,MAAM,8DAA8D,CAAC;AAEhJ;;GAEG;AACH,MAAM,CAAC,MAAM,2CAA2C,GAAY,aAAa,CAC/E,QAAQ,CAAC,q5BAAq5B,EAAE,CAAC,uCAAuC,EAAE,sCAAsC,EAAE,uDAAuD,EAAE,gEAAgE,CAAC,CAAC,CAAC;AAEhnC;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GA+CjC,aAAa,CAChB,WAAW,CAAC,2CAA2C,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"command_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/workflow/v1/command_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,4HAA4H;AAC5H,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,uCAAuC,EAAE,MAAM,UAAU,CAAC;AAEnE,OAAO,EAAE,sCAAsC,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,uDAAuD,EAAE,MAAM,qDAAqD,CAAC;AAC9H,OAAO,EAAE,gEAAgE,EAAE,MAAM,8DAA8D,CAAC;AAEhJ;;GAEG;AACH,MAAM,CAAC,MAAM,2CAA2C,GAAY,aAAa,CAC/E,QAAQ,CAAC,q5BAAq5B,EAAE,CAAC,uCAAuC,EAAE,sCAAsC,EAAE,uDAAuD,EAAE,gEAAgE,CAAC,CAAC,CAAC;AAEhnC;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAkDjC,aAAa,CAChB,WAAW,CAAC,2CAA2C,EAAE,CAAC,CAAC,CAAC"}

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

@@ -4,7 +4,9 @@ import type { GenEnum, GenFile } from "@bufbuild/protobuf/codegenv1";
  */
 export declare const file_ai_stigmer_agentic_workflow_v1_enum: GenFile;
 /**
- * WorkflowTaskKind defines all supported task types in workflows.
+ * WorkflowTaskKind defines the supported task types in a workflow.
+ *
+ * @internal
  * These map directly to Zigflow DSL task types.
  *
  * Naming conventions:
@@ -34,97 +36,127 @@ export declare const file_ai_stigmer_agentic_workflow_v1_enum: GenFile;
  */
 export declare enum WorkflowTaskKind {
     /**
-     * Unspecified (invalid) - prefixed for zero value clarity.
+     * Default value, not a valid task kind.
      *
      * @generated from enum value: workflow_task_kind_unspecified = 0;
      */
     workflow_task_kind_unspecified = 0,
     /**
-     * set_vars: Set variables in workflow state.
+     * Set variables in workflow state.
+     *
+     * @internal
      * Config: {"variables": {"key": "value", ...}}
      *
      * @generated from enum value: set_vars = 1;
      */
     set_vars = 1,
     /**
-     * http_call: Make HTTP requests (GET, POST, PUT, DELETE, PATCH).
+     * Make an HTTP request (GET, POST, PUT, DELETE, PATCH).
+     *
+     * @internal
      * Config: {"method": "POST", "endpoint": {"uri": "..."}, "headers": {...}, "body": {...}}
      *
      * @generated from enum value: http_call = 2;
      */
     http_call = 2,
     /**
-     * grpc_call: Make gRPC requests.
+     * Make a gRPC request to an external service.
+     *
+     * @internal
      * Config: {"service": "...", "method": "...", "request": {...}}
      *
      * @generated from enum value: grpc_call = 3;
      */
     grpc_call = 3,
     /**
-     * activity_call: Execute Temporal activities.
+     * Execute an activity.
+     *
+     * @internal
      * Config: {"activity": "ActivityName", "input": {...}}
+     * Executes a Temporal activity.
      *
      * @generated from enum value: activity_call = 4;
      */
     activity_call = 4,
     /**
-     * switch_case: Conditional branching based on expressions.
+     * Branch conditionally based on expressions.
+     *
+     * @internal
      * Config: {"cases": [{"name": "...", "when": "${expr}", "then": "taskName"}, ...]}
      *
      * @generated from enum value: switch_case = 5;
      */
     switch_case = 5,
     /**
-     * for_each: Iterate over collections (forEach loop).
+     * Iterate over a collection, executing tasks for each item.
+     *
+     * @internal
      * Config: {"each": "item", "in": "${$data.items}", "do": [{task}, ...]}
      *
      * @generated from enum value: for_each = 6;
      */
     for_each = 6,
     /**
-     * fork: Parallel execution of multiple branches.
+     * Execute multiple branches in parallel.
+     *
+     * @internal
      * Config: {"branches": [{"name": "...", "do": [{task}, ...]}, ...], "compete": false}
      *
      * @generated from enum value: fork = 7;
      */
     fork = 7,
     /**
-     * try_catch: Error handling (try/catch block).
+     * Handle errors with try/catch logic.
+     *
+     * @internal
      * Config: {"try": [{task}, ...], "catch": {"as": "error", "do": [{task}, ...]}}
      *
      * @generated from enum value: try_catch = 8;
      */
     try_catch = 8,
     /**
-     * listen: Wait for external signals/events.
+     * Wait for external signals or events.
+     *
+     * @internal
      * Config: {"to": {"mode": "one", "signals": [{"id": "...", "type": "signal"}]}}
+     * Implemented via Temporal signals.
      *
      * @generated from enum value: listen = 9;
      */
     listen = 9,
     /**
-     * wait: Sleep/delay (Temporal timer).
+     * Pause execution for a duration or until a timestamp.
+     *
+     * @internal
      * Config: {"seconds": 5}
+     * Implemented via Temporal timers.
      *
      * @generated from enum value: wait = 10;
      */
     wait = 10,
     /**
-     * raise_error: Raise errors/exceptions.
+     * Raise an error to terminate or trigger error handling.
+     *
+     * @internal
      * Config: {"error": "ErrorType", "message": "${...}"}
      *
      * @generated from enum value: raise_error = 11;
      */
     raise_error = 11,
     /**
-     * run_workflow: Execute sub-workflows.
+     * Execute a sub-workflow.
+     *
+     * @internal
      * Config: {"workflow": "workflow-name", "input": {...}}
+     * Implemented via Temporal child workflows.
      *
      * @generated from enum value: run_workflow = 12;
      */
     run_workflow = 12,
     /**
-     * agent_call: Invoke AI agents as tasks.
+     * Invoke an AI agent as a workflow task.
+     *
+     * @internal
      * Allows workflows to delegate complex operations to specialized agents.
      * Config: {"agent": "agent-slug", "message": "...", "env": {...}, "config": {...}}
      *

package/ai/stigmer/agentic/workflow/v1/enum_pb.js

@@ -7,7 +7,9 @@ import { enumDesc, fileDesc } from "@bufbuild/protobuf/codegenv1";
  */
 export const file_ai_stigmer_agentic_workflow_v1_enum = /*@__PURE__*/ fileDesc("CilhaS9zdGlnbWVyL2FnZW50aWMvd29ya2Zsb3cvdjEvZW51bS5wcm90bxIeYWkuc3RpZ21lci5hZ2VudGljLndvcmtmbG93LnYxKvYBChBXb3JrZmxvd1Rhc2tLaW5kEiIKHndvcmtmbG93X3Rhc2tfa2luZF91bnNwZWNpZmllZBAAEgwKCHNldF92YXJzEAESDQoJaHR0cF9jYWxsEAISDQoJZ3JwY19jYWxsEAMSEQoNYWN0aXZpdHlfY2FsbBAEEg8KC3N3aXRjaF9jYXNlEAUSDAoIZm9yX2VhY2gQBhIICgRmb3JrEAcSDQoJdHJ5X2NhdGNoEAgSCgoGbGlzdGVuEAkSCAoEd2FpdBAKEg8KC3JhaXNlX2Vycm9yEAsSEAoMcnVuX3dvcmtmbG93EAwSDgoKYWdlbnRfY2FsbBANYgZwcm90bzM");
 /**
- * WorkflowTaskKind defines all supported task types in workflows.
+ * WorkflowTaskKind defines the supported task types in a workflow.
+ *
+ * @internal
  * These map directly to Zigflow DSL task types.
  *
  * Naming conventions:
@@ -38,97 +40,127 @@ export const file_ai_stigmer_agentic_workflow_v1_enum = /*@__PURE__*/ fileDesc("
 export var WorkflowTaskKind;
 (function (WorkflowTaskKind) {
     /**
-     * Unspecified (invalid) - prefixed for zero value clarity.
+     * Default value, not a valid task kind.
      *
      * @generated from enum value: workflow_task_kind_unspecified = 0;
      */
     WorkflowTaskKind[WorkflowTaskKind["workflow_task_kind_unspecified"] = 0] = "workflow_task_kind_unspecified";
     /**
-     * set_vars: Set variables in workflow state.
+     * Set variables in workflow state.
+     *
+     * @internal
      * Config: {"variables": {"key": "value", ...}}
      *
      * @generated from enum value: set_vars = 1;
      */
     WorkflowTaskKind[WorkflowTaskKind["set_vars"] = 1] = "set_vars";
     /**
-     * http_call: Make HTTP requests (GET, POST, PUT, DELETE, PATCH).
+     * Make an HTTP request (GET, POST, PUT, DELETE, PATCH).
+     *
+     * @internal
      * Config: {"method": "POST", "endpoint": {"uri": "..."}, "headers": {...}, "body": {...}}
      *
      * @generated from enum value: http_call = 2;
      */
     WorkflowTaskKind[WorkflowTaskKind["http_call"] = 2] = "http_call";
     /**
-     * grpc_call: Make gRPC requests.
+     * Make a gRPC request to an external service.
+     *
+     * @internal
      * Config: {"service": "...", "method": "...", "request": {...}}
      *
      * @generated from enum value: grpc_call = 3;
      */
     WorkflowTaskKind[WorkflowTaskKind["grpc_call"] = 3] = "grpc_call";
     /**
-     * activity_call: Execute Temporal activities.
+     * Execute an activity.
+     *
+     * @internal
      * Config: {"activity": "ActivityName", "input": {...}}
+     * Executes a Temporal activity.
      *
      * @generated from enum value: activity_call = 4;
      */
     WorkflowTaskKind[WorkflowTaskKind["activity_call"] = 4] = "activity_call";
     /**
-     * switch_case: Conditional branching based on expressions.
+     * Branch conditionally based on expressions.
+     *
+     * @internal
      * Config: {"cases": [{"name": "...", "when": "${expr}", "then": "taskName"}, ...]}
      *
      * @generated from enum value: switch_case = 5;
      */
     WorkflowTaskKind[WorkflowTaskKind["switch_case"] = 5] = "switch_case";
     /**
-     * for_each: Iterate over collections (forEach loop).
+     * Iterate over a collection, executing tasks for each item.
+     *
+     * @internal
      * Config: {"each": "item", "in": "${$data.items}", "do": [{task}, ...]}
      *
      * @generated from enum value: for_each = 6;
      */
     WorkflowTaskKind[WorkflowTaskKind["for_each"] = 6] = "for_each";
     /**
-     * fork: Parallel execution of multiple branches.
+     * Execute multiple branches in parallel.
+     *
+     * @internal
      * Config: {"branches": [{"name": "...", "do": [{task}, ...]}, ...], "compete": false}
      *
      * @generated from enum value: fork = 7;
      */
     WorkflowTaskKind[WorkflowTaskKind["fork"] = 7] = "fork";
     /**
-     * try_catch: Error handling (try/catch block).
+     * Handle errors with try/catch logic.
+     *
+     * @internal
      * Config: {"try": [{task}, ...], "catch": {"as": "error", "do": [{task}, ...]}}
      *
      * @generated from enum value: try_catch = 8;
      */
     WorkflowTaskKind[WorkflowTaskKind["try_catch"] = 8] = "try_catch";
     /**
-     * listen: Wait for external signals/events.
+     * Wait for external signals or events.
+     *
+     * @internal
      * Config: {"to": {"mode": "one", "signals": [{"id": "...", "type": "signal"}]}}
+     * Implemented via Temporal signals.
      *
      * @generated from enum value: listen = 9;
      */
     WorkflowTaskKind[WorkflowTaskKind["listen"] = 9] = "listen";
     /**
-     * wait: Sleep/delay (Temporal timer).
+     * Pause execution for a duration or until a timestamp.
+     *
+     * @internal
      * Config: {"seconds": 5}
+     * Implemented via Temporal timers.
      *
      * @generated from enum value: wait = 10;
      */
     WorkflowTaskKind[WorkflowTaskKind["wait"] = 10] = "wait";
     /**
-     * raise_error: Raise errors/exceptions.
+     * Raise an error to terminate or trigger error handling.
+     *
+     * @internal
      * Config: {"error": "ErrorType", "message": "${...}"}
      *
      * @generated from enum value: raise_error = 11;
      */
     WorkflowTaskKind[WorkflowTaskKind["raise_error"] = 11] = "raise_error";
     /**
-     * run_workflow: Execute sub-workflows.
+     * Execute a sub-workflow.
+     *
+     * @internal
      * Config: {"workflow": "workflow-name", "input": {...}}
+     * Implemented via Temporal child workflows.
      *
      * @generated from enum value: run_workflow = 12;
      */
     WorkflowTaskKind[WorkflowTaskKind["run_workflow"] = 12] = "run_workflow";
     /**
-     * agent_call: Invoke AI agents as tasks.
+     * Invoke an AI agent as a workflow task.
+     *
+     * @internal
      * Allows workflows to delegate complex operations to specialized agents.
      * Config: {"agent": "agent-slug", "message": "...", "env": {...}, "config": {...}}
      *

package/ai/stigmer/agentic/workflow/v1/enum_pb.js.map

@@ -1 +1 @@
-{"version":3,"file":"enum_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/workflow/v1/enum_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,yHAAyH;AACzH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAElE;;GAEG;AACH,MAAM,CAAC,MAAM,wCAAwC,GAAY,aAAa,CAC5E,QAAQ,CAAC,6bAA6b,CAAC,CAAC;AAE1c;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAN,IAAY,gBAgHX;AAhHD,WAAY,gBAAgB;IAC1B;;;;OAIG;IACH,2GAAkC,CAAA;IAElC;;;;;OAKG;IACH,+DAAY,CAAA;IAEZ;;;;;OAKG;IACH,iEAAa,CAAA;IAEb;;;;;OAKG;IACH,iEAAa,CAAA;IAEb;;;;;OAKG;IACH,yEAAiB,CAAA;IAEjB;;;;;OAKG;IACH,qEAAe,CAAA;IAEf;;;;;OAKG;IACH,+DAAY,CAAA;IAEZ;;;;;OAKG;IACH,uDAAQ,CAAA;IAER;;;;;OAKG;IACH,iEAAa,CAAA;IAEb;;;;;OAKG;IACH,2DAAU,CAAA;IAEV;;;;;OAKG;IACH,wDAAS,CAAA;IAET;;;;;OAKG;IACH,sEAAgB,CAAA;IAEhB;;;;;OAKG;IACH,wEAAiB,CAAA;IAEjB;;;;;;OAMG;IACH,oEAAe,CAAA;AACjB,CAAC,EAhHW,gBAAgB,KAAhB,gBAAgB,QAgH3B;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAA8B,aAAa,CAC5E,QAAQ,CAAC,wCAAwC,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"enum_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/workflow/v1/enum_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,yHAAyH;AACzH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAElE;;GAEG;AACH,MAAM,CAAC,MAAM,wCAAwC,GAAY,aAAa,CAC5E,QAAQ,CAAC,6bAA6b,CAAC,CAAC;AAE1c;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,CAAN,IAAY,gBA8IX;AA9ID,WAAY,gBAAgB;IAC1B;;;;OAIG;IACH,2GAAkC,CAAA;IAElC;;;;;;;OAOG;IACH,+DAAY,CAAA;IAEZ;;;;;;;OAOG;IACH,iEAAa,CAAA;IAEb;;;;;;;OAOG;IACH,iEAAa,CAAA;IAEb;;;;;;;;OAQG;IACH,yEAAiB,CAAA;IAEjB;;;;;;;OAOG;IACH,qEAAe,CAAA;IAEf;;;;;;;OAOG;IACH,+DAAY,CAAA;IAEZ;;;;;;;OAOG;IACH,uDAAQ,CAAA;IAER;;;;;;;OAOG;IACH,iEAAa,CAAA;IAEb;;;;;;;;OAQG;IACH,2DAAU,CAAA;IAEV;;;;;;;;OAQG;IACH,wDAAS,CAAA;IAET;;;;;;;OAOG;IACH,sEAAgB,CAAA;IAEhB;;;;;;;;OAQG;IACH,wEAAiB,CAAA;IAEjB;;;;;;;;OAQG;IACH,oEAAe,CAAA;AACjB,CAAC,EA9IW,gBAAgB,KAAhB,gBAAgB,QA8I3B;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAA8B,aAAa,CAC5E,QAAQ,CAAC,wCAAwC,EAAE,CAAC,CAAC,CAAC"}

package/ai/stigmer/agentic/workflow/v1/query_connect.d.ts

@@ -18,7 +18,12 @@ export declare const WorkflowQueryController: {
             readonly kind: any;
         };
         /**
-         * Custom authorization in handler
+         * Get a workflow by its organization-scoped reference (org/slug).
+         * Resolves a human-readable reference like "stigmer/deploy" to the full Workflow resource.
+         *
+         * @internal
+         * Custom authorization in handler — checks both direct resource access
+         * and organization-level visibility permissions.
          *
          * @generated from rpc ai.stigmer.agentic.workflow.v1.WorkflowQueryController.getByReference
          */

package/ai/stigmer/agentic/workflow/v1/query_connect.js

@@ -23,7 +23,12 @@ export const WorkflowQueryController = {
             kind: MethodKind.Unary,
         },
         /**
-         * Custom authorization in handler
+         * Get a workflow by its organization-scoped reference (org/slug).
+         * Resolves a human-readable reference like "stigmer/deploy" to the full Workflow resource.
+         *
+         * @internal
+         * Custom authorization in handler — checks both direct resource access
+         * and organization-level visibility permissions.
          *
          * @generated from rpc ai.stigmer.agentic.workflow.v1.WorkflowQueryController.getByReference
          */

package/ai/stigmer/agentic/workflow/v1/query_connect.js.map

@@ -1 +1 @@
-{"version":3,"file":"query_connect.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/workflow/v1/query_connect.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,0HAA0H;AAC1H,oBAAoB;AACpB,cAAc;AAId,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,QAAQ,EAAE,wDAAwD;IAClE,OAAO,EAAE;QACP;;;;WAIG;QACH,GAAG,EAAE;YACH,IAAI,EAAE,KAAK;YACX,CAAC,EAAE,UAAU;YACb,CAAC,EAAE,QAAQ;YACX,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;WAIG;QACH,cAAc,EAAE;YACd,IAAI,EAAE,gBAAgB;YACtB,CAAC,EAAE,oBAAoB;YACvB,CAAC,EAAE,QAAQ;YACX,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;KACF;CACO,CAAC"}
+{"version":3,"file":"query_connect.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/workflow/v1/query_connect.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,0HAA0H;AAC1H,oBAAoB;AACpB,cAAc;AAId,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,QAAQ,EAAE,wDAAwD;IAClE,OAAO,EAAE;QACP;;;;WAIG;QACH,GAAG,EAAE;YACH,IAAI,EAAE,KAAK;YACX,CAAC,EAAE,UAAU;YACb,CAAC,EAAE,QAAQ;YACX,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;WASG;QACH,cAAc,EAAE;YACd,IAAI,EAAE,gBAAgB;YACtB,CAAC,EAAE,oBAAoB;YACvB,CAAC,EAAE,QAAQ;YACX,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;KACF;CACO,CAAC"}

package/ai/stigmer/agentic/workflow/v1/query_pb.d.ts

@@ -23,7 +23,12 @@ export declare const WorkflowQueryController: GenService<{
         output: typeof WorkflowSchema;
     };
     /**
-     * Custom authorization in handler
+     * Get a workflow by its organization-scoped reference (org/slug).
+     * Resolves a human-readable reference like "stigmer/deploy" to the full Workflow resource.
+     *
+     * @internal
+     * Custom authorization in handler — checks both direct resource access
+     * and organization-level visibility permissions.
      *
      * @generated from rpc ai.stigmer.agentic.workflow.v1.WorkflowQueryController.getByReference
      */

package/ai/stigmer/agentic/workflow/v1/query_pb.js.map

@@ -1 +1 @@
-{"version":3,"file":"query_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/workflow/v1/query_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,0HAA0H;AAC1H,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,uCAAuC,EAAE,MAAM,UAAU,CAAC;AAEnE,OAAO,EAAE,sCAAsC,EAAE,MAAM,SAAS,CAAC;AAEjE,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,yCAAyC,GAAY,aAAa,CAC7E,QAAQ,CAAC,4fAA4f,EAAE,CAAC,uCAAuC,EAAE,sCAAsC,EAAE,sCAAsC,EAAE,uDAAuD,EAAE,gEAAgE,CAAC,CAAC,CAAC;AAE/vB;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAqB/B,aAAa,CAChB,WAAW,CAAC,yCAAyC,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"query_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/workflow/v1/query_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,0HAA0H;AAC1H,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,uCAAuC,EAAE,MAAM,UAAU,CAAC;AAEnE,OAAO,EAAE,sCAAsC,EAAE,MAAM,SAAS,CAAC;AAEjE,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,yCAAyC,GAAY,aAAa,CAC7E,QAAQ,CAAC,4fAA4f,EAAE,CAAC,uCAAuC,EAAE,sCAAsC,EAAE,sCAAsC,EAAE,uDAAuD,EAAE,gEAAgE,CAAC,CAAC,CAAC;AAE/vB;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GA0B/B,aAAa,CAChB,WAAW,CAAC,yCAAyC,EAAE,CAAC,CAAC,CAAC"}

package/ai/stigmer/agentic/workflow/v1/serverless/validation_pb.d.ts

@@ -6,60 +6,55 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_ai_stigmer_agentic_workflow_v1_serverless_validation: GenFile;
 /**
- * ServerlessWorkflowValidation contains the generated Serverless Workflow YAML
- * and its validation state. This is populated asynchronously after workflow creation
- * via a Temporal workflow that validates the workflow structure.
+ * ServerlessWorkflowValidation contains the generated Serverless Workflow YAML and its validation state.
+ *
+ * @internal
+ * Populated asynchronously after workflow creation via a Temporal workflow
+ * that validates the workflow structure.
  *
  * @generated from message ai.stigmer.agentic.workflow.v1.serverless.ServerlessWorkflowValidation
  */
 export type ServerlessWorkflowValidation = Message<"ai.stigmer.agentic.workflow.v1.serverless.ServerlessWorkflowValidation"> & {
     /**
-     * Current validation state
+     * Current validation state.
      *
      * @generated from field: ai.stigmer.agentic.workflow.v1.serverless.ValidationState state = 1;
      */
     state: ValidationState;
     /**
-     * Generated Serverless Workflow YAML (CNCF DSL 1.0.0 format)
-     * This YAML may contain runtime expressions for environment variables:
-     *   Example: ${ .env.API_BASE_URL }
-     *
+     * Generated CNCF Serverless Workflow DSL 1.0.0 YAML.
      * Present even if validation failed (helps debugging).
-     * Empty if validation hasn't started yet.
+     * Empty if validation has not started yet.
+     *
+     * @internal
+     * May contain runtime expressions for environment variables (e.g., ${ .env.API_BASE_URL }).
      *
      * @generated from field: string yaml = 2;
      */
     yaml: string;
     /**
-     * Validation errors (empty if valid)
-     * Examples:
-     *   - "Invalid YAML syntax at line 15"
-     *   - "Unknown task type 'invalid_task'"
-     *   - "Missing required field: document.namespace"
+     * Validation errors, empty when valid.
      *
      * @generated from field: repeated string errors = 3;
      */
     errors: string[];
     /**
-     * Non-fatal warnings
-     * Examples:
-     *   - "Environment variable API_KEY referenced but not defined"
-     *   - "Task 'fetchData' has no error handling"
+     * Non-fatal validation warnings.
      *
      * @generated from field: repeated string warnings = 4;
      */
     warnings: string[];
     /**
-     * When validation was performed
-     * Null if validation hasn't completed yet
+     * When the validation was performed.
      *
      * @generated from field: google.protobuf.Timestamp validated_at = 5;
      */
     validatedAt?: Timestamp;
     /**
-     * Temporal workflow ID for the validation workflow
-     * Format: "validate-workflow-{workflow_id}"
-     * Useful for tracking/debugging validation progress
+     * Validation process ID for tracking validation progress.
+     *
+     * @internal
+     * Temporal workflow ID. Format: "validate-workflow-{workflow_id}".
      *
      * @generated from field: string validation_workflow_id = 6;
      */
@@ -77,37 +72,36 @@ export declare const ServerlessWorkflowValidationSchema: GenMessage<ServerlessWo
  */
 export declare enum ValidationState {
     /**
-     * Unspecified state (should not be used)
+     * Default value, not a valid validation state.
      *
      * @generated from enum value: VALIDATION_STATE_UNSPECIFIED = 0;
      */
     VALIDATION_STATE_UNSPECIFIED = 0,
     /**
-     * Validation has been triggered but not yet completed
-     * This is the initial state when a workflow is created
+     * Validation is pending and has not yet completed.
      *
      * @generated from enum value: PENDING = 1;
      */
     PENDING = 1,
     /**
-     * Validation completed successfully - workflow structure is valid
-     * The generated YAML is stored and can be used for execution
+     * Validation completed successfully and the workflow structure is valid.
      *
      * @generated from enum value: VALID = 2;
      */
     VALID = 2,
     /**
-     * Validation completed but found errors - workflow structure is invalid
-     * The workflow cannot be executed until errors are fixed
-     * Errors are listed in the 'errors' field
+     * Validation completed but found errors in the workflow structure.
+     * Check the `errors` field for details.
      *
      * @generated from enum value: INVALID = 3;
      */
     INVALID = 3,
     /**
-     * Validation process itself failed (system error, not user error)
+     * Validation process failed due to a system error (not a user error).
+     * Retry validation or contact support.
+     *
+     * @internal
      * Examples: Temporal workflow crashed, activity timeout, etc.
-     * User should retry validation or contact support
      *
      * @generated from enum value: FAILED = 4;
      */