@stigmer/protos 0.0.36 → 0.0.40

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

@@ -45,6 +45,24 @@ export declare const AgentCommandController: {
             readonly O: any;
             readonly kind: any;
         };
+        /**
+         * Update the visibility of an existing agent.
+         *
+         * This is a targeted metadata update — it only modifies metadata.visibility,
+         * leaving spec, status, and other metadata fields untouched. Use this to
+         * make an agent publicly accessible or to revoke public access without
+         * sending the entire agent resource (avoiding read-modify-write races).
+         *
+         * Authorization: Requires can_edit permission on the agent resource.
+         *
+         * @generated from rpc ai.stigmer.agentic.agent.v1.AgentCommandController.updateVisibility
+         */
+        readonly updateVisibility: {
+            readonly name: "updateVisibility";
+            readonly I: any;
+            readonly O: any;
+            readonly kind: any;
+        };
         /**
          * Delete an agent.
          *

package/ai/stigmer/agentic/agent/v1/command_connect.js

@@ -50,6 +50,24 @@ export const AgentCommandController = {
             O: Agent,
             kind: MethodKind.Unary,
         },
+        /**
+         * Update the visibility of an existing agent.
+         *
+         * This is a targeted metadata update — it only modifies metadata.visibility,
+         * leaving spec, status, and other metadata fields untouched. Use this to
+         * make an agent publicly accessible or to revoke public access without
+         * sending the entire agent resource (avoiding read-modify-write races).
+         *
+         * Authorization: Requires can_edit permission on the agent resource.
+         *
+         * @generated from rpc ai.stigmer.agentic.agent.v1.AgentCommandController.updateVisibility
+         */
+        updateVisibility: {
+            name: "updateVisibility",
+            I: UpdateVisibilityInput,
+            O: Agent,
+            kind: MethodKind.Unary,
+        },
         /**
          * Delete an agent.
          *

package/ai/stigmer/agentic/agent/v1/command_connect.js.map

@@ -1 +1 @@
-{"version":3,"file":"command_connect.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/agent/v1/command_connect.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,sHAAsH;AACtH,oBAAoB;AACpB,cAAc;AAGd,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,QAAQ,EAAE,oDAAoD;IAC9D,OAAO,EAAE;QACP;;;;;;WAMG;QACH,KAAK,EAAE;YACL,IAAI,EAAE,OAAO;YACb,CAAC,EAAE,KAAK;YACR,CAAC,EAAE,KAAK;YACR,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;WAQG;QACH,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,CAAC,EAAE,KAAK;YACR,CAAC,EAAE,KAAK;YACR,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;WAIG;QACH,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,CAAC,EAAE,KAAK;YACR,CAAC,EAAE,KAAK;YACR,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;WAIG;QACH,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,CAAC,EAAE,OAAO;YACV,CAAC,EAAE,KAAK;YACR,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;KACF;CACO,CAAC"}
+{"version":3,"file":"command_connect.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/agent/v1/command_connect.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,sHAAsH;AACtH,oBAAoB;AACpB,cAAc;AAGd,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,QAAQ,EAAE,oDAAoD;IAC9D,OAAO,EAAE;QACP;;;;;;WAMG;QACH,KAAK,EAAE;YACL,IAAI,EAAE,OAAO;YACb,CAAC,EAAE,KAAK;YACR,CAAC,EAAE,KAAK;YACR,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;WAQG;QACH,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,CAAC,EAAE,KAAK;YACR,CAAC,EAAE,KAAK;YACR,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;WAIG;QACH,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,CAAC,EAAE,KAAK;YACR,CAAC,EAAE,KAAK;YACR,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;;WAWG;QACH,gBAAgB,EAAE;YAChB,IAAI,EAAE,kBAAkB;YACxB,CAAC,EAAE,qBAAqB;YACxB,CAAC,EAAE,KAAK;YACR,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;WAIG;QACH,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,CAAC,EAAE,OAAO;YACV,CAAC,EAAE,KAAK;YACR,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;KACF;CACO,CAAC"}

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

@@ -1,6 +1,7 @@
 import type { GenFile, GenService } from "@bufbuild/protobuf/codegenv1";
 import type { AgentSchema } from "./api_pb";
 import type { AgentIdSchema } from "./io_pb";
+import type { UpdateVisibilityInputSchema } from "../../../commons/apiresource/io_pb";
 /**
  * Describes the file ai/stigmer/agentic/agent/v1/command.proto.
  */
@@ -47,6 +48,23 @@ export declare const AgentCommandController: GenService<{
         input: typeof AgentSchema;
         output: typeof AgentSchema;
     };
+    /**
+     * Update the visibility of an existing agent.
+     *
+     * This is a targeted metadata update — it only modifies metadata.visibility,
+     * leaving spec, status, and other metadata fields untouched. Use this to
+     * make an agent publicly accessible or to revoke public access without
+     * sending the entire agent resource (avoiding read-modify-write races).
+     *
+     * Authorization: Requires can_edit permission on the agent resource.
+     *
+     * @generated from rpc ai.stigmer.agentic.agent.v1.AgentCommandController.updateVisibility
+     */
+    updateVisibility: {
+        methodKind: "unary";
+        input: typeof UpdateVisibilityInputSchema;
+        output: typeof AgentSchema;
+    };
     /**
      * Delete an agent.
      *

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

@@ -4,12 +4,13 @@
 import { fileDesc, serviceDesc } from "@bufbuild/protobuf/codegenv1";
 import { file_ai_stigmer_agentic_agent_v1_api } from "./api_pb";
 import { file_ai_stigmer_agentic_agent_v1_io } from "./io_pb";
+import { file_ai_stigmer_commons_apiresource_io } from "../../../commons/apiresource/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/agent/v1/command.proto.
  */
