agentpacks 0.3.0 → 0.4.0

package/dist/utils/credentials.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Stored credentials.
+ */
+export interface Credentials {
+    registryUrl: string;
+    token?: string;
+}
+/**
+ * Load credentials from ~/.config/agentpacks/credentials.json.
+ */
+export declare function loadCredentials(): Credentials;
+/**
+ * Save credentials to ~/.config/agentpacks/credentials.json.
+ */
+export declare function saveCredentials(credentials: Credentials): void;
+/**
+ * Clear saved credentials.
+ */
+export declare function clearCredentials(): void;

package/dist/utils/credentials.js

@@ -0,0 +1,38 @@
+// @bun
+var __require = import.meta.require;
+
+// src/utils/credentials.ts
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
+import { join, dirname } from "path";
+import { homedir } from "os";
+var CONFIG_DIR = join(homedir(), ".config", "agentpacks");
+var CREDENTIALS_FILE = join(CONFIG_DIR, "credentials.json");
+function loadCredentials() {
+  if (!existsSync(CREDENTIALS_FILE)) {
+    return { registryUrl: "https://registry.agentpacks.dev" };
+  }
+  try {
+    const raw = readFileSync(CREDENTIALS_FILE, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return { registryUrl: "https://registry.agentpacks.dev" };
+  }
+}
+function saveCredentials(credentials) {
+  mkdirSync(dirname(CREDENTIALS_FILE), { recursive: true });
+  writeFileSync(CREDENTIALS_FILE, JSON.stringify(credentials, null, 2) + `
+`, {
+    mode: 384
+  });
+}
+function clearCredentials() {
+  if (existsSync(CREDENTIALS_FILE)) {
+    writeFileSync(CREDENTIALS_FILE, JSON.stringify({ registryUrl: "https://registry.agentpacks.dev" }) + `
+`);
+  }
+}
+export {
+  saveCredentials,
+  loadCredentials,
+  clearCredentials
+};

package/dist/utils/diff.js

@@ -1,32 +1,4 @@
 // @bun
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __moduleCache = /* @__PURE__ */ new WeakMap;
-var __toCommonJS = (from) => {
-  var entry = __moduleCache.get(from), desc;
-  if (entry)
-    return entry;
-  entry = __defProp({}, "__esModule", { value: true });
-  if (from && typeof from === "object" || typeof from === "function")
-    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
-      get: () => from[key],
-      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-    }));
-  __moduleCache.set(from, entry);
-  return entry;
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: (newValue) => all[name] = () => newValue
-    });
-};
-var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = import.meta.require;
 
 // src/utils/diff.ts
@@ -84,14 +56,29 @@ function findHunks(oldLines, newLines) {
   let ni = 0;
   while (oi < oldLines.length || ni < newLines.length) {
     if (oi < oldLines.length && ni < newLines.length && oldLines[oi] === newLines[ni]) {
-      changes.push({ type: " ", line: oldLines[oi], oldIdx: oi, newIdx: ni });
+      changes.push({
+        type: " ",
+        line: oldLines[oi] ?? "",
+        oldIdx: oi,
+        newIdx: ni
+      });
       oi++;
       ni++;
-    } else if (ni < newLines.length && (oi >= oldLines.length || !newLines.slice(ni).includes(oldLines[oi]))) {
-      changes.push({ type: "+", line: newLines[ni], oldIdx: oi, newIdx: ni });
+    } else if (ni < newLines.length && (oi >= oldLines.length || !newLines.slice(ni).includes(oldLines[oi] ?? ""))) {
+      changes.push({
+        type: "+",
+        line: newLines[ni] ?? "",
+        oldIdx: oi,
+        newIdx: ni
+      });
       ni++;
     } else {
-      changes.push({ type: "-", line: oldLines[oi], oldIdx: oi, newIdx: oi });
+      changes.push({
+        type: "-",
+        line: oldLines[oi] ?? "",
+        oldIdx: oi,
+        newIdx: oi
+      });
       oi++;
     }
   }
@@ -120,8 +107,9 @@ function findHunks(oldLines, newLines) {
           lines: []
         };
         for (let i = contextStart;i < changes.indexOf(change); i++) {
-          if (changes[i].type === " ") {
-            currentHunk.lines.push(` ${changes[i].line}`);
+          const entry = changes[i];
+          if (entry?.type === " ") {
+            currentHunk.lines.push(` ${entry.line}`);
             currentHunk.oldCount++;
             currentHunk.newCount++;
           }

package/dist/utils/filesystem.js

@@ -1,32 +1,4 @@
 // @bun
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __moduleCache = /* @__PURE__ */ new WeakMap;
-var __toCommonJS = (from) => {
-  var entry = __moduleCache.get(from), desc;
-  if (entry)
-    return entry;
-  entry = __defProp({}, "__esModule", { value: true });
-  if (from && typeof from === "object" || typeof from === "function")
-    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
-      get: () => from[key],
-      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-    }));
-  __moduleCache.set(from, entry);
-  return entry;
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: (newValue) => all[name] = () => newValue
-    });
-};
-var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = import.meta.require;
 
 // src/utils/filesystem.ts
