@stigmer/protos 0.0.34

package/ai/stigmer/agentic/agentexecution/v1/query_connect.js

@@ -0,0 +1,152 @@
+// @generated by protoc-gen-connect-es v1.6.1 with parameter "target=ts"
+// @generated from file ai/stigmer/agentic/agentexecution/v1/query.proto (package ai.stigmer.agentic.agentexecution.v1, syntax proto3)
+/* eslint-disable */
+// @ts-nocheck
+import { MethodKind } from "@bufbuild/protobuf";
+/**
+ * AgentExecutionQueryController handles read operations for agent executions.
+ *
+ * @generated from service ai.stigmer.agentic.agentexecution.v1.AgentExecutionQueryController
+ */
+export const AgentExecutionQueryController = {
+    typeName: "ai.stigmer.agentic.agentexecution.v1.AgentExecutionQueryController",
+    methods: {
+        /**
+         * Get a single agent execution by ID.
+         *
+         * @generated from rpc ai.stigmer.agentic.agentexecution.v1.AgentExecutionQueryController.get
+         */
+        get: {
+            name: "get",
+            I: AgentExecutionId,
+            O: AgentExecution,
+            kind: MethodKind.Unary,
+        },
+        /**
+         * List all agent executions with pagination and optional filtering.
+         *
+         * @generated from rpc ai.stigmer.agentic.agentexecution.v1.AgentExecutionQueryController.list
+         */
+        list: {
+            name: "list",
+            I: ListAgentExecutionsRequest,
+            O: AgentExecutionList,
+            kind: MethodKind.Unary,
+        },
+        /**
+         * List all executions in a specific session.
+         * Authorization is handled in handler via FGA query for authorized agent_execution_ids,
+         * then filtered by session_id. This ensures consistent authorization pattern across all list operations.
+         *
+         * @generated from rpc ai.stigmer.agentic.agentexecution.v1.AgentExecutionQueryController.listBySession
+         */
+        listBySession: {
+            name: "listBySession",
+            I: ListAgentExecutionsBySessionRequest,
+            O: AgentExecutionList,
+            kind: MethodKind.Unary,
+        },
+        /**
+         * Subscribe to real-time execution updates (streaming).
+         * Authorization is handled by the FJ model via proto configuration.
+         *
+         * @generated from rpc ai.stigmer.agentic.agentexecution.v1.AgentExecutionQueryController.subscribe
+         */
+        subscribe: {
+            name: "subscribe",
+            I: AgentExecutionId,
+            O: AgentExecution,
+            kind: MethodKind.ServerStreaming,
+        },
+        /**
+         * Get a presigned download URL for an execution artifact.
+         *
+         * Returns a time-limited URL for downloading an artifact published by
+         * an agent during execution. The URL can be used with a simple HTTP GET
+         * request without authentication.
+         *
+         * ## Authorization
+         *
+         * Requires can_view permission on the execution. This ensures users can
+         * only download artifacts from executions they have access to.
+         *
+         * ## Security
+         *
+         * The storage_key is validated to ensure it belongs to the specified
+         * execution. Keys must start with "artifacts/{execution_id}/" to prevent
+         * path traversal attacks.
+         *
+         * ## URL Expiration
+         *
+         * Download URLs expire after 7 days (configurable). After expiration,
+         * call this endpoint again to get a fresh URL.
+         *
+         * ## Use Cases
+         *
+         * - CLI downloading agent-created files
+         * - Web UI providing download links for artifacts
+         * - Refreshing expired download URLs
+         *
+         * ## Example Flow
+         *
+         * 1. Get execution via AgentExecutionQueryController.get
+         * 2. Find artifact in status.artifacts[]
+         * 3. Call getArtifactDownloadUrl with execution_id and storage_key
+         * 4. Use returned download_url for HTTP GET
+         *
+         * @since Artifact Lifecycle (Attachments & Artifacts)
+         *
+         * @generated from rpc ai.stigmer.agentic.agentexecution.v1.AgentExecutionQueryController.getArtifactDownloadUrl
+         */
+        getArtifactDownloadUrl: {
+            name: "getArtifactDownloadUrl",
+            I: GetArtifactDownloadUrlRequest,
+            O: GetArtifactDownloadUrlResponse,
+            kind: MethodKind.Unary,
+        },
+        /**
+         * Get usage report for a session (all executions in a session).
+         * Returns aggregated tokens, cost, cache hit rate, and per-execution breakdown.
+         *
+         * Authorization is handled in handler — caller must have can_view on
+         * all executions in the session (same pattern as listBySession).
+         *
+         * @generated from rpc ai.stigmer.agentic.agentexecution.v1.AgentExecutionQueryController.getSessionUsageReport
+         */
+        getSessionUsageReport: {
+            name: "getSessionUsageReport",
+            I: GetSessionUsageReportInput,
+            O: GetSessionUsageReportOutput,
+            kind: MethodKind.Unary,
+        },
+        /**
+         * Get usage report for an agent (all sessions for an agent in a time range).
+         * Returns aggregated tokens, cost, and per-session breakdown with pagination.
+         *
+         * Authorization is handled in handler — caller must have can_view on the agent.
+         *
+         * @generated from rpc ai.stigmer.agentic.agentexecution.v1.AgentExecutionQueryController.getAgentUsageReport
+         */
+        getAgentUsageReport: {
+            name: "getAgentUsageReport",
+            I: GetAgentUsageReportInput,
+            O: GetAgentUsageReportOutput,
+            kind: MethodKind.Unary,
+        },
+        /**
+         * Get usage report for an organization (all agents in a time range).
+         * Returns org-wide totals, top agents by cost, model breakdown, and daily trend.
+         *
+         * Authorization is handled in handler — caller must be org member.
+         *
+         * @generated from rpc ai.stigmer.agentic.agentexecution.v1.AgentExecutionQueryController.getOrgUsageReport
+         */
+        getOrgUsageReport: {
+            name: "getOrgUsageReport",
+            I: GetOrgUsageReportInput,
+            O: GetOrgUsageReportOutput,
+            kind: MethodKind.Unary,
+        },
+    }
+};
+//# sourceMappingURL=query_connect.js.map