-export const file_ai_stigmer_agentic_agent_v1_command = /*@__PURE__*/ fileDesc("CilhaS9zdGlnbWVyL2FnZW50aWMvYWdlbnQvdjEvY29tbWFuZC5wcm90bxIbYWkuc3RpZ21lci5hZ2VudGljLmFnZW50LnYxMpkEChZBZ2VudENvbW1hbmRDb250cm9sbGVyEk8KBWFwcGx5EiIuYWkuc3RpZ21lci5hZ2VudGljLmFnZW50LnYxLkFnZW50GiIuYWkuc3RpZ21lci5hZ2VudGljLmFnZW50LnYxLkFnZW50EpsBCgZjcmVhdGUSIi5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnQudjEuQWdlbnQaIi5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnQudjEuQWdlbnQiScK4GEUIEBAeIgxtZXRhZGF0YS5vcmcqMXVuYXV0aG9yaXplZCB0byBjcmVhdGUgYWdlbnQgaW4gdGhpcyBvcmdhbml6YXRpb24ShQEKBnVwZGF0ZRIiLmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudC52MS5BZ2VudBoiLmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudC52MS5BZ2VudCIzwrgYLwgEECgiC21ldGFkYXRhLmlkKhx1bmF1dGhvcml6ZWQgdG8gdXBkYXRlIGFnZW50EoEBCgZkZWxldGUSJC5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnQudjEuQWdlbnRJZBoiLmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudC52MS5BZ2VudCItwrgYKQgCECgiBXZhbHVlKhx1bmF1dGhvcml6ZWQgdG8gZGVsZXRlIGFnZW50GgSg/ysoYgZwcm90bzM", [file_ai_stigmer_agentic_agent_v1_api, file_ai_stigmer_agentic_agent_v1_io, file_ai_stigmer_commons_apiresource_rpc_service_options, file_ai_stigmer_iam_iampolicy_v1_rpcauthorization_method_options]);
+export const file_ai_stigmer_agentic_agent_v1_command = /*@__PURE__*/ fileDesc("CilhaS9zdGlnbWVyL2FnZW50aWMvYWdlbnQvdjEvY29tbWFuZC5wcm90bxIbYWkuc3RpZ21lci5hZ2VudGljLmFnZW50LnYxMskFChZBZ2VudENvbW1hbmRDb250cm9sbGVyEk8KBWFwcGx5EiIuYWkuc3RpZ21lci5hZ2VudGljLmFnZW50LnYxLkFnZW50GiIuYWkuc3RpZ21lci5hZ2VudGljLmFnZW50LnYxLkFnZW50EpsBCgZjcmVhdGUSIi5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnQudjEuQWdlbnQaIi5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnQudjEuQWdlbnQiScK4GEUIEBAeIgxtZXRhZGF0YS5vcmcqMXVuYXV0aG9yaXplZCB0byBjcmVhdGUgYWdlbnQgaW4gdGhpcyBvcmdhbml6YXRpb24ShQEKBnVwZGF0ZRIiLmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudC52MS5BZ2VudBoiLmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudC52MS5BZ2VudCIzwrgYLwgEECgiC21ldGFkYXRhLmlkKhx1bmF1dGhvcml6ZWQgdG8gdXBkYXRlIGFnZW50Eq0BChB1cGRhdGVWaXNpYmlsaXR5EjUuYWkuc3RpZ21lci5jb21tb25zLmFwaXJlc291cmNlLlVwZGF0ZVZpc2liaWxpdHlJbnB1dBoiLmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudC52MS5BZ2VudCI+wrgYOggEECgiC3Jlc291cmNlX2lkKid1bmF1dGhvcml6ZWQgdG8gdXBkYXRlIGFnZW50IHZpc2liaWxpdHkSgQEKBmRlbGV0ZRIkLmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudC52MS5BZ2VudElkGiIuYWkuc3RpZ21lci5hZ2VudGljLmFnZW50LnYxLkFnZW50Ii3CuBgpCAIQKCIFdmFsdWUqHHVuYXV0aG9yaXplZCB0byBkZWxldGUgYWdlbnQaBKD/KyhiBnByb3RvMw", [file_ai_stigmer_agentic_agent_v1_api, file_ai_stigmer_agentic_agent_v1_io, file_ai_stigmer_commons_apiresource_io, file_ai_stigmer_commons_apiresource_rpc_service_options, file_ai_stigmer_iam_iampolicy_v1_rpcauthorization_method_options]);
 /**
  * AgentCommandController handles write operations for AI agents.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"command_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/agent/v1/command_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,sHAAsH;AACtH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,oCAAoC,EAAE,MAAM,UAAU,CAAC;AAEhE,OAAO,EAAE,mCAAmC,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,uDAAuD,EAAE,MAAM,qDAAqD,CAAC;AAC9H,OAAO,EAAE,gEAAgE,EAAE,MAAM,8DAA8D,CAAC;AAEhJ;;GAEG;AACH,MAAM,CAAC,MAAM,wCAAwC,GAAY,aAAa,CAC5E,QAAQ,CAAC,6zBAA6zB,EAAE,CAAC,oCAAoC,EAAE,mCAAmC,EAAE,uDAAuD,EAAE,gEAAgE,CAAC,CAAC,CAAC;AAElhC;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GA+C9B,aAAa,CAChB,WAAW,CAAC,wCAAwC,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"command_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/agent/v1/command_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,sHAAsH;AACtH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,oCAAoC,EAAE,MAAM,UAAU,CAAC;AAEhE,OAAO,EAAE,mCAAmC,EAAE,MAAM,SAAS,CAAC;AAE9D,OAAO,EAAE,sCAAsC,EAAE,MAAM,oCAAoC,CAAC;AAC5F,OAAO,EAAE,uDAAuD,EAAE,MAAM,qDAAqD,CAAC;AAC9H,OAAO,EAAE,gEAAgE,EAAE,MAAM,8DAA8D,CAAC;AAEhJ;;GAEG;AACH,MAAM,CAAC,MAAM,wCAAwC,GAAY,aAAa,CAC5E,QAAQ,CAAC,wiCAAwiC,EAAE,CAAC,oCAAoC,EAAE,mCAAmC,EAAE,sCAAsC,EAAE,uDAAuD,EAAE,gEAAgE,CAAC,CAAC,CAAC;AAEryC;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAgE9B,aAAa,CAChB,WAAW,CAAC,wCAAwC,EAAE,CAAC,CAAC,CAAC"}

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

@@ -20,3 +20,22 @@ export type AgentId = Message<"ai.stigmer.agentic.agent.v1.AgentId"> & {
  * Use `create(AgentIdSchema)` to create a new message.
  */
 export declare const AgentIdSchema: GenMessage<AgentId>;