@@ -36,10 +8,10 @@ import {
   readFileSync,
   writeFileSync,
   readdirSync,
+  rmSync,
   statSync
 } from "fs";
 import { dirname, relative, join } from "path";
-import { removeSync } from "fs-extra";
 var GENERATED_HEADER_MD = "<!-- Generated by agentpacks. DO NOT EDIT. -->";
 var GENERATED_HEADER_JSON = "// Generated by agentpacks. DO NOT EDIT.";
 var GENERATED_HEADER_JS = "// Generated by agentpacks. DO NOT EDIT.";
@@ -80,7 +52,7 @@ function ensureDir(dirPath) {
 }
 function removeIfExists(targetPath) {
   if (existsSync(targetPath)) {
-    removeSync(targetPath);
+    rmSync(targetPath, { recursive: true, force: true });
   }
 }
 function listFiles(dirPath, options = {}) {

package/dist/utils/frontmatter.js

@@ -1,32 +1,4 @@
 // @bun
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __moduleCache = /* @__PURE__ */ new WeakMap;
-var __toCommonJS = (from) => {
-  var entry = __moduleCache.get(from), desc;
-  if (entry)
-    return entry;
-  entry = __defProp({}, "__esModule", { value: true });
-  if (from && typeof from === "object" || typeof from === "function")
-    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
-      get: () => from[key],
-      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-    }));
-  __moduleCache.set(from, entry);
-  return entry;
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: (newValue) => all[name] = () => newValue
-    });
-};
-var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = import.meta.require;
 
 // src/utils/frontmatter.ts

package/dist/utils/global.js

@@ -1,32 +1,4 @@
 // @bun
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __moduleCache = /* @__PURE__ */ new WeakMap;
-var __toCommonJS = (from) => {
-  var entry = __moduleCache.get(from), desc;
-  if (entry)
-    return entry;
-  entry = __defProp({}, "__esModule", { value: true });
-  if (from && typeof from === "object" || typeof from === "function")
-    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
-      get: () => from[key],
-      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-    }));
-  __moduleCache.set(from, entry);
-  return entry;
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: (newValue) => all[name] = () => newValue
-    });
-};
-var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = import.meta.require;
 
 // src/utils/global.ts
@@ -62,15 +34,15 @@ function globalTargetDir(targetId, platform = process.platform) {
   }
 }
 function xdgConfig(platform, home) {
-  if (process.env.XDG_CONFIG_HOME) {
-    return process.env.XDG_CONFIG_HOME;
-  }
   if (platform === "darwin") {
     return join(home, "Library", "Application Support");
   }
   if (platform === "win32") {
     return process.env.APPDATA ?? join(home, "AppData", "Roaming");
   }
+  if (process.env.XDG_CONFIG_HOME) {
+    return process.env.XDG_CONFIG_HOME;
+  }
   return join(home, ".config");
 }
 export {

package/dist/utils/markdown.js

@@ -1,32 +1,4 @@
 // @bun
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __moduleCache = /* @__PURE__ */ new WeakMap;
-var __toCommonJS = (from) => {
-  var entry = __moduleCache.get(from), desc;
-  if (entry)
-    return entry;
-  entry = __defProp({}, "__esModule", { value: true });
-  if (from && typeof from === "object" || typeof from === "function")
-    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
-      get: () => from[key],
-      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-    }));
-  __moduleCache.set(from, entry);
-  return entry;
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: (newValue) => all[name] = () => newValue
-    });
-};
-var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = import.meta.require;
 
 // src/utils/markdown.ts

