@orchestrator-claude/sdk 1.11.3

package/README.md

@@ -0,0 +1,170 @@
+# @orchestrator/sdk
+
+Programmatic SDK for Orchestrator - Create and manage agents, workflows, and skills via code.
+
+## Installation
+
+```bash
+npm install @orchestrator/sdk
+```
+
+## Quick Start
+
+```typescript
+import { OrchestratorSDK } from '@orchestrator/sdk';
+
+// Initialize SDK
+const sdk = new OrchestratorSDK({ projectPath: '.' });
+
+// Create an agent
+const agent = sdk.agents.create({
+  name: 'my-agent',
+  displayName: 'My Custom Agent',
+  prompt: 'You are a helpful assistant...',
+  capabilities: ['code-generation', 'documentation']
+});
+
+await sdk.agents.save(agent);
+```
+
+## Features
+
+- **Type-safe API**: Full TypeScript support with strict types
+- **Fluent interface**: Chainable methods for easy usage
+- **Event-driven**: Emits domain events for observability
+- **Local & Remote**: Supports both local file and remote API modes
+
+## API Overview
+
+### Agents API
+
+```typescript
+// Create agent
+const agent = sdk.agents.create({
+  name: 'code-reviewer',
+  prompt: 'You are an expert code reviewer...',
+  capabilities: ['code-review', 'security-analysis'],
+  tools: ['git', 'grep']
+});
+
+await sdk.agents.save(agent);
+
+// List agents
+const agents = await sdk.agents.list({ tier: 'user' });
+
+// Get agent
+const agent = await sdk.agents.get('code-reviewer');
+
+// Clone agent
+const cloned = await sdk.agents.clone('specifier', 'my-specifier', {
+  prompt: 'Custom prompt...'
+});
+
+// Delete agent
+await sdk.agents.delete('my-agent');
+```
+
+### Workflows API
+
+```typescript
+// Create workflow definition
+const definition = sdk.workflows.createDefinition({
+  name: 'Custom Workflow',
+  description: 'A custom development workflow',
+  phases: [
+    { id: 'research', name: 'Research', agent: 'researcher' },
+    { id: 'plan', name: 'Plan', agent: 'planner' },
+    { id: 'implement', name: 'Implement', agent: 'implementer' }
+  ],
+  approvalPoints: [
+    { beforePhase: 'implement', message: 'Approve implementation?' }
+  ]
+});
+
+await sdk.workflows.saveDefinition(definition);
+
+// Start workflow instance
+const workflow = await sdk.workflows.start('custom-workflow', 'project-123');
+
+// Get workflow instance
+const instance = await sdk.workflows.getInstance(workflow.id);
+
+// List definitions
+const definitions = await sdk.workflows.listDefinitions({ tier: 'user' });
+
+// List instances
+const instances = await sdk.workflows.listInstances({ status: 'active' });
+```
+
+### Skills API
+
+```typescript
+// Create skill
+const skill = sdk.skills.create({
+  name: 'code-analyzer',
+  description: 'Analyzes code quality',
+  trigger: {
+    type: 'command',
+    value: 'analyze-code'
+  },
+  promptTemplate: 'Analyze this code for quality and security: {{input}}'
+});
+
+await sdk.skills.save(skill);
+
+// List skills
+const skills = await sdk.skills.list({ triggerType: 'command' });
+
+// Get skill
+const skill = await sdk.skills.get('code-analyzer');
+
+// Delete skill
+await sdk.skills.delete('my-skill');
+```
+
+## Configuration
+
+```typescript
+const sdk = new OrchestratorSDK({
+  // Project root path (default: process.cwd())
+  projectPath: '/path/to/project',
+
+  // API URL for remote mode (optional)
+  apiUrl: 'https://api.orchestrator.dev',
+
+  // Operation mode (default: 'local')
+  mode: 'local' // or 'remote'
+});
+```
+
+## Type Definitions
+
+All SDK types are fully typed with TypeScript:
+
+```typescript
+import type {
+  AgentDefinition,
+  CreateAgentConfig,
+  WorkflowDefinition,
+  CreateWorkflowDefinitionConfig,
+  SkillDefinition,
+  CreateSkillConfig
+} from '@orchestrator/sdk';
+```
+
+## Examples
+
+See the [examples](./examples) directory for complete usage examples:
+
+- `create-agent.ts` - Create custom agents
+- `create-workflow.ts` - Create workflow definitions
+- `start-workflow.ts` - Start and manage workflows
+- `create-skill.ts` - Create custom skills
+
+## Documentation
+
+See [API Documentation](./docs/API.md) for detailed API reference.
+
+## License
+
+MIT

