@stigmer/sdk 3.15.3-dev.20260914121148 → 3.16.0

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stigmer/sdk",
-  "version": "3.15.3-dev.20260914121148",
+  "version": "3.16.0",
   "description": "Stigmer TypeScript SDK — typed API client for all Stigmer platform resources",
   "license": "Apache-2.0",
   "type": "module",
@@ -45,6 +45,6 @@
   "peerDependencies": {
     "@bufbuild/protobuf": "^2.0.0",
     "@connectrpc/connect-node": "^2.0.0",
-    "@stigmer/protos": "3.15.3-dev.20260914121148"
+    "@stigmer/protos": "3.16.0"
   }
 }

package/plugin.d.ts

@@ -0,0 +1,25 @@
+import type { Transport } from "@connectrpc/connect";
+import type { Plugin } from "@stigmer/protos/ai/stigmer/agentic/plugin/v1/api_pb";
+import { type PushPluginRequest } from "@stigmer/protos/ai/stigmer/agentic/plugin/v1/io_pb";
+import { PluginClient } from "./gen/plugin.js";
+/**
+ * Plugin client with transport-aware push routing: the plugin binding of
+ * `artifact-routing.ts`. A plugin archive travels inline when it fits the
+ * gRPC message cap and is staged over HTTP via `createArtifactUploadUrl`
+ * (the skill lane's slots, one upload surface) when it does not; `push`
+ * simply works for any valid archive size. Every other method is the
+ * generated client's, inherited unchanged.
+ */
+export declare class RoutedPluginClient extends PluginClient {
+    private readonly fetchImpl;
+    private readonly route;
+    /**
+     * @param fetchImpl - Custom `fetch` for the staging PUT. Must be the same
+     *   implementation the transport uses where the global one is restricted
+     *   (the Tauri CSP/CORS case the `Stigmer.fetch` property documents).
+     */
+    constructor(transport: Transport, fetchImpl?: typeof globalThis.fetch);
+    /** Push a plugin archive, routing it by size (see the class comment). */
+    push(input: PushPluginRequest): Promise<Plugin>;
+}
+//# sourceMappingURL=plugin.d.ts.map

package/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qDAAqD,CAAC;AAClF,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,oDAAoD,CAAC;AAG5D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;;;;;GAOG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsC;IAChE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2C;IAEjE;;;;OAIG;gBACS,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK;IAyBrE,yEAAyE;IAChE,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;CAGzD"}

package/plugin.js

@@ -0,0 +1,46 @@
+import { create } from "@bufbuild/protobuf";
+import { CreatePluginArtifactUploadUrlRequestSchema, PushPluginRequestSchema, } from "@stigmer/protos/ai/stigmer/agentic/plugin/v1/io_pb";
+import { pushRoutedArtifact } from "./artifact-routing.js";
+import { PluginClient } from "./gen/plugin.js";
+/**
+ * Plugin client with transport-aware push routing: the plugin binding of
+ * `artifact-routing.ts`. A plugin archive travels inline when it fits the
+ * gRPC message cap and is staged over HTTP via `createArtifactUploadUrl`
+ * (the skill lane's slots, one upload surface) when it does not; `push`
+ * simply works for any valid archive size. Every other method is the
+ * generated client's, inherited unchanged.
+ */
+export class RoutedPluginClient extends PluginClient {
+    fetchImpl;
+    route;
+    /**
+     * @param fetchImpl - Custom `fetch` for the staging PUT. Must be the same
+     *   implementation the transport uses where the global one is restricted
+     *   (the Tauri CSP/CORS case the `Stigmer.fetch` property documents).
+     */
+    constructor(transport, fetchImpl) {
+        super(transport);
+        this.fetchImpl = fetchImpl;
+        this.route = {
+            noun: "plugin",
+            artifactOf: (request) => request.artifact,
+            uploadRefOf: (request) => request.artifactUploadRef,
+            orgOf: (request) => request.org,
+            withUploadRef: (request, artifactUploadRef) => create(PushPluginRequestSchema, {
+                ...request,
+                artifact: new Uint8Array(0),
+                artifactUploadRef,
+            }),
+            mintUploadUrl: (org, sizeBytes) => super.createArtifactUploadUrl(create(CreatePluginArtifactUploadUrlRequestSchema, {
+                org,
+                sizeBytes,
+            })),
+            push: (request) => super.push(request),
+        };
+    }
+    /** Push a plugin archive, routing it by size (see the class comment). */
+    push(input) {
+        return pushRoutedArtifact(this.route, input, this.fetchImpl);
+    }
+}
+//# sourceMappingURL=plugin.js.map

