@stigmer/protos 0.5.0 → 1.0.0

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

@@ -0,0 +1,128 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts,import_extension=js"
+// @generated from file ai/stigmer/agentic/workflow/v1/tasks/eval.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/eval.proto.
+ */
+export const file_ai_stigmer_agentic_workflow_v1_tasks_eval = /*@__PURE__*/ fileDesc("Ci9haS9zdGlnbWVyL2FnZW50aWMvd29ya2Zsb3cvdjEvdGFza3MvZXZhbC5wcm90bxIkYWkuc3RpZ21lci5hZ2VudGljLndvcmtmbG93LnYxLnRhc2tzIlwKDUV2YWxDcml0ZXJpb24SGgoEbmFtZRgBIAEoCUIMukgJyAEBcgQQARh/Eh8KC2Rlc2NyaXB0aW9uGAIgASgJQgq6SAfIAQFyAhABEg4KBndlaWdodBgDIAEoASLIAwoORXZhbFRhc2tDb25maWcSGwoFbW9kZWwYASABKAlCDLpICcgBAXIEEAEYfxIfCgdzdWJqZWN0GAIgASgJQg66SAfIAQFyAhAB2IUsARIaCgZydWJyaWMYAyABKAlCCrpIB8gBAXICEAESSwoMc2NvcmluZ19tb2RlGAQgASgOMjUuYWkuc3RpZ21lci5hZ2VudGljLndvcmtmbG93LnYxLnRhc2tzLkV2YWxTY29yaW5nTW9kZRIqCgl0aHJlc2hvbGQYBSABKAFCF7pIFBISGQAAAAAAAPA/KQAAAAAAAAAAEkUKB29uX2ZhaWwYBiABKA4yNC5haS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3cudjEudGFza3MuRXZhbEZhaWxQb2xpY3kSFQoNZmFsbGJhY2tfdGFzaxgHIAEoCRIbCg1zeXN0ZW1fcHJvbXB0GAggASgJQgTYhSwBEkUKCGNyaXRlcmlhGAkgAygLMjMuYWkuc3RpZ21lci5hZ2VudGljLndvcmtmbG93LnYxLnRhc2tzLkV2YWxDcml0ZXJpb24SFwoPbWF4X2Nvc3RfbWljcm9zGAogASgDOgjqiywEZXZhbCpxCg5FdmFsRmFpbFBvbGljeRIgChxFVkFMX0ZBSUxfUE9MSUNZX1VOU1BFQ0lGSUVEEAASEwoPRVZBTF9GQUlMX1JBSVNFEAESFAoQRVZBTF9GQUlMX0JSQU5DSBACEhIKDkVWQUxfRkFJTF9XQVJOEAMqeQoPRXZhbFNjb3JpbmdNb2RlEiEKHUVWQUxfU0NPUklOR19NT0RFX1VOU1BFQ0lGSUVEEAASEgoORVZBTF9QQVNTX0ZBSUwQARIWChJFVkFMX05VTUVSSUNfU0NPUkUQAhIXChNFVkFMX01VTFRJX0NSSVRFUklBEANiBnByb3RvMw", [file_ai_stigmer_commons_apiresource_field_options, file_buf_validate_validate]);
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.tasks.EvalCriterion.
+ * Use `create(EvalCriterionSchema)` to create a new message.
+ */
+export const EvalCriterionSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflow_v1_tasks_eval, 0);
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.tasks.EvalTaskConfig.
+ * Use `create(EvalTaskConfigSchema)` to create a new message.
+ */
+export const EvalTaskConfigSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflow_v1_tasks_eval, 1);
+/**
+ * EvalFailPolicy defines what happens when an eval task determines that
+ * the evaluated subject does not meet the quality threshold.
+ *
+ * @internal
+ * Mirrors ValidationFailPolicy from validate tasks, since evaluation
+ * failure is semantically analogous to validation failure — the subject
+ * did not pass a quality gate. The only difference is that eval uses an
+ * LLM judge to assess semantic quality rather than deterministic schema
+ * checks.
+ *
+ * @since T17 (Advanced Agentic Orchestration)
+ *
+ * @generated from enum ai.stigmer.agentic.workflow.v1.tasks.EvalFailPolicy
+ */
+export var EvalFailPolicy;
+(function (EvalFailPolicy) {
+    /**
+     * Unspecified: defaults to EVAL_FAIL_RAISE behavior.
+     *
+     * @generated from enum value: EVAL_FAIL_POLICY_UNSPECIFIED = 0;
+     */
+    EvalFailPolicy[EvalFailPolicy["EVAL_FAIL_POLICY_UNSPECIFIED"] = 0] = "EVAL_FAIL_POLICY_UNSPECIFIED";
+    /**
+     * Task fails with an evaluation error.
+     * The workflow transitions to error handling (try_catch or EXECUTION_FAILED).
+     * The error includes the judge's reasoning and score for diagnostics.
+     *
+     * @generated from enum value: EVAL_FAIL_RAISE = 1;
+     */
+    EvalFailPolicy[EvalFailPolicy["EVAL_FAIL_RAISE"] = 1] = "EVAL_FAIL_RAISE";
+    /**
+     * Branch to fallback_task instead of failing.
+     * Requires fallback_task to be set on the EvalTaskConfig.
+     * Use when evaluation failure should trigger an alternative workflow
+     * path (e.g., re-generation with stricter prompt, human review, retry
+     * with a different model).
+     *
+     * @generated from enum value: EVAL_FAIL_BRANCH = 2;
+     */
+    EvalFailPolicy[EvalFailPolicy["EVAL_FAIL_BRANCH"] = 2] = "EVAL_FAIL_BRANCH";
+    /**
+     * Log warnings but continue to the next task.
+     * Evaluation results (score, reasoning, criteria breakdown) are included
+     * in the task output, allowing downstream tasks to inspect quality
+     * without stopping the workflow.
+     * Use for advisory evaluation or when downstream logic can gracefully
+     * handle low-quality inputs.
+     *
+     * @generated from enum value: EVAL_FAIL_WARN = 3;
+     */
+    EvalFailPolicy[EvalFailPolicy["EVAL_FAIL_WARN"] = 3] = "EVAL_FAIL_WARN";
+})(EvalFailPolicy || (EvalFailPolicy = {}));
+/**
+ * Describes the enum ai.stigmer.agentic.workflow.v1.tasks.EvalFailPolicy.
+ */
+export const EvalFailPolicySchema = /*@__PURE__*/ enumDesc(file_ai_stigmer_agentic_workflow_v1_tasks_eval, 0);
+/**
+ * EvalScoringMode defines how the LLM judge scores the subject.
+ *
+ * @internal
+ * The scoring mode determines the response schema enforced on the judge
+ * LLM and how the threshold is applied.
+ *
+ * @since T17 (Advanced Agentic Orchestration)
+ *
+ * @generated from enum ai.stigmer.agentic.workflow.v1.tasks.EvalScoringMode
+ */
+export var EvalScoringMode;
+(function (EvalScoringMode) {
+    /**
+     * Unspecified: defaults to EVAL_PASS_FAIL.
+     *
+     * @generated from enum value: EVAL_SCORING_MODE_UNSPECIFIED = 0;
+     */
+    EvalScoringMode[EvalScoringMode["EVAL_SCORING_MODE_UNSPECIFIED"] = 0] = "EVAL_SCORING_MODE_UNSPECIFIED";
+    /**
+     * Binary pass/fail judgment.
+     * The judge returns {pass: bool, reasoning: string}.
+     * Threshold is ignored — the judge's pass/fail decision is authoritative.
+     *
+     * @generated from enum value: EVAL_PASS_FAIL = 1;
+     */
+    EvalScoringMode[EvalScoringMode["EVAL_PASS_FAIL"] = 1] = "EVAL_PASS_FAIL";
+    /**
+     * Numeric score from 0.0 to 1.0.
+     * The judge returns {score: float, reasoning: string}.
+     * The subject passes if score >= threshold.
+     *
+     * @generated from enum value: EVAL_NUMERIC_SCORE = 2;
+     */
+    EvalScoringMode[EvalScoringMode["EVAL_NUMERIC_SCORE"] = 2] = "EVAL_NUMERIC_SCORE";
+    /**
+     * Multiple named criteria, each scored 0.0 to 1.0.
+     * The judge returns {criteria: [{name, score, reasoning}], overall_score, pass}.
+     * Overall score is the weighted average of criteria scores.
+     * The subject passes if overall_score >= threshold.
+     * Requires the criteria field to be populated on EvalTaskConfig.
+     *
+     * @generated from enum value: EVAL_MULTI_CRITERIA = 3;
+     */
+    EvalScoringMode[EvalScoringMode["EVAL_MULTI_CRITERIA"] = 3] = "EVAL_MULTI_CRITERIA";
+})(EvalScoringMode || (EvalScoringMode = {}));
+/**
+ * Describes the enum ai.stigmer.agentic.workflow.v1.tasks.EvalScoringMode.
+ */
+export const EvalScoringModeSchema = /*@__PURE__*/ enumDesc(file_ai_stigmer_agentic_workflow_v1_tasks_eval, 1);
+//# sourceMappingURL=eval_pb.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"eval_pb.js","sourceRoot":"","sources":["../../../../../../../ai/stigmer/agentic/workflow/v1/tasks/eval_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,qIAAqI;AACrI,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,8CAA8C,GAAY,aAAa,CAClF,QAAQ,CAAC,gqCAAgqC,EAAE,CAAC,iDAAiD,EAAE,0BAA0B,CAAC,CAAC,CAAC;AA2C9vC;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA8B,aAAa,CACzE,WAAW,CAAC,8CAA8C,EAAE,CAAC,CAAC,CAAC;AAkMjE;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA+B,aAAa,CAC3E,WAAW,CAAC,8CAA8C,EAAE,CAAC,CAAC,CAAC;AAEjE;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAN,IAAY,cAuCX;AAvCD,WAAY,cAAc;IACxB;;;;OAIG;IACH,mGAAgC,CAAA;IAEhC;;;;;;OAMG;IACH,yEAAmB,CAAA;IAEnB;;;;;;;;OAQG;IACH,2EAAoB,CAAA;IAEpB;;;;;;;;;OASG;IACH,uEAAkB,CAAA;AACpB,CAAC,EAvCW,cAAc,KAAd,cAAc,QAuCzB;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA4B,aAAa,CACxE,QAAQ,CAAC,8CAA8C,EAAE,CAAC,CAAC,CAAC;AAE9D;;;;;;;;;;GAUG;AACH,MAAM,CAAN,IAAY,eAoCX;AApCD,WAAY,eAAe;IACzB;;;;OAIG;IACH,uGAAiC,CAAA;IAEjC;;;;;;OAMG;IACH,yEAAkB,CAAA;IAElB;;;;;;OAMG;IACH,iFAAsB,CAAA;IAEtB;;;;;;;;OAQG;IACH,mFAAuB,CAAA;AACzB,CAAC,EApCW,eAAe,KAAf,eAAe,QAoC1B;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA6B,aAAa,CAC1E,QAAQ,CAAC,8CAA8C,EAAE,CAAC,CAAC,CAAC"}

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

