@stigmer/protos 0.5.1 → 1.0.0

package/ai/stigmer/agentic/workflow/v1/tasks/transform_pb.js

@@ -0,0 +1,65 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts,import_extension=js"
+// @generated from file ai/stigmer/agentic/workflow/v1/tasks/transform.proto (package ai.stigmer.agentic.workflow.v1.tasks, syntax proto3)
+/* eslint-disable */
+import { enumDesc, fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv1";
+import { file_ai_stigmer_commons_apiresource_field_options } from "../../../../commons/apiresource/field_options_pb.js";
+import { file_buf_validate_validate } from "../../../../../../buf/validate/validate_pb.js";
+/**
+ * Describes the file ai/stigmer/agentic/workflow/v1/tasks/transform.proto.
+ */
+export const file_ai_stigmer_agentic_workflow_v1_tasks_transform = /*@__PURE__*/ fileDesc("CjRhaS9zdGlnbWVyL2FnZW50aWMvd29ya2Zsb3cvdjEvdGFza3MvdHJhbnNmb3JtLnByb3RvEiRhaS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3cudjEudGFza3MirwEKE1RyYW5zZm9ybVRhc2tDb25maWcSVAoGZW5naW5lGAEgASgOMjUuYWkuc3RpZ21lci5hZ2VudGljLndvcmtmbG93LnYxLnRhc2tzLlRyYW5zZm9ybUVuZ2luZUINukgKyAEBggEEEAEgABIeCgpleHByZXNzaW9uGAIgASgJQgq6SAfIAQFyAhABEhMKBWlucHV0GAMgASgJQgTYhSwBOg3qiywJdHJhbnNmb3JtKokBCg9UcmFuc2Zvcm1FbmdpbmUSIAocVFJBTlNGT1JNX0VOR0lORV9VTlNQRUNJRklFRBAAEhcKE1RSQU5TRk9STV9FTkdJTkVfSlEQARIcChhUUkFOU0ZPUk1fRU5HSU5FX0pTT05BVEEQAhIdChlUUkFOU0ZPUk1fRU5HSU5FX1RFTVBMQVRFEANiBnByb3RvMw", [file_ai_stigmer_commons_apiresource_field_options, file_buf_validate_validate]);
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.tasks.TransformTaskConfig.
+ * Use `create(TransformTaskConfigSchema)` to create a new message.
+ */
+export const TransformTaskConfigSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflow_v1_tasks_transform, 0);
+/**
+ * TransformEngine enumerates the supported transformation engines.
+ *
+ * Each engine has different syntax and capabilities:
+ * - JQ: full JQ expression language for JSON-to-JSON transformation
+ * - JSONata: JSONata expression language (JSON query and transformation)
+ * - TEMPLATE: Go text/template with ${ } expression interpolation for
+ *   string-building use cases (email bodies, API payloads, log messages)
+ *
+ * @generated from enum ai.stigmer.agentic.workflow.v1.tasks.TransformEngine
+ */
+export var TransformEngine;
+(function (TransformEngine) {
+    /**
+     * Default value, not a valid engine. Must be explicitly set.
+     *
+     * @generated from enum value: TRANSFORM_ENGINE_UNSPECIFIED = 0;
+     */
+    TransformEngine[TransformEngine["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    /**
+     * JQ expression engine.
+     * Full JQ syntax for filtering, projecting, and reshaping JSON data.
+     * Example: '{name: .customer.full_name, severity: .triage.severity}'
+     *
+     * @generated from enum value: TRANSFORM_ENGINE_JQ = 1;
+     */
+    TransformEngine[TransformEngine["JQ"] = 1] = "JQ";
+    /**
+     * JSONata expression engine.
+     * JSONata syntax for JSON query and transformation.
+     * Example: '{"name": customer.full_name, "severity": triage.severity}'
+     *
+     * @generated from enum value: TRANSFORM_ENGINE_JSONATA = 2;
+     */
+    TransformEngine[TransformEngine["JSONATA"] = 2] = "JSONATA";
+    /**
+     * Template engine using Go's text/template syntax.
+     * Supports ${ } expression interpolation for input variable references.
+     * Best for building strings (email bodies, messages, API payloads).
+     * Example: 'Ticket {{ .ticket_id }} classified as {{ .severity }}'
+     *
+     * @generated from enum value: TRANSFORM_ENGINE_TEMPLATE = 3;
+     */
+    TransformEngine[TransformEngine["TEMPLATE"] = 3] = "TEMPLATE";
+})(TransformEngine || (TransformEngine = {}));
+/**
+ * Describes the enum ai.stigmer.agentic.workflow.v1.tasks.TransformEngine.
+ */
+export const TransformEngineSchema = /*@__PURE__*/ enumDesc(file_ai_stigmer_agentic_workflow_v1_tasks_transform, 0);
+//# sourceMappingURL=transform_pb.js.map

package/ai/stigmer/agentic/workflow/v1/tasks/transform_pb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform_pb.js","sourceRoot":"","sources":["../../../../../../../ai/stigmer/agentic/workflow/v1/tasks/transform_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,0IAA0I;AAC1I,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC/E,OAAO,EAAE,iDAAiD,EAAE,MAAM,qDAAqD,CAAC;AACxH,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AAG3F;;GAEG;AACH,MAAM,CAAC,MAAM,mDAAmD,GAAY,aAAa,CACvF,QAAQ,CAAC,gjBAAgjB,EAAE,CAAC,iDAAiD,EAAE,0BAA0B,CAAC,CAAC,CAAC;AAsE9oB;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAoC,aAAa,CACrF,WAAW,CAAC,mDAAmD,EAAE,CAAC,CAAC,CAAC;AAEtE;;;;;;;;;;GAUG;AACH,MAAM,CAAN,IAAY,eAmCX;AAnCD,WAAY,eAAe;IACzB;;;;OAIG;IACH,mEAAe,CAAA;IAEf;;;;;;OAMG;IACH,iDAAM,CAAA;IAEN;;;;;;OAMG;IACH,2DAAW,CAAA;IAEX;;;;;;;OAOG;IACH,6DAAY,CAAA;AACd,CAAC,EAnCW,eAAe,KAAf,eAAe,QAmC1B;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA6B,aAAa,CAC1E,QAAQ,CAAC,mDAAmD,EAAE,CAAC,CAAC,CAAC"}

package/ai/stigmer/agentic/workflow/v1/tasks/try_pb.d.ts

@@ -71,6 +71,25 @@ export type CatchBlock = Message<"ai.stigmer.agentic.workflow.v1.tasks.CatchBloc
      * @generated from field: repeated ai.stigmer.agentic.workflow.v1.WorkflowTask do = 2;
      */
     do: WorkflowTask[];
+    /**
+     * Whether to run compensation tasks for already-completed try tasks
+     * before executing the catch do block.
+     *
+     * When true, the runtime walks the compensation stack (completed tasks
+     * that declared a `compensate` block) in reverse order and executes
+     * each task's compensation actions. After all compensations complete
+     * (or fail), the catch `do` block runs as normal.
+     *
+     * Compensation failures do not prevent the catch block from running.
+     * They are logged and included in the task output for diagnostics.
+     *
+     * Default: false (no compensation — preserves pre-T17 behavior).
+     *
+     * @since T17 (Advanced Agentic Orchestration)
+     *
+     * @generated from field: bool compensate = 3;
+     */
+    compensate: boolean;
 };
 /**
  * Describes the message ai.stigmer.agentic.workflow.v1.tasks.CatchBlock.

package/ai/stigmer/agentic/workflow/v1/tasks/try_pb.js

@@ -8,7 +8,7 @@ import { file_buf_validate_validate } from "../../../../../../buf/validate/valid
 /**
  * Describes the file ai/stigmer/agentic/workflow/v1/tasks/try.proto.
  */
-export const file_ai_stigmer_agentic_workflow_v1_tasks_try = /*@__PURE__*/ fileDesc("Ci5haS9zdGlnbWVyL2FnZW50aWMvd29ya2Zsb3cvdjEvdGFza3MvdHJ5LnByb3RvEiRhaS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3cudjEudGFza3MipAEKDVRyeVRhc2tDb25maWcSQwoDdHJ5GAEgAygLMiwuYWkuc3RpZ21lci5hZ2VudGljLndvcmtmbG93LnYxLldvcmtmbG93VGFza0IIukgFkgECCAESPwoFY2F0Y2gYAiABKAsyMC5haS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3cudjEudGFza3MuQ2F0Y2hCbG9jazoN6ossCXRyeV9jYXRjaCJcCgpDYXRjaEJsb2NrEgoKAmFzGAEgASgJEkIKAmRvGAIgAygLMiwuYWkuc3RpZ21lci5hZ2VudGljLndvcmtmbG93LnYxLldvcmtmbG93VGFza0IIukgFkgECCAFiBnByb3RvMw", [file_ai_stigmer_agentic_workflow_v1_spec, file_ai_stigmer_commons_apiresource_field_options, file_buf_validate_validate]);
+export const file_ai_stigmer_agentic_workflow_v1_tasks_try = /*@__PURE__*/ fileDesc("Ci5haS9zdGlnbWVyL2FnZW50aWMvd29ya2Zsb3cvdjEvdGFza3MvdHJ5LnByb3RvEiRhaS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3cudjEudGFza3MipAEKDVRyeVRhc2tDb25maWcSQwoDdHJ5GAEgAygLMiwuYWkuc3RpZ21lci5hZ2VudGljLndvcmtmbG93LnYxLldvcmtmbG93VGFza0IIukgFkgECCAESPwoFY2F0Y2gYAiABKAsyMC5haS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3cudjEudGFza3MuQ2F0Y2hCbG9jazoN6ossCXRyeV9jYXRjaCJwCgpDYXRjaEJsb2NrEgoKAmFzGAEgASgJEkIKAmRvGAIgAygLMiwuYWkuc3RpZ21lci5hZ2VudGljLndvcmtmbG93LnYxLldvcmtmbG93VGFza0IIukgFkgECCAESEgoKY29tcGVuc2F0ZRgDIAEoCGIGcHJvdG8z", [file_ai_stigmer_agentic_workflow_v1_spec, file_ai_stigmer_commons_apiresource_field_options, file_buf_validate_validate]);
 /**
  * Describes the message ai.stigmer.agentic.workflow.v1.tasks.TryTaskConfig.
  * Use `create(TryTaskConfigSchema)` to create a new message.

package/ai/stigmer/agentic/workflow/v1/tasks/try_pb.js.map

@@ -1 +1 @@
-{"version":3,"file":"try_pb.js","sourceRoot":"","sources":["../../../../../../../ai/stigmer/agentic/workflow/v1/tasks/try_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,oIAAoI;AACpI,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,wCAAwC,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,iDAAiD,EAAE,MAAM,qDAAqD,CAAC;AACxH,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AAG3F;;GAEG;AACH,MAAM,CAAC,MAAM,6CAA6C,GAAY,aAAa,CACjF,QAAQ,CAAC,4dAA4d,EAAE,CAAC,wCAAwC,EAAE,iDAAiD,EAAE,0BAA0B,CAAC,CAAC,CAAC;AA8CpmB;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA8B,aAAa,CACzE,WAAW,CAAC,6CAA6C,EAAE,CAAC,CAAC,CAAC;AAwBhE;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA2B,aAAa,CACnE,WAAW,CAAC,6CAA6C,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"try_pb.js","sourceRoot":"","sources":["../../../../../../../ai/stigmer/agentic/workflow/v1/tasks/try_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,oIAAoI;AACpI,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,wCAAwC,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,iDAAiD,EAAE,MAAM,qDAAqD,CAAC;AACxH,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AAG3F;;GAEG;AACH,MAAM,CAAC,MAAM,6CAA6C,GAAY,aAAa,CACjF,QAAQ,CAAC,sfAAsf,EAAE,CAAC,wCAAwC,EAAE,iDAAiD,EAAE,0BAA0B,CAAC,CAAC,CAAC;AA8C9nB;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA8B,aAAa,CACzE,WAAW,CAAC,6CAA6C,EAAE,CAAC,CAAC,CAAC;AA4ChE;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA2B,aAAa,CACnE,WAAW,CAAC,6CAA6C,EAAE,CAAC,CAAC,CAAC"}

package/ai/stigmer/agentic/workflow/v1/tasks/validate_pb.d.ts

@@ -0,0 +1,257 @@
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
+import type { JsonObject, Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file ai/stigmer/agentic/workflow/v1/tasks/validate.proto.
+ */
+export declare const file_ai_stigmer_agentic_workflow_v1_tasks_validate: GenFile;
+/**
+ * ValidationRule defines a business rule evaluated as a boolean expression.
+ *
+ * @internal
+ * Rules complement JSON Schema validation by expressing constraints that
+ * schema alone cannot: cross-field dependencies, conditional requirements,
+ * and domain-specific invariants.
+ *
+ * The expression must evaluate to a boolean. When it evaluates to false,
+ * the rule is considered violated and the message (if provided) is included
+ * in the validation error output.
+ *
+ * Expressions use the same expression engine as switch_case.when for
+ * consistency across the workflow domain.
+ *
+ * @since T03 (P0 New Task Types)
+ *
+ * @generated from message ai.stigmer.agentic.workflow.v1.tasks.ValidationRule
+ */
+export type ValidationRule = Message<"ai.stigmer.agentic.workflow.v1.tasks.ValidationRule"> & {
+    /**
+     * Rule identifier for error reporting and debugging.
+     * Appears in validation error output so operators can identify which
+     * specific rule failed.
+     * Examples: "critical_needs_rationale", "customer_impact_requires_high_severity"
+     *
+     * @generated from field: string name = 1;
+     */
+    name: string;
+    /**
+     * Boolean expression that must evaluate to true for the rule to pass.
+     * Supports ${ } expression interpolation.
+     * The expression receives the validate task's input data as its context.
+     * Example: "${ .severity != 'critical' || (.rationale != null && .rationale != '') }"
+     *
+     * @generated from field: string expression = 2;
+     */
+    expression: string;
+    /**
+     * Error message included in validation output when the rule fails.
+     * Supports ${ } expression interpolation for dynamic error messages.
+     * When empty, a generic message is generated from the rule name.
+     * Example: "Critical severity requires a rationale"
+     *
+     * @generated from field: string message = 3;
+     */
+    message: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.tasks.ValidationRule.
+ * Use `create(ValidationRuleSchema)` to create a new message.
+ */
+export declare const ValidationRuleSchema: GenMessage<ValidationRule>;
+/**
+ * ValidateTaskConfig defines the configuration for validate tasks that
+ * perform explicit schema and business-rule validation on workflow data.
+ *
+ * @internal
+ * Use validate when you need an explicit validation checkpoint before
+ * downstream actions. This is how you distinguish "the API call succeeded"
+ * from "the data is safe and complete enough to continue."
+ *
+ * While switch_case + raise_error can approximate validation, a dedicated
+ * validate task makes the intent explicit, the error messages richer, and
+ * the execution trace clearer. In the execution viewer (T09), a validate
+ * task shows exactly what was checked, what passed, and what failed —
+ * visible as a distinct verification step.
+ *
+ * The task supports two complementary validation modes:
+ * - schema: JSON Schema validation for structural correctness
+ * - rules: business-rule expressions for domain-specific constraints
+ *
+ * At least one of schema or rules must be set. Both can be used together
+ * for comprehensive validation (schema checks structure, rules check
+ * business logic). This cross-field constraint is enforced at runtime
+ * validation since buf.validate cannot express it on individual fields.
+ *
+ * Task output includes the full validation result:
+ *   {
+ *     "valid": true/false,
+ *     "errors": [
+ *       {"rule": "critical_needs_rationale", "message": "Critical severity requires a rationale"},
+ *       {"path": "$.category", "message": "must have at least 1 character"}
+ *     ],
+ *     "data": <original input data>
+ *   }
+ *
+ * YAML Example (schema + business rules):
+ *   - check_triage_quality:
+ *       validate:
+ *         input: "${ $context.triage }"
+ *         schema:
+ *           type: object
+ *           required: [severity, category, customer_impact]
+ *           properties:
+ *             severity:
+ *               type: string
+ *               enum: [low, medium, high, critical]
+ *             category:
+ *               type: string
+ *               minLength: 1
+ *             customer_impact:
+ *               type: boolean
+ *         rules:
+ *           - name: critical_needs_rationale
+ *             expression: "${ .severity != 'critical' || (.rationale != null && .rationale != '') }"
+ *             message: "Critical severity requires a rationale"
+ *           - name: customer_impact_needs_severity
+ *             expression: "${ .customer_impact != true || .severity in ['high', 'critical'] }"
+ *             message: "Customer-impacting issues must be high or critical severity"
+ *         on_fail: VALIDATION_FAIL_BRANCH
+ *         fallback_task: human_review
+ *       export:
+ *         as: "${ . }"
+ *
+ * YAML Example (schema-only validation with warn policy):
+ *   - check_payload_shape:
+ *       validate:
+ *         input: "${ $context.api_payload }"
+ *         schema:
+ *           type: object
+ *           required: [name, email]
+ *           properties:
+ *             name:
+ *               type: string
+ *             email:
+ *               type: string
+ *               format: email
+ *         on_fail: VALIDATION_FAIL_WARN
+ *       export:
+ *         as: "${ . }"
+ *
+ * @generated from message ai.stigmer.agentic.workflow.v1.tasks.ValidateTaskConfig
+ */
+export type ValidateTaskConfig = Message<"ai.stigmer.agentic.workflow.v1.tasks.ValidateTaskConfig"> & {
+    /**
+     * Expression selecting the data to validate.
+     * Supports ${ } expression interpolation.
+     * Example: "${ $context.triage }" to validate the triage task's output.
+     *
+     * @generated from field: string input = 1;
+     */
+    input: string;
+    /**
+     * JSON Schema to validate the input data against.
+     *
+     * Standard JSON Schema (draft 2020-12 or compatible). The runtime
+     * validates the input data against this schema and reports detailed
+     * errors for any constraint violations.
+     *
+     * Uses the same google.protobuf.Struct + JSON Schema pattern as
+     * AgentCallOutputContract.schema, LlmCallTaskConfig.response_schema,
+     * and HumanInputTaskConfig.form_schema.
+     *
+     * At least one of schema or rules must be set.
+     *
+     * @generated from field: google.protobuf.Struct schema = 2;
+     */
+    schema?: JsonObject;
+    /**
+     * Business rules to evaluate against the input data.
+     *
+     * Each rule is a boolean expression that must evaluate to true.
+     * Rules complement schema validation by expressing constraints that
+     * JSON Schema cannot: cross-field dependencies, conditional requirements,
+     * and domain-specific invariants.
+     *
+     * At least one of schema or rules must be set.
+     *
+     * @generated from field: repeated ai.stigmer.agentic.workflow.v1.tasks.ValidationRule rules = 3;
+     */
+    rules: ValidationRule[];
+    /**
+     * Policy applied when validation fails.
+     * Default: VALIDATION_FAIL_RAISE (task fails with validation error).
+     *
+     * @generated from field: ai.stigmer.agentic.workflow.v1.tasks.ValidationFailPolicy on_fail = 4;
+     */
+    onFail: ValidationFailPolicy;
+    /**
+     * Target task to branch to when on_fail is VALIDATION_FAIL_BRANCH.
+     *
+     * Must reference a valid task name in the same workflow.
+     * Only meaningful when on_fail is VALIDATION_FAIL_BRANCH; ignored otherwise.
+     * When on_fail is BRANCH and fallback_task is empty, the task fails.
+     *
+     * @generated from field: string fallback_task = 5;
+     */
+    fallbackTask: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.tasks.ValidateTaskConfig.
+ * Use `create(ValidateTaskConfigSchema)` to create a new message.
+ */
+export declare const ValidateTaskConfigSchema: GenMessage<ValidateTaskConfig>;
+/**
+ * ValidationFailPolicy defines what happens when a validate task's
+ * validation fails (schema mismatch or business rule violation).
+ *
+ * @internal
+ * The policy determines whether validation failure is a hard stop,
+ * a branch point, or an advisory warning. This is distinct from
+ * OnInvalidOutputPolicy (which handles LLM/agent output schema failures
+ * with retry semantics) — validate tasks check data correctness, not
+ * LLM output quality, so retry (re-prompting) is not applicable.
+ *
+ * @since T03 (P0 New Task Types)
+ *
+ * @generated from enum ai.stigmer.agentic.workflow.v1.tasks.ValidationFailPolicy
+ */
+export declare enum ValidationFailPolicy {
+    /**
+     * Unspecified: defaults to VALIDATION_FAIL_RAISE behavior.
+     *
+     * @generated from enum value: VALIDATION_FAIL_POLICY_UNSPECIFIED = 0;
+     */
+    VALIDATION_FAIL_POLICY_UNSPECIFIED = 0,
+    /**
+     * Task fails with a validation error.
+     * The workflow transitions to error handling (try_catch or EXECUTION_FAILED).
+     * The error includes detailed validation results (which rules/schema
+     * constraints failed and why).
+     *
+     * @generated from enum value: VALIDATION_FAIL_RAISE = 1;
+     */
+    VALIDATION_FAIL_RAISE = 1,
+    /**
+     * Branch to fallback_task instead of failing.
+     * Requires fallback_task to be set on the ValidateTaskConfig.
+     * Use when validation failure should trigger an alternative workflow
+     * path (e.g., human review, re-processing, data enrichment).
+     *
+     * @generated from enum value: VALIDATION_FAIL_BRANCH = 2;
+     */
+    VALIDATION_FAIL_BRANCH = 2,
+    /**
+     * Log warnings but continue to the next task.
+     * Validation errors are included in the task output under the "errors"
+     * key, allowing downstream tasks to inspect what failed without
+     * stopping the workflow.
+     * Use for advisory validation where downstream logic handles errors
+     * gracefully, or for monitoring/audit purposes.
+     *
+     * @generated from enum value: VALIDATION_FAIL_WARN = 3;
+     */
+    VALIDATION_FAIL_WARN = 3
+}
+/**
+ * Describes the enum ai.stigmer.agentic.workflow.v1.tasks.ValidationFailPolicy.
+ */
+export declare const ValidationFailPolicySchema: GenEnum<ValidationFailPolicy>;

package/ai/stigmer/agentic/workflow/v1/tasks/validate_pb.js

@@ -0,0 +1,79 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts,import_extension=js"
+// @generated from file ai/stigmer/agentic/workflow/v1/tasks/validate.proto (package ai.stigmer.agentic.workflow.v1.tasks, syntax proto3)
+/* eslint-disable */
+import { enumDesc, fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv1";
+import { file_ai_stigmer_commons_apiresource_field_options } from "../../../../commons/apiresource/field_options_pb.js";
+import { file_buf_validate_validate } from "../../../../../../buf/validate/validate_pb.js";
+import { file_google_protobuf_struct } from "@bufbuild/protobuf/wkt";
+/**
+ * Describes the file ai/stigmer/agentic/workflow/v1/tasks/validate.proto.
+ */
+export const file_ai_stigmer_agentic_workflow_v1_tasks_validate = /*@__PURE__*/ fileDesc("CjNhaS9zdGlnbWVyL2FnZW50aWMvd29ya2Zsb3cvdjEvdGFza3MvdmFsaWRhdGUucHJvdG8SJGFpLnN0aWdtZXIuYWdlbnRpYy53b3JrZmxvdy52MS50YXNrcyJnCg5WYWxpZGF0aW9uUnVsZRIaCgRuYW1lGAEgASgJQgy6SAnIAQFyBBABGH8SIgoKZXhwcmVzc2lvbhgCIAEoCUIOukgHyAEBcgIQAdiFLAESFQoHbWVzc2FnZRgDIAEoCUIE2IUsASKTAgoSVmFsaWRhdGVUYXNrQ29uZmlnEh0KBWlucHV0GAEgASgJQg66SAfIAQFyAhAB2IUsARInCgZzY2hlbWEYAiABKAsyFy5nb29nbGUucHJvdG9idWYuU3RydWN0EkMKBXJ1bGVzGAMgAygLMjQuYWkuc3RpZ21lci5hZ2VudGljLndvcmtmbG93LnYxLnRhc2tzLlZhbGlkYXRpb25SdWxlEksKB29uX2ZhaWwYBCABKA4yOi5haS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3cudjEudGFza3MuVmFsaWRhdGlvbkZhaWxQb2xpY3kSFQoNZmFsbGJhY2tfdGFzaxgFIAEoCToM6ossCHZhbGlkYXRlKo8BChRWYWxpZGF0aW9uRmFpbFBvbGljeRImCiJWQUxJREFUSU9OX0ZBSUxfUE9MSUNZX1VOU1BFQ0lGSUVEEAASGQoVVkFMSURBVElPTl9GQUlMX1JBSVNFEAESGgoWVkFMSURBVElPTl9GQUlMX0JSQU5DSBACEhgKFFZBTElEQVRJT05fRkFJTF9XQVJOEANiBnByb3RvMw", [file_ai_stigmer_commons_apiresource_field_options, file_buf_validate_validate, file_google_protobuf_struct]);
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.tasks.ValidationRule.
+ * Use `create(ValidationRuleSchema)` to create a new message.
+ */
+export const ValidationRuleSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflow_v1_tasks_validate, 0);
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.tasks.ValidateTaskConfig.
+ * Use `create(ValidateTaskConfigSchema)` to create a new message.
+ */
+export const ValidateTaskConfigSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflow_v1_tasks_validate, 1);
+/**
+ * ValidationFailPolicy defines what happens when a validate task's
+ * validation fails (schema mismatch or business rule violation).
+ *
+ * @internal
+ * The policy determines whether validation failure is a hard stop,
+ * a branch point, or an advisory warning. This is distinct from
+ * OnInvalidOutputPolicy (which handles LLM/agent output schema failures
+ * with retry semantics) — validate tasks check data correctness, not
+ * LLM output quality, so retry (re-prompting) is not applicable.
+ *
+ * @since T03 (P0 New Task Types)
+ *
+ * @generated from enum ai.stigmer.agentic.workflow.v1.tasks.ValidationFailPolicy
+ */
+export var ValidationFailPolicy;
+(function (ValidationFailPolicy) {
+    /**
+     * Unspecified: defaults to VALIDATION_FAIL_RAISE behavior.
+     *
+     * @generated from enum value: VALIDATION_FAIL_POLICY_UNSPECIFIED = 0;
+     */
+    ValidationFailPolicy[ValidationFailPolicy["VALIDATION_FAIL_POLICY_UNSPECIFIED"] = 0] = "VALIDATION_FAIL_POLICY_UNSPECIFIED";
+    /**
+     * Task fails with a validation error.
+     * The workflow transitions to error handling (try_catch or EXECUTION_FAILED).
+     * The error includes detailed validation results (which rules/schema
+     * constraints failed and why).
+     *
+     * @generated from enum value: VALIDATION_FAIL_RAISE = 1;
+     */
+    ValidationFailPolicy[ValidationFailPolicy["VALIDATION_FAIL_RAISE"] = 1] = "VALIDATION_FAIL_RAISE";
+    /**
+     * Branch to fallback_task instead of failing.
+     * Requires fallback_task to be set on the ValidateTaskConfig.
+     * Use when validation failure should trigger an alternative workflow
+     * path (e.g., human review, re-processing, data enrichment).
+     *
+     * @generated from enum value: VALIDATION_FAIL_BRANCH = 2;
+     */
+    ValidationFailPolicy[ValidationFailPolicy["VALIDATION_FAIL_BRANCH"] = 2] = "VALIDATION_FAIL_BRANCH";
+    /**
+     * Log warnings but continue to the next task.
+     * Validation errors are included in the task output under the "errors"
+     * key, allowing downstream tasks to inspect what failed without
+     * stopping the workflow.
+     * Use for advisory validation where downstream logic handles errors
+     * gracefully, or for monitoring/audit purposes.
+     *
+     * @generated from enum value: VALIDATION_FAIL_WARN = 3;
+     */
+    ValidationFailPolicy[ValidationFailPolicy["VALIDATION_FAIL_WARN"] = 3] = "VALIDATION_FAIL_WARN";
+})(ValidationFailPolicy || (ValidationFailPolicy = {}));
+/**
+ * Describes the enum ai.stigmer.agentic.workflow.v1.tasks.ValidationFailPolicy.
+ */
+export const ValidationFailPolicySchema = /*@__PURE__*/ enumDesc(file_ai_stigmer_agentic_workflow_v1_tasks_validate, 0);
+//# sourceMappingURL=validate_pb.js.map

package/ai/stigmer/agentic/workflow/v1/tasks/validate_pb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate_pb.js","sourceRoot":"","sources":["../../../../../../../ai/stigmer/agentic/workflow/v1/tasks/validate_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,yIAAyI;AACzI,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC/E,OAAO,EAAE,iDAAiD,EAAE,MAAM,qDAAqD,CAAC;AACxH,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AAC3F,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAGrE;;GAEG;AACH,MAAM,CAAC,MAAM,kDAAkD,GAAY,aAAa,CACtF,QAAQ,CAAC,w0BAAw0B,EAAE,CAAC,iDAAiD,EAAE,0BAA0B,EAAE,2BAA2B,CAAC,CAAC,CAAC;AAqDn8B;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA+B,aAAa,CAC3E,WAAW,CAAC,kDAAkD,EAAE,CAAC,CAAC,CAAC;AAgJrE;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAmC,aAAa,CACnF,WAAW,CAAC,kDAAkD,EAAE,CAAC,CAAC,CAAC;AAErE;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAN,IAAY,oBAuCX;AAvCD,WAAY,oBAAoB;IAC9B;;;;OAIG;IACH,2HAAsC,CAAA;IAEtC;;;;;;;OAOG;IACH,iGAAyB,CAAA;IAEzB;;;;;;;OAOG;IACH,mGAA0B,CAAA;IAE1B;;;;;;;;;OASG;IACH,+FAAwB,CAAA;AAC1B,CAAC,EAvCW,oBAAoB,KAApB,oBAAoB,QAuC/B;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAkC,aAAa,CACpF,QAAQ,CAAC,kDAAkD,EAAE,CAAC,CAAC,CAAC"}

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

@@ -339,6 +339,46 @@ export type WorkflowExecutionStatus = Message<"ai.stigmer.agentic.workflowexecut
      * @generated from field: repeated ai.stigmer.agentic.workflowexecution.v1.WorkflowPendingApproval pending_approvals = 9;
      */
     pendingApprovals: WorkflowPendingApproval[];
+    /**
+     * Cumulative cost across all tasks in micro-USD (1 USD = 1,000,000 micros).
+     *
+     * @internal
+     * Updated by the workflow-runner alongside each status update. Reflects the
+     * budget tracker's accumulated cost at the time of the last status write.
+     * Used by getExecutionSummary for fast aggregation without scanning events.
+     *
+     * Consistent with WorkflowBudget.max_cost_micros and the billing domain's
+     * micro-USD convention (CostStamp.provider_cost_micros, etc.).
+     *
+     * @since Cost Data Pipeline
+     *
+     * @generated from field: int64 total_cost_micros = 10;
+     */
+    totalCostMicros: bigint;
+    /**
+     * Cumulative input tokens consumed across all LLM and agent tasks.
+     *
+     * @internal
+     * Input tokens represent prompt/context tokens sent to the model.
+     * Updated alongside total_cost_micros from the budget tracker.
+     *
+     * @since Cost Data Pipeline
+     *
+     * @generated from field: int64 total_input_tokens = 11;
+     */
+    totalInputTokens: bigint;
+    /**
+     * Cumulative output tokens consumed across all LLM and agent tasks.
+     *
+     * @internal
+     * Output tokens represent completion/generation tokens returned by the model.
+     * Updated alongside total_cost_micros from the budget tracker.
+     *
+     * @since Cost Data Pipeline
+     *
+     * @generated from field: int64 total_output_tokens = 12;
+     */
+    totalOutputTokens: bigint;
 };
 /**
  * Describes the message ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionStatus.
@@ -534,6 +574,62 @@ export type WorkflowTask = Message<"ai.stigmer.agentic.workflowexecution.v1.Work
      * @generated from field: google.protobuf.Struct metadata = 10;
      */
     metadata?: JsonObject;
+    /**
+     * Artifact IDs produced by this task.
+     *
+     * @internal
+     * Populated when the task's output (or portions of it) is auto-promoted
+     * to the artifact store because it exceeds the size threshold (256KB),
+     * or when the workflow author explicitly declares artifact persistence.
+     *
+     * Each entry is an Artifact ID (format: "art_{unique-suffix}") that can
+     * be resolved via the Artifact.get() and Artifact.getDownloadUrl() RPCs.
+     *
+     * When artifact_ids is non-empty, the task's output field contains
+     * artifact references ({"_artifact_ref": "art_xxx", ...}) instead of
+     * the original inline data. Consumers (execution viewer, SDK hooks)
+     * detect these references and resolve them via the Artifact APIs.
+     *
+     * @since T07 (Artifact Store)
+     *
+     * @generated from field: repeated string artifact_ids = 11;
+     */
+    artifactIds: string[];
+    /**
+     * Cost incurred by this task in micro-USD (1 USD = 1,000,000 micros).
+     *
+     * @internal
+     * Non-zero for cost-incurring task kinds (llm_call, agent_call).
+     * Zero for non-LLM tasks (transform, validate, emit_event, etc.).
+     * Set by the workflow-runner when the task completes.
+     *
+     * @since Cost Data Pipeline
+     *
+     * @generated from field: int64 cost_micros = 12;
+     */
+    costMicros: bigint;
+    /**
+     * Input (prompt/context) tokens consumed by this task.
+     *
+     * @internal
+     * Non-zero for LLM-backed tasks. Zero for non-LLM tasks.
+     *
+     * @since Cost Data Pipeline
+     *
+     * @generated from field: int64 input_tokens = 13;
+     */
+    inputTokens: bigint;
+    /**
+     * Output (completion/generation) tokens produced by this task.
+     *
+     * @internal
+     * Non-zero for LLM-backed tasks. Zero for non-LLM tasks.
+     *
+     * @since Cost Data Pipeline
+     *
+     * @generated from field: int64 output_tokens = 14;
+     */
+    outputTokens: bigint;
 };
 /**
  * Describes the message ai.stigmer.agentic.workflowexecution.v1.WorkflowTask.

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

@@ -12,7 +12,7 @@ import { file_google_protobuf_struct } from "@bufbuild/protobuf/wkt";
 /**
  * Describes the file ai/stigmer/agentic/workflowexecution/v1/api.proto.
  */
