@stigmer/protos 0.5.0 → 1.0.0

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

@@ -0,0 +1,67 @@
+import type { GenEnum, GenFile } from "@bufbuild/protobuf/codegenv1";
+/**
+ * Describes the file ai/stigmer/agentic/workflow/v1/tasks/common.proto.
+ */
+export declare const file_ai_stigmer_agentic_workflow_v1_tasks_common: GenFile;
+/**
+ * OnInvalidOutputPolicy defines what happens when an LLM or agent output
+ * fails schema validation against a declared output contract or response schema.
+ *
+ * @internal
+ * Shared by AgentCallOutputContract.on_invalid (agent_call) and
+ * LlmCallTaskConfig.on_invalid (llm_call). Any task type that produces
+ * schema-validated output can reference this enum.
+ *
+ * Failure handling follows a deliberate hierarchy:
+ * - FAIL: strictest — bad output is unacceptable, fail the task immediately
+ * - RETRY: re-prompt with validation errors, up to max_retries attempts
+ * - FALLBACK: branch to a named task (e.g., human_review) without retrying
+ *
+ * When ON_INVALID_RETRY is used and all retries are exhausted:
+ * - If fallback_task is set: branch to that task
+ * - If fallback_task is empty: task fails
+ *
+ * @since T02 (Structured Agent Output Model)
+ *
+ * @generated from enum ai.stigmer.agentic.workflow.v1.tasks.OnInvalidOutputPolicy
+ */
+export declare enum OnInvalidOutputPolicy {
+    /**
+     * Unspecified: defaults to ON_INVALID_FAIL behavior.
+     *
+     * @generated from enum value: ON_INVALID_POLICY_UNSPECIFIED = 0;
+     */
+    ON_INVALID_POLICY_UNSPECIFIED = 0,
+    /**
+     * Task fails immediately with a schema validation error.
+     * The workflow transitions to error handling (try_catch or EXECUTION_FAILED).
+     *
+     * @generated from enum value: ON_INVALID_FAIL = 1;
+     */
+    ON_INVALID_FAIL = 1,
+    /**
+     * Re-prompt the agent with the validation error message, up to max_retries
+     * attempts. The retry message includes the schema and specific validation
+     * errors so the agent can self-correct.
+     *
+     * After exhausting retries:
+     *   - If fallback_task is set: branch to that task
+     *   - Otherwise: task fails with a schema validation error
+     *
+     * @generated from enum value: ON_INVALID_RETRY = 2;
+     */
+    ON_INVALID_RETRY = 2,
+    /**
+     * Branch immediately to fallback_task without retrying.
+     * Requires fallback_task to be set on the owning contract/config.
+     * Use when human review or an alternative extraction path is preferred
+     * over automated retry.
+     *
+     * @generated from enum value: ON_INVALID_FALLBACK = 3;
+     */
+    ON_INVALID_FALLBACK = 3
+}
+/**
+ * Describes the enum ai.stigmer.agentic.workflow.v1.tasks.OnInvalidOutputPolicy.
+ */
+export declare const OnInvalidOutputPolicySchema: GenEnum<OnInvalidOutputPolicy>;

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