package/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAG5C,OAAO,EACL,0CAA0C,EAC1C,uBAAuB,GAExB,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;;;;;GAOG;AACH,MAAM,OAAO,kBAAmB,SAAQ,YAAY;IACjC,SAAS,CAAsC;IAC/C,KAAK,CAA2C;IAEjE;;;;OAIG;IACH,YAAY,SAAoB,EAAE,SAAmC;QACnE,KAAK,CAAC,SAAS,CAAC,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ;YACzC,WAAW,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,iBAAiB;YACnD,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG;YAC/B,aAAa,EAAE,CAAC,OAAO,EAAE,iBAAiB,EAAE,EAAE,CAC5C,MAAM,CAAC,uBAAuB,EAAE;gBAC9B,GAAG,OAAO;gBACV,QAAQ,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC;gBAC3B,iBAAiB;aAClB,CAAC;YACJ,aAAa,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,CAChC,KAAK,CAAC,uBAAuB,CAC3B,MAAM,CAAC,0CAA0C,EAAE;gBACjD,GAAG;gBACH,SAAS;aACV,CAAC,CACH;YACH,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;SACvC,CAAC;IACJ,CAAC;IAED,yEAAyE;IAChE,IAAI,CAAC,KAAwB;QACpC,OAAO,kBAAkB,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC/D,CAAC;CACF"}

package/skill.d.ts

@@ -2,50 +2,26 @@ import type { Transport } from "@connectrpc/connect";
 import type { Skill } from "@stigmer/protos/ai/stigmer/agentic/skill/v1/api_pb";
 import { type PushSkillRequest } from "@stigmer/protos/ai/stigmer/agentic/skill/v1/io_pb";
 import { SkillClient } from "./gen/skill.js";
+export { MAX_INLINE_ARTIFACT_BYTES } from "./artifact-routing.js";
 /**
- * Largest artifact pushed inline in the gRPC request (#675). The server's
- * transport cap is 10MB for the WHOLE message, so the artifact leaves 64KB
- * of headroom for the request envelope (org, tag, provenance, framing).
- * Mirrors the Go SDK's maxInlineArtifactBytes.
- */
-export declare const MAX_INLINE_ARTIFACT_BYTES: number;
-/**
- * Skill client with transport-aware push routing (stigmer#675 / #701).
- *
- * The gRPC transport caps messages at 10MB while skills may be up to 100MB,
- * so `push` routes by size: small artifacts travel inline in the request
- * (one round trip, unchanged behavior), larger ones are staged over HTTP
- * via `createArtifactUploadUrl` — a capability URL, so no auth header —
- * and pushed by reference. Callers never see the mechanics: `push(req)`
- * simply works for any valid skill size.
+ * Skill client with transport-aware push routing (stigmer#675 / #701):
+ * the skill binding of `artifact-routing.ts`, which holds the mechanism
+ * (small artifacts inline, larger ones staged over HTTP via
+ * `createArtifactUploadUrl` and pushed by reference). Callers never see
+ * the mechanics: `push(req)` simply works for any valid skill size.
  *
  * Every other method is the generated client's, inherited unchanged.
  */
 export declare class RoutedSkillClient extends SkillClient {
     private readonly fetchImpl;
+    private readonly route;
     /**
      * @param fetchImpl - Custom `fetch` for the staging PUT. Must be the same
      *   implementation the transport uses where the global one is restricted
      *   (the Tauri CSP/CORS case the `Stigmer.fetch` property documents).
      */
     constructor(transport: Transport, fetchImpl?: typeof globalThis.fetch);
-    /**
-     * Push a skill, routing the artifact by size (see the class comment).
-     *
-     * A request that already carries an `artifactUploadRef` is passed through
-     * untouched — the caller has done its own staging.
-     */
+    /** Push a skill, routing the artifact by size (see the class comment). */
     push(input: PushSkillRequest): Promise<Skill>;
-    /**
-     * Stage the artifact over HTTP and push by reference:
-     * createArtifactUploadUrl → PUT bytes → push(artifactUploadRef).
-     */
-    private pushViaUploadUrl;
-    /**
-     * PUT the artifact ZIP to the staging URL. The URL is the credential
-     * (capability semantics — a pre-signed R2 URL on cloud, the server's own
-     * transfer lane on OSS), so no auth header is attached.
-     */
-    private putArtifact;
 }
 //# sourceMappingURL=skill.d.ts.map

