@stigmer/protos 0.5.1 → 1.0.0

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

@@ -1,6 +1,6 @@
 import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
 import type { EnvVarDeclaration } from "../../environment/v1/spec_pb.js";
-import type { WorkflowTaskKind } from "./enum_pb.js";
+import type { BudgetExceededPolicy, WorkflowTaskKind } from "./enum_pb.js";
 import type { JsonObject, Message } from "@bufbuild/protobuf";
 /**
  * Describes the file ai/stigmer/agentic/workflow/v1/spec.proto.
@@ -47,12 +47,81 @@ export type WorkflowSpec = Message<"ai.stigmer.agentic.workflow.v1.WorkflowSpec"
     env: {
         [key: string]: EnvVarDeclaration;
     };
+    /**
+     * Budget limits for this workflow execution.
+     * When set, the runtime (T13) enforces cost, token, and duration limits
+     * across all tasks. The existing org-level billing reservation system
+     * (AuthorizeExecution / ExecutionBillingSignal) remains the safety net
+     * for overall credit exhaustion; workflow budgets prevent individual
+     * workflows from consuming more than intended.
+     * Optional — when not set, no workflow-level budget is enforced.
+     *
+     * @generated from field: ai.stigmer.agentic.workflow.v1.WorkflowBudget budget = 5;
+     */
+    budget?: WorkflowBudget;
 };
 /**
  * Describes the message ai.stigmer.agentic.workflow.v1.WorkflowSpec.
  * Use `create(WorkflowSpecSchema)` to create a new message.
  */
 export declare const WorkflowSpecSchema: GenMessage<WorkflowSpec>;
