antpath 0.10.14 → 0.11.0

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQ/F,yBAAyB;AACzB,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAQpD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGhE,SAAS;AACT,OAAO,EACL,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,yBAAyB,EACzB,aAAa,EACb,aAAa,EACd,MAAM,iBAAiB,CAAC;AAEzB,yBAAyB;AACzB,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,wBAAwB,EACxB,2BAA2B,EAC3B,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AAmDzB,oBAAoB;AACpB,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,0BAA0B,EAC1B,sBAAsB,EACtB,yBAAyB,EACzB,WAAW,EACX,WAAW,EACX,aAAa,EACd,MAAM,iBAAiB,CAAC;AAEzB,mBAAmB;AACnB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQ/F,yBAAyB;AACzB,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAQpD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGhE,SAAS;AACT,OAAO,EACL,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,yBAAyB,EACzB,aAAa,EACb,aAAa,EACd,MAAM,iBAAiB,CAAC;AAEzB,yBAAyB;AACzB,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,wBAAwB,EACxB,2BAA2B,EAC3B,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AAmDzB,gEAAgE;AAChE,mEAAmE;AACnE,sDAAsD;AACtD,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,wBAAwB,EACxB,aAAa,EACb,aAAa,EACb,wBAAwB,EACxB,sBAAsB,EACtB,aAAa,EACd,MAAM,iBAAiB,CAAC;AAOzB,oBAAoB;AACpB,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,0BAA0B,EAC1B,sBAAsB,EACtB,yBAAyB,EACzB,WAAW,EACX,WAAW,EACX,aAAa,EACd,MAAM,iBAAiB,CAAC;AAEzB,mBAAmB;AACnB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/mcp-server.d.ts

@@ -1,4 +1,4 @@
-import type { McpServerRef, PlatformMcpServerSecret } from "./_shared/index.js";
+import { type McpServerRef, type PlatformMcpServerSecret, type RemoteMcpTransport } from "./_shared/index.js";
 /**
  * Wire shape for a workspace MCP server ref in `submission.mcpServers[]`.
  * The BFF resolves this to an inline `{name, url}` before the shared
@@ -35,6 +35,7 @@ export declare class McpServer {
     readonly kind: "inline" | "workspace";
     readonly name: string;
     readonly url: string;
+    readonly transport: RemoteMcpTransport | undefined;
     readonly id: string | undefined;
     readonly headers: Readonly<Record<string, string>> | undefined;
     /** Internal constructor. Use `McpServer.remote(...)` or `McpServer.fromId(...)`. */
@@ -43,12 +44,19 @@ export declare class McpServer {
         readonly id?: string;
         readonly name?: string;
         readonly url?: string;
+        readonly transport?: RemoteMcpTransport;
         readonly headers?: Readonly<Record<string, string>>;
     });
-    /** Inline remote MCP server reachable over HTTP(S) by URL. */
+    /**
+     * Inline remote MCP server reachable over HTTP(S) by URL. `transport`
+     * defaults to the runtime's choice when omitted; pass it explicitly
+     * to pin `"http"` (streamable) or `"sse"` (event-stream). Stdio is
+     * not supported — see {@link rejectStdioMcpShape}.
+     */
     static remote(args: {
         readonly name: string;
         readonly url: string;
+        readonly transport?: RemoteMcpTransport;
         readonly headers?: Readonly<Record<string, string>>;
     }): McpServer;
     /**

package/dist/mcp-server.js

@@ -1,3 +1,4 @@
+import { rejectStdioMcpShape } from "./_shared/index.js";
 const WORKSPACE_MCP_ID_PATTERN = /^mcp_[A-Za-z0-9_-]{8,128}$/;
 /**
  * Inline MCP server reference OR a workspace-persistent ref via
@@ -24,6 +25,7 @@ export class McpServer {
     kind;
     name;
     url;
+    transport;
     id;
     headers;
     /** Internal constructor. Use `McpServer.remote(...)` or `McpServer.fromId(...)`. */