package/skill.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oDAAoD,CAAC;AAChF,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,mDAAmD,CAAC;AAE3D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,QAA+B,CAAC;AAEtE;;;;;;;;;;;GAWG;AACH,qBAAa,iBAAkB,SAAQ,WAAW;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsC;IAEhE;;;;OAIG;gBACS,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK;IAKrE;;;;;OAKG;IACY,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC;IAO5D;;;OAGG;YACW,gBAAgB;IAqC9B;;;;OAIG;YACW,WAAW;CAoB1B"}
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oDAAoD,CAAC;AAChF,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,mDAAmD,CAAC;AAG3D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAElE;;;;;;;;GAQG;AACH,qBAAa,iBAAkB,SAAQ,WAAW;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsC;IAChE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyC;IAE/D;;;;OAIG;gBACS,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK;IAsBrE,0EAA0E;IACjE,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC;CAGvD"}

package/skill.js

@@ -1,29 +1,20 @@
 import { create } from "@bufbuild/protobuf";
-import { Code } from "@connectrpc/connect";
 import { CreateSkillArtifactUploadUrlRequestSchema, PushSkillRequestSchema, } from "@stigmer/protos/ai/stigmer/agentic/skill/v1/io_pb";
-import { isUnimplemented, StigmerError } from "./gen/errors.js";
+import { pushRoutedArtifact } from "./artifact-routing.js";
 import { SkillClient } from "./gen/skill.js";