@@ -1,4 +1,4 @@
-import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
 import type { WorkflowTask } from "../spec_pb.js";
 import type { Message } from "@bufbuild/protobuf";
 /**
@@ -9,7 +9,14 @@ export declare const file_ai_stigmer_agentic_workflow_v1_tasks_for: GenFile;
  * ForTaskConfig defines the configuration for for_each tasks that iterate over collections.
  *
  * @internal
- * YAML Example:
+ * Supports both sequential (default) and parallel execution modes. When
+ * max_parallelism is set, iterations run concurrently using Temporal
+ * workflow goroutines with bounded concurrency.
+ *
+ * Backward compatibility: all new fields default to values that preserve
+ * the pre-T17 sequential behavior. Existing workflows require no changes.
+ *
+ * YAML Example (sequential, unchanged from pre-T17):
  *   - taskName:
  *       for:
  *         each: item
@@ -23,8 +30,27 @@ export declare const file_ai_stigmer_agentic_workflow_v1_tasks_for: GenFile;
  *                 item: ${ $data.item }
  *                 index: ${ $data.index }
  *
+ * YAML Example (parallel with bounded concurrency):
+ *   - batchProcess:
+ *       for:
+ *         each: item
+ *         in: ${ $data.items }
+ *         max_parallelism: 5
+ *         on_error: FOR_EACH_CONTINUE
+ *       do:
+ *         - callApi:
+ *             call: http
+ *             with:
+ *               method: POST
+ *               endpoint:
+ *                 uri: "https://api.example.com/process"
+ *               body:
+ *                 item: ${ $data.item }
+ *
  * Reference: zigflow-dsl-pattern-catalog.md - Task Type 4
  *
+ * @since max_parallelism, batch_size, on_error: T17 (Advanced Agentic Orchestration)
+ *
  * @generated from message ai.stigmer.agentic.workflow.v1.tasks.ForTaskConfig
  */
 export type ForTaskConfig = Message<"ai.stigmer.agentic.workflow.v1.tasks.ForTaskConfig"> & {
@@ -49,9 +75,110 @@ export type ForTaskConfig = Message<"ai.stigmer.agentic.workflow.v1.tasks.ForTas
      * @generated from field: repeated ai.stigmer.agentic.workflow.v1.WorkflowTask do = 3;
      */
     do: WorkflowTask[];
+    /**
+     * Maximum number of iterations to execute concurrently.
+     *
+     * 0 (default): sequential execution — iterations run one at a time
+     * in input order. This preserves pre-T17 behavior.
+     *
+     * 1: effectively sequential (one at a time, but uses the parallel
+     * execution path — useful for testing).
+     *
+     * N > 1: up to N iterations run concurrently using Temporal workflow
+     * goroutines with a semaphore-based concurrency limiter. Results are
+     * always reassembled in original input order regardless of completion
+     * order.
+     *
+     * @since T17 (Advanced Agentic Orchestration)
+     *
+     * @generated from field: int32 max_parallelism = 4;
+     */
+    maxParallelism: number;
+    /**
+     * Number of items to process in each batch before moving to the next.
+     *
+     * 0 (default): no batching — all items are available for parallel
+     * execution (up to max_parallelism concurrent).
+     *
+     * N > 0: items are chunked into groups of N. Each chunk is fully
+     * processed before the next chunk begins. Within each chunk, up to
+     * max_parallelism iterations run concurrently.
+     *
+     * Only meaningful when max_parallelism > 0; ignored in sequential mode.
+     *
+     * @since T17 (Advanced Agentic Orchestration)
+     *
+     * @generated from field: int32 batch_size = 5;
+     */
+    batchSize: number;
+    /**
+     * Policy for handling individual iteration failures.
+     *
+     * Default: FOR_EACH_FAIL_FAST (stop on first error).
+     * Only meaningful when max_parallelism > 0; in sequential mode, any
+     * failure stops the loop regardless of this setting (pre-T17 behavior).
+     *
+     * @since T17 (Advanced Agentic Orchestration)
+     *
+     * @generated from field: ai.stigmer.agentic.workflow.v1.tasks.ForEachErrorPolicy on_error = 6;
+     */
+    onError: ForEachErrorPolicy;
 };
 /**
  * Describes the message ai.stigmer.agentic.workflow.v1.tasks.ForTaskConfig.
  * Use `create(ForTaskConfigSchema)` to create a new message.
  */
 export declare const ForTaskConfigSchema: GenMessage<ForTaskConfig>;