+/**
+ * GetDefaultAgentRequest provides org context for fetching the platform default agent.
+ *
+ * The handler resolves the default agent globally (by label stigmer.ai/default-agent: "true"
+ * with visibility_public), but the org is needed for authorization scoping.
+ *
+ * @generated from message ai.stigmer.agentic.agent.v1.GetDefaultAgentRequest
+ */
+export type GetDefaultAgentRequest = Message<"ai.stigmer.agentic.agent.v1.GetDefaultAgentRequest"> & {
+    /**
+     * @generated from field: string org = 1;
+     */
+    org: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.agent.v1.GetDefaultAgentRequest.
+ * Use `create(GetDefaultAgentRequestSchema)` to create a new message.
+ */
+export declare const GetDefaultAgentRequestSchema: GenMessage<GetDefaultAgentRequest>;

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

@@ -6,10 +6,15 @@ import { file_buf_validate_validate } from "../../../../../buf/validate/validate
 /**
  * Describes the file ai/stigmer/agentic/agent/v1/io.proto.
  */
-export const file_ai_stigmer_agentic_agent_v1_io = /*@__PURE__*/ fileDesc("CiRhaS9zdGlnbWVyL2FnZW50aWMvYWdlbnQvdjEvaW8ucHJvdG8SG2FpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudC52MSIgCgdBZ2VudElkEhUKBXZhbHVlGAEgASgJQga6SAPIAQFiBnByb3RvMw", [file_buf_validate_validate]);
+export const file_ai_stigmer_agentic_agent_v1_io = /*@__PURE__*/ fileDesc("CiRhaS9zdGlnbWVyL2FnZW50aWMvYWdlbnQvdjEvaW8ucHJvdG8SG2FpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudC52MSIgCgdBZ2VudElkEhUKBXZhbHVlGAEgASgJQga6SAPIAQEiLgoWR2V0RGVmYXVsdEFnZW50UmVxdWVzdBIUCgNvcmcYASABKAlCB7pIBHICEAFiBnByb3RvMw", [file_buf_validate_validate]);
 /**
  * Describes the message ai.stigmer.agentic.agent.v1.AgentId.
  * Use `create(AgentIdSchema)` to create a new message.
  */
 export const AgentIdSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_agent_v1_io, 0);
+/**
+ * Describes the message ai.stigmer.agentic.agent.v1.GetDefaultAgentRequest.
+ * Use `create(GetDefaultAgentRequestSchema)` to create a new message.
+ */
+export const GetDefaultAgentRequestSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_agent_v1_io, 1);
 //# sourceMappingURL=io_pb.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"io_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/agent/v1/io_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,iHAAiH;AACjH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAGrF;;GAEG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAY,aAAa,CACvE,QAAQ,CAAC,oJAAoJ,EAAE,CAAC,0BAA0B,CAAC,CAAC,CAAC;AAc/L;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAwB,aAAa,CAC7D,WAAW,CAAC,mCAAmC,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"io_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/agent/v1/io_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,iHAAiH;AACjH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAGrF;;GAEG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAY,aAAa,CACvE,QAAQ,CAAC,oNAAoN,EAAE,CAAC,0BAA0B,CAAC,CAAC,CAAC;AAc/P;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAwB,aAAa,CAC7D,WAAW,CAAC,mCAAmC,EAAE,CAAC,CAAC,CAAC;AAiBtD;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAuC,aAAa,CAC3F,WAAW,CAAC,mCAAmC,EAAE,CAAC,CAAC,CAAC"}

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

@@ -28,5 +28,26 @@ export declare const AgentQueryController: {
             readonly O: any;
             readonly kind: any;
         };
+        /**
+         * Get the platform default agent.
+         *
+         * Resolves the agent labeled stigmer.ai/default-agent: "true" with
+         * visibility_public. Returns the full Agent resource including
+         * status.default_instance_id for session creation.
+         *
+         * Used by frontends to enable session-first UX where users start
+         * a conversation without explicitly selecting an agent.
+         *
+         * Error: NOT_FOUND if no default agent is configured.
+         * Custom authorization in handler.
+         *
+         * @generated from rpc ai.stigmer.agentic.agent.v1.AgentQueryController.getDefault
+         */
+        readonly getDefault: {
+            readonly name: "getDefault";
+            readonly I: any;
+            readonly O: any;
+            readonly kind: any;
+        };
     };
 };

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

@@ -33,6 +33,27 @@ export const AgentQueryController = {
             O: Agent,
             kind: MethodKind.Unary,
         },
+        /**
+         * Get the platform default agent.
+         *
+         * Resolves the agent labeled stigmer.ai/default-agent: "true" with
+         * visibility_public. Returns the full Agent resource including
+         * status.default_instance_id for session creation.
+         *
+         * Used by frontends to enable session-first UX where users start
+         * a conversation without explicitly selecting an agent.
+         *
+         * Error: NOT_FOUND if no default agent is configured.
+         * Custom authorization in handler.
+         *
+         * @generated from rpc ai.stigmer.agentic.agent.v1.AgentQueryController.getDefault
+         */
+        getDefault: {
+            name: "getDefault",
+            I: GetDefaultAgentRequest,
+            O: Agent,
+            kind: MethodKind.Unary,
+        },
     }
 };
 //# sourceMappingURL=query_connect.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"query_connect.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/agent/v1/query_connect.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,oHAAoH;AACpH,oBAAoB;AACpB,cAAc;AAId,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,QAAQ,EAAE,kDAAkD;IAC5D,OAAO,EAAE;QACP;;;;WAIG;QACH,GAAG,EAAE;YACH,IAAI,EAAE,KAAK;YACX,CAAC,EAAE,OAAO;YACV,CAAC,EAAE,KAAK;YACR,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;WAIG;QACH,cAAc,EAAE;YACd,IAAI,EAAE,gBAAgB;YACtB,CAAC,EAAE,oBAAoB;YACvB,CAAC,EAAE,KAAK;YACR,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;KACF;CACO,CAAC"}
+{"version":3,"file":"query_connect.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/agent/v1/query_connect.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,oHAAoH;AACpH,oBAAoB;AACpB,cAAc;AAId,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,QAAQ,EAAE,kDAAkD;IAC5D,OAAO,EAAE;QACP;;;;WAIG;QACH,GAAG,EAAE;YACH,IAAI,EAAE,KAAK;YACX,CAAC,EAAE,OAAO;YACV,CAAC,EAAE,KAAK;YACR,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;WAIG;QACH,cAAc,EAAE;YACd,IAAI,EAAE,gBAAgB;YACtB,CAAC,EAAE,oBAAoB;YACvB,CAAC,EAAE,KAAK;YACR,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;;;;;WAcG;QACH,UAAU,EAAE;YACV,IAAI,EAAE,YAAY;YAClB,CAAC,EAAE,sBAAsB;YACzB,CAAC,EAAE,KAAK;YACR,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;KACF;CACO,CAAC"}

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

