@stigmer/protos 0.5.1 → 1.0.0

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

@@ -0,0 +1,80 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts,import_extension=js"
+// @generated from file ai/stigmer/agentic/workflow/v1/tasks/human_input.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/human_input.proto.
+ */
+export const file_ai_stigmer_agentic_workflow_v1_tasks_human_input = /*@__PURE__*/ fileDesc("CjZhaS9zdGlnbWVyL2FnZW50aWMvd29ya2Zsb3cvdjEvdGFza3MvaHVtYW5faW5wdXQucHJvdG8SJGFpLnN0aWdtZXIuYWdlbnRpYy53b3JrZmxvdy52MS50YXNrcyJMChFIdW1hbklucHV0T3V0Y29tZRIaCgRuYW1lGAEgASgJQgy6SAnIAQFyBBABGD8SDQoFbGFiZWwYAiABKAkSDAoEdGhlbhgDIAEoCSLkAgoUSHVtYW5JbnB1dFRhc2tDb25maWcSHgoGcHJvbXB0GAEgASgJQg66SAfIAQFyAhAB2IUsARIsCgtmb3JtX3NjaGVtYRgCIAEoCzIXLmdvb2dsZS5wcm90b2J1Zi5TdHJ1Y3QSSQoIb3V0Y29tZXMYAyADKAsyNy5haS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3cudjEudGFza3MuSHVtYW5JbnB1dE91dGNvbWUSEQoJYXBwcm92ZXJzGAQgAygJEh0KB3RpbWVvdXQYBSABKAVCDLpICRoHGICangEoABJRCgpvbl90aW1lb3V0GAYgASgOMj0uYWkuc3RpZ21lci5hZ2VudGljLndvcmtmbG93LnYxLnRhc2tzLkh1bWFuSW5wdXRUaW1lb3V0UG9saWN5Eh0KFW5vdGlmaWNhdGlvbl9jaGFubmVscxgHIAMoCToP6ossC2h1bWFuX2lucHV0KsQBChdIdW1hbklucHV0VGltZW91dFBvbGljeRIqCiZIVU1BTl9JTlBVVF9USU1FT1VUX1BPTElDWV9VTlNQRUNJRklFRBAAEhwKGEhVTUFOX0lOUFVUX1RJTUVPVVRfRkFJTBABEh8KG0hVTUFOX0lOUFVUX1RJTUVPVVRfQVBQUk9WRRACEhwKGEhVTUFOX0lOUFVUX1RJTUVPVVRfREVOWRADEiAKHEhVTUFOX0lOUFVUX1RJTUVPVVRfRVNDQUxBVEUQBGIGcHJvdG8z", [file_ai_stigmer_commons_apiresource_field_options, file_buf_validate_validate, file_google_protobuf_struct]);
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.tasks.HumanInputOutcome.
+ * Use `create(HumanInputOutcomeSchema)` to create a new message.
+ */
+export const HumanInputOutcomeSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflow_v1_tasks_human_input, 0);
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.tasks.HumanInputTaskConfig.
+ * Use `create(HumanInputTaskConfigSchema)` to create a new message.
+ */
+export const HumanInputTaskConfigSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflow_v1_tasks_human_input, 1);
+/**
+ * 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 var HumanInputTimeoutPolicy;
+(function (HumanInputTimeoutPolicy) {
+    /**
+     * Unspecified: defaults to HUMAN_INPUT_TIMEOUT_FAIL behavior.
+     *
+     * @generated from enum value: HUMAN_INPUT_TIMEOUT_POLICY_UNSPECIFIED = 0;
+     */
+    HumanInputTimeoutPolicy[HumanInputTimeoutPolicy["HUMAN_INPUT_TIMEOUT_POLICY_UNSPECIFIED"] = 0] = "HUMAN_INPUT_TIMEOUT_POLICY_UNSPECIFIED";
+    /**
+     * 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;
+     */
+    HumanInputTimeoutPolicy[HumanInputTimeoutPolicy["HUMAN_INPUT_TIMEOUT_FAIL"] = 1] = "HUMAN_INPUT_TIMEOUT_FAIL";
+    /**
+     * 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;
+     */
+    HumanInputTimeoutPolicy[HumanInputTimeoutPolicy["HUMAN_INPUT_TIMEOUT_APPROVE"] = 2] = "HUMAN_INPUT_TIMEOUT_APPROVE";
+    /**
+     * 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;
+     */
+    HumanInputTimeoutPolicy[HumanInputTimeoutPolicy["HUMAN_INPUT_TIMEOUT_DENY"] = 3] = "HUMAN_INPUT_TIMEOUT_DENY";
+    /**
+     * 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;
+     */
+    HumanInputTimeoutPolicy[HumanInputTimeoutPolicy["HUMAN_INPUT_TIMEOUT_ESCALATE"] = 4] = "HUMAN_INPUT_TIMEOUT_ESCALATE";
+})(HumanInputTimeoutPolicy || (HumanInputTimeoutPolicy = {}));
+/**
+ * Describes the enum ai.stigmer.agentic.workflow.v1.tasks.HumanInputTimeoutPolicy.
+ */
+export const HumanInputTimeoutPolicySchema = /*@__PURE__*/ enumDesc(file_ai_stigmer_agentic_workflow_v1_tasks_human_input, 0);
+//# sourceMappingURL=human_input_pb.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"human_input_pb.js","sourceRoot":"","sources":["../../../../../../../ai/stigmer/agentic/workflow/v1/tasks/human_input_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,4IAA4I;AAC5I,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,qDAAqD,GAAY,aAAa,CACzF,QAAQ,CAAC,09BAA09B,EAAE,CAAC,iDAAiD,EAAE,0BAA0B,EAAE,2BAA2B,CAAC,CAAC,CAAC;AAgDrlC;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAkC,aAAa,CACjF,WAAW,CAAC,qDAAqD,EAAE,CAAC,CAAC,CAAC;AAiLxE;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAqC,aAAa,CACvF,WAAW,CAAC,qDAAqD,EAAE,CAAC,CAAC,CAAC;AAExE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAN,IAAY,uBA2CX;AA3CD,WAAY,uBAAuB;IACjC;;;;OAIG;IACH,yIAA0C,CAAA;IAE1C;;;;;OAKG;IACH,6GAA4B,CAAA;IAE5B;;;;;;OAMG;IACH,mHAA+B,CAAA;IAE/B;;;;;;OAMG;IACH,6GAA4B,CAAA;IAE5B;;;;;;;OAOG;IACH,qHAAgC,CAAA;AAClC,CAAC,EA3CW,uBAAuB,KAAvB,uBAAuB,QA2ClC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAqC,aAAa,CAC1F,QAAQ,CAAC,qDAAqD,EAAE,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,186 @@
+import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
+import type { OnInvalidOutputPolicy } from "./common_pb.js";
+import type { JsonObject, Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file ai/stigmer/agentic/workflow/v1/tasks/llm_call.proto.
+ */
+export declare const file_ai_stigmer_agentic_workflow_v1_tasks_llm_call: GenFile;
+/**
+ * LlmCallTaskConfig defines the configuration for llm_call tasks that make
+ * direct LLM API calls without the overhead of a full agent invocation.
+ *
+ * @internal
+ * Use llm_call when the task is focused and deterministic: classification,
+ * extraction, scoring, summarization, moderation, or routing. An agent_call
+ * carries setup overhead (system prompt, tool resolution, MCP server setup,
+ * session management) that is unnecessary when all you need is a single
+ * prompt-response cycle with optional structured output.
+ *
+ * When response_schema is set, the runner requests structured output from the
+ * provider and validates the response against the schema. The on_invalid /
+ * max_retries / fallback_task fields control what happens when validation fails,
+ * using the same OnInvalidOutputPolicy enum as agent_call's output contract.
+ *
+ * YAML Example (classification with structured output):
+ *   - classify_severity:
+ *       call: llm
+ *       with:
+ *         model: "gpt-4o-mini"
+ *         system_prompt: "You are a support ticket classifier."
+ *         prompt: "Classify this ticket: ${ $context.ticket.description }"
+ *         response_schema:
+ *           type: object
+ *           required: [severity, category]
+ *           properties:
+ *             severity:
+ *               type: string
+ *               enum: [low, medium, high, critical]
+ *             category:
+ *               type: string
+ *         on_invalid: ON_INVALID_RETRY
+ *         max_retries: 2
+ *       export:
+ *         as: "${ . }"
+ *
+ * YAML Example (simple summarization, no schema):
+ *   - summarize:
+ *       call: llm
+ *       with:
+ *         model: "claude-sonnet-4-5"
+ *         prompt: "Summarize in 2 sentences: ${ $context.document.text }"
+ *         temperature: 0.3
+ *         max_tokens: 200
+ *       export:
+ *         as: "${ . }"
+ *
+ * @generated from message ai.stigmer.agentic.workflow.v1.tasks.LlmCallTaskConfig
+ */
+export type LlmCallTaskConfig = Message<"ai.stigmer.agentic.workflow.v1.tasks.LlmCallTaskConfig"> & {
+    /**
+     * Model reference resolved via the Stigmer model registry.
+     * Examples: "gpt-4o", "gpt-4o-mini", "claude-sonnet-4-5", "claude-haiku-3-5"
+     * Required field.
+     *
+     * @generated from field: string model = 1;
+     */
+    model: string;
+    /**
+     * System prompt that sets the LLM's role and constraints.
+     * Supports ${ } expression interpolation for dynamic system prompts.
+     * Optional — omit for tasks where the user prompt is self-contained.
+     *
+     * @generated from field: string system_prompt = 2;
+     */
+    systemPrompt: string;
+    /**
+     * User prompt / instruction sent to the LLM.
+     * Supports ${ } expression interpolation for injecting workflow context.
+     * Example: "Classify this ticket: ${ $context.ticket.description }"
+     * Required field.
+     *
+     * @generated from field: string prompt = 3;
+     */
+    prompt: string;
+    /**
+     * JSON Schema for structured output.
+     *
+     * When set, the runner requests structured output from the provider
+     * (e.g., OpenAI's response_format, Anthropic's tool_use extraction)
+     * and validates the response against this schema.
+     *
+     * Uses the same google.protobuf.Struct + JSON Schema pattern as
+     * AgentCallOutputContract.schema for consistency across the workflow domain.
+     *
+     * When not set, the task output is the LLM's raw text response.
+     *
+     * @generated from field: google.protobuf.Struct response_schema = 4;
+     */
+    responseSchema?: JsonObject;
+    /**
+     * Sampling temperature (0.0 to 2.0).
+     * Lower = more deterministic, higher = more creative.
+     * Range is 0.0-2.0 to accommodate all major providers (OpenAI supports
+     * up to 2.0; others clamp to their supported range at runtime).
+     * Optional — uses the provider's default when not set.
+     *
+     * @generated from field: float temperature = 5;
+     */
+    temperature: number;
+    /**
+     * Maximum tokens in the LLM response.
+     * Optional — uses the provider's default when not set.
+     *
+     * @generated from field: int32 max_tokens = 6;
+     */
+    maxTokens: number;
+    /**
+     * Timeout for the LLM call in seconds.
+     * Default: 60. Max: 600 (10 minutes).
+     * Optional.
+     *
+     * @generated from field: int32 timeout = 7;
+     */
+    timeout: number;
+    /**
+     * Policy when the LLM response fails schema validation.
+     * Only meaningful when response_schema is set; ignored otherwise.
+     * Default: ON_INVALID_FAIL (task fails immediately).
+     *
+     * @generated from field: ai.stigmer.agentic.workflow.v1.tasks.OnInvalidOutputPolicy on_invalid = 8;
+     */
+    onInvalid: OnInvalidOutputPolicy;
+    /**
+     * Maximum schema-validation retry attempts when on_invalid is ON_INVALID_RETRY.
+     *
+     * Each retry re-prompts the LLM with the validation errors and expected
+     * schema, giving it an opportunity to self-correct.
+     *
+     * Only meaningful when on_invalid is ON_INVALID_RETRY; ignored otherwise.
+     * Default: 1. Valid range: 1-5.
+     *
+     * @generated from field: int32 max_retries = 9;
+     */
+    maxRetries: number;
+    /**
+     * Target task to branch to when schema validation cannot be resolved.
+     *
+     * Used in two scenarios:
+     * 1. on_invalid is ON_INVALID_RETRY and all retries are exhausted
+     * 2. on_invalid is ON_INVALID_FALLBACK (immediate branch, no retry)
+     *
+     * Must reference a valid task name in the same workflow.
+     * When empty and retries are exhausted, the task fails.
+     *
+     * @generated from field: string fallback_task = 10;
+     */
+    fallbackTask: string;
+    /**
+     * Per-task cost cap in micro-USD (1 USD = 1,000,000 micros).
+     * When set, the runtime terminates this specific LLM call if its cost
+     * exceeds this limit, independent of the workflow-level budget.
+     * The runtime checks both: per-task limit first, then workflow remaining budget.
+     * Optional — when 0, no per-task cost limit is enforced.
+     *
+     * @since T05 (Workflow-Level Budget Primitives)
+     *
+     * @generated from field: int64 max_cost_micros = 11;
+     */
+    maxCostMicros: bigint;
+    /**
+     * Per-task token cap (input + output tokens combined).
+     * When set, the runtime terminates this specific LLM call if total tokens
+     * exceed this limit. Complements max_tokens (field 6), which limits only
+     * the output token count as a generation parameter.
+     * Optional — when 0, no per-task total token limit is enforced.
+     *
+     * @since T05 (Workflow-Level Budget Primitives)
+     *
+     * @generated from field: int64 max_total_tokens = 12;
+     */
+    maxTotalTokens: bigint;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.tasks.LlmCallTaskConfig.
+ * Use `create(LlmCallTaskConfigSchema)` to create a new message.
+ */
+export declare const LlmCallTaskConfigSchema: GenMessage<LlmCallTaskConfig>;

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

@@ -0,0 +1,18 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts,import_extension=js"
+// @generated from file ai/stigmer/agentic/workflow/v1/tasks/llm_call.proto (package ai.stigmer.agentic.workflow.v1.tasks, syntax proto3)
+/* eslint-disable */
+import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv1";
+import { file_ai_stigmer_agentic_workflow_v1_tasks_common } from "./common_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";
+import { file_google_protobuf_struct } from "@bufbuild/protobuf/wkt";
+/**
+ * Describes the file ai/stigmer/agentic/workflow/v1/tasks/llm_call.proto.
+ */
+export const file_ai_stigmer_agentic_workflow_v1_tasks_llm_call = /*@__PURE__*/ fileDesc("CjNhaS9zdGlnbWVyL2FnZW50aWMvd29ya2Zsb3cvdjEvdGFza3MvbGxtX2NhbGwucHJvdG8SJGFpLnN0aWdtZXIuYWdlbnRpYy53b3JrZmxvdy52MS50YXNrcyLIAwoRTGxtQ2FsbFRhc2tDb25maWcSGwoFbW9kZWwYASABKAlCDLpICcgBAXIEEAEYfxIbCg1zeXN0ZW1fcHJvbXB0GAIgASgJQgTYhSwBEh4KBnByb21wdBgDIAEoCUIOukgHyAEBcgIQAdiFLAESMAoPcmVzcG9uc2Vfc2NoZW1hGAQgASgLMhcuZ29vZ2xlLnByb3RvYnVmLlN0cnVjdBIkCgt0ZW1wZXJhdHVyZRgFIAEoAkIPukgMCgodAAAAQC0AAAAAEhsKCm1heF90b2tlbnMYBiABKAVCB7pIBBoCKAESGwoHdGltZW91dBgHIAEoBUIKukgHGgUY2AQoARJPCgpvbl9pbnZhbGlkGAggASgOMjsuYWkuc3RpZ21lci5hZ2VudGljLndvcmtmbG93LnYxLnRhc2tzLk9uSW52YWxpZE91dHB1dFBvbGljeRIeCgttYXhfcmV0cmllcxgJIAEoBUIJukgGGgQYBSgBEhUKDWZhbGxiYWNrX3Rhc2sYCiABKAkSFwoPbWF4X2Nvc3RfbWljcm9zGAsgASgDEhgKEG1heF90b3RhbF90b2tlbnMYDCABKAM6DOqLLAhsbG1fY2FsbGIGcHJvdG8z", [file_ai_stigmer_agentic_workflow_v1_tasks_common, file_ai_stigmer_commons_apiresource_field_options, file_buf_validate_validate, file_google_protobuf_struct]);
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.tasks.LlmCallTaskConfig.
+ * Use `create(LlmCallTaskConfigSchema)` to create a new message.
+ */
+export const LlmCallTaskConfigSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflow_v1_tasks_llm_call, 0);
+//# sourceMappingURL=llm_call_pb.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"llm_call_pb.js","sourceRoot":"","sources":["../../../../../../../ai/stigmer/agentic/workflow/v1/tasks/llm_call_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,yIAAyI;AACzI,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,gDAAgD,EAAE,MAAM,gBAAgB,CAAC;AAClF,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,0uBAA0uB,EAAE,CAAC,gDAAgD,EAAE,iDAAiD,EAAE,0BAA0B,EAAE,2BAA2B,CAAC,CAAC,CAAC;AA4Lv5B;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAkC,aAAa,CACjF,WAAW,CAAC,kDAAkD,EAAE,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,160 @@
+import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file ai/stigmer/agentic/workflow/v1/tasks/notification.proto.
+ */
+export declare const file_ai_stigmer_agentic_workflow_v1_tasks_notification: GenFile;
+/**
+ * NotificationTaskConfig defines the configuration for notification tasks
+ * that send messages to humans through channels like Slack, email, Discord,
+ * Microsoft Teams, or webhooks.
+ *
+ * @internal
+ * notification is a convenience abstraction for "send a message to humans"
+ * — simpler and more intuitive than emit_event for common operational
+ * notification patterns. While emit_event publishes system-level CloudEvents
+ * for machine consumption, notification is purpose-built for human-readable
+ * messages with channel routing and recipient targeting.
+ *
+ * Key distinction from related task types:
+ *   emit_event = system-to-system (CloudEvents, consumed by workflows/services)
+ *   notification = system-to-human (Slack, email, Discord — read by people)
+ *   human_input = system-to-human-to-system (waits for a response; notification
+ *                 is fire-and-forget)
+ *
+ * Notifications are fire-and-forget by default. The task output confirms
+ * delivery was attempted but does not wait for acknowledgment:
+ *   {
+ *     "channel": "slack",
+ *     "recipients": ["#incident-response"],
+ *     "delivered": true,
+ *     "delivered_at": "<ISO 8601 timestamp>"
+ *   }
+ *
+ * For notifications that require acknowledgment or a response, use
+ * human_input instead — it pauses the workflow until a human responds.
+ *
+ * The channel field is a string (not an enum) to allow extensibility:
+ * new notification channels can be added without proto changes. The
+ * runtime (T13) resolves channel identifiers to actual notification
+ * providers configured in the workflow instance's environment.
+ *
+ * YAML Example (Slack notification):
+ *   - alert_slack:
+ *       notification:
+ *         channel: "slack"
+ *         recipients:
+ *           - "#incident-response"
+ *           - "@oncall-lead"
+ *         subject: "P${ $context.triage.severity } Incident: ${ $context.ticket.title }"
+ *         body: |
+ *           *Severity*: ${ $context.triage.severity }
+ *           *Category*: ${ $context.triage.category }
+ *           *Customer Impact*: ${ $context.triage.customer_impact }
+ *           *Summary*: ${ $context.agent_analysis.structured.summary }
+ *         metadata:
+ *           thread_ts: "${ $context.slack_thread_id }"
+ *       export:
+ *         as: "${ . }"
+ *
+ * YAML Example (email with template):
+ *   - send_confirmation:
+ *       notification:
+ *         channel: "email"
+ *         recipients:
+ *           - "${ $context.customer.email }"
+ *         subject: "Order ${ $context.order.number } Confirmed"
+ *         body: "Your order has been confirmed. You will receive tracking information shortly."
+ *         template: "order-confirmation"
+ *         metadata:
+ *           priority: "high"
+ *           reply_to: "support@acme.com"
+ *       export:
+ *         as: "${ . }"
+ *
+ * @generated from message ai.stigmer.agentic.workflow.v1.tasks.NotificationTaskConfig
+ */
+export type NotificationTaskConfig = Message<"ai.stigmer.agentic.workflow.v1.tasks.NotificationTaskConfig"> & {
+    /**
+     * Notification channel identifier.
+     * Determines which notification provider processes this message.
+     * Common values: "slack", "email", "discord", "teams", "webhook"
+     *
+     * This is a string (not an enum) for extensibility — new channels can
+     * be added without proto changes. The runtime resolves the channel to
+     * its configured provider in the workflow instance's environment.
+     *
+     * @generated from field: string channel = 1;
+     */
+    channel: string;
+    /**
+     * Recipient identifiers for the notification.
+     * Format depends on the channel:
+     *   - slack: "#channel-name", "@username", or Slack user IDs
+     *   - email: "user@example.com"
+     *   - discord: "#channel-name", "@role"
+     *   - teams: "#channel-name"
+     *   - webhook: URL or webhook identifier
+     *
+     * At least one recipient is required.
+     * Individual values may contain ${ } expressions that the runtime
+     * evaluates before delivery (e.g., "${ $context.customer.email }").
+     *
+     * @generated from field: repeated string recipients = 2;
+     */
+    recipients: string[];
+    /**
+     * Notification subject or title.
+     * Supports ${ } expression interpolation.
+     * Used as: email subject line, Slack message title, webhook payload title.
+     * Optional — some channels (e.g., simple Slack messages) may not use it.
+     *
+     * @generated from field: string subject = 3;
+     */
+    subject: string;
+    /**
+     * Notification body / message content.
+     * Supports ${ } expression interpolation.
+     * The primary content of the notification. Formatting depends on channel
+     * (e.g., Slack Markdown, HTML for email, plain text for SMS).
+     *
+     * When template is also set, body serves as the fallback content if the
+     * template cannot be resolved.
+     *
+     * @generated from field: string body = 4;
+     */
+    body: string;
+    /**
+     * Named template reference for rendering the notification.
+     * When set, the runtime looks up this template in the workflow instance's
+     * environment and uses it for rendering, with the workflow context as
+     * template data. The body field is used as fallback if the template
+     * cannot be resolved.
+     *
+     * Examples: "incident-alert", "order-confirmation", "approval-request"
+     * Template resolution and rendering is a runtime concern (T13).
+     *
+     * @generated from field: string template = 5;
+     */
+    template: string;
+    /**
+     * Channel-specific metadata as key-value pairs.
+     * Provides additional configuration that varies by notification channel:
+     *   - slack: {"thread_ts": "...", "unfurl_links": "false"}
+     *   - email: {"priority": "high", "reply_to": "...", "cc": "..."}
+     *   - webhook: {"method": "POST", "content_type": "application/json"}
+     *
+     * Values may contain ${ } expressions that the runtime evaluates
+     * before delivery.
+     *
+     * @generated from field: map<string, string> metadata = 6;
+     */
+    metadata: {
+        [key: string]: string;
+    };
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.tasks.NotificationTaskConfig.
+ * Use `create(NotificationTaskConfigSchema)` to create a new message.
+ */
+export declare const NotificationTaskConfigSchema: GenMessage<NotificationTaskConfig>;

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

@@ -0,0 +1,16 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts,import_extension=js"
+// @generated from file ai/stigmer/agentic/workflow/v1/tasks/notification.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";
+/**
+ * Describes the file ai/stigmer/agentic/workflow/v1/tasks/notification.proto.
+ */
+export const file_ai_stigmer_agentic_workflow_v1_tasks_notification = /*@__PURE__*/ fileDesc("CjdhaS9zdGlnbWVyL2FnZW50aWMvd29ya2Zsb3cvdjEvdGFza3Mvbm90aWZpY2F0aW9uLnByb3RvEiRhaS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3cudjEudGFza3MivQIKFk5vdGlmaWNhdGlvblRhc2tDb25maWcSHQoHY2hhbm5lbBgBIAEoCUIMukgJyAEBcgQQARg/EhwKCnJlY2lwaWVudHMYAiADKAlCCLpIBZIBAggBEhUKB3N1YmplY3QYAyABKAlCBNiFLAESHAoEYm9keRgEIAEoCUIOukgHyAEBcgIQAdiFLAESEAoIdGVtcGxhdGUYBSABKAkSXAoIbWV0YWRhdGEYBiADKAsySi5haS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3cudjEudGFza3MuTm90aWZpY2F0aW9uVGFza0NvbmZpZy5NZXRhZGF0YUVudHJ5Gi8KDU1ldGFkYXRhRW50cnkSCwoDa2V5GAEgASgJEg0KBXZhbHVlGAIgASgJOgI4AToQ6ossDG5vdGlmaWNhdGlvbmIGcHJvdG8z", [file_ai_stigmer_commons_apiresource_field_options, file_buf_validate_validate]);
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.tasks.NotificationTaskConfig.
+ * Use `create(NotificationTaskConfigSchema)` to create a new message.
+ */
+export const NotificationTaskConfigSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflow_v1_tasks_notification, 0);
+//# sourceMappingURL=notification_pb.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notification_pb.js","sourceRoot":"","sources":["../../../../../../../ai/stigmer/agentic/workflow/v1/tasks/notification_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,6IAA6I;AAC7I,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;AAG3F;;GAEG;AACH,MAAM,CAAC,MAAM,sDAAsD,GAAY,aAAa,CAC1F,QAAQ,CAAC,sjBAAsjB,EAAE,CAAC,iDAAiD,EAAE,0BAA0B,CAAC,CAAC,CAAC;AA2JppB;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAuC,aAAa,CAC3F,WAAW,CAAC,sDAAsD,EAAE,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,124 @@
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file ai/stigmer/agentic/workflow/v1/tasks/transform.proto.
+ */
+export declare const file_ai_stigmer_agentic_workflow_v1_tasks_transform: GenFile;
+/**
+ * TransformTaskConfig defines the configuration for transform tasks that
+ * perform deterministic data transformation without LLM calls.
+ *
+ * @internal
+ * Use transform when you need to reshape data between tasks: projecting
+ * fields, joining objects, converting formats, or building API payloads.
+ * Unlike set_vars (which mutates workflow state variables as a side effect),
+ * transform produces an explicit output that flows through export like any
+ * other task — visible and inspectable in the execution viewer.
+ *
+ * The distinction from set_vars:
+ *   set_vars = imperative assignment ("set X to Y"), mutates workflow context
+ *   transform = functional transformation ("reshape this data"), produces output
+ *
+ * YAML Example (JQ — reshape data for an API call):
+ *   - build_api_payload:
+ *       transform:
+ *         engine: jq
+ *         expression: '{name: .customer.full_name, severity: .triage.severity, summary: .agent_analysis.structured.summary}'
+ *         input: "${ $context }"
+ *       export:
+ *         as: "${ . }"
+ *
+ * YAML Example (template — render a notification message):
+ *   - render_notification:
+ *       transform:
+ *         engine: template
+ *         expression: "Ticket {{ .ticket_id }} classified as {{ .severity }} — {{ .summary }}"
+ *         input: "${ $context.build_api_payload }"
+ *       export:
+ *         as: "${ . }"
+ *
+ * @generated from message ai.stigmer.agentic.workflow.v1.tasks.TransformTaskConfig
+ */
+export type TransformTaskConfig = Message<"ai.stigmer.agentic.workflow.v1.tasks.TransformTaskConfig"> & {
+    /**
+     * Transformation engine to use.
+     * Required — must be explicitly set (not UNSPECIFIED).
+     *
+     * @generated from field: ai.stigmer.agentic.workflow.v1.tasks.TransformEngine engine = 1;
+     */
+    engine: TransformEngine;
+    /**
+     * Transformation expression in the chosen engine's syntax.
+     *
+     * For JQ: a JQ filter expression (e.g., '{name: .full_name}')
+     * For JSONata: a JSONata expression (e.g., '{"name": full_name}')
+     * For TEMPLATE: a Go text/template string with {{ }} placeholders
+     *
+     * Required field.
+     *
+     * @generated from field: string expression = 2;
+     */
+    expression: string;
+    /**
+     * Expression selecting the input data for the transformation.
+     * Supports ${ } expression interpolation.
+     * When omitted, the entire workflow context is used as input.
+     * Example: "${ $context.triage }" to transform just the triage output.
+     *
+     * @generated from field: string input = 3;
+     */
+    input: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.tasks.TransformTaskConfig.
+ * Use `create(TransformTaskConfigSchema)` to create a new message.
+ */
+export declare const TransformTaskConfigSchema: GenMessage<TransformTaskConfig>;
+/**
+ * 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 declare enum TransformEngine {
+    /**
+     * Default value, not a valid engine. Must be explicitly set.
+     *
+     * @generated from enum value: TRANSFORM_ENGINE_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * 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;
+     */
+    JQ = 1,
+    /**
+     * 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;
+     */
+    JSONATA = 2,
+    /**
+     * 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;
+     */
+    TEMPLATE = 3
+}
+/**
+ * Describes the enum ai.stigmer.agentic.workflow.v1.tasks.TransformEngine.
+ */
+export declare const TransformEngineSchema: GenEnum<TransformEngine>;