antpath 0.10.14 → 0.11.0

package/dist/_shared/telemetry.d.ts

@@ -14,7 +14,7 @@
  *      defensive redaction pass before sending. Callers are also
  *      expected to keep `context` shallow + non-sensitive.
  *   3. **Default on, env-configurable opt-out.** Default endpoint:
- *      `https://www.antpath.ai/api/telemetry`. Override with
+ *      `https://api.antpath.ai/api/telemetry`. Override with
  *      `ANTPATH_TELEMETRY_ENDPOINT`; disable with
  *      `ANTPATH_TELEMETRY_DISABLED=1`.
  *   4. **Bounded payload.** Stringified payload capped at 8 KiB; the
@@ -25,7 +25,7 @@
  * Default sink. Co-located with the SDK's default API base so we
  * don't introduce a second canonical host to keep in sync.
  */
-export declare const DEFAULT_TELEMETRY_ENDPOINT = "https://www.antpath.ai/api/telemetry";
+export declare const DEFAULT_TELEMETRY_ENDPOINT = "https://api.antpath.ai/api/telemetry";
 /**
  * Hard cap on the JSON body sent to the sink. Anything above this is
  * either a coding mistake (huge context object) or an attempt to

package/dist/_shared/telemetry.js

@@ -14,7 +14,7 @@
  *      defensive redaction pass before sending. Callers are also
  *      expected to keep `context` shallow + non-sensitive.
  *   3. **Default on, env-configurable opt-out.** Default endpoint:
- *      `https://www.antpath.ai/api/telemetry`. Override with
+ *      `https://api.antpath.ai/api/telemetry`. Override with
  *      `ANTPATH_TELEMETRY_ENDPOINT`; disable with
  *      `ANTPATH_TELEMETRY_DISABLED=1`.
  *   4. **Bounded payload.** Stringified payload capped at 8 KiB; the
@@ -25,7 +25,7 @@
  * Default sink. Co-located with the SDK's default API base so we
  * don't introduce a second canonical host to keep in sync.
  */