-export const file_ai_stigmer_agentic_workflowexecution_v1_api = /*@__PURE__*/ fileDesc("CjFhaS9zdGlnbWVyL2FnZW50aWMvd29ya2Zsb3dleGVjdXRpb24vdjEvYXBpLnByb3RvEidhaS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3dleGVjdXRpb24udjEi3QIKEVdvcmtmbG93RXhlY3V0aW9uEjEKC2FwaV92ZXJzaW9uGAEgASgJQhy6SBlyFwoVYWdlbnRpYy5zdGlnbWVyLmFpL3YxEiYKBGtpbmQYAiABKAlCGLpIFXITChFXb3JrZmxvd0V4ZWN1dGlvbhJNCghtZXRhZGF0YRgDIAEoCzIzLmFpLnN0aWdtZXIuY29tbW9ucy5hcGlyZXNvdXJjZS5BcGlSZXNvdXJjZU1ldGFkYXRhQga6SAPIAQESTAoEc3BlYxgEIAEoCzI+LmFpLnN0aWdtZXIuYWdlbnRpYy53b3JrZmxvd2V4ZWN1dGlvbi52MS5Xb3JrZmxvd0V4ZWN1dGlvblNwZWMSUAoGc3RhdHVzGAUgASgLMkAuYWkuc3RpZ21lci5hZ2VudGljLndvcmtmbG93ZXhlY3V0aW9uLnYxLldvcmtmbG93RXhlY3V0aW9uU3RhdHVzIs8DChdXb3JrZmxvd0V4ZWN1dGlvblN0YXR1cxI/CgVhdWRpdBhjIAEoCzIwLmFpLnN0aWdtZXIuY29tbW9ucy5hcGlyZXNvdXJjZS5BcGlSZXNvdXJjZUF1ZGl0ElAKBXBoYXNlGAEgASgOMjcuYWkuc3RpZ21lci5hZ2VudGljLndvcmtmbG93ZXhlY3V0aW9uLnYxLkV4ZWN1dGlvblBoYXNlQgi6SAWCAQIQARJECgV0YXNrcxgCIAMoCzI1LmFpLnN0aWdtZXIuYWdlbnRpYy53b3JrZmxvd2V4ZWN1dGlvbi52MS5Xb3JrZmxvd1Rhc2sSJwoGb3V0cHV0GAMgASgLMhcuZ29vZ2xlLnByb3RvYnVmLlN0cnVjdBINCgVlcnJvchgEIAEoCRISCgpzdGFydGVkX2F0GAUgASgJEhQKDGNvbXBsZXRlZF9hdBgGIAEoCRIcChR0ZW1wb3JhbF93b3JrZmxvd19pZBgHIAEoCRJbChFwZW5kaW5nX2FwcHJvdmFscxgJIAMoCzJALmFpLnN0aWdtZXIuYWdlbnRpYy53b3JrZmxvd2V4ZWN1dGlvbi52MS5Xb3JrZmxvd1BlbmRpbmdBcHByb3ZhbCKEAQoXV29ya2Zsb3dQZW5kaW5nQXBwcm92YWwSRwoIYXBwcm92YWwYASABKAsyNS5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnRleGVjdXRpb24udjEuUGVuZGluZ0FwcHJvdmFsEiAKGGNoaWxkX2FnZW50X2V4ZWN1dGlvbl9pZBgCIAEoCSKWAwoMV29ya2Zsb3dUYXNrEg8KB3Rhc2tfaWQYASABKAkSEQoJdGFza19uYW1lGAIgASgJElYKCXRhc2tfdHlwZRgDIAEoDjI5LmFpLnN0aWdtZXIuYWdlbnRpYy53b3JrZmxvd2V4ZWN1dGlvbi52MS5Xb3JrZmxvd1Rhc2tUeXBlQgi6SAWCAQIQARImCgVpbnB1dBgEIAEoCzIXLmdvb2dsZS5wcm90b2J1Zi5TdHJ1Y3QSJwoGb3V0cHV0GAUgASgLMhcuZ29vZ2xlLnByb3RvYnVmLlN0cnVjdBJVCgZzdGF0dXMYBiABKA4yOy5haS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3dleGVjdXRpb24udjEuV29ya2Zsb3dUYXNrU3RhdHVzQgi6SAWCAQIQARISCgpzdGFydGVkX2F0GAcgASgJEhQKDGNvbXBsZXRlZF9hdBgIIAEoCRINCgVlcnJvchgJIAEoCRIpCghtZXRhZGF0YRgKIAEoCzIXLmdvb2dsZS5wcm90b2J1Zi5TdHJ1Y3RiBnByb3RvMw", [file_ai_stigmer_agentic_agentexecution_v1_approval, file_ai_stigmer_agentic_workflowexecution_v1_enum, file_ai_stigmer_agentic_workflowexecution_v1_spec, file_ai_stigmer_commons_apiresource_metadata, file_ai_stigmer_commons_apiresource_status, file_buf_validate_validate, file_google_protobuf_struct]);
+export const file_ai_stigmer_agentic_workflowexecution_v1_api = /*@__PURE__*/ fileDesc("CjFhaS9zdGlnbWVyL2FnZW50aWMvd29ya2Zsb3dleGVjdXRpb24vdjEvYXBpLnByb3RvEidhaS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3dleGVjdXRpb24udjEi3QIKEVdvcmtmbG93RXhlY3V0aW9uEjEKC2FwaV92ZXJzaW9uGAEgASgJQhy6SBlyFwoVYWdlbnRpYy5zdGlnbWVyLmFpL3YxEiYKBGtpbmQYAiABKAlCGLpIFXITChFXb3JrZmxvd0V4ZWN1dGlvbhJNCghtZXRhZGF0YRgDIAEoCzIzLmFpLnN0aWdtZXIuY29tbW9ucy5hcGlyZXNvdXJjZS5BcGlSZXNvdXJjZU1ldGFkYXRhQga6SAPIAQESTAoEc3BlYxgEIAEoCzI+LmFpLnN0aWdtZXIuYWdlbnRpYy53b3JrZmxvd2V4ZWN1dGlvbi52MS5Xb3JrZmxvd0V4ZWN1dGlvblNwZWMSUAoGc3RhdHVzGAUgASgLMkAuYWkuc3RpZ21lci5hZ2VudGljLndvcmtmbG93ZXhlY3V0aW9uLnYxLldvcmtmbG93RXhlY3V0aW9uU3RhdHVzIqMEChdXb3JrZmxvd0V4ZWN1dGlvblN0YXR1cxI/CgVhdWRpdBhjIAEoCzIwLmFpLnN0aWdtZXIuY29tbW9ucy5hcGlyZXNvdXJjZS5BcGlSZXNvdXJjZUF1ZGl0ElAKBXBoYXNlGAEgASgOMjcuYWkuc3RpZ21lci5hZ2VudGljLndvcmtmbG93ZXhlY3V0aW9uLnYxLkV4ZWN1dGlvblBoYXNlQgi6SAWCAQIQARJECgV0YXNrcxgCIAMoCzI1LmFpLnN0aWdtZXIuYWdlbnRpYy53b3JrZmxvd2V4ZWN1dGlvbi52MS5Xb3JrZmxvd1Rhc2sSJwoGb3V0cHV0GAMgASgLMhcuZ29vZ2xlLnByb3RvYnVmLlN0cnVjdBINCgVlcnJvchgEIAEoCRISCgpzdGFydGVkX2F0GAUgASgJEhQKDGNvbXBsZXRlZF9hdBgGIAEoCRIcChR0ZW1wb3JhbF93b3JrZmxvd19pZBgHIAEoCRJbChFwZW5kaW5nX2FwcHJvdmFscxgJIAMoCzJALmFpLnN0aWdtZXIuYWdlbnRpYy53b3JrZmxvd2V4ZWN1dGlvbi52MS5Xb3JrZmxvd1BlbmRpbmdBcHByb3ZhbBIZChF0b3RhbF9jb3N0X21pY3JvcxgKIAEoAxIaChJ0b3RhbF9pbnB1dF90b2tlbnMYCyABKAMSGwoTdG90YWxfb3V0cHV0X3Rva2VucxgMIAEoAyKEAQoXV29ya2Zsb3dQZW5kaW5nQXBwcm92YWwSRwoIYXBwcm92YWwYASABKAsyNS5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnRleGVjdXRpb24udjEuUGVuZGluZ0FwcHJvdmFsEiAKGGNoaWxkX2FnZW50X2V4ZWN1dGlvbl9pZBgCIAEoCSLuAwoMV29ya2Zsb3dUYXNrEg8KB3Rhc2tfaWQYASABKAkSEQoJdGFza19uYW1lGAIgASgJElYKCXRhc2tfdHlwZRgDIAEoDjI5LmFpLnN0aWdtZXIuYWdlbnRpYy53b3JrZmxvd2V4ZWN1dGlvbi52MS5Xb3JrZmxvd1Rhc2tUeXBlQgi6SAWCAQIQARImCgVpbnB1dBgEIAEoCzIXLmdvb2dsZS5wcm90b2J1Zi5TdHJ1Y3QSJwoGb3V0cHV0GAUgASgLMhcuZ29vZ2xlLnByb3RvYnVmLlN0cnVjdBJVCgZzdGF0dXMYBiABKA4yOy5haS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3dleGVjdXRpb24udjEuV29ya2Zsb3dUYXNrU3RhdHVzQgi6SAWCAQIQARISCgpzdGFydGVkX2F0GAcgASgJEhQKDGNvbXBsZXRlZF9hdBgIIAEoCRINCgVlcnJvchgJIAEoCRIpCghtZXRhZGF0YRgKIAEoCzIXLmdvb2dsZS5wcm90b2J1Zi5TdHJ1Y3QSFAoMYXJ0aWZhY3RfaWRzGAsgAygJEhMKC2Nvc3RfbWljcm9zGAwgASgDEhQKDGlucHV0X3Rva2VucxgNIAEoAxIVCg1vdXRwdXRfdG9rZW5zGA4gASgDYgZwcm90bzM", [file_ai_stigmer_agentic_agentexecution_v1_approval, file_ai_stigmer_agentic_workflowexecution_v1_enum, file_ai_stigmer_agentic_workflowexecution_v1_spec, file_ai_stigmer_commons_apiresource_metadata, file_ai_stigmer_commons_apiresource_status, file_buf_validate_validate, file_google_protobuf_struct]);
 /**
  * Describes the message ai.stigmer.agentic.workflowexecution.v1.WorkflowExecution.
  * Use `create(WorkflowExecutionSchema)` to create a new message.

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,oFAAoF;AACpF,0IAA0I;AAC1I,oBAAoB;AAYpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,kDAAkD,EAAE,MAAM,wCAAwC,CAAC;AAE5G,OAAO,EAAE,iDAAiD,EAAE,MAAM,cAAc,CAAC;AAEjF,OAAO,EAAE,iDAAiD,EAAE,MAAM,cAAc,CAAC;AAEjF,OAAO,EAAE,4CAA4C,EAAE,MAAM,6CAA6C,CAAC;AAE3G,OAAO,EAAE,0CAA0C,EAAE,MAAM,2CAA2C,CAAC;AACvG,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AACxF,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"}
+{"version":3,"file":"api_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/workflowexecution/v1/api_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,0IAA0I;AAC1I,oBAAoB;AAYpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,kDAAkD,EAAE,MAAM,wCAAwC,CAAC;AAE5G,OAAO,EAAE,iDAAiD,EAAE,MAAM,cAAc,CAAC;AAEjF,OAAO,EAAE,iDAAiD,EAAE,MAAM,cAAc,CAAC;AAEjF,OAAO,EAAE,4CAA4C,EAAE,MAAM,6CAA6C,CAAC;AAE3G,OAAO,EAAE,0CAA0C,EAAE,MAAM,2CAA2C,CAAC;AACvG,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AACxF,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAGrE;;GAEG;AACH,MAAM,CAAC,MAAM,gDAAgD,GAAY,aAAa,CACpF,QAAQ,CAAC,qoEAAqoE,EAAE,CAAC,kDAAkD,EAAE,iDAAiD,EAAE,iDAAiD,EAAE,4CAA4C,EAAE,0CAA0C,EAAE,0BAA0B,EAAE,2BAA2B,CAAC,CAAC,CAAC;AAqJj8E;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAkC,aAAa,CACjF,WAAW,CAAC,gDAAgD,EAAE,CAAC,CAAC,CAAC;AA8OnE;;;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;AAkOnE;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6B,aAAa,CACvE,WAAW,CAAC,gDAAgD,EAAE,CAAC,CAAC,CAAC"}

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

@@ -337,6 +337,53 @@ export declare const WorkflowExecutionCommandController: {
             readonly O: any;
             readonly kind: any;
         };
+        /**
+         * Submit a human reviewer's decision for a workflow-level human_input task.
+         *
+         * Resolves a human_input approval gate by sending the reviewer's outcome
+         * (and optional form data) to the waiting workflow task via Temporal signal.
+         *
+         * @internal
+         * This RPC is specifically for workflow-level human_input tasks — the approval
+         * gates defined in workflow YAML that pause execution until a human responds.
+         * It is distinct from submitApproval, which forwards agent-level tool call
+         * approvals to child AgentExecutions.
+         *
+         * Behavior
+         *
+         * 1. Validates execution exists and is in progress
+         * 2. Validates that task_name references a human_input task in the workflow
+         * 3. Validates outcome against configured outcomes (if any)
+         * 4. Constructs signal name: "human_input_{task_name}"
+         * 5. Builds signal payload: {outcome, form_data, reviewer, responded_at}
+         * 6. Sends signal via Temporal SignalWithStart
+         * 7. Returns current WorkflowExecution (status updates asynchronously)
+         *
+         * Preconditions
+         *
+         * - Execution must be in EXECUTION_IN_PROGRESS phase
+         * - task_name must reference a human_input task in the workflow
+         * - outcome must be valid for the task's configured outcomes
+         * - User must have can_edit permission on the workflow execution
+         *
+         * Error Cases
+         *
+         * - NOT_FOUND: Workflow execution doesn't exist
+         * - PERMISSION_DENIED: User doesn't have can_edit permission
+         * - INVALID_ARGUMENT: task_name is not a human_input task, or outcome
+         *   doesn't match configured outcomes
+         * - FAILED_PRECONDITION: Execution is not in a signalable phase
+         *
+         * @since T13b (Java/Cloud Backend Parity)
+         *
+         * @generated from rpc ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionCommandController.submitWorkflowTaskApproval
+         */
+        readonly submitWorkflowTaskApproval: {
+            readonly name: "submitWorkflowTaskApproval";
+            readonly I: any;
+            readonly O: any;
+            readonly kind: any;
+        };
         /**
          * Delete a workflow execution.
          *