@stigmer/protos 0.0.69 → 0.0.71

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

@@ -7,13 +7,14 @@ export declare const SkillCommandController: {
     readonly typeName: "ai.stigmer.agentic.skill.v1.SkillCommandController";
     readonly methods: {
         /**
-         * Push (upload) a skill artifact.
-         * This operation creates a new skill if it doesn't exist, or creates a new version
-         * of an existing skill. The skill artifact must contain SKILL.md.
+         * Push a skill artifact.
+         * Creates a skill if it does not exist, or creates a new version of an
+         * existing skill. The artifact must contain a SKILL.md file.
          *
+         * @internal
          * Authorization:
          * - Organization-scoped skills: Caller must have can_create_skill permission in the organization
-         * - Platform-scoped skills: Caller must be a platform operator (handled automatically by common auth step)
+         * - Platform-scoped skills: Caller must be a platform operator
          *
          * The backend will:
          * 1. Normalize the name to a slug
@@ -24,8 +25,6 @@ export declare const SkillCommandController: {
          * 6. Update skill spec and status
          * 7. Archive the previous version (if updating)
          *
-         * Returns: The created or updated Skill resource (consistent with other CRUD operations)
-         *
          * @generated from rpc ai.stigmer.agentic.skill.v1.SkillCommandController.push
          */
         readonly push: {
@@ -35,18 +34,18 @@ export declare const SkillCommandController: {
             readonly kind: any;
         };
         /**
-         * Push a skill directly from an execution artifact already in storage.
-         *
-         * This is the server-side equivalent of push() — instead of receiving
-         * ZIP bytes from the client, it reads an existing directory artifact
-         * (produced by an agent execution) from artifact storage and pushes
-         * it as a skill. This avoids downloading the ZIP to the browser and
-         * re-uploading it, and eliminates CORS concerns for SDK consumers.
+         * Push a skill from an execution artifact already in storage.
+         * Use this when an agent execution has already produced a skill artifact
+         * and you want to publish it without downloading and re-uploading the ZIP.
          *
-         * The caller must have can_view on the referenced execution AND
-         * can_create_skill in the target organization.
+         * @internal
+         * Server-side equivalent of push() — reads the ZIP directly from artifact
+         * storage instead of receiving bytes from the client. This eliminates
+         * CORS concerns for SDK consumers.
          *
-         * Returns: The created or updated Skill resource
+         * Authorization:
+         * - Requires can_view on the referenced execution (to read the artifact)
+         * - Requires can_create_skill in the target organization (to push the skill)
          *
          * @generated from rpc ai.stigmer.agentic.skill.v1.SkillCommandController.pushFromExecutionArtifact
          */
@@ -58,12 +57,11 @@ export declare const SkillCommandController: {
         };
         /**
          * Update the visibility of an existing skill.
+         * Only modifies metadata.visibility, leaving spec, status, and other
+         * metadata fields untouched. Use this to make a skill publicly accessible
+         * or to revoke public access.
          *
-         * This is a targeted metadata update — it only modifies metadata.visibility,
-         * leaving spec, status, and other metadata fields untouched. Skills default
-         * to visibility_private on push; use this RPC to make a skill publicly
-         * accessible (marketplace-style sharing) or to revoke public access.
-         *
+         * @internal
          * Authorization: Requires can_edit permission on the skill resource.
          *
          * @generated from rpc ai.stigmer.agentic.skill.v1.SkillCommandController.updateVisibility
@@ -76,7 +74,9 @@ export declare const SkillCommandController: {
         };
         /**
          * Delete a skill and all its versions.
-         * This removes the skill from the main collection but preserves audit history.
+         *
+         * @internal
+         * Removes the skill from the main collection but preserves audit history.
          *
          * @generated from rpc ai.stigmer.agentic.skill.v1.SkillCommandController.delete
          */

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

@@ -12,13 +12,14 @@ export const SkillCommandController = {
     typeName: "ai.stigmer.agentic.skill.v1.SkillCommandController",
     methods: {
         /**
-         * Push (upload) a skill artifact.
-         * This operation creates a new skill if it doesn't exist, or creates a new version
-         * of an existing skill. The skill artifact must contain SKILL.md.
+         * Push a skill artifact.
+         * Creates a skill if it does not exist, or creates a new version of an
+         * existing skill. The artifact must contain a SKILL.md file.
          *
+         * @internal
          * Authorization:
          * - Organization-scoped skills: Caller must have can_create_skill permission in the organization
-         * - Platform-scoped skills: Caller must be a platform operator (handled automatically by common auth step)
+         * - Platform-scoped skills: Caller must be a platform operator
          *
          * The backend will:
          * 1. Normalize the name to a slug
@@ -29,8 +30,6 @@ export const SkillCommandController = {
          * 6. Update skill spec and status
          * 7. Archive the previous version (if updating)
          *
-         * Returns: The created or updated Skill resource (consistent with other CRUD operations)
-         *
          * @generated from rpc ai.stigmer.agentic.skill.v1.SkillCommandController.push
          */
         push: {
@@ -40,18 +39,18 @@ export const SkillCommandController = {
             kind: MethodKind.Unary,
         },
         /**
-         * Push a skill directly from an execution artifact already in storage.
-         *
-         * This is the server-side equivalent of push() — instead of receiving
-         * ZIP bytes from the client, it reads an existing directory artifact
-         * (produced by an agent execution) from artifact storage and pushes
-         * it as a skill. This avoids downloading the ZIP to the browser and
-         * re-uploading it, and eliminates CORS concerns for SDK consumers.
+         * Push a skill from an execution artifact already in storage.
+         * Use this when an agent execution has already produced a skill artifact
+         * and you want to publish it without downloading and re-uploading the ZIP.
          *
-         * The caller must have can_view on the referenced execution AND
-         * can_create_skill in the target organization.
+         * @internal
+         * Server-side equivalent of push() — reads the ZIP directly from artifact
+         * storage instead of receiving bytes from the client. This eliminates
+         * CORS concerns for SDK consumers.
          *
-         * Returns: The created or updated Skill resource
+         * Authorization:
+         * - Requires can_view on the referenced execution (to read the artifact)
+         * - Requires can_create_skill in the target organization (to push the skill)
          *
          * @generated from rpc ai.stigmer.agentic.skill.v1.SkillCommandController.pushFromExecutionArtifact
          */
@@ -63,12 +62,11 @@ export const SkillCommandController = {
         },
         /**
          * Update the visibility of an existing skill.
+         * Only modifies metadata.visibility, leaving spec, status, and other
+         * metadata fields untouched. Use this to make a skill publicly accessible
+         * or to revoke public access.
          *
-         * This is a targeted metadata update — it only modifies metadata.visibility,
-         * leaving spec, status, and other metadata fields untouched. Skills default
-         * to visibility_private on push; use this RPC to make a skill publicly
-         * accessible (marketplace-style sharing) or to revoke public access.
-         *
+         * @internal
          * Authorization: Requires can_edit permission on the skill resource.
          *
          * @generated from rpc ai.stigmer.agentic.skill.v1.SkillCommandController.updateVisibility
@@ -81,7 +79,9 @@ export const SkillCommandController = {
         },
         /**
          * Delete a skill and all its versions.
-         * This removes the skill from the main collection but preserves audit history.
+         *
+         * @internal
+         * Removes the skill from the main collection but preserves audit history.
          *
          * @generated from rpc ai.stigmer.agentic.skill.v1.SkillCommandController.delete
          */

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

@@ -1 +1 @@
-{"version":3,"file":"command_connect.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/skill/v1/command_connect.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,sHAAsH;AACtH,oBAAoB;AACpB,cAAc;AAId,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,QAAQ,EAAE,oDAAoD;IAC9D,OAAO,EAAE;QACP;;;;;;;;;;;;;;;;;;;;;WAqBG;QACH,IAAI,EAAE;YACJ,IAAI,EAAE,MAAM;YACZ,CAAC,EAAE,gBAAgB;YACnB,CAAC,EAAE,KAAK;YACR,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;;;;;;WAeG;QACH,yBAAyB,EAAE;YACzB,IAAI,EAAE,2BAA2B;YACjC,CAAC,EAAE,qCAAqC;YACxC,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;;;;;WAKG;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/skill/v1/command_connect.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,sHAAsH;AACtH,oBAAoB;AACpB,cAAc;AAId,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,QAAQ,EAAE,oDAAoD;IAC9D,OAAO,EAAE;QACP;;;;;;;;;;;;;;;;;;;;WAoBG;QACH,IAAI,EAAE;YACJ,IAAI,EAAE,MAAM;YACZ,CAAC,EAAE,gBAAgB;YACnB,CAAC,EAAE,KAAK;YACR,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;;;;;;WAeG;QACH,yBAAyB,EAAE;YACzB,IAAI,EAAE,2BAA2B;YACjC,CAAC,EAAE,qCAAqC;YACxC,CAAC,EAAE,KAAK;YACR,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;WAUG;QACH,gBAAgB,EAAE;YAChB,IAAI,EAAE,kBAAkB;YACxB,CAAC,EAAE,qBAAqB;YACxB,CAAC,EAAE,KAAK;YACR,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;WAOG;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/skill/v1/command_pb.d.ts

@@ -13,13 +13,14 @@ export declare const file_ai_stigmer_agentic_skill_v1_command: GenFile;
  */
 export declare const SkillCommandController: GenService<{
     /**
-     * Push (upload) a skill artifact.
-     * This operation creates a new skill if it doesn't exist, or creates a new version
-     * of an existing skill. The skill artifact must contain SKILL.md.
+     * Push a skill artifact.
+     * Creates a skill if it does not exist, or creates a new version of an
+     * existing skill. The artifact must contain a SKILL.md file.
      *
+     * @internal
      * Authorization:
      * - Organization-scoped skills: Caller must have can_create_skill permission in the organization
-     * - Platform-scoped skills: Caller must be a platform operator (handled automatically by common auth step)
+     * - Platform-scoped skills: Caller must be a platform operator
      *
      * The backend will:
      * 1. Normalize the name to a slug
@@ -30,8 +31,6 @@ export declare const SkillCommandController: GenService<{
      * 6. Update skill spec and status
      * 7. Archive the previous version (if updating)
      *
-     * Returns: The created or updated Skill resource (consistent with other CRUD operations)
-     *
      * @generated from rpc ai.stigmer.agentic.skill.v1.SkillCommandController.push
      */
     push: {
@@ -40,18 +39,18 @@ export declare const SkillCommandController: GenService<{
         output: typeof SkillSchema;
     };
     /**
-     * Push a skill directly from an execution artifact already in storage.
-     *
-     * This is the server-side equivalent of push() — instead of receiving
-     * ZIP bytes from the client, it reads an existing directory artifact
-     * (produced by an agent execution) from artifact storage and pushes
-     * it as a skill. This avoids downloading the ZIP to the browser and
-     * re-uploading it, and eliminates CORS concerns for SDK consumers.
+     * Push a skill from an execution artifact already in storage.
+     * Use this when an agent execution has already produced a skill artifact
+     * and you want to publish it without downloading and re-uploading the ZIP.
      *
-     * The caller must have can_view on the referenced execution AND
-     * can_create_skill in the target organization.
+     * @internal
+     * Server-side equivalent of push() — reads the ZIP directly from artifact
+     * storage instead of receiving bytes from the client. This eliminates
+     * CORS concerns for SDK consumers.
      *
-     * Returns: The created or updated Skill resource
+     * Authorization:
+     * - Requires can_view on the referenced execution (to read the artifact)
+     * - Requires can_create_skill in the target organization (to push the skill)
      *
      * @generated from rpc ai.stigmer.agentic.skill.v1.SkillCommandController.pushFromExecutionArtifact
      */
@@ -62,12 +61,11 @@ export declare const SkillCommandController: GenService<{
     };
     /**
      * Update the visibility of an existing skill.
+     * Only modifies metadata.visibility, leaving spec, status, and other
+     * metadata fields untouched. Use this to make a skill publicly accessible
+     * or to revoke public access.
      *
-     * This is a targeted metadata update — it only modifies metadata.visibility,
-     * leaving spec, status, and other metadata fields untouched. Skills default
-     * to visibility_private on push; use this RPC to make a skill publicly
-     * accessible (marketplace-style sharing) or to revoke public access.
-     *
+     * @internal
      * Authorization: Requires can_edit permission on the skill resource.
      *
      * @generated from rpc ai.stigmer.agentic.skill.v1.SkillCommandController.updateVisibility
@@ -79,7 +77,9 @@ export declare const SkillCommandController: GenService<{
     };
     /**
      * Delete a skill and all its versions.
-     * This removes the skill from the main collection but preserves audit history.
+     *
+     * @internal
+     * Removes the skill from the main collection but preserves audit history.
      *
      * @generated from rpc ai.stigmer.agentic.skill.v1.SkillCommandController.delete
      */

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

@@ -23,19 +23,19 @@ export type SkillId = Message<"ai.stigmer.agentic.skill.v1.SkillId"> & {
 export declare const SkillIdSchema: GenMessage<SkillId>;
 /**
  * PushSkillRequest contains the skill artifact and metadata for upload.
- * This operation creates a new skill if it doesn't exist, or creates a new version
- * of an existing skill.
+ * Creates a skill if it does not exist, or creates a new version of an
+ * existing skill.
  *
+ * @internal
  * The skill name and description are extracted by the backend from the SKILL.md
  * YAML frontmatter within the artifact. The CLI validates the format but does not
- * send these fields - backend is the single source of truth for parsing.
+ * send these fields — backend is the single source of truth for parsing.
  *
  * @generated from message ai.stigmer.agentic.skill.v1.PushSkillRequest
  */
 export type PushSkillRequest = Message<"ai.stigmer.agentic.skill.v1.PushSkillRequest"> & {
     /**
-     * Organization that owns this skill. Required.
-     * All skills belong to exactly one organization.
+     * Organization that owns this skill.
      *
      * @generated from field: string org = 1;
      */
@@ -62,12 +62,14 @@ export type PushSkillRequest = Message<"ai.stigmer.agentic.skill.v1.PushSkillReq
      */
     tag: string;
     /**
-     * Git provenance for this skill version. Optional.
+     * Git provenance for this skill version.
+     * Absent when pushed from a non-git directory.
+     *
+     * @internal
      * Populated by CLI during push:
      * - For local pushes: auto-detected if directory is within a git repository
      * - For git pushes: resolved from user-provided URL/ref
-     * Absent when pushed from a non-git directory.
-     * This is stored in SkillStatus.git_provenance for traceability.
+     * Stored in SkillStatus.git_provenance for traceability.
      *
      * @generated from field: ai.stigmer.agentic.skill.v1.GitProvenance git_provenance = 4;
      */
@@ -79,25 +81,20 @@ export type PushSkillRequest = Message<"ai.stigmer.agentic.skill.v1.PushSkillReq
  */
 export declare const PushSkillRequestSchema: GenMessage<PushSkillRequest>;
 /**
- * PushSkillFromExecutionArtifactRequest pushes a skill from an execution
- * artifact that is already stored in artifact storage.
+ * PushSkillFromExecutionArtifactRequest publishes a skill from an execution
+ * artifact already in storage, without downloading and re-uploading the ZIP.
  *
- * This enables a server-side push flow where the ZIP artifact produced by
- * an agent execution (e.g., skill-creator) is pushed as a skill without
- * downloading it to the client first. The server reads the ZIP directly
- * from artifact storage and delegates to the standard push logic.
+ * @internal
+ * Server-side push flow: reads the ZIP directly from artifact storage and
+ * delegates to the standard push logic.
  *
- * ## Authorization
- *
- * Requires both:
- * - can_view on the agent execution (to read the artifact)
- * - can_create_skill in the target organization (to push the skill)
- *
- * ## Security
+ * Authorization:
+ * - Requires can_view on the agent execution (to read the artifact)
+ * - Requires can_create_skill in the target organization (to push the skill)
  *
+ * Security:
  * The storage_key is validated to start with "artifacts/{execution_id}/"
- * to prevent access to other executions' artifacts (same validation as
- * getArtifactContent).
+ * to prevent access to other executions' artifacts.
  *
  * @generated from message ai.stigmer.agentic.skill.v1.PushSkillFromExecutionArtifactRequest
  */
@@ -109,24 +106,22 @@ export type PushSkillFromExecutionArtifactRequest = Message<"ai.stigmer.agentic.
      */
     org: string;
     /**
-     * ID of the agent execution that produced the artifact.
-     * Used for authorization (can_view check) and storage_key validation.
+     * ID of the agent execution that produced the artifact (e.g., "aex_abc123xyz456").
      *
-     * Format: "aex_{ulid}"
-     * Example: "aex_abc123xyz456"
+     * @internal
+     * Used for authorization (can_view check) and storage_key validation.
+     * Format: "aex_{ulid}".
      *
      * @generated from field: string execution_id = 2;
      */
     executionId: string;
     /**
      * Storage key of the directory artifact (ZIP) to push as a skill.
-     * Must start with "artifacts/{execution_id}/" for security.
-     *
-     * Obtain this value from ExecutionArtifact.storage_key in the
-     * execution status for a DIRECTORY artifact.
+     * Obtain this from ExecutionArtifact.storage_key in the execution status.
      *
-     * Format: "artifacts/{execution_id}/{filename}.zip"
-     * Example: "artifacts/aex_abc123xyz456/my-skill.zip"
+     * @internal
+     * Must start with "artifacts/{execution_id}/" for security.
+     * Format: "artifacts/{execution_id}/{filename}.zip".
      *
      * @generated from field: string storage_key = 3;
      */
@@ -152,7 +147,9 @@ export declare const PushSkillFromExecutionArtifactRequestSchema: GenMessage<Pus
 export type GetArtifactRequest = Message<"ai.stigmer.agentic.skill.v1.GetArtifactRequest"> & {
     /**
      * The artifact storage key from skill.status.artifact_storage_key.
-     * This key identifies the location of the ZIP file in storage (R2/S3).
+     *
+     * @internal
+     * Identifies the location of the ZIP file in storage (R2/S3).
      *
      * @generated from field: string artifact_storage_key = 1;
      */

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

@@ -1 +1 @@
-{"version":3,"file":"io_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/skill/v1/io_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,iHAAiH;AACjH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,uCAAuC,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAGrF;;GAEG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAY,aAAa,CACvE,QAAQ,CAAC,6uBAA6uB,EAAE,CAAC,uCAAuC,EAAE,0BAA0B,CAAC,CAAC,CAAC;AAcj0B;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAwB,aAAa,CAC7D,WAAW,CAAC,mCAAmC,EAAE,CAAC,CAAC,CAAC;AA0DtD;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAiC,aAAa,CAC/E,WAAW,CAAC,mCAAmC,EAAE,CAAC,CAAC,CAAC;AAmEtD;;;GAGG;AACH,MAAM,CAAC,MAAM,2CAA2C,GAAsD,aAAa,CACzH,WAAW,CAAC,mCAAmC,EAAE,CAAC,CAAC,CAAC;AAiBtD;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAmC,aAAa,CACnF,WAAW,CAAC,mCAAmC,EAAE,CAAC,CAAC,CAAC;AAiBtD;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAoC,aAAa,CACrF,WAAW,CAAC,mCAAmC,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"io_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/skill/v1/io_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,iHAAiH;AACjH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,uCAAuC,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAGrF;;GAEG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAY,aAAa,CACvE,QAAQ,CAAC,6uBAA6uB,EAAE,CAAC,uCAAuC,EAAE,0BAA0B,CAAC,CAAC,CAAC;AAcj0B;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAwB,aAAa,CAC7D,WAAW,CAAC,mCAAmC,EAAE,CAAC,CAAC,CAAC;AA4DtD;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAiC,aAAa,CAC/E,WAAW,CAAC,mCAAmC,EAAE,CAAC,CAAC,CAAC;AA4DtD;;;GAGG;AACH,MAAM,CAAC,MAAM,2CAA2C,GAAsD,aAAa,CACzH,WAAW,CAAC,mCAAmC,EAAE,CAAC,CAAC,CAAC;AAmBtD;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAmC,aAAa,CACnF,WAAW,CAAC,mCAAmC,EAAE,CAAC,CAAC,CAAC;AAiBtD;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAoC,aAAa,CACrF,WAAW,CAAC,mCAAmC,EAAE,CAAC,CAAC,CAAC"}

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

@@ -21,10 +21,11 @@ export declare const SkillQueryController: {
          * Get a skill by API resource reference with version support.
          *
          * Version resolution (via ApiResourceReference.version field):
-         * - Empty/"latest" → Returns current version from main collection
-         * - Tag name (e.g., "stable", "v1.0") → Resolves to version with this tag
-         * - SHA256 hash (64 hex chars) → Returns exact immutable version
+         * - Empty/"latest" → Returns the current version
+         * - Tag name (e.g., "stable", "v1.0") → Resolves to the version with this tag
+         * - SHA256 hash (64 hex chars) → Returns the exact immutable version
          *
+         * @internal
          * Authorization is handled in the handler after resolving the reference to a skill ID.
          * (Input doesn't contain skill ID, so proto-level auth cannot work)
          *
@@ -40,10 +41,10 @@ export declare const SkillQueryController: {
          * Download skill artifact from storage by its storage key.
          * Returns the ZIP file containing SKILL.md and implementation files.
          *
-         * This endpoint is used by the agent-runner to download and extract
-         * skill artifacts into the sandbox at /bin/skills/{version_hash}/.
-         *
-         * Authorization is skipped as the storage key itself acts as a capability token.
+         * @internal
+         * Used by the agent-runner to download and extract skill artifacts into the
+         * sandbox at /bin/skills/{version_hash}/. Authorization is skipped as the
+         * storage key itself acts as a capability token.
          *
          * @generated from rpc ai.stigmer.agentic.skill.v1.SkillQueryController.getArtifact
          */

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

@@ -26,10 +26,11 @@ export const SkillQueryController = {
          * Get a skill by API resource reference with version support.
          *
          * Version resolution (via ApiResourceReference.version field):
-         * - Empty/"latest" → Returns current version from main collection
-         * - Tag name (e.g., "stable", "v1.0") → Resolves to version with this tag
-         * - SHA256 hash (64 hex chars) → Returns exact immutable version
+         * - Empty/"latest" → Returns the current version
+         * - Tag name (e.g., "stable", "v1.0") → Resolves to the version with this tag
+         * - SHA256 hash (64 hex chars) → Returns the exact immutable version
          *
+         * @internal
          * Authorization is handled in the handler after resolving the reference to a skill ID.
          * (Input doesn't contain skill ID, so proto-level auth cannot work)
          *
@@ -45,10 +46,10 @@ export const SkillQueryController = {
          * Download skill artifact from storage by its storage key.
          * Returns the ZIP file containing SKILL.md and implementation files.
          *
-         * This endpoint is used by the agent-runner to download and extract
-         * skill artifacts into the sandbox at /bin/skills/{version_hash}/.
-         *
-         * Authorization is skipped as the storage key itself acts as a capability token.
+         * @internal
+         * Used by the agent-runner to download and extract skill artifacts into the
+         * sandbox at /bin/skills/{version_hash}/. Authorization is skipped as the
+         * storage key itself acts as a capability token.
          *
          * @generated from rpc ai.stigmer.agentic.skill.v1.SkillQueryController.getArtifact
          */

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

@@ -1 +1 @@
-{"version":3,"file":"query_connect.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/skill/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;;;;;;;;;;;;WAYG;QACH,cAAc,EAAE;YACd,IAAI,EAAE,gBAAgB;YACtB,CAAC,EAAE,oBAAoB;YACvB,CAAC,EAAE,KAAK;YACR,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;WAUG;QACH,WAAW,EAAE;YACX,IAAI,EAAE,aAAa;YACnB,CAAC,EAAE,kBAAkB;YACrB,CAAC,EAAE,mBAAmB;YACtB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;KACF;CACO,CAAC"}
+{"version":3,"file":"query_connect.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/skill/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;;;;;;;;;;;;;WAaG;QACH,cAAc,EAAE;YACd,IAAI,EAAE,gBAAgB;YACtB,CAAC,EAAE,oBAAoB;YACvB,CAAC,EAAE,KAAK;YACR,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;WAUG;QACH,WAAW,EAAE;YACX,IAAI,EAAE,aAAa;YACnB,CAAC,EAAE,kBAAkB;YACrB,CAAC,EAAE,mBAAmB;YACtB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;KACF;CACO,CAAC"}

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

@@ -26,10 +26,11 @@ export declare const SkillQueryController: GenService<{
      * Get a skill by API resource reference with version support.
      *
      * Version resolution (via ApiResourceReference.version field):
-     * - Empty/"latest" → Returns current version from main collection
-     * - Tag name (e.g., "stable", "v1.0") → Resolves to version with this tag
-     * - SHA256 hash (64 hex chars) → Returns exact immutable version
+     * - Empty/"latest" → Returns the current version
+     * - Tag name (e.g., "stable", "v1.0") → Resolves to the version with this tag
+     * - SHA256 hash (64 hex chars) → Returns the exact immutable version
      *
+     * @internal
      * Authorization is handled in the handler after resolving the reference to a skill ID.
      * (Input doesn't contain skill ID, so proto-level auth cannot work)
      *
@@ -44,10 +45,10 @@ export declare const SkillQueryController: GenService<{
      * Download skill artifact from storage by its storage key.
      * Returns the ZIP file containing SKILL.md and implementation files.
      *
-     * This endpoint is used by the agent-runner to download and extract
-     * skill artifacts into the sandbox at /bin/skills/{version_hash}/.
-     *
-     * Authorization is skipped as the storage key itself acts as a capability token.
+     * @internal
+     * Used by the agent-runner to download and extract skill artifacts into the
+     * sandbox at /bin/skills/{version_hash}/. Authorization is skipped as the
+     * storage key itself acts as a capability token.
      *
      * @generated from rpc ai.stigmer.agentic.skill.v1.SkillQueryController.getArtifact
      */

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

@@ -1 +1 @@
-{"version":3,"file":"query_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/skill/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,knBAAknB,EAAE,CAAC,oCAAoC,EAAE,mCAAmC,EAAE,sCAAsC,EAAE,uDAAuD,EAAE,gEAAgE,CAAC,CAAC,CAAC;AAE/2B;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GA6C5B,aAAa,CAChB,WAAW,CAAC,sCAAsC,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"query_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/skill/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,knBAAknB,EAAE,CAAC,oCAAoC,EAAE,mCAAmC,EAAE,sCAAsC,EAAE,uDAAuD,EAAE,gEAAgE,CAAC,CAAC,CAAC;AAE/2B;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GA8C5B,aAAa,CAChB,WAAW,CAAC,sCAAsC,EAAE,CAAC,CAAC,CAAC"}

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

@@ -5,11 +5,12 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_ai_stigmer_agentic_skill_v1_spec: GenFile;
 /**
- * SkillSpec defines the stored desired state of a skill.
- * All fields are extracted from the skill artifact by the backend.
- * This follows the Kubernetes spec pattern - contains user's desired state.
+ * SkillSpec defines the desired state of a skill.
  *
- * Note: Source/provenance information is NOT stored here - it's in SkillStatus
+ * @internal
+ * All fields are extracted from the skill artifact by the backend.
+ * This follows the Kubernetes spec pattern — contains user's desired state.
+ * Source/provenance information is NOT stored here — it's in SkillStatus
  * as GitProvenance (observed state). See synth.proto for SDK input structure.
  *
  * @generated from message ai.stigmer.agentic.skill.v1.SkillSpec

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

@@ -1 +1 @@
-{"version":3,"file":"spec_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/skill/v1/spec_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,mHAAmH;AACnH,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,qCAAqC,GAAY,aAAa,CACzE,QAAQ,CAAC,0TAA0T,EAAE,CAAC,0BAA0B,CAAC,CAAC,CAAC;AAsDrW;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAA0B,aAAa,CACjE,WAAW,CAAC,qCAAqC,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"spec_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/skill/v1/spec_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,mHAAmH;AACnH,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,qCAAqC,GAAY,aAAa,CACzE,QAAQ,CAAC,0TAA0T,EAAE,CAAC,0BAA0B,CAAC,CAAC,CAAC;AAuDrW;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAA0B,aAAa,CACjE,WAAW,CAAC,qCAAqC,EAAE,CAAC,CAAC,CAAC"}

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

@@ -7,32 +7,36 @@ import type { Message } from "@bufbuild/protobuf";
 export declare const file_ai_stigmer_agentic_skill_v1_status: GenFile;
 /**
  * SkillStatus represents the system-managed state of a skill.
- * This represents observed state managed by the system.
  *
  * @generated from message ai.stigmer.agentic.skill.v1.SkillStatus
  */
 export type SkillStatus = Message<"ai.stigmer.agentic.skill.v1.SkillStatus"> & {
     /**
      * Standard audit information tracking creation and modification.
+     *
+     * @internal
      * Field 99 follows Stigmer convention for audit placement.
      *
      * @generated from field: ai.stigmer.commons.apiresource.ApiResourceAudit audit = 99;
      */
     audit?: ApiResourceAudit;
     /**
-     * SHA256 hash of the skill artifact Zip file.
-     * This is the content fingerprint and serves as the immutable version identifier.
-     * Calculated by the system from the uploaded artifact.
+     * SHA256 hash of the skill artifact, used as the immutable version identifier.
+     *
+     * @internal
+     * Calculated by the system from the uploaded artifact ZIP.
      *
      * @generated from field: string version_hash = 1;
      */
     versionHash: string;
     /**
-     * Storage location key for the skill artifact.
+     * Storage key for the skill artifact.
+     *
+     * @internal
      * Format varies based on storage backend:
      * - Local: "<hash>.zip"
      * - Cloud: "skills/<slug>_<hash>.zip"
-     * This is determined by the system based on storage configuration.
+     * Determined by the system based on storage configuration.
      *
      * @generated from field: string artifact_storage_key = 2;
      */
@@ -45,10 +49,12 @@ export type SkillStatus = Message<"ai.stigmer.agentic.skill.v1.SkillStatus"> & {
     state: SkillState;
     /**
      * Git provenance tracking where the skill artifacts originated from.
-     * Populated by CLI during push, provides traceability and enables
-     * "view on GitHub" links and reproducible deployments.
      * Absent when pushed from a non-git directory.
      *
+     * @internal
+     * Populated by CLI during push; provides traceability and enables
+     * "view on GitHub" links and reproducible deployments.
+     *
      * @generated from field: ai.stigmer.agentic.skill.v1.GitProvenance git_provenance = 4;
      */
     gitProvenance?: GitProvenance;
@@ -60,7 +66,9 @@ export type SkillStatus = Message<"ai.stigmer.agentic.skill.v1.SkillStatus"> & {
 export declare const SkillStatusSchema: GenMessage<SkillStatus>;
 /**
  * GitProvenance tracks the git origin of skill artifacts.
- * This is system-detected metadata, not user-specified configuration.
+ *
+ * @internal
+ * System-detected metadata, not user-specified configuration.
  * Populated by CLI during push based on:
  * - Local push: auto-detected from directory's git context
  * - Git push: resolved from user-provided URL/ref
@@ -69,28 +77,31 @@ export declare const SkillStatusSchema: GenMessage<SkillStatus>;
  */
 export type GitProvenance = Message<"ai.stigmer.agentic.skill.v1.GitProvenance"> & {
     /**
-     * Git remote URL.
-     * For local push: detected "origin" remote URL
-     * For git push: the user-provided repository URL
-     * Example: "https://github.com/stigmer/skills.git"
+     * Git remote URL (e.g., "https://github.com/stigmer/skills.git").
+     *
+     * @internal
+     * For local push: detected "origin" remote URL.
+     * For git push: the user-provided repository URL.
      *
      * @generated from field: string remote_url = 1;
      */
     remoteUrl: string;
     /**
-     * Original git reference (for display purposes).
-     * For local push: detected branch name (e.g., "main") or empty if detached HEAD
-     * For git push: the user-provided ref (e.g., "v1.0.0", "main")
-     * This preserves user intent for display while commit provides immutability.
+     * Original git reference such as a branch or tag name (e.g., "main", "v1.0.0").
+     *
+     * @internal
+     * For local push: detected branch name or empty if detached HEAD.
+     * For git push: the user-provided ref.
+     * Preserves user intent for display while commit provides immutability.
      *
      * @generated from field: string ref = 2;
      */
     ref: string;
     /**
-     * Resolved commit SHA (for reproducibility).
-     * Always populated - this is the immutable version reference.
-     * Full 40-character SHA ensures exact reproducibility.
-     * Example: "abc123def456789012345678901234567890abcd"
+     * Resolved commit SHA for exact reproducibility.
+     *
+     * @internal
+     * Always populated. Full 40-character SHA.
      *
      * @generated from field: string commit = 3;
      */

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

@@ -1 +1 @@
-{"version":3,"file":"status_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/skill/v1/status_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,qHAAqH;AACrH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE/E,OAAO,EAAE,0CAA0C,EAAE,MAAM,wCAAwC,CAAC;AACpG,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAGrF;;GAEG;AACH,MAAM,CAAC,MAAM,uCAAuC,GAAY,aAAa,CAC3E,QAAQ,CAAC,kwBAAkwB,EAAE,CAAC,0CAA0C,EAAE,0BAA0B,CAAC,CAAC,CAAC;AAuDz1B;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA4B,aAAa,CACrE,WAAW,CAAC,uCAAuC,EAAE,CAAC,CAAC,CAAC;AAoD1D;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA8B,aAAa,CACzE,WAAW,CAAC,uCAAuC,EAAE,CAAC,CAAC,CAAC;AAE1D;;;;GAIG;AACH,MAAM,CAAN,IAAY,UA4BX;AA5BD,WAAY,UAAU;IACpB;;;;OAIG;IACH,yDAAe,CAAA;IAEf;;;;OAIG;IACH,qDAAa,CAAA;IAEb;;;;OAIG;IACH,6CAAS,CAAA;IAET;;;;OAIG;IACH,+CAAU,CAAA;AACZ,CAAC,EA5BW,UAAU,KAAV,UAAU,QA4BrB;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAwB,aAAa,CAChE,QAAQ,CAAC,uCAAuC,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"status_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/skill/v1/status_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,qHAAqH;AACrH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE/E,OAAO,EAAE,0CAA0C,EAAE,MAAM,wCAAwC,CAAC;AACpG,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAGrF;;GAEG;AACH,MAAM,CAAC,MAAM,uCAAuC,GAAY,aAAa,CAC3E,QAAQ,CAAC,kwBAAkwB,EAAE,CAAC,0CAA0C,EAAE,0BAA0B,CAAC,CAAC,CAAC;AA6Dz1B;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA4B,aAAa,CACrE,WAAW,CAAC,uCAAuC,EAAE,CAAC,CAAC,CAAC;AAyD1D;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA8B,aAAa,CACzE,WAAW,CAAC,uCAAuC,EAAE,CAAC,CAAC,CAAC;AAE1D;;;;GAIG;AACH,MAAM,CAAN,IAAY,UA4BX;AA5BD,WAAY,UAAU;IACpB;;;;OAIG;IACH,yDAAe,CAAA;IAEf;;;;OAIG;IACH,qDAAa,CAAA;IAEb;;;;OAIG;IACH,6CAAS,CAAA;IAET;;;;OAIG;IACH,+CAAU,CAAA;AACZ,CAAC,EA5BW,UAAU,KAAV,UAAU,QA4BrB;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAwB,aAAa,CAChE,QAAQ,CAAC,uCAAuC,EAAE,CAAC,CAAC,CAAC"}