@stigmer/protos 0.5.0 → 1.0.0

package/ai/stigmer/agentic/artifact/v1/command_pb.d.ts

@@ -0,0 +1,86 @@
+import type { GenFile, GenService } from "@bufbuild/protobuf/codegenv1";
+import type { ArtifactSchema } from "./api_pb.js";
+import type { CreateArtifactInputSchema } from "./io_pb.js";
+import type { ApiResourceIdSchema } from "../../../commons/apiresource/io_pb.js";
+/**
+ * Describes the file ai/stigmer/agentic/artifact/v1/command.proto.
+ */
+export declare const file_ai_stigmer_agentic_artifact_v1_command: GenFile;
+/**
+ * ArtifactCommandController handles write operations for Artifact resources.
+ *
+ * @internal
+ * Follows the Command-Query Separation (CQS) pattern.
+ *
+ * These RPCs are system-level — used by the workflow-runner and agent-runner
+ * to persist task outputs. They are NOT exposed to end users or the SDK.
+ *
+ * Artifact creation flow:
+ * 1. Runner detects output exceeding auto-promotion threshold (256KB)
+ * 2. Runner calls create() with spec (metadata) + content (bytes)
+ * 3. Backend hashes content, deduplicates, stores blob, creates record
+ * 4. Runner receives Artifact with ID and status
+ * 5. Runner replaces inline task output with artifact reference
+ * 6. Runner includes artifact_created event in next updateStatus call
+ *
+ * @since T07 (Artifact Store)
+ *
+ * @generated from service ai.stigmer.agentic.artifact.v1.ArtifactCommandController
+ */
+export declare const ArtifactCommandController: GenService<{
+    /**
+     * Create a new artifact with content.
+     *
+     * Persists the artifact's metadata and content blob. The backend:
+     * 1. Computes SHA-256 hash of the content bytes
+     * 2. Checks for existing blob with same hash (content-addressable dedup)
+     * 3. If new: writes blob to storage (filesystem in OSS, S3 in Cloud)
+     * 4. Creates Artifact metadata record with status populated
+     * 5. Returns the created Artifact
+     *
+     * @internal
+     * Authorization: skip_authorization (system-level RPC, called by runners)
+     * The runner authenticates via service identity, not user credentials.
+     *
+     * Idempotent by content hash: creating the same content twice returns
+     * two distinct Artifact metadata records pointing to the same blob.
+     * This is intentional — different tasks may independently produce the
+     * same content, and each needs its own provenance trail.
+     *
+     * Error Cases:
+     *
+     * - INVALID_ARGUMENT: spec or content is missing/invalid
+     * - RESOURCE_EXHAUSTED: content exceeds 50MB limit
+     * - INTERNAL: blob storage write failure
+     *
+     * @generated from rpc ai.stigmer.agentic.artifact.v1.ArtifactCommandController.create
+     */
+    create: {
+        methodKind: "unary";
+        input: typeof CreateArtifactInputSchema;
+        output: typeof ArtifactSchema;
+    };
+    /**
+     * Delete an artifact.
+     *
+     * Marks the artifact for deletion. The backend transitions the storage
+     * state to deleted and schedules the blob for garbage collection.
+     * If other artifacts reference the same content hash, the blob is
+     * retained until all references are deleted.
+     *
+     * @internal
+     * Authorization: requires can_edit permission on the artifact.
+     *
+     * Error Cases:
+     *
+     * - NOT_FOUND: Artifact with given ID doesn't exist
+     * - PERMISSION_DENIED: User lacks can_edit permission
+     *
+     * @generated from rpc ai.stigmer.agentic.artifact.v1.ArtifactCommandController.delete
+     */
+    delete: {
+        methodKind: "unary";
+        input: typeof ApiResourceIdSchema;
+        output: typeof ArtifactSchema;
+    };
+}>;

package/ai/stigmer/agentic/artifact/v1/command_pb.js