+/**
+ * ForEachErrorPolicy defines what happens when an individual iteration fails
+ * during parallel or sequential for_each execution.
+ *
+ * @internal
+ * When max_parallelism > 0 (parallel mode), error handling becomes critical
+ * because multiple iterations are in-flight simultaneously. This policy
+ * governs whether the entire loop fails fast or continues processing.
+ *
+ * @since T17 (Advanced Agentic Orchestration)
+ *
+ * @generated from enum ai.stigmer.agentic.workflow.v1.tasks.ForEachErrorPolicy
+ */
+export declare enum ForEachErrorPolicy {
+    /**
+     * Unspecified: defaults to FOR_EACH_FAIL_FAST behavior (current behavior).
+     *
+     * @generated from enum value: FOR_EACH_ERROR_POLICY_UNSPECIFIED = 0;
+     */
+    FOR_EACH_ERROR_POLICY_UNSPECIFIED = 0,
+    /**
+     * Stop on first error, cancel in-flight iterations.
+     * This is the default and preserves backward compatibility with the
+     * pre-T17 sequential behavior.
+     *
+     * @generated from enum value: FOR_EACH_FAIL_FAST = 1;
+     */
+    FOR_EACH_FAIL_FAST = 1,
+    /**
+     * Continue remaining iterations after a failure.
+     * Failed items are recorded in the output with their errors.
+     * The task output includes a summary of successes and failures.
+     * Use when partial results are valuable (e.g., batch API calls where
+     * some may fail but others should proceed).
+     *
+     * @generated from enum value: FOR_EACH_CONTINUE = 2;
+     */
+    FOR_EACH_CONTINUE = 2,
+    /**
+     * Skip failed items silently and continue.
+     * Failed items are excluded from the output array.
+     * No error details are preserved.
+     * Use when failures are expected and ignorable (e.g., best-effort
+     * enrichment of optional data).
+     *
+     * @generated from enum value: FOR_EACH_SKIP = 3;
+     */
+    FOR_EACH_SKIP = 3
+}
+/**
+ * Describes the enum ai.stigmer.agentic.workflow.v1.tasks.ForEachErrorPolicy.
+ */
+export declare const ForEachErrorPolicySchema: GenEnum<ForEachErrorPolicy>;

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

