@stigmer/sdk 3.15.3-dev.20260914121148 → 3.16.0

package/src/gen/plugin.ts

@@ -0,0 +1,143 @@
+// Code generated by stigmer-codegen. DO NOT EDIT.
+
+import { wrapError } from "./errors.js";
+import { stripUndefined } from "./proto-utils.js";
+import { type ResourceRef } from "./types.js";
+import { create } from "@bufbuild/protobuf";
+import { createClient, type Client, type Transport } from "@connectrpc/connect";
+import { PluginSchema, type Plugin } from "@stigmer/protos/ai/stigmer/agentic/plugin/v1/api_pb";
+import { PluginCommandController } from "@stigmer/protos/ai/stigmer/agentic/plugin/v1/command_pb";
+import { PluginIdSchema, PushPluginRequestSchema, CreatePluginArtifactUploadUrlRequestSchema, PluginArtifactUploadUrlSchema, ListPluginMembersResponseSchema, ListPluginVersionsInputSchema, ListPluginVersionsResponseSchema, type PushPluginRequest, type CreatePluginArtifactUploadUrlRequest, type PluginArtifactUploadUrl, type ListPluginMembersResponse, type ListPluginVersionsInput, type ListPluginVersionsResponse } from "@stigmer/protos/ai/stigmer/agentic/plugin/v1/io_pb";
+import { PluginQueryController } from "@stigmer/protos/ai/stigmer/agentic/plugin/v1/query_pb";
+import { PluginSpecSchema, PluginDialect, PluginAuthorSchema } from "@stigmer/protos/ai/stigmer/agentic/plugin/v1/spec_pb";
+import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
+import { ApiResourceVisibility } from "@stigmer/protos/ai/stigmer/commons/apiresource/enum_pb";
+import { ApiResourceReferenceSchema, type UpdateVisibilityInput } from "@stigmer/protos/ai/stigmer/commons/apiresource/io_pb";
+import { ApiResourceMetadataSchema, ApiResourceMetadataVersionSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/metadata_pb";
+
+/** Provides operations on plugin resources. */
+export class PluginClient {
+  private readonly command: Client<typeof PluginCommandController>;
+  private readonly query: Client<typeof PluginQueryController>;
+
+  constructor(transport: Transport) {
+    this.command = createClient(PluginCommandController, transport);
+    this.query = createClient(PluginQueryController, transport);
+  }
+
+  async push(input: PushPluginRequest): Promise<Plugin> {
+    try {
+      return await this.command.push(input);
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async createArtifactUploadUrl(input: CreatePluginArtifactUploadUrlRequest): Promise<PluginArtifactUploadUrl> {
+    try {
+      return await this.command.createArtifactUploadUrl(input);
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async updateVisibility(input: UpdateVisibilityInput): Promise<Plugin> {
+    try {
+      return await this.command.updateVisibility(input);
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async delete(id: string): Promise<Plugin> {
+    try {
+      return await this.command.delete(create(PluginIdSchema, { value: id }));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async get(id: string): Promise<Plugin> {
+    try {
+      return await this.query.get(create(PluginIdSchema, { value: id }));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async getByReference(ref: ResourceRef): Promise<Plugin> {
+    try {
+      return await this.query.getByReference(create(ApiResourceReferenceSchema, { ...ref, kind: ApiResourceKind.plugin }));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async listMembers(id: string): Promise<ListPluginMembersResponse> {
+    try {
+      return await this.query.listMembers(create(PluginIdSchema, { value: id }));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async listVersions(input: ListPluginVersionsInput): Promise<ListPluginVersionsResponse> {
+    try {
+      return await this.query.listVersions(input);
+    } catch (e) { throw wrapError(e); }
+  }
+}
+
+/** Input for creating/updating a Plugin. */
+export interface PluginInput {
+  /**
+   * The resource's `metadata.id`, for exact update addressing when set
+   * from a loaded resource. Required for updates to platform-scoped
+   * (org-less) kinds, where the org+slug fallback cannot match. On
+   * create, the cloud server stamps its own id regardless; the OSS
+   * server honors a caller-supplied id (existing apply semantics).
+   */
+  id?: string;
+  name: string;
+  slug?: string;
+  org: string;
+  labels?: Record<string, string>;
+  visibility?: ApiResourceVisibility;
+  versionMessage?: string;
+  version?: string;
+  description?: string;
+  author?: PluginAuthorInput;
+  homepage?: string;
+  repository?: string;
+  license?: string;
+  keywords?: string[];
+  dialect?: PluginDialect;
+}
+
+/** SDK input type for PluginAuthor. */
+export interface PluginAuthorInput {
+  name?: string;
+  email?: string;
+  url?: string;
+}
+
+function buildPluginAuthorProto(input: PluginAuthorInput) {
+  return Object.assign(create(PluginAuthorSchema), stripUndefined({
+    name: input.name,
+    email: input.email,
+    url: input.url,
+  }));
+}
+
+export function buildPluginProto(input: PluginInput): Plugin {
+  const author = input.author ? buildPluginAuthorProto(input.author) : undefined;
+  return Object.assign(create(PluginSchema), {
+    apiVersion: "agentic.stigmer.ai/v1",
+    kind: "Plugin",
+    metadata: Object.assign(create(ApiResourceMetadataSchema), {
+      ...(input.id && { id: input.id }),
+      name: input.name,
+      org: input.org,
+      ...(input.slug && { slug: input.slug }),
+      ...(input.labels && { labels: input.labels }),
+      ...(input.visibility && { visibility: input.visibility }),
+      ...(input.versionMessage && { version: Object.assign(create(ApiResourceMetadataVersionSchema), { message: input.versionMessage }) }),
+    }),
+    spec: Object.assign(create(PluginSpecSchema), stripUndefined({
+      version: input.version,
+      description: input.description,
+      author,
+      homepage: input.homepage,
+      repository: input.repository,
+      license: input.license,
+      keywords: input.keywords,
+      dialect: input.dialect,
+    })),
+  }) as Plugin;
+}

package/src/gen/resource-availability.ts

@@ -39,5 +39,6 @@ export const KIND_TIERS: ReadonlyMap<ApiResourceKind, ResourceTier> = new Map([
   [ApiResourceKind.artifact, ResourceTier.open_source],
   [ApiResourceKind.schedule, ResourceTier.open_source],
   [ApiResourceKind.memory, ResourceTier.open_source],
+  [ApiResourceKind.plugin, ResourceTier.open_source],
   [ApiResourceKind.project, ResourceTier.open_source],
 ]);

package/src/index.ts

@@ -362,6 +362,8 @@ export {
 export { toDisplayFileChange } from "./execution/to-display-file-change.js";
 export { SkillClient, type SkillInput } from "./gen/skill.js";
 export { RoutedSkillClient, MAX_INLINE_ARTIFACT_BYTES } from "./skill.js";
+export { PluginClient, type PluginInput, type PluginAuthorInput } from "./gen/plugin.js";
+export { RoutedPluginClient } from "./plugin.js";
 export {
   WorkflowClient,
   toWorkflowUpdateInput,

package/src/plugin.ts

@@ -0,0 +1,59 @@
+import { create } from "@bufbuild/protobuf";
+import type { Transport } from "@connectrpc/connect";
+import type { Plugin } from "@stigmer/protos/ai/stigmer/agentic/plugin/v1/api_pb";
+import {
+  CreatePluginArtifactUploadUrlRequestSchema,
+  PushPluginRequestSchema,
+  type PushPluginRequest,
+} from "@stigmer/protos/ai/stigmer/agentic/plugin/v1/io_pb";
+import { pushRoutedArtifact } from "./artifact-routing.js";
+import type { ArtifactRoute } 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 {
+  private readonly fetchImpl: typeof globalThis.fetch | undefined;
+  private readonly route: ArtifactRoute<PushPluginRequest, Plugin>;
+
+  /**
+   * @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) {
+    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). */
+  override push(input: PushPluginRequest): Promise<Plugin> {
+    return pushRoutedArtifact(this.route, input, this.fetchImpl);
+  }
+}

package/src/skill.ts

@@ -1,5 +1,4 @@
 import { create } from "@bufbuild/protobuf";
-import { Code } from "@connectrpc/connect";
 import type { Transport } from "@connectrpc/connect";
 import type { Skill } from "@stigmer/protos/ai/stigmer/agentic/skill/v1/api_pb";
 import {
@@ -7,31 +6,24 @@ import {
   PushSkillRequestSchema,
   type PushSkillRequest,
 } from "@stigmer/protos/ai/stigmer/agentic/skill/v1/io_pb";
-import { isUnimplemented, StigmerError } from "./gen/errors.js";
+import { pushRoutedArtifact } from "./artifact-routing.js";
+import type { ArtifactRoute } from "./artifact-routing.js";
 import { SkillClient } from "./gen/skill.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;
+export { MAX_INLINE_ARTIFACT_BYTES } from "./artifact-routing.js";
 
 /**
- * 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 {
   private readonly fetchImpl: typeof globalThis.fetch | undefined;
+  private readonly route: ArtifactRoute<PushSkillRequest, Skill>;
 
   /**
    * @param fetchImpl - Custom `fetch` for the staging PUT. Must be the same
@@ -41,85 +33,27 @@ export class RoutedSkillClient extends SkillClient {
   constructor(transport: Transport, fetchImpl?: typeof globalThis.fetch) {
     super(transport);
     this.fetchImpl = fetchImpl;
-  }
-
-  /**
-   * 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.
-   */
-  override async push(input: PushSkillRequest): Promise<Skill> {
-    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).
-   */
-  private async pushViaUploadUrl(input: PushSkillRequest): Promise<Skill> {
-    let minted;
-    try {
-      minted = await super.createArtifactUploadUrl(
-        create(CreateSkillArtifactUploadUrlRequestSchema, {
-          org: input.org,
-          sizeBytes: BigInt(input.artifact.length),
+    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,
         }),
-      );
-    } 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);
+      mintUploadUrl: (org, sizeBytes) =>
+        super.createArtifactUploadUrl(
+          create(CreateSkillArtifactUploadUrlRequestSchema, { org, sizeBytes }),
+        ),
+      push: (request) => super.push(request),
+    };
   }
 
-  /**
-   * 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 async putArtifact(url: string, artifact: Uint8Array): Promise<void> {
-    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 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",
-        `skill artifact upload rejected with HTTP ${resp.status}${detail === "" ? "" : `: ${detail}`}`,
-        Code.Unknown,
-      );
-    }
+  /** Push a skill, routing the artifact by size (see the class comment). */
+  override push(input: PushSkillRequest): Promise<Skill> {
+    return pushRoutedArtifact(this.route, input, this.fetchImpl);
   }
 }

package/src/stigmer.ts

@@ -7,6 +7,7 @@ import { ManifestClient } from "./manifest/index.js";
 import { PlatformClient } from "./platform.js";
 import { ProviderStandingClient } from "./provider-standing.js";
 import { SearchClient } from "./search.js";
+import { RoutedPluginClient } from "./plugin.js";
 import { RoutedSkillClient } from "./skill.js";
 import { createStigmerTransport } from "./transport.js";
 import {
@@ -92,6 +93,12 @@ export class Stigmer extends GeneratedClient {
    * `stigmer.skill.push` simply works for any valid skill size.
    */
   override readonly skill: RoutedSkillClient;
+  /**
+   * Plugin operations, with `push` routed by archive size over the same
+   * transfer lane — shadows the inherited generated client so
+   * `stigmer.plugin.push` simply works for any valid archive size.
+   */
+  override readonly plugin: RoutedPluginClient;
 
   private readonly _tokenProvider: TokenProvider;
 
@@ -106,7 +113,7 @@ export class Stigmer extends GeneratedClient {
     this.defaultExecutionTarget = toExecutionTarget(config.executionTarget);
     this._tokenProvider = config.apiKey
       ? () => config.apiKey!
-      : config.getAccessToken ?? (() => null);
+      : (config.getAccessToken ?? (() => null));
 
     this.activity = new ActivityClient(transport);
     this.billing = new BillingClient(transport);
@@ -117,6 +124,7 @@ export class Stigmer extends GeneratedClient {
     this.github = new GitHubClient(transport);
     this.manifest = new ManifestClient(transport);
     this.skill = new RoutedSkillClient(transport, config.fetch);
+    this.plugin = new RoutedPluginClient(transport, config.fetch);
 
     if (this.defaultExecutionTarget != null) {
       this._applyExecutionTargetDefaults();
@@ -148,7 +156,10 @@ export class Stigmer extends GeneratedClient {
     this.agentExecution.create = (input) =>
       origExecutionCreate(
         input.sessionSpec
-          ? { ...input, sessionSpec: applySessionDefault(input.sessionSpec, target) }
+          ? {
+              ...input,
+              sessionSpec: applySessionDefault(input.sessionSpec, target),
+            }
           : input,
       );
   }
@@ -193,4 +204,3 @@ function applySessionDefault<T extends { executionTarget?: ExecutionTarget }>(
   }
   return input;
 }
-

package/stigmer.d.ts

@@ -7,6 +7,7 @@ import { ManifestClient } from "./manifest/index.js";
 import { PlatformClient } from "./platform.js";
 import { ProviderStandingClient } from "./provider-standing.js";
 import { SearchClient } from "./search.js";
+import { RoutedPluginClient } from "./plugin.js";
 import { RoutedSkillClient } from "./skill.js";
 import { type StigmerConfig } from "./config.js";
 import { ExecutionTarget } from "@stigmer/protos/ai/stigmer/agentic/session/v1/enum_pb";
@@ -81,6 +82,12 @@ export declare class Stigmer extends GeneratedClient {
      * `stigmer.skill.push` simply works for any valid skill size.
      */
     readonly skill: RoutedSkillClient;
+    /**
+     * Plugin operations, with `push` routed by archive size over the same
+     * transfer lane — shadows the inherited generated client so
+     * `stigmer.plugin.push` simply works for any valid archive size.
+     */
+    readonly plugin: RoutedPluginClient;
     private readonly _tokenProvider;
     constructor(config: StigmerConfig);
     /**

package/stigmer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stigmer.d.ts","sourceRoot":"","sources":["../src/stigmer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,uDAAuD,CAAC;AAIxF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,OAAQ,SAAQ,eAAe;IAC1C;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;;;;;;;OAQG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,GAAG,SAAS,CAAC;IAEpD;;;;;;;;;OASG;IACH,QAAQ,CAAC,sBAAsB,EAAE,eAAe,GAAG,SAAS,CAAC;IAE7D,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,yDAAyD;IACzD,QAAQ,CAAC,cAAc,EAAE,oBAAoB,CAAC;IAC9C,uEAAuE;IACvE,QAAQ,CAAC,gBAAgB,EAAE,sBAAsB,CAAC;IAClD,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC;;;;OAIG;IACH,SAAkB,KAAK,EAAE,iBAAiB,CAAC;IAE3C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;gBAEnC,MAAM,EAAE,aAAa;IA4BjC;;;;;;;;;OASG;IACH,OAAO,CAAC,6BAA6B;IAoBrC;;;;;;;;;OASG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAGlD"}
+{"version":3,"file":"stigmer.d.ts","sourceRoot":"","sources":["../src/stigmer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,uDAAuD,CAAC;AAIxF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,OAAQ,SAAQ,eAAe;IAC1C;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;;;;;;;OAQG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,GAAG,SAAS,CAAC;IAEpD;;;;;;;;;OASG;IACH,QAAQ,CAAC,sBAAsB,EAAE,eAAe,GAAG,SAAS,CAAC;IAE7D,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,yDAAyD;IACzD,QAAQ,CAAC,cAAc,EAAE,oBAAoB,CAAC;IAC9C,uEAAuE;IACvE,QAAQ,CAAC,gBAAgB,EAAE,sBAAsB,CAAC;IAClD,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC;;;;OAIG;IACH,SAAkB,KAAK,EAAE,iBAAiB,CAAC;IAC3C;;;;OAIG;IACH,SAAkB,MAAM,EAAE,kBAAkB,CAAC;IAE7C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;gBAEnC,MAAM,EAAE,aAAa;IA6BjC;;;;;;;;;OASG;IACH,OAAO,CAAC,6BAA6B;IAuBrC;;;;;;;;;OASG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAGlD"}

package/stigmer.js

@@ -7,6 +7,7 @@ import { ManifestClient } from "./manifest/index.js";
 import { PlatformClient } from "./platform.js";
 import { ProviderStandingClient } from "./provider-standing.js";
 import { SearchClient } from "./search.js";
+import { RoutedPluginClient } from "./plugin.js";
 import { RoutedSkillClient } from "./skill.js";
 import { createStigmerTransport } from "./transport.js";
 import { validateConfig, } from "./config.js";
@@ -82,6 +83,12 @@ export class Stigmer extends GeneratedClient {
      * `stigmer.skill.push` simply works for any valid skill size.
      */
     skill;
+    /**
+     * Plugin operations, with `push` routed by archive size over the same
+     * transfer lane — shadows the inherited generated client so
+     * `stigmer.plugin.push` simply works for any valid archive size.
+     */
+    plugin;
     _tokenProvider;
     constructor(config) {
         validateConfig(config);
@@ -92,7 +99,7 @@ export class Stigmer extends GeneratedClient {
         this.defaultExecutionTarget = toExecutionTarget(config.executionTarget);
         this._tokenProvider = config.apiKey
             ? () => config.apiKey
-            : config.getAccessToken ?? (() => null);
+            : (config.getAccessToken ?? (() => null));
         this.activity = new ActivityClient(transport);
         this.billing = new BillingClient(transport);
         this.cursorAccounts = new CursorAccountsClient(transport);
@@ -102,6 +109,7 @@ export class Stigmer extends GeneratedClient {
         this.github = new GitHubClient(transport);
         this.manifest = new ManifestClient(transport);
         this.skill = new RoutedSkillClient(transport, config.fetch);
+        this.plugin = new RoutedPluginClient(transport, config.fetch);
         if (this.defaultExecutionTarget != null) {
             this._applyExecutionTargetDefaults();
         }
@@ -124,7 +132,10 @@ export class Stigmer extends GeneratedClient {
         this.session.create = (input) => origSessionCreate(applySessionDefault(input, target));
         this.session.apply = (input) => origSessionApply(applySessionDefault(input, target));
         this.agentExecution.create = (input) => origExecutionCreate(input.sessionSpec
-            ? { ...input, sessionSpec: applySessionDefault(input.sessionSpec, target) }
+            ? {
+                ...input,
+                sessionSpec: applySessionDefault(input.sessionSpec, target),
+            }
             : input);
     }
     /**

package/stigmer.js.map

@@ -1 +1 @@
-{"version":3,"file":"stigmer.js","sourceRoot":"","sources":["../src/stigmer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"stigmer.js","sourceRoot":"","sources":["../src/stigmer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EACL,cAAc,GAGf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,uDAAuD,CAAC;AAIxF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,OAAO,OAAQ,SAAQ,eAAe;IAC1C;;;;;;OAMG;IACM,OAAO,CAAS;IAEzB;;;;;;;;OAQG;IACM,KAAK,CAAsC;IAEpD;;;;;;;;;OASG;IACM,sBAAsB,CAA8B;IAEpD,QAAQ,CAAiB;IACzB,OAAO,CAAgB;IAChC,yDAAyD;IAChD,cAAc,CAAuB;IAC9C,uEAAuE;IAC9D,gBAAgB,CAAyB;IACzC,QAAQ,CAAiB;IACzB,MAAM,CAAe;IACrB,MAAM,CAAe;IACrB,QAAQ,CAAiB;IAClC;;;;OAIG;IACe,KAAK,CAAoB;IAC3C;;;;OAIG;IACe,MAAM,CAAqB;IAE5B,cAAc,CAAgB;IAE/C,YAAY,MAAqB;QAC/B,cAAc,CAAC,MAAM,CAAC,CAAC;QAEvB,MAAM,SAAS,GAAG,MAAM,CAAC,eAAe,IAAI,sBAAsB,CAAC,MAAM,CAAC,CAAC;QAC3E,KAAK,CAAC,SAAS,CAAC,CAAC;QAEjB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,sBAAsB,GAAG,iBAAiB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QACxE,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,MAAM;YACjC,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAO;YACtB,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QAE5C,IAAI,CAAC,QAAQ,GAAG,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,CAAC,OAAO,GAAG,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC,cAAc,GAAG,IAAI,oBAAoB,CAAC,SAAS,CAAC,CAAC;QAC1D,IAAI,CAAC,gBAAgB,GAAG,IAAI,sBAAsB,CAAC,SAAS,CAAC,CAAC;QAC9D,IAAI,CAAC,QAAQ,GAAG,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,CAAC,QAAQ,GAAG,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK,GAAG,IAAI,iBAAiB,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5D,IAAI,CAAC,MAAM,GAAG,IAAI,kBAAkB,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAE9D,IAAI,IAAI,CAAC,sBAAsB,IAAI,IAAI,EAAE,CAAC;YACxC,IAAI,CAAC,6BAA6B,EAAE,CAAC;QACvC,CAAC;IACH,CAAC;IAED;;;;;;;;;OASG;IACK,6BAA6B;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,sBAAuB,CAAC;QAC5C,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjE,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/D,MAAM,mBAAmB,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CACzD,IAAI,CAAC,cAAc,CACpB,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,KAAK,EAAE,EAAE,CAC9B,iBAAiB,CAAC,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,CAAC,KAAK,EAAE,EAAE,CAC7B,gBAAgB,CAAC,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;QACvD,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,KAAK,EAAE,EAAE,CACrC,mBAAmB,CACjB,KAAK,CAAC,WAAW;YACf,CAAC,CAAC;gBACE,GAAG,KAAK;gBACR,WAAW,EAAE,mBAAmB,CAAC,KAAK,CAAC,WAAW,EAAE,MAAM,CAAC;aAC5D;YACH,CAAC,CAAC,KAAK,CACV,CAAC;IACN,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,iBAAiB;QACrB,OAAO,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;IACrC,CAAC;CACF;AAED,SAAS,iBAAiB,CACxB,GAA0B;IAE1B,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,OAAO;YACV,OAAO,eAAe,CAAC,KAAK,CAAC;QAC/B,KAAK,OAAO;YACV,OAAO,eAAe,CAAC,KAAK,CAAC;QAC/B;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAC1B,KAAQ,EACR,MAAuB;IAEvB,IACE,KAAK,CAAC,eAAe,IAAI,IAAI;QAC7B,KAAK,CAAC,eAAe,KAAK,eAAe,CAAC,WAAW,EACrD,CAAC;QACD,OAAO,EAAE,GAAG,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC;IAC/C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}