@@ -1,6 +1,6 @@
 import type { GenFile, GenService } from "@bufbuild/protobuf/codegenv1";
 import type { AgentSchema } from "./api_pb";
-import type { AgentIdSchema } from "./io_pb";
+import type { AgentIdSchema, GetDefaultAgentRequestSchema } from "./io_pb";
 import type { ApiResourceReferenceSchema } from "../../../commons/apiresource/io_pb";
 /**
  * Describes the file ai/stigmer/agentic/agent/v1/query.proto.
@@ -32,4 +32,24 @@ export declare const AgentQueryController: GenService<{
         input: typeof ApiResourceReferenceSchema;
         output: typeof AgentSchema;
     };
+    /**
+     * Get the platform default agent.
+     *
+     * Resolves the agent labeled stigmer.ai/default-agent: "true" with
+     * visibility_public. Returns the full Agent resource including
+     * status.default_instance_id for session creation.
+     *
+     * Used by frontends to enable session-first UX where users start
+     * a conversation without explicitly selecting an agent.
+     *
+     * Error: NOT_FOUND if no default agent is configured.
+     * Custom authorization in handler.
+     *
+     * @generated from rpc ai.stigmer.agentic.agent.v1.AgentQueryController.getDefault
+     */
+    getDefault: {
+        methodKind: "unary";
+        input: typeof GetDefaultAgentRequestSchema;
+        output: typeof AgentSchema;
+    };
 }>;

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

@@ -10,7 +10,7 @@ import { file_ai_stigmer_iam_iampolicy_v1_rpcauthorization_method_options } from
 /**
  * Describes the file ai/stigmer/agentic/agent/v1/query.proto.
  */
-export const file_ai_stigmer_agentic_agent_v1_query = /*@__PURE__*/ fileDesc("CidhaS9zdGlnbWVyL2FnZW50aWMvYWdlbnQvdjEvcXVlcnkucHJvdG8SG2FpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudC52MTKFAgoUQWdlbnRRdWVyeUNvbnRyb2xsZXISewoDZ2V0EiQuYWkuc3RpZ21lci5hZ2VudGljLmFnZW50LnYxLkFnZW50SWQaIi5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnQudjEuQWdlbnQiKsK4GCYIAxAoIgV2YWx1ZSoZdW5hdXRob3JpemVkIHRvIGdldCBhZ2VudBJqCg5nZXRCeVJlZmVyZW5jZRI0LmFpLnN0aWdtZXIuY29tbW9ucy5hcGlyZXNvdXJjZS5BcGlSZXNvdXJjZVJlZmVyZW5jZRoiLmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudC52MS5BZ2VudBoEoP8rKGIGcHJvdG8z", [file_ai_stigmer_agentic_agent_v1_api, file_ai_stigmer_agentic_agent_v1_io, file_ai_stigmer_commons_apiresource_io, file_ai_stigmer_commons_apiresource_rpc_service_options, file_ai_stigmer_iam_iampolicy_v1_rpcauthorization_method_options]);
+export const file_ai_stigmer_agentic_agent_v1_query = /*@__PURE__*/ fileDesc("CidhaS9zdGlnbWVyL2FnZW50aWMvYWdlbnQvdjEvcXVlcnkucHJvdG8SG2FpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudC52MTL4AgoUQWdlbnRRdWVyeUNvbnRyb2xsZXISewoDZ2V0EiQuYWkuc3RpZ21lci5hZ2VudGljLmFnZW50LnYxLkFnZW50SWQaIi5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnQudjEuQWdlbnQiKsK4GCYIAxAoIgV2YWx1ZSoZdW5hdXRob3JpemVkIHRvIGdldCBhZ2VudBJwCg5nZXRCeVJlZmVyZW5jZRI0LmFpLnN0aWdtZXIuY29tbW9ucy5hcGlyZXNvdXJjZS5BcGlSZXNvdXJjZVJlZmVyZW5jZRoiLmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudC52MS5BZ2VudCIE0LgYARJrCgpnZXREZWZhdWx0EjMuYWkuc3RpZ21lci5hZ2VudGljLmFnZW50LnYxLkdldERlZmF1bHRBZ2VudFJlcXVlc3QaIi5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnQudjEuQWdlbnQiBNC4GAEaBKD/KyhiBnByb3RvMw", [file_ai_stigmer_agentic_agent_v1_api, file_ai_stigmer_agentic_agent_v1_io, file_ai_stigmer_commons_apiresource_io, file_ai_stigmer_commons_apiresource_rpc_service_options, file_ai_stigmer_iam_iampolicy_v1_rpcauthorization_method_options]);
 /**
  * AgentQueryController handles read operations for AI agents.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"query_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/agent/v1/query_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,oHAAoH;AACpH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,oCAAoC,EAAE,MAAM,UAAU,CAAC;AAEhE,OAAO,EAAE,mCAAmC,EAAE,MAAM,SAAS,CAAC;AAE9D,OAAO,EAAE,sCAAsC,EAAE,MAAM,oCAAoC,CAAC;AAC5F,OAAO,EAAE,uDAAuD,EAAE,MAAM,qDAAqD,CAAC;AAC9H,OAAO,EAAE,gEAAgE,EAAE,MAAM,8DAA8D,CAAC;AAEhJ;;GAEG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAY,aAAa,CAC1E,QAAQ,CAAC,0cAA0c,EAAE,CAAC,oCAAoC,EAAE,mCAAmC,EAAE,sCAAsC,EAAE,uDAAuD,EAAE,gEAAgE,CAAC,CAAC,CAAC;AAEvsB;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAqB5B,aAAa,CAChB,WAAW,CAAC,sCAAsC,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"query_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/agent/v1/query_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,oHAAoH;AACpH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,oCAAoC,EAAE,MAAM,UAAU,CAAC;AAEhE,OAAO,EAAE,mCAAmC,EAAE,MAAM,SAAS,CAAC;AAE9D,OAAO,EAAE,sCAAsC,EAAE,MAAM,oCAAoC,CAAC;AAC5F,OAAO,EAAE,uDAAuD,EAAE,MAAM,qDAAqD,CAAC;AAC9H,OAAO,EAAE,gEAAgE,EAAE,MAAM,8DAA8D,CAAC;AAEhJ;;GAEG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAY,aAAa,CAC1E,QAAQ,CAAC,omBAAomB,EAAE,CAAC,oCAAoC,EAAE,mCAAmC,EAAE,sCAAsC,EAAE,uDAAuD,EAAE,gEAAgE,CAAC,CAAC,CAAC;AAEj2B;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAyC5B,aAAa,CAChB,WAAW,CAAC,sCAAsC,EAAE,CAAC,CAAC,CAAC"}

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

@@ -83,6 +83,23 @@ export type ExecutionArtifact = Message<"ai.stigmer.agentic.agentexecution.v1.Ex
      * @generated from field: string expires_at = 8;
      */
     expiresAt: string;