@@ -0,0 +1,36 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts,import_extension=js"
+// @generated from file ai/stigmer/agentic/artifact/v1/command.proto (package ai.stigmer.agentic.artifact.v1, syntax proto3)
+/* eslint-disable */
+import { fileDesc, serviceDesc } from "@bufbuild/protobuf/codegenv1";
+import { file_ai_stigmer_agentic_artifact_v1_api } from "./api_pb.js";
+import { file_ai_stigmer_agentic_artifact_v1_io } from "./io_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/artifact/v1/command.proto.
+ */
+export const file_ai_stigmer_agentic_artifact_v1_command = /*@__PURE__*/ fileDesc("CixhaS9zdGlnbWVyL2FnZW50aWMvYXJ0aWZhY3QvdjEvY29tbWFuZC5wcm90bxIeYWkuc3RpZ21lci5hZ2VudGljLmFydGlmYWN0LnYxMqYCChlBcnRpZmFjdENvbW1hbmRDb250cm9sbGVyEm0KBmNyZWF0ZRIzLmFpLnN0aWdtZXIuYWdlbnRpYy5hcnRpZmFjdC52MS5DcmVhdGVBcnRpZmFjdElucHV0GiguYWkuc3RpZ21lci5hZ2VudGljLmFydGlmYWN0LnYxLkFydGlmYWN0IgTQuBgBEpMBCgZkZWxldGUSLS5haS5zdGlnbWVyLmNvbW1vbnMuYXBpcmVzb3VyY2UuQXBpUmVzb3VyY2VJZBooLmFpLnN0aWdtZXIuYWdlbnRpYy5hcnRpZmFjdC52MS5BcnRpZmFjdCIwwrgYLAgCEDciBXZhbHVlKh91bmF1dGhvcml6ZWQgdG8gZGVsZXRlIGFydGlmYWN0GgSg/ys3YgZwcm90bzM", [file_ai_stigmer_agentic_artifact_v1_api, file_ai_stigmer_agentic_artifact_v1_io, file_ai_stigmer_commons_apiresource_io, file_ai_stigmer_commons_apiresource_rpc_service_options, file_ai_stigmer_commons_rpc_method_options]);
+/**
+ * ArtifactCommandController handles write operations for Artifact resources.
+ *
+ * @internal
+ * Follows the Command-Query Separation (CQS) pattern.
+ *
+ * These RPCs are system-level — used by the workflow-runner and agent-runner
+ * to persist task outputs. They are NOT exposed to end users or the SDK.
+ *
+ * Artifact creation flow:
+ * 1. Runner detects output exceeding auto-promotion threshold (256KB)
+ * 2. Runner calls create() with spec (metadata) + content (bytes)
+ * 3. Backend hashes content, deduplicates, stores blob, creates record
+ * 4. Runner receives Artifact with ID and status
+ * 5. Runner replaces inline task output with artifact reference
+ * 6. Runner includes artifact_created event in next updateStatus call
+ *
+ * @since T07 (Artifact Store)
+ *
+ * @generated from service ai.stigmer.agentic.artifact.v1.ArtifactCommandController
+ */
+export const ArtifactCommandController = /*@__PURE__*/ serviceDesc(file_ai_stigmer_agentic_artifact_v1_command, 0);
+//# sourceMappingURL=command_pb.js.map

package/ai/stigmer/agentic/artifact/v1/command_pb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/artifact/v1/command_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,4HAA4H;AAC5H,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,2CAA2C,GAAY,aAAa,CAC/E,QAAQ,CAAC,igBAAigB,EAAE,CAAC,uCAAuC,EAAE,sCAAsC,EAAE,sCAAsC,EAAE,uDAAuD,EAAE,0CAA0C,CAAC,CAAC,CAAC;AAE9uB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAwDjC,aAAa,CAChB,WAAW,CAAC,2CAA2C,EAAE,CAAC,CAAC,CAAC"}

package/ai/stigmer/agentic/artifact/v1/enum_pb.d.ts