package/dist/utils/model-allowlist.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Model ID allowlist validation.
+ *
+ * Validates model identifiers against known provider patterns.
+ * Returns warnings (not errors) for unknown model IDs to allow
+ * innovative use of new models.
+ */
+/** Validation result. */
+export interface ModelValidationResult {
+    modelId: string;
+    known: boolean;
+    provider?: string;
+    warning?: string;
+}
+/**
+ * Validate a single model ID against the allowlist.
+ * Returns { known: true, provider } for known IDs,
+ * or { known: false, warning } for unknown IDs.
+ */
+export declare function validateModelId(modelId: string): ModelValidationResult;
+/**
+ * Scan a models config for unknown model IDs.
+ * Returns warnings for any model IDs not matching known patterns.
+ * These are advisory only — they don't block publish.
+ */
+export declare function scanModelsForUnknownIds(config: {
+    default?: string;
+    small?: string;
+    agents?: Record<string, {
+        model: string;
+    }>;
+    profiles?: Record<string, {
+        default?: string;
+        small?: string;
+        agents?: Record<string, {
+            model: string;
+        }>;
+    }>;
+}): string[];

package/dist/utils/model-allowlist.js

@@ -0,0 +1,110 @@
+// @bun
+var __require = import.meta.require;
+
+// src/utils/model-allowlist.ts
+var KNOWN_MODEL_PATTERNS = [
+  {
+    provider: "Anthropic",
+    pattern: /^(anthropic\/)?claude-(opus|sonnet|haiku|instant|3|3\.5|4)[-.\w]*/i,
+    examples: ["claude-sonnet-4-20250514", "anthropic/claude-opus-4-6"]
+  },
+  {
+    provider: "OpenAI",
+    pattern: /^(openai\/)?(gpt-4|gpt-3\.5|o[1-9]|o[1-9]-\w+|chatgpt-4o|gpt-4o)[-.\w]*/i,
+    examples: ["gpt-4o", "openai/gpt-4-turbo", "o1-preview"]
+  },
+  {
+    provider: "Google",
+    pattern: /^(google\/)?gemini-(pro|ultra|nano|flash|1\.5|2\.0|2\.5|exp)[-.\w]*/i,
+    examples: ["gemini-2.5-flash", "google/gemini-pro"]
+  },
+  {
+    provider: "Meta",
+    pattern: /^(meta\/)?(llama|codellama)[-.\w]*/i,
+    examples: ["llama-3.1-70b", "meta/llama-3-8b"]
+  },
+  {
+    provider: "Mistral",
+    pattern: /^(mistral(ai)?\/)?(mistral|mixtral|codestral|pixtral)[-.\w]*/i,
+    examples: ["mistral-large", "mixtral-8x7b"]
+  },
+  {
+    provider: "Cohere",
+    pattern: /^(cohere\/)?command[-.\w]*/i,
+    examples: ["command-r-plus", "cohere/command-r"]
+  },
+  {
+    provider: "DeepSeek",
+    pattern: /^(deepseek\/)?deepseek[-.\w]*/i,
+    examples: ["deepseek-coder", "deepseek/deepseek-chat"]
+  },
+  {
+    provider: "Qwen",
+    pattern: /^(qwen\/)?qwen[-.\w]*/i,
+    examples: ["qwen-2.5-72b"]
+  },
+  {
+    provider: "xAI",
+    pattern: /^(xai\/)?grok[-.\w]*/i,
+    examples: ["grok-2", "xai/grok-3"]
+  }
+];
+function validateModelId(modelId) {
+  if (!modelId || typeof modelId !== "string") {
+    return {
+      modelId: modelId ?? "",
+      known: false,
+      warning: "Empty model ID"
+    };
+  }
+  for (const entry of KNOWN_MODEL_PATTERNS) {
+    if (entry.pattern.test(modelId)) {
+      return {
+        modelId,
+        known: true,
+        provider: entry.provider
+      };
+    }
+  }
+  return {
+    modelId,
+    known: false,
+    warning: `Unknown model ID "${modelId}" \u2014 not in any known provider pattern. This may be a new or custom model.`
+  };
+}
+function scanModelsForUnknownIds(config) {
+  const warnings = [];
+  const checked = new Set;
+  function check(modelId, context) {
+    if (!modelId || checked.has(modelId))
+      return;
+    checked.add(modelId);
+    const result = validateModelId(modelId);
+    if (!result.known) {
+      warnings.push(`${context}: ${result.warning}`);
+    }
+  }
+  check(config.default, "default model");
+  check(config.small, "small model");
+  if (config.agents) {
+    for (const [name, assignment] of Object.entries(config.agents)) {
+      check(assignment.model, `agent "${name}"`);
+    }
+  }
+  if (config.profiles) {
+    for (const [profileName, profile] of Object.entries(config.profiles)) {
+      check(profile.default, `profile "${profileName}" default`);
+      check(profile.small, `profile "${profileName}" small`);
+      if (profile.agents) {
+        for (const [name, assignment] of Object.entries(profile.agents)) {
+          check(assignment.model, `profile "${profileName}" agent "${name}"`);
+        }
+      }
+    }
+  }
+  return warnings;
+}
+export {
+  validateModelId,
+  scanModelsForUnknownIds
+};