+    /**
+     * Relative file paths within a directory artifact's archive.
+     *
+     * Populated at creation time by the agent runner when archiving a
+     * directory. Empty for FILE artifacts and for older DIRECTORY
+     * artifacts created before this field was added.
+     *
+     * Clients use this for instant skill package detection (check for
+     * "SKILL.md") and for rendering file listings without additional RPCs.
+     *
+     * Paths use forward slashes and are relative to the archive root.
+     * Directory entries are excluded — only regular files are listed.
+     * Examples: ["SKILL.md", "scripts/init_skill.py", "references/workflows.md"]
+     *
+     * @generated from field: repeated string entries = 9;
+     */
+    entries: string[];
 };
 /**
  * Describes the message ai.stigmer.agentic.agentexecution.v1.ExecutionArtifact.

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

@@ -7,7 +7,7 @@ import { file_buf_validate_validate } from "../../../../../buf/validate/validate
 /**
  * Describes the file ai/stigmer/agentic/agentexecution/v1/artifact.proto.
  */
-export const file_ai_stigmer_agentic_agentexecution_v1_artifact = /*@__PURE__*/ fileDesc("CjNhaS9zdGlnbWVyL2FnZW50aWMvYWdlbnRleGVjdXRpb24vdjEvYXJ0aWZhY3QucHJvdG8SJGFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MSLzAQoRRXhlY3V0aW9uQXJ0aWZhY3QSDAoEbmFtZRgBIAEoCRIUCgxzYW5kYm94X3BhdGgYAiABKAkSUwoEa2luZBgDIAEoDjI7LmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5FeGVjdXRpb25BcnRpZmFjdEtpbmRCCLpIBYIBAhABEhIKCnNpemVfYnl0ZXMYBCABKAMSEwoLc3RvcmFnZV9rZXkYBSABKAkSFAoMZG93bmxvYWRfdXJsGAYgASgJEhIKCmNyZWF0ZWRfYXQYByABKAkSEgoKZXhwaXJlc19hdBgIIAEoCWIGcHJvdG8z", [file_ai_stigmer_agentic_agentexecution_v1_enum, file_buf_validate_validate]);
+export const file_ai_stigmer_agentic_agentexecution_v1_artifact = /*@__PURE__*/ fileDesc("CjNhaS9zdGlnbWVyL2FnZW50aWMvYWdlbnRleGVjdXRpb24vdjEvYXJ0aWZhY3QucHJvdG8SJGFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MSKEAgoRRXhlY3V0aW9uQXJ0aWZhY3QSDAoEbmFtZRgBIAEoCRIUCgxzYW5kYm94X3BhdGgYAiABKAkSUwoEa2luZBgDIAEoDjI7LmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5FeGVjdXRpb25BcnRpZmFjdEtpbmRCCLpIBYIBAhABEhIKCnNpemVfYnl0ZXMYBCABKAMSEwoLc3RvcmFnZV9rZXkYBSABKAkSFAoMZG93bmxvYWRfdXJsGAYgASgJEhIKCmNyZWF0ZWRfYXQYByABKAkSEgoKZXhwaXJlc19hdBgIIAEoCRIPCgdlbnRyaWVzGAkgAygJYgZwcm90bzM", [file_ai_stigmer_agentic_agentexecution_v1_enum, file_buf_validate_validate]);
 /**
  * Describes the message ai.stigmer.agentic.agentexecution.v1.ExecutionArtifact.
  * Use `create(ExecutionArtifactSchema)` to create a new message.

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

@@ -1 +1 @@
-{"version":3,"file":"artifact_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/agentexecution/v1/artifact_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,yIAAyI;AACzI,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,8CAA8C,EAAE,MAAM,WAAW,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAGrF;;GAEG;AACH,MAAM,CAAC,MAAM,kDAAkD,GAAY,aAAa,CACtF,QAAQ,CAAC,8cAA8c,EAAE,CAAC,8CAA8C,EAAE,0BAA0B,CAAC,CAAC,CAAC;AAyFziB;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAkC,aAAa,CACjF,WAAW,CAAC,kDAAkD,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"artifact_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/agentexecution/v1/artifact_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,yIAAyI;AACzI,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,8CAA8C,EAAE,MAAM,WAAW,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAGrF;;GAEG;AACH,MAAM,CAAC,MAAM,kDAAkD,GAAY,aAAa,CACtF,QAAQ,CAAC,qeAAqe,EAAE,CAAC,8CAA8C,EAAE,0BAA0B,CAAC,CAAC,CAAC;AA2GhkB;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAkC,aAAa,CACjF,WAAW,CAAC,kDAAkD,EAAE,CAAC,CAAC,CAAC"}

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

@@ -10,7 +10,7 @@ import { file_ai_stigmer_iam_iampolicy_v1_rpcauthorization_method_options } from
 /**
  * Describes the file ai/stigmer/agentic/agentexecution/v1/command.proto.
  */
