@stigmer/protos 1.0.3 → 2.0.0

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

@@ -4,13 +4,14 @@
 import { fileDesc, serviceDesc } from "@bufbuild/protobuf/codegenv1";
 import { file_ai_stigmer_agentic_workflow_v1_api } from "./api_pb.js";
 import { file_ai_stigmer_agentic_workflow_v1_io } from "./io_pb.js";
+import { file_ai_stigmer_agentic_workflow_v1_version } from "./version_pb.js";
 import { file_ai_stigmer_commons_apiresource_io } from "../../../commons/apiresource/io_pb.js";
 import { file_ai_stigmer_commons_apiresource_rpc_service_options } from "../../../commons/apiresource/rpc_service_options_pb.js";
 import { file_ai_stigmer_commons_rpc_method_options } from "../../../commons/rpc/method_options_pb.js";
 /**
  * Describes the file ai/stigmer/agentic/workflow/v1/query.proto.
  */
-export const file_ai_stigmer_agentic_workflow_v1_query = /*@__PURE__*/ fileDesc("CiphaS9zdGlnbWVyL2FnZW50aWMvd29ya2Zsb3cvdjEvcXVlcnkucHJvdG8SHmFpLnN0aWdtZXIuYWdlbnRpYy53b3JrZmxvdy52MTKkAgoXV29ya2Zsb3dRdWVyeUNvbnRyb2xsZXISigEKA2dldBIqLmFpLnN0aWdtZXIuYWdlbnRpYy53b3JrZmxvdy52MS5Xb3JrZmxvd0lkGiguYWkuc3RpZ21lci5hZ2VudGljLndvcmtmbG93LnYxLldvcmtmbG93Ii3CuBgpCAEQMiIFdmFsdWUqHHVuYXV0aG9yaXplZCB0byBnZXQgd29ya2Zsb3cSdgoOZ2V0QnlSZWZlcmVuY2USNC5haS5zdGlnbWVyLmNvbW1vbnMuYXBpcmVzb3VyY2UuQXBpUmVzb3VyY2VSZWZlcmVuY2UaKC5haS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3cudjEuV29ya2Zsb3ciBNC4GAEaBKD/KzJiBnByb3RvMw", [file_ai_stigmer_agentic_workflow_v1_api, file_ai_stigmer_agentic_workflow_v1_io, file_ai_stigmer_commons_apiresource_io, file_ai_stigmer_commons_apiresource_rpc_service_options, file_ai_stigmer_commons_rpc_method_options]);
+export const file_ai_stigmer_agentic_workflow_v1_query = /*@__PURE__*/ fileDesc("CiphaS9zdGlnbWVyL2FnZW50aWMvd29ya2Zsb3cvdjEvcXVlcnkucHJvdG8SHmFpLnN0aWdtZXIuYWdlbnRpYy53b3JrZmxvdy52MTLvBAoXV29ya2Zsb3dRdWVyeUNvbnRyb2xsZXISigEKA2dldBIqLmFpLnN0aWdtZXIuYWdlbnRpYy53b3JrZmxvdy52MS5Xb3JrZmxvd0lkGiguYWkuc3RpZ21lci5hZ2VudGljLndvcmtmbG93LnYxLldvcmtmbG93Ii3CuBgpCAEQMiIFdmFsdWUqHHVuYXV0aG9yaXplZCB0byBnZXQgd29ya2Zsb3cSdgoOZ2V0QnlSZWZlcmVuY2USNC5haS5zdGlnbWVyLmNvbW1vbnMuYXBpcmVzb3VyY2UuQXBpUmVzb3VyY2VSZWZlcmVuY2UaKC5haS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3cudjEuV29ya2Zsb3ciBNC4GAESjQEKDGxpc3RWZXJzaW9ucxI5LmFpLnN0aWdtZXIuYWdlbnRpYy53b3JrZmxvdy52MS5MaXN0V29ya2Zsb3dWZXJzaW9uc0lucHV0GjwuYWkuc3RpZ21lci5hZ2VudGljLndvcmtmbG93LnYxLkxpc3RXb3JrZmxvd1ZlcnNpb25zUmVzcG9uc2UiBNC4GAESuAEKCmdldFZlcnNpb24SNy5haS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3cudjEuR2V0V29ya2Zsb3dWZXJzaW9uSW5wdXQaNC5haS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3cudjEuV29ya2Zsb3dWZXJzaW9uRW50cnkiO8K4GDcIARAyIgt3b3JrZmxvd19pZCokdW5hdXRob3JpemVkIHRvIGdldCB3b3JrZmxvdyB2ZXJzaW9uGgSg/ysyYgZwcm90bzM", [file_ai_stigmer_agentic_workflow_v1_api, file_ai_stigmer_agentic_workflow_v1_io, file_ai_stigmer_agentic_workflow_v1_version, file_ai_stigmer_commons_apiresource_io, file_ai_stigmer_commons_apiresource_rpc_service_options, file_ai_stigmer_commons_rpc_method_options]);
 /**
  * WorkflowQueryController handles read operations for workflows.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"query_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/workflow/v1/query_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,0HAA0H;AAC1H,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,uCAAuC,EAAE,MAAM,aAAa,CAAC;AAEtE,OAAO,EAAE,sCAAsC,EAAE,MAAM,YAAY,CAAC;AAEpE,OAAO,EAAE,sCAAsC,EAAE,MAAM,uCAAuC,CAAC;AAC/F,OAAO,EAAE,uDAAuD,EAAE,MAAM,wDAAwD,CAAC;AACjI,OAAO,EAAE,0CAA0C,EAAE,MAAM,2CAA2C,CAAC;AAEvG;;GAEG;AACH,MAAM,CAAC,MAAM,yCAAyC,GAAY,aAAa,CAC7E,QAAQ,CAAC,4fAA4f,EAAE,CAAC,uCAAuC,EAAE,sCAAsC,EAAE,sCAAsC,EAAE,uDAAuD,EAAE,0CAA0C,CAAC,CAAC,CAAC;AAEzuB;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GA0B/B,aAAa,CAChB,WAAW,CAAC,yCAAyC,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"query_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/workflow/v1/query_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,0HAA0H;AAC1H,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,uCAAuC,EAAE,MAAM,aAAa,CAAC;AAEtE,OAAO,EAAE,sCAAsC,EAAE,MAAM,YAAY,CAAC;AAEpE,OAAO,EAAE,2CAA2C,EAAE,MAAM,iBAAiB,CAAC;AAE9E,OAAO,EAAE,sCAAsC,EAAE,MAAM,uCAAuC,CAAC;AAC/F,OAAO,EAAE,uDAAuD,EAAE,MAAM,wDAAwD,CAAC;AACjI,OAAO,EAAE,0CAA0C,EAAE,MAAM,2CAA2C,CAAC;AAEvG;;GAEG;AACH,MAAM,CAAC,MAAM,yCAAyC,GAAY,aAAa,CAC7E,QAAQ,CAAC,q7BAAq7B,EAAE,CAAC,uCAAuC,EAAE,sCAAsC,EAAE,2CAA2C,EAAE,sCAAsC,EAAE,uDAAuD,EAAE,0CAA0C,CAAC,CAAC,CAAC;AAE/sC;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAoE/B,aAAa,CAChB,WAAW,CAAC,yCAAyC,EAAE,CAAC,CAAC,CAAC"}

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

@@ -40,6 +40,28 @@ export type WorkflowStatus = Message<"ai.stigmer.agentic.workflow.v1.WorkflowSta
      * @generated from field: ai.stigmer.agentic.workflow.v1.serverless.ServerlessWorkflowValidation serverless_workflow_validation = 2;
      */
     serverlessWorkflowValidation?: ServerlessWorkflowValidation;