package/dist/utils/model-guidance.d.ts

@@ -0,0 +1,6 @@
+import type { ResolvedModels } from '../core/profile-resolver.js';
+/**
+ * Generate a markdown model guidance document from resolved model config.
+ * Used by targets that don't have native model configuration (Claude, Copilot, generic).
+ */
+export declare function generateModelGuidanceMarkdown(resolved: ResolvedModels): string | null;

package/dist/utils/model-guidance.js

@@ -0,0 +1,78 @@
+// @bun
+var __require = import.meta.require;
+
+// src/utils/model-guidance.ts
+function generateModelGuidanceMarkdown(resolved) {
+  if (!resolved.default && !resolved.small && Object.keys(resolved.agents).length === 0 && Object.keys(resolved.profiles).length === 0) {
+    return null;
+  }
+  const lines = [];
+  lines.push("# Model Configuration");
+  lines.push("");
+  lines.push("Use the following model preferences when working in this project.");
+  lines.push("");
+  if (resolved.default || resolved.small) {
+    lines.push("## Default Models");
+    lines.push("");
+    if (resolved.default) {
+      lines.push(`- **Primary model**: ${resolved.default}`);
+    }
+    if (resolved.small) {
+      lines.push(`- **Lightweight tasks** (titles, summaries): ${resolved.small}`);
+    }
+    lines.push("");
+  }
+  const agentEntries = Object.entries(resolved.agents);
+  if (agentEntries.length > 0) {
+    lines.push("## Agent Model Assignments");
+    lines.push("");
+    lines.push("| Agent | Model | Temperature |");
+    lines.push("| --- | --- | --- |");
+    for (const [name, assignment] of agentEntries) {
+      const temp = assignment.temperature !== undefined ? String(assignment.temperature) : "\u2014";
+      lines.push(`| ${name} | ${assignment.model} | ${temp} |`);
+    }
+    lines.push("");
+  }
+  if (Object.keys(resolved.profiles).length > 0) {
+    lines.push("## Available Profiles");
+    lines.push("");
+    lines.push("| Profile | Description | Default Model |");
+    lines.push("| --- | --- | --- |");
+    for (const [name, profile] of Object.entries(resolved.profiles)) {
+      lines.push(`| ${name} | ${profile.description ?? "\u2014"} | ${profile.default ?? "\u2014"} |`);
+    }
+    lines.push("");
+  }
+  if (resolved.activeProfile) {
+    lines.push(`**Active profile**: \`${resolved.activeProfile}\``);
+    lines.push("");
+  }
+  if (resolved.routing.length > 0) {
+    lines.push("## Task-Aware Routing");
+    lines.push("");
+    lines.push("Select the appropriate profile based on the task context:");
+    lines.push("");
+    lines.push("| Condition | Profile | Description |");
+    lines.push("| --- | --- | --- |");
+    for (const rule of resolved.routing) {
+      const conditions = Object.entries(rule.when).map(([k, v]) => `${k}=${v}`).join(", ");
+      const desc = rule.description ?? "\u2014";
+      lines.push(`| ${conditions} | ${rule.use} | ${desc} |`);
+    }
+    lines.push("");
+    lines.push("### Condition Reference");
+    lines.push("");
+    lines.push("- **complexity**: low | medium | high | critical");
+    lines.push("- **urgency**: low | normal | high");
+    lines.push("- **budget**: minimal | standard | premium");
+    lines.push("- **contextWindowNeed**: small | medium | large | max");
+    lines.push("- **toolUseIntensity**: none | light | heavy");
+    lines.push("");
+  }
+  return lines.join(`
+`);
+}
+export {
+  generateModelGuidanceMarkdown
+};