package/ai/stigmer/agentic/agentexecution/v1/query_connect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query_connect.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/agentexecution/v1/query_connect.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,sIAAsI;AACtI,oBAAoB;AACpB,cAAc;AAId,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,QAAQ,EAAE,oEAAoE;IAC9E,OAAO,EAAE;QACP;;;;WAIG;QACH,GAAG,EAAE;YACH,IAAI,EAAE,KAAK;YACX,CAAC,EAAE,gBAAgB;YACnB,CAAC,EAAE,cAAc;YACjB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;WAIG;QACH,IAAI,EAAE;YACJ,IAAI,EAAE,MAAM;YACZ,CAAC,EAAE,0BAA0B;YAC7B,CAAC,EAAE,kBAAkB;YACrB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;WAMG;QACH,aAAa,EAAE;YACb,IAAI,EAAE,eAAe;YACrB,CAAC,EAAE,mCAAmC;YACtC,CAAC,EAAE,kBAAkB;YACrB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;WAKG;QACH,SAAS,EAAE;YACT,IAAI,EAAE,WAAW;YACjB,CAAC,EAAE,gBAAgB;YACnB,CAAC,EAAE,cAAc;YACjB,IAAI,EAAE,UAAU,CAAC,eAAe;SACjC;QACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAuCG;QACH,sBAAsB,EAAE;YACtB,IAAI,EAAE,wBAAwB;YAC9B,CAAC,EAAE,6BAA6B;YAChC,CAAC,EAAE,8BAA8B;YACjC,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;WAQG;QACH,qBAAqB,EAAE;YACrB,IAAI,EAAE,uBAAuB;YAC7B,CAAC,EAAE,0BAA0B;YAC7B,CAAC,EAAE,2BAA2B;YAC9B,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;WAOG;QACH,mBAAmB,EAAE;YACnB,IAAI,EAAE,qBAAqB;YAC3B,CAAC,EAAE,wBAAwB;YAC3B,CAAC,EAAE,yBAAyB;YAC5B,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;WAOG;QACH,iBAAiB,EAAE;YACjB,IAAI,EAAE,mBAAmB;YACzB,CAAC,EAAE,sBAAsB;YACzB,CAAC,EAAE,uBAAuB;YAC1B,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;KACF;CACO,CAAC"}