+    /**
+     * SHA-256 hash of the generated CNCF YAML for the current valid version.
+     *
+     * @internal
+     * Updated only when validation produces state=VALID and the generated YAML
+     * differs from the previous version's hash. Empty for workflows that have
+     * never passed validation.
+     *
+     * This is the content-addressed version identifier for the workflow definition.
+     * The hash is computed from the `serverless_workflow_validation.yaml` string,
+     * ensuring that "same YAML = same hash = same execution behavior."
+     *
+     * Consumers:
+     * - Execution create pipeline reads this to pin executions to a specific version
+     * - getByReference resolves ApiResourceReference.version against this and audit entries
+     * - UI displays this as the current version identifier
+     *
+     * @since Workflow Versioning
+     *
+     * @generated from field: string version_hash = 3;
+     */
+    versionHash: string;
 };
 /**
  * Describes the message ai.stigmer.agentic.workflow.v1.WorkflowStatus.

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

@@ -7,7 +7,7 @@ import { file_ai_stigmer_commons_apiresource_status } from "../../../commons/api
 /**
  * Describes the file ai/stigmer/agentic/workflow/v1/status.proto.
  */
-export const file_ai_stigmer_agentic_workflow_v1_status = /*@__PURE__*/ fileDesc("CithaS9zdGlnbWVyL2FnZW50aWMvd29ya2Zsb3cvdjEvc3RhdHVzLnByb3RvEh5haS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3cudjEi3wEKDldvcmtmbG93U3RhdHVzEj8KBWF1ZGl0GGMgASgLMjAuYWkuc3RpZ21lci5jb21tb25zLmFwaXJlc291cmNlLkFwaVJlc291cmNlQXVkaXQSGwoTZGVmYXVsdF9pbnN0YW5jZV9pZBgBIAEoCRJvCh5zZXJ2ZXJsZXNzX3dvcmtmbG93X3ZhbGlkYXRpb24YAiABKAsyRy5haS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3cudjEuc2VydmVybGVzcy5TZXJ2ZXJsZXNzV29ya2Zsb3dWYWxpZGF0aW9uYgZwcm90bzM", [file_ai_stigmer_agentic_workflow_v1_serverless_validation, file_ai_stigmer_commons_apiresource_status]);
+export const file_ai_stigmer_agentic_workflow_v1_status = /*@__PURE__*/ fileDesc("CithaS9zdGlnbWVyL2FnZW50aWMvd29ya2Zsb3cvdjEvc3RhdHVzLnByb3RvEh5haS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3cudjEi9QEKDldvcmtmbG93U3RhdHVzEj8KBWF1ZGl0GGMgASgLMjAuYWkuc3RpZ21lci5jb21tb25zLmFwaXJlc291cmNlLkFwaVJlc291cmNlQXVkaXQSGwoTZGVmYXVsdF9pbnN0YW5jZV9pZBgBIAEoCRJvCh5zZXJ2ZXJsZXNzX3dvcmtmbG93X3ZhbGlkYXRpb24YAiABKAsyRy5haS5zdGlnbWVyLmFnZW50aWMud29ya2Zsb3cudjEuc2VydmVybGVzcy5TZXJ2ZXJsZXNzV29ya2Zsb3dWYWxpZGF0aW9uEhQKDHZlcnNpb25faGFzaBgDIAEoCWIGcHJvdG8z", [file_ai_stigmer_agentic_workflow_v1_serverless_validation, file_ai_stigmer_commons_apiresource_status]);
 /**
  * Describes the message ai.stigmer.agentic.workflow.v1.WorkflowStatus.
  * Use `create(WorkflowStatusSchema)` to create a new message.

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

@@ -1 +1 @@
-{"version":3,"file":"status_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/workflow/v1/status_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,2HAA2H;AAC3H,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,yDAAyD,EAAE,MAAM,+BAA+B,CAAC;AAE1G,OAAO,EAAE,0CAA0C,EAAE,MAAM,2CAA2C,CAAC;AAGvG;;GAEG;AACH,MAAM,CAAC,MAAM,0CAA0C,GAAY,aAAa,CAC9E,QAAQ,CAAC,iaAAia,EAAE,CAAC,yDAAyD,EAAE,0CAA0C,CAAC,CAAC,CAAC;AAwCvhB;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA+B,aAAa,CAC3E,WAAW,CAAC,0CAA0C,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"status_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/workflow/v1/status_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,2HAA2H;AAC3H,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,yDAAyD,EAAE,MAAM,+BAA+B,CAAC;AAE1G,OAAO,EAAE,0CAA0C,EAAE,MAAM,2CAA2C,CAAC;AAGvG;;GAEG;AACH,MAAM,CAAC,MAAM,0CAA0C,GAAY,aAAa,CAC9E,QAAQ,CAAC,8bAA8b,EAAE,CAAC,yDAAyD,EAAE,0CAA0C,CAAC,CAAC,CAAC;AA+DpjB;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA+B,aAAa,CAC3E,WAAW,CAAC,0CAA0C,EAAE,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,281 @@
+import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
+import type { ApiResourceAuditActor } from "../../../commons/apiresource/status_pb.js";
+import type { Timestamp } from "@bufbuild/protobuf/wkt";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file ai/stigmer/agentic/workflow/v1/version.proto.
+ */
+export declare const file_ai_stigmer_agentic_workflow_v1_version: GenFile;
+/**
+ * WorkflowVersionEntry represents a single historical version of a workflow.
+ *
+ * Each apply/update that changes the generated CNCF YAML (and passes validation)
+ * creates a new immutable version entry. The version is identified by its content
+ * hash (SHA-256 of the validated YAML).
+ *
+ * @internal
+ * Stored in the resource_audit table (OSS SQLite) or workflow_audit collection
+ * (Cloud MongoDB). Entries are immutable after creation — a version's content
+ * never changes, only its tag can be reassigned via tagVersion.
+ *
+ * @since Workflow Versioning
+ *
+ * @generated from message ai.stigmer.agentic.workflow.v1.WorkflowVersionEntry
+ */
+export type WorkflowVersionEntry = Message<"ai.stigmer.agentic.workflow.v1.WorkflowVersionEntry"> & {
+    /**
+     * SHA-256 hash of the CNCF YAML — the immutable version identifier.
+     *
+     * @generated from field: string version_hash = 1;
+     */
+    versionHash: string;
+    /**
+     * When this version was created (the apply/update timestamp).
+     *
+     * @generated from field: google.protobuf.Timestamp applied_at = 2;
+     */
+    appliedAt?: Timestamp;
+    /**
+     * Who created this version (the actor who triggered the apply/update).
+     *
+     * @generated from field: ai.stigmer.commons.apiresource.ApiResourceAuditActor applied_by = 3;
+     */
+    appliedBy?: ApiResourceAuditActor;
+    /**
+     * Tag assigned to this version at apply time or via tagVersion.
+     * May be empty if the version was applied without a tag.
+     * Examples: "stable", "v1.0", "production"
+     *
+     * @internal
+     * Tags are mutable pointers — calling tagVersion moves a tag to a different
+     * version. When resolving by tag, the system returns the most recent audit
+     * entry with that tag (ordered by applied_at DESC).
+     *
+     * @generated from field: string tag = 4;
+     */
+    tag: string;
+    /**
+     * Whether this is the currently active version of the workflow.
+     *
+     * @generated from field: bool is_current = 5;
+     */
+    isCurrent: boolean;
+    /**
+     * Human-readable message describing what changed in this version.
+     * Analogous to a git commit message.
+     *
+     * @generated from field: string message = 6;
+     */
+    message: string;
+    /**
+     * The generated CNCF Serverless Workflow DSL 1.0.0 YAML for this version.
+     *
+     * @internal
+     * Used by the runner (to execute the workflow) and the execution viewer
+     * (to render the graph for historical executions). This is the exact YAML
+     * that was validated at the time this version was created.
+     *
+     * @generated from field: string validated_yaml = 7;
+     */
+    validatedYaml: string;
+    /**
+     * Git provenance tracking where this version's definition originated.
+     * Absent when applied from a non-git directory or via the web editor.
+     *
+     * @internal
+     * Populated by CLI during apply when the working directory is within a
+     * git repository. Provides traceability and enables "view on GitHub" links.
+     *
+     * @generated from field: ai.stigmer.agentic.workflow.v1.GitProvenance git_provenance = 8;
+     */
+    gitProvenance?: GitProvenance;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.WorkflowVersionEntry.
+ * Use `create(WorkflowVersionEntrySchema)` to create a new message.
+ */
+export declare const WorkflowVersionEntrySchema: GenMessage<WorkflowVersionEntry>;
+/**
+ * GitProvenance tracks the git origin of a workflow version.
+ *
+ * @internal
+ * Reuses the same structure as Skill's GitProvenance for consistency.
+ * Populated by the CLI during apply when the directory is a git repo.
+ *
+ * @since Workflow Versioning
+ *
+ * @generated from message ai.stigmer.agentic.workflow.v1.GitProvenance
+ */
+export type GitProvenance = Message<"ai.stigmer.agentic.workflow.v1.GitProvenance"> & {
+    /**
+     * Git remote URL (e.g., "https://github.com/org/repo.git").
+     *
+     * @generated from field: string remote_url = 1;
+     */
+    remoteUrl: string;
+    /**
+     * Original git reference (branch or tag name, e.g., "main", "v1.0.0").
+     *
+     * @generated from field: string ref = 2;
+     */
+    ref: string;
+    /**
+     * Resolved commit SHA (full 40-character SHA).
+     *
+     * @generated from field: string commit = 3;
+     */
+    commit: string;
+    /**
+     * Subdirectory path relative to repo root. Empty if at root.
+     *
+     * @generated from field: string subdir = 4;
+     */
+    subdir: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.GitProvenance.
+ * Use `create(GitProvenanceSchema)` to create a new message.
+ */
+export declare const GitProvenanceSchema: GenMessage<GitProvenance>;
+/**
+ * ListWorkflowVersionsInput requests the version history for a workflow.
+ *
+ * Returns all historical versions ordered by applied_at (newest first).
+ * Used by the Console, SDK, and CLI to render version timelines and
+ * enable version comparison.
+ *
+ * @since Workflow Versioning
+ *
+ * @generated from message ai.stigmer.agentic.workflow.v1.ListWorkflowVersionsInput
+ */
+export type ListWorkflowVersionsInput = Message<"ai.stigmer.agentic.workflow.v1.ListWorkflowVersionsInput"> & {
+    /**
+     * Organization that owns the workflow.
+     *
+     * @generated from field: string org = 1;
+     */
+    org: string;
+    /**
+     * Workflow slug (unique within the organization).
+     *
+     * @generated from field: string slug = 2;
+     */
+    slug: string;
+    /**
+     * Opaque token for cursor-based pagination.
+     * Empty string or omitted for the first page.
+     *
+     * @generated from field: string page_token = 3;
+     */
+    pageToken: string;
+    /**
+     * Maximum number of versions to return per page.
+     * Server may return fewer. Default is 50, max is 100.
+     *
+     * @generated from field: int32 page_size = 4;
+     */
+    pageSize: number;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.ListWorkflowVersionsInput.
+ * Use `create(ListWorkflowVersionsInputSchema)` to create a new message.
+ */
+export declare const ListWorkflowVersionsInputSchema: GenMessage<ListWorkflowVersionsInput>;
+/**
+ * ListWorkflowVersionsResponse contains a page of workflow version history.
+ *
+ * @since Workflow Versioning
+ *
+ * @generated from message ai.stigmer.agentic.workflow.v1.ListWorkflowVersionsResponse
+ */
+export type ListWorkflowVersionsResponse = Message<"ai.stigmer.agentic.workflow.v1.ListWorkflowVersionsResponse"> & {
+    /**
+     * Ordered list of versions (newest first).
+     *
+     * @generated from field: repeated ai.stigmer.agentic.workflow.v1.WorkflowVersionEntry versions = 1;
+     */
+    versions: WorkflowVersionEntry[];
+    /**
+     * Token for fetching the next page. Empty when no more pages exist.
+     *
+     * @generated from field: string next_page_token = 2;
+     */
+    nextPageToken: string;
+    /**
+     * Total number of versions across all pages.
+     *
+     * @generated from field: int32 total_count = 3;
+     */
+    totalCount: number;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.ListWorkflowVersionsResponse.
+ * Use `create(ListWorkflowVersionsResponseSchema)` to create a new message.
+ */
+export declare const ListWorkflowVersionsResponseSchema: GenMessage<ListWorkflowVersionsResponse>;
+/**
+ * GetWorkflowVersionInput requests a specific historical version of a workflow.
+ *
+ * Used by the runner (to hydrate execution from a pinned version) and the
+ * execution viewer (to render the graph for historical executions).
+ *
+ * @since Workflow Versioning
+ *
+ * @generated from message ai.stigmer.agentic.workflow.v1.GetWorkflowVersionInput
+ */
+export type GetWorkflowVersionInput = Message<"ai.stigmer.agentic.workflow.v1.GetWorkflowVersionInput"> & {
+    /**
+     * ID of the workflow resource.
+     *
+     * @generated from field: string workflow_id = 1;
+     */
+    workflowId: string;
+    /**
+     * SHA-256 hash identifying the specific version to retrieve.
+     *
+     * @generated from field: string version_hash = 2;
+     */
+    versionHash: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.GetWorkflowVersionInput.
+ * Use `create(GetWorkflowVersionInputSchema)` to create a new message.
+ */
+export declare const GetWorkflowVersionInputSchema: GenMessage<GetWorkflowVersionInput>;
+/**
+ * TagWorkflowVersionInput assigns or moves a tag to a specific workflow version.
+ *
+ * Tags are mutable pointers — calling tagVersion with an existing tag name
+ * moves it from the previous version to the specified version. A version can
+ * have at most one tag (set at apply time or via this RPC).
+ *
+ * @since Workflow Versioning
+ *
+ * @generated from message ai.stigmer.agentic.workflow.v1.TagWorkflowVersionInput
+ */
+export type TagWorkflowVersionInput = Message<"ai.stigmer.agentic.workflow.v1.TagWorkflowVersionInput"> & {
+    /**
+     * ID of the workflow resource.
+     *
+     * @generated from field: string workflow_id = 1;
+     */
+    workflowId: string;
+    /**
+     * SHA-256 hash of the version to tag.
+     *
+     * @generated from field: string version_hash = 2;
+     */
+    versionHash: string;
+    /**
+     * Tag to assign. Must be a non-empty alphanumeric string with dots, hyphens,
+     * or underscores (same pattern as Skill tags).
+     *
+     * @generated from field: string tag = 3;
+     */
+    tag: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.TagWorkflowVersionInput.
+ * Use `create(TagWorkflowVersionInputSchema)` to create a new message.
+ */
+export declare const TagWorkflowVersionInputSchema: GenMessage<TagWorkflowVersionInput>;

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

@@ -0,0 +1,42 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts,import_extension=js"
+// @generated from file ai/stigmer/agentic/workflow/v1/version.proto (package ai.stigmer.agentic.workflow.v1, syntax proto3)
+/* eslint-disable */
+import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv1";
+import { file_ai_stigmer_commons_apiresource_status } from "../../../commons/apiresource/status_pb.js";
+import { file_buf_validate_validate } from "../../../../../buf/validate/validate_pb.js";
+import { file_google_protobuf_timestamp } from "@bufbuild/protobuf/wkt";
+/**
+ * Describes the file ai/stigmer/agentic/workflow/v1/version.proto.
+ */
+export const file_ai_stigmer_agentic_workflow_v1_version = /*@__PURE__*/ fileDesc("CixhaS9zdGlnbWVyL2FnZW50aWMvd29ya2Zsb3cvdjEvdmVyc2lvbi5wcm90bxIeYWkuc3RpZ21lci5hZ2VudGljLndvcmtmbG93LnYxIrgCChRXb3JrZmxvd1ZlcnNpb25FbnRyeRIUCgx2ZXJzaW9uX2hhc2gYASABKAkSLgoKYXBwbGllZF9hdBgCIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASSQoKYXBwbGllZF9ieRgDIAEoCzI1LmFpLnN0aWdtZXIuY29tbW9ucy5hcGlyZXNvdXJjZS5BcGlSZXNvdXJjZUF1ZGl0QWN0b3ISCwoDdGFnGAQgASgJEhIKCmlzX2N1cnJlbnQYBSABKAgSDwoHbWVzc2FnZRgGIAEoCRIWCg52YWxpZGF0ZWRfeWFtbBgHIAEoCRJFCg5naXRfcHJvdmVuYW5jZRgIIAEoCzItLmFpLnN0aWdtZXIuYWdlbnRpYy53b3JrZmxvdy52MS5HaXRQcm92ZW5hbmNlIlAKDUdpdFByb3ZlbmFuY2USEgoKcmVtb3RlX3VybBgBIAEoCRILCgNyZWYYAiABKAkSDgoGY29tbWl0GAMgASgJEg4KBnN1YmRpchgEIAEoCSJtChlMaXN0V29ya2Zsb3dWZXJzaW9uc0lucHV0EhMKA29yZxgBIAEoCUIGukgDyAEBEhQKBHNsdWcYAiABKAlCBrpIA8gBARISCgpwYWdlX3Rva2VuGAMgASgJEhEKCXBhZ2Vfc2l6ZRgEIAEoBSKUAQocTGlzdFdvcmtmbG93VmVyc2lvbnNSZXNwb25zZRJGCgh2ZXJzaW9ucxgBIAMoCzI0LmFpLnN0aWdtZXIuYWdlbnRpYy53b3JrZmxvdy52MS5Xb3JrZmxvd1ZlcnNpb25FbnRyeRIXCg9uZXh0X3BhZ2VfdG9rZW4YAiABKAkSEwoLdG90YWxfY291bnQYAyABKAUiYwoXR2V0V29ya2Zsb3dWZXJzaW9uSW5wdXQSGwoLd29ya2Zsb3dfaWQYASABKAlCBrpIA8gBARIrCgx2ZXJzaW9uX2hhc2gYAiABKAlCFbpIEnIQMg5eW2EtZjAtOV17NjR9JCKMAQoXVGFnV29ya2Zsb3dWZXJzaW9uSW5wdXQSGwoLd29ya2Zsb3dfaWQYASABKAlCBrpIA8gBARIrCgx2ZXJzaW9uX2hhc2gYAiABKAlCFbpIEnIQMg5eW2EtZjAtOV17NjR9JBInCgN0YWcYAyABKAlCGrpIF3IVEAEyEV5bYS16QS1aMC05Ll8tXSskYgZwcm90bzM", [file_ai_stigmer_commons_apiresource_status, file_buf_validate_validate, file_google_protobuf_timestamp]);
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.WorkflowVersionEntry.
+ * Use `create(WorkflowVersionEntrySchema)` to create a new message.
+ */
+export const WorkflowVersionEntrySchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflow_v1_version, 0);
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.GitProvenance.
+ * Use `create(GitProvenanceSchema)` to create a new message.
+ */
+export const GitProvenanceSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflow_v1_version, 1);
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.ListWorkflowVersionsInput.
+ * Use `create(ListWorkflowVersionsInputSchema)` to create a new message.
+ */
+export const ListWorkflowVersionsInputSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflow_v1_version, 2);
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.ListWorkflowVersionsResponse.
+ * Use `create(ListWorkflowVersionsResponseSchema)` to create a new message.
+ */
+export const ListWorkflowVersionsResponseSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflow_v1_version, 3);
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.GetWorkflowVersionInput.
+ * Use `create(GetWorkflowVersionInputSchema)` to create a new message.
+ */
+export const GetWorkflowVersionInputSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflow_v1_version, 4);
+/**
+ * Describes the message ai.stigmer.agentic.workflow.v1.TagWorkflowVersionInput.
+ * Use `create(TagWorkflowVersionInputSchema)` to create a new message.
+ */
+export const TagWorkflowVersionInputSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_workflow_v1_version, 5);
+//# sourceMappingURL=version_pb.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"version_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/workflow/v1/version_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,4HAA4H;AAC5H,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,0CAA0C,EAAE,MAAM,2CAA2C,CAAC;AACvG,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AAExF,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAGxE;;GAEG;AACH,MAAM,CAAC,MAAM,2CAA2C,GAAY,aAAa,CAC/E,QAAQ,CAAC,yyCAAyyC,EAAE,CAAC,0CAA0C,EAAE,0BAA0B,EAAE,8BAA8B,CAAC,CAAC,CAAC;AA8Fh6C;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAqC,aAAa,CACvF,WAAW,CAAC,2CAA2C,EAAE,CAAC,CAAC,CAAC;AA2C9D;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA8B,aAAa,CACzE,WAAW,CAAC,2CAA2C,EAAE,CAAC,CAAC,CAAC;AA6C9D;;;GAGG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAA0C,aAAa,CACjG,WAAW,CAAC,2CAA2C,EAAE,CAAC,CAAC,CAAC;AAgC9D;;;GAGG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAA6C,aAAa,CACvG,WAAW,CAAC,2CAA2C,EAAE,CAAC,CAAC,CAAC;AA4B9D;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAwC,aAAa,CAC7F,WAAW,CAAC,2CAA2C,EAAE,CAAC,CAAC,CAAC;AAqC9D;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAwC,aAAa,CAC7F,WAAW,CAAC,2CAA2C,EAAE,CAAC,CAAC,CAAC"}

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