package/dist/OrchestratorSDK.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Main entry point for Orchestrator SDK
+ */
+import { AgentAPI } from './agents/AgentAPI.js';
+import { WorkflowAPI } from './workflows/WorkflowAPI.js';
+import { SkillAPI } from './skills/SkillAPI.js';
+/**
+ * SDK configuration options
+ */
+export interface SDKConfig {
+    /**
+     * Project root path. Defaults to current working directory.
+     */
+    projectPath?: string;
+    /**
+     * API URL for remote mode
+     */
+    apiUrl?: string;
+    /**
+     * Operation mode: local file system or remote API
+     * @default 'local'
+     */
+    mode?: 'local' | 'remote';
+}
+/**
+ * Main SDK class providing access to all Orchestrator APIs
+ *
+ * @example
+ * ```typescript
+ * const sdk = new OrchestratorSDK({ projectPath: '.' });
+ * const agent = sdk.agents.create({ name: 'my-agent', prompt: '...' });
+ * await sdk.agents.save(agent);
+ * ```
+ */
+export declare class OrchestratorSDK {
+    private readonly config;
+    private _agents?;
+    private _workflows?;
+    private _skills?;
+    /**
+     * Create a new SDK instance
+     *
+     * @param config - SDK configuration options
+     */
+    constructor(config?: SDKConfig);
+    /**
+     * Get the Agent API for managing agent definitions
+     *
+     * Lazily initialized on first access.
+     */
+    get agents(): AgentAPI;
+    /**
+     * Get the Workflow API for managing workflow definitions and instances
+     *
+     * Lazily initialized on first access.
+     */
+    get workflows(): WorkflowAPI;
+    /**
+     * Get the Skill API for managing skill definitions
+     *
+     * Lazily initialized on first access.
+     */
+    get skills(): SkillAPI;
+    /**
+     * Get the current SDK configuration
+     */
+    getConfig(): Readonly<Required<SDKConfig>>;
+}
+//# sourceMappingURL=OrchestratorSDK.d.ts.map

package/dist/OrchestratorSDK.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrchestratorSDK.d.ts","sourceRoot":"","sources":["../src/OrchestratorSDK.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;CAC3B;AAED;;;;;;;;;GASG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,OAAO,CAAC,CAAW;IAC3B,OAAO,CAAC,UAAU,CAAC,CAAc;IACjC,OAAO,CAAC,OAAO,CAAC,CAAW;IAE3B;;;;OAIG;gBACS,MAAM,CAAC,EAAE,SAAS;IAQ9B;;;;OAIG;IACH,IAAI,MAAM,IAAI,QAAQ,CAKrB;IAED;;;;OAIG;IACH,IAAI,SAAS,IAAI,WAAW,CAK3B;IAED;;;;OAIG;IACH,IAAI,MAAM,IAAI,QAAQ,CAKrB;IAED;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;CAG3C"}

package/dist/OrchestratorSDK.js