@@ -0,0 +1,49 @@
+import type { GenEnum, GenFile } from "@bufbuild/protobuf/codegenv1";
+/**
+ * Describes the file ai/stigmer/agentic/artifact/v1/enum.proto.
+ */
+export declare const file_ai_stigmer_agentic_artifact_v1_enum: GenFile;
+/**
+ * ArtifactStorageState tracks the lifecycle of an artifact's blob in storage.
+ *
+ * @internal
+ * The state machine is linear:
+ * storage_state_pending → storage_state_stored → storage_state_deleted
+ *
+ * Pending: metadata record created, blob upload not yet confirmed.
+ * Stored: blob successfully written to object storage and verified.
+ * Deleted: blob has been garbage-collected (metadata may be retained for audit).
+ *
+ * @since T07 (Artifact Store)
+ *
+ * @generated from enum ai.stigmer.agentic.artifact.v1.ArtifactStorageState
+ */
+export declare enum ArtifactStorageState {
+    /**
+     * @generated from enum value: storage_state_unspecified = 0;
+     */
+    storage_state_unspecified = 0,
+    /**
+     * Metadata created, blob upload in progress or not yet confirmed.
+     *
+     * @generated from enum value: storage_state_pending = 1;
+     */
+    storage_state_pending = 1,
+    /**
+     * Blob successfully stored and content hash verified.
+     *
+     * @generated from enum value: storage_state_stored = 2;
+     */
+    storage_state_stored = 2,
+    /**
+     * Blob deleted from storage (retention expired or manual deletion).
+     * Metadata record may be retained for audit trail purposes.
+     *
+     * @generated from enum value: storage_state_deleted = 3;
+     */
+    storage_state_deleted = 3
+}
+/**
+ * Describes the enum ai.stigmer.agentic.artifact.v1.ArtifactStorageState.
+ */
+export declare const ArtifactStorageStateSchema: GenEnum<ArtifactStorageState>;

package/ai/stigmer/agentic/artifact/v1/enum_pb.js

@@ -0,0 +1,54 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts,import_extension=js"
+// @generated from file ai/stigmer/agentic/artifact/v1/enum.proto (package ai.stigmer.agentic.artifact.v1, syntax proto3)
+/* eslint-disable */
+import { enumDesc, fileDesc } from "@bufbuild/protobuf/codegenv1";
+/**
+ * Describes the file ai/stigmer/agentic/artifact/v1/enum.proto.
+ */
+export const file_ai_stigmer_agentic_artifact_v1_enum = /*@__PURE__*/ fileDesc("CilhaS9zdGlnbWVyL2FnZW50aWMvYXJ0aWZhY3QvdjEvZW51bS5wcm90bxIeYWkuc3RpZ21lci5hZ2VudGljLmFydGlmYWN0LnYxKoUBChRBcnRpZmFjdFN0b3JhZ2VTdGF0ZRIdChlzdG9yYWdlX3N0YXRlX3Vuc3BlY2lmaWVkEAASGQoVc3RvcmFnZV9zdGF0ZV9wZW5kaW5nEAESGAoUc3RvcmFnZV9zdGF0ZV9zdG9yZWQQAhIZChVzdG9yYWdlX3N0YXRlX2RlbGV0ZWQQA2IGcHJvdG8z");
+/**
+ * ArtifactStorageState tracks the lifecycle of an artifact's blob in storage.
+ *
+ * @internal
+ * The state machine is linear:
+ * storage_state_pending → storage_state_stored → storage_state_deleted
+ *
+ * Pending: metadata record created, blob upload not yet confirmed.
+ * Stored: blob successfully written to object storage and verified.
+ * Deleted: blob has been garbage-collected (metadata may be retained for audit).
+ *
+ * @since T07 (Artifact Store)
+ *
+ * @generated from enum ai.stigmer.agentic.artifact.v1.ArtifactStorageState
+ */
+export var ArtifactStorageState;
+(function (ArtifactStorageState) {
+    /**
+     * @generated from enum value: storage_state_unspecified = 0;
+     */
+    ArtifactStorageState[ArtifactStorageState["storage_state_unspecified"] = 0] = "storage_state_unspecified";
+    /**
+     * Metadata created, blob upload in progress or not yet confirmed.
+     *
+     * @generated from enum value: storage_state_pending = 1;
+     */
+    ArtifactStorageState[ArtifactStorageState["storage_state_pending"] = 1] = "storage_state_pending";
+    /**
+     * Blob successfully stored and content hash verified.
+     *
+     * @generated from enum value: storage_state_stored = 2;
+     */
+    ArtifactStorageState[ArtifactStorageState["storage_state_stored"] = 2] = "storage_state_stored";
+    /**
+     * Blob deleted from storage (retention expired or manual deletion).
+     * Metadata record may be retained for audit trail purposes.
+     *
+     * @generated from enum value: storage_state_deleted = 3;
+     */
+    ArtifactStorageState[ArtifactStorageState["storage_state_deleted"] = 3] = "storage_state_deleted";
+})(ArtifactStorageState || (ArtifactStorageState = {}));
+/**
+ * Describes the enum ai.stigmer.agentic.artifact.v1.ArtifactStorageState.
+ */
+export const ArtifactStorageStateSchema = /*@__PURE__*/ enumDesc(file_ai_stigmer_agentic_artifact_v1_enum, 0);
+//# sourceMappingURL=enum_pb.js.map