package/ai/stigmer/agentic/agentexecution/v1/query_pb.d.ts

@@ -0,0 +1,142 @@
+import type { GenFile, GenService } from "@bufbuild/protobuf/codegenv1";
+import type { AgentExecutionSchema } from "./api_pb";
+import type { AgentExecutionIdSchema, AgentExecutionListSchema, GetAgentUsageReportInputSchema, GetAgentUsageReportOutputSchema, GetArtifactDownloadUrlRequestSchema, GetArtifactDownloadUrlResponseSchema, GetOrgUsageReportInputSchema, GetOrgUsageReportOutputSchema, GetSessionUsageReportInputSchema, GetSessionUsageReportOutputSchema, ListAgentExecutionsBySessionRequestSchema, ListAgentExecutionsRequestSchema } from "./io_pb";
+/**
+ * Describes the file ai/stigmer/agentic/agentexecution/v1/query.proto.
+ */
+export declare const file_ai_stigmer_agentic_agentexecution_v1_query: GenFile;
+/**
+ * AgentExecutionQueryController handles read operations for agent executions.
+ *
+ * @generated from service ai.stigmer.agentic.agentexecution.v1.AgentExecutionQueryController
+ */
+export declare const AgentExecutionQueryController: GenService<{
+    /**
+     * Get a single agent execution by ID.
+     *
+     * @generated from rpc ai.stigmer.agentic.agentexecution.v1.AgentExecutionQueryController.get
+     */
+    get: {
+        methodKind: "unary";
+        input: typeof AgentExecutionIdSchema;
+        output: typeof AgentExecutionSchema;
+    };
+    /**
+     * List all agent executions with pagination and optional filtering.
+     *
+     * @generated from rpc ai.stigmer.agentic.agentexecution.v1.AgentExecutionQueryController.list
+     */
+    list: {
+        methodKind: "unary";
+        input: typeof ListAgentExecutionsRequestSchema;
+        output: typeof AgentExecutionListSchema;
+    };
+    /**
+     * List all executions in a specific session.
+     * Authorization is handled in handler via FGA query for authorized agent_execution_ids,
+     * then filtered by session_id. This ensures consistent authorization pattern across all list operations.
+     *
+     * @generated from rpc ai.stigmer.agentic.agentexecution.v1.AgentExecutionQueryController.listBySession
+     */
+    listBySession: {
+        methodKind: "unary";
+        input: typeof ListAgentExecutionsBySessionRequestSchema;
+        output: typeof AgentExecutionListSchema;
+    };
+    /**
+     * Subscribe to real-time execution updates (streaming).
+     * Authorization is handled by the FJ model via proto configuration.
+     *
+     * @generated from rpc ai.stigmer.agentic.agentexecution.v1.AgentExecutionQueryController.subscribe
+     */
+    subscribe: {
+        methodKind: "server_streaming";
+        input: typeof AgentExecutionIdSchema;
+        output: typeof AgentExecutionSchema;
+    };
+    /**
+     * Get a presigned download URL for an execution artifact.
+     *
+     * Returns a time-limited URL for downloading an artifact published by
+     * an agent during execution. The URL can be used with a simple HTTP GET
+     * request without authentication.
+     *
+     * ## Authorization
+     *
+     * Requires can_view permission on the execution. This ensures users can
+     * only download artifacts from executions they have access to.
+     *
+     * ## Security
+     *
+     * The storage_key is validated to ensure it belongs to the specified
+     * execution. Keys must start with "artifacts/{execution_id}/" to prevent
+     * path traversal attacks.
+     *
+     * ## URL Expiration
+     *
+     * Download URLs expire after 7 days (configurable). After expiration,
+     * call this endpoint again to get a fresh URL.
+     *
+     * ## Use Cases
+     *
+     * - CLI downloading agent-created files
+     * - Web UI providing download links for artifacts
+     * - Refreshing expired download URLs
+     *
+     * ## Example Flow
+     *
+     * 1. Get execution via AgentExecutionQueryController.get
+     * 2. Find artifact in status.artifacts[]
+     * 3. Call getArtifactDownloadUrl with execution_id and storage_key
+     * 4. Use returned download_url for HTTP GET
+     *
+     * @since Artifact Lifecycle (Attachments & Artifacts)
+     *
+     * @generated from rpc ai.stigmer.agentic.agentexecution.v1.AgentExecutionQueryController.getArtifactDownloadUrl
+     */
+    getArtifactDownloadUrl: {
+        methodKind: "unary";
+        input: typeof GetArtifactDownloadUrlRequestSchema;
+        output: typeof GetArtifactDownloadUrlResponseSchema;
+    };
+    /**
+     * Get usage report for a session (all executions in a session).
+     * Returns aggregated tokens, cost, cache hit rate, and per-execution breakdown.
+     *
+     * Authorization is handled in handler — caller must have can_view on
+     * all executions in the session (same pattern as listBySession).
+     *
+     * @generated from rpc ai.stigmer.agentic.agentexecution.v1.AgentExecutionQueryController.getSessionUsageReport
+     */
+    getSessionUsageReport: {
+        methodKind: "unary";
+        input: typeof GetSessionUsageReportInputSchema;
+        output: typeof GetSessionUsageReportOutputSchema;
+    };
+    /**
+     * Get usage report for an agent (all sessions for an agent in a time range).
+     * Returns aggregated tokens, cost, and per-session breakdown with pagination.
+     *
+     * Authorization is handled in handler — caller must have can_view on the agent.
+     *
+     * @generated from rpc ai.stigmer.agentic.agentexecution.v1.AgentExecutionQueryController.getAgentUsageReport
+     */
+    getAgentUsageReport: {
+        methodKind: "unary";
+        input: typeof GetAgentUsageReportInputSchema;
+        output: typeof GetAgentUsageReportOutputSchema;
+    };
+    /**
+     * Get usage report for an organization (all agents in a time range).
+     * Returns org-wide totals, top agents by cost, model breakdown, and daily trend.
+     *
+     * Authorization is handled in handler — caller must be org member.
+     *
+     * @generated from rpc ai.stigmer.agentic.agentexecution.v1.AgentExecutionQueryController.getOrgUsageReport
+     */
+    getOrgUsageReport: {
+        methodKind: "unary";
+        input: typeof GetOrgUsageReportInputSchema;
+        output: typeof GetOrgUsageReportOutputSchema;
+    };
+}>;

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