+/**
+ * WorkflowBudget declares cost, token, and duration limits for a workflow execution.
+ *
+ * All cost fields use micro-USD (int64): 1 USD = 1,000,000 micros.
+ * This matches the billing domain convention (CostStamp.provider_cost_micros,
+ * CreditLedgerEntry.amount_micros, ExecutionReservation.reserved_micros).
+ *
+ * The runtime checks accumulated costs between task boundaries. Per-task
+ * limits (on LlmCallTaskConfig and AgentExecutionConfig) are checked first;
+ * then the remaining workflow budget is verified before the next task starts.
+ *
+ * Example YAML:
+ *   budget:
+ *     max_cost_micros: 5000000    # $5.00 per run
+ *     max_total_tokens: 500000
+ *     max_duration_seconds: 3600   # 1 hour
+ *     on_exceeded: budget_exceeded_terminate
+ *
+ * @generated from message ai.stigmer.agentic.workflow.v1.WorkflowBudget
+ */
+export type WorkflowBudget = Message<"ai.stigmer.agentic.workflow.v1.WorkflowBudget"> & {
+    /**
+     * Maximum total cost for this workflow execution in micro-USD.
+     * 1 USD = 1,000,000 micros. Example: 2000000 = $2.00.
+     * When exceeded, the on_exceeded policy is applied.
+     * Optional — when 0, no cost limit is enforced.
+     *
+     * @generated from field: int64 max_cost_micros = 1;
+     */
+    maxCostMicros: bigint;
+    /**
+     * Maximum total tokens (input + output) across all LLM/agent tasks.
+     * Optional — when 0, no token limit is enforced.
+     *
+     * @generated from field: int64 max_total_tokens = 2;
+     */
+    maxTotalTokens: bigint;
+    /**
+     * Maximum wall-clock duration for the entire workflow execution in seconds.
+     * Optional — when 0, no duration limit is enforced (Temporal's own
+     * workflow execution timeout still applies).
+     *
+     * @generated from field: int32 max_duration_seconds = 3;
+     */
+    maxDurationSeconds: number;
+    /**
+     * Policy when any budget limit is exceeded.
+     *
+     * @generated from field: ai.stigmer.agentic.workflow.v1.BudgetExceededPolicy on_exceeded = 4;
+     */
+    onExceeded: BudgetExceededPolicy;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.WorkflowBudget.
+ * Use `create(WorkflowBudgetSchema)` to create a new message.
+ */
+export declare const WorkflowBudgetSchema: GenMessage<WorkflowBudget>;
 /**
  * WorkflowDocument contains workflow-level metadata for versioning and identification.
  *
@@ -125,6 +194,8 @@ export declare const WorkflowDocumentSchema: GenMessage<WorkflowDocument>;
 export type WorkflowTask = Message<"ai.stigmer.agentic.workflow.v1.WorkflowTask"> & {
     /**
      * Task name/identifier (must be unique within workflow).
+     * Must be a valid C-style identifier: starts with a letter or underscore,
+     * followed by letters, digits, or underscores.
      *
      * @generated from field: string name = 1;
      */
@@ -153,6 +224,12 @@ export type WorkflowTask = Message<"ai.stigmer.agentic.workflow.v1.WorkflowTask"
      * - raise_error: ai.stigmer.agentic.workflow.v1.tasks.RaiseTaskConfig
      * - run_workflow: ai.stigmer.agentic.workflow.v1.tasks.RunTaskConfig
      * - agent_call: ai.stigmer.agentic.workflow.v1.tasks.AgentCallTaskConfig
+     * - llm_call: ai.stigmer.agentic.workflow.v1.tasks.LlmCallTaskConfig
+     * - transform: ai.stigmer.agentic.workflow.v1.tasks.TransformTaskConfig
+     * - human_input: ai.stigmer.agentic.workflow.v1.tasks.HumanInputTaskConfig
+     * - validate: ai.stigmer.agentic.workflow.v1.tasks.ValidateTaskConfig
+     * - emit_event: ai.stigmer.agentic.workflow.v1.tasks.EmitEventTaskConfig
+     * - notification: ai.stigmer.agentic.workflow.v1.tasks.NotificationTaskConfig
      *
      * See: apis/ai/stigmer/agentic/workflow/v1/tasks/*.proto for detailed schemas.
      *
@@ -173,6 +250,60 @@ export type WorkflowTask = Message<"ai.stigmer.agentic.workflow.v1.WorkflowTask"
      * @generated from field: ai.stigmer.agentic.workflow.v1.FlowControl flow = 5;
      */
     flow?: FlowControl;
+    /**
+     * Compensation tasks to execute if this task needs to be "undone."
+     *
+     * @internal
+     * Saga-style compensation for workflows with side effects. When a
+     * try_catch block catches an error, it can optionally run the
+     * compensation tasks for all already-completed tasks in reverse order.
+     *
+     * The compensation tasks receive the original task's output in their
+     * input context, allowing them to construct the appropriate undo
+     * operation (e.g., cancel an API call, delete a created resource,
+     * send a reversal notification).
+     *
+     * Only executed when:
+     * 1. The task completed successfully (failed tasks are not compensated)
+     * 2. A subsequent task within the same try_catch scope fails
+     * 3. The catch block is configured to run compensations
+     *
+     * YAML Example:
+     *   try:
+     *     - create_order:
+     *         call: http
+     *         with:
+     *           method: POST
+     *           endpoint: { uri: "https://api.example.com/orders" }
+     *           body: { ... }
+     *         compensate:
+     *           - cancel_order:
+     *               call: http
+     *               with:
+     *                 method: DELETE
+     *                 endpoint: { uri: "https://api.example.com/orders/${ $context.create_order.id }" }
+     *         export:
+     *           as: "${ . }"
+     *     - charge_payment:
+     *         call: http
+     *         with:
+     *           method: POST
+     *           endpoint: { uri: "https://api.example.com/payments" }
+     *   catch:
+     *     as: error
+     *     compensate: true
+     *     do:
+     *       - log_failure:
+     *           call: notification
+     *           with: ...
+     *
+     * Optional - when empty, this task has no compensation action.
+     *
+     * @since T17 (Advanced Agentic Orchestration)
+     *
+     * @generated from field: repeated ai.stigmer.agentic.workflow.v1.WorkflowTask compensate = 6;
+     */
+    compensate: WorkflowTask[];
 };
 /**
  * Describes the message ai.stigmer.agentic.workflow.v1.WorkflowTask.

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

@@ -10,30 +10,35 @@ import { file_google_protobuf_struct } from "@bufbuild/protobuf/wkt";
 /**
  * Describes the file ai/stigmer/agentic/workflow/v1/spec.proto.
  */