@@ -0,0 +1,74 @@
+/**
+ * Main entry point for Orchestrator SDK
+ */
+import { AgentAPI } from './agents/AgentAPI.js';
+import { WorkflowAPI } from './workflows/WorkflowAPI.js';
+import { SkillAPI } from './skills/SkillAPI.js';
+/**
+ * Main SDK class providing access to all Orchestrator APIs
+ *
+ * @example
+ * ```typescript
+ * const sdk = new OrchestratorSDK({ projectPath: '.' });
+ * const agent = sdk.agents.create({ name: 'my-agent', prompt: '...' });
+ * await sdk.agents.save(agent);
+ * ```
+ */
+export class OrchestratorSDK {
+    config;
+    _agents;
+    _workflows;
+    _skills;
+    /**
+     * Create a new SDK instance
+     *
+     * @param config - SDK configuration options
+     */
+    constructor(config) {
+        this.config = {
+            projectPath: config?.projectPath ?? process.cwd(),
+            apiUrl: config?.apiUrl ?? '',
+            mode: config?.mode ?? 'local',
+        };
+    }
+    /**
+     * Get the Agent API for managing agent definitions
+     *
+     * Lazily initialized on first access.
+     */
+    get agents() {
+        if (!this._agents) {
+            this._agents = new AgentAPI(this.config.projectPath);
+        }
+        return this._agents;
+    }
+    /**
+     * Get the Workflow API for managing workflow definitions and instances
+     *
+     * Lazily initialized on first access.
+     */
+    get workflows() {
+        if (!this._workflows) {
+            this._workflows = new WorkflowAPI(this.config.projectPath);
+        }
+        return this._workflows;
+    }
+    /**
+     * Get the Skill API for managing skill definitions
+     *
+     * Lazily initialized on first access.
+     */
+    get skills() {
+        if (!this._skills) {
+            this._skills = new SkillAPI(this.config.projectPath);
+        }
+        return this._skills;
+    }
+    /**
+     * Get the current SDK configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+}
+//# sourceMappingURL=OrchestratorSDK.js.map

package/dist/OrchestratorSDK.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrchestratorSDK.js","sourceRoot":"","sources":["../src/OrchestratorSDK.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAuBhD;;;;;;;;;GASG;AACH,MAAM,OAAO,eAAe;IACT,MAAM,CAAsB;IACrC,OAAO,CAAY;IACnB,UAAU,CAAe;IACzB,OAAO,CAAY;IAE3B;;;;OAIG;IACH,YAAY,MAAkB;QAC5B,IAAI,CAAC,MAAM,GAAG;YACZ,WAAW,EAAE,MAAM,EAAE,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE;YACjD,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,EAAE;YAC5B,IAAI,EAAE,MAAM,EAAE,IAAI,IAAI,OAAO;SAC9B,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,IAAI,MAAM;QACR,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,CAAC,OAAO,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;;OAIG;IACH,IAAI,SAAS;QACX,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,IAAI,CAAC,UAAU,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACH,IAAI,MAAM;QACR,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,CAAC,OAAO,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;CACF"}

package/dist/agents/AgentAPI.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Agent API for managing agent definitions
+ */
+import type { AgentDefinition, CreateAgentConfig, AgentFilter } from '../types/Agent.js';
+/**
+ * API for creating and managing agent definitions
+ *
+ * @example
+ * ```typescript
+ * const agent = sdk.agents.create({
+ *   name: 'code-reviewer',
+ *   prompt: 'You are an expert code reviewer...',
+ *   capabilities: ['code-review', 'security-analysis']
+ * });
+ * await sdk.agents.save(agent);
+ * ```
+ */
+export declare class AgentAPI {
+    private readonly _projectPath;
+    constructor(_projectPath: string);
+    /**
+     * Get project path (used by repository implementations)
+     * @internal
+     */
+    protected getProjectPath(): string;
+    /**
+     * Create a new agent definition
+     *
+     * @param config - Agent configuration
+     * @returns Agent definition (not yet persisted)
+     *
+     * @example
+     * ```typescript
+     * const agent = sdk.agents.create({
+     *   name: 'My Agent',
+     *   prompt: 'You are a helpful assistant...'
+     * });
+     * ```
+     */
+    create(config: CreateAgentConfig): AgentDefinition;
+    /**
+     * Save an agent definition to the repository
+     *
+     * @param agent - Agent definition to save
+     * @throws {Error} If agent is invalid or cannot be saved
+     *
+     * @example
+     * ```typescript
+     * await sdk.agents.save(agent);
+     * ```
+     */
+    save(agent: AgentDefinition): Promise<void>;
+    /**
+     * List all agent definitions
+     *
+     * @param filter - Optional filter criteria
+     * @returns Array of agent definitions
+     *
+     * @example
+     * ```typescript
+     * const agents = await sdk.agents.list({ tier: 'user' });
+     * ```
+     */
+    list(filter?: AgentFilter): Promise<AgentDefinition[]>;
+    /**
+     * Get a specific agent by slug
+     *
+     * @param slug - Agent slug
+     * @returns Agent definition or null if not found
+     *
+     * @example
+     * ```typescript
+     * const agent = await sdk.agents.get('my-agent');
+     * ```
+     */
+    get(slug: string): Promise<AgentDefinition | null>;
+    /**
+     * Clone an existing agent with optional overrides
+     *
+     * @param sourceSlug - Source agent slug
+     * @param newSlug - New agent slug
+     * @param overrides - Optional configuration overrides
+     * @returns New agent definition
+     * @throws {Error} If source agent not found
+     *
+     * @example
+     * ```typescript
+     * const cloned = await sdk.agents.clone('specifier', 'my-specifier', {
+     *   prompt: 'Custom prompt...'
+     * });
+     * ```
+     */
+    clone(sourceSlug: string, newSlug: string, overrides?: Partial<CreateAgentConfig>): Promise<AgentDefinition>;
+    /**
+     * Delete an agent definition
+     *
+     * @param slug - Agent slug to delete
+     * @throws {Error} If agent is builtin or cannot be deleted
+     *
+     * @example
+     * ```typescript
+     * await sdk.agents.delete('my-agent');
+     * ```
+     */
+    delete(slug: string): Promise<void>;
+    /**
+     * Validate agent configuration
+     */
+    private validateConfig;
+    /**
+     * Validate agent definition
+     */
+    private validateAgent;
+    /**
+     * Convert name to slug format
+     */
+    private slugify;
+}
+//# sourceMappingURL=AgentAPI.d.ts.map

package/dist/agents/AgentAPI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentAPI.d.ts","sourceRoot":"","sources":["../../src/agents/AgentAPI.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;GAYG;AACH,qBAAa,QAAQ;IAEP,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAAZ,YAAY,EAAE,MAAM;IAEjD;;;OAGG;IACH,SAAS,CAAC,cAAc,IAAI,MAAM;IAIlC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,eAAe;IAqBlD;;;;;;;;;;OAUG;IACG,IAAI,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjD;;;;;;;;;;OAUG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAM5D;;;;;;;;;;OAUG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAUxD;;;;;;;;;;;;;;;OAeG;IACG,KAAK,CACT,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACrC,OAAO,CAAC,eAAe,CAAC;IAkC3B;;;;;;;;;;OAUG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAczC;;OAEG;IACH,OAAO,CAAC,cAAc;IAsBtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAcrB;;OAEG;IACH,OAAO,CAAC,OAAO;CAQhB"}

package/dist/agents/AgentAPI.js

@@ -0,0 +1,227 @@
+/**
+ * Agent API for managing agent definitions
+ */
+/**
+ * API for creating and managing agent definitions
+ *
+ * @example
+ * ```typescript
+ * const agent = sdk.agents.create({
+ *   name: 'code-reviewer',
+ *   prompt: 'You are an expert code reviewer...',
+ *   capabilities: ['code-review', 'security-analysis']
+ * });
+ * await sdk.agents.save(agent);
+ * ```
+ */
+export class AgentAPI {
+    _projectPath;
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    constructor(_projectPath) {
+        this._projectPath = _projectPath;
+    }
+    /**
+     * Get project path (used by repository implementations)
+     * @internal
+     */
+    getProjectPath() {
+        return this._projectPath;
+    }
+    /**
+     * Create a new agent definition
+     *
+     * @param config - Agent configuration
+     * @returns Agent definition (not yet persisted)
+     *
+     * @example
+     * ```typescript
+     * const agent = sdk.agents.create({
+     *   name: 'My Agent',
+     *   prompt: 'You are a helpful assistant...'
+     * });
+     * ```
+     */
+    create(config) {
+        this.validateConfig(config);
+        const slug = this.slugify(config.name);
+        const now = new Date().toISOString();
+        return {
+            slug,
+            name: config.name,
+            ...(config.displayName && { displayName: config.displayName }),
+            ...(config.description && { description: config.description }),
+            prompt: config.prompt,
+            ...(config.capabilities && { capabilities: config.capabilities }),
+            ...(config.tools && { tools: config.tools }),
+            ...(config.modelPreference && { modelPreference: config.modelPreference }),
+            tier: config.tier ?? 'user',
+            createdAt: now,
+            updatedAt: now,
+        };
+    }
+    /**
+     * Save an agent definition to the repository
+     *
+     * @param agent - Agent definition to save
+     * @throws {Error} If agent is invalid or cannot be saved
+     *
+     * @example
+     * ```typescript
+     * await sdk.agents.save(agent);
+     * ```
+     */
+    async save(agent) {
+        this.validateAgent(agent);
+        // TODO: Implement persistence via repository
+        // For now, just validate
+        console.log(`[SDK] Would save agent: ${agent.slug}`);
+    }
+    /**
+     * List all agent definitions
+     *
+     * @param filter - Optional filter criteria
+     * @returns Array of agent definitions
+     *
+     * @example
+     * ```typescript
+     * const agents = await sdk.agents.list({ tier: 'user' });
+     * ```
+     */
+    async list(filter) {
+        // TODO: Implement via repository
+        console.log(`[SDK] Would list agents with filter:`, filter);
+        return [];
+    }
+    /**
+     * Get a specific agent by slug
+     *
+     * @param slug - Agent slug
+     * @returns Agent definition or null if not found
+     *
+     * @example
+     * ```typescript
+     * const agent = await sdk.agents.get('my-agent');
+     * ```
+     */
+    async get(slug) {
+        if (!slug || typeof slug !== 'string') {
+            throw new Error('Agent slug is required and must be a string');
+        }
+        // TODO: Implement via repository
+        console.log(`[SDK] Would get agent: ${slug}`);
+        return null;
+    }
+    /**
+     * Clone an existing agent with optional overrides
+     *
+     * @param sourceSlug - Source agent slug
+     * @param newSlug - New agent slug
+     * @param overrides - Optional configuration overrides
+     * @returns New agent definition
+     * @throws {Error} If source agent not found
+     *
+     * @example
+     * ```typescript
+     * const cloned = await sdk.agents.clone('specifier', 'my-specifier', {
+     *   prompt: 'Custom prompt...'
+     * });
+     * ```
+     */
+    async clone(sourceSlug, newSlug, overrides) {
+        const source = await this.get(sourceSlug);
+        if (!source) {
+            throw new Error(`Source agent not found: ${sourceSlug}`);
+        }
+        if (await this.get(newSlug)) {
+            throw new Error(`Agent with slug '${newSlug}' already exists`);
+        }
+        const now = new Date().toISOString();
+        // Build cloned agent with only defined optional properties
+        const displayName = overrides?.displayName ?? source.displayName;
+        const description = overrides?.description ?? source.description;
+        const capabilities = overrides?.capabilities ?? source.capabilities;
+        const tools = overrides?.tools ?? source.tools;
+        const modelPreference = overrides?.modelPreference ?? source.modelPreference;
+        return {
+            slug: newSlug,
+            name: overrides?.name ?? source.name,
+            ...(displayName !== undefined && { displayName }),
+            ...(description !== undefined && { description }),
+            prompt: overrides?.prompt ?? source.prompt,
+            ...(capabilities !== undefined && { capabilities }),
+            ...(tools !== undefined && { tools }),
+            ...(modelPreference !== undefined && { modelPreference }),
+            tier: 'user', // Clones are always user-tier
+            createdAt: now,
+            updatedAt: now,
+        };
+    }
+    /**
+     * Delete an agent definition
+     *
+     * @param slug - Agent slug to delete
+     * @throws {Error} If agent is builtin or cannot be deleted
+     *
+     * @example
+     * ```typescript
+     * await sdk.agents.delete('my-agent');
+     * ```
+     */
+    async delete(slug) {
+        const agent = await this.get(slug);
+        if (!agent) {
+            throw new Error(`Agent not found: ${slug}`);
+        }
+        if (agent.tier === 'builtin') {
+            throw new Error('Cannot delete builtin agents');
+        }
+        // TODO: Implement via repository
+        console.log(`[SDK] Would delete agent: ${slug}`);
+    }
+    /**
+     * Validate agent configuration
+     */
+    validateConfig(config) {
+        if (!config.name || typeof config.name !== 'string') {
+            throw new Error('Agent name is required and must be a string');
+        }
+        if (!config.prompt || typeof config.prompt !== 'string') {
+            throw new Error('Agent prompt is required and must be a string');
+        }
+        if (config.name.length < 3) {
+            throw new Error('Agent name must be at least 3 characters');
+        }
+        if (config.prompt.length < 10) {
+            throw new Error('Agent prompt must be at least 10 characters');
+        }
+        if (config.tier && !['user', 'community'].includes(config.tier)) {
+            throw new Error('Agent tier must be "user" or "community"');
+        }
+    }
+    /**
+     * Validate agent definition
+     */
+    validateAgent(agent) {
+        if (!agent.slug || typeof agent.slug !== 'string') {
+            throw new Error('Agent slug is required');
+        }
+        if (!agent.name || typeof agent.name !== 'string') {
+            throw new Error('Agent name is required');
+        }
+        if (!agent.prompt || typeof agent.prompt !== 'string') {
+            throw new Error('Agent prompt is required');
+        }
+    }
+    /**
+     * Convert name to slug format
+     */
+    slugify(name) {
+        return name
+            .toLowerCase()
+            .trim()
+            .replace(/[^a-z0-9\s-]/g, '')
+            .replace(/\s+/g, '-')
+            .replace(/-+/g, '-');
+    }
+}
+//# sourceMappingURL=AgentAPI.js.map

package/dist/agents/AgentAPI.js.map

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

package/dist/agents/index.d.ts

@@ -0,0 +1,2 @@
+export { AgentAPI } from './AgentAPI.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/agents/index.js

@@ -0,0 +1,2 @@
+export { AgentAPI } from './AgentAPI.js';
+//# sourceMappingURL=index.js.map