@@ -0,0 +1,72 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts,import_extension=js"
+// @generated from file ai/stigmer/agentic/workflow/v1/tasks/common.proto (package ai.stigmer.agentic.workflow.v1.tasks, syntax proto3)
+/* eslint-disable */
+import { enumDesc, fileDesc } from "@bufbuild/protobuf/codegenv1";
+/**
+ * Describes the file ai/stigmer/agentic/workflow/v1/tasks/common.proto.
+ */
+export const file_ai_stigmer_agentic_workflow_v1_tasks_common = /*@__PURE__*/ fileDesc("CjFhaS9zdGlnbWVyL2FnZW50aWMvd29ya2Zsb3cvdjEvdGFza3MvY29tbW9uLnByb3RvEiRhaS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3cudjEudGFza3MqfgoVT25JbnZhbGlkT3V0cHV0UG9saWN5EiEKHU9OX0lOVkFMSURfUE9MSUNZX1VOU1BFQ0lGSUVEEAASEwoPT05fSU5WQUxJRF9GQUlMEAESFAoQT05fSU5WQUxJRF9SRVRSWRACEhcKE09OX0lOVkFMSURfRkFMTEJBQ0sQA2IGcHJvdG8z");
+/**
+ * OnInvalidOutputPolicy defines what happens when an LLM or agent output
+ * fails schema validation against a declared output contract or response schema.
+ *
+ * @internal
+ * Shared by AgentCallOutputContract.on_invalid (agent_call) and
+ * LlmCallTaskConfig.on_invalid (llm_call). Any task type that produces
+ * schema-validated output can reference this enum.
+ *
+ * Failure handling follows a deliberate hierarchy:
+ * - FAIL: strictest — bad output is unacceptable, fail the task immediately
+ * - RETRY: re-prompt with validation errors, up to max_retries attempts
+ * - FALLBACK: branch to a named task (e.g., human_review) without retrying
+ *
+ * When ON_INVALID_RETRY is used and all retries are exhausted:
+ * - If fallback_task is set: branch to that task
+ * - If fallback_task is empty: task fails
+ *
+ * @since T02 (Structured Agent Output Model)
+ *
+ * @generated from enum ai.stigmer.agentic.workflow.v1.tasks.OnInvalidOutputPolicy
+ */
+export var OnInvalidOutputPolicy;
+(function (OnInvalidOutputPolicy) {
+    /**
+     * Unspecified: defaults to ON_INVALID_FAIL behavior.
+     *
+     * @generated from enum value: ON_INVALID_POLICY_UNSPECIFIED = 0;
+     */
+    OnInvalidOutputPolicy[OnInvalidOutputPolicy["ON_INVALID_POLICY_UNSPECIFIED"] = 0] = "ON_INVALID_POLICY_UNSPECIFIED";
+    /**
+     * Task fails immediately with a schema validation error.
+     * The workflow transitions to error handling (try_catch or EXECUTION_FAILED).
+     *
+     * @generated from enum value: ON_INVALID_FAIL = 1;
+     */
+    OnInvalidOutputPolicy[OnInvalidOutputPolicy["ON_INVALID_FAIL"] = 1] = "ON_INVALID_FAIL";
+    /**
+     * Re-prompt the agent with the validation error message, up to max_retries
+     * attempts. The retry message includes the schema and specific validation
+     * errors so the agent can self-correct.
+     *
+     * After exhausting retries:
+     *   - If fallback_task is set: branch to that task
+     *   - Otherwise: task fails with a schema validation error
+     *
+     * @generated from enum value: ON_INVALID_RETRY = 2;
+     */
+    OnInvalidOutputPolicy[OnInvalidOutputPolicy["ON_INVALID_RETRY"] = 2] = "ON_INVALID_RETRY";
+    /**
+     * Branch immediately to fallback_task without retrying.
+     * Requires fallback_task to be set on the owning contract/config.
+     * Use when human review or an alternative extraction path is preferred
+     * over automated retry.
+     *
+     * @generated from enum value: ON_INVALID_FALLBACK = 3;
+     */
+    OnInvalidOutputPolicy[OnInvalidOutputPolicy["ON_INVALID_FALLBACK"] = 3] = "ON_INVALID_FALLBACK";
+})(OnInvalidOutputPolicy || (OnInvalidOutputPolicy = {}));
+/**
+ * Describes the enum ai.stigmer.agentic.workflow.v1.tasks.OnInvalidOutputPolicy.
+ */
+export const OnInvalidOutputPolicySchema = /*@__PURE__*/ enumDesc(file_ai_stigmer_agentic_workflow_v1_tasks_common, 0);
+//# sourceMappingURL=common_pb.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"common_pb.js","sourceRoot":"","sources":["../../../../../../../ai/stigmer/agentic/workflow/v1/tasks/common_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,uIAAuI;AACvI,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAElE;;GAEG;AACH,MAAM,CAAC,MAAM,gDAAgD,GAAY,aAAa,CACpF,QAAQ,CAAC,8SAA8S,CAAC,CAAC;AAE3T;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAN,IAAY,qBAsCX;AAtCD,WAAY,qBAAqB;IAC/B;;;;OAIG;IACH,mHAAiC,CAAA;IAEjC;;;;;OAKG;IACH,uFAAmB,CAAA;IAEnB;;;;;;;;;;OAUG;IACH,yFAAoB,CAAA;IAEpB;;;;;;;OAOG;IACH,+FAAuB,CAAA;AACzB,CAAC,EAtCW,qBAAqB,KAArB,qBAAqB,QAsChC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAmC,aAAa,CACtF,QAAQ,CAAC,gDAAgD,EAAE,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,147 @@
+import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
+import type { JsonObject, Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file ai/stigmer/agentic/workflow/v1/tasks/emit_event.proto.
+ */
+export declare const file_ai_stigmer_agentic_workflow_v1_tasks_emit_event: GenFile;
+/**
+ * EmitEventSpec defines the CloudEvents envelope for an event to be emitted.
+ *
+ * @internal
+ * Follows CloudEvents semantics (type, source, subject, data) because:
+ * 1. CloudEvents is a graduated CNCF project with broad ecosystem support
+ * 2. The CNCF Serverless Workflow spec already uses CloudEvents
+ * 3. It provides a standard envelope that external consumers can parse
+ *
+ * Runtime-generated fields not authored here:
+ * - id: unique event identifier (UUID, generated at emit time)
+ * - specversion: always "1.0"
+ * - time: ISO 8601 timestamp of emission
+ * - datacontenttype: always "application/json" (since data is a Struct)
+ *
+ * The runtime (T13) decides how events are delivered: Temporal signals to
+ * other workflows, message queues, webhooks, or event buses. The proto
+ * carries the event specification; delivery is a runtime concern.
+ *
+ * @since T03 (P0 New Task Types)
+ *
+ * @generated from message ai.stigmer.agentic.workflow.v1.tasks.EmitEventSpec
+ */
+export type EmitEventSpec = Message<"ai.stigmer.agentic.workflow.v1.tasks.EmitEventSpec"> & {
+    /**
+     * CloudEvents type identifier.
+     * A reverse-DNS string that categorizes the event for routing and filtering.
+     * Examples: "stigmer.workflow.ticket.classified", "acme.order.completed"
+     *
+     * @generated from field: string type = 1;
+     */
+    type: string;
+    /**
+     * CloudEvents source identifier.
+     * URI or URI-reference that identifies the context in which the event
+     * happened. Supports ${ } expression interpolation.
+     * When empty, the runtime defaults to the workflow execution URI
+     * (e.g., "/workflows/{workflow_id}/executions/{execution_id}").
+     *
+     * @generated from field: string source = 2;
+     */
+    source: string;
+    /**
+     * Event payload data.
+     * Arbitrary JSON object carried as the CloudEvents data attribute.
+     * Values within the Struct can contain ${ } expressions that the
+     * runtime evaluates before emission.
+     *
+     * Unlike other Struct fields in the workflow domain (response_schema,
+     * form_schema, schema) which carry JSON Schema definitions, this field
+     * carries the actual event payload — not a schema.
+     *
+     * @generated from field: google.protobuf.Struct data = 3;
+     */
+    data?: JsonObject;
+    /**
+     * CloudEvents subject identifier.
+     * Describes the subject of the event in the context of the event producer.
+     * Supports ${ } expression interpolation.
+     * Examples: "${ $context.ticket.id }", "${ $context.order.number }"
+     *
+     * @generated from field: string subject = 4;
+     */
+    subject: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.tasks.EmitEventSpec.
+ * Use `create(EmitEventSpecSchema)` to create a new message.
+ */
+export declare const EmitEventSpecSchema: GenMessage<EmitEventSpec>;
+/**
+ * EmitEventTaskConfig defines the configuration for emit_event tasks that
+ * publish CloudEvents to external consumers, other workflows, audit trails,
+ * and metrics systems.
+ *
+ * @internal
+ * emit_event is the complement to listen. While listen waits for Temporal
+ * signals (internal workflow primitives), emit_event publishes business
+ * events using the CloudEvents envelope (a standard external contract).
+ * The runtime (T13) bridges the two: an emitted CloudEvent can be
+ * delivered as a Temporal signal to another workflow's listen task, or
+ * routed to external consumers via message queues, webhooks, or event buses.
+ *
+ * The task output is the fully-resolved CloudEvents envelope with
+ * runtime-generated fields populated:
+ *   {
+ *     "id": "<generated UUID>",
+ *     "specversion": "1.0",
+ *     "type": "stigmer.workflow.ticket.classified",
+ *     "source": "/workflows/triage/executions/abc-123",
+ *     "time": "2026-05-12T14:30:00Z",
+ *     "subject": "TICKET-456",
+ *     "datacontenttype": "application/json",
+ *     "data": { <resolved payload> }
+ *   }
+ *
+ * YAML Example (emit a classification event):
+ *   - notify_classified:
+ *       emit_event:
+ *         event:
+ *           type: "stigmer.workflow.ticket.classified"
+ *           subject: "${ $context.ticket.id }"
+ *           data:
+ *             ticket_id: "${ $context.ticket.id }"
+ *             severity: "${ $context.triage.severity }"
+ *             category: "${ $context.triage.category }"
+ *             classified_by: "${ $context.workflow_instance_id }"
+ *       export:
+ *         as: "${ . }"
+ *
+ * YAML Example (emit with explicit source):
+ *   - publish_completion:
+ *       emit_event:
+ *         event:
+ *           type: "acme.order.fulfilled"
+ *           source: "urn:acme:fulfillment-service"
+ *           subject: "${ $context.order.number }"
+ *           data:
+ *             order_id: "${ $context.order.id }"
+ *             status: "fulfilled"
+ *             fulfilled_at: "${ $context.timestamp }"
+ *       export:
+ *         as: "${ . }"
+ *
+ * @generated from message ai.stigmer.agentic.workflow.v1.tasks.EmitEventTaskConfig
+ */
+export type EmitEventTaskConfig = Message<"ai.stigmer.agentic.workflow.v1.tasks.EmitEventTaskConfig"> & {
+    /**
+     * The event specification to emit.
+     * Contains the CloudEvents envelope fields (type, source, data, subject).
+     * Required field.
+     *
+     * @generated from field: ai.stigmer.agentic.workflow.v1.tasks.EmitEventSpec event = 1;
+     */
+    event?: EmitEventSpec;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.tasks.EmitEventTaskConfig.
+ * Use `create(EmitEventTaskConfigSchema)` to create a new message.
+ */
+export declare const EmitEventTaskConfigSchema: GenMessage<EmitEventTaskConfig>;

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

@@ -0,0 +1,22 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts,import_extension=js"
+// @generated from file ai/stigmer/agentic/workflow/v1/tasks/emit_event.proto (package ai.stigmer.agentic.workflow.v1.tasks, syntax proto3)
+/* eslint-disable */
+import { 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/emit_event.proto.
+ */
+export const file_ai_stigmer_agentic_workflow_v1_tasks_emit_event = /*@__PURE__*/ fileDesc("CjVhaS9zdGlnbWVyL2FnZW50aWMvd29ya2Zsb3cvdjEvdGFza3MvZW1pdF9ldmVudC5wcm90bxIkYWkuc3RpZ21lci5hZ2VudGljLndvcmtmbG93LnYxLnRhc2tzIoABCg1FbWl0RXZlbnRTcGVjEhsKBHR5cGUYASABKAlCDbpICsgBAXIFEAEY/wESFAoGc291cmNlGAIgASgJQgTYhSwBEiUKBGRhdGEYAyABKAsyFy5nb29nbGUucHJvdG9idWYuU3RydWN0EhUKB3N1YmplY3QYBCABKAlCBNiFLAEicQoTRW1pdEV2ZW50VGFza0NvbmZpZxJKCgVldmVudBgBIAEoCzIzLmFpLnN0aWdtZXIuYWdlbnRpYy53b3JrZmxvdy52MS50YXNrcy5FbWl0RXZlbnRTcGVjQga6SAPIAQE6DuqLLAplbWl0X2V2ZW50YgZwcm90bzM", [file_ai_stigmer_commons_apiresource_field_options, file_buf_validate_validate, file_google_protobuf_struct]);
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.tasks.EmitEventSpec.
+ * Use `create(EmitEventSpecSchema)` to create a new message.
+ */
+export const EmitEventSpecSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflow_v1_tasks_emit_event, 0);
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.tasks.EmitEventTaskConfig.
+ * Use `create(EmitEventTaskConfigSchema)` to create a new message.
+ */
+export const EmitEventTaskConfigSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflow_v1_tasks_emit_event, 1);
+//# sourceMappingURL=emit_event_pb.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"emit_event_pb.js","sourceRoot":"","sources":["../../../../../../../ai/stigmer/agentic/workflow/v1/tasks/emit_event_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,2IAA2I;AAC3I,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AACrE,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,oDAAoD,GAAY,aAAa,CACxF,QAAQ,CAAC,idAAid,EAAE,CAAC,iDAAiD,EAAE,0BAA0B,EAAE,2BAA2B,CAAC,CAAC,CAAC;AAuE5kB;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA8B,aAAa,CACzE,WAAW,CAAC,oDAAoD,EAAE,CAAC,CAAC,CAAC;AAqEvE;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAoC,aAAa,CACrF,WAAW,CAAC,oDAAoD,EAAE,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,341 @@
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file ai/stigmer/agentic/workflow/v1/tasks/eval.proto.
+ */
+export declare const file_ai_stigmer_agentic_workflow_v1_tasks_eval: GenFile;
+/**
+ * EvalCriterion defines a single evaluation dimension for multi-criteria mode.
+ *
+ * @internal
+ * When scoring_mode is EVAL_MULTI_CRITERIA, these criteria are included
+ * in the judge prompt as distinct evaluation axes. Each criterion gets
+ * its own score and reasoning in the output.
+ *
+ * @since T17 (Advanced Agentic Orchestration)
+ *
+ * @generated from message ai.stigmer.agentic.workflow.v1.tasks.EvalCriterion
+ */
+export type EvalCriterion = Message<"ai.stigmer.agentic.workflow.v1.tasks.EvalCriterion"> & {
+    /**
+     * Name of this evaluation dimension.
+     * Used in the judge prompt and appears in the output.
+     * Examples: "accuracy", "completeness", "safety", "relevance"
+     *
+     * @generated from field: string name = 1;
+     */
+    name: string;
+    /**
+     * Description of what this criterion measures.
+     * Included in the judge prompt to guide the LLM's assessment.
+     * Example: "Does the response accurately reflect the source data without hallucinations?"
+     *
+     * @generated from field: string description = 2;
+     */
+    description: string;
+    /**
+     * Relative weight for computing the weighted average overall score.
+     * When all weights are equal (or all zero), criteria are averaged uniformly.
+     * Example: accuracy=3.0, formatting=1.0 means accuracy counts 3x more.
+     *
+     * @generated from field: double weight = 3;
+     */
+    weight: number;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.tasks.EvalCriterion.
+ * Use `create(EvalCriterionSchema)` to create a new message.
+ */
+export declare const EvalCriterionSchema: GenMessage<EvalCriterion>;
+/**
+ * EvalTaskConfig defines the configuration for eval tasks that use an LLM
+ * judge to assess the semantic quality of workflow data.
+ *
+ * @internal
+ * Use eval when you need to assess quality, correctness, safety, or
+ * completeness of LLM-generated or agent-produced content. This fills the
+ * gap between structural validation (validate task — JSON Schema, business
+ * rules) and human review (human_input task — manual inspection).
+ *
+ * The eval task constructs a judge prompt from the rubric and subject,
+ * calls the specified LLM with structured output enforcement, parses the
+ * judge's response, and applies the threshold to determine pass/fail.
+ *
+ * Key differences from validate:
+ * - validate checks deterministic structural properties (schema, rules)
+ * - eval checks semantic quality via an LLM judge (hallucination, relevance, safety)
+ *
+ * Key differences from llm_call:
+ * - llm_call is a general-purpose LLM invocation
+ * - eval has built-in judge prompt construction, scoring semantics,
+ *   threshold application, and on_fail branching
+ *
+ * Task output structure:
+ *   {
+ *     "pass": true/false,
+ *     "score": 0.85,              // present for numeric_score and multi_criteria
+ *     "reasoning": "The response...",
+ *     "criteria": [               // present only for multi_criteria
+ *       {"name": "accuracy", "score": 0.9, "reasoning": "..."},
+ *       {"name": "safety", "score": 0.8, "reasoning": "..."}
+ *     ],
+ *     "model_used": "gpt-4o",
+ *     "subject": <original subject data>
+ *   }
+ *
+ * YAML Example (binary pass/fail evaluation):
+ *   - check_summary_quality:
+ *       call: eval
+ *       with:
+ *         model: "gpt-4o"
+ *         subject: "${ $context.summarize.text }"
+ *         rubric: |
+ *           Evaluate whether this summary accurately captures the key points
+ *           of the source document without hallucinations or omissions.
+ *           The summary should be concise (under 3 sentences) and factually
+ *           correct.
+ *         scoring_mode: EVAL_PASS_FAIL
+ *         on_fail: EVAL_FAIL_BRANCH
+ *         fallback_task: regenerate_summary
+ *       export:
+ *         as: "${ . }"
+ *
+ * YAML Example (numeric score with threshold):
+ *   - score_translation:
+ *       call: eval
+ *       with:
+ *         model: "gpt-4o"
+ *         subject: "${ $context.translate.text }"
+ *         rubric: |
+ *           Rate the quality of this translation on accuracy, fluency,
+ *           and preservation of meaning. Score 0.0 (unusable) to 1.0 (perfect).
+ *         scoring_mode: EVAL_NUMERIC_SCORE
+ *         threshold: 0.7
+ *         on_fail: EVAL_FAIL_WARN
+ *       export:
+ *         as: "${ . }"
+ *
+ * YAML Example (multi-criteria evaluation):
+ *   - evaluate_response:
+ *       call: eval
+ *       with:
+ *         model: "gpt-4o"
+ *         subject: "${ $context.agent_response }"
+ *         rubric: "Evaluate this customer support response."
+ *         scoring_mode: EVAL_MULTI_CRITERIA
+ *         threshold: 0.75
+ *         criteria:
+ *           - name: accuracy
+ *             description: "Is the information factually correct?"
+ *             weight: 3.0
+ *           - name: helpfulness
+ *             description: "Does it address the customer's actual question?"
+ *             weight: 2.0
+ *           - name: tone
+ *             description: "Is the tone professional and empathetic?"
+ *             weight: 1.0
+ *         on_fail: EVAL_FAIL_RAISE
+ *       export:
+ *         as: "${ . }"
+ *
+ * @generated from message ai.stigmer.agentic.workflow.v1.tasks.EvalTaskConfig
+ */
+export type EvalTaskConfig = Message<"ai.stigmer.agentic.workflow.v1.tasks.EvalTaskConfig"> & {
+    /**
+     * LLM model used as the judge.
+     * Resolved via the Stigmer model registry.
+     * Examples: "gpt-4o", "claude-sonnet-4-5"
+     *
+     * @generated from field: string model = 1;
+     */
+    model: string;
+    /**
+     * Expression selecting the data to evaluate.
+     * Supports ${ } expression interpolation.
+     * Example: "${ $context.summarize.text }" to evaluate a summary task's output.
+     *
+     * @generated from field: string subject = 2;
+     */
+    subject: string;
+    /**
+     * Evaluation criteria in natural language.
+     * Tells the judge LLM what to assess and what "good" looks like.
+     * For pass_fail: describe what constitutes a pass.
+     * For numeric_score: describe the scoring scale.
+     * For multi_criteria: provide overall context (per-criterion detail goes in criteria field).
+     *
+     * @generated from field: string rubric = 3;
+     */
+    rubric: string;
+    /**
+     * How the judge scores the subject.
+     * Default: EVAL_PASS_FAIL.
+     *
+     * @generated from field: ai.stigmer.agentic.workflow.v1.tasks.EvalScoringMode scoring_mode = 4;
+     */
+    scoringMode: EvalScoringMode;
+    /**
+     * Pass threshold for numeric_score and multi_criteria modes.
+     * The subject passes if score >= threshold.
+     * Ignored for pass_fail mode (the judge's binary decision is used directly).
+     * Valid range: 0.0 to 1.0. Default: 0.5.
+     *
+     * @generated from field: double threshold = 5;
+     */
+    threshold: number;
+    /**
+     * Policy applied when the subject fails evaluation.
+     * Default: EVAL_FAIL_RAISE (task fails with evaluation error).
+     *
+     * @generated from field: ai.stigmer.agentic.workflow.v1.tasks.EvalFailPolicy on_fail = 6;
+     */
+    onFail: EvalFailPolicy;
+    /**
+     * Target task to branch to when on_fail is EVAL_FAIL_BRANCH.
+     * Must reference a valid task name in the same workflow.
+     * Only meaningful when on_fail is EVAL_FAIL_BRANCH; ignored otherwise.
+     *
+     * @generated from field: string fallback_task = 7;
+     */
+    fallbackTask: string;
+    /**
+     * Optional custom system prompt override for the judge LLM.
+     * When set, replaces the auto-generated judge system prompt entirely.
+     * Use only when the default judge prompt template does not fit your needs.
+     * When empty, the runtime constructs a judge-appropriate system prompt
+     * from the rubric, scoring_mode, and criteria.
+     *
+     * @generated from field: string system_prompt = 8;
+     */
+    systemPrompt: string;
+    /**
+     * Evaluation criteria for multi_criteria mode.
+     * Required when scoring_mode is EVAL_MULTI_CRITERIA; ignored otherwise.
+     * Each criterion is scored independently, and the overall score is the
+     * weighted average (uniform if all weights are equal or zero).
+     *
+     * @generated from field: repeated ai.stigmer.agentic.workflow.v1.tasks.EvalCriterion criteria = 9;
+     */
+    criteria: EvalCriterion[];
+    /**
+     * Per-task cost cap in micro-USD (1 USD = 1,000,000 micros).
+     * When set, the runtime terminates this eval call if its cost exceeds
+     * this limit, independent of the workflow-level budget.
+     * Optional — when 0, no per-task cost limit is enforced.
+     *
+     * @since T05 (Workflow-Level Budget Primitives)
+     *
+     * @generated from field: int64 max_cost_micros = 10;
+     */
+    maxCostMicros: bigint;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.tasks.EvalTaskConfig.
+ * Use `create(EvalTaskConfigSchema)` to create a new message.
+ */
+export declare const EvalTaskConfigSchema: GenMessage<EvalTaskConfig>;
+/**
+ * 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 declare enum EvalFailPolicy {
+    /**
+     * Unspecified: defaults to EVAL_FAIL_RAISE behavior.
+     *
+     * @generated from enum value: EVAL_FAIL_POLICY_UNSPECIFIED = 0;
+     */
+    EVAL_FAIL_POLICY_UNSPECIFIED = 0,
+    /**
+     * 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;
+     */
+    EVAL_FAIL_RAISE = 1,
+    /**
+     * 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;
+     */
+    EVAL_FAIL_BRANCH = 2,
+    /**
+     * 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;
+     */
+    EVAL_FAIL_WARN = 3
+}
+/**
+ * Describes the enum ai.stigmer.agentic.workflow.v1.tasks.EvalFailPolicy.
+ */
+export declare const EvalFailPolicySchema: GenEnum<EvalFailPolicy>;
+/**
+ * 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 declare enum EvalScoringMode {
+    /**
+     * Unspecified: defaults to EVAL_PASS_FAIL.
+     *
+     * @generated from enum value: EVAL_SCORING_MODE_UNSPECIFIED = 0;
+     */
+    EVAL_SCORING_MODE_UNSPECIFIED = 0,
+    /**
+     * 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;
+     */
+    EVAL_PASS_FAIL = 1,
+    /**
+     * 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;
+     */
+    EVAL_NUMERIC_SCORE = 2,
+    /**
+     * 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;
+     */
+    EVAL_MULTI_CRITERIA = 3
+}
+/**
+ * Describes the enum ai.stigmer.agentic.workflow.v1.tasks.EvalScoringMode.
+ */
+export declare const EvalScoringModeSchema: GenEnum<EvalScoringMode>;