@stigmer/protos 0.0.68 → 0.0.70

package/ai/stigmer/agentic/workflowinstance/v1/spec_pb.d.ts

@@ -6,8 +6,9 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_ai_stigmer_agentic_workflowinstance_v1_spec: GenFile;
 /**
- * WorkflowInstanceSpec defines the user-configurable properties for a WorkflowInstance.
+ * WorkflowInstanceSpec defines the configurable properties of a workflow instance.
  *
+ * @internal
  * This is the "Instance" layer in the Template→Instance→Execution pattern.
  * It provides stateful configuration with environment bindings and secrets.
  *
@@ -27,47 +28,33 @@ export type WorkflowInstanceSpec = Message<"ai.stigmer.agentic.workflowinstance.
     /**
      * Reference to the Workflow template this instance deploys.
      *
+     * @internal
      * This links the instance to a reusable orchestration blueprint.
      * The Workflow defines which AgentInstances to orchestrate and in what order.
-     *
-     * Format: Workflow resource ID (e.g., "wfl-abc123")
+     * Format: Workflow resource ID (e.g., "wfl_abc123")
      * Validation: Minimum length of 1 character (required field)
      *
-     * Example: "wfl-abc123" (references a Workflow named "deploy-to-cloud")
-     *
      * @generated from field: string workflow_id = 1;
      */
     workflowId: string;
     /**
-     * Human-readable description explaining what this instance is for.
-     *
-     * Use this to document:
-     * - Purpose of this instance
-     * - Environment it targets (dev, staging, prod)
-     * - Team or project ownership
-     * - Special configuration notes
-     *
-     * Examples:
-     * - "Production CI/CD pipeline for main branch"
-     * - "Staging environment deployment for feature testing"
-     * - "Data pipeline for analytics team - runs daily at midnight"
-     * - "Customer onboarding workflow for ACME Corp"
+     * Human-readable description of this workflow instance.
      *
      * @generated from field: string description = 2;
      */
     description: string;
     /**
-     * References to Environment resources providing configuration and secrets.
+     * Ordered list of Environment resources providing configuration and secrets.
+     *
+     * Environments are merged in declaration order — later entries override
+     * earlier ones when keys conflict.
      *
+     * @internal
      * Environments are layered configuration containers that provide:
      * - Environment variables (API keys, endpoints, flags)
      * - Secrets (credentials, tokens, passwords)
      * - Configuration values (timeouts, limits, settings)
      *
-     * Layering Behavior:
-     * Environments are merged in order - later environments override earlier ones.
-     * This enables a base + overrides pattern:
-     *
      * Example layering:
      *   [base-env, aws-prod-env, github-team-env]
      *   └─ base-env: Common settings for all instances
@@ -80,7 +67,7 @@ export type WorkflowInstanceSpec = Message<"ai.stigmer.agentic.workflowinstance.
      * - Layered: [base, cloud, team] - Base + cloud credentials + team settings
      *
      * References use ApiResourceReference which supports:
-     * - By ID: {id: "env-abc123"}
+     * - By ID: {id: "env_abc123"}
      * - By slug: {slug: "aws-prod-env"}
      *
      * At execution time, the WorkflowExecution runtime merges these environments

package/ai/stigmer/agentic/workflowinstance/v1/spec_pb.js.map

@@ -1 +1 @@
-{"version":3,"file":"spec_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/workflowinstance/v1/spec_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,yIAAyI;AACzI,oBAAoB;AAKpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,sCAAsC,EAAE,MAAM,oCAAoC,CAAC;AAC5F,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAGrF;;GAEG;AACH,MAAM,CAAC,MAAM,gDAAgD,GAAY,aAAa,CACpF,QAAQ,CAAC,qfAAqf,EAAE,CAAC,sCAAsC,EAAE,0BAA0B,CAAC,CAAC,CAAC;AA0FxkB;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAqC,aAAa,CACvF,WAAW,CAAC,gDAAgD,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"spec_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/workflowinstance/v1/spec_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,yIAAyI;AACzI,oBAAoB;AAKpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,sCAAsC,EAAE,MAAM,oCAAoC,CAAC;AAC5F,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAGrF;;GAEG;AACH,MAAM,CAAC,MAAM,gDAAgD,GAAY,aAAa,CACpF,QAAQ,CAAC,qfAAqf,EAAE,CAAC,sCAAsC,EAAE,0BAA0B,CAAC,CAAC,CAAC;AA6ExkB;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAqC,aAAa,CACvF,WAAW,CAAC,gDAAgD,EAAE,CAAC,CAAC,CAAC"}

package/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb.d.ts

@@ -74,16 +74,20 @@ export type ApiResourceKindMeta = Message<"ai.stigmer.commons.apiresource.apires
  */
 export declare const ApiResourceKindMetaSchema: GenMessage<ApiResourceKindMeta>;
 /**
- * API resource version
+ * API resource version.
  *
  * @generated from enum ai.stigmer.commons.apiresource.apiresourcekind.ApiResourceVersion
  */
 export declare enum ApiResourceVersion {
     /**
+     * Default value when no version is set.
+     *
      * @generated from enum value: api_resource_version_unspecified = 0;
      */
     api_resource_version_unspecified = 0,
     /**
+     * Current API version for all resource types.
+     *
      * @generated from enum value: v1 = 1;
      */
     v1 = 1
@@ -143,101 +147,127 @@ export declare enum PlatformIdValue {
  */
 export declare const PlatformIdValueSchema: GenEnum<PlatformIdValue>;
 /**
- * API resource kinds for Stigmer
+ * API resource kinds for Stigmer.
  *
  * @generated from enum ai.stigmer.commons.apiresource.apiresourcekind.ApiResourceKind
  */
 export declare enum ApiResourceKind {
     /**
+     * Default value for unset or unrecognized resource kinds.
+     *
      * @generated from enum value: api_resource_kind_unknown = 0;
      */
     api_resource_kind_unknown = 0,
     /**
-     * Agentic - System-level audit trails and versioning
+     * Immutable version record tracking changes to an API resource.
      *
      * @generated from enum value: api_resource_version = 1;
      */
     api_resource_version = 1,
     /**
-     * IAM - Identity and Access Management
+     * Role-based access control policy for granting permissions on resources.
      *
      * @generated from enum value: iam_policy = 10;
      */
     iam_policy = 10,
     /**
+     * User account in the identity system.
+     *
      * @generated from enum value: identity_account = 11;
      */
     identity_account = 11,
     /**
+     * Credential for programmatic API access.
+     *
      * @generated from enum value: api_key = 12;
      */
     api_key = 12,
     /**
-     * IAM - External identity provider configuration
+     * External identity provider for federated authentication.
      *
      * @generated from enum value: identity_provider = 21;
      */
     identity_provider = 21,
     /**
-     * Tenancy - Platform and organizational resources
+     * Top-level tenant that owns and manages resources.
      *
      * @generated from enum value: organization = 30;
      */
     organization = 30,
     /**
+     * Singleton platform instance representing the Stigmer deployment.
+     *
      * @generated from enum value: platform = 31;
      */
     platform = 31,
     /**
-     * Agentic - AI agent management
+     * AI assistant with instructions, tools, skills, and a delegation model.
      *
      * @generated from enum value: agent = 40;
      */
     agent = 40,
     /**
+     * Single run of an agent within a session, tracking tool calls and responses.
+     *
      * @generated from enum value: agent_execution = 41;
      */
     agent_execution = 41,
     /**
+     * Conversation thread between a user and an agent.
+     *
      * @generated from enum value: session = 42;
      */
     session = 42,
     /**
+     * Knowledge resource that provides domain-specific context to an agent.
+     *
      * @generated from enum value: skill = 43;
      */
     skill = 43,
     /**
+     * External tool server connected via the Model Context Protocol.
+     *
      * @generated from enum value: mcp_server = 44;
      */
     mcp_server = 44,
     /**
+     * Configured deployment of an agent with environment-specific overrides.
+     *
      * @generated from enum value: agent_instance = 45;
      */
     agent_instance = 45,
     /**
-     * Agentic - Workflow orchestration
+     * Multi-step orchestration defining how agents collaborate on a task.
      *
      * @generated from enum value: workflow = 50;
      */
     workflow = 50,
     /**
+     * Configured deployment of a workflow with environment-specific bindings.
+     *
      * @generated from enum value: workflow_instance = 51;
      */
     workflow_instance = 51,
     /**
+     * Single run of a workflow instance, tracking step progress and outcomes.
+     *
      * @generated from enum value: workflow_execution = 52;
      */
     workflow_execution = 52,
     /**
+     * Named set of variables and secrets for agent and workflow execution.
+     *
      * @generated from enum value: environment = 53;
      */
     environment = 53,
     /**
+     * User-owned runtime context for managing execution state.
+     *
      * @generated from enum value: execution_context = 54;
      */
     execution_context = 54,
     /**
-     * Tenancy - Project management (aggregate root for resource lifecycle)
+     * Aggregate root grouping related resources for lifecycle management.
      *
      * @generated from enum value: project = 60;
      */

package/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb.js

@@ -15,17 +15,21 @@ export const file_ai_stigmer_commons_apiresource_apiresourcekind_api_resource_ki
  */
 export const ApiResourceKindMetaSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_commons_apiresource_apiresourcekind_api_resource_kind, 0);
 /**
- * API resource version
+ * API resource version.
  *
  * @generated from enum ai.stigmer.commons.apiresource.apiresourcekind.ApiResourceVersion
  */
 export var ApiResourceVersion;
 (function (ApiResourceVersion) {
     /**
+     * Default value when no version is set.
+     *
      * @generated from enum value: api_resource_version_unspecified = 0;
      */
     ApiResourceVersion[ApiResourceVersion["api_resource_version_unspecified"] = 0] = "api_resource_version_unspecified";
     /**
+     * Current API version for all resource types.
+     *
      * @generated from enum value: v1 = 1;
      */
     ApiResourceVersion[ApiResourceVersion["v1"] = 1] = "v1";
@@ -87,102 +91,128 @@ export var PlatformIdValue;
  */
 export const PlatformIdValueSchema = /*@__PURE__*/ enumDesc(file_ai_stigmer_commons_apiresource_apiresourcekind_api_resource_kind, 2);
 /**
- * API resource kinds for Stigmer
+ * API resource kinds for Stigmer.
  *
  * @generated from enum ai.stigmer.commons.apiresource.apiresourcekind.ApiResourceKind
  */
 export var ApiResourceKind;
 (function (ApiResourceKind) {
     /**
+     * Default value for unset or unrecognized resource kinds.
+     *
      * @generated from enum value: api_resource_kind_unknown = 0;
      */
     ApiResourceKind[ApiResourceKind["api_resource_kind_unknown"] = 0] = "api_resource_kind_unknown";
     /**
-     * Agentic - System-level audit trails and versioning
+     * Immutable version record tracking changes to an API resource.
      *
      * @generated from enum value: api_resource_version = 1;
      */
     ApiResourceKind[ApiResourceKind["api_resource_version"] = 1] = "api_resource_version";
     /**
-     * IAM - Identity and Access Management
+     * Role-based access control policy for granting permissions on resources.
      *
      * @generated from enum value: iam_policy = 10;
      */
     ApiResourceKind[ApiResourceKind["iam_policy"] = 10] = "iam_policy";
     /**
+     * User account in the identity system.
+     *
      * @generated from enum value: identity_account = 11;
      */
     ApiResourceKind[ApiResourceKind["identity_account"] = 11] = "identity_account";
     /**
+     * Credential for programmatic API access.
+     *
      * @generated from enum value: api_key = 12;
      */
     ApiResourceKind[ApiResourceKind["api_key"] = 12] = "api_key";
     /**
-     * IAM - External identity provider configuration
+     * External identity provider for federated authentication.
      *
      * @generated from enum value: identity_provider = 21;
      */
     ApiResourceKind[ApiResourceKind["identity_provider"] = 21] = "identity_provider";
     /**
-     * Tenancy - Platform and organizational resources
+     * Top-level tenant that owns and manages resources.
      *
      * @generated from enum value: organization = 30;
      */
     ApiResourceKind[ApiResourceKind["organization"] = 30] = "organization";
     /**
+     * Singleton platform instance representing the Stigmer deployment.
+     *
      * @generated from enum value: platform = 31;
      */
     ApiResourceKind[ApiResourceKind["platform"] = 31] = "platform";
     /**
-     * Agentic - AI agent management
+     * AI assistant with instructions, tools, skills, and a delegation model.
      *
      * @generated from enum value: agent = 40;
      */
     ApiResourceKind[ApiResourceKind["agent"] = 40] = "agent";
     /**
+     * Single run of an agent within a session, tracking tool calls and responses.
+     *
      * @generated from enum value: agent_execution = 41;
      */
     ApiResourceKind[ApiResourceKind["agent_execution"] = 41] = "agent_execution";
     /**
+     * Conversation thread between a user and an agent.
+     *
      * @generated from enum value: session = 42;
      */
     ApiResourceKind[ApiResourceKind["session"] = 42] = "session";
     /**
+     * Knowledge resource that provides domain-specific context to an agent.
+     *
      * @generated from enum value: skill = 43;
      */
     ApiResourceKind[ApiResourceKind["skill"] = 43] = "skill";
     /**
+     * External tool server connected via the Model Context Protocol.
+     *
      * @generated from enum value: mcp_server = 44;
      */
     ApiResourceKind[ApiResourceKind["mcp_server"] = 44] = "mcp_server";
     /**
+     * Configured deployment of an agent with environment-specific overrides.
+     *
      * @generated from enum value: agent_instance = 45;
      */
     ApiResourceKind[ApiResourceKind["agent_instance"] = 45] = "agent_instance";
     /**
-     * Agentic - Workflow orchestration
+     * Multi-step orchestration defining how agents collaborate on a task.
      *
      * @generated from enum value: workflow = 50;
      */
     ApiResourceKind[ApiResourceKind["workflow"] = 50] = "workflow";
     /**
+     * Configured deployment of a workflow with environment-specific bindings.
+     *
      * @generated from enum value: workflow_instance = 51;
      */
     ApiResourceKind[ApiResourceKind["workflow_instance"] = 51] = "workflow_instance";
     /**
+     * Single run of a workflow instance, tracking step progress and outcomes.
+     *
      * @generated from enum value: workflow_execution = 52;
      */
     ApiResourceKind[ApiResourceKind["workflow_execution"] = 52] = "workflow_execution";
     /**
+     * Named set of variables and secrets for agent and workflow execution.
+     *
      * @generated from enum value: environment = 53;
      */
     ApiResourceKind[ApiResourceKind["environment"] = 53] = "environment";
     /**
+     * User-owned runtime context for managing execution state.
+     *
      * @generated from enum value: execution_context = 54;
      */
     ApiResourceKind[ApiResourceKind["execution_context"] = 54] = "execution_context";
     /**
-     * Tenancy - Project management (aggregate root for resource lifecycle)
+     * Aggregate root grouping related resources for lifecycle management.
      *
      * @generated from enum value: project = 60;
      */

package/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb.js.map

@@ -1 +1 @@
-{"version":3,"file":"api_resource_kind_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"api_resource_kind_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb.ts"],"names":[],"mappings":"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"}

package/ai/stigmer/commons/apiresource/enum_pb.d.ts

@@ -4,36 +4,47 @@ import type { GenEnum, GenFile } from "@bufbuild/protobuf/codegenv1";
  */
 export declare const file_ai_stigmer_commons_apiresource_enum: GenFile;
 /**
- * enumeration of the union of all event types used across all the api resources.
- * this is used for specifying the event type produced by rpc methods in command controllers.
- * using different enum for these event types while specifying in rpc methods and individual api resource would
- * work because the events are eventually converted to strings during message passing.
+ * Event types produced by command controller RPCs across all API resources.
+ *
+ * @internal
+ * Different enums could be used per resource, but a shared enum is simpler
+ * because events are converted to strings during message passing.
  *
  * @generated from enum ai.stigmer.commons.apiresource.ApiResourceEventType
  */
 export declare enum ApiResourceEventType {
     /**
+     * Default value when no event type is set.
+     *
      * @generated from enum value: unspecified = 0;
      */
     unspecified = 0,
     /**
+     * Resource was created.
+     *
      * @generated from enum value: created = 1;
      */
     created = 1,
     /**
+     * Resource spec or status was updated.
+     *
      * @generated from enum value: updated = 2;
      */
     updated = 2,
     /**
+     * Resource was deleted.
+     *
      * @generated from enum value: deleted = 3;
      */
     deleted = 3,
     /**
+     * Resource was renamed (slug changed).
+     *
      * @generated from enum value: renamed = 4;
      */
     renamed = 4,
     /**
-     * this is only applicable for cloud-resources
+     * Cloud infrastructure stack outputs were updated.
      *
      * @generated from enum value: stack_outputs_updated = 5;
      */
@@ -44,30 +55,48 @@ export declare enum ApiResourceEventType {
  */
 export declare const ApiResourceEventTypeSchema: GenEnum<ApiResourceEventType>;
 /**
+ * Operation type for API resource state transitions.
+ *
+ * @internal
+ * Used by the state machine to classify RPC operations and enforce
+ * transition rules (e.g., a resource in "deleting" state rejects create).
+ *
  * @generated from enum ai.stigmer.commons.apiresource.ApiResourceStateOperationType
  */
 export declare enum ApiResourceStateOperationType {
     /**
+     * Default value when no operation type is set.
+     *
      * @generated from enum value: api_resource_state_operation_type_unspecified = 0;
      */
     api_resource_state_operation_type_unspecified = 0,
     /**
+     * Create a new resource.
+     *
      * @generated from enum value: create = 1;
      */
     create = 1,
     /**
+     * Update an existing resource.
+     *
      * @generated from enum value: update = 2;
      */
     update = 2,
     /**
+     * Delete an existing resource.
+     *
      * @generated from enum value: delete = 3;
      */
     delete = 3,
     /**
+     * Read a resource (query).
+     *
      * @generated from enum value: read = 4;
      */
     read = 4,
     /**
+     * Open a server-streaming connection to a resource.
+     *
      * @generated from enum value: stream = 5;
      */
     stream = 5

package/ai/stigmer/commons/apiresource/enum_pb.js

@@ -7,37 +7,48 @@ import { enumDesc, fileDesc } from "@bufbuild/protobuf/codegenv1";
  */
 export const file_ai_stigmer_commons_apiresource_enum = /*@__PURE__*/ fileDesc("CilhaS9zdGlnbWVyL2NvbW1vbnMvYXBpcmVzb3VyY2UvZW51bS5wcm90bxIeYWkuc3RpZ21lci5jb21tb25zLmFwaXJlc291cmNlKnYKFEFwaVJlc291cmNlRXZlbnRUeXBlEg8KC3Vuc3BlY2lmaWVkEAASCwoHY3JlYXRlZBABEgsKB3VwZGF0ZWQQAhILCgdkZWxldGVkEAMSCwoHcmVuYW1lZBAEEhkKFXN0YWNrX291dHB1dHNfdXBkYXRlZBAFKowBCh1BcGlSZXNvdXJjZVN0YXRlT3BlcmF0aW9uVHlwZRIxCi1hcGlfcmVzb3VyY2Vfc3RhdGVfb3BlcmF0aW9uX3R5cGVfdW5zcGVjaWZpZWQQABIKCgZjcmVhdGUQARIKCgZ1cGRhdGUQAhIKCgZkZWxldGUQAxIICgRyZWFkEAQSCgoGc3RyZWFtEAUqbwoVQXBpUmVzb3VyY2VWaXNpYmlsaXR5EicKI2FwaV9yZXNvdXJjZV92aXNpYmlsaXR5X3Vuc3BlY2lmaWVkEAASFgoSdmlzaWJpbGl0eV9wcml2YXRlEAESFQoRdmlzaWJpbGl0eV9wdWJsaWMQAmIGcHJvdG8z");
 /**
- * enumeration of the union of all event types used across all the api resources.
- * this is used for specifying the event type produced by rpc methods in command controllers.
- * using different enum for these event types while specifying in rpc methods and individual api resource would
- * work because the events are eventually converted to strings during message passing.
+ * Event types produced by command controller RPCs across all API resources.
+ *
+ * @internal
+ * Different enums could be used per resource, but a shared enum is simpler
+ * because events are converted to strings during message passing.
  *
  * @generated from enum ai.stigmer.commons.apiresource.ApiResourceEventType
  */
 export var ApiResourceEventType;
 (function (ApiResourceEventType) {
     /**
+     * Default value when no event type is set.
+     *
      * @generated from enum value: unspecified = 0;
      */
     ApiResourceEventType[ApiResourceEventType["unspecified"] = 0] = "unspecified";
     /**
+     * Resource was created.
+     *
      * @generated from enum value: created = 1;
      */
     ApiResourceEventType[ApiResourceEventType["created"] = 1] = "created";
     /**
+     * Resource spec or status was updated.
+     *
      * @generated from enum value: updated = 2;
      */
     ApiResourceEventType[ApiResourceEventType["updated"] = 2] = "updated";
     /**
+     * Resource was deleted.
+     *
      * @generated from enum value: deleted = 3;
      */
     ApiResourceEventType[ApiResourceEventType["deleted"] = 3] = "deleted";
     /**
+     * Resource was renamed (slug changed).
+     *
      * @generated from enum value: renamed = 4;
      */
     ApiResourceEventType[ApiResourceEventType["renamed"] = 4] = "renamed";
     /**
-     * this is only applicable for cloud-resources
+     * Cloud infrastructure stack outputs were updated.
      *
      * @generated from enum value: stack_outputs_updated = 5;
      */
@@ -48,31 +59,49 @@ export var ApiResourceEventType;
  */
 export const ApiResourceEventTypeSchema = /*@__PURE__*/ enumDesc(file_ai_stigmer_commons_apiresource_enum, 0);
 /**
+ * Operation type for API resource state transitions.
+ *
+ * @internal
+ * Used by the state machine to classify RPC operations and enforce
+ * transition rules (e.g., a resource in "deleting" state rejects create).
+ *
  * @generated from enum ai.stigmer.commons.apiresource.ApiResourceStateOperationType
  */
 export var ApiResourceStateOperationType;
 (function (ApiResourceStateOperationType) {
     /**
+     * Default value when no operation type is set.
+     *
      * @generated from enum value: api_resource_state_operation_type_unspecified = 0;
      */
     ApiResourceStateOperationType[ApiResourceStateOperationType["api_resource_state_operation_type_unspecified"] = 0] = "api_resource_state_operation_type_unspecified";
     /**
+     * Create a new resource.
+     *
      * @generated from enum value: create = 1;
      */
     ApiResourceStateOperationType[ApiResourceStateOperationType["create"] = 1] = "create";
     /**
+     * Update an existing resource.
+     *
      * @generated from enum value: update = 2;
      */
     ApiResourceStateOperationType[ApiResourceStateOperationType["update"] = 2] = "update";
     /**
+     * Delete an existing resource.
+     *
      * @generated from enum value: delete = 3;
      */
     ApiResourceStateOperationType[ApiResourceStateOperationType["delete"] = 3] = "delete";
     /**
+     * Read a resource (query).
+     *
      * @generated from enum value: read = 4;
      */
     ApiResourceStateOperationType[ApiResourceStateOperationType["read"] = 4] = "read";
     /**
+     * Open a server-streaming connection to a resource.
+     *
      * @generated from enum value: stream = 5;
      */
     ApiResourceStateOperationType[ApiResourceStateOperationType["stream"] = 5] = "stream";

package/ai/stigmer/commons/apiresource/enum_pb.js.map

@@ -1 +1 @@
-{"version":3,"file":"enum_pb.js","sourceRoot":"","sources":["../../../../../ai/stigmer/commons/apiresource/enum_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,yHAAyH;AACzH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAElE;;GAEG;AACH,MAAM,CAAC,MAAM,wCAAwC,GAAY,aAAa,CAC5E,QAAQ,CAAC,smBAAsmB,CAAC,CAAC;AAEnnB;;;;;;;GAOG;AACH,MAAM,CAAN,IAAY,oBAgCX;AAhCD,WAAY,oBAAoB;IAC9B;;OAEG;IACH,6EAAe,CAAA;IAEf;;OAEG;IACH,qEAAW,CAAA;IAEX;;OAEG;IACH,qEAAW,CAAA;IAEX;;OAEG;IACH,qEAAW,CAAA;IAEX;;OAEG;IACH,qEAAW,CAAA;IAEX;;;;OAIG;IACH,iGAAyB,CAAA;AAC3B,CAAC,EAhCW,oBAAoB,KAApB,oBAAoB,QAgC/B;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAkC,aAAa,CACpF,QAAQ,CAAC,wCAAwC,EAAE,CAAC,CAAC,CAAC;AAExD;;GAEG;AACH,MAAM,CAAN,IAAY,6BA8BX;AA9BD,WAAY,6BAA6B;IACvC;;OAEG;IACH,mKAAiD,CAAA;IAEjD;;OAEG;IACH,qFAAU,CAAA;IAEV;;OAEG;IACH,qFAAU,CAAA;IAEV;;OAEG;IACH,qFAAU,CAAA;IAEV;;OAEG;IACH,iFAAQ,CAAA;IAER;;OAEG;IACH,qFAAU,CAAA;AACZ,CAAC,EA9BW,6BAA6B,KAA7B,6BAA6B,QA8BxC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAA2C,aAAa,CACtG,QAAQ,CAAC,wCAAwC,EAAE,CAAC,CAAC,CAAC;AAExD;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAN,IAAY,qBA2BX;AA3BD,WAAY,qBAAqB;IAC/B;;;;;OAKG;IACH,+HAAuC,CAAA;IAEvC;;;;;;OAMG;IACH,6FAAsB,CAAA;IAEtB;;;;;;;OAOG;IACH,2FAAqB,CAAA;AACvB,CAAC,EA3BW,qBAAqB,KAArB,qBAAqB,QA2BhC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAmC,aAAa,CACtF,QAAQ,CAAC,wCAAwC,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"enum_pb.js","sourceRoot":"","sources":["../../../../../ai/stigmer/commons/apiresource/enum_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,yHAAyH;AACzH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAElE;;GAEG;AACH,MAAM,CAAC,MAAM,wCAAwC,GAAY,aAAa,CAC5E,QAAQ,CAAC,smBAAsmB,CAAC,CAAC;AAEnnB;;;;;;;;GAQG;AACH,MAAM,CAAN,IAAY,oBA0CX;AA1CD,WAAY,oBAAoB;IAC9B;;;;OAIG;IACH,6EAAe,CAAA;IAEf;;;;OAIG;IACH,qEAAW,CAAA;IAEX;;;;OAIG;IACH,qEAAW,CAAA;IAEX;;;;OAIG;IACH,qEAAW,CAAA;IAEX;;;;OAIG;IACH,qEAAW,CAAA;IAEX;;;;OAIG;IACH,iGAAyB,CAAA;AAC3B,CAAC,EA1CW,oBAAoB,KAApB,oBAAoB,QA0C/B;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAkC,aAAa,CACpF,QAAQ,CAAC,wCAAwC,EAAE,CAAC,CAAC,CAAC;AAExD;;;;;;;;GAQG;AACH,MAAM,CAAN,IAAY,6BA0CX;AA1CD,WAAY,6BAA6B;IACvC;;;;OAIG;IACH,mKAAiD,CAAA;IAEjD;;;;OAIG;IACH,qFAAU,CAAA;IAEV;;;;OAIG;IACH,qFAAU,CAAA;IAEV;;;;OAIG;IACH,qFAAU,CAAA;IAEV;;;;OAIG;IACH,iFAAQ,CAAA;IAER;;;;OAIG;IACH,qFAAU,CAAA;AACZ,CAAC,EA1CW,6BAA6B,KAA7B,6BAA6B,QA0CxC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAA2C,aAAa,CACtG,QAAQ,CAAC,wCAAwC,EAAE,CAAC,CAAC,CAAC;AAExD;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAN,IAAY,qBA2BX;AA3BD,WAAY,qBAAqB;IAC/B;;;;;OAKG;IACH,+HAAuC,CAAA;IAEvC;;;;;;OAMG;IACH,6FAAsB,CAAA;IAEtB;;;;;;;OAOG;IACH,2FAAqB,CAAA;AACvB,CAAC,EA3BW,qBAAqB,KAArB,qBAAqB,QA2BhC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAmC,aAAa,CACtF,QAAQ,CAAC,wCAAwC,EAAE,CAAC,CAAC,CAAC"}

package/ai/stigmer/commons/apiresource/io_pb.d.ts

@@ -8,7 +8,7 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_ai_stigmer_commons_apiresource_io: GenFile;
 /**
- * Wrapper for api-resource-id
+ * Wraps a system-generated resource identifier.
  *
  * @generated from message ai.stigmer.commons.apiresource.ApiResourceId
  */