@@ -1,17 +1,71 @@
 // @generated by protoc-gen-es v2.2.2 with parameter "target=ts,import_extension=js"
 // @generated from file ai/stigmer/agentic/workflow/v1/tasks/for.proto (package ai.stigmer.agentic.workflow.v1.tasks, syntax proto3)
 /* eslint-disable */
-import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv1";
+import { enumDesc, fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv1";
 import { file_ai_stigmer_agentic_workflow_v1_spec } from "../spec_pb.js";
 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/for.proto.
  */
-export const file_ai_stigmer_agentic_workflow_v1_tasks_for = /*@__PURE__*/ fileDesc("Ci5haS9zdGlnbWVyL2FnZW50aWMvd29ya2Zsb3cvdjEvdGFza3MvZm9yLnByb3RvEiRhaS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3cudjEudGFza3MilwEKDUZvclRhc2tDb25maWcSGAoEZWFjaBgBIAEoCUIKukgHyAEBcgIQARIaCgJpbhgCIAEoCUIOukgHyAEBcgIQAdiFLAESQgoCZG8YAyADKAsyLC5haS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3cudjEuV29ya2Zsb3dUYXNrQgi6SAWSAQIIAToM6ossCGZvcl9lYWNoYgZwcm90bzM", [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_for = /*@__PURE__*/ fileDesc("Ci5haS9zdGlnbWVyL2FnZW50aWMvd29ya2Zsb3cvdjEvdGFza3MvZm9yLnByb3RvEiRhaS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3cudjEudGFza3MiogIKDUZvclRhc2tDb25maWcSGAoEZWFjaBgBIAEoCUIKukgHyAEBcgIQARIaCgJpbhgCIAEoCUIOukgHyAEBcgIQAdiFLAESQgoCZG8YAyADKAsyLC5haS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3cudjEuV29ya2Zsb3dUYXNrQgi6SAWSAQIIARIgCg9tYXhfcGFyYWxsZWxpc20YBCABKAVCB7pIBBoCKAASGwoKYmF0Y2hfc2l6ZRgFIAEoBUIHukgEGgIoABJKCghvbl9lcnJvchgGIAEoDjI4LmFpLnN0aWdtZXIuYWdlbnRpYy53b3JrZmxvdy52MS50YXNrcy5Gb3JFYWNoRXJyb3JQb2xpY3k6DOqLLAhmb3JfZWFjaCp9ChJGb3JFYWNoRXJyb3JQb2xpY3kSJQohRk9SX0VBQ0hfRVJST1JfUE9MSUNZX1VOU1BFQ0lGSUVEEAASFgoSRk9SX0VBQ0hfRkFJTF9GQVNUEAESFQoRRk9SX0VBQ0hfQ09OVElOVUUQAhIRCg1GT1JfRUFDSF9TS0lQEANiBnByb3RvMw", [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.ForTaskConfig.
  * Use `create(ForTaskConfigSchema)` to create a new message.
  */
 export const ForTaskConfigSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflow_v1_tasks_for, 0);
+/**
+ * ForEachErrorPolicy defines what happens when an individual iteration fails
+ * during parallel or sequential for_each execution.
+ *
+ * @internal
+ * When max_parallelism > 0 (parallel mode), error handling becomes critical
+ * because multiple iterations are in-flight simultaneously. This policy
+ * governs whether the entire loop fails fast or continues processing.
+ *
+ * @since T17 (Advanced Agentic Orchestration)
+ *
+ * @generated from enum ai.stigmer.agentic.workflow.v1.tasks.ForEachErrorPolicy
+ */
+export var ForEachErrorPolicy;
+(function (ForEachErrorPolicy) {
+    /**
+     * Unspecified: defaults to FOR_EACH_FAIL_FAST behavior (current behavior).
+     *
+     * @generated from enum value: FOR_EACH_ERROR_POLICY_UNSPECIFIED = 0;
+     */
+    ForEachErrorPolicy[ForEachErrorPolicy["FOR_EACH_ERROR_POLICY_UNSPECIFIED"] = 0] = "FOR_EACH_ERROR_POLICY_UNSPECIFIED";
+    /**
+     * Stop on first error, cancel in-flight iterations.
+     * This is the default and preserves backward compatibility with the
+     * pre-T17 sequential behavior.
+     *
+     * @generated from enum value: FOR_EACH_FAIL_FAST = 1;
+     */
+    ForEachErrorPolicy[ForEachErrorPolicy["FOR_EACH_FAIL_FAST"] = 1] = "FOR_EACH_FAIL_FAST";
+    /**
+     * Continue remaining iterations after a failure.
+     * Failed items are recorded in the output with their errors.
+     * The task output includes a summary of successes and failures.
+     * Use when partial results are valuable (e.g., batch API calls where
+     * some may fail but others should proceed).
+     *
+     * @generated from enum value: FOR_EACH_CONTINUE = 2;
+     */
+    ForEachErrorPolicy[ForEachErrorPolicy["FOR_EACH_CONTINUE"] = 2] = "FOR_EACH_CONTINUE";
+    /**
+     * Skip failed items silently and continue.
+     * Failed items are excluded from the output array.
+     * No error details are preserved.
+     * Use when failures are expected and ignorable (e.g., best-effort
+     * enrichment of optional data).
+     *
+     * @generated from enum value: FOR_EACH_SKIP = 3;
+     */
+    ForEachErrorPolicy[ForEachErrorPolicy["FOR_EACH_SKIP"] = 3] = "FOR_EACH_SKIP";
+})(ForEachErrorPolicy || (ForEachErrorPolicy = {}));
+/**
+ * Describes the enum ai.stigmer.agentic.workflow.v1.tasks.ForEachErrorPolicy.
+ */
+export const ForEachErrorPolicySchema = /*@__PURE__*/ enumDesc(file_ai_stigmer_agentic_workflow_v1_tasks_for, 0);
 //# sourceMappingURL=for_pb.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"for_pb.js","sourceRoot":"","sources":["../../../../../../../ai/stigmer/agentic/workflow/v1/tasks/for_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,6UAA6U,EAAE,CAAC,wCAAwC,EAAE,iDAAiD,EAAE,0BAA0B,CAAC,CAAC,CAAC;AAkDrd;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA8B,aAAa,CACzE,WAAW,CAAC,6CAA6C,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"for_pb.js","sourceRoot":"","sources":["../../../../../../../ai/stigmer/agentic/workflow/v1/tasks/for_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,oIAAoI;AACpI,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE/E,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,grBAAgrB,EAAE,CAAC,wCAAwC,EAAE,iDAAiD,EAAE,0BAA0B,CAAC,CAAC,CAAC;AA+HxzB;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA8B,aAAa,CACzE,WAAW,CAAC,6CAA6C,EAAE,CAAC,CAAC,CAAC;AAEhE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAN,IAAY,kBAsCX;AAtCD,WAAY,kBAAkB;IAC5B;;;;OAIG;IACH,qHAAqC,CAAA;IAErC;;;;;;OAMG;IACH,uFAAsB,CAAA;IAEtB;;;;;;;;OAQG;IACH,qFAAqB,CAAA;IAErB;;;;;;;;OAQG;IACH,6EAAiB,CAAA;AACnB,CAAC,EAtCW,kBAAkB,KAAlB,kBAAkB,QAsC7B;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAgC,aAAa,CAChF,QAAQ,CAAC,6CAA6C,EAAE,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,284 @@
+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/human_input.proto.
+ */
+export declare const file_ai_stigmer_agentic_workflow_v1_tasks_human_input: GenFile;
+/**
+ * HumanInputOutcome defines a named outcome that a reviewer can select
+ * when responding to a human_input task.
+ *
+ * @internal
+ * Outcomes enable rich branching beyond binary approve/deny. Each outcome
+ * can route to a different downstream task via the `then` field, enabling
+ * patterns like "approve → continue", "deny → re_classify", "needs_revision
+ * → gather_more_context".
+ *
+ * When no outcomes are defined, the task defaults to binary approve/deny
+ * behavior: approve continues to the next task, deny fails the task.
+ *
+ * @since T03 (P0 New Task Types)
+ *
+ * @generated from message ai.stigmer.agentic.workflow.v1.tasks.HumanInputOutcome
+ */
+export type HumanInputOutcome = Message<"ai.stigmer.agentic.workflow.v1.tasks.HumanInputOutcome"> & {
+    /**
+     * Outcome identifier used in task output and routing.
+     * Examples: "approve", "deny", "needs_revision", "escalate", "defer"
+     * Must be unique within the outcomes list.
+     *
+     * @generated from field: string name = 1;
+     */
+    name: string;
+    /**
+     * Human-readable label for the button/action in the approval UI.
+     * When empty, the UI displays the capitalized name.
+     * Examples: "Approve Escalation", "Reject — Not Customer-Impacting"
+     *
+     * @generated from field: string label = 2;
+     */
+    label: string;
+    /**
+     * Task to branch to when this outcome is selected.
+     * Must reference a valid task name in the same workflow.
+     * When empty, the workflow continues to the next task in sequence.
+     *
+     * @generated from field: string then = 3;
+     */
+    then: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.tasks.HumanInputOutcome.
+ * Use `create(HumanInputOutcomeSchema)` to create a new message.
+ */
+export declare const HumanInputOutcomeSchema: GenMessage<HumanInputOutcome>;
+/**
+ * HumanInputTaskConfig defines the configuration for human_input tasks that
+ * pause workflow execution to collect typed input or approval from a human
+ * reviewer, then resume based on the reviewer's response.
+ *
+ * @internal
+ * Use human_input when a workflow needs human judgment before proceeding:
+ * approvals before API calls, sign-off before publishing, confirmation
+ * before customer-impacting actions, or structured data collection from
+ * a human operator.
+ *
+ * This is a workflow-level approval gate — distinct from agent-level HITL
+ * (tool approval inside an agent session). Workflow-level gates are visible
+ * in the execution viewer as explicit tasks with input/output/timing, and
+ * they can route to different branches based on the reviewer's decision.
+ *
+ * Runtime implementation (T13) will use Temporal signals for workflow
+ * resumption. The proto definition is intentionally runtime-agnostic.
+ *
+ * The reviewer's response (selected outcome + form data) becomes the task
+ * output, accessible via export:
+ *   {
+ *     "outcome": "approve",
+ *     "form_data": { <validated form response if form_schema is set> },
+ *     "reviewer": "<user who responded>",
+ *     "responded_at": "<ISO 8601 timestamp>"
+ *   }
+ *
+ * YAML Example (approval gate with custom outcomes):
+ *   - manager_approval:
+ *       human_input:
+ *         prompt: "Customer-impacting incident classified as ${ $context.triage.severity }. Approve escalation?"
+ *         form_schema:
+ *           type: object
+ *           properties:
+ *             notes:
+ *               type: string
+ *               description: "Optional notes for the engineering team"
+ *             priority_override:
+ *               type: string
+ *               enum: [P1, P2, P3]
+ *         outcomes:
+ *           - name: approve
+ *             label: "Approve Escalation"
+ *           - name: deny
+ *             label: "Reject — Not Customer-Impacting"
+ *             then: re_classify
+ *           - name: needs_revision
+ *             label: "Needs More Info"
+ *             then: gather_more_context
+ *         approvers:
+ *           - "team:engineering-leads"
+ *         timeout: 86400
+ *         on_timeout: HUMAN_INPUT_TIMEOUT_ESCALATE
+ *         notification_channels:
+ *           - "slack:#incident-approvals"
+ *       export:
+ *         as: "${ . }"
+ *
+ * YAML Example (simple binary approval, no form):
+ *   - confirm_publish:
+ *       human_input:
+ *         prompt: "Ready to publish ${ $context.document.title } to production?"
+ *         approvers:
+ *           - "role:content-admin"
+ *         timeout: 3600
+ *         on_timeout: HUMAN_INPUT_TIMEOUT_FAIL
+ *       export:
+ *         as: "${ . }"
+ *
+ * @generated from message ai.stigmer.agentic.workflow.v1.tasks.HumanInputTaskConfig
+ */
+export type HumanInputTaskConfig = Message<"ai.stigmer.agentic.workflow.v1.tasks.HumanInputTaskConfig"> & {
+    /**
+     * Message shown to the reviewer explaining what needs approval or input.
+     * Supports ${ } expression interpolation for injecting workflow context.
+     * Example: "Approve escalation for ticket ${ $context.ticket.id }?"
+     *
+     * @generated from field: string prompt = 1;
+     */
+    prompt: string;
+    /**
+     * JSON Schema defining the input form rendered to the reviewer.
+     *
+     * When set, the approval UI renders a typed form based on this schema.
+     * The reviewer's form response is validated against the schema before
+     * the task completes, and the validated data appears in the task output
+     * under the "form_data" key.
+     *
+     * When not set, the reviewer sees only the outcome buttons (approve/deny
+     * or custom outcomes) without a data entry form.
+     *
+     * Uses the same google.protobuf.Struct + JSON Schema pattern as
+     * AgentCallOutputContract.schema and LlmCallTaskConfig.response_schema.
+     *
+     * @generated from field: google.protobuf.Struct form_schema = 2;
+     */
+    formSchema?: JsonObject;
+    /**
+     * Named outcomes that the reviewer can select.
+     *
+     * Each outcome represents a decision the reviewer can make, with optional
+     * routing to a different downstream task. This enables rich branching
+     * beyond binary approve/deny.
+     *
+     * When empty, the task defaults to binary behavior:
+     *   - "approve": task completes, workflow continues to next task
+     *   - "deny": task fails (enters try_catch or EXECUTION_FAILED)
+     *
+     * When custom outcomes are defined, the first outcome is used as the
+     * default for HUMAN_INPUT_TIMEOUT_APPROVE, and the last outcome is used
+     * as the default for HUMAN_INPUT_TIMEOUT_DENY.
+     *
+     * @generated from field: repeated ai.stigmer.agentic.workflow.v1.tasks.HumanInputOutcome outcomes = 3;
+     */
+    outcomes: HumanInputOutcome[];
+    /**
+     * Approver identifiers — who is allowed to respond to this task.
+     *
+     * Supports user IDs, team slugs, and role names. Format examples:
+     *   - "user:jane@acme.com" — specific user
+     *   - "team:engineering-leads" — any member of the team
+     *   - "role:content-admin" — any user with the role
+     *
+     * When empty, any authenticated user can respond.
+     * Resolution of these identifiers is a runtime concern (T13).
+     *
+     * @generated from field: repeated string approvers = 4;
+     */
+    approvers: string[];
+    /**
+     * Timeout in seconds before the on_timeout policy applies.
+     * Default: 0 (no timeout — the task waits indefinitely).
+     * Max: 2592000 (30 days).
+     *
+     * A timeout of 0 means the workflow will wait until a human responds.
+     * For production workflows, setting a timeout with an appropriate
+     * on_timeout policy is strongly recommended.
+     *
+     * @generated from field: int32 timeout = 5;
+     */
+    timeout: number;
+    /**
+     * Policy applied when the timeout expires without a response.
+     * Only meaningful when timeout > 0; ignored when timeout is 0.
+     * Default: HUMAN_INPUT_TIMEOUT_FAIL (task fails with timeout error).
+     *
+     * @generated from field: ai.stigmer.agentic.workflow.v1.tasks.HumanInputTimeoutPolicy on_timeout = 6;
+     */
+    onTimeout: HumanInputTimeoutPolicy;
+    /**
+     * Channel identifiers for sending approval request notifications.
+     *
+     * When the task starts, the runtime sends notifications through these
+     * channels to alert potential approvers. Format examples:
+     *   - "slack:#approvals" — Slack channel
+     *   - "email:ops@acme.com" — email address
+     *   - "teams:#incident-response" — Microsoft Teams channel
+     *
+     * The format and routing of notifications is a runtime concern (T13).
+     * The proto carries the identifiers; the runtime resolves them to
+     * actual notification providers configured in the workflow instance's
+     * environment.
+     *
+     * @generated from field: repeated string notification_channels = 7;
+     */
+    notificationChannels: string[];
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.tasks.HumanInputTaskConfig.
+ * Use `create(HumanInputTaskConfigSchema)` to create a new message.
+ */
+export declare const HumanInputTaskConfigSchema: GenMessage<HumanInputTaskConfig>;
+/**
+ * HumanInputTimeoutPolicy defines what happens when a human_input task's
+ * timeout expires without a response from any approver.
+ *
+ * @internal
+ * Timeout behavior is a workflow design decision: should the workflow fail
+ * (safest), auto-approve (for non-critical gates), auto-deny (for opt-in
+ * flows), or escalate to a different handler?
+ *
+ * @since T03 (P0 New Task Types)
+ *
+ * @generated from enum ai.stigmer.agentic.workflow.v1.tasks.HumanInputTimeoutPolicy
+ */
+export declare enum HumanInputTimeoutPolicy {
+    /**
+     * Unspecified: defaults to HUMAN_INPUT_TIMEOUT_FAIL behavior.
+     *
+     * @generated from enum value: HUMAN_INPUT_TIMEOUT_POLICY_UNSPECIFIED = 0;
+     */
+    HUMAN_INPUT_TIMEOUT_POLICY_UNSPECIFIED = 0,
+    /**
+     * Task fails with a timeout error.
+     * The workflow transitions to error handling (try_catch or EXECUTION_FAILED).
+     *
+     * @generated from enum value: HUMAN_INPUT_TIMEOUT_FAIL = 1;
+     */
+    HUMAN_INPUT_TIMEOUT_FAIL = 1,
+    /**
+     * Auto-approve: the task completes as if the reviewer selected the first
+     * outcome (or "approve" if no outcomes are defined).
+     * Task output: {"outcome": "approve", "auto_resolved": true, "reason": "timeout"}
+     *
+     * @generated from enum value: HUMAN_INPUT_TIMEOUT_APPROVE = 2;
+     */
+    HUMAN_INPUT_TIMEOUT_APPROVE = 2,
+    /**
+     * Auto-deny: the task completes as if the reviewer selected "deny"
+     * (or the last outcome if custom outcomes are defined).
+     * Task output: {"outcome": "deny", "auto_resolved": true, "reason": "timeout"}
+     *
+     * @generated from enum value: HUMAN_INPUT_TIMEOUT_DENY = 3;
+     */
+    HUMAN_INPUT_TIMEOUT_DENY = 3,
+    /**
+     * Escalate: branch to a named escalation task.
+     * Requires a corresponding outcome with then set, or a try_catch handler.
+     * Use when timeout should trigger a different workflow path rather than
+     * a simple approve/deny decision.
+     *
+     * @generated from enum value: HUMAN_INPUT_TIMEOUT_ESCALATE = 4;
+     */
+    HUMAN_INPUT_TIMEOUT_ESCALATE = 4
+}
+/**
+ * Describes the enum ai.stigmer.agentic.workflow.v1.tasks.HumanInputTimeoutPolicy.
+ */
+export declare const HumanInputTimeoutPolicySchema: GenEnum<HumanInputTimeoutPolicy>;