-export const file_ai_stigmer_agentic_workflow_v1_spec = /*@__PURE__*/ fileDesc("CilhaS9zdGlnbWVyL2FnZW50aWMvd29ya2Zsb3cvdjEvc3BlYy5wcm90bxIeYWkuc3RpZ21lci5hZ2VudGljLndvcmtmbG93LnYxItwCCgxXb3JrZmxvd1NwZWMSEwoLZGVzY3JpcHRpb24YASABKAkSSgoIZG9jdW1lbnQYAiABKAsyMC5haS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3cudjEuV29ya2Zsb3dEb2N1bWVudEIGukgDyAEBEkUKBXRhc2tzGAMgAygLMiwuYWkuc3RpZ21lci5hZ2VudGljLndvcmtmbG93LnYxLldvcmtmbG93VGFza0IIukgFkgECCAESQgoDZW52GAQgAygLMjUuYWkuc3RpZ21lci5hZ2VudGljLndvcmtmbG93LnYxLldvcmtmbG93U3BlYy5FbnZFbnRyeRpgCghFbnZFbnRyeRILCgNrZXkYASABKAkSQwoFdmFsdWUYAiABKAsyNC5haS5zdGlnbWVyLmFnZW50aWMuZW52aXJvbm1lbnQudjEuRW52VmFyRGVjbGFyYXRpb246AjgBIpABChBXb3JrZmxvd0RvY3VtZW50Eh0KA2RzbBgBIAEoCUIQukgNcgsyCV4xXC4wXC4wJBIZCgluYW1lc3BhY2UYAiABKAlCBrpIA8gBARIUCgRuYW1lGAMgASgJQga6SAPIAQESFwoHdmVyc2lvbhgEIAEoCUIGukgDyAEBEhMKC2Rlc2NyaXB0aW9uGAUgASgJIp0CCgxXb3JrZmxvd1Rhc2sSFAoEbmFtZRgBIAEoCUIGukgDyAEBEkYKBGtpbmQYAiABKA4yMC5haS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3cudjEuV29ya2Zsb3dUYXNrS2luZEIGukgDyAEBEjwKC3Rhc2tfY29uZmlnGAMgASgLMhcuZ29vZ2xlLnByb3RvYnVmLlN0cnVjdEIOukgDyAEB6oUsBGtpbmQSNgoGZXhwb3J0GAQgASgLMiYuYWkuc3RpZ21lci5hZ2VudGljLndvcmtmbG93LnYxLkV4cG9ydBI5CgRmbG93GAUgASgLMisuYWkuc3RpZ21lci5hZ2VudGljLndvcmtmbG93LnYxLkZsb3dDb250cm9sIh0KBkV4cG9ydBITCgJhcxgBIAEoCUIHukgEcgIQASIbCgtGbG93Q29udHJvbBIMCgR0aGVuGAEgASgJYgZwcm90bzM", [file_ai_stigmer_agentic_environment_v1_spec, file_ai_stigmer_agentic_workflow_v1_enum, file_ai_stigmer_commons_apiresource_field_options, file_buf_validate_validate, file_google_protobuf_struct]);
+export const file_ai_stigmer_agentic_workflow_v1_spec = /*@__PURE__*/ fileDesc("CilhaS9zdGlnbWVyL2FnZW50aWMvd29ya2Zsb3cvdjEvc3BlYy5wcm90bxIeYWkuc3RpZ21lci5hZ2VudGljLndvcmtmbG93LnYxIpwDCgxXb3JrZmxvd1NwZWMSEwoLZGVzY3JpcHRpb24YASABKAkSSgoIZG9jdW1lbnQYAiABKAsyMC5haS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3cudjEuV29ya2Zsb3dEb2N1bWVudEIGukgDyAEBEkUKBXRhc2tzGAMgAygLMiwuYWkuc3RpZ21lci5hZ2VudGljLndvcmtmbG93LnYxLldvcmtmbG93VGFza0IIukgFkgECCAESQgoDZW52GAQgAygLMjUuYWkuc3RpZ21lci5hZ2VudGljLndvcmtmbG93LnYxLldvcmtmbG93U3BlYy5FbnZFbnRyeRI+CgZidWRnZXQYBSABKAsyLi5haS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3cudjEuV29ya2Zsb3dCdWRnZXQaYAoIRW52RW50cnkSCwoDa2V5GAEgASgJEkMKBXZhbHVlGAIgASgLMjQuYWkuc3RpZ21lci5hZ2VudGljLmVudmlyb25tZW50LnYxLkVudlZhckRlY2xhcmF0aW9uOgI4ASKsAQoOV29ya2Zsb3dCdWRnZXQSFwoPbWF4X2Nvc3RfbWljcm9zGAEgASgDEhgKEG1heF90b3RhbF90b2tlbnMYAiABKAMSHAoUbWF4X2R1cmF0aW9uX3NlY29uZHMYAyABKAUSSQoLb25fZXhjZWVkZWQYBCABKA4yNC5haS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3cudjEuQnVkZ2V0RXhjZWVkZWRQb2xpY3kikAEKEFdvcmtmbG93RG9jdW1lbnQSHQoDZHNsGAEgASgJQhC6SA1yCzIJXjFcLjBcLjAkEhkKCW5hbWVzcGFjZRgCIAEoCUIGukgDyAEBEhQKBG5hbWUYAyABKAlCBrpIA8gBARIXCgd2ZXJzaW9uGAQgASgJQga6SAPIAQESEwoLZGVzY3JpcHRpb24YBSABKAki+gIKDFdvcmtmbG93VGFzaxIvCgRuYW1lGAEgASgJQiG6SB5yHBABMhheW2EtekEtWl9dW2EtekEtWjAtOV9dKiQSRgoEa2luZBgCIAEoDjIwLmFpLnN0aWdtZXIuYWdlbnRpYy53b3JrZmxvdy52MS5Xb3JrZmxvd1Rhc2tLaW5kQga6SAPIAQESPAoLdGFza19jb25maWcYAyABKAsyFy5nb29nbGUucHJvdG9idWYuU3RydWN0Qg66SAPIAQHqhSwEa2luZBI2CgZleHBvcnQYBCABKAsyJi5haS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3cudjEuRXhwb3J0EjkKBGZsb3cYBSABKAsyKy5haS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3cudjEuRmxvd0NvbnRyb2wSQAoKY29tcGVuc2F0ZRgGIAMoCzIsLmFpLnN0aWdtZXIuYWdlbnRpYy53b3JrZmxvdy52MS5Xb3JrZmxvd1Rhc2siHQoGRXhwb3J0EhMKAmFzGAEgASgJQge6SARyAhABIhsKC0Zsb3dDb250cm9sEgwKBHRoZW4YASABKAliBnByb3RvMw", [file_ai_stigmer_agentic_environment_v1_spec, file_ai_stigmer_agentic_workflow_v1_enum, file_ai_stigmer_commons_apiresource_field_options, file_buf_validate_validate, file_google_protobuf_struct]);
 /**
  * Describes the message ai.stigmer.agentic.workflow.v1.WorkflowSpec.
  * Use `create(WorkflowSpecSchema)` to create a new message.
  */
 export const WorkflowSpecSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflow_v1_spec, 0);
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.WorkflowBudget.
+ * Use `create(WorkflowBudgetSchema)` to create a new message.
+ */
+export const WorkflowBudgetSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflow_v1_spec, 1);
 /**
  * Describes the message ai.stigmer.agentic.workflow.v1.WorkflowDocument.
  * Use `create(WorkflowDocumentSchema)` to create a new message.
  */