package/dist/utils/registry-client.d.ts

@@ -0,0 +1,141 @@
+/**
+ * HTTP client for the agentpacks pack registry API.
+ * Handles search, info, download, publish, and auth operations.
+ */
+/**
+ * Registry API client configuration.
+ */
+export interface RegistryClientConfig {
+    /** Base URL of the registry API */
+    registryUrl: string;
+    /** Bearer token for authenticated operations */
+    authToken?: string;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Pack search result from the registry.
+ */
+export interface RegistryPackResult {
+    name: string;
+    displayName: string;
+    description: string;
+    author: string;
+    downloads: number;
+    weeklyDownloads: number;
+    tags: string[];
+    targets: string[];
+    features: string[];
+    verified: boolean;
+    featured: boolean;
+    latestVersion: string;
+    updatedAt: string;
+}
+/**
+ * Detailed pack info from the registry.
+ */
+export interface RegistryPackInfo extends RegistryPackResult {
+    longDescription?: string;
+    license: string;
+    homepage?: string;
+    repository?: string;
+    versions: {
+        version: string;
+        createdAt: string;
+        fileCount: number;
+        tarballSize: number;
+    }[];
+    readme?: string;
+}
+/**
+ * Search parameters.
+ */
+export interface SearchParams {
+    query?: string;
+    tags?: string[];
+    targets?: string[];
+    features?: string[];
+    author?: string;
+    sort?: 'downloads' | 'updated' | 'name' | 'weekly';
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Publish result.
+ */
+export interface PublishResult {
+    name: string;
+    version: string;
+    integrity: string;
+}
+/**
+ * Create a registry client with the given configuration.
+ */
+export declare function createRegistryClient(config?: Partial<RegistryClientConfig>): RegistryClient;
+/**
+ * Registry API client.
+ */
+export declare class RegistryClient {
+    private config;
+    constructor(config: RegistryClientConfig);
+    /**
+     * Search for packs in the registry.
+     */
+    search(params: SearchParams): Promise<{
+        packs: RegistryPackResult[];
+        total: number;
+    }>;
+    /**
+     * Get detailed pack info.
+     */
+    info(packName: string): Promise<RegistryPackInfo>;
+    /**
+     * Download a pack tarball. Returns the raw ArrayBuffer.
+     */
+    download(packName: string, version?: string): Promise<{
+        data: ArrayBuffer;
+        integrity: string;
+    }>;
+    /**
+     * Publish a pack tarball to the registry.
+     */
+    publish(tarball: ArrayBuffer, metadata: {
+        name: string;
+        version: string;
+        manifest: Record<string, unknown>;
+    }): Promise<PublishResult>;
+    /**
+     * Get featured packs.
+     */
+    featured(limit?: number): Promise<RegistryPackResult[]>;
+    /**
+     * Get available tags.
+     */
+    tags(): Promise<{
+        tag: string;
+        count: number;
+    }[]>;
+    /**
+     * Get registry stats.
+     */
+    stats(): Promise<{
+        totalPacks: number;
+        totalDownloads: number;
+        totalVersions: number;
+    }>;
+    /**
+     * Health check.
+     */
+    health(): Promise<boolean>;
+    /** Internal fetch helper with timeout and error handling. */
+    private fetch;
+    /** Build headers for requests. */
+    private headers;
+}
+/**
+ * Registry API error with HTTP status code.
+ */
+export declare class RegistryApiError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}