antpath 0.4.2 → 0.6.2

package/dist/skill.d.ts

@@ -0,0 +1,59 @@
+import type { ProviderSkillRef, Skill as SkillRecord, SkillRef } from "./_shared/index.js";
+/**
+ * Workspace `Skill` and provider `Skill` are both modeled by ONE class with
+ * a discriminated wire shape under `.ref`. Keeping a single class means
+ * `submitRun({ skills: [...] })` accepts a uniform array; the SDK
+ * normalises every entry to its `ref` before sending the wire payload.
+ *
+ * Three workspace constructors:
+ *
+ *   - `Skill.fromId("skl_abc123")` — reference an existing workspace
+ *     skill without re-uploading. Useful for sharing a skill across many
+ *     `submitRun` calls or in a `defineRun` factory.
+ *   - `client.skills.upload({ name, files })` — inline files map (UTF-8
+ *     strings or `Uint8Array`); SDK zips and uploads.
+ *   - `client.skills.fromPath("./dir", { name })` — local directory; SDK
+ *     reads, zips, and uploads (Node only).
+ *
+ * One provider constructor:
+ *
+ *   - `Skill.provider({ vendor, skillId, version? })` — references a
+ *     provider built-in skill (e.g. Anthropic web-search). Provider
+ *     skills are NOT uploaded to your workspace and have no
+ *     soft-delete semantics.
+ *
+ * Instances are immutable. The wire `ref` is the only state and never
+ * carries credentials.
+ */
+export declare class Skill {
+    /** Workspace skill record returned by the BFF (only set for workspace-uploaded skills). */
+    readonly record: SkillRecord | undefined;
+    readonly ref: SkillRef;
+    /**
+     * Internal constructor. Use `Skill.fromId`, `Skill.provider`, or
+     * `client.skills.upload` / `client.skills.fromPath` to create
+     * instances.
+     */
+    constructor(ref: SkillRef, record?: SkillRecord);
+    /**
+     * 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;
+    /**
+     * 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.
+     */
+    static provider(args: {
+        readonly vendor: ProviderSkillRef["vendor"];
+        readonly skillId: string;
+        readonly version?: string;
+    }): Skill;
+    /** True for `Skill.fromId(...)` and skills returned by `client.skills.upload(...)`. */
+    get isWorkspace(): boolean;
+    /** True for `Skill.provider(...)`. */
+    get isProvider(): boolean;
+}

package/dist/skill.js

@@ -0,0 +1,82 @@
+/**
+ * Workspace `Skill` and provider `Skill` are both modeled by ONE class with
+ * a discriminated wire shape under `.ref`. Keeping a single class means
+ * `submitRun({ skills: [...] })` accepts a uniform array; the SDK
+ * normalises every entry to its `ref` before sending the wire payload.
+ *
+ * Three workspace constructors:
+ *
+ *   - `Skill.fromId("skl_abc123")` — reference an existing workspace
+ *     skill without re-uploading. Useful for sharing a skill across many
+ *     `submitRun` calls or in a `defineRun` factory.
+ *   - `client.skills.upload({ name, files })` — inline files map (UTF-8
+ *     strings or `Uint8Array`); SDK zips and uploads.
+ *   - `client.skills.fromPath("./dir", { name })` — local directory; SDK
+ *     reads, zips, and uploads (Node only).
+ *
+ * One provider constructor:
+ *
+ *   - `Skill.provider({ vendor, skillId, version? })` — references a
+ *     provider built-in skill (e.g. Anthropic web-search). Provider
+ *     skills are NOT uploaded to your workspace and have no
+ *     soft-delete semantics.
+ *
+ * Instances are immutable. The wire `ref` is the only state and never
+ * carries credentials.
+ */
+export class Skill {
+    /** Workspace skill record returned by the BFF (only set for workspace-uploaded skills). */
+    record;
+    ref;
+    /**
+     * Internal constructor. Use `Skill.fromId`, `Skill.provider`, or
+     * `client.skills.upload` / `client.skills.fromPath` to create
+     * instances.
+     */
+    constructor(ref, record) {
+        this.ref = ref;
+        this.record = record;
+    }
+    /**
+     * 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) {
+        if (typeof id !== "string" || !id) {
+            throw new Error("Skill.fromId: id is required");
+        }
+        const ref = { kind: "workspace", id };
+        return new Skill(ref);
+    }
+    /**
+     * 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.
+     */
+    static provider(args) {
+        if (!args || typeof args !== "object") {
+            throw new Error("Skill.provider: args is required");
+        }
+        if (typeof args.vendor !== "string" || !args.vendor) {
+            throw new Error("Skill.provider: vendor is required");
+        }
+        if (typeof args.skillId !== "string" || !args.skillId) {
+            throw new Error("Skill.provider: skillId is required");
+        }
+        const ref = args.version
+            ? { kind: "provider", vendor: args.vendor, skillId: args.skillId, version: args.version }
+            : { kind: "provider", vendor: args.vendor, skillId: args.skillId };
+        return new Skill(ref);
+    }
+    /** True for `Skill.fromId(...)` and skills returned by `client.skills.upload(...)`. */
+    get isWorkspace() {
+        return this.ref.kind === "workspace";
+    }
+    /** True for `Skill.provider(...)`. */
+    get isProvider() {
+        return this.ref.kind === "provider";
+    }
+}
+//# sourceMappingURL=skill.js.map

package/dist/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,OAAO,KAAK;IAChB,2FAA2F;IAClF,MAAM,CAA0B;IAChC,GAAG,CAAW;IAEvB;;;;OAIG;IACH,YAAY,GAAa,EAAE,MAAoB;QAC7C,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,EAAU;QACtB,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,CAAC,EAAE,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,CAAC;QACD,MAAM,GAAG,GAAsB,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;QACzD,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,IAA0G;QACxH,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,GAAG,GAAqB,IAAI,CAAC,OAAO;YACxC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;YACzF,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QACrE,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAED,uFAAuF;IACvF,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,WAAW,CAAC;IACvC,CAAC;IAED,sCAAsC;IACtC,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,UAAU,CAAC;IACtC,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "antpath",
-  "version": "0.4.2",
+  "version": "0.6.2",
   "description": "TypeScript SDK for running autonomous Claude Managed Agents sessions.",
   "repository": {
     "type": "git",
@@ -30,6 +30,9 @@
   "engines": {
     "node": ">=20"
   },
+  "dependencies": {
+    "fflate": "0.8.2"
+  },
   "scripts": {
     "build": "pnpm --filter @antpath/cli run build && pnpm --filter @antpath/shared run build && tsc -p tsconfig.build.json && node ./scripts/bundle-cli.mjs && node ./scripts/inline-shared.mjs",
     "lint": "tsc --noEmit",
@@ -37,9 +40,8 @@
     "test:unit": "vitest run test/unit",
     "test:unit:recorded": "vitest run test/unit/recorded",
     "test:load:replay": "vitest run test/unit/recorded/anthropic-replay-resilience.test.ts",
-    "test:property": "vitest run property",
+    "test:property": "vitest run --passWithNoTests property",
     "test:coverage": "vitest run --coverage test/unit",
-    "test:e2e:live": "vitest run test/e2e/live",
     "fixtures:record:anthropic": "tsx scripts/record-api-fixtures.ts",
     "fixtures:sanitize": "tsx scripts/sanitize-api-fixtures.ts",
     "publish:dry-run": "pnpm publish --dry-run --no-git-checks"