package/ai/stigmer/agentic/artifact/v1/enum_pb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/artifact/v1/enum_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,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,sSAAsS,CAAC,CAAC;AAEnT;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAN,IAAY,oBA2BX;AA3BD,WAAY,oBAAoB;IAC9B;;OAEG;IACH,yGAA6B,CAAA;IAE7B;;;;OAIG;IACH,iGAAyB,CAAA;IAEzB;;;;OAIG;IACH,+FAAwB,CAAA;IAExB;;;;;OAKG;IACH,iGAAyB,CAAA;AAC3B,CAAC,EA3BW,oBAAoB,KAApB,oBAAoB,QA2B/B;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAkC,aAAa,CACpF,QAAQ,CAAC,wCAAwC,EAAE,CAAC,CAAC,CAAC"}

package/ai/stigmer/agentic/artifact/v1/io_pb.d.ts

@@ -0,0 +1,205 @@
+import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
+import type { Artifact } from "./api_pb.js";
+import type { ArtifactSpec } from "./spec_pb.js";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file ai/stigmer/agentic/artifact/v1/io.proto.
+ */
+export declare const file_ai_stigmer_agentic_artifact_v1_io: GenFile;
+/**
+ * ArtifactId wraps an artifact identifier.
+ *
+ * @internal
+ * Using a wrapper (instead of a raw string) provides validation,
+ * clear field naming, and extensibility.
+ *
+ * @since T07 (Artifact Store)
+ *
+ * @generated from message ai.stigmer.agentic.artifact.v1.ArtifactId
+ */
+export type ArtifactId = Message<"ai.stigmer.agentic.artifact.v1.ArtifactId"> & {
+    /**
+     * Artifact identifier.
+     * Format: "art_{unique-suffix}" (auto-generated by backend)
+     *
+     * @generated from field: string value = 1;
+     */
+    value: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.artifact.v1.ArtifactId.
+ * Use `create(ArtifactIdSchema)` to create a new message.
+ */
+export declare const ArtifactIdSchema: GenMessage<ArtifactId>;
+/**
+ * ArtifactList contains a paginated list of artifacts.
+ *
+ * @internal
+ * Returned by list operations (listByExecution).
+ *
+ * @since T07 (Artifact Store)
+ *
+ * @generated from message ai.stigmer.agentic.artifact.v1.ArtifactList
+ */
+export type ArtifactList = Message<"ai.stigmer.agentic.artifact.v1.ArtifactList"> & {
+    /**
+     * Total number of pages available for this query.
+     *
+     * @generated from field: int32 total_pages = 1;
+     */
+    totalPages: number;
+    /**
+     * Artifacts in the current page, sorted by created_at descending.
+     *
+     * @generated from field: repeated ai.stigmer.agentic.artifact.v1.Artifact entries = 2;
+     */
+    entries: Artifact[];
+};
+/**
+ * Describes the message ai.stigmer.agentic.artifact.v1.ArtifactList.
+ * Use `create(ArtifactListSchema)` to create a new message.
+ */
+export declare const ArtifactListSchema: GenMessage<ArtifactList>;
+/**
+ * CreateArtifactInput provides the data needed to create an artifact.
+ *
+ * @internal
+ * Used by the workflow-runner and agent-runner to persist task outputs.
+ * This is a system-level RPC — not exposed to end users or the SDK.
+ *
+ * The backend:
+ * 1. Computes SHA-256 hash of content
+ * 2. Checks if a blob with that hash already exists (deduplication)
+ * 3. If not, writes blob to storage (filesystem in OSS, S3 in Cloud)
+ * 4. Creates the Artifact metadata record
+ * 5. Returns the created Artifact with status populated
+ *
+ * Size limit: 50MB per request. This matches Temporal's max history size
+ * and covers all practical workflow task outputs. For larger artifacts,
+ * multipart upload will be added in a future phase.
+ *
+ * @since T07 (Artifact Store)
+ *
+ * @generated from message ai.stigmer.agentic.artifact.v1.CreateArtifactInput
+ */
+export type CreateArtifactInput = Message<"ai.stigmer.agentic.artifact.v1.CreateArtifactInput"> & {
+    /**
+     * Artifact properties (content type, display name, source, retention).
+     *
+     * @generated from field: ai.stigmer.agentic.artifact.v1.ArtifactSpec spec = 1;
+     */
+    spec?: ArtifactSpec;
+    /**
+     * Raw artifact content bytes.
+     *
+     * @internal
+     * Maximum size: 50MB (52,428,800 bytes).
+     * The backend computes the SHA-256 hash of this content for
+     * content-addressable storage and deduplication.
+     *
+     * @generated from field: bytes content = 2;
+     */
+    content: Uint8Array;
+};
+/**
+ * Describes the message ai.stigmer.agentic.artifact.v1.CreateArtifactInput.
+ * Use `create(CreateArtifactInputSchema)` to create a new message.
+ */
+export declare const CreateArtifactInputSchema: GenMessage<CreateArtifactInput>;
+/**
+ * ListArtifactsByExecutionRequest lists artifacts produced by a specific execution.
+ *
+ * @internal
+ * Supports listing by either workflow_execution_id or agent_execution_id.
+ * At least one must be provided.
+ *
+ * @since T07 (Artifact Store)
+ *
+ * @generated from message ai.stigmer.agentic.artifact.v1.ListArtifactsByExecutionRequest
+ */
+export type ListArtifactsByExecutionRequest = Message<"ai.stigmer.agentic.artifact.v1.ListArtifactsByExecutionRequest"> & {
+    /**
+     * WorkflowExecution ID to list artifacts for.
+     * Format: "wex_{unique-suffix}"
+     *
+     * @generated from field: string workflow_execution_id = 1;
+     */
+    workflowExecutionId: string;
+    /**
+     * AgentExecution ID to list artifacts for.
+     * Format: "aex_{unique-suffix}"
+     *
+     * @generated from field: string agent_execution_id = 2;
+     */
+    agentExecutionId: string;
+    /**
+     * Maximum number of artifacts to return per page.
+     * Default: 50. Maximum: 100.
+     *
+     * @generated from field: int32 page_size = 3;
+     */
+    pageSize: number;
+    /**
+     * Opaque pagination token from a previous response.
+     *
+     * @generated from field: string page_token = 4;
+     */
+    pageToken: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.artifact.v1.ListArtifactsByExecutionRequest.
+ * Use `create(ListArtifactsByExecutionRequestSchema)` to create a new message.
+ */
+export declare const ListArtifactsByExecutionRequestSchema: GenMessage<ListArtifactsByExecutionRequest>;
+/**
+ * ArtifactDownloadUrl provides a URL for downloading artifact content.
+ *
+ * @internal
+ * The download strategy differs by edition:
+ * - Cloud: pre-signed S3 URL with short TTL (e.g., 15 minutes)
+ * - OSS: direct URL to the local artifact server endpoint
+ *
+ * This pattern avoids streaming large blobs through the gRPC control plane.
+ * The client receives a URL and fetches the content via HTTP GET.
+ *
+ * @since T07 (Artifact Store)
+ *
+ * @generated from message ai.stigmer.agentic.artifact.v1.ArtifactDownloadUrl
+ */
+export type ArtifactDownloadUrl = Message<"ai.stigmer.agentic.artifact.v1.ArtifactDownloadUrl"> & {
+    /**
+     * URL to download the artifact content via HTTP GET.
+     *
+     * @internal
+     * Cloud: pre-signed S3 URL (expires after ttl_seconds)
+     * OSS: http://localhost:{port}/artifacts/{hash}
+     *
+     * @generated from field: string url = 1;
+     */
+    url: string;
+    /**
+     * Time-to-live for the download URL in seconds.
+     * After this duration, the URL expires and a new one must be requested.
+     * Typically 900 (15 minutes) for Cloud, 0 (no expiry) for OSS.
+     *
+     * @generated from field: int32 ttl_seconds = 2;
+     */
+    ttlSeconds: number;
+    /**
+     * Size of the artifact content in bytes (convenience, same as status.size_bytes).
+     *
+     * @generated from field: int64 size_bytes = 3;
+     */
+    sizeBytes: bigint;
+    /**
+     * MIME content type (convenience, same as spec.content_type).
+     *
+     * @generated from field: string content_type = 4;
+     */
+    contentType: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.artifact.v1.ArtifactDownloadUrl.
+ * Use `create(ArtifactDownloadUrlSchema)` to create a new message.
+ */
+export declare const ArtifactDownloadUrlSchema: GenMessage<ArtifactDownloadUrl>;

package/ai/stigmer/agentic/artifact/v1/io_pb.js

@@ -0,0 +1,37 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts,import_extension=js"
+// @generated from file ai/stigmer/agentic/artifact/v1/io.proto (package ai.stigmer.agentic.artifact.v1, syntax proto3)
+/* eslint-disable */
+import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv1";
+import { file_ai_stigmer_agentic_artifact_v1_api } from "./api_pb.js";
+import { file_ai_stigmer_agentic_artifact_v1_spec } from "./spec_pb.js";
+import { file_buf_validate_validate } from "../../../../../buf/validate/validate_pb.js";
+/**
+ * Describes the file ai/stigmer/agentic/artifact/v1/io.proto.
+ */
+export const file_ai_stigmer_agentic_artifact_v1_io = /*@__PURE__*/ fileDesc("CidhaS9zdGlnbWVyL2FnZW50aWMvYXJ0aWZhY3QvdjEvaW8ucHJvdG8SHmFpLnN0aWdtZXIuYWdlbnRpYy5hcnRpZmFjdC52MSIjCgpBcnRpZmFjdElkEhUKBXZhbHVlGAEgASgJQga6SAPIAQEiXgoMQXJ0aWZhY3RMaXN0EhMKC3RvdGFsX3BhZ2VzGAEgASgFEjkKB2VudHJpZXMYAiADKAsyKC5haS5zdGlnbWVyLmFnZW50aWMuYXJ0aWZhY3QudjEuQXJ0aWZhY3QieQoTQ3JlYXRlQXJ0aWZhY3RJbnB1dBJCCgRzcGVjGAEgASgLMiwuYWkuc3RpZ21lci5hZ2VudGljLmFydGlmYWN0LnYxLkFydGlmYWN0U3BlY0IGukgDyAEBEh4KB2NvbnRlbnQYAiABKAxCDbpICsgBAXoFGICAgBkigwEKH0xpc3RBcnRpZmFjdHNCeUV4ZWN1dGlvblJlcXVlc3QSHQoVd29ya2Zsb3dfZXhlY3V0aW9uX2lkGAEgASgJEhoKEmFnZW50X2V4ZWN1dGlvbl9pZBgCIAEoCRIRCglwYWdlX3NpemUYAyABKAUSEgoKcGFnZV90b2tlbhgEIAEoCSJhChNBcnRpZmFjdERvd25sb2FkVXJsEgsKA3VybBgBIAEoCRITCgt0dGxfc2Vjb25kcxgCIAEoBRISCgpzaXplX2J5dGVzGAMgASgDEhQKDGNvbnRlbnRfdHlwZRgEIAEoCWIGcHJvdG8z", [file_ai_stigmer_agentic_artifact_v1_api, file_ai_stigmer_agentic_artifact_v1_spec, file_buf_validate_validate]);
+/**
+ * Describes the message ai.stigmer.agentic.artifact.v1.ArtifactId.
+ * Use `create(ArtifactIdSchema)` to create a new message.
+ */
+export const ArtifactIdSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_artifact_v1_io, 0);
+/**
+ * Describes the message ai.stigmer.agentic.artifact.v1.ArtifactList.
+ * Use `create(ArtifactListSchema)` to create a new message.
+ */
+export const ArtifactListSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_artifact_v1_io, 1);
+/**
+ * Describes the message ai.stigmer.agentic.artifact.v1.CreateArtifactInput.
+ * Use `create(CreateArtifactInputSchema)` to create a new message.
+ */
+export const CreateArtifactInputSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_artifact_v1_io, 2);
+/**
+ * Describes the message ai.stigmer.agentic.artifact.v1.ListArtifactsByExecutionRequest.
+ * Use `create(ListArtifactsByExecutionRequestSchema)` to create a new message.
+ */
+export const ListArtifactsByExecutionRequestSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_artifact_v1_io, 3);
+/**
+ * Describes the message ai.stigmer.agentic.artifact.v1.ArtifactDownloadUrl.
+ * Use `create(ArtifactDownloadUrlSchema)` to create a new message.
+ */
+export const ArtifactDownloadUrlSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_artifact_v1_io, 4);
+//# sourceMappingURL=io_pb.js.map