+export { MAX_INLINE_ARTIFACT_BYTES } from "./artifact-routing.js";
 /**
- * Largest artifact pushed inline in the gRPC request (#675). The server's
- * transport cap is 10MB for the WHOLE message, so the artifact leaves 64KB
- * of headroom for the request envelope (org, tag, provenance, framing).
- * Mirrors the Go SDK's maxInlineArtifactBytes.
- */
-export const MAX_INLINE_ARTIFACT_BYTES = 10 * 1024 * 1024 - 64 * 1024;
-/**
- * Skill client with transport-aware push routing (stigmer#675 / #701).
- *
- * The gRPC transport caps messages at 10MB while skills may be up to 100MB,
- * so `push` routes by size: small artifacts travel inline in the request
- * (one round trip, unchanged behavior), larger ones are staged over HTTP
- * via `createArtifactUploadUrl` — a capability URL, so no auth header —
- * and pushed by reference. Callers never see the mechanics: `push(req)`
- * simply works for any valid skill size.
+ * Skill client with transport-aware push routing (stigmer#675 / #701):
+ * the skill binding of `artifact-routing.ts`, which holds the mechanism
+ * (small artifacts inline, larger ones staged over HTTP via
+ * `createArtifactUploadUrl` and pushed by reference). Callers never see
+ * the mechanics: `push(req)` simply works for any valid skill size.
  *
  * Every other method is the generated client's, inherited unchanged.
  */
 export class RoutedSkillClient extends SkillClient {
     fetchImpl;
+    route;
     /**
      * @param fetchImpl - Custom `fetch` for the staging PUT. Must be the same
      *   implementation the transport uses where the global one is restricted
@@ -32,71 +23,23 @@ export class RoutedSkillClient extends SkillClient {
     constructor(transport, fetchImpl) {
         super(transport);
         this.fetchImpl = fetchImpl;
+        this.route = {
+            noun: "skill",
+            artifactOf: (request) => request.artifact,
+            uploadRefOf: (request) => request.artifactUploadRef,
+            orgOf: (request) => request.org,
+            withUploadRef: (request, artifactUploadRef) => create(PushSkillRequestSchema, {
+                ...request,
+                artifact: new Uint8Array(0),
+                artifactUploadRef,
+            }),
+            mintUploadUrl: (org, sizeBytes) => super.createArtifactUploadUrl(create(CreateSkillArtifactUploadUrlRequestSchema, { org, sizeBytes })),
+            push: (request) => super.push(request),
+        };
     }
-    /**
-     * Push a skill, routing the artifact by size (see the class comment).
-     *
-     * A request that already carries an `artifactUploadRef` is passed through
-     * untouched — the caller has done its own staging.
-     */
-    async push(input) {
-        if (input.artifactUploadRef !== "" || input.artifact.length <= MAX_INLINE_ARTIFACT_BYTES) {
-            return super.push(input);
-        }
-        return this.pushViaUploadUrl(input);
-    }
-    /**
-     * Stage the artifact over HTTP and push by reference:
-     * createArtifactUploadUrl → PUT bytes → push(artifactUploadRef).
-     */
-    async pushViaUploadUrl(input) {
-        let minted;
-        try {
-            minted = await super.createArtifactUploadUrl(create(CreateSkillArtifactUploadUrlRequestSchema, {
-                org: input.org,
-                sizeBytes: BigInt(input.artifact.length),
-            }));
-        }
-        catch (err) {
-            if (isUnimplemented(err)) {
-                // Pre-transfer-lane server: without staging, an artifact this size
-                // physically cannot travel. Say so instead of surfacing the raw
-                // transport error (the failure mode #675 reported).
-                throw new StigmerError("unknown", `skill artifact is ${input.artifact.length} bytes, above the ~10MB gRPC message cap, ` +
-                    "and this server does not support the HTTP artifact transfer lane — " +
-                    "upgrade stigmer-server to push skills of this size", Code.Unimplemented, { cause: err });
-            }
-            throw err;
-        }
-        await this.putArtifact(minted.url, input.artifact);
-        // Same request, artifact traveling by reference instead of by value.
-        const byRef = create(PushSkillRequestSchema, {
-            ...input,
-            artifact: new Uint8Array(0),
-            artifactUploadRef: minted.artifactUploadRef,
-        });
-        return super.push(byRef);
-    }
-    /**
-     * PUT the artifact ZIP to the staging URL. The URL is the credential
-     * (capability semantics — a pre-signed R2 URL on cloud, the server's own
-     * transfer lane on OSS), so no auth header is attached.
-     */
-    async putArtifact(url, artifact) {
-        const doFetch = this.fetchImpl ?? globalThis.fetch;
-        const resp = await doFetch(url, {
-            method: "PUT",
-            // Both DOM and undici accept an ArrayBufferView body at runtime; the
-            // cast bridges TS 5.7's ArrayBufferLike generic, which BodyInit's
-            // typing predates. A Blob/Buffer wrapper would copy up to 100MB for
-            // nothing, and Buffer is Node-only while this client is isomorphic.
-            body: artifact,
-            headers: { "content-type": "application/zip" },
-        });
-        if (!resp.ok) {
-            const detail = (await resp.text().catch(() => "")).slice(0, 512).trim();
-            throw new StigmerError("unknown", `skill artifact upload rejected with HTTP ${resp.status}${detail === "" ? "" : `: ${detail}`}`, Code.Unknown);
-        }
+    /** Push a skill, routing the artifact by size (see the class comment). */
+    push(input) {
+        return pushRoutedArtifact(this.route, input, this.fetchImpl);
     }
 }
 //# sourceMappingURL=skill.js.map

package/skill.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill.js","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAG5C,OAAO,EACL,yCAAyC,EACzC,sBAAsB,GAEvB,MAAM,mDAAmD,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAElE;;;;;;;;GAQG;AACH,MAAM,OAAO,iBAAkB,SAAQ,WAAW;IAC/B,SAAS,CAAsC;IAC/C,KAAK,CAAyC;IAE/D;;;;OAIG;IACH,YAAY,SAAoB,EAAE,SAAmC;QACnE,KAAK,CAAC,SAAS,CAAC,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG;YACX,IAAI,EAAE,OAAO;YACb,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ;YACzC,WAAW,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,iBAAiB;YACnD,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG;YAC/B,aAAa,EAAE,CAAC,OAAO,EAAE,iBAAiB,EAAE,EAAE,CAC5C,MAAM,CAAC,sBAAsB,EAAE;gBAC7B,GAAG,OAAO;gBACV,QAAQ,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC;gBAC3B,iBAAiB;aAClB,CAAC;YACJ,aAAa,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,CAChC,KAAK,CAAC,uBAAuB,CAC3B,MAAM,CAAC,yCAAyC,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CACtE;YACH,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;SACvC,CAAC;IACJ,CAAC;IAED,0EAA0E;IACjE,IAAI,CAAC,KAAuB;QACnC,OAAO,kBAAkB,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC/D,CAAC;CACF"}

package/src/__tests__/plugin.test.ts

@@ -0,0 +1,92 @@
+// Wire-shape tests for RoutedPluginClient's size-routed push: the plugin
+// binding of the shared artifact routing. The routing mechanism itself is
+// pinned by skill.test.ts; these arms pin that the plugin binding reads
+// and rewrites ITS request shape (org, artifact, artifactUploadRef,
+// visibility, message) and mints through ITS createArtifactUploadUrl.
+import { describe, expect, it, vi } from "vitest";
+import { createRouterTransport, type Transport } from "@connectrpc/connect";
+import { create } from "@bufbuild/protobuf";
+import { PluginCommandController } from "@stigmer/protos/ai/stigmer/agentic/plugin/v1/command_pb";
+import { PluginSchema } from "@stigmer/protos/ai/stigmer/agentic/plugin/v1/api_pb";
+import {
+  PluginArtifactUploadUrlSchema,
+  PushPluginRequestSchema,
+  type PushPluginRequest,
+} from "@stigmer/protos/ai/stigmer/agentic/plugin/v1/io_pb";
+import { ApiResourceVisibility } from "@stigmer/protos/ai/stigmer/commons/apiresource/enum_pb";
+import { RoutedPluginClient } from "../plugin.js";
+import { MAX_INLINE_ARTIFACT_BYTES } from "../skill.js";
+
+const STAGING_URL = "http://stage.example/v1/skill-artifacts/uploads/sau_p";
+
+interface Captured {
+  pushes: PushPluginRequest[];
+  mints: number;
+}
+
+function fakeTransport(captured: Captured): Transport {
+  return createRouterTransport(({ service }) => {
+    service(PluginCommandController, {
+      push: (req) => {
+        captured.pushes.push(req);
+        return create(PluginSchema, {});
+      },
+      createArtifactUploadUrl: (req) => {
+        captured.mints++;
+        expect(req.org).toBe("acme");
+        expect(req.sizeBytes).toBeGreaterThan(0n);
+        return create(PluginArtifactUploadUrlSchema, {
+          url: STAGING_URL,
+          artifactUploadRef: "sau_p",
+          ttlSeconds: 900,
+        });
+      },
+    });
+  });
+}
+
+describe("RoutedPluginClient.push size routing", () => {
+  it("keeps a small archive inline", async () => {
+    const captured: Captured = { pushes: [], mints: 0 };
+    const client = new RoutedPluginClient(fakeTransport(captured));
+    await client.push(
+      create(PushPluginRequestSchema, {
+        org: "acme",
+        artifact: new Uint8Array(2048),
+      }),
+    );
+    expect(captured.mints).toBe(0);
+    expect(captured.pushes[0]?.artifact.length).toBe(2048);
+  });
+
+  it("stages a large archive through the plugin's own mint and pushes by reference, keeping the envelope", async () => {
+    const captured: Captured = { pushes: [], mints: 0 };
+    const record: { url?: string; bytes?: number } = {};
+    const fetchImpl = vi.fn(async (url: unknown, init: RequestInit) => {
+      record.url = String(url);
+      record.bytes =
+        init.body instanceof Uint8Array ? init.body.byteLength : -1;
+      return new Response(null, { status: 200 });
+    }) as unknown as typeof globalThis.fetch;
+    const client = new RoutedPluginClient(fakeTransport(captured), fetchImpl);
+    const artifact = new Uint8Array(MAX_INLINE_ARTIFACT_BYTES + 1);
+
+    await client.push(
+      create(PushPluginRequestSchema, {
+        org: "acme",
+        artifact,
+        visibility: ApiResourceVisibility.visibility_public,
+        message: "big",
+      }),
+    );
+
+    expect(captured.mints).toBe(1);
+    expect(record.url).toBe(STAGING_URL);
+    expect(record.bytes).toBe(artifact.length);
+    const pushed = captured.pushes[0]!;
+    expect(pushed.artifact.length).toBe(0);
+    expect(pushed.artifactUploadRef).toBe("sau_p");
+    expect(pushed.visibility).toBe(ApiResourceVisibility.visibility_public);
+    expect(pushed.message).toBe("big");
+  });
+});

package/src/artifact-routing.ts

@@ -0,0 +1,111 @@
+import { Code } from "@connectrpc/connect";
+import { isUnimplemented, StigmerError } from "./gen/errors.js";
+
+/**
+ * Largest artifact pushed inline in the gRPC request (#675). The server's
+ * transport cap is 10MB for the WHOLE message, so the artifact leaves 64KB
+ * of headroom for the request envelope (org, tag, provenance, framing).
+ * Mirrors the Go SDK's maxInlineArtifactBytes.
+ */
+export const MAX_INLINE_ARTIFACT_BYTES = 10 * 1024 * 1024 - 64 * 1024;
+
+/**
+ * Transport-aware push routing for archive-shaped kinds (skills, plugins;
+ * stigmer#675 / #701). The gRPC transport caps messages at 10MB while an
+ * archive may be up to 100MB, so a push routes by size: a small archive
+ * travels inline (one round trip), a larger one is staged over HTTP via
+ * the kind's `createArtifactUploadUrl` — a capability URL, so no auth
+ * header — and pushed by reference. Skills carried this alone; plugins
+ * push the same two ways, so the routing lives here once and each kind
+ * binds its request shape and its noun.
+ */
+export interface ArtifactRoute<Request, Response> {
+  /** The noun in error copy: "skill", "plugin". */
+  readonly noun: string;
+  artifactOf(request: Request): Uint8Array;
+  uploadRefOf(request: Request): string;
+  orgOf(request: Request): string;
+  /** The same request with the bytes replaced by a staged reference. */
+  withUploadRef(request: Request, artifactUploadRef: string): Request;
+  mintUploadUrl(
+    org: string,
+    sizeBytes: bigint,
+  ): Promise<{ url: string; artifactUploadRef: string }>;
+  push(request: Request): Promise<Response>;
+}
+
+/**
+ * Push, routing the archive by size. A request that already carries an
+ * upload reference is passed through untouched — the caller has done its
+ * own staging.
+ */
+export async function pushRoutedArtifact<Request, Response>(
+  route: ArtifactRoute<Request, Response>,
+  input: Request,
+  fetchImpl: typeof globalThis.fetch | undefined,
+): Promise<Response> {
+  const artifact = route.artifactOf(input);
+  if (
+    route.uploadRefOf(input) !== "" ||
+    artifact.length <= MAX_INLINE_ARTIFACT_BYTES
+  ) {
+    return route.push(input);
+  }
+
+  let minted;
+  try {
+    minted = await route.mintUploadUrl(
+      route.orgOf(input),
+      BigInt(artifact.length),
+    );
+  } catch (err) {
+    if (isUnimplemented(err)) {
+      // Pre-transfer-lane server: without staging, an artifact this size
+      // physically cannot travel. Say so instead of surfacing the raw
+      // transport error (the failure mode #675 reported).
+      throw new StigmerError(
+        "unknown",
+        `${route.noun} artifact is ${artifact.length} bytes, above the ~10MB gRPC message cap, ` +
+          "and this server does not support the HTTP artifact transfer lane — " +
+          `upgrade stigmer-server to push ${route.noun}s of this size`,
+        Code.Unimplemented,
+        { cause: err },
+      );
+    }
+    throw err;
+  }
+
+  await putArtifact(route.noun, minted.url, artifact, fetchImpl);
+  return route.push(route.withUploadRef(input, minted.artifactUploadRef));
+}
+
+/**
+ * PUT the archive to the staging URL. The URL is the credential
+ * (capability semantics — a pre-signed R2 URL on cloud, the server's own
+ * transfer lane on OSS), so no auth header is attached.
+ */
+async function putArtifact(
+  noun: string,
+  url: string,
+  artifact: Uint8Array,
+  fetchImpl: typeof globalThis.fetch | undefined,
+): Promise<void> {
+  const doFetch = fetchImpl ?? globalThis.fetch;
+  const resp = await doFetch(url, {
+    method: "PUT",
+    // Both DOM and undici accept an ArrayBufferView body at runtime; the
+    // cast bridges TS 5.7's ArrayBufferLike generic, which BodyInit's
+    // typing predates. A Blob/Buffer wrapper would copy up to 100MB for
+    // nothing, and Buffer is Node-only while this client is isomorphic.
+    body: artifact as unknown as RequestInit["body"],
+    headers: { "content-type": "application/zip" },
+  });
+  if (!resp.ok) {
+    const detail = (await resp.text().catch(() => "")).slice(0, 512).trim();
+    throw new StigmerError(
+      "unknown",
+      `${noun} artifact upload rejected with HTTP ${resp.status}${detail === "" ? "" : `: ${detail}`}`,
+      Code.Unknown,
+    );
+  }
+}

package/src/gen/authorization-config.ts

@@ -32,5 +32,6 @@ export const GRANTABLE_ROLES: ReadonlyMap<ApiResourceKind, readonly IamRole[]> =
   [ApiResourceKind.environment, [IamRole.owner, IamRole.viewer]],
   [ApiResourceKind.artifact, [IamRole.owner, IamRole.viewer]],
   [ApiResourceKind.schedule, [IamRole.owner, IamRole.viewer]],
+  [ApiResourceKind.plugin, [IamRole.owner, IamRole.viewer]],
   [ApiResourceKind.project, [IamRole.owner, IamRole.viewer]],
 ]);