@@ -31,6 +33,10 @@ export class McpServer {
         if (!args || typeof args !== "object") {
             throw new Error("McpServer: args is required");
         }
+        // Defence in depth: any stdio-shaped input that slips past the
+        // builder type (callers will reach in with `as never` to feed stdio
+        // shapes) is rejected with the canonical error.
+        rejectStdioMcpShape(args);
         if (args.kind === "workspace") {
             if (typeof args.id !== "string" || !WORKSPACE_MCP_ID_PATTERN.test(args.id)) {
                 throw new Error(`McpServer.fromId: id must match ${WORKSPACE_MCP_ID_PATTERN.source}`);
@@ -42,6 +48,7 @@ export class McpServer {
             // ref so callers can branch.
             this.name = "";
             this.url = "";
+            this.transport = undefined;
             this.headers = undefined;
             return;
         }
@@ -55,9 +62,15 @@ export class McpServer {
         this.id = undefined;
         this.name = args.name;
         this.url = args.url;
+        this.transport = args.transport;
         this.headers = args.headers && Object.keys(args.headers).length > 0 ? { ...args.headers } : undefined;
     }
-    /** Inline remote MCP server reachable over HTTP(S) by URL. */
+    /**
+     * Inline remote MCP server reachable over HTTP(S) by URL. `transport`
+     * defaults to the runtime's choice when omitted; pass it explicitly
+     * to pin `"http"` (streamable) or `"sse"` (event-stream). Stdio is
+     * not supported — see {@link rejectStdioMcpShape}.
+     */
     static remote(args) {
         return new McpServer({ kind: "inline", ...args });
     }
@@ -75,7 +88,9 @@ export class McpServer {
         if (this.kind === "workspace") {
             return { kind: "workspace", id: this.id };
         }
-        return { name: this.name, url: this.url };
+        return this.transport
+            ? { name: this.name, transport: this.transport, url: this.url }
+            : { name: this.name, url: this.url };
     }
     /**
      * Wire shape for the `secrets.mcpServers` entry, or `undefined`

package/dist/mcp-server.js.map

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

package/dist/skill.d.ts

@@ -1,95 +1,46 @@
-import { type ProviderSkillRef, type Skill as SkillRecord, type SkillRef } from "./_shared/index.js";
+import { type ProviderSkillRef, type SkillRef } from "./_shared/index.js";
 import { type SkillFiles } from "./bundle.js";
 /**
- * One `Skill` class, one mental model, three usage modes:
- *
- *   - **Workspace** — uploaded to the antpath platform and reused across
- *     runs.
- *     ```ts
- *     const persisted = await Skill.fromFiles({ name, files }).upload(client);
- *     // or
- *     const ref = Skill.fromId("skl_abc123");
- *     ```
+ * One `Skill` class, two usage modes:
  *
  *   - **Provider built-in** — references a provider-side skill (e.g.
  *     Anthropic's `pdf` / `xlsx` / `docx` / `pptx` prebuilt Agent
- *     Skills). Not uploaded to your workspace.
+ *     Skills). Not uploaded.
  *     ```ts
  *     const pdf = Skill.provider({ vendor: "anthropic", skillId: "pdf" });
  *     ```
- *     Note: Anthropic web search is a Messages-API *tool*
- *     (`{ type: "web_search_…" }`), not an Agent Skill — `Skill.provider`
- *     does not enable it.
  *
- *   - **Transient (per-run)** — built from local files, never persisted.
- *     The bytes ride alongside `submitRun` as a multipart part and the
- *     BFF tears them down at run terminal.
+ *   - **Local bytes** — built from local files. `client.submitRun`
+ *     materializes the bytes to R2 (content-addressable, workspace-
+ *     scoped) before the run lands; the wire ref becomes `kind:"r2"`.
  *     ```ts
  *     const rules = await Skill.fromFiles({ name: "rules", files: {...} });
  *     await client.submitRun({ skills: [rules], ... });
  *     ```
  *
- * ## Lifecycle of an unstaged transient Skill
- *
- * After `Skill.fromFiles(...)` returns, the Skill is "unstaged transient":
- *
- *   1. Passing it to `submitRun` uploads the bytes for that one run only
- *      and assigns a positional slot id (`transient-0`, `transient-1`, …).
- *      The same instance may be passed to multiple `submitRun` calls
- *      until it is consumed by `.upload(...)`.
- *
- *   2. Calling `await skill.upload(client)` persists the bundle to the
- *      workspace skill store and returns a **new** `Skill` instance
- *      whose `.ref.kind === "workspace"`. The **original** is marked
- *      **consumed**:
- *      - any further use in `submitRun` throws a clear validation error,
- *      - `.upload(...)` on the consumed instance throws,
- *      - `JSON.stringify` / `toJSON()` on the consumed instance throws.
- *
- *      Use the returned (workspace) Skill from then on. The consumed
- *      reference exists only to surface the mistake loudly the first
- *      time the user re-uses it; it never silently re-uploads as
- *      transient.
- *
- * Unstaged transient Skills do NOT round-trip through JSON (the bytes
- * cannot be serialised back). `toJSON()` throws in that state too —
- * persist via `.upload(client)` first, or pass the unstaged Skill
- * directly to `submitRun`.
- *
- * The Skill class is the only public way to build a transient bundle;
- * the SDK never accepts a raw `TransientSkillRef` object from user code.
+ * The workspace pre-upload concept is gone — R2's content-addressable
+ * dedup at submit time makes the same bytes a no-op upload on subsequent
+ * runs. There is no `Skill.fromId(...)` and no `.upload(client)`.
  */
 export declare class Skill {
     #private;
-    /** Workspace skill record returned by the BFF (only set for workspace-uploaded skills). */
-    readonly record: SkillRecord | undefined;
     /**
-     * Internal constructor. Use `Skill.fromId`, `Skill.provider`,
-     * `Skill.fromFiles`, or `Skill.fromPath` to create instances.
+     * Internal constructor. Use `Skill.provider`, `Skill.fromFiles`, or
+     * `Skill.fromPath` to create instances.
      */
-    constructor(ref: SkillRef, record?: SkillRecord, transientBytes?: Uint8Array);
+    constructor(ref: SkillRef | DraftSkillRef, inlineBytes?: Uint8Array);
     /**
-     * The wire-level reference. For workspace and provider skills this is
-     * stable. For unstaged transient skills it carries the placeholder
-     * `slot: "(unstaged)"` — `submitRun` rewrites the slot to a real
-     * positional id (`transient-0`, …) before sending.
-     *
-     * For consumed Skills, the getter still returns the original
-     * transient ref so error messages can be precise — but using a
-     * consumed Skill in any submit/serialise path throws.
+     * The wire-level reference. Returns the SDK-private draft shape for
+     * un-materialized skills (kind:"draft", with name + contentHash).
+     * `client.submitRun` walks these and uploads to R2 before the run
+     * lands.
      */
-    get ref(): SkillRef;
-    /**
-     * Reference an existing workspace skill by its id (e.g. `skl_abc123`).
-     * Does NOT validate the skill exists — that check happens on the next
-     * `submitRun`, where the BFF rejects unknown / soft-deleted ids before
-     * inserting the run row.
-     */
-    static fromId(id: string): Skill;
+    get ref(): SkillRef | DraftSkillRef;
+    /** True for local-bytes Skills that haven't been uploaded yet. */
+    get isDraft(): boolean;
+    get isConsumed(): boolean;
     /**
-     * Reference a provider built-in skill. The vendor decides what the
-     * `skillId` and `version` mean; the SDK only forwards the values
-     * verbatim to the platform.
+     * Reference a provider built-in skill (e.g. Anthropic Skills).
      */
     static provider(args: {
         readonly vendor: ProviderSkillRef["vendor"];
@@ -97,168 +48,47 @@ export declare class Skill {
         readonly version?: string;
     }): Skill;
     /**
-     * Build an unstaged transient Skill from an inline files map. The SDK
-     * validates basic safety (no path traversal, size caps, has
-     * `SKILL.md`), deterministically zips the bundle, and computes the
-     * `sha256:<hex>` content hash that travels in the wire ref.
-     *
-     * The returned Skill carries the bytes privately. Pass it to
-     * `submitRun` for transient (per-run) use, or call `.upload(client)`
-     * to persist it as a workspace skill.
+     * Build a draft Skill from an inline files map. The SDK validates
+     * basic safety (no path traversal, size caps, has `SKILL.md`),
+     * deterministically zips the bundle, and computes the
+     * `sha256:<hex>` content hash. `client.submitRun` materializes
+     * these to R2 before the run lands.
      */
     static fromFiles(args: {
         readonly name: string;
         readonly files: SkillFiles;
     }): Promise<Skill>;
     /**
-     * Read a local directory and build an unstaged transient Skill.
-     * Symlinks and non-regular files are skipped. Node-only.
-     *
-     * The returned Skill behaves identically to one built via
-     * `Skill.fromFiles` — pass it to `submitRun` for transient use, or
-     * call `.upload(client)` to persist as a workspace skill.
+     * Read a local directory and build a draft Skill. Symlinks and
+     * non-regular files are skipped. Node-only.
      */
     static fromPath(rootDir: string, args: {
         readonly name: string;
     }): Promise<Skill>;
     /**
-     * Persist this unstaged transient Skill as a workspace skill and
-     * return a new `Skill` instance backed by the resulting `skl_*`
-     * record. After `upload` resolves successfully, the original
-     * instance is marked **consumed** — any further use throws a clear
-     * validation error.
-     *
-     * Only unstaged transient Skills can be uploaded. Calling this on a
-     * workspace-ref Skill, a provider-ref Skill, or a previously
-     * consumed Skill throws.
+     * Internal: yield the draft's bytes + metadata so `client.submitRun`
+     * can upload to R2. After this returns, the Skill is marked consumed
+     * so a second submitRun call against the same instance throws
+     * (avoid silently re-uploading; explicit re-construction is the
+     * supported retry pattern).
      *
-     * Accepts either an `AntpathClient` (preferred) or its
-     * `SkillsClient` if the caller already has a handle to it.
+     * Returns undefined for non-draft (provider / already-materialized)
+     * Skills.
      */
-    upload(client: SkillUploader): Promise<Skill>;
-    /**
-     * Persist this unstaged transient Skill as a workspace skill **only
-     * if** an existing skill with the same `(name, contentHash)` is not
-     * already live.
-     *
-     * Flow:
-     *
-     *   1. Hash is already known from `Skill.fromFiles` / `fromPath`.
-     *   2. Call `client.skills.findByHash({ name, contentHash })`. If a
-     *      live row exists, mark this instance consumed and return a
-     *      new `Skill` backed by that record.
-     *   3. Otherwise call `upload(client)`.
-     *
-     * Returns either the existing or newly-created workspace Skill;
-     * callers do not need to branch.
-     *
-     * Only unstaged transient Skills can be `uploadIfChanged`. Calling
-     * this on a workspace-ref Skill, a provider-ref Skill, or a
-     * previously consumed Skill throws.
-     */
-    uploadIfChanged(client: SkillUploader & SkillLookup): Promise<Skill>;
-    /** True for `Skill.fromId(...)` and skills returned by `.upload(...)`. */
-    get isWorkspace(): boolean;
-    /** True for `Skill.provider(...)`. */
-    get isProvider(): boolean;
-    /** True for any transient Skill (unstaged or consumed). */
-    get isTransient(): boolean;
-    /**
-     * True only while the transient Skill still carries bytes and has
-     * not been consumed by `.upload(...)`. Unstaged Skills can be passed
-     * to `submitRun` or `.upload(client)`; consumed ones cannot.
-     */
-    get isUnstaged(): boolean;
-    /** True after a successful `.upload(...)` — using this instance further throws. */
-    get isConsumed(): boolean;
-    /**
-     * Internal: yield the unstaged transient bundle's payload so the
-     * client's `submitRun` can build a multipart part. Returns undefined
-     * for non-transient or consumed skills. Throws if the instance is
-     * marked consumed (a stronger signal than "no bytes").
-     *
-     * NOT part of the public API — the `_` prefix is a "do not call from
-     * user code" marker. Callers within the SDK pass the returned bytes
-     * into the multipart body once per `submitRun` invocation.
-     */
-    _takeUnstagedBundle(): {
+    _takeDraftBundle(): {
         name: string;
-        bytes: Uint8Array;
         contentHash: string;
+        bytes: Uint8Array;
     } | undefined;
-    /**
-     * JSON serialisation guard. Workspace and provider Skills serialise
-     * to their `ref`. Unstaged transient Skills throw — the bytes are not
-     * in the JSON, so a round-trip would silently drop them. Consumed
-     * Skills also throw, to surface the "you forgot to use the returned
-     * Skill from `.upload(...)`" mistake at the point it happens.
-     */
     toJSON(): SkillRef;
 }
 /**
- * Anything that can persist a skill bundle. Both `AntpathClient` and
- * the internal `SkillsClient` satisfy this shape — `Skill.upload`
- * accepts either, but the SDK consumer only ever sees the
- * `AntpathClient`-based path.
- */
-export interface SkillUploader {
-    readonly _uploadSkillBundle?: (args: {
-        readonly name: string;
-        readonly body: Uint8Array;
-    }) => Promise<SkillRecord>;
-    readonly skills?: {
-        readonly _uploadSkillBundle?: (args: {
-            readonly name: string;
-            readonly body: Uint8Array;
-        }) => Promise<SkillRecord>;
-    };
-    /**
-     * Optional chunked-upload entry point. Present on `AntpathClient`
-     * when the BFF supports `POST /api/assets/upload-init` and
-     * `POST /api/assets/finalize`. When absent, bundles > 6 MiB throw
-     * an informative error.
-     */
-    readonly _chunkedUpload?: ChunkedUploadClient;
-}
-/** Internal interface for the three-step TUS upload flow. */
-export interface ChunkedUploadClient {
-    readonly init: (args: {
-        readonly kind: "skill" | "file";
-        readonly name: string;
-        readonly sizeBytes: number;
-        readonly hash: string;
-    }) => Promise<{
-        readonly assetId: string;
-        readonly storagePath: string;
-        readonly tusUrl: string;
-        readonly tusToken: string;
-        readonly expiresAt: string;
-        readonly uploadHeaders: Readonly<Record<string, string>>;
-    }>;
-    readonly finalize: (args: {
-        readonly assetId: string;
-        readonly kind: "skill" | "file";
-        readonly hash: string;
-        readonly storagePath: string;
-    }) => Promise<void>;
-}
-/**
- * Anything that can look up an existing workspace skill by hash. Used
- * by `Skill.uploadIfChanged` — both `AntpathClient` (via
- * `.skills.findByHash`) and the internal `SkillsClient` satisfy this
- * shape. The lookup is optional so test doubles for `upload` need not
- * implement it; in that case `uploadIfChanged` simply falls back to
- * a plain `upload`.
+ * SDK-internal draft skill marker. Never reaches the wire; the
+ * materialize step inside `client.submitRun` converts these to
+ * `kind:"r2"` refs.
  */
-export interface SkillLookup {
-    readonly skills?: {
-        readonly findByHash?: (args: {
-            readonly name: string;
-            readonly contentHash: string;
-        }) => Promise<SkillRecord | null>;
-    };
-    readonly findByHash?: (args: {
-        readonly name: string;
-        readonly contentHash: string;
-    }) => Promise<SkillRecord | null>;
+export interface DraftSkillRef {
+    readonly kind: "draft";
+    readonly name: string;
+    readonly contentHash: string;
 }