package/ai/stigmer/agentic/artifact/v1/io_pb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/artifact/v1/io_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,uHAAuH;AACvH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,uCAAuC,EAAE,MAAM,aAAa,CAAC;AAEtE,OAAO,EAAE,wCAAwC,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AAGxF;;GAEG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAY,aAAa,CAC1E,QAAQ,CAAC,0vBAA0vB,EAAE,CAAC,uCAAuC,EAAE,wCAAwC,EAAE,0BAA0B,CAAC,CAAC,CAAC;AAuBx3B;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA2B,aAAa,CACnE,WAAW,CAAC,sCAAsC,EAAE,CAAC,CAAC,CAAC;AA4BzD;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6B,aAAa,CACvE,WAAW,CAAC,sCAAsC,EAAE,CAAC,CAAC,CAAC;AA6CzD;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAoC,aAAa,CACrF,WAAW,CAAC,sCAAsC,EAAE,CAAC,CAAC,CAAC;AA8CzD;;;GAGG;AACH,MAAM,CAAC,MAAM,qCAAqC,GAAgD,aAAa,CAC7G,WAAW,CAAC,sCAAsC,EAAE,CAAC,CAAC,CAAC;AAqDzD;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAoC,aAAa,CACrF,WAAW,CAAC,sCAAsC,EAAE,CAAC,CAAC,CAAC"}