package/src/gen/client.ts

@@ -20,6 +20,7 @@ import { MemoryClient } from "./memory.js";
 import { OAuthAppClient } from "./oauthapp.js";
 import { OrganizationClient } from "./organization.js";
 import { PlatformClientClient } from "./platformclient.js";
+import { PluginClient } from "./plugin.js";
 import { ProjectClient } from "./project.js";
 import { ScheduleClient } from "./schedule.js";
 import { SessionClient } from "./session.js";
@@ -49,6 +50,7 @@ export class GeneratedClient {
   readonly oauthapp: OAuthAppClient;
   readonly organization: OrganizationClient;
   readonly platformclient: PlatformClientClient;
+  readonly plugin: PluginClient;
   readonly project: ProjectClient;
   readonly schedule: ScheduleClient;
   readonly session: SessionClient;
@@ -77,6 +79,7 @@ export class GeneratedClient {
     this.oauthapp = new OAuthAppClient(transport);
     this.organization = new OrganizationClient(transport);
     this.platformclient = new PlatformClientClient(transport);
+    this.plugin = new PluginClient(transport);
     this.project = new ProjectClient(transport);
     this.schedule = new ScheduleClient(transport);
     this.session = new SessionClient(transport);
@@ -126,6 +129,8 @@ export { OrganizationClient } from "./organization.js";
 export { type OrganizationInput, type OrganizationPreferencesInput } from "./organization.js";
 export { PlatformClientClient } from "./platformclient.js";
 export { type PlatformClientInput } from "./platformclient.js";
+export { PluginClient } from "./plugin.js";
+export { type PluginInput, type PluginAuthorInput } from "./plugin.js";
 export { ProjectClient } from "./project.js";
 export { type ProjectInput } from "./project.js";
 export { ScheduleClient } from "./schedule.js";