-export const file_ai_stigmer_agentic_agentexecution_v1_command = /*@__PURE__*/ fileDesc("CjJhaS9zdGlnbWVyL2FnZW50aWMvYWdlbnRleGVjdXRpb24vdjEvY29tbWFuZC5wcm90bxIkYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxMuUPCh9BZ2VudEV4ZWN1dGlvbkNvbW1hbmRDb250cm9sbGVyEnYKBmNyZWF0ZRI0LmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5BZ2VudEV4ZWN1dGlvbho0LmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5BZ2VudEV4ZWN1dGlvbiIAErMBCgZ1cGRhdGUSNC5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnRleGVjdXRpb24udjEuQWdlbnRFeGVjdXRpb24aNC5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnRleGVjdXRpb24udjEuQWdlbnRFeGVjdXRpb24iPcK4GDkIBBApIgttZXRhZGF0YS5pZComdW5hdXRob3JpemVkIHRvIHVwZGF0ZSBhZ2VudCBleGVjdXRpb24S0gEKDHVwZGF0ZVN0YXR1cxJFLmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5BZ2VudEV4ZWN1dGlvblVwZGF0ZVN0YXR1c0lucHV0GjQuYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLkFnZW50RXhlY3V0aW9uIkXCuBhBCAQQKSIMZXhlY3V0aW9uX2lkKi11bmF1dGhvcml6ZWQgdG8gdXBkYXRlIGFnZW50IGV4ZWN1dGlvbiBzdGF0dXMSpgEKBmRlbGV0ZRItLmFpLnN0aWdtZXIuY29tbW9ucy5hcGlyZXNvdXJjZS5BcGlSZXNvdXJjZUlkGjQuYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLkFnZW50RXhlY3V0aW9uIjfCuBgzCAQQKSIFdmFsdWUqJnVuYXV0aG9yaXplZCB0byBkZWxldGUgYWdlbnQgZXhlY3V0aW9uEtQBCg5zdWJtaXRBcHByb3ZhbBI5LmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5TdWJtaXRBcHByb3ZhbElucHV0GjQuYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLkFnZW50RXhlY3V0aW9uIlHCuBhNCAQQKSISYWdlbnRfZXhlY3V0aW9uX2lkKjN1bmF1dGhvcml6ZWQgdG8gc3VibWl0IGFwcHJvdmFsIGZvciBhZ2VudCBleGVjdXRpb24StQEKBmNhbmNlbBI/LmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5DYW5jZWxBZ2VudEV4ZWN1dGlvbklucHV0GjQuYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLkFnZW50RXhlY3V0aW9uIjTCuBgwCAQQKSICaWQqJnVuYXV0aG9yaXplZCB0byBjYW5jZWwgYWdlbnQgZXhlY3V0aW9uEr4BCgl0ZXJtaW5hdGUSQi5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnRleGVjdXRpb24udjEuVGVybWluYXRlQWdlbnRFeGVjdXRpb25JbnB1dBo0LmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5BZ2VudEV4ZWN1dGlvbiI3wrgYMwgEECkiAmlkKil1bmF1dGhvcml6ZWQgdG8gdGVybWluYXRlIGFnZW50IGV4ZWN1dGlvbhK4AQoHcmVjb3ZlchJALmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5SZWNvdmVyQWdlbnRFeGVjdXRpb25JbnB1dBo0LmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5BZ2VudEV4ZWN1dGlvbiI1wrgYMQgEECkiAmlkKid1bmF1dGhvcml6ZWQgdG8gcmVjb3ZlciBhZ2VudCBleGVjdXRpb24SsgEKBXBhdXNlEj4uYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLlBhdXNlQWdlbnRFeGVjdXRpb25JbnB1dBo0LmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5BZ2VudEV4ZWN1dGlvbiIzwrgYLwgEECkiAmlkKiV1bmF1dGhvcml6ZWQgdG8gcGF1c2UgYWdlbnQgZXhlY3V0aW9uErUBCgZyZXN1bWUSPy5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnRleGVjdXRpb24udjEuUmVzdW1lQWdlbnRFeGVjdXRpb25JbnB1dBo0LmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5BZ2VudEV4ZWN1dGlvbiI0wrgYMAgEECkiAmlkKiZ1bmF1dGhvcml6ZWQgdG8gcmVzdW1lIGFnZW50IGV4ZWN1dGlvbhKXAQoQdXBsb2FkQXR0YWNobWVudBI9LmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5VcGxvYWRBdHRhY2htZW50UmVxdWVzdBo+LmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5VcGxvYWRBdHRhY2htZW50UmVzcG9uc2UiBNC4GAEaBKD/KyliBnByb3RvMw", [file_ai_stigmer_agentic_agentexecution_v1_api, file_ai_stigmer_agentic_agentexecution_v1_io, file_ai_stigmer_commons_apiresource_io, file_ai_stigmer_commons_apiresource_rpc_service_options, file_ai_stigmer_iam_iampolicy_v1_rpcauthorization_method_options]);
+export const file_ai_stigmer_agentic_agentexecution_v1_command = /*@__PURE__*/ fileDesc("CjJhaS9zdGlnbWVyL2FnZW50aWMvYWdlbnRleGVjdXRpb24vdjEvY29tbWFuZC5wcm90bxIkYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxMuQPCh9BZ2VudEV4ZWN1dGlvbkNvbW1hbmRDb250cm9sbGVyEnoKBmNyZWF0ZRI0LmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5BZ2VudEV4ZWN1dGlvbho0LmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5BZ2VudEV4ZWN1dGlvbiIE0LgYARKzAQoGdXBkYXRlEjQuYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLkFnZW50RXhlY3V0aW9uGjQuYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLkFnZW50RXhlY3V0aW9uIj3CuBg5CAQQKSILbWV0YWRhdGEuaWQqJnVuYXV0aG9yaXplZCB0byB1cGRhdGUgYWdlbnQgZXhlY3V0aW9uEs0BCgx1cGRhdGVTdGF0dXMSRS5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnRleGVjdXRpb24udjEuQWdlbnRFeGVjdXRpb25VcGRhdGVTdGF0dXNJbnB1dBo0LmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5BZ2VudEV4ZWN1dGlvbiJAwrgYPAgfEB8qLXVuYXV0aG9yaXplZCB0byB1cGRhdGUgYWdlbnQgZXhlY3V0aW9uIHN0YXR1czIHc3RpZ21lchKmAQoGZGVsZXRlEi0uYWkuc3RpZ21lci5jb21tb25zLmFwaXJlc291cmNlLkFwaVJlc291cmNlSWQaNC5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnRleGVjdXRpb24udjEuQWdlbnRFeGVjdXRpb24iN8K4GDMIBBApIgV2YWx1ZSomdW5hdXRob3JpemVkIHRvIGRlbGV0ZSBhZ2VudCBleGVjdXRpb24S1AEKDnN1Ym1pdEFwcHJvdmFsEjkuYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLlN1Ym1pdEFwcHJvdmFsSW5wdXQaNC5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnRleGVjdXRpb24udjEuQWdlbnRFeGVjdXRpb24iUcK4GE0IBBApIhJhZ2VudF9leGVjdXRpb25faWQqM3VuYXV0aG9yaXplZCB0byBzdWJtaXQgYXBwcm92YWwgZm9yIGFnZW50IGV4ZWN1dGlvbhK1AQoGY2FuY2VsEj8uYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLkNhbmNlbEFnZW50RXhlY3V0aW9uSW5wdXQaNC5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnRleGVjdXRpb24udjEuQWdlbnRFeGVjdXRpb24iNMK4GDAIBBApIgJpZComdW5hdXRob3JpemVkIHRvIGNhbmNlbCBhZ2VudCBleGVjdXRpb24SvgEKCXRlcm1pbmF0ZRJCLmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5UZXJtaW5hdGVBZ2VudEV4ZWN1dGlvbklucHV0GjQuYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLkFnZW50RXhlY3V0aW9uIjfCuBgzCAQQKSICaWQqKXVuYXV0aG9yaXplZCB0byB0ZXJtaW5hdGUgYWdlbnQgZXhlY3V0aW9uErgBCgdyZWNvdmVyEkAuYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLlJlY292ZXJBZ2VudEV4ZWN1dGlvbklucHV0GjQuYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLkFnZW50RXhlY3V0aW9uIjXCuBgxCAQQKSICaWQqJ3VuYXV0aG9yaXplZCB0byByZWNvdmVyIGFnZW50IGV4ZWN1dGlvbhKyAQoFcGF1c2USPi5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnRleGVjdXRpb24udjEuUGF1c2VBZ2VudEV4ZWN1dGlvbklucHV0GjQuYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLkFnZW50RXhlY3V0aW9uIjPCuBgvCAQQKSICaWQqJXVuYXV0aG9yaXplZCB0byBwYXVzZSBhZ2VudCBleGVjdXRpb24StQEKBnJlc3VtZRI/LmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5SZXN1bWVBZ2VudEV4ZWN1dGlvbklucHV0GjQuYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLkFnZW50RXhlY3V0aW9uIjTCuBgwCAQQKSICaWQqJnVuYXV0aG9yaXplZCB0byByZXN1bWUgYWdlbnQgZXhlY3V0aW9uEpcBChB1cGxvYWRBdHRhY2htZW50Ej0uYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLlVwbG9hZEF0dGFjaG1lbnRSZXF1ZXN0Gj4uYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLlVwbG9hZEF0dGFjaG1lbnRSZXNwb25zZSIE0LgYARoEoP8rKWIGcHJvdG8z", [file_ai_stigmer_agentic_agentexecution_v1_api, file_ai_stigmer_agentic_agentexecution_v1_io, file_ai_stigmer_commons_apiresource_io, file_ai_stigmer_commons_apiresource_rpc_service_options, file_ai_stigmer_iam_iampolicy_v1_rpcauthorization_method_options]);
 /**
  * AgentExecutionCommandController handles write operations for agent executions.
  * Follows the standard pattern: create, update, delete (no granular field updates).

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

@@ -1 +1 @@
-{"version":3,"file":"command_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/agentexecution/v1/command_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,wIAAwI;AACxI,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;AAEvE,OAAO,EAAE,sCAAsC,EAAE,MAAM,oCAAoC,CAAC;AAC5F,OAAO,EAAE,uDAAuD,EAAE,MAAM,qDAAqD,CAAC;AAC9H,OAAO,EAAE,gEAAgE,EAAE,MAAM,8DAA8D,CAAC;AAEhJ;;GAEG;AACH,MAAM,CAAC,MAAM,iDAAiD,GAAY,aAAa,CACrF,QAAQ,CAAC,gxFAAgxF,EAAE,CAAC,6CAA6C,EAAE,4CAA4C,EAAE,sCAAsC,EAAE,uDAAuD,EAAE,gEAAgE,CAAC,CAAC,CAAC;AAE/hG;;;;;GAKG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAwYvC,aAAa,CAChB,WAAW,CAAC,iDAAiD,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"command_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/agentexecution/v1/command_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,wIAAwI;AACxI,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;AAEvE,OAAO,EAAE,sCAAsC,EAAE,MAAM,oCAAoC,CAAC;AAC5F,OAAO,EAAE,uDAAuD,EAAE,MAAM,qDAAqD,CAAC;AAC9H,OAAO,EAAE,gEAAgE,EAAE,MAAM,8DAA8D,CAAC;AAEhJ;;GAEG;AACH,MAAM,CAAC,MAAM,iDAAiD,GAAY,aAAa,CACrF,QAAQ,CAAC,8wFAA8wF,EAAE,CAAC,6CAA6C,EAAE,4CAA4C,EAAE,sCAAsC,EAAE,uDAAuD,EAAE,gEAAgE,CAAC,CAAC,CAAC;AAE7hG;;;;;GAKG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAwYvC,aAAa,CAChB,WAAW,CAAC,iDAAiD,EAAE,CAAC,CAAC,CAAC"}

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

@@ -835,6 +835,184 @@ export type GetArtifactDownloadUrlResponse = Message<"ai.stigmer.agentic.agentex
  * Use `create(GetArtifactDownloadUrlResponseSchema)` to create a new message.
  */
 export declare const GetArtifactDownloadUrlResponseSchema: GenMessage<GetArtifactDownloadUrlResponse>;
