@stigmer/protos 3.12.2 → 3.12.4

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

@@ -11,21 +11,12 @@ export declare const file_ai_stigmer_agentic_session_v1_spec: GenFile;
 /**
  * SessionSpec defines the configurable properties of a session.
  *
- * @internal
- * This is the "Execution" layer — ephemeral runtime against an AgentInstance.
- * The overview.md file provides the SDK-facing description and example YAML.
- *
  * @generated from message ai.stigmer.agentic.session.v1.SessionSpec
  */
 export type SessionSpec = Message<"ai.stigmer.agentic.session.v1.SessionSpec"> & {
     /**
      * Agent instance this session runs against.
      *
-     * @internal
-     * When empty, the backend resolves the platform default agent
-     * (labeled stigmer.ai/default-agent: "true" with visibility_public)
-     * and auto-creates a default instance if needed.
-     *
      * @generated from field: string agent_instance_id = 1;
      */
     agentInstanceId: string;
@@ -49,11 +40,6 @@ export type SessionSpec = Message<"ai.stigmer.agentic.session.v1.SessionSpec"> &
      *   returned by Agent.create(). Used for Agent.resume() on
      *   subsequent executions.
      *
-     * @internal
-     * Also serves as the immutability sentinel: when non-empty, the
-     * session's harness and cursor_mode cannot be changed — each harness
-     * owns its conversation state independently.
-     *
      * @generated from field: string harness_state_id = 3;
      */
     harnessStateId: string;
@@ -64,14 +50,6 @@ export type SessionSpec = Message<"ai.stigmer.agentic.session.v1.SessionSpec"> &
      * cursor-runner's resume fails, it creates a fresh Cursor agent and
      * replaces harness_state_id, and the replaced id lands here.
      *
-     * @internal
-     * Server-owned, append-only. The update handler computes the append from
-     * the observed harness_state_id transition — client-supplied values for
-     * this field are discarded, so a stale client resending an old spec can
-     * never clobber the history. Billing reconciliation joins Cursor ledger
-     * events on the union of current + prior ids; dropping a replaced id
-     * would orphan the ledger events of every turn that ran under it.
-     *
      * @generated from field: repeated string harness_state_id_history = 13;
      */
     harnessStateIdHistory: string[];
@@ -102,13 +80,6 @@ export type SessionSpec = Message<"ai.stigmer.agentic.session.v1.SessionSpec"> &
      * modifying the agent blueprint. Each usage references an McpServer
      * resource.
      *
-     * @internal
-     * Merge semantics: session-level usages are union'd with agent-level usages.
-     * If both reference the same MCP server slug, the session-level entry takes
-     * precedence (enables per-session tool restriction or expansion). The agent
-     * runner merges these with the agent's mcp_server_usages when constructing
-     * the execution graph.
-     *
      * @generated from field: repeated ai.stigmer.agentic.agent.v1.McpServerUsage mcp_server_usages = 7;
      */
     mcpServerUsages: McpServerUsage[];
@@ -119,9 +90,6 @@ export type SessionSpec = Message<"ai.stigmer.agentic.session.v1.SessionSpec"> &
      * modifying the agent blueprint. Each reference points to a Skill resource
      * whose content is added to the agent's context alongside agent-level skills.
      *
-     * @internal
-     * Merge semantics: union'd with agent-level skill_refs, deduplicated by slug.
-     *
      * @generated from field: repeated ai.stigmer.commons.apiresource.ApiResourceReference skill_refs = 8;
      */
     skillRefs: ApiResourceReference[];
@@ -154,16 +122,6 @@ export type SessionSpec = Message<"ai.stigmer.agentic.session.v1.SessionSpec"> &
      * Only meaningful when harness == HARNESS_CURSOR. Ignored for other
      * harness types.
      *
-     * @internal
-     * Runner-owned, never user-set (see the CursorMode enum docs): the
-     * cursor-runner stamps it on the first execution when UNSPECIFIED —
-     * always LOCAL while cloud mode is disabled platform-wide. The
-     * workflow reads it back on subsequent executions to route to the
-     * correct Agent.create / Agent.resume path.
-     *
-     * When UNSPECIFIED on an existing CURSOR session, the runner defaults
-     * to LOCAL for backward compatibility.
-     *
      * @generated from field: ai.stigmer.agentic.session.v1.CursorMode cursor_mode = 11;
      */
     cursorMode: CursorMode;

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

@@ -1 +1 @@
-{"version":3,"file":"spec_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/session/v1/spec_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,uHAAuH;AACvH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,qCAAqC,EAAE,MAAM,2BAA2B,CAAC;AAElF,OAAO,EAAE,uCAAuC,EAAE,MAAM,cAAc,CAAC;AAEvE,OAAO,EAAE,4CAA4C,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,iDAAiD,EAAE,MAAM,kDAAkD,CAAC;AAErH,OAAO,EAAE,sCAAsC,EAAE,MAAM,uCAAuC,CAAC;AAC/F,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AAGxF;;GAEG;AACH,MAAM,CAAC,MAAM,uCAAuC,GAAY,aAAa,CAC3E,QAAQ,CAAC,0zCAA0zC,EAAE,CAAC,qCAAqC,EAAE,uCAAuC,EAAE,4CAA4C,EAAE,iDAAiD,EAAE,sCAAsC,EAAE,0BAA0B,CAAC,CAAC,CAAC;AA6L9jD;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA4B,aAAa,CACrE,WAAW,CAAC,uCAAuC,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"spec_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/session/v1/spec_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,uHAAuH;AACvH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,qCAAqC,EAAE,MAAM,2BAA2B,CAAC;AAElF,OAAO,EAAE,uCAAuC,EAAE,MAAM,cAAc,CAAC;AAEvE,OAAO,EAAE,4CAA4C,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,iDAAiD,EAAE,MAAM,kDAAkD,CAAC;AAErH,OAAO,EAAE,sCAAsC,EAAE,MAAM,uCAAuC,CAAC;AAC/F,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AAGxF;;GAEG;AACH,MAAM,CAAC,MAAM,uCAAuC,GAAY,aAAa,CAC3E,QAAQ,CAAC,0zCAA0zC,EAAE,CAAC,qCAAqC,EAAE,uCAAuC,EAAE,4CAA4C,EAAE,iDAAiD,EAAE,sCAAsC,EAAE,0BAA0B,CAAC,CAAC,CAAC;AAmJ9jD;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA4B,aAAa,CACrE,WAAW,CAAC,uCAAuC,EAAE,CAAC,CAAC,CAAC"}

package/ai/stigmer/agentic/session/v1/workspace_pb.d.ts

@@ -8,11 +8,6 @@ export declare const file_ai_stigmer_agentic_session_v1_workspace: GenFile;
 /**
  * WorkspaceSource defines where the workspace content comes from.
  *
- * @internal
- * Pure source-definition type: describes the origin of workspace content
- * without any identity or naming. Use WorkspaceEntry to pair a source with
- * a name for session-level usage.
- *
  * @generated from message ai.stigmer.agentic.session.v1.WorkspaceSource
  */
 export type WorkspaceSource = Message<"ai.stigmer.agentic.session.v1.WorkspaceSource"> & {
@@ -52,12 +47,6 @@ export declare const WorkspaceSourceSchema: GenMessage<WorkspaceSource>;
  * operate on. The name serves as the entry's identity and must be unique
  * within a session's workspace_entries list.
  *
- * @internal
- * In a multi-root workspace (VS Code model), the name appears in the system
- * prompt and in cloud mode it becomes the subdirectory name under the
- * workspace root. Names are auto-derived by the CLI from the repository
- * name (last URL path segment sans ".git") or the directory basename.
- *
  * @generated from message ai.stigmer.agentic.session.v1.WorkspaceEntry
  */
 export type WorkspaceEntry = Message<"ai.stigmer.agentic.session.v1.WorkspaceEntry"> & {
@@ -85,11 +74,6 @@ export declare const WorkspaceEntrySchema: GenMessage<WorkspaceEntry>;
  * The agent operates directly on the user's files — changes are immediate
  * and persistent. No copy or clone is made.
  *
- * @internal
- * Deployment constraint: only valid when the runner is in local mode.
- * Cloud runners reject this at provisioning time with a clear error, the same
- * way GitRepoSource rejects SSH URLs at validation time.
- *
  * @generated from message ai.stigmer.agentic.session.v1.LocalPathSource
  */
 export type LocalPathSource = Message<"ai.stigmer.agentic.session.v1.LocalPathSource"> & {
@@ -110,16 +94,6 @@ export declare const LocalPathSourceSchema: GenMessage<LocalPathSource>;
  *
  * Only HTTPS clone URLs are supported. SSH URLs are rejected at validation time.
  *
- * @internal
- * Authentication: The provisioner resolves GITHUB_TOKEN from the merged
- * environment (instance environment_refs < ExecutionContext.runtime_env). As a
- * workspace-provisioning key it is re-injected past the Agent.spec.env
- * declared-key filter when the session has git_repo entries, with a fallback
- * to the caller's personal environment (see the agentexecution controller's
- * executionContextBuilder). The token is injected into the clone URL, consumed
- * by provisioning, and stripped before forwarding to the agent runtime (see
- * AD-05). SSH key authentication is a future enhancement.
- *
  * @generated from message ai.stigmer.agentic.session.v1.GitRepoSource
  */
 export type GitRepoSource = Message<"ai.stigmer.agentic.session.v1.GitRepoSource"> & {
@@ -153,29 +127,12 @@ export type GitRepoSource = Message<"ai.stigmer.agentic.session.v1.GitRepoSource
      * When not set, defaults to a shallow clone with depth 1. Set to 0 for
      * a full clone with complete history.
      *
-     * @internal
-     * Uses proto3 optional to distinguish "not set" from "set to 0."
-     * Absent: shallow clone depth 1; 0: full clone; N > 0: shallow clone depth N.
-     *
      * @generated from field: optional int32 depth = 4;
      */
     depth?: number;
     /**
      * Controls whether the platform creates a branch and pull request from the agent's file changes.
      *
-     * @internal
-     * This is a platform-level workflow, not an agent-level decision. The
-     * agent focuses on making code changes; the platform packages them
-     * incrementally — the PR appears the moment the first file is written
-     * and the diff grows in real time as the agent works.
-     *
-     * Requires GITHUB_TOKEN in the execution environment. If credentials
-     * are not available, the write-back is silently skipped regardless of
-     * this setting.
-     *
-     * Default (UNSPECIFIED): platform decides. Currently defaults to
-     * write-back enabled when git credentials are available.
-     *
      * @generated from field: ai.stigmer.agentic.session.v1.GitWriteBackMode write_back_mode = 5;
      */
     writeBackMode: GitWriteBackMode;

package/ai/stigmer/agentic/session/v1/workspace_pb.js.map

@@ -1 +1 @@
-{"version":3,"file":"workspace_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/session/v1/workspace_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,4HAA4H;AAC5H,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,uCAAuC,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AAGxF;;GAEG;AACH,MAAM,CAAC,MAAM,4CAA4C,GAAY,aAAa,CAChF,QAAQ,CAAC,o+BAAo+B,EAAE,CAAC,uCAAuC,EAAE,0BAA0B,CAAC,CAAC,CAAC;AAmCxjC;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAgC,aAAa,CAC7E,WAAW,CAAC,4CAA4C,EAAE,CAAC,CAAC,CAAC;AAiC/D;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA+B,aAAa,CAC3E,WAAW,CAAC,4CAA4C,EAAE,CAAC,CAAC,CAAC;AAwB/D;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAgC,aAAa,CAC7E,WAAW,CAAC,4CAA4C,EAAE,CAAC,CAAC,CAAC;AAkF/D;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA8B,aAAa,CACzE,WAAW,CAAC,4CAA4C,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"workspace_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/session/v1/workspace_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,4HAA4H;AAC5H,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,uCAAuC,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AAGxF;;GAEG;AACH,MAAM,CAAC,MAAM,4CAA4C,GAAY,aAAa,CAChF,QAAQ,CAAC,o+BAAo+B,EAAE,CAAC,uCAAuC,EAAE,0BAA0B,CAAC,CAAC,CAAC;AA8BxjC;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAgC,aAAa,CAC7E,WAAW,CAAC,4CAA4C,EAAE,CAAC,CAAC,CAAC;AA2B/D;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA+B,aAAa,CAC3E,WAAW,CAAC,4CAA4C,EAAE,CAAC,CAAC,CAAC;AAmB/D;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAgC,aAAa,CAC7E,WAAW,CAAC,4CAA4C,EAAE,CAAC,CAAC,CAAC;AAuD/D;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA8B,aAAa,CACzE,WAAW,CAAC,4CAA4C,EAAE,CAAC,CAAC,CAAC"}

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

@@ -11,20 +11,6 @@ export declare const SkillCommandController: {
          * 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
-         *
-         * The backend will:
-         * 1. Normalize the name to a slug
-         * 2. Find or create the skill resource
-         * 3. Extract SKILL.md from the artifact
-         * 4. Calculate SHA256 hash (version identifier)
-         * 5. Store the artifact (deduplicated by hash)
-         * 6. Update skill spec and status
-         * 7. Archive the previous version (if updating)
-         *
          * @generated from rpc ai.stigmer.agentic.skill.v1.SkillCommandController.push
          */
         readonly push: {
@@ -33,20 +19,30 @@ export declare const SkillCommandController: {
             readonly O: any;
             readonly kind: any;
         };
+        /**
+         * Mint a short-lived, single-use upload URL for staging a skill artifact
+         * that exceeds the gRPC message-size cap (10MB). Flow:
+         *
+         * 1. createArtifactUploadUrl(org, size_bytes) → { url, artifact_upload_ref }
+         * 2. HTTP PUT the ZIP bytes to url
+         * 3. push(PushSkillRequest{ artifact_upload_ref }) — same pipeline,
+         *    validation, and versioning as an inline push
+         *
+         * The server refuses over-limit size_bytes here, before any bytes move.
+         *
+         * @generated from rpc ai.stigmer.agentic.skill.v1.SkillCommandController.createArtifactUploadUrl
+         */
+        readonly createArtifactUploadUrl: {
+            readonly name: "createArtifactUploadUrl";
+            readonly I: any;
+            readonly O: any;
+            readonly kind: any;
+        };
         /**
          * 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.
          *
-         * @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.
-         *
-         * 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
          */
         readonly pushFromExecutionArtifact: {
@@ -61,9 +57,6 @@ export declare const SkillCommandController: {
          * metadata fields untouched. Use this to make a skill publicly accessible
          * 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
          */
         readonly updateVisibility: {
@@ -75,9 +68,6 @@ export declare const SkillCommandController: {
         /**
          * Delete a skill and all its versions.
          *
-         * @internal
-         * Removes the skill from the main collection but preserves audit history.
-         *
          * @generated from rpc ai.stigmer.agentic.skill.v1.SkillCommandController.delete
          */
         readonly delete: {

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

@@ -2,7 +2,7 @@
 // @generated from file ai/stigmer/agentic/skill/v1/command.proto (package ai.stigmer.agentic.skill.v1, syntax proto3)
 /* eslint-disable */
 // @ts-nocheck
-import { PushSkillFromExecutionArtifactRequest, PushSkillRequest, SkillId } from "./io_pbjs";
+import { CreateSkillArtifactUploadUrlRequest, PushSkillFromExecutionArtifactRequest, PushSkillRequest, SkillArtifactUploadUrl, SkillId } from "./io_pbjs";
 import { Skill } from "./api_pbjs";
 import { MethodKind } from "@bufbuild/protobuf";
 import { UpdateVisibilityInput } from "../../../commons/apiresource/io_pbjs";
@@ -19,20 +19,6 @@ export const SkillCommandController = {
          * 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
-         *
-         * The backend will:
-         * 1. Normalize the name to a slug
-         * 2. Find or create the skill resource
-         * 3. Extract SKILL.md from the artifact
-         * 4. Calculate SHA256 hash (version identifier)
-         * 5. Store the artifact (deduplicated by hash)
-         * 6. Update skill spec and status
-         * 7. Archive the previous version (if updating)
-         *
          * @generated from rpc ai.stigmer.agentic.skill.v1.SkillCommandController.push
          */
         push: {
@@ -41,20 +27,30 @@ export const SkillCommandController = {
             O: Skill,
             kind: MethodKind.Unary,
         },
+        /**
+         * Mint a short-lived, single-use upload URL for staging a skill artifact
+         * that exceeds the gRPC message-size cap (10MB). Flow:
+         *
+         * 1. createArtifactUploadUrl(org, size_bytes) → { url, artifact_upload_ref }
+         * 2. HTTP PUT the ZIP bytes to url
+         * 3. push(PushSkillRequest{ artifact_upload_ref }) — same pipeline,
+         *    validation, and versioning as an inline push
+         *
+         * The server refuses over-limit size_bytes here, before any bytes move.
+         *
+         * @generated from rpc ai.stigmer.agentic.skill.v1.SkillCommandController.createArtifactUploadUrl
+         */
+        createArtifactUploadUrl: {
+            name: "createArtifactUploadUrl",
+            I: CreateSkillArtifactUploadUrlRequest,
+            O: SkillArtifactUploadUrl,
+            kind: MethodKind.Unary,
+        },
         /**
          * 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.
          *
-         * @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.
-         *
-         * 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
          */
         pushFromExecutionArtifact: {
@@ -69,9 +65,6 @@ export const SkillCommandController = {
          * metadata fields untouched. Use this to make a skill publicly accessible
          * 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
          */
         updateVisibility: {
@@ -83,9 +76,6 @@ export const SkillCommandController = {
         /**
          * Delete a skill and all its versions.
          *
-         * @internal
-         * Removes the skill from the main collection but preserves audit history.
-         *
          * @generated from rpc ai.stigmer.agentic.skill.v1.SkillCommandController.delete
          */
         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,4FAA4F;AAC5F,sHAAsH;AACtH,oBAAoB;AACpB,cAAc;AAEd,OAAO,EAAE,qCAAqC,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7F,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAE7E;;;;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"}
+{"version":3,"file":"command_connect.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/skill/v1/command_connect.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,sHAAsH;AACtH,oBAAoB;AACpB,cAAc;AAEd,OAAO,EAAE,mCAAmC,EAAE,qCAAqC,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1J,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAE7E;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,QAAQ,EAAE,oDAAoD;IAC9D,OAAO,EAAE;QACP;;;;;;WAMG;QACH,IAAI,EAAE;YACJ,IAAI,EAAE,MAAM;YACZ,CAAC,EAAE,gBAAgB;YACnB,CAAC,EAAE,KAAK;YACR,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;;;WAYG;QACH,uBAAuB,EAAE;YACvB,IAAI,EAAE,yBAAyB;YAC/B,CAAC,EAAE,mCAAmC;YACtC,CAAC,EAAE,sBAAsB;YACzB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;WAMG;QACH,yBAAyB,EAAE;YACzB,IAAI,EAAE,2BAA2B;YACjC,CAAC,EAAE,qCAAqC;YACxC,CAAC,EAAE,KAAK;YACR,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;WAOG;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/skill/v1/command_pb.d.ts

@@ -1,6 +1,6 @@
 import type { GenFile, GenService } from "@bufbuild/protobuf/codegenv1";
 import type { SkillSchema } from "./api_pb.js";
-import type { PushSkillFromExecutionArtifactRequestSchema, PushSkillRequestSchema, SkillIdSchema } from "./io_pb.js";
+import type { CreateSkillArtifactUploadUrlRequestSchema, PushSkillFromExecutionArtifactRequestSchema, PushSkillRequestSchema, SkillArtifactUploadUrlSchema, SkillIdSchema } from "./io_pb.js";
 import type { UpdateVisibilityInputSchema } from "../../../commons/apiresource/io_pb.js";
 /**
  * Describes the file ai/stigmer/agentic/skill/v1/command.proto.
@@ -17,20 +17,6 @@ export declare const SkillCommandController: GenService<{
      * 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
-     *
-     * The backend will:
-     * 1. Normalize the name to a slug
-     * 2. Find or create the skill resource
-     * 3. Extract SKILL.md from the artifact
-     * 4. Calculate SHA256 hash (version identifier)
-     * 5. Store the artifact (deduplicated by hash)
-     * 6. Update skill spec and status
-     * 7. Archive the previous version (if updating)
-     *
      * @generated from rpc ai.stigmer.agentic.skill.v1.SkillCommandController.push
      */
     push: {
@@ -38,20 +24,29 @@ export declare const SkillCommandController: GenService<{
         input: typeof PushSkillRequestSchema;
         output: typeof SkillSchema;
     };
+    /**
+     * Mint a short-lived, single-use upload URL for staging a skill artifact
+     * that exceeds the gRPC message-size cap (10MB). Flow:
+     *
+     * 1. createArtifactUploadUrl(org, size_bytes) → { url, artifact_upload_ref }
+     * 2. HTTP PUT the ZIP bytes to url
+     * 3. push(PushSkillRequest{ artifact_upload_ref }) — same pipeline,
+     *    validation, and versioning as an inline push
+     *
+     * The server refuses over-limit size_bytes here, before any bytes move.
+     *
+     * @generated from rpc ai.stigmer.agentic.skill.v1.SkillCommandController.createArtifactUploadUrl
+     */
+    createArtifactUploadUrl: {
+        methodKind: "unary";
+        input: typeof CreateSkillArtifactUploadUrlRequestSchema;
+        output: typeof SkillArtifactUploadUrlSchema;
+    };
     /**
      * 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.
      *
-     * @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.
-     *
-     * 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
      */
     pushFromExecutionArtifact: {
@@ -65,9 +60,6 @@ export declare const SkillCommandController: GenService<{
      * metadata fields untouched. Use this to make a skill publicly accessible
      * 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
      */
     updateVisibility: {
@@ -78,9 +70,6 @@ export declare const SkillCommandController: GenService<{
     /**
      * Delete a skill and all its versions.
      *
-     * @internal
-     * Removes the skill from the main collection but preserves audit history.
-     *
      * @generated from rpc ai.stigmer.agentic.skill.v1.SkillCommandController.delete
      */
     delete: {

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

@@ -10,7 +10,7 @@ import { file_ai_stigmer_commons_rpc_method_options } from "../../../commons/rpc
 /**
  * Describes the file ai/stigmer/agentic/skill/v1/command.proto.
  */
-export const file_ai_stigmer_agentic_skill_v1_command = /*@__PURE__*/ fileDesc("CilhaS9zdGlnbWVyL2FnZW50aWMvc2tpbGwvdjEvY29tbWFuZC5wcm90bxIbYWkuc3RpZ21lci5hZ2VudGljLnNraWxsLnYxMrQFChZTa2lsbENvbW1hbmRDb250cm9sbGVyEpkBCgRwdXNoEi0uYWkuc3RpZ21lci5hZ2VudGljLnNraWxsLnYxLlB1c2hTa2lsbFJlcXVlc3QaIi5haS5zdGlnbWVyLmFnZW50aWMuc2tpbGwudjEuU2tpbGwiPsK4GDoICRAeIgNvcmcqL3VuYXV0aG9yaXplZCB0byBwdXNoIHNraWxsIGluIHRoaXMgb3JnYW5pemF0aW9uEsMBChlwdXNoRnJvbUV4ZWN1dGlvbkFydGlmYWN0EkIuYWkuc3RpZ21lci5hZ2VudGljLnNraWxsLnYxLlB1c2hTa2lsbEZyb21FeGVjdXRpb25BcnRpZmFjdFJlcXVlc3QaIi5haS5zdGlnbWVyLmFnZW50aWMuc2tpbGwudjEuU2tpbGwiPsK4GDoICRAeIgNvcmcqL3VuYXV0aG9yaXplZCB0byBwdXNoIHNraWxsIGluIHRoaXMgb3JnYW5pemF0aW9uEq0BChB1cGRhdGVWaXNpYmlsaXR5EjUuYWkuc3RpZ21lci5jb21tb25zLmFwaXJlc291cmNlLlVwZGF0ZVZpc2liaWxpdHlJbnB1dBoiLmFpLnN0aWdtZXIuYWdlbnRpYy5za2lsbC52MS5Ta2lsbCI+wrgYOggCECsiC3Jlc291cmNlX2lkKid1bmF1dGhvcml6ZWQgdG8gdXBkYXRlIHNraWxsIHZpc2liaWxpdHkSgQEKBmRlbGV0ZRIkLmFpLnN0aWdtZXIuYWdlbnRpYy5za2lsbC52MS5Ta2lsbElkGiIuYWkuc3RpZ21lci5hZ2VudGljLnNraWxsLnYxLlNraWxsIi3CuBgpCAMQKyIFdmFsdWUqHHVuYXV0aG9yaXplZCB0byBkZWxldGUgc2tpbGwaBKD/KytiBnByb3RvMw", [file_ai_stigmer_agentic_skill_v1_api, file_ai_stigmer_agentic_skill_v1_io, file_ai_stigmer_commons_apiresource_io, file_ai_stigmer_commons_apiresource_rpc_service_options, file_ai_stigmer_commons_rpc_method_options]);
+export const file_ai_stigmer_agentic_skill_v1_command = /*@__PURE__*/ fileDesc("CilhaS9zdGlnbWVyL2FnZW50aWMvc2tpbGwvdjEvY29tbWFuZC5wcm90bxIbYWkuc3RpZ21lci5hZ2VudGljLnNraWxsLnYxMocHChZTa2lsbENvbW1hbmRDb250cm9sbGVyEpkBCgRwdXNoEi0uYWkuc3RpZ21lci5hZ2VudGljLnNraWxsLnYxLlB1c2hTa2lsbFJlcXVlc3QaIi5haS5zdGlnbWVyLmFnZW50aWMuc2tpbGwudjEuU2tpbGwiPsK4GDoICRAeIgNvcmcqL3VuYXV0aG9yaXplZCB0byBwdXNoIHNraWxsIGluIHRoaXMgb3JnYW5pemF0aW9uEtABChdjcmVhdGVBcnRpZmFjdFVwbG9hZFVybBJALmFpLnN0aWdtZXIuYWdlbnRpYy5za2lsbC52MS5DcmVhdGVTa2lsbEFydGlmYWN0VXBsb2FkVXJsUmVxdWVzdBozLmFpLnN0aWdtZXIuYWdlbnRpYy5za2lsbC52MS5Ta2lsbEFydGlmYWN0VXBsb2FkVXJsIj7CuBg6CAkQHiIDb3JnKi91bmF1dGhvcml6ZWQgdG8gcHVzaCBza2lsbCBpbiB0aGlzIG9yZ2FuaXphdGlvbhLDAQoZcHVzaEZyb21FeGVjdXRpb25BcnRpZmFjdBJCLmFpLnN0aWdtZXIuYWdlbnRpYy5za2lsbC52MS5QdXNoU2tpbGxGcm9tRXhlY3V0aW9uQXJ0aWZhY3RSZXF1ZXN0GiIuYWkuc3RpZ21lci5hZ2VudGljLnNraWxsLnYxLlNraWxsIj7CuBg6CAkQHiIDb3JnKi91bmF1dGhvcml6ZWQgdG8gcHVzaCBza2lsbCBpbiB0aGlzIG9yZ2FuaXphdGlvbhKtAQoQdXBkYXRlVmlzaWJpbGl0eRI1LmFpLnN0aWdtZXIuY29tbW9ucy5hcGlyZXNvdXJjZS5VcGRhdGVWaXNpYmlsaXR5SW5wdXQaIi5haS5zdGlnbWVyLmFnZW50aWMuc2tpbGwudjEuU2tpbGwiPsK4GDoIAhArIgtyZXNvdXJjZV9pZCondW5hdXRob3JpemVkIHRvIHVwZGF0ZSBza2lsbCB2aXNpYmlsaXR5EoEBCgZkZWxldGUSJC5haS5zdGlnbWVyLmFnZW50aWMuc2tpbGwudjEuU2tpbGxJZBoiLmFpLnN0aWdtZXIuYWdlbnRpYy5za2lsbC52MS5Ta2lsbCItwrgYKQgDECsiBXZhbHVlKhx1bmF1dGhvcml6ZWQgdG8gZGVsZXRlIHNraWxsGgSg/ysrYgZwcm90bzM", [file_ai_stigmer_agentic_skill_v1_api, file_ai_stigmer_agentic_skill_v1_io, file_ai_stigmer_commons_apiresource_io, file_ai_stigmer_commons_apiresource_rpc_service_options, file_ai_stigmer_commons_rpc_method_options]);
 /**
  * SkillCommandController handles write operations for skills.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"command_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/skill/v1/command_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,sHAAsH;AACtH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,oCAAoC,EAAE,MAAM,aAAa,CAAC;AAEnE,OAAO,EAAE,mCAAmC,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,EAAE,sCAAsC,EAAE,MAAM,uCAAuC,CAAC;AAC/F,OAAO,EAAE,uDAAuD,EAAE,MAAM,wDAAwD,CAAC;AACjI,OAAO,EAAE,0CAA0C,EAAE,MAAM,2CAA2C,CAAC;AAEvG;;GAEG;AACH,MAAM,CAAC,MAAM,wCAAwC,GAAY,aAAa,CAC5E,QAAQ,CAAC,4gCAA4gC,EAAE,CAAC,oCAAoC,EAAE,mCAAmC,EAAE,sCAAsC,EAAE,uDAAuD,EAAE,0CAA0C,CAAC,CAAC,CAAC;AAEnvC;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GA6E9B,aAAa,CAChB,WAAW,CAAC,wCAAwC,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"command_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/skill/v1/command_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,sHAAsH;AACtH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,oCAAoC,EAAE,MAAM,aAAa,CAAC;AAEnE,OAAO,EAAE,mCAAmC,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,EAAE,sCAAsC,EAAE,MAAM,uCAAuC,CAAC;AAC/F,OAAO,EAAE,uDAAuD,EAAE,MAAM,wDAAwD,CAAC;AACjI,OAAO,EAAE,0CAA0C,EAAE,MAAM,2CAA2C,CAAC;AAEvG;;GAEG;AACH,MAAM,CAAC,MAAM,wCAAwC,GAAY,aAAa,CAC5E,QAAQ,CAAC,qyCAAqyC,EAAE,CAAC,oCAAoC,EAAE,mCAAmC,EAAE,sCAAsC,EAAE,uDAAuD,EAAE,0CAA0C,CAAC,CAAC,CAAC;AAE5gD;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAkE9B,aAAa,CAChB,WAAW,CAAC,wCAAwC,EAAE,CAAC,CAAC,CAAC"}