package/ai/stigmer/agentic/artifact/v1/query_connect.d.ts

@@ -0,0 +1,127 @@
+/**
+ * ArtifactQueryController handles read operations for Artifact resources.
+ *
+ * @internal
+ * Follows the Command-Query Separation (CQS) pattern.
+ *
+ * These RPCs are exposed to the SDK and consumed by:
+ * - Execution viewer (T09): lists artifacts per execution, provides download links
+ * - CLI: `stigmer workflow artifacts <execution-id>`
+ * - React SDK: useArtifact() hook for artifact metadata and download
+ *
+ * Authorization follows the parent execution's access model:
+ * if a user can view an execution, they can view its artifacts.
+ *
+ * @since T07 (Artifact Store)
+ *
+ * @generated from service ai.stigmer.agentic.artifact.v1.ArtifactQueryController
+ */
+export declare const ArtifactQueryController: {
+    readonly typeName: "ai.stigmer.agentic.artifact.v1.ArtifactQueryController";
+    readonly methods: {
+        /**
+         * Get a single artifact by ID.
+         *
+         * Returns the complete Artifact resource including metadata, spec,
+         * and status (content hash, size, storage state, expiration).
+         *
+         * Does NOT return the artifact content — use getDownloadUrl to
+         * retrieve a URL for downloading the content via HTTP GET.
+         *
+         * Use Cases:
+         *
+         * 1. Artifact Detail View:
+         *    - User clicks an artifact in the execution viewer
+         *    - UI calls get() to fetch full metadata
+         *    - UI displays content type, size, source task, expiration
+         *
+         * 2. Artifact Reference Resolution:
+         *    - Task output contains _artifact_ref field
+         *    - UI calls get() to resolve the reference to metadata
+         *    - UI renders a download/preview widget instead of raw JSON
+         *
+         * Error Cases:
+         *
+         * - NOT_FOUND: No Artifact exists with the given ID
+         * - PERMISSION_DENIED: User doesn't have view access to the parent execution
+         *
+         * @generated from rpc ai.stigmer.agentic.artifact.v1.ArtifactQueryController.get
+         */
+        readonly get: {
+            readonly name: "get";
+            readonly I: any;
+            readonly O: any;
+            readonly kind: any;
+        };
+        /**
+         * List all artifacts produced by a specific execution.
+         *
+         * Returns a paginated list of artifacts filtered by either
+         * workflow_execution_id or agent_execution_id.
+         *
+         * Use Cases:
+         *
+         * 1. Execution Viewer Artifact Panel:
+         *    - User views a workflow execution in the execution viewer
+         *    - UI calls listByExecution() to populate the artifact sidebar
+         *    - Each artifact shows display name, content type, size, source task
+         *
+         * 2. CLI Artifact Listing:
+         *    - `stigmer workflow artifacts wex_abc123`
+         *    - CLI calls listByExecution() and formats as a table
+         *
+         * Error Cases:
+         *
+         * - INVALID_ARGUMENT: Neither workflow_execution_id nor agent_execution_id provided
+         * - PERMISSION_DENIED: User doesn't have view access to the parent execution
+         *
+         * @generated from rpc ai.stigmer.agentic.artifact.v1.ArtifactQueryController.listByExecution
+         */
+        readonly listByExecution: {
+            readonly name: "listByExecution";
+            readonly I: any;
+            readonly O: any;
+            readonly kind: any;
+        };
+        /**
+         * Get a download URL for artifact content.
+         *
+         * Returns a URL that the client can use to download the artifact's
+         * content via HTTP GET. This avoids streaming large blobs through
+         * the gRPC control plane.
+         *
+         * Cloud: returns a pre-signed S3 URL with a short TTL (15 minutes).
+         * OSS: returns a direct URL to the local artifact server endpoint.
+         *
+         * Use Cases:
+         *
+         * 1. Download Artifact:
+         *    - User clicks "Download" in the execution viewer
+         *    - UI calls getDownloadUrl() to get a URL
+         *    - Browser opens the URL in a new tab or triggers a download
+         *
+         * 2. Preview Artifact:
+         *    - UI calls getDownloadUrl() for JSON/text artifacts
+         *    - UI fetches content from the URL and renders inline
+         *    - Large artifacts show a truncated preview with download option
+         *
+         * 3. CLI Download:
+         *    - `stigmer workflow artifact download art_abc123 -o output.json`
+         *    - CLI calls getDownloadUrl() then fetches via HTTP GET
+         *
+         * Error Cases:
+         *
+         * - NOT_FOUND: No Artifact exists with the given ID
+         * - PERMISSION_DENIED: User doesn't have view access to the parent execution
+         * - FAILED_PRECONDITION: Artifact blob has been deleted (storage_state_deleted)
+         *
+         * @generated from rpc ai.stigmer.agentic.artifact.v1.ArtifactQueryController.getDownloadUrl
+         */
+        readonly getDownloadUrl: {
+            readonly name: "getDownloadUrl";
+            readonly I: any;
+            readonly O: any;
+            readonly kind: any;
+        };
+    };
+};