-export const WorkflowDocumentSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflow_v1_spec, 1);
+export const WorkflowDocumentSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflow_v1_spec, 2);
 /**
  * Describes the message ai.stigmer.agentic.workflow.v1.WorkflowTask.
  * Use `create(WorkflowTaskSchema)` to create a new message.
  */
-export const WorkflowTaskSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflow_v1_spec, 2);
+export const WorkflowTaskSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflow_v1_spec, 3);
 /**
  * Describes the message ai.stigmer.agentic.workflow.v1.Export.
  * Use `create(ExportSchema)` to create a new message.
  */
-export const ExportSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflow_v1_spec, 3);
+export const ExportSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflow_v1_spec, 4);
 /**
  * Describes the message ai.stigmer.agentic.workflow.v1.FlowControl.
  * Use `create(FlowControlSchema)` to create a new message.
  */
-export const FlowControlSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflow_v1_spec, 4);
+export const FlowControlSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflow_v1_spec, 5);
 //# sourceMappingURL=spec_pb.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"spec_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/workflow/v1/spec_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,yHAAyH;AACzH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,2CAA2C,EAAE,MAAM,iCAAiC,CAAC;AAE9F,OAAO,EAAE,wCAAwC,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,iDAAiD,EAAE,MAAM,kDAAkD,CAAC;AACrH,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AACxF,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAGrE;;GAEG;AACH,MAAM,CAAC,MAAM,wCAAwC,GAAY,aAAa,CAC5E,QAAQ,CAAC,ytCAAytC,EAAE,CAAC,2CAA2C,EAAE,wCAAwC,EAAE,iDAAiD,EAAE,0BAA0B,EAAE,2BAA2B,CAAC,CAAC,CAAC;AA8C36C;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6B,aAAa,CACvE,WAAW,CAAC,wCAAwC,EAAE,CAAC,CAAC,CAAC;AA+C3D;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAiC,aAAa,CAC/E,WAAW,CAAC,wCAAwC,EAAE,CAAC,CAAC,CAAC;AAmF3D;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6B,aAAa,CACvE,WAAW,CAAC,wCAAwC,EAAE,CAAC,CAAC,CAAC;AAwB3D;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAuB,aAAa,CAC3D,WAAW,CAAC,wCAAwC,EAAE,CAAC,CAAC,CAAC;AAwB3D;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA4B,aAAa,CACrE,WAAW,CAAC,wCAAwC,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"spec_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/workflow/v1/spec_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,yHAAyH;AACzH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,2CAA2C,EAAE,MAAM,iCAAiC,CAAC;AAE9F,OAAO,EAAE,wCAAwC,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,iDAAiD,EAAE,MAAM,kDAAkD,CAAC;AACrH,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AACxF,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAGrE;;GAEG;AACH,MAAM,CAAC,MAAM,wCAAwC,GAAY,aAAa,CAC5E,QAAQ,CAAC,opDAAopD,EAAE,CAAC,2CAA2C,EAAE,wCAAwC,EAAE,iDAAiD,EAAE,0BAA0B,EAAE,2BAA2B,CAAC,CAAC,CAAC;AA2Dt2D;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6B,aAAa,CACvE,WAAW,CAAC,wCAAwC,EAAE,CAAC,CAAC,CAAC;AA0D3D;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA+B,aAAa,CAC3E,WAAW,CAAC,wCAAwC,EAAE,CAAC,CAAC,CAAC;AA+C3D;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAiC,aAAa,CAC/E,WAAW,CAAC,wCAAwC,EAAE,CAAC,CAAC,CAAC;AAkJ3D;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6B,aAAa,CACvE,WAAW,CAAC,wCAAwC,EAAE,CAAC,CAAC,CAAC;AAwB3D;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAuB,aAAa,CAC3D,WAAW,CAAC,wCAAwC,EAAE,CAAC,CAAC,CAAC;AAwB3D;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA4B,aAAa,CACrE,WAAW,CAAC,wCAAwC,EAAE,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,430 @@
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
+import type { WorkflowTaskKind } from "./enum_pb.js";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file ai/stigmer/agentic/workflow/v1/task_kind_descriptor.proto.
+ */
+export declare const file_ai_stigmer_agentic_workflow_v1_task_kind_descriptor: GenFile;
+/**
+ * TaskFieldGroup defines a logical grouping of fields for UI form rendering.
+ *
+ * Fields within the same group are rendered together in a collapsible section.
+ * Groups are ordered by their position in the TaskKindDescriptor.field_groups list.
+ *
+ * @since T04 (Task Schema Registry)
+ *
+ * @generated from message ai.stigmer.agentic.workflow.v1.TaskFieldGroup
+ */
+export type TaskFieldGroup = Message<"ai.stigmer.agentic.workflow.v1.TaskFieldGroup"> & {
+    /**
+     * Group identifier matching TaskFieldDescriptor.group_id.
+     *
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    /**
+     * Human-readable label for the group section header.
+     *
+     * @generated from field: string display_name = 2;
+     */
+    displayName: string;
+    /**
+     * Optional description shown below the group header.
+     *
+     * @generated from field: string description = 3;
+     */
+    description: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.TaskFieldGroup.
+ * Use `create(TaskFieldGroupSchema)` to create a new message.
+ */
+export declare const TaskFieldGroupSchema: GenMessage<TaskFieldGroup>;
+/**
+ * TaskFieldDescriptor describes a single field in a task configuration message.
+ *
+ * Provides enough metadata for UI form renderers to generate appropriate
+ * input controls, validation messages, and documentation without needing
+ * access to the raw proto descriptor.
+ *
+ * @since T04 (Task Schema Registry)
+ *
+ * @generated from message ai.stigmer.agentic.workflow.v1.TaskFieldDescriptor
+ */
+export type TaskFieldDescriptor = Message<"ai.stigmer.agentic.workflow.v1.TaskFieldDescriptor"> & {
+    /**
+     * Proto field name (snake_case, matching the proto definition).
+     *
+     * @generated from field: string name = 1;
+     */
+    name: string;
+    /**
+     * Human-readable label for form rendering.
+     * When empty, the UI derives it from the name (e.g., "system_prompt" -> "System Prompt").
+     *
+     * @generated from field: string display_name = 2;
+     */
+    displayName: string;
+    /**
+     * Field description from proto comments. Shown as help text in forms.
+     *
+     * @generated from field: string description = 3;
+     */
+    description: string;
+    /**
+     * Data type for rendering the appropriate form control.
+     *
+     * @generated from field: ai.stigmer.agentic.workflow.v1.TaskFieldType type = 4;
+     */
+    type: TaskFieldType;
+    /**
+     * Whether the field is required (from buf.validate annotations).
+     *
+     * @generated from field: bool required = 5;
+     */
+    required: boolean;
+    /**
+     * Whether the field accepts ${ } expression interpolation.
+     * Derived from the is_expression proto annotation.
+     *
+     * @generated from field: bool is_expression = 6;
+     */
+    isExpression: boolean;
+    /**
+     * Default value as a JSON-encoded string.
+     * Empty string means no default (field is unset by default).
+     *
+     * @generated from field: string default_value = 7;
+     */
+    defaultValue: string;
+    /**
+     * Valid enum values when type is TASK_FIELD_TYPE_ENUM.
+     *
+     * @generated from field: repeated string enum_values = 8;
+     */
+    enumValues: string[];
+    /**
+     * JSON Schema fragment for this field's validation.
+     * Enables client-side pre-validation without the full registry.
+     *
+     * @generated from field: string json_schema_fragment = 9;
+     */
+    jsonSchemaFragment: string;
+    /**
+     * Group this field belongs to for form section rendering.
+     * References TaskFieldGroup.id in the parent descriptor.
+     *
+     * @generated from field: string group_id = 10;
+     */
+    groupId: string;
+    /**
+     * Proto field number (for stable identification across renames).
+     *
+     * @generated from field: int32 field_number = 11;
+     */
+    fieldNumber: number;
+    /**
+     * For TASK_FIELD_TYPE_REPEATED: the element type.
+     * For TASK_FIELD_TYPE_MESSAGE: the nested message proto type name.
+     *
+     * @generated from field: string element_type = 12;
+     */
+    elementType: string;
+    /**
+     * Validation constraints as human-readable descriptions.
+     * Examples: "min: 1, max: 5", "pattern: ^1\\.0\\.0$", "min_items: 1"
+     *
+     * @generated from field: repeated string validation_hints = 13;
+     */
+    validationHints: string[];
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.TaskFieldDescriptor.
+ * Use `create(TaskFieldDescriptorSchema)` to create a new message.
+ */
+export declare const TaskFieldDescriptorSchema: GenMessage<TaskFieldDescriptor>;
+/**
+ * TaskKindDescriptor provides complete metadata for a single workflow task kind.
+ *
+ * This is the primary output of the Task Schema Registry — one descriptor
+ * per WorkflowTaskKind enum value. Consumers use these descriptors to:
+ * - Render task palettes in the visual builder (category, icon, display_name)
+ * - Generate configuration forms (fields, field_groups)
+ * - Power YAML editor autocomplete (config_json_schema)
+ * - Validate task configs client-side (config_json_schema)
+ * - Display task output shapes in the execution viewer (output_json_schema)
+ * - Generate documentation (description, yaml_examples, documentation_url)
+ *
+ * @since T04 (Task Schema Registry)
+ *
+ * @generated from message ai.stigmer.agentic.workflow.v1.TaskKindDescriptor
+ */
+export type TaskKindDescriptor = Message<"ai.stigmer.agentic.workflow.v1.TaskKindDescriptor"> & {
+    /**
+     * The task kind this descriptor describes.
+     *
+     * @generated from field: ai.stigmer.agentic.workflow.v1.WorkflowTaskKind kind = 1;
+     */
+    kind: WorkflowTaskKind;
+    /**
+     * Human-readable display name for UI rendering.
+     * Examples: "LLM Call", "Human Input", "HTTP Call", "Switch Case"
+     *
+     * @generated from field: string display_name = 2;
+     */
+    displayName: string;
+    /**
+     * One-line description of what this task kind does.
+     *
+     * @generated from field: string description = 3;
+     */
+    description: string;
+    /**
+     * Functional category for palette grouping and filtering.
+     *
+     * @generated from field: ai.stigmer.agentic.workflow.v1.TaskKindCategory category = 4;
+     */
+    category: TaskKindCategory;
+    /**
+     * Lucide icon name for UI rendering.
+     * Examples: "brain", "user-check", "globe", "git-branch"
+     *
+     * @generated from field: string icon = 5;
+     */
+    icon: string;
+    /**
+     * Fully-qualified proto message type for the task config.
+     * Example: "ai.stigmer.agentic.workflow.v1.tasks.LlmCallTaskConfig"
+     *
+     * @generated from field: string config_proto_type = 6;
+     */
+    configProtoType: string;
+    /**
+     * Ordered field descriptors for form rendering.
+     * Fields are ordered by their intended display sequence (not proto field number).
+     *
+     * @generated from field: repeated ai.stigmer.agentic.workflow.v1.TaskFieldDescriptor fields = 7;
+     */
+    fields: TaskFieldDescriptor[];
+    /**
+     * Logical field groups for form section rendering.
+     *
+     * @generated from field: repeated ai.stigmer.agentic.workflow.v1.TaskFieldGroup field_groups = 8;
+     */
+    fieldGroups: TaskFieldGroup[];
+    /**
+     * JSON Schema (draft 2020-12) for the task_config Struct payload.
+     * Serialized as a JSON string. Used by Monaco editor for validation
+     * and autocomplete, and by form libraries (RJSF) for form generation.
+     *
+     * @generated from field: string config_json_schema = 9;
+     */
+    configJsonSchema: string;
+    /**
+     * JSON Schema describing the task's output shape.
+     * Serialized as a JSON string. Used by the execution viewer to
+     * render typed output inspection panels.
+     *
+     * @generated from field: string output_json_schema = 10;
+     */
+    outputJsonSchema: string;
+    /**
+     * YAML code examples demonstrating common usage patterns.
+     * Each entry is a complete, self-contained YAML snippet.
+     *
+     * @generated from field: repeated string yaml_examples = 11;
+     */
+    yamlExamples: string[];
+    /**
+     * Documentation URL path (relative to docs root).
+     * Example: "/docs/workflow/tasks/llm-call"
+     *
+     * @generated from field: string documentation_url = 12;
+     */
+    documentationUrl: string;
+    /**
+     * Whether this task kind invokes AI models (agent_call, llm_call).
+     * UI uses this to show cost indicators and model selection hints.
+     *
+     * @generated from field: bool is_ai_native = 13;
+     */
+    isAiNative: boolean;
+    /**
+     * Whether this task kind requires external service connectivity.
+     * UI uses this to show connectivity warnings during offline editing.
+     *
+     * @generated from field: bool requires_external_service = 14;
+     */
+    requiresExternalService: boolean;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.TaskKindDescriptor.
+ * Use `create(TaskKindDescriptorSchema)` to create a new message.
+ */
+export declare const TaskKindDescriptorSchema: GenMessage<TaskKindDescriptor>;
+/**
+ * GetTaskKindRegistryRequest is the request message for retrieving the
+ * complete task kind registry.
+ *
+ * @generated from message ai.stigmer.agentic.workflow.v1.GetTaskKindRegistryRequest
+ */
+export type GetTaskKindRegistryRequest = Message<"ai.stigmer.agentic.workflow.v1.GetTaskKindRegistryRequest"> & {};
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.GetTaskKindRegistryRequest.
+ * Use `create(GetTaskKindRegistryRequestSchema)` to create a new message.
+ */
+export declare const GetTaskKindRegistryRequestSchema: GenMessage<GetTaskKindRegistryRequest>;
+/**
+ * GetTaskKindRegistryResponse returns the full set of task kind descriptors.
+ *
+ * @generated from message ai.stigmer.agentic.workflow.v1.GetTaskKindRegistryResponse
+ */
+export type GetTaskKindRegistryResponse = Message<"ai.stigmer.agentic.workflow.v1.GetTaskKindRegistryResponse"> & {
+    /**
+     * All registered task kind descriptors, one per WorkflowTaskKind value.
+     * Excludes workflow_task_kind_unspecified.
+     *
+     * @generated from field: repeated ai.stigmer.agentic.workflow.v1.TaskKindDescriptor descriptors = 1;
+     */
+    descriptors: TaskKindDescriptor[];
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.GetTaskKindRegistryResponse.
+ * Use `create(GetTaskKindRegistryResponseSchema)` to create a new message.
+ */
+export declare const GetTaskKindRegistryResponseSchema: GenMessage<GetTaskKindRegistryResponse>;
+/**
+ * TaskKindCategory classifies task kinds by their functional role in a workflow.
+ *
+ * Used by the UI to render task palettes with grouped categories, and by
+ * documentation generators to organize task reference pages.
+ *
+ * @since T04 (Task Schema Registry)
+ *
+ * @generated from enum ai.stigmer.agentic.workflow.v1.TaskKindCategory
+ */
+export declare enum TaskKindCategory {
+    /**
+     * @generated from enum value: TASK_KIND_CATEGORY_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * Control flow tasks that direct execution order.
+     * Members: switch_case, for_each, fork, try_catch, wait
+     *
+     * @generated from enum value: TASK_KIND_CATEGORY_CONTROL_FLOW = 1;
+     */
+    CONTROL_FLOW = 1,
+    /**
+     * Tasks that invoke external services or sub-workflows.
+     * Members: http_call, grpc_call, activity_call, run_workflow
+     *
+     * @generated from enum value: TASK_KIND_CATEGORY_INVOCATION = 2;
+     */
+    INVOCATION = 2,
+    /**
+     * AI-native tasks that invoke language models or agents.
+     * Members: agent_call, llm_call
+     *
+     * @generated from enum value: TASK_KIND_CATEGORY_AI = 3;
+     */
+    AI = 3,
+    /**
+     * Tasks that manipulate, validate, or transform data.
+     * Members: set_vars, transform, validate
+     *
+     * @generated from enum value: TASK_KIND_CATEGORY_DATA = 4;
+     */
+    DATA = 4,
+    /**
+     * Tasks that require human interaction to proceed.
+     * Members: human_input
+     *
+     * @generated from enum value: TASK_KIND_CATEGORY_GOVERNANCE = 5;
+     */
+    GOVERNANCE = 5,
+    /**
+     * Tasks that emit, listen for, or route events and notifications.
+     * Members: listen, emit_event, notification, raise_error
+     *
+     * @generated from enum value: TASK_KIND_CATEGORY_EVENT = 6;
+     */
+    EVENT = 6
+}
+/**
+ * Describes the enum ai.stigmer.agentic.workflow.v1.TaskKindCategory.
+ */
+export declare const TaskKindCategorySchema: GenEnum<TaskKindCategory>;
+/**
+ * TaskFieldType represents the data type of a task configuration field
+ * as understood by UI form renderers and schema validators.
+ *
+ * @since T04 (Task Schema Registry)
+ *
+ * @generated from enum ai.stigmer.agentic.workflow.v1.TaskFieldType
+ */
+export declare enum TaskFieldType {
+    /**
+     * @generated from enum value: TASK_FIELD_TYPE_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * Plain string value.
+     *
+     * @generated from enum value: TASK_FIELD_TYPE_STRING = 1;
+     */
+    STRING = 1,
+    /**
+     * 32-bit integer.
+     *
+     * @generated from enum value: TASK_FIELD_TYPE_INT32 = 2;
+     */
+    INT32 = 2,
+    /**
+     * 32-bit floating point.
+     *
+     * @generated from enum value: TASK_FIELD_TYPE_FLOAT = 3;
+     */
+    FLOAT = 3,
+    /**
+     * Boolean true/false.
+     *
+     * @generated from enum value: TASK_FIELD_TYPE_BOOL = 4;
+     */
+    BOOL = 4,
+    /**
+     * Enumeration — valid values listed in TaskFieldDescriptor.enum_values.
+     *
+     * @generated from enum value: TASK_FIELD_TYPE_ENUM = 5;
+     */
+    ENUM = 5,
+    /**
+     * Structured JSON object (google.protobuf.Struct in proto).
+     * Used for JSON Schema fields, form schemas, event data payloads.
+     *
+     * @generated from enum value: TASK_FIELD_TYPE_STRUCT = 6;
+     */
+    STRUCT = 6,
+    /**
+     * Repeated (array) of a scalar or message type.
+     *
+     * @generated from enum value: TASK_FIELD_TYPE_REPEATED = 7;
+     */
+    REPEATED = 7,
+    /**
+     * Map from string keys to string values.
+     *
+     * @generated from enum value: TASK_FIELD_TYPE_MAP = 8;
+     */
+    MAP = 8,
+    /**
+     * Nested message type — field contains a sub-object with its own fields.
+     *
+     * @generated from enum value: TASK_FIELD_TYPE_MESSAGE = 9;
+     */
+    MESSAGE = 9
+}
+/**
+ * Describes the enum ai.stigmer.agentic.workflow.v1.TaskFieldType.
+ */
+export declare const TaskFieldTypeSchema: GenEnum<TaskFieldType>;