+/**
+ * GetArtifactContentRequest reads the raw content of an execution artifact.
+ *
+ * Unlike getArtifactDownloadUrl (which returns a presigned URL for direct
+ * browser download), this endpoint returns the artifact bytes through the
+ * Stigmer API. This eliminates CORS concerns for SDK consumers who need to
+ * read artifact content programmatically — e.g., for YAML parsing, resource
+ * detection, or in-app preview rendering.
+ *
+ * ## Authorization
+ *
+ * Requires can_view permission on the execution. This ensures users can only
+ * read artifacts from executions they have access to.
+ *
+ * ## Security
+ *
+ * The storage_key is validated to ensure it belongs to the specified execution.
+ * Storage keys must start with "artifacts/{execution_id}/" to prevent path
+ * traversal attacks where a user could request content from other executions'
+ * artifacts.
+ *
+ * ## Size Limit
+ *
+ * The server enforces a maximum content size (default: 512 KB). If the
+ * artifact exceeds max_bytes, the response contains the first max_bytes of
+ * content with truncated=true. Callers can use total_size_bytes to decide
+ * whether to offer a full download via getArtifactDownloadUrl instead.
+ *
+ * ## Use Cases
+ *
+ * - Web UI reading YAML artifacts for Stigmer resource detection
+ * - SDK consumers rendering artifact previews in embedded components
+ * - CLI inspecting artifact content without a separate HTTP download
+ *
+ * ## Example
+ *
+ * Request:
+ * {
+ *   "execution_id": "aex_abc123xyz456",
+ *   "storage_key": "artifacts/aex_abc123xyz456/pr-review-agent.yaml"
+ * }
+ *
+ * Response:
+ * {
+ *   "content": <bytes>,
+ *   "content_type": "text/yaml",
+ *   "total_size_bytes": 1842,
+ *   "truncated": false
+ * }
+ *
+ * @since Artifact Lifecycle (Attachments & Artifacts)
+ *
+ * @generated from message ai.stigmer.agentic.agentexecution.v1.GetArtifactContentRequest
+ */
+export type GetArtifactContentRequest = Message<"ai.stigmer.agentic.agentexecution.v1.GetArtifactContentRequest"> & {
+    /**
+     * ID of the agent execution that produced the artifact.
+     *
+     * Used for authorization (can_view check) and storage_key validation.
+     *
+     * Format: "aex_{ulid}"
+     * Example: "aex_abc123xyz456"
+     *
+     * Validation: Required, minimum 1 character
+     *
+     * @generated from field: string execution_id = 1;
+     */
+    executionId: string;
+    /**
+     * Storage key of the artifact to read.
+     *
+     * Must be an artifact from the specified execution. The storage_key
+     * is validated to start with "artifacts/{execution_id}/" to prevent
+     * access to other executions' artifacts.
+     *
+     * Obtain this value from ExecutionArtifact.storage_key in the execution status.
+     *
+     * Format: "artifacts/{execution_id}/{filename}"
+     * Example: "artifacts/aex_abc123xyz456/pr-review-agent.yaml"
+     *
+     * Validation: Required, minimum 1 character
+     *
+     * @generated from field: string storage_key = 2;
+     */
+    storageKey: string;
+    /**
+     * Maximum number of bytes to return.
+     *
+     * If the artifact is larger than this limit, the response will contain
+     * the first max_bytes of content with truncated=true.
+     *
+     * When 0 or unset, the server applies a default limit (512 KB).
+     * The server may also enforce a hard upper bound regardless of this value.
+     *
+     * Example: 524288 (512 KB)
+     *
+     * @generated from field: int64 max_bytes = 3;
+     */
+    maxBytes: bigint;
+    /**
+     * For directory artifacts (ZIPs): extract a specific file by its
+     * path within the archive instead of returning the raw ZIP bytes.
+     *
+     * When empty, returns the full artifact content (existing behavior).
+     * When set for a FILE artifact, this field is ignored.
+     *
+     * The path must match an entry in the archive exactly (case-sensitive).
+     * Use the paths from ExecutionArtifact.entries to discover valid values.
+     *
+     * Example: "SKILL.md", "scripts/init_skill.py"
+     *
+     * @generated from field: string entry_path = 4;
+     */
+    entryPath: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.agentexecution.v1.GetArtifactContentRequest.
+ * Use `create(GetArtifactContentRequestSchema)` to create a new message.
+ */
+export declare const GetArtifactContentRequestSchema: GenMessage<GetArtifactContentRequest>;
+/**
+ * GetArtifactContentResponse returns the raw content of an execution artifact.
+ *
+ * The content field contains the artifact bytes (up to max_bytes). For text
+ * artifacts, clients decode via TextDecoder or equivalent. The content_type
+ * field provides a hint for rendering (detected by file extension).
+ *
+ * @since Artifact Lifecycle (Attachments & Artifacts)
+ *
+ * @generated from message ai.stigmer.agentic.agentexecution.v1.GetArtifactContentResponse
+ */
+export type GetArtifactContentResponse = Message<"ai.stigmer.agentic.agentexecution.v1.GetArtifactContentResponse"> & {
+    /**
+     * Raw artifact content (up to max_bytes).
+     *
+     * For text artifacts (YAML, JSON, Markdown, etc.), decode as UTF-8.
+     * For binary artifacts, this contains raw bytes — but callers should
+     * generally use getArtifactDownloadUrl for binary downloads instead.
+     *
+     * @generated from field: bytes content = 1;
+     */
+    content: Uint8Array;
+    /**
+     * Detected content type based on file extension.
+     *
+     * Examples: "text/yaml", "text/plain", "application/json",
+     * "application/zip" (for directory artifacts).
+     *
+     * This is a best-effort detection — not based on content inspection.
+     *
+     * @generated from field: string content_type = 2;
+     */
+    contentType: string;
+    /**
+     * Actual total size of the artifact in bytes.
+     *
+     * May be larger than len(content) when truncated=true.
+     * Callers can use this to show "showing 512 KB of 2.1 MB" messages
+     * or to decide whether to offer a full download link.
+     *
+     * @generated from field: int64 total_size_bytes = 3;
+     */
+    totalSizeBytes: bigint;
+    /**
+     * Whether the content was truncated to fit within max_bytes.
+     *
+     * When true, content contains only the first max_bytes of the artifact.
+     * The full artifact can be downloaded via getArtifactDownloadUrl.
+     *
+     * @generated from field: bool truncated = 4;
+     */
+    truncated: boolean;
+};
+/**
+ * Describes the message ai.stigmer.agentic.agentexecution.v1.GetArtifactContentResponse.
+ * Use `create(GetArtifactContentResponseSchema)` to create a new message.
+ */
+export declare const GetArtifactContentResponseSchema: GenMessage<GetArtifactContentResponse>;
 /**
  * GetSessionUsageReportInput requests a usage report for a single session.
  * Aggregates cost and token data across all executions in the session.