@@ -325,11 +325,15 @@ export type WorkflowExecutionStatus = Message<"ai.stigmer.agentic.workflowexecut
      * EXECUTION_WAITING_FOR_APPROVAL phase. This surfaces all approval
      * requests at the workflow level for UI visibility.
      *
-     * Full-Replace Protocol:
-     * The workflow-runner always sends the complete set of pending approvals
-     * via UpdateStatus. The server replaces the stored list unconditionally:
+     * Guarded Update Protocol:
+     * This field is only modified when UpdateStatusInput.update_pending_approvals
+     * is explicitly set to true. Normal event emissions (which don't concern
+     * approvals) leave this field untouched, preventing race conditions between
+     * concurrent status writers.
+     *
+     * Only call-agent-status manages this field:
      * - Non-empty list: child agent(s) need approval
-     * - Empty list: all approvals resolved, clear the field
+     * - Empty list + update_pending_approvals=true: all approvals resolved
      *
      * Parallel Agents:
      * When multiple child agents run in parallel, entries from different children
@@ -379,6 +383,30 @@ export type WorkflowExecutionStatus = Message<"ai.stigmer.agentic.workflowexecut
      * @generated from field: int64 total_output_tokens = 12;
      */
     totalOutputTokens: bigint;
+    /**
+     * SHA-256 hash identifying which workflow version was used for this execution.
+     *
+     * @internal
+     * Pinned at execution creation time from Workflow.status.version_hash.
+     * Immutable after creation — represents the exact workflow definition this
+     * execution ran (or will run, if still pending).
+     *
+     * Consumers:
+     * - Runner: fetches the version-specific CNCF YAML via getVersion() during
+     *   hydration, ensuring the execution runs the intended definition even if
+     *   the workflow has been updated since creation.
+     * - Execution viewer: fetches the version entry to render the correct graph
+     *   for historical executions, eliminating the version mismatch problem.
+     *
+     * Empty for executions created before workflow versioning was introduced.
+     * In that case, consumers fall back to fetching the current workflow
+     * definition (legacy behavior with mismatch warning).
+     *
+     * @since Workflow Versioning
+     *
+     * @generated from field: string workflow_version_hash = 13;
+     */
+    workflowVersionHash: string;
 };
 /**
  * Describes the message ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionStatus.

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

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

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

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

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

@@ -499,12 +499,12 @@ export declare const WorkflowExecutionCommandController: {
          *
          * Preconditions
          *
-         * - Execution must be in EXECUTION_PENDING or EXECUTION_IN_PROGRESS phase
+         * - Execution must be in EXECUTION_PENDING, EXECUTION_IN_PROGRESS, or EXECUTION_PAUSED phase
          * - Cannot cancel already-terminal executions (COMPLETED, FAILED, CANCELLED, TERMINATED)
          *
          * State Transitions
          *
-         * - status.phase: PENDING/IN_PROGRESS → CANCELLED
+         * - status.phase: PENDING/IN_PROGRESS/PAUSED → CANCELLED
          * - status.completed_at: Set to current timestamp
          * - In-progress tasks: May complete cleanup or be interrupted
          *
@@ -568,12 +568,12 @@ export declare const WorkflowExecutionCommandController: {
          *
          * Preconditions
          *
-         * - Execution must be in EXECUTION_PENDING or EXECUTION_IN_PROGRESS phase
+         * - Execution must be in EXECUTION_PENDING, EXECUTION_IN_PROGRESS, or EXECUTION_PAUSED phase
          * - Cannot terminate already-terminal executions
          *
          * State Transitions
          *
-         * - status.phase: PENDING/IN_PROGRESS → TERMINATED
+         * - status.phase: PENDING/IN_PROGRESS/PAUSED → TERMINATED
          * - status.completed_at: Set to current timestamp
          * - status.error: May contain termination reason
          * - In-progress tasks: Stopped abruptly (no cleanup)
@@ -628,23 +628,44 @@ export declare const WorkflowExecutionCommandController: {
             readonly kind: any;
         };
         /**
-         * Recover a failed workflow execution from the last checkpoint.
+         * Recover a failed workflow execution.
          *
-         * Resumes execution from the last successful point. Completed work is
-         * preserved - successful tasks are NOT re-executed. This enables
-         * "retry and resume" semantics without duplicating side effects.
+         * Terminates the existing (possibly stuck) Temporal orchestrator and child
+         * workflows, recreates the ExecutionContext with freshly resolved environment
+         * variables, and starts a new Temporal workflow with recovery mode enabled.
+         * The workflow engine reads completed task outputs from the persisted event
+         * log, skips those tasks, and resumes execution from the first incomplete or
+         * failed task — preserving all previously completed work.
          *
          * @internal
-         * Temporal Equivalent: `temporal workflow reset --workflow-id <id> --type LastWorkflowTask`
+         * Temporal Equivalent: Terminates the existing orchestrator and child
+         * workflows, starts a fresh orchestrator with the same workflow ID and
+         * recoveryMode: true in the workflow input.
          *
          * Behavior
          *
          * 1. Validates execution is in FAILED phase (recoverable)
-         * 2. Identifies the last successful checkpoint in workflow history
-         * 3. Creates new Temporal run from that checkpoint via ResetWorkflow
-         * 4. Execution transitions from FAILED to IN_PROGRESS phase
-         * 5. Workflow continues from where it failed
-         * 6. Returns updated WorkflowExecution with IN_PROGRESS phase
+         * 2. Terminates the existing Temporal orchestrator workflow and its child
+         *    TS runner workflow (handles stuck Workflow-Task-Failed loops and
+         *    already-completed workflows gracefully)
+         * 3. Recreates the ExecutionContext with freshly resolved environment
+         *    variables from the current WorkflowInstance and Workflow configuration
+         * 4. Starts a fresh Temporal orchestrator workflow with recoveryMode flag;
+         *    the engine loads completed task outputs from the event log, skips
+         *    those tasks (emitting task_skipped events), and resumes from the
+         *    first non-completed task
+         * 5. Event sequence continues from the persisted high-water mark (no
+         *    duplicate keys, no gaps)
+         * 6. Execution transitions from FAILED to IN_PROGRESS phase
+         * 7. Returns updated WorkflowExecution with IN_PROGRESS phase
+         *
+         * Environment Resolution
+         *
+         * Environment variables are re-resolved from the current WorkflowInstance
+         * environment_refs and Workflow env declarations. This is desirable: if the
+         * user fixed an environment value (e.g., rotated an API key), recovery picks
+         * up the fix. Runtime env overrides (runtime_env) provided at original
+         * execution time are not preserved — they were stripped before persist.
          *
          * Preconditions
          *
@@ -658,17 +679,19 @@ export declare const WorkflowExecutionCommandController: {
          * - status.phase: FAILED → IN_PROGRESS
          * - status.completed_at: Cleared (execution is running again)
          * - status.error: Cleared (no longer failed)
-         * - Completed tasks: Preserved (not re-executed)
-         * - Failed tasks: Reset to pending, will be retried
+         * - Completed tasks: Skipped (outputs restored from event log into $context)
+         * - Failed/pending tasks: Re-executed from the failure point
          *
          * Recovery vs Restart
          *
          * | Aspect | recover | Create new execution |
          * |--------|---------|----------------------|
-         * | Completed work | Preserved | Lost (re-executed) |
-         * | Side effects | Not duplicated | May duplicate |
          * | Execution ID | Same | New ID |
-         * | Use case | Resume after fix | Start fresh |
+         * | Environment | Re-resolved (current) | From request |
+         * | Completed tasks | Skipped (outputs preserved) | All tasks run fresh |
+         * | Failed task | Re-executed | All tasks run fresh |
+         * | Event history | Continues (appended) | Starts from 1 |
+         * | Use case | Fix config, then retry | Start fresh |
          *
          * Idempotency
          *
@@ -690,7 +713,7 @@ export declare const WorkflowExecutionCommandController: {
          *
          * {
          *   "id": "wfx_abc123xyz456",
-         *   "reason": "Stripe API recovered, resuming payment processing"
+         *   "reason": "Fixed API key in environment, retrying"
          * }
          *
          * Example Response
@@ -701,11 +724,7 @@ export declare const WorkflowExecutionCommandController: {
          *   "metadata": { "id": "wfx_abc123xyz456" },
          *   "status": {
          *     "phase": 2,  // EXECUTION_IN_PROGRESS
-         *     "started_at": "2026-02-07T10:00:00Z",
-         *     "tasks": [
-         *       { "task_id": "task-1", "status": 3 },  // COMPLETED (preserved)
-         *       { "task_id": "task-2", "status": 2 }   // IN_PROGRESS (resumed)
-         *     ]
+         *     "started_at": "2026-02-07T10:00:00Z"
          *   }
          * }
          *