@sysprompthub/sdk 1.0.1 → 2.0.0

package/README.md

@@ -1,6 +1,13 @@
 # @sysprompthub/sdk
 
-SDK for syncing system prompts from SysPromptHub to your projects.
+Node.js SDK for managing and syncing system prompts from [SysPromptHub](https://sysprompthub.com) to your AI assistant configurations.
+
+> 🌐 Please see [@sysprompthub/cli](https://www.npmjs.com/package/@sysprompthub) for the command-line interface
+>
+> 🌐 For VS Code integration, see the [SysPromptHub Extension](https://marketplace.visualstudio.com/items?itemName=sysprompthub.sysprompthub)
+>
+> ⏳ Jetbrains IDE integration coming soon!
+
 
 ## Installation
 
@@ -8,52 +15,220 @@ SDK for syncing system prompts from SysPromptHub to your projects.
 npm install @sysprompthub/sdk
 ```
 
-## Usage
+## Quick Start
 
 ```typescript
-import { SyncManager, NodeFileSystem } from '@sysprompthub/sdk';
+import { SyncManager, NodeFileSystem, DefaultConfigManager } from '@sysprompthub/sdk';
 
-// Example 1: Sync with explicit config and Node.js file system
+const syncManager = new SyncManager();
 const fs = new NodeFileSystem();
 
-const syncManager = new SyncManager();
 await syncManager.sync({
   config: {
-    packName: 'user/pack/latest',
-    assistants: ['copilot', 'claude']
+    apiKey: 'your-api-key',
+    packs: [
+      { type: 'copilot', pack: 'owner/pack-name/latest' },
+      { type: 'claude', pack: 'owner/pack-name/latest' }
+    ]
   },
   fs
 });
+```
+
+## Features
+
+- 🔄 **Sync prompts** to GitHub Copilot and Claude Desktop
+- 🎯 **Agent/Skill support** - Configure multiple specialized agents
+- 📁 **Custom paths** - Write prompts to any location
+- 🌍 **Environment support** - Development, local, and production configs
+- 💾 **Project config management** - Edit `.sysprompthub.json` programmatically
+
+## Usage
+
+### Syncing Prompts
+
+```typescript
+import { SyncManager, NodeFileSystem } from '@sysprompthub/sdk';
 
-// Example 2: Sync to a custom path
+const syncManager = new SyncManager();
+const fs = new NodeFileSystem();
+
+// Sync multiple assistants
 await syncManager.sync({
   config: {
-    packName: 'user/pack/latest',
-    path: 'docs/system-prompt.md'
+    apiKey: process.env.SYSPROMPTHUB_API_KEY!,
+    packs: [
+      { type: 'copilot', pack: 'company/general/v1.0.0' },
+      { type: 'claude', pack: 'company/general/v1.0.0' },
+      { 
+        type: 'copilot', 
+        pack: 'company/python-expert/latest',
+        agent: { 
+          name: 'python',
+          description: 'Python development expert'
+        }
+      }
+    ]
   },
   fs
 });
 ```
 
-## Development
+### Managing Project Configuration
 
-```bash
-# Install dependencies
-npm install
+```typescript
+import { DefaultConfigManager, ProjectConfigEditor, NodeFileSystem } from '@sysprompthub/sdk';
+
+const fs = new NodeFileSystem();
+const manager = new DefaultConfigManager();
+
+// Load or create config
+const editor = await manager.load(fs);
+
+// Set primary assistant pack
+await editor.set({
+  assistant: 'copilot',
+  pack: 'owner/pack/latest',
+  environment: 'development'
+});
+
+// Add an agent
+await editor.addAgent({
+  assistant: 'copilot',
+  name: 'typescript',
+  pack: 'owner/typescript-pack/latest',
+  frontMatter: {
+    description: 'TypeScript expert',
+    model: 'gpt-4'
+  }
+});
+
+// Add custom path
+await editor.addCustom({
+  path: 'docs/prompt.md',
+  pack: 'owner/docs-pack/latest'
+});
 
-# Build
-npm run build
+// View current configuration
+console.log(editor.packs);
 
-# Run tests
-npm test
+// Remove an agent
+await editor.removeAgent('copilot', 'typescript');
 
-# Run tests in watch mode
-npm run test:watch
+// Clear all packs for an assistant
+await editor.clearAll('copilot');
+```
+
+### Working with Configurations
+
+```typescript
+import { DefaultConfigManager, UserConfigManager, NodeFileSystem } from '@sysprompthub/sdk';
 
-# Type check
-npm run typecheck
+const fs = new NodeFileSystem();
+
+// Project configuration (.sysprompthub.json)
+const projectManager = new DefaultConfigManager();
+const projectEditor = await projectManager.load(fs);
+
+// User configuration (~/.sysprompthub/config.json)
+const userManager = new UserConfigManager();
+const userConfig = await userManager.load(fs);
+if (userConfig) {
+  console.log('API Key:', userConfig.apiKey);
+}
 ```
 
+## Configuration Format
+
+### Project Config (`.sysprompthub.json`)
+
+```json
+{
+  "packs": [
+    {
+      "type": "copilot",
+      "pack": "owner/pack-name/version"
+    },
+    {
+      "type": "copilot",
+      "pack": "owner/agent-pack/version",
+      "agent": {
+        "name": "python",
+        "description": "Python expert"
+      }
+    },
+    {
+      "type": "claude",
+      "pack": "owner/pack-name/version",
+      "environment": "development"
+    },
+    {
+      "type": "custom",
+      "pack": "owner/custom-pack/version",
+      "path": "docs/prompt.md"
+    }
+  ]
+}
+```
+
+### User Config (`~/.sysprompthub/config.json`)
+
+```json
+{
+  "apiKey": "sph_..."
+}
+```
+
+## API Reference
+
+### SyncManager
+
+Syncs prompts from SysPromptHub to local files.
+
+- `sync(workspace: Workspace): Promise<void>` - Download and write prompts
+
+### ProjectConfigEditor
+
+Manages project configuration with a fluent API.
+
+- `set(options)` - Set/replace assistant root pack
+- `clear(type)` - Remove assistant root pack
+- `clearAll(type)` - Remove all packs for an assistant
+- `find(assistant)` - Find root pack
+- `addAgent(options)` - Add/replace agent pack
+- `removeAgent(assistant, name)` - Remove agent pack
+- `findAgent(assistant, name)` - Find agent pack
+- `addCustom(options)` - Add/replace custom pack
+- `removeCustom(path)` - Remove custom pack
+- `findCustom(path)` - Find custom pack by path
+
+### ConfigManager
+
+Interface for loading and saving configurations.
+
+- `load(fs)` - Load configuration, returns editor
+- `save(fs, config)` - Save configuration
+- `update(fs, config)` - Update existing configuration
+- `exists(fs)` - Check if configuration exists
+
+## TypeScript Support
+
+This package includes full TypeScript definitions.
+
+```typescript
+import type { 
+  PackConfig, 
+  ProjectConfig, 
+  UserConfig,
+  AssistantType,
+  Environment 
+} from '@sysprompthub/sdk';
+```
+
+## CLI Alternative
+
+For command-line usage, see [@sysprompthub/cli](https://www.npmjs.com/package/@sysprompthub/cli).
+
 ## License
 
 ISC

package/dist/assistant-manager.d.ts

@@ -1,28 +1,30 @@
-import { AssistantType } from './assistant.type.js';
-import { Assistant } from "./assistant.js";
-type AssistantCallback = (assistant: Assistant) => void;
+import { Assistant as BaseAssistant } from './assistants/index.js';
+import { PackConfigType, RemovePackConfig } from './config.type.js';
+import { FileSystem } from './file-system.type.js';
 /**
- * Manages registered AI assistants and their configurations
+ * Manages registered AI assistants and their configurations.
  */
 export declare class AssistantManager {
     private static readonly ASSISTANTS;
     /**
-     * Iterates over all assistant types and invokes callback for each
-     * @param callback - Function to call for each assistant
+     * Gets an assistant class by pack config type
+     * @param type - The pack config type
+     * @returns The assistant class
      */
-    forEach(callback: AssistantCallback): void;
+    getAssistantClass(type: PackConfigType): typeof BaseAssistant;
     /**
-     * Iterates over specified assistant types and invokes callback for each
-     * @param types - Array of assistant types to iterate over
-     * @param callback - Function to call for each assistant
+     * Creates a new assistant instance by pack config type
+     * @param type - The pack config type
+     * @returns A new assistant instance
      */
-    forEach(types: readonly AssistantType[], callback: AssistantCallback): void;
+    createAssistant(type: PackConfigType): BaseAssistant;
     /**
-     * Gets an assistant by type
-     * @param type - The assistant type
-     * @returns The Assistant instance
+     * Removes a prompt file for the given pack configuration.
+     * @param config - The pack configuration
+     * @param fs - The file system interface
      */
-    get(type: AssistantType): Assistant;
+    removePack(config: RemovePackConfig, fs: FileSystem): Promise<void>;
 }
-export {};
+/** Singleton instance of AssistantManager for convenient access */
+export declare const assistantManager: AssistantManager;
 //# sourceMappingURL=assistant-manager.d.ts.map

package/dist/assistant-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assistant-manager.d.ts","sourceRoot":"","sources":["../src/assistant-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAiB,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAC,SAAS,EAAC,MAAM,gBAAgB,CAAC;AAEzC,KAAK,iBAAiB,GAAG,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;AAExD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAG/B;IAEH;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAC1C;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,EAAE,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAY3E;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS;CAGpC"}
+{"version":3,"file":"assistant-manager.d.ts","sourceRoot":"","sources":["../src/assistant-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqD,SAAS,IAAI,aAAa,EAAC,MAAM,uBAAuB,CAAC;AACrH,OAAO,EAAa,cAAc,EAAE,gBAAgB,EAAC,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAC,UAAU,EAAC,MAAM,uBAAuB,CAAC;AAGjD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAI/B;IAEH;;;;OAIG;IACH,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,aAAa;IAQ7D;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,aAAa;IAKpD;;;;OAIG;IACG,UAAU,CAAC,MAAM,EAAE,gBAAgB,EAAE,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAI1E;AAED,mEAAmE;AACnE,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}

package/dist/assistant-manager.js

@@ -1,31 +1,44 @@
-import { assistantTypes } from './assistant.type.js';
-import { Assistant } from "./assistant.js";
+import { CopilotAssistant, ClaudeAssistant, CustomAssistant } from './assistants/index.js';
 /**
- * Manages registered AI assistants and their configurations
+ * Manages registered AI assistants and their configurations.
  */
 export class AssistantManager {
     static ASSISTANTS = Object.freeze({
-        copilot: new Assistant('copilot', '.github/copilot-instructions.md'),
-        claude: new Assistant('claude', '.claude/system.md')
+        copilot: CopilotAssistant,
+        claude: ClaudeAssistant,
+        custom: CustomAssistant
     });
-    forEach(types, callback) {
-        if (typeof types === 'function') {
-            callback = types;
-            types = assistantTypes;
-        }
-        else {
-            if (typeof callback !== 'function')
-                throw new Error('Callback is required');
+    /**
+     * Gets an assistant class by pack config type
+     * @param type - The pack config type
+     * @returns The assistant class
+     */
+    getAssistantClass(type) {
+        const assistantClass = AssistantManager.ASSISTANTS[type];
+        if (!assistantClass) {
+            throw new Error(`Unknown assistant type: ${type}`);
         }
-        types.forEach(type => callback(AssistantManager.ASSISTANTS[type]));
+        return assistantClass;
+    }
+    /**
+     * Creates a new assistant instance by pack config type
+     * @param type - The pack config type
+     * @returns A new assistant instance
+     */
+    createAssistant(type) {
+        const AssistantClass = this.getAssistantClass(type);
+        return new AssistantClass();
     }
     /**
-     * Gets an assistant by type
-     * @param type - The assistant type
-     * @returns The Assistant instance
+     * Removes a prompt file for the given pack configuration.
+     * @param config - The pack configuration
+     * @param fs - The file system interface
      */
-    get(type) {
-        return AssistantManager.ASSISTANTS[type];
+    async removePack(config, fs) {
+        const assistant = this.createAssistant(config.type);
+        await assistant.remove(config, fs);
     }
 }
+/** Singleton instance of AssistantManager for convenient access */
+export const assistantManager = new AssistantManager();
 //# sourceMappingURL=assistant-manager.js.map

package/dist/assistant-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"assistant-manager.js","sourceRoot":"","sources":["../src/assistant-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,cAAc,EAAC,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAC,SAAS,EAAC,MAAM,gBAAgB,CAAC;AAIzC;;GAEG;AACH,MAAM,OAAO,gBAAgB;IACnB,MAAM,CAAU,UAAU,GAA+C,MAAM,CAAC,MAAM,CAAC;QAC7F,OAAO,EAAE,IAAI,SAAS,CAAC,SAAS,EAAE,iCAAiC,CAAC;QACpE,MAAM,EAAE,IAAI,SAAS,CAAC,QAAQ,EAAE,mBAAmB,CAAC;KACrD,CAAC,CAAC;IAaH,OAAO,CAAC,KAAmD,EAAE,QAA4B;QACvF,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;YAChC,QAAQ,GAAG,KAAK,CAAC;YACjB,KAAK,GAAG,cAAc,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,IAAI,OAAO,QAAQ,KAAK,UAAU;gBAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAA;QAC7E,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,IAAmB;QACrB,OAAO,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;IAC1C,CAAC"}
+{"version":3,"file":"assistant-manager.js","sourceRoot":"","sources":["../src/assistant-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAA6B,MAAM,uBAAuB,CAAC;AAKrH;;GAEG;AACH,MAAM,OAAO,gBAAgB;IACnB,MAAM,CAAU,UAAU,GAA2D,MAAM,CAAC,MAAM,CAAC;QACzG,OAAO,EAAE,gBAAgB;QACzB,MAAM,EAAE,eAAe;QACvB,MAAM,EAAE,eAAe;KACxB,CAAC,CAAC;IAEH;;;;OAIG;IACH,iBAAiB,CAAC,IAAoB;QACpC,MAAM,cAAc,GAAG,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,cAAc,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACH,eAAe,CAAC,IAAoB;QAClC,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACpD,OAAO,IAAI,cAAc,EAAE,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,MAAwB,EAAE,EAAc;QACvD,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACpD,MAAM,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACrC,CAAC;;AAGH,mEAAmE;AACnE,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,EAAE,CAAC"}

package/dist/assistant.type.d.ts

@@ -1,4 +1,5 @@
 /** Supported AI assistant types */
 export declare const assistantTypes: readonly ["copilot", "claude"];
 export type AssistantType = typeof assistantTypes[number];
+export type FrontMatter = Record<string, string>;
 //# sourceMappingURL=assistant.type.d.ts.map

package/dist/assistant.type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assistant.type.d.ts","sourceRoot":"","sources":["../src/assistant.type.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,eAAO,MAAM,cAAc,gCAAiC,CAAC;AAC7D,MAAM,MAAM,aAAa,GAAG,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"assistant.type.d.ts","sourceRoot":"","sources":["../src/assistant.type.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,eAAO,MAAM,cAAc,gCAAiC,CAAC;AAC7D,MAAM,MAAM,aAAa,GAAG,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;AAC1D,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC"}

package/dist/assistants/base.d.ts

@@ -0,0 +1,66 @@
+import { AgentConfig, PackConfig, RemovePackConfig } from '../config.type.js';
+import { FileSystem } from '../file-system.type.js';
+export interface AssistantAgentConfig {
+    name: string;
+    names: string;
+    promptPath: (config: RemovePackConfig) => string;
+}
+/**
+ * Base class for all assistant implementations.
+ * Provides validation and writing capabilities for assistant-specific prompt configurations.
+ */
+export declare class Assistant {
+    /**
+     * Indicates the assistant's terminology for agents.
+     * - String value: the term used (e.g., "agent" for Copilot, "skill" for Claude)
+     * - false: assistant does not support agents
+     */
+    static readonly agents: AssistantAgentConfig | false;
+    static readonly promptPath: string | ((config: RemovePackConfig) => string);
+    /**
+     * Validates a pack configuration for this assistant type.
+     * Throws an error if the configuration is invalid.
+     * @param config - The pack configuration to validate
+     */
+    static validate(config: PackConfig): void;
+    /**
+     * Writes a prompt to the file system according to the pack configuration.
+     * Subclasses should override this method.
+     * @param config - The pack configuration
+     * @param fs - The file system interface
+     * @param prompt - The prompt content to write
+     */
+    write(config: PackConfig, fs: FileSystem, prompt: string): Promise<void>;
+    /**
+     * Removes a prompt file from the file system according to the pack configuration.
+     * Subclasses should override this method.
+     * @param config - The pack configuration
+     * @param fs - The file system interface
+     */
+    remove(config: RemovePackConfig, fs: FileSystem): Promise<void>;
+    promptPath(config: RemovePackConfig): string;
+    protected get agents(): AssistantAgentConfig;
+    /**
+     * Helper to write a file with frontmatter.
+     * @param fs - The file system interface
+     * @param path - The file path
+     * @param agent - The agent configuration
+     * @param prompt - The prompt content
+     */
+    protected writePromptWithFrontmatter(fs: FileSystem, path: string, agent: AgentConfig, prompt: string): Promise<void>;
+    /**
+     * Helper to write a root prompt file without frontmatter.
+     * @param fs - The file system interface
+     * @param path - The file path
+     * @param prompt - The prompt content
+     */
+    protected writePrompt(fs: FileSystem, path: string, prompt: string): Promise<void>;
+    /**
+     * Formats prompt content with YAML frontmatter.
+     * @param agent - The agent configuration
+     * @param prompt - The prompt content
+     * @returns Formatted content with frontmatter
+     */
+    protected formatWithFrontmatter(agent: AgentConfig, prompt: string): string;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/assistants/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/assistants/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAC,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAC,UAAU,EAAC,MAAM,wBAAwB,CAAC;AAGlD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,MAAM,CAAC;CAClD;AAED;;;GAGG;AACH,qBAAa,SAAS;IACpB;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,GAAG,KAAK,CAAS;IAC7D,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,gBAAgB,KAAK,MAAM,CAAC,CAAK;IAEhF;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IA+CzC;;;;;;OAMG;IACG,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ9E;;;;;OAKG;IACG,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAQrE,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM;IAa5C,SAAS,KAAK,MAAM,IAAI,oBAAoB,CAM3C;IAED;;;;;;OAMG;cACa,0BAA0B,CACxC,EAAE,EAAE,UAAU,EACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IAShB;;;;;OAKG;cACa,WAAW,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxF;;;;;OAKG;IACH,SAAS,CAAC,qBAAqB,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;CAW5E"}

package/dist/assistants/base.js

@@ -0,0 +1,146 @@
+import { dirname } from 'path';
+/**
+ * Base class for all assistant implementations.
+ * Provides validation and writing capabilities for assistant-specific prompt configurations.
+ */
+export class Assistant {
+    /**
+     * Indicates the assistant's terminology for agents.
+     * - String value: the term used (e.g., "agent" for Copilot, "skill" for Claude)
+     * - false: assistant does not support agents
+     */
+    static agents = false;
+    static promptPath = '';
+    /**
+     * Validates a pack configuration for this assistant type.
+     * Throws an error if the configuration is invalid.
+     * @param config - The pack configuration to validate
+     */
+    static validate(config) {
+        // Validate pack name format: owner/pack/version
+        const packRegex = /^[a-z0-9_-]+\/[a-z0-9_-]+\/[a-z0-9_.-]+$/i;
+        if (!packRegex.test(config.pack)) {
+            throw new Error(`Invalid pack name format: ${config.pack}. Expected format: owner/pack/version`);
+        }
+        // Validate environment if provided
+        if (config.environment && !['development', 'local'].includes(config.environment)) {
+            throw new Error(`Invalid environment: ${config.environment}. Must be 'development' or 'local'`);
+        }
+        // Validate agent config if provided
+        if ('agent' in config && config.agent) {
+            if (this.agents === false) {
+                throw new Error(`${config.type} does not support agents`);
+            }
+            if (!config.agent.name) {
+                throw new Error('Agent name is required');
+            }
+            // Validate agent name format: lowercase alphanumeric, hyphens, underscores
+            const nameRegex = /^[a-z0-9_-]+$/;
+            if (!nameRegex.test(config.agent.name)) {
+                throw new Error(`Invalid agent name: ${config.agent.name}. Must contain only lowercase letters, numbers, hyphens, and underscores`);
+            }
+            // Validate all frontmatter values are strings
+            for (const [key, value] of Object.entries(config.agent)) {
+                if (value !== undefined && typeof value !== 'string') {
+                    throw new Error(`Agent frontmatter value for '${key}' must be a string, got ${typeof value}`);
+                }
+            }
+        }
+        // Custom type must have path
+        if (config.type === 'custom' && !config.path) {
+            throw new Error('Custom pack configuration must include a path');
+        }
+        // Non-custom types must not have path
+        if (config.type !== 'custom' && 'path' in config) {
+            throw new Error(`Path is only allowed for custom pack configurations, not for ${config.type}`);
+        }
+    }
+    /**
+     * Writes a prompt to the file system according to the pack configuration.
+     * Subclasses should override this method.
+     * @param config - The pack configuration
+     * @param fs - The file system interface
+     * @param prompt - The prompt content to write
+     */
+    async write(config, fs, prompt) {
+        if ('agent' in config && config.agent) {
+            await this.writePromptWithFrontmatter(fs, this.promptPath(config), config.agent, prompt);
+        }
+        else {
+            await this.writePrompt(fs, this.promptPath(config), prompt);
+        }
+    }
+    /**
+     * Removes a prompt file from the file system according to the pack configuration.
+     * Subclasses should override this method.
+     * @param config - The pack configuration
+     * @param fs - The file system interface
+     */
+    async remove(config, fs) {
+        if ('agent' in config && config.agent) {
+            await fs.delete(this.agents.promptPath(config));
+        }
+        else {
+            await fs.delete(this.promptPath(config));
+        }
+    }
+    promptPath(config) {
+        if ('agent' in config && config.agent) {
+            return this.agents.promptPath(config);
+        }
+        const promptPath = this.constructor['promptPath'];
+        if (typeof promptPath === 'string') {
+            return promptPath;
+        }
+        else {
+            return promptPath(config);
+        }
+    }
+    get agents() {
+        const agents = this.constructor['agents'];
+        if (!agents) {
+            throw new Error('This assistant does not support agents');
+        }
+        return agents;
+    }
+    /**
+     * Helper to write a file with frontmatter.
+     * @param fs - The file system interface
+     * @param path - The file path
+     * @param agent - The agent configuration
+     * @param prompt - The prompt content
+     */
+    async writePromptWithFrontmatter(fs, path, agent, prompt) {
+        if (!agent) {
+            throw new Error('Agent config is required for frontmatter');
+        }
+        const content = this.formatWithFrontmatter(agent, prompt);
+        await this.writePrompt(fs, path, content);
+    }
+    /**
+     * Helper to write a root prompt file without frontmatter.
+     * @param fs - The file system interface
+     * @param path - The file path
+     * @param prompt - The prompt content
+     */
+    async writePrompt(fs, path, prompt) {
+        await fs.createDir(dirname(path));
+        await fs.write(path, prompt);
+    }
+    /**
+     * Formats prompt content with YAML frontmatter.
+     * @param agent - The agent configuration
+     * @param prompt - The prompt content
+     * @returns Formatted content with frontmatter
+     */
+    formatWithFrontmatter(agent, prompt) {
+        if (!agent) {
+            throw new Error('Agent config is required for frontmatter');
+        }
+        const frontmatterLines = Object.entries(agent)
+            .filter(([_, value]) => value !== undefined)
+            .map(([key, value]) => `${key}: ${value}`);
+        return `---\n${frontmatterLines.join('\n')}\n---\n\n${prompt}`;
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/assistants/base.js.map

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

package/dist/assistants/claude.d.ts

@@ -0,0 +1,15 @@
+import { Assistant } from './base.js';
+import { RemovePackConfig } from "../config.type.js";
+/**
+ * Claude assistant implementation.
+ * Supports both root prompts and skill-specific prompts.
+ */
+export declare class ClaudeAssistant extends Assistant {
+    static readonly promptPath = ".claude/system.md";
+    static readonly agents: {
+        name: string;
+        names: string;
+        promptPath: (config: RemovePackConfig) => string;
+    };
+}
+//# sourceMappingURL=claude.d.ts.map

package/dist/assistants/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/assistants/claude.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,WAAW,CAAC;AACpC,OAAO,EAA4B,gBAAgB,EAAC,MAAM,mBAAmB,CAAC;AAE9E;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,MAAM,CAAC,QAAQ,CAAC,UAAU,uBAAsB;IAChD,MAAM,CAAC,QAAQ,CAAC,MAAM;;;6BAGC,gBAAgB;MACrC;CACH"}

package/dist/assistants/claude.js

@@ -0,0 +1,14 @@
+import { Assistant } from './base.js';
+/**
+ * Claude assistant implementation.
+ * Supports both root prompts and skill-specific prompts.
+ */
+export class ClaudeAssistant extends Assistant {
+    static promptPath = '.claude/system.md';
+    static agents = {
+        name: 'skill',
+        names: 'skills',
+        promptPath: (config) => `.claude/skills/${config.agent.name}/SKILL.md`
+    };
+}
+//# sourceMappingURL=claude.js.map