agentpacks 0.3.0 → 0.4.0

package/dist/utils/registry-client.js

@@ -0,0 +1,142 @@
+// @bun
+var __require = import.meta.require;
+
+// src/utils/registry-client.ts
+var DEFAULT_REGISTRY_URL = "https://registry.agentpacks.dev";
+function createRegistryClient(config) {
+  return new RegistryClient({
+    registryUrl: config?.registryUrl ?? DEFAULT_REGISTRY_URL,
+    authToken: config?.authToken,
+    timeout: config?.timeout ?? 30000
+  });
+}
+
+class RegistryClient {
+  config;
+  constructor(config) {
+    this.config = {
+      registryUrl: config.registryUrl.replace(/\/+$/, ""),
+      authToken: config.authToken,
+      timeout: config.timeout ?? 30000
+    };
+  }
+  async search(params) {
+    const searchParams = new URLSearchParams;
+    if (params.query)
+      searchParams.set("q", params.query);
+    if (params.tags?.length)
+      searchParams.set("tags", params.tags.join(","));
+    if (params.targets?.length)
+      searchParams.set("targets", params.targets.join(","));
+    if (params.features?.length)
+      searchParams.set("features", params.features.join(","));
+    if (params.author)
+      searchParams.set("author", params.author);
+    if (params.sort)
+      searchParams.set("sort", params.sort);
+    if (params.limit)
+      searchParams.set("limit", String(params.limit));
+    if (params.offset)
+      searchParams.set("offset", String(params.offset));
+    const url = `${this.config.registryUrl}/packs?${searchParams.toString()}`;
+    const res = await this.fetch(url);
+    return res;
+  }
+  async info(packName) {
+    const url = `${this.config.registryUrl}/packs/${encodeURIComponent(packName)}`;
+    const res = await this.fetch(url);
+    return res;
+  }
+  async download(packName, version = "latest") {
+    const url = `${this.config.registryUrl}/packs/${encodeURIComponent(packName)}/versions/${encodeURIComponent(version)}/download`;
+    const response = await fetch(url, {
+      headers: this.headers(),
+      signal: AbortSignal.timeout(this.config.timeout)
+    });
+    if (!response.ok) {
+      throw new RegistryApiError(response.status, `Failed to download ${packName}@${version}: ${response.statusText}`);
+    }
+    const integrity = response.headers.get("x-integrity") ?? "";
+    const data = await response.arrayBuffer();
+    return { data, integrity };
+  }
+  async publish(tarball, metadata) {
+    if (!this.config.authToken) {
+      throw new Error("Authentication required. Run `agentpacks login` first.");
+    }
+    const formData = new FormData;
+    formData.append("tarball", new Blob([tarball], { type: "application/gzip" }), `${metadata.name}-${metadata.version}.tgz`);
+    formData.append("metadata", JSON.stringify(metadata));
+    const url = `${this.config.registryUrl}/packs`;
+    const response = await fetch(url, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${this.config.authToken}`
+      },
+      body: formData,
+      signal: AbortSignal.timeout(this.config.timeout)
+    });
+    if (!response.ok) {
+      const body = await response.text();
+      throw new RegistryApiError(response.status, `Publish failed: ${body || response.statusText}`);
+    }
+    return await response.json();
+  }
+  async featured(limit) {
+    const url = limit ? `${this.config.registryUrl}/featured?limit=${limit}` : `${this.config.registryUrl}/featured`;
+    const res = await this.fetch(url);
+    return res.packs;
+  }
+  async tags() {
+    const url = `${this.config.registryUrl}/tags`;
+    const res = await this.fetch(url);
+    return res.tags;
+  }
+  async stats() {
+    const url = `${this.config.registryUrl}/stats`;
+    return await this.fetch(url);
+  }
+  async health() {
+    try {
+      const url = `${this.config.registryUrl}/health`;
+      await this.fetch(url);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  async fetch(url) {
+    const response = await fetch(url, {
+      headers: this.headers(),
+      signal: AbortSignal.timeout(this.config.timeout)
+    });
+    if (!response.ok) {
+      const body = await response.text();
+      throw new RegistryApiError(response.status, body || response.statusText);
+    }
+    return response.json();
+  }
+  headers() {
+    const h = {
+      Accept: "application/json"
+    };
+    if (this.config.authToken) {
+      h["Authorization"] = `Bearer ${this.config.authToken}`;
+    }
+    return h;
+  }
+}
+
+class RegistryApiError extends Error {
+  status;
+  constructor(status, message) {
+    super(message);
+    this.name = "RegistryApiError";
+    this.status = status;
+  }
+}
+export {
+  createRegistryClient,
+  RegistryClient,
+  RegistryApiError
+};

package/dist/utils/tarball.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Create a tarball from a pack directory.
+ * Returns the tarball as an ArrayBuffer.
+ */
+export declare function createTarball(packDir: string): Promise<ArrayBuffer>;
+/**
+ * Extract a tarball to a directory.
+ */
+export declare function extractTarball(data: ArrayBuffer, targetDir: string): Promise<void>;
+/**
+ * Compute SHA-256 integrity hash for an ArrayBuffer.
+ */
+export declare function computeTarballIntegrity(data: ArrayBuffer): string;

package/dist/utils/tarball.js

@@ -0,0 +1,49 @@
+// @bun
+var __require = import.meta.require;
+
+// src/utils/tarball.ts
+import { execSync } from "child_process";
+import { readFileSync, existsSync, mkdirSync, rmSync } from "fs";
+import { join, resolve } from "path";
+import { createHash } from "crypto";
+import { tmpdir } from "os";
+async function createTarball(packDir) {
+  const absDir = resolve(packDir);
+  const tmpFile = join(tmpdir(), `agentpacks-${Date.now()}.tgz`);
+  try {
+    execSync(`tar -czf "${tmpFile}" -C "${absDir}" .`, {
+      stdio: "pipe"
+    });
+    const buffer = readFileSync(tmpFile);
+    return buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
+  } finally {
+    if (existsSync(tmpFile)) {
+      rmSync(tmpFile);
+    }
+  }
+}
+async function extractTarball(data, targetDir) {
+  mkdirSync(targetDir, { recursive: true });
+  const tmpFile = join(tmpdir(), `agentpacks-${Date.now()}.tgz`);
+  try {
+    const buffer = Buffer.from(data);
+    const { writeFileSync } = await import("fs");
+    writeFileSync(tmpFile, buffer);
+    execSync(`tar -xzf "${tmpFile}" -C "${targetDir}"`, {
+      stdio: "pipe"
+    });
+  } finally {
+    if (existsSync(tmpFile)) {
+      rmSync(tmpFile);
+    }
+  }
+}
+function computeTarballIntegrity(data) {
+  const hash = createHash("sha256").update(Buffer.from(data)).digest("hex");
+  return `sha256-${hash}`;
+}
+export {
+  extractTarball,
+  createTarball,
+  computeTarballIntegrity
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentpacks",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "type": "module",
   "description": "Composable AI agent configuration manager. Pack-based rules, commands, skills, hooks, and MCP sync across OpenCode, Cursor, Claude Code, Codex, Gemini, Copilot, and more.",
   "keywords": [
@@ -67,6 +67,12 @@
       "node": "./dist/node/cli/import-cmd.js",
       "default": "./dist/cli/import-cmd.js"
     },
+    "./cli/info": {
+      "types": "./dist/cli/info.d.ts",
+      "bun": "./dist/cli/info.js",
+      "node": "./dist/node/cli/info.js",
+      "default": "./dist/cli/info.js"
+    },
     "./cli/init": {
       "types": "./dist/cli/init.d.ts",
       "bun": "./dist/cli/init.js",
@@ -79,6 +85,18 @@
       "node": "./dist/node/cli/install.js",
       "default": "./dist/cli/install.js"
     },
+    "./cli/login": {
+      "types": "./dist/cli/login.d.ts",
+      "bun": "./dist/cli/login.js",
+      "node": "./dist/node/cli/login.js",
+      "default": "./dist/cli/login.js"
+    },
+    "./cli/models-explain": {
+      "types": "./dist/cli/models-explain.d.ts",
+      "bun": "./dist/cli/models-explain.js",
+      "node": "./dist/node/cli/models-explain.js",
+      "default": "./dist/cli/models-explain.js"
+    },
     "./cli/pack/create": {
       "types": "./dist/cli/pack/create.d.ts",
       "bun": "./dist/cli/pack/create.js",
@@ -103,6 +121,18 @@
       "node": "./dist/node/cli/pack/validate.js",
       "default": "./dist/cli/pack/validate.js"
     },
+    "./cli/publish": {
+      "types": "./dist/cli/publish.d.ts",
+      "bun": "./dist/cli/publish.js",
+      "node": "./dist/node/cli/publish.js",
+      "default": "./dist/cli/publish.js"
+    },
+    "./cli/search": {
+      "types": "./dist/cli/search.d.ts",
+      "bun": "./dist/cli/search.js",
+      "node": "./dist/node/cli/search.js",
+      "default": "./dist/cli/search.js"
+    },
     "./core": {
       "types": "./dist/core/index.d.ts",
       "bun": "./dist/core/index.js",
@@ -151,6 +181,12 @@
       "node": "./dist/node/core/pack-loader.js",
       "default": "./dist/core/pack-loader.js"
     },
+    "./core/profile-resolver": {
+      "types": "./dist/core/profile-resolver.d.ts",
+      "bun": "./dist/core/profile-resolver.js",
+      "node": "./dist/node/core/profile-resolver.js",
+      "default": "./dist/core/profile-resolver.js"
+    },
     "./exporters": {
       "types": "./dist/exporters/index.d.ts",
       "bun": "./dist/exporters/index.js",
@@ -211,6 +247,12 @@
       "node": "./dist/node/features/mcp.js",
       "default": "./dist/features/mcp.js"
     },
+    "./features/models": {
+      "types": "./dist/features/models.d.ts",
+      "bun": "./dist/features/models.js",
+      "node": "./dist/node/features/models.js",
+      "default": "./dist/features/models.js"
+    },
     "./features/plugins": {
       "types": "./dist/features/plugins.d.ts",
       "bun": "./dist/features/plugins.js",
@@ -295,6 +337,18 @@
       "node": "./dist/node/sources/npm-ref.js",
       "default": "./dist/sources/npm-ref.js"
     },
+    "./sources/registry": {
+      "types": "./dist/sources/registry.d.ts",
+      "bun": "./dist/sources/registry.js",
+      "node": "./dist/node/sources/registry.js",
+      "default": "./dist/sources/registry.js"
+    },
+    "./sources/registry-ref": {
+      "types": "./dist/sources/registry-ref.d.ts",
+      "bun": "./dist/sources/registry-ref.js",
+      "node": "./dist/node/sources/registry-ref.js",
+      "default": "./dist/sources/registry-ref.js"
+    },
     "./targets": {
       "types": "./dist/targets/index.d.ts",
       "bun": "./dist/targets/index.js",
@@ -373,6 +427,12 @@
       "node": "./dist/node/targets/registry.js",
       "default": "./dist/targets/registry.js"
     },
+    "./utils/credentials": {
+      "types": "./dist/utils/credentials.d.ts",
+      "bun": "./dist/utils/credentials.js",
+      "node": "./dist/node/utils/credentials.js",
+      "default": "./dist/utils/credentials.js"
+    },
     "./utils/diff": {
       "types": "./dist/utils/diff.d.ts",
       "bun": "./dist/utils/diff.js",
@@ -402,6 +462,30 @@
       "bun": "./dist/utils/markdown.js",
       "node": "./dist/node/utils/markdown.js",
       "default": "./dist/utils/markdown.js"
+    },
+    "./utils/model-allowlist": {
+      "types": "./dist/utils/model-allowlist.d.ts",
+      "bun": "./dist/utils/model-allowlist.js",
+      "node": "./dist/node/utils/model-allowlist.js",
+      "default": "./dist/utils/model-allowlist.js"
+    },
+    "./utils/model-guidance": {
+      "types": "./dist/utils/model-guidance.d.ts",
+      "bun": "./dist/utils/model-guidance.js",
+      "node": "./dist/node/utils/model-guidance.js",
+      "default": "./dist/utils/model-guidance.js"
+    },
+    "./utils/registry-client": {
+      "types": "./dist/utils/registry-client.d.ts",
+      "bun": "./dist/utils/registry-client.js",
+      "node": "./dist/node/utils/registry-client.js",
+      "default": "./dist/utils/registry-client.js"
+    },
+    "./utils/tarball": {
+      "types": "./dist/utils/tarball.d.ts",
+      "bun": "./dist/utils/tarball.js",
+      "node": "./dist/node/utils/tarball.js",
+      "default": "./dist/utils/tarball.js"
     }
   },
   "files": [
@@ -414,15 +498,13 @@
     "commander": "^14.0.3",
     "chalk": "^5.3.0",
     "gray-matter": "^4.0.3",
-    "fs-extra": "^11.2.0",
     "zod": "^4.3.5",
     "jsonc-parser": "^3.3.1",
     "glob": "^13.0.3"
   },
   "devDependencies": {
-    "@contractspec/tool.typescript": "2.4.0",
-    "@contractspec/tool.bun": "2.4.0",
-    "@types/fs-extra": "^11.0.4",
+    "@contractspec/tool.typescript": "2.5.0",
+    "@contractspec/tool.bun": "2.5.0",
     "typescript": "^5.9.3"
   },
   "publishConfig": {
@@ -459,6 +541,12 @@
         "node": "./dist/node/cli/import-cmd.js",
         "default": "./dist/cli/import-cmd.js"
       },
+      "./cli/info": {
+        "types": "./dist/cli/info.d.ts",
+        "bun": "./dist/cli/info.js",
+        "node": "./dist/node/cli/info.js",
+        "default": "./dist/cli/info.js"
+      },
       "./cli/init": {
         "types": "./dist/cli/init.d.ts",
         "bun": "./dist/cli/init.js",
@@ -471,6 +559,18 @@
         "node": "./dist/node/cli/install.js",
         "default": "./dist/cli/install.js"
       },
+      "./cli/login": {
+        "types": "./dist/cli/login.d.ts",
+        "bun": "./dist/cli/login.js",
+        "node": "./dist/node/cli/login.js",
+        "default": "./dist/cli/login.js"
+      },
+      "./cli/models-explain": {
+        "types": "./dist/cli/models-explain.d.ts",
+        "bun": "./dist/cli/models-explain.js",
+        "node": "./dist/node/cli/models-explain.js",
+        "default": "./dist/cli/models-explain.js"
+      },
       "./cli/pack/create": {
         "types": "./dist/cli/pack/create.d.ts",
         "bun": "./dist/cli/pack/create.js",
@@ -495,6 +595,18 @@
         "node": "./dist/node/cli/pack/validate.js",
         "default": "./dist/cli/pack/validate.js"
       },
+      "./cli/publish": {
+        "types": "./dist/cli/publish.d.ts",
+        "bun": "./dist/cli/publish.js",
+        "node": "./dist/node/cli/publish.js",
+        "default": "./dist/cli/publish.js"
+      },
+      "./cli/search": {
+        "types": "./dist/cli/search.d.ts",
+        "bun": "./dist/cli/search.js",
+        "node": "./dist/node/cli/search.js",
+        "default": "./dist/cli/search.js"
+      },
       "./core": {
         "types": "./dist/core/index.d.ts",
         "bun": "./dist/core/index.js",
@@ -543,6 +655,12 @@
         "node": "./dist/node/core/pack-loader.js",
         "default": "./dist/core/pack-loader.js"
       },
+      "./core/profile-resolver": {
+        "types": "./dist/core/profile-resolver.d.ts",
+        "bun": "./dist/core/profile-resolver.js",
+        "node": "./dist/node/core/profile-resolver.js",
+        "default": "./dist/core/profile-resolver.js"
+      },
       "./exporters": {
         "types": "./dist/exporters/index.d.ts",
         "bun": "./dist/exporters/index.js",
@@ -603,6 +721,12 @@
         "node": "./dist/node/features/mcp.js",
         "default": "./dist/features/mcp.js"
       },
+      "./features/models": {
+        "types": "./dist/features/models.d.ts",
+        "bun": "./dist/features/models.js",
+        "node": "./dist/node/features/models.js",
+        "default": "./dist/features/models.js"
+      },
       "./features/plugins": {
         "types": "./dist/features/plugins.d.ts",
         "bun": "./dist/features/plugins.js",
@@ -687,6 +811,18 @@
         "node": "./dist/node/sources/npm-ref.js",
         "default": "./dist/sources/npm-ref.js"
       },
+      "./sources/registry": {
+        "types": "./dist/sources/registry.d.ts",
+        "bun": "./dist/sources/registry.js",
+        "node": "./dist/node/sources/registry.js",
+        "default": "./dist/sources/registry.js"
+      },
+      "./sources/registry-ref": {
+        "types": "./dist/sources/registry-ref.d.ts",
+        "bun": "./dist/sources/registry-ref.js",
+        "node": "./dist/node/sources/registry-ref.js",
+        "default": "./dist/sources/registry-ref.js"
+      },
       "./targets": {
         "types": "./dist/targets/index.d.ts",
         "bun": "./dist/targets/index.js",
@@ -765,6 +901,12 @@
         "node": "./dist/node/targets/registry.js",
         "default": "./dist/targets/registry.js"
       },
+      "./utils/credentials": {
+        "types": "./dist/utils/credentials.d.ts",
+        "bun": "./dist/utils/credentials.js",
+        "node": "./dist/node/utils/credentials.js",
+        "default": "./dist/utils/credentials.js"
+      },
       "./utils/diff": {
         "types": "./dist/utils/diff.d.ts",
         "bun": "./dist/utils/diff.js",
@@ -794,6 +936,30 @@
         "bun": "./dist/utils/markdown.js",
         "node": "./dist/node/utils/markdown.js",
         "default": "./dist/utils/markdown.js"
+      },
+      "./utils/model-allowlist": {
+        "types": "./dist/utils/model-allowlist.d.ts",
+        "bun": "./dist/utils/model-allowlist.js",
+        "node": "./dist/node/utils/model-allowlist.js",
+        "default": "./dist/utils/model-allowlist.js"
+      },
+      "./utils/model-guidance": {
+        "types": "./dist/utils/model-guidance.d.ts",
+        "bun": "./dist/utils/model-guidance.js",
+        "node": "./dist/node/utils/model-guidance.js",
+        "default": "./dist/utils/model-guidance.js"
+      },
+      "./utils/registry-client": {
+        "types": "./dist/utils/registry-client.d.ts",
+        "bun": "./dist/utils/registry-client.js",
+        "node": "./dist/node/utils/registry-client.js",
+        "default": "./dist/utils/registry-client.js"
+      },
+      "./utils/tarball": {
+        "types": "./dist/utils/tarball.d.ts",
+        "bun": "./dist/utils/tarball.js",
+        "node": "./dist/node/utils/tarball.js",
+        "default": "./dist/utils/tarball.js"
       }
     }
   },

package/templates/pack/models.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "https://agentpacks.dev/schemas/models.json",
+  "default": "anthropic/claude-sonnet-4-20250514",
+  "small": "anthropic/claude-haiku-3.5",
+  "profiles": {
+    "quality": {
+      "description": "Maximum quality — use the strongest available model",
+      "default": "anthropic/claude-opus-4-20250514",
+      "small": "anthropic/claude-sonnet-4-20250514"
+    },
+    "budget": {
+      "description": "Cost-efficient — use smaller models where possible",
+      "default": "anthropic/claude-haiku-3.5",
+      "small": "anthropic/claude-haiku-3.5"
+    },
+    "fast": {
+      "description": "Low-latency — prioritize speed over depth",
+      "default": "anthropic/claude-haiku-3.5",
+      "small": "anthropic/claude-haiku-3.5"
+    }
+  },
+  "providers": {
+    "anthropic": {
+      "models": {
+        "claude-opus-4-20250514": {
+          "options": {
+            "budgetTokens": 10000
+          }
+        },
+        "claude-sonnet-4-20250514": {
+          "options": {
+            "budgetTokens": 5000
+          }
+        }
+      }
+    }
+  }
+}