@@ -0,0 +1,19 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts"
+// @generated from file ai/stigmer/agentic/agentexecution/v1/query.proto (package ai.stigmer.agentic.agentexecution.v1, syntax proto3)
+/* eslint-disable */
+import { fileDesc, serviceDesc } from "@bufbuild/protobuf/codegenv1";
+import { file_ai_stigmer_agentic_agentexecution_v1_api } from "./api_pb";
+import { file_ai_stigmer_agentic_agentexecution_v1_io } from "./io_pb";
+import { file_ai_stigmer_commons_apiresource_rpc_service_options } from "../../../commons/apiresource/rpc_service_options_pb";
+import { file_ai_stigmer_iam_iampolicy_v1_rpcauthorization_method_options } from "../../../iam/iampolicy/v1/rpcauthorization/method_options_pb";
+/**
+ * Describes the file ai/stigmer/agentic/agentexecution/v1/query.proto.
+ */
+export const file_ai_stigmer_agentic_agentexecution_v1_query = /*@__PURE__*/ fileDesc("CjBhaS9zdGlnbWVyL2FnZW50aWMvYWdlbnRleGVjdXRpb24vdjEvcXVlcnkucHJvdG8SJGFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MTKJCwodQWdlbnRFeGVjdXRpb25RdWVyeUNvbnRyb2xsZXISqQEKA2dldBI2LmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5BZ2VudEV4ZWN1dGlvbklkGjQuYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLkFnZW50RXhlY3V0aW9uIjTCuBgwCAMQKSIFdmFsdWUqI3VuYXV0aG9yaXplZCB0byBnZXQgYWdlbnQgZXhlY3V0aW9uEogBCgRsaXN0EkAuYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLkxpc3RBZ2VudEV4ZWN1dGlvbnNSZXF1ZXN0GjguYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLkFnZW50RXhlY3V0aW9uTGlzdCIE0LgYARKaAQoNbGlzdEJ5U2Vzc2lvbhJJLmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5MaXN0QWdlbnRFeGVjdXRpb25zQnlTZXNzaW9uUmVxdWVzdBo4LmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5BZ2VudEV4ZWN1dGlvbkxpc3QiBNC4GAESugEKCXN1YnNjcmliZRI2LmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5BZ2VudEV4ZWN1dGlvbklkGjQuYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLkFnZW50RXhlY3V0aW9uIj3CuBg5CAMQKSIFdmFsdWUqLHVuYXV0aG9yaXplZCB0byBzdWJzY3JpYmUgdG8gYWdlbnQgZXhlY3V0aW9uMAES8wEKFmdldEFydGlmYWN0RG93bmxvYWRVcmwSQy5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnRleGVjdXRpb24udjEuR2V0QXJ0aWZhY3REb3dubG9hZFVybFJlcXVlc3QaRC5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnRleGVjdXRpb24udjEuR2V0QXJ0aWZhY3REb3dubG9hZFVybFJlc3BvbnNlIk7CuBhKCAMQKSIMZXhlY3V0aW9uX2lkKjZ1bmF1dGhvcml6ZWQgdG8gZG93bmxvYWQgYXJ0aWZhY3QgZnJvbSBhZ2VudCBleGVjdXRpb24SogEKFWdldFNlc3Npb25Vc2FnZVJlcG9ydBJALmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5HZXRTZXNzaW9uVXNhZ2VSZXBvcnRJbnB1dBpBLmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5HZXRTZXNzaW9uVXNhZ2VSZXBvcnRPdXRwdXQiBNC4GAESnAEKE2dldEFnZW50VXNhZ2VSZXBvcnQSPi5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnRleGVjdXRpb24udjEuR2V0QWdlbnRVc2FnZVJlcG9ydElucHV0Gj8uYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLkdldEFnZW50VXNhZ2VSZXBvcnRPdXRwdXQiBNC4GAESlgEKEWdldE9yZ1VzYWdlUmVwb3J0EjwuYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLkdldE9yZ1VzYWdlUmVwb3J0SW5wdXQaPS5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnRleGVjdXRpb24udjEuR2V0T3JnVXNhZ2VSZXBvcnRPdXRwdXQiBNC4GAEaBKD/KyliBnByb3RvMw", [file_ai_stigmer_agentic_agentexecution_v1_api, file_ai_stigmer_agentic_agentexecution_v1_io, file_ai_stigmer_commons_apiresource_rpc_service_options, file_ai_stigmer_iam_iampolicy_v1_rpcauthorization_method_options]);
+/**
+ * AgentExecutionQueryController handles read operations for agent executions.
+ *
+ * @generated from service ai.stigmer.agentic.agentexecution.v1.AgentExecutionQueryController
+ */
+export const AgentExecutionQueryController = /*@__PURE__*/ serviceDesc(file_ai_stigmer_agentic_agentexecution_v1_query, 0);
+//# sourceMappingURL=query_pb.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/agentexecution/v1/query_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,sIAAsI;AACtI,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,6CAA6C,EAAE,MAAM,UAAU,CAAC;AAEzE,OAAO,EAAE,4CAA4C,EAAE,MAAM,SAAS,CAAC;AACvE,OAAO,EAAE,uDAAuD,EAAE,MAAM,qDAAqD,CAAC;AAC9H,OAAO,EAAE,gEAAgE,EAAE,MAAM,8DAA8D,CAAC;AAEhJ;;GAEG;AACH,MAAM,CAAC,MAAM,+CAA+C,GAAY,aAAa,CACnF,QAAQ,CAAC,w+DAAw+D,EAAE,CAAC,6CAA6C,EAAE,4CAA4C,EAAE,uDAAuD,EAAE,gEAAgE,CAAC,CAAC,CAAC;AAE/sE;;;;GAIG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAiIrC,aAAa,CAChB,WAAW,CAAC,+CAA+C,EAAE,CAAC,CAAC,CAAC"}