-export const DEFAULT_TELEMETRY_ENDPOINT = "https://www.antpath.ai/api/telemetry";
+export const DEFAULT_TELEMETRY_ENDPOINT = "https://api.antpath.ai/api/telemetry";
 /**
  * Hard cap on the JSON body sent to the sink. Anything above this is
  * either a coding mistake (huge context object) or an attempt to

package/dist/_shared/template/index.d.ts

@@ -1,4 +1,3 @@
 export type { CredentialRequirement, EnvironmentDefinition, McpServerDefinition, OutputDefinition, SkillDefinition, TemplateDefinition, TemplateVariableDefinition } from "./types.js";
 export { compileTemplate, type ResolvedMcpServer, type ResolvedTemplate } from "./compiler.js";
 export { defineTemplate, string, requiredStaticBearer, requiredOAuthAccessToken } from "./helpers.js";
-export { toPlatformSubmissionTemplate } from "./mapper.js";

package/dist/_shared/template/index.js

@@ -1,4 +1,3 @@
 export { compileTemplate } from "./compiler.js";
 export { defineTemplate, string, requiredStaticBearer, requiredOAuthAccessToken } from "./helpers.js";
-export { toPlatformSubmissionTemplate } from "./mapper.js";
 //# sourceMappingURL=index.js.map

package/dist/agents-md.d.ts

@@ -1,90 +1,48 @@
 import type { AgentsMdRef } from "./_shared/index.js";
 /**
- * The second of the three agent-context concepts (see
- * `references/agent-context-uploads.md`). An `AgentsMd` instance
- * carries the bytes of a single markdown file that antpath will
- * deliver to the agent as the **first user turn** of the session —
- * matching Claude Code's CLAUDE.md behaviour.
+ * AgentsMd — a single markdown file delivered to the agent as the
+ * first user turn of the session (matches Claude Code's CLAUDE.md
+ * behaviour).
  *
- * Three usage modes mirror `Skill`:
+ *   const rules = await AgentsMd.fromContent("# Be helpful", { name: "rules" });
+ *   await client.submitRun({ agentsMd: [rules], ... });
  *
- *   - **Workspace** — `AgentsMd.fromId("amd_…")`. Persistent, reused
- *     across runs.
- *   - **Workspace via explicit upload** —
- *     `await AgentsMd.fromContent("…", { name }).upload(client)`.
- *     Returns a workspace-backed instance; the original is consumed.
- *   - **Inline per-run** — `await AgentsMd.fromContent("…", { name })`
- *     passed directly to `submitRun({ agentsMd: [...] })`. The BFF
- *     ingests it as a per-run-artifact workspace file with an
- *     auto-suffixed name (mirrors `Skill`'s inline behaviour).
- *
- * The single canonical filename inside the zip is always `AGENTS.md`
- * so the canonical hash is a pure function of the markdown content —
- * dedup via `uploadIfChanged` works on bytes alone.
+ * `client.submitRun` materializes the bytes to R2 (content-addressable,
+ * workspace-scoped) before the run lands. The workspace pre-upload
+ * concept is gone — R2 dedup at submit time handles the "I already
+ * uploaded these bytes" case automatically.
  */
 export declare class AgentsMd {
     #private;
-    constructor(ref: AgentsMdRef, content?: string, contentHash?: string);
-    get ref(): AgentsMdRef;
-    /** True for `AgentsMd.fromId(...)` and instances returned by `.upload(...)`. */
-    get isWorkspace(): boolean;
-    /** True only while the inline AgentsMd still carries bytes and has not been consumed. */
-    get isUnstaged(): boolean;
+    constructor(ref: AgentsMdRef | DraftAgentsMdRef, zipBytes?: Uint8Array);
+    get ref(): AgentsMdRef | DraftAgentsMdRef;
+    get isDraft(): boolean;
     get isConsumed(): boolean;
     /**
-     * Reference an existing workspace `amd_*` row. Does NOT validate
-     * existence — that check happens on the next `submitRun`, where the
-     * BFF rejects unknown / soft-deleted ids before inserting the run.
-     */
-    static fromId(id: string): AgentsMd;
-    /**
-     * Build an inline AgentsMd from a markdown string. `name` becomes
-     * the workspace name (per-run-artifact auto-suffixes it at ingest).
+     * Build a draft AgentsMd from a markdown string. The SDK zips the
+     * content under the canonical filename `AGENTS.md` so the hash is a
+     * pure function of the markdown text.
      */
     static fromContent(content: string, args: {
         readonly name: string;
     }): Promise<AgentsMd>;
-    /**
-     * Read a local markdown file and build an inline AgentsMd. Path
-     * may point at AGENTS.md, CLAUDE.md, or any markdown file — the
-     * filename inside the zip is always normalised to AGENTS.md so
-     * the canonical hash is pure.
-     */
-    static fromPath(path: string, args?: {
-        readonly name?: string;
+    /** Node-only convenience: read a markdown file from disk. */
+    static fromPath(path: string, args: {
+        readonly name: string;
     }): Promise<AgentsMd>;
     /**
-     * Persist this inline AgentsMd as a workspace row and return a new
-     * workspace-backed instance. The original is marked consumed.
-     */
-    upload(client: AgentsMdUploader): Promise<AgentsMd>;
-    /**
-     * Internal: yield the inline content + hash so client.submitRun
-     * can build the `agentsmd:<slot>` multipart part. Not part of the
-     * public API.
+     * Internal: yield the draft's zipped bytes + metadata so
+     * `client.submitRun` can upload to R2.
      */
-    _takeUnstagedContent(): {
+    _takeDraftBundle(): {
         name: string;
-        content: string;
         contentHash: string;
+        bytes: Uint8Array;
     } | undefined;
     toJSON(): AgentsMdRef;
 }
-export interface AgentsMdRecord {
-    readonly id: string;
+export interface DraftAgentsMdRef {
+    readonly kind: "draft";
     readonly name: string;
-    readonly hash: string | null;
-    readonly sizeBytes: number | null;
-}
-export interface AgentsMdUploader {
-    readonly _uploadAgentsMd?: (args: {
-        readonly name: string;
-        readonly content: string;
-    }) => Promise<AgentsMdRecord>;
-    readonly agentsMd?: {
-        readonly _uploadAgentsMd?: (args: {
-            readonly name: string;
-            readonly content: string;
-        }) => Promise<AgentsMdRecord>;
-    };
+    readonly contentHash: string;
 }

package/dist/agents-md.js

@@ -2,69 +2,39 @@ import { readFile } from "node:fs/promises";
 import { hashSkillBundle } from "./bundle.js";
 import { strToU8, zipSync } from "fflate";
 /**
- * The second of the three agent-context concepts (see
- * `references/agent-context-uploads.md`). An `AgentsMd` instance
- * carries the bytes of a single markdown file that antpath will
- * deliver to the agent as the **first user turn** of the session —
- * matching Claude Code's CLAUDE.md behaviour.
+ * AgentsMd — a single markdown file delivered to the agent as the
+ * first user turn of the session (matches Claude Code's CLAUDE.md
+ * behaviour).
  *
- * Three usage modes mirror `Skill`:
+ *   const rules = await AgentsMd.fromContent("# Be helpful", { name: "rules" });
+ *   await client.submitRun({ agentsMd: [rules], ... });
  *
- *   - **Workspace** — `AgentsMd.fromId("amd_…")`. Persistent, reused
- *     across runs.
- *   - **Workspace via explicit upload** —
- *     `await AgentsMd.fromContent("…", { name }).upload(client)`.
- *     Returns a workspace-backed instance; the original is consumed.
- *   - **Inline per-run** — `await AgentsMd.fromContent("…", { name })`
- *     passed directly to `submitRun({ agentsMd: [...] })`. The BFF
- *     ingests it as a per-run-artifact workspace file with an
- *     auto-suffixed name (mirrors `Skill`'s inline behaviour).
- *
- * The single canonical filename inside the zip is always `AGENTS.md`
- * so the canonical hash is a pure function of the markdown content —
- * dedup via `uploadIfChanged` works on bytes alone.
+ * `client.submitRun` materializes the bytes to R2 (content-addressable,
+ * workspace-scoped) before the run lands. The workspace pre-upload
+ * concept is gone — R2 dedup at submit time handles the "I already
+ * uploaded these bytes" case automatically.
  */
 export class AgentsMd {
     #ref;
-    #content;
-    #contentHash;
+    #zipBytes;
     #consumed = false;
-    constructor(ref, content, contentHash) {
+    constructor(ref, zipBytes) {
         this.#ref = ref;
-        this.#content = content;
-        this.#contentHash = contentHash;
+        this.#zipBytes = zipBytes;
     }
     get ref() {
         return this.#ref;
     }
-    /** True for `AgentsMd.fromId(...)` and instances returned by `.upload(...)`. */
-    get isWorkspace() {
-        return this.#ref.kind === "workspace_agentsmd";
-    }
-    /** True only while the inline AgentsMd still carries bytes and has not been consumed. */
-    get isUnstaged() {
-        return (this.#ref.kind === "transient_agentsmd" &&
-            this.#ref.slot === UNSTAGED_SLOT &&
-            !this.#consumed &&
-            this.#content !== undefined);
+    get isDraft() {
+        return this.#ref.kind === "draft" && !this.#consumed;
     }
     get isConsumed() {
         return this.#consumed;
     }
     /**
-     * Reference an existing workspace `amd_*` row. Does NOT validate
-     * existence — that check happens on the next `submitRun`, where the
-     * BFF rejects unknown / soft-deleted ids before inserting the run.
-     */
-    static fromId(id) {
-        if (typeof id !== "string" || id.length === 0) {
-            throw new Error("AgentsMd.fromId: id is required");
-        }
-        return new AgentsMd({ kind: "workspace_agentsmd", id });
-    }
-    /**
-     * Build an inline AgentsMd from a markdown string. `name` becomes
-     * the workspace name (per-run-artifact auto-suffixes it at ingest).
+     * Build a draft AgentsMd from a markdown string. The SDK zips the
+     * content under the canonical filename `AGENTS.md` so the hash is a
+     * pure function of the markdown text.
      */
     static async fromContent(content, args) {
         if (typeof content !== "string" || content.length === 0) {
@@ -75,97 +45,41 @@ export class AgentsMd {
         }
         const zip = zipSync({ "AGENTS.md": [strToU8(content), { mtime: ZIP_EPOCH }] }, { level: 6 });
         const contentHash = await hashSkillBundle(zip);
-        const ref = {
-            kind: "transient_agentsmd",
-            slot: UNSTAGED_SLOT,
-            name: args.name,
-            contentHash
-        };
-        return new AgentsMd(ref, content, contentHash);
+        const ref = { kind: "draft", name: args.name, contentHash };
+        return new AgentsMd(ref, zip);
     }
-    /**
-     * Read a local markdown file and build an inline AgentsMd. Path
-     * may point at AGENTS.md, CLAUDE.md, or any markdown file — the
-     * filename inside the zip is always normalised to AGENTS.md so
-     * the canonical hash is pure.
-     */
+    /** Node-only convenience: read a markdown file from disk. */
     static async fromPath(path, args) {
-        const buffer = await readFile(path, "utf8");
-        const inferredName = args?.name ?? inferNameFromPath(path);
-        return AgentsMd.fromContent(buffer, { name: inferredName });
+        const content = await readFile(path, "utf8");
+        return AgentsMd.fromContent(content, args);
     }
     /**
-     * Persist this inline AgentsMd as a workspace row and return a new
-     * workspace-backed instance. The original is marked consumed.
+     * Internal: yield the draft's zipped bytes + metadata so
+     * `client.submitRun` can upload to R2.
      */
-    async upload(client) {
+    _takeDraftBundle() {
         if (this.#consumed) {
-            throw new Error(consumedMessage());
+            throw new Error("AgentsMd: cannot reuse a consumed AgentsMd in submitRun. Build a fresh one " +
+                "via AgentsMd.fromContent(...) / AgentsMd.fromPath(...) per submitRun call.");
         }
-        if (this.#ref.kind !== "transient_agentsmd" || this.#content === undefined) {
-            throw new Error("AgentsMd.upload: only inline (unstaged) instances can be uploaded");
-        }
-        const uploader = resolveUploader(client);
-        const record = await uploader({ name: this.#ref.name, content: this.#content });
-        this.#consumed = true;
-        return new AgentsMd({ kind: "workspace_agentsmd", id: record.id });
-    }
-    /**
-     * Internal: yield the inline content + hash so client.submitRun
-     * can build the `agentsmd:<slot>` multipart part. Not part of the
-     * public API.
-     */
-    _takeUnstagedContent() {
-        if (this.#consumed) {
-            throw new Error(consumedMessage());
-        }
-        if (!this.isUnstaged)
-            return undefined;
-        if (this.#ref.kind !== "transient_agentsmd" || this.#content === undefined || this.#contentHash === undefined) {
+        if (this.#ref.kind !== "draft" || !this.#zipBytes) {
             return undefined;
         }
+        this.#consumed = true;
         return {
             name: this.#ref.name,
-            content: this.#content,
-            contentHash: this.#contentHash
+            contentHash: this.#ref.contentHash,
+            bytes: this.#zipBytes
         };
     }
     toJSON() {
-        if (this.#consumed)
-            throw new Error(consumedMessage());
-        if (this.isUnstaged) {
-            throw new Error("Cannot JSON-serialise an inline AgentsMd — the content is not in the JSON. " +
-                "Persist via agentsMd.upload(client) and serialise the returned workspace instance, " +
-                "or pass the inline AgentsMd directly to submitRun without serialising.");
+        if (this.#ref.kind === "draft") {
+            throw new Error("AgentsMd: draft AgentsMd cannot be JSON-serialised — it only becomes a wire " +
+                "ref when client.submitRun uploads the bytes to R2.");
         }
         return this.#ref;
     }
 }
-const UNSTAGED_SLOT = "(unstaged)";
-const ZIP_EPOCH = new Date(Date.UTC(1980, 0, 1));
 const WORKSPACE_NAME_RE = /^[a-z0-9][a-z0-9-]{0,62}[a-z0-9]$/;
-function resolveUploader(client) {
-    const direct = client._uploadAgentsMd;
-    if (typeof direct === "function")
-        return direct.bind(client);
-    const nested = client.agentsMd?._uploadAgentsMd;
-    if (typeof nested === "function")
-        return nested.bind(client.agentsMd);
-    throw new Error("AgentsMd.upload: client argument does not expose an upload entry point — " +
-        "pass the AntpathClient instance or its `client.agentsMd`");
-}
-function consumedMessage() {
-    return ("this AgentsMd was already uploaded via agentsMd.upload(client); use the returned instance " +
-        "or AgentsMd.fromId(record.id) for subsequent runs");
-}
-function inferNameFromPath(path) {
-    // Use the basename minus extension, lowercased and normalised to
-    // match the workspace-name regex. Falls back to a timestamp slug.
-    const base = path.replace(/\\/g, "/").split("/").at(-1) ?? "";
-    const stem = base.replace(/\.[^.]+$/, "").toLowerCase();
-    const slug = stem.replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
-    if (slug && WORKSPACE_NAME_RE.test(slug))
-        return slug;
-    return `agentsmd-${Date.now().toString(36)}`;
-}
+const ZIP_EPOCH = new Date(Date.UTC(1980, 0, 1));
 //# sourceMappingURL=agents-md.js.map

package/dist/agents-md.js.map

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

package/dist/asset-upload.d.ts

@@ -83,3 +83,37 @@ export interface UploadChunkedArgs {
  * `assetId`, `kind`, etc.).
  */
 export declare function uploadChunked(args: UploadChunkedArgs): Promise<void>;
+/**
+ * Subset of `HttpClient` needed by the asset uploader. Defined as a
+ * structural type so tests can supply a thin stub without dragging in
+ * the full client.
+ */
+export interface AssetsHttpClient {
+    request<T>(path: string, init?: RequestInit, query?: Record<string, string>): Promise<T>;
+}
+export interface UploadAssetToR2Args {
+    readonly http: AssetsHttpClient;
+    readonly bytes: Uint8Array;
+    /** `sha256:<hex>` — the canonical content hash declared on the wire. */
+    readonly hash: string;
+    readonly contentType?: string;
+}
+export interface UploadedR2Asset {
+    readonly path: string;
+    readonly hash: string;
+    readonly sizeBytes: number;
+    /** true if R2 already had identical bytes under this hash (dedup hit). */
+    readonly exists: boolean;
+}
+/**
+ * Upload `bytes` to the Worker's content-addressable R2 endpoint. The
+ * Worker scopes the key under the calling workspace (derived from the
+ * API token) so the returned `path` is `assets/<wsId>/<hash>` — safe
+ * to embed in a kind:"r2" submission ref.
+ *
+ * Verifies the advisory hash matches the bytes BEFORE sending so a
+ * mismatch fails fast on the client. The Worker re-verifies on
+ * receipt; a mismatch there is a 400 with code "hash_mismatch" that
+ * surfaces as an `AntpathApiError`.
+ */
+export declare function uploadAssetToR2(args: UploadAssetToR2Args): Promise<UploadedR2Asset>;

package/dist/asset-upload.js

@@ -121,4 +121,38 @@ function bufferToHex(buffer) {
     }
     return out;
 }
+/**
+ * Upload `bytes` to the Worker's content-addressable R2 endpoint. The
+ * Worker scopes the key under the calling workspace (derived from the
+ * API token) so the returned `path` is `assets/<wsId>/<hash>` — safe
+ * to embed in a kind:"r2" submission ref.
+ *
+ * Verifies the advisory hash matches the bytes BEFORE sending so a
+ * mismatch fails fast on the client. The Worker re-verifies on
+ * receipt; a mismatch there is a 400 with code "hash_mismatch" that
+ * surfaces as an `AntpathApiError`.
+ */
+export async function uploadAssetToR2(args) {
+    const expected = args.hash.startsWith("sha256:") ? args.hash.slice("sha256:".length) : args.hash;
+    const actual = await computeSha256Hex(args.bytes);
+    if (actual !== expected) {
+        throw new Error(`uploadAssetToR2: client-side hash mismatch — computed sha256:${actual} ` +
+            `but caller declared ${args.hash}. Aborting to avoid uploading corrupted data.`);
+    }
+    const body = await args.http.request("/assets/upload", {
+        method: "POST",
+        headers: {
+            "content-type": args.contentType ?? "application/zip",
+            "content-length": String(args.bytes.byteLength),
+            "x-asset-hash": `sha256:${actual}`
+        },
+        body: args.bytes
+    });
+    return {
+        path: body.path,
+        hash: body.hash,
+        sizeBytes: body.sizeBytes,
+        exists: body.exists
+    };
+}
 //# sourceMappingURL=asset-upload.js.map

package/dist/asset-upload.js.map

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

package/dist/blueprint.d.ts

@@ -1,4 +1,4 @@
-import type { JsonValue, PlatformCleanupPolicy, PlatformTemplateEnvironment } from "./_shared/index.js";
+import type { JsonValue, PlatformCleanupPolicy, PlatformEnvironment } from "./_shared/index.js";
 import type { McpServer } from "./mcp-server.js";
 import type { ProxyEndpoint } from "./proxy-endpoint.js";
 import type { Skill } from "./skill.js";
@@ -14,7 +14,7 @@ import type { Skill } from "./skill.js";
  * "idempotencyKey" | "signal">` so it can be embedded as a reusable,
  * credential-free fragment via `defineRun`.
  *
- * Note: Blueprints can legally contain unstaged transient Skills built
+ * Note: Blueprints can legally contain unstaged inline Skills built
  * via `Skill.fromFiles` / `Skill.fromPath`. The transient bytes ride
  * via multipart at `submitRun` time and never persist anywhere —
  * exactly the right shape for a per-run, throwaway skill. Passing a
@@ -27,7 +27,7 @@ export interface Blueprint {
     readonly prompt: string | readonly string[];
     readonly skills?: readonly Skill[];
     readonly mcpServers?: readonly McpServer[];
-    readonly environment?: PlatformTemplateEnvironment;
+    readonly environment?: PlatformEnvironment;
     readonly cleanup?: PlatformCleanupPolicy;
     readonly proxyEndpoints?: readonly ProxyEndpoint[];
     readonly metadata?: Record<string, JsonValue>;

package/dist/bundle.d.ts

@@ -10,7 +10,7 @@
  *
  * For transient (per-run) skills the SDK does compute an advisory
  * `sha256` of the canonicalised zip via `hashSkillBundle()` — it travels
- * in the `TransientSkillRef.contentHash` field, is used for retry
+ * in the `InlineSkillRef.contentHash` field, is used for retry
  * de-dup and janitor reconciliation, and is recomputed server-side
  * (mismatch → submission rejected).
  */
@@ -25,7 +25,7 @@ export declare function bundleSkillFiles(files: SkillFiles): BundledSkill;
 /**
  * Compute `sha256:<hex>` of the given canonicalised zip bytes. Used by
  * `Skill.fromFiles` / `Skill.fromPath` to populate the
- * `TransientSkillRef.contentHash` field. The hash is advisory — the BFF
+ * `InlineSkillRef.contentHash` field. The hash is advisory — the BFF
  * recomputes server-side after re-canonicalising the zip; a mismatch is
  * rejected. Web-Crypto-only so the SDK works in Node, edge runtimes,
  * and browsers without polyfills.

package/dist/bundle.js

@@ -57,7 +57,7 @@ const ZIP_EPOCH = new Date(Date.UTC(1980, 0, 1));
 /**
  * Compute `sha256:<hex>` of the given canonicalised zip bytes. Used by
  * `Skill.fromFiles` / `Skill.fromPath` to populate the
- * `TransientSkillRef.contentHash` field. The hash is advisory — the BFF
+ * `InlineSkillRef.contentHash` field. The hash is advisory — the BFF
  * recomputes server-side after re-canonicalising the zip; a mismatch is
  * rejected. Web-Crypto-only so the SDK works in Node, edge runtimes,
  * and browsers without polyfills.