@orchestrator-claude/sdk 1.11.3

package/dist/types/Workflow.d.ts

@@ -0,0 +1,225 @@
+/**
+ * Workflow-related type definitions
+ */
+/**
+ * Workflow definition (template)
+ */
+export interface WorkflowDefinition {
+    /**
+     * Unique slug
+     */
+    readonly slug: string;
+    /**
+     * Display name
+     */
+    name: string;
+    /**
+     * Description
+     */
+    description?: string;
+    /**
+     * Workflow phases
+     */
+    phases: PhaseConfig[];
+    /**
+     * Phase transitions
+     */
+    transitions?: TransitionConfig[];
+    /**
+     * Approval points
+     */
+    approvalPoints?: ApprovalPointConfig[];
+    /**
+     * Definition tier
+     */
+    tier: 'builtin' | 'community' | 'user';
+    /**
+     * Creation timestamp
+     */
+    readonly createdAt: string;
+    /**
+     * Update timestamp
+     */
+    updatedAt: string;
+}
+/**
+ * Phase configuration
+ */
+export interface PhaseConfig {
+    /**
+     * Phase identifier
+     */
+    id: string;
+    /**
+     * Phase display name
+     */
+    name: string;
+    /**
+     * Agent to invoke
+     */
+    agent: string;
+    /**
+     * Phase description
+     */
+    description?: string;
+    /**
+     * Expected artifacts
+     */
+    artifacts?: string[];
+}
+/**
+ * Transition configuration
+ */
+export interface TransitionConfig {
+    /**
+     * From phase
+     */
+    from: string;
+    /**
+     * To phase
+     */
+    to: string;
+    /**
+     * Transition condition
+     */
+    condition?: string;
+}
+/**
+ * Approval point configuration
+ */
+export interface ApprovalPointConfig {
+    /**
+     * Before which phase
+     */
+    beforePhase: string;
+    /**
+     * Approval message
+     */
+    message: string;
+    /**
+     * Auto-approve condition
+     */
+    autoApproveIf?: string;
+}
+/**
+ * Workflow instance (running workflow)
+ */
+export interface Workflow {
+    /**
+     * Workflow instance ID
+     */
+    readonly id: string;
+    /**
+     * Definition slug used
+     */
+    definitionSlug: string;
+    /**
+     * Project ID
+     */
+    projectId: string;
+    /**
+     * Current phase
+     */
+    currentPhase: string;
+    /**
+     * Workflow status
+     */
+    status: 'active' | 'completed' | 'failed' | 'paused';
+    /**
+     * Phase history
+     */
+    phaseHistory: PhaseHistoryEntry[];
+    /**
+     * Created at
+     */
+    readonly createdAt: string;
+    /**
+     * Updated at
+     */
+    updatedAt: string;
+    /**
+     * Completed at
+     */
+    completedAt?: string;
+}
+/**
+ * Phase history entry
+ */
+export interface PhaseHistoryEntry {
+    /**
+     * Phase ID
+     */
+    phase: string;
+    /**
+     * Entry timestamp
+     */
+    enteredAt: string;
+    /**
+     * Exit timestamp
+     */
+    exitedAt?: string;
+    /**
+     * Phase status
+     */
+    status: 'running' | 'completed' | 'failed';
+}
+/**
+ * Configuration for creating workflow definition
+ */
+export interface CreateWorkflowDefinitionConfig {
+    /**
+     * Definition name
+     */
+    name: string;
+    /**
+     * Description
+     */
+    description?: string;
+    /**
+     * Phases
+     */
+    phases: PhaseConfig[];
+    /**
+     * Transitions (optional, defaults to sequential)
+     */
+    transitions?: TransitionConfig[];
+    /**
+     * Approval points
+     */
+    approvalPoints?: ApprovalPointConfig[];
+    /**
+     * Tier
+     */
+    tier?: 'user' | 'community';
+}
+/**
+ * Filter for workflow definitions
+ */
+export interface WorkflowFilter {
+    /**
+     * Filter by tier
+     */
+    tier?: 'builtin' | 'community' | 'user' | 'all';
+    /**
+     * Search term
+     */
+    search?: string;
+}
+/**
+ * Filter for workflow instances
+ */
+export interface InstanceFilter {
+    /**
+     * Filter by status
+     */
+    status?: 'active' | 'completed' | 'failed' | 'paused' | 'all';
+    /**
+     * Filter by project ID
+     */
+    projectId?: string;
+    /**
+     * Filter by definition slug
+     */
+    definitionSlug?: string;
+}
+//# sourceMappingURL=Workflow.d.ts.map

package/dist/types/Workflow.d.ts.map

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

package/dist/types/Workflow.js

@@ -0,0 +1,5 @@
+/**
+ * Workflow-related type definitions
+ */
+export {};
+//# sourceMappingURL=Workflow.js.map

package/dist/types/Workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Workflow.js","sourceRoot":"","sources":["../../src/types/Workflow.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Public type definitions for Orchestrator SDK
+ */
+export type { AgentDefinition, CreateAgentConfig, AgentFilter, ModelPreference, } from './Agent.js';
+export type { WorkflowDefinition, CreateWorkflowDefinitionConfig, WorkflowFilter, Workflow, InstanceFilter, PhaseConfig, TransitionConfig, ApprovalPointConfig, PhaseHistoryEntry, } from './Workflow.js';
+export type { SkillDefinition, CreateSkillConfig, SkillFilter, TriggerConfig, } from './Skill.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,kBAAkB,EAClB,8BAA8B,EAC9B,cAAc,EACd,QAAQ,EACR,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,5 @@
+/**
+ * Public type definitions for Orchestrator SDK
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/workflows/WorkflowAPI.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Workflow API for managing workflow definitions and instances
+ */
+import type { WorkflowDefinition, CreateWorkflowDefinitionConfig, WorkflowFilter, Workflow, InstanceFilter } from '../types/Workflow.js';
+/**
+ * API for creating and managing workflow definitions and instances
+ *
+ * @example
+ * ```typescript
+ * // Create definition
+ * const definition = sdk.workflows.createDefinition({
+ *   name: 'Custom Workflow',
+ *   phases: [
+ *     { id: 'research', name: 'Research', agent: 'researcher' },
+ *     { id: 'implement', name: 'Implement', agent: 'implementer' }
+ *   ]
+ * });
+ * await sdk.workflows.saveDefinition(definition);
+ *
+ * // Start instance
+ * const workflow = await sdk.workflows.start('custom-workflow', 'project-123');
+ * ```
+ */
+export declare class WorkflowAPI {
+    private readonly _projectPath;
+    constructor(_projectPath: string);
+    /**
+     * Get project path (used by repository implementations)
+     * @internal
+     */
+    protected getProjectPath(): string;
+    /**
+     * Create a new workflow definition
+     *
+     * @param config - Workflow configuration
+     * @returns Workflow definition (not yet persisted)
+     *
+     * @example
+     * ```typescript
+     * const definition = sdk.workflows.createDefinition({
+     *   name: 'My Workflow',
+     *   phases: [{ id: 'plan', name: 'Plan', agent: 'planner' }]
+     * });
+     * ```
+     */
+    createDefinition(config: CreateWorkflowDefinitionConfig): WorkflowDefinition;
+    /**
+     * Save a workflow definition
+     *
+     * @param definition - Workflow definition to save
+     * @throws {Error} If definition is invalid
+     *
+     * @example
+     * ```typescript
+     * await sdk.workflows.saveDefinition(definition);
+     * ```
+     */
+    saveDefinition(definition: WorkflowDefinition): Promise<void>;
+    /**
+     * List workflow definitions
+     *
+     * @param filter - Optional filter
+     * @returns Array of definitions
+     *
+     * @example
+     * ```typescript
+     * const definitions = await sdk.workflows.listDefinitions({ tier: 'user' });
+     * ```
+     */
+    listDefinitions(filter?: WorkflowFilter): Promise<WorkflowDefinition[]>;
+    /**
+     * Get workflow definition by slug
+     *
+     * @param slug - Definition slug
+     * @returns Definition or null
+     *
+     * @example
+     * ```typescript
+     * const definition = await sdk.workflows.getDefinition('my-workflow');
+     * ```
+     */
+    getDefinition(slug: string): Promise<WorkflowDefinition | null>;
+    /**
+     * Start a workflow instance from a definition
+     *
+     * @param definitionSlug - Definition to use
+     * @param projectId - Project ID
+     * @returns Running workflow instance
+     * @throws {Error} If definition not found
+     *
+     * @example
+     * ```typescript
+     * const workflow = await sdk.workflows.start('my-workflow', 'project-123');
+     * ```
+     */
+    start(definitionSlug: string, projectId: string): Promise<Workflow>;
+    /**
+     * Get workflow instance by ID
+     *
+     * @param workflowId - Workflow instance ID
+     * @returns Workflow or null
+     *
+     * @example
+     * ```typescript
+     * const workflow = await sdk.workflows.getInstance('wf_123');
+     * ```
+     */
+    getInstance(workflowId: string): Promise<Workflow | null>;
+    /**
+     * List workflow instances
+     *
+     * @param filter - Optional filter
+     * @returns Array of workflows
+     *
+     * @example
+     * ```typescript
+     * const workflows = await sdk.workflows.listInstances({ status: 'active' });
+     * ```
+     */
+    listInstances(filter?: InstanceFilter): Promise<Workflow[]>;
+    /**
+     * Validate definition configuration
+     */
+    private validateDefinitionConfig;
+    /**
+     * Validate workflow definition
+     */
+    private validateDefinition;
+    /**
+     * Convert name to slug
+     */
+    private slugify;
+}
+//# sourceMappingURL=WorkflowAPI.d.ts.map

package/dist/workflows/WorkflowAPI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowAPI.d.ts","sourceRoot":"","sources":["../../src/workflows/WorkflowAPI.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,8BAA8B,EAC9B,cAAc,EACd,QAAQ,EACR,cAAc,EACf,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,WAAW;IAEV,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAAZ,YAAY,EAAE,MAAM;IAEjD;;;OAGG;IACH,SAAS,CAAC,cAAc,IAAI,MAAM;IAIlC;;;;;;;;;;;;;OAaG;IACH,gBAAgB,CAAC,MAAM,EAAE,8BAA8B,GAAG,kBAAkB;IAmB5E;;;;;;;;;;OAUG;IACG,cAAc,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnE;;;;;;;;;;OAUG;IACG,eAAe,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAM7E;;;;;;;;;;OAUG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAUrE;;;;;;;;;;;;OAYG;IACG,KAAK,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAgDzE;;;;;;;;;;OAUG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAU/D;;;;;;;;;;OAUG;IACG,aAAa,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAMjE;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA2ChC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAkB1B;;OAEG;IACH,OAAO,CAAC,OAAO;CAQhB"}

package/dist/workflows/WorkflowAPI.js

@@ -0,0 +1,266 @@
+/**
+ * Workflow API for managing workflow definitions and instances
+ */
+/**
+ * API for creating and managing workflow definitions and instances
+ *
+ * @example
+ * ```typescript
+ * // Create definition
+ * const definition = sdk.workflows.createDefinition({
+ *   name: 'Custom Workflow',
+ *   phases: [
+ *     { id: 'research', name: 'Research', agent: 'researcher' },
+ *     { id: 'implement', name: 'Implement', agent: 'implementer' }
+ *   ]
+ * });
+ * await sdk.workflows.saveDefinition(definition);
+ *
+ * // Start instance
+ * const workflow = await sdk.workflows.start('custom-workflow', 'project-123');
+ * ```
+ */
+export class WorkflowAPI {
+    _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 workflow definition
+     *
+     * @param config - Workflow configuration
+     * @returns Workflow definition (not yet persisted)
+     *
+     * @example
+     * ```typescript
+     * const definition = sdk.workflows.createDefinition({
+     *   name: 'My Workflow',
+     *   phases: [{ id: 'plan', name: 'Plan', agent: 'planner' }]
+     * });
+     * ```
+     */
+    createDefinition(config) {
+        this.validateDefinitionConfig(config);
+        const slug = this.slugify(config.name);
+        const now = new Date().toISOString();
+        return {
+            slug,
+            name: config.name,
+            ...(config.description && { description: config.description }),
+            phases: config.phases,
+            ...(config.transitions && { transitions: config.transitions }),
+            ...(config.approvalPoints && { approvalPoints: config.approvalPoints }),
+            tier: config.tier ?? 'user',
+            createdAt: now,
+            updatedAt: now,
+        };
+    }
+    /**
+     * Save a workflow definition
+     *
+     * @param definition - Workflow definition to save
+     * @throws {Error} If definition is invalid
+     *
+     * @example
+     * ```typescript
+     * await sdk.workflows.saveDefinition(definition);
+     * ```
+     */
+    async saveDefinition(definition) {
+        this.validateDefinition(definition);
+        // TODO: Implement persistence
+        console.log(`[SDK] Would save workflow definition: ${definition.slug}`);
+    }
+    /**
+     * List workflow definitions
+     *
+     * @param filter - Optional filter
+     * @returns Array of definitions
+     *
+     * @example
+     * ```typescript
+     * const definitions = await sdk.workflows.listDefinitions({ tier: 'user' });
+     * ```
+     */
+    async listDefinitions(filter) {
+        // TODO: Implement via repository
+        console.log(`[SDK] Would list definitions with filter:`, filter);
+        return [];
+    }
+    /**
+     * Get workflow definition by slug
+     *
+     * @param slug - Definition slug
+     * @returns Definition or null
+     *
+     * @example
+     * ```typescript
+     * const definition = await sdk.workflows.getDefinition('my-workflow');
+     * ```
+     */
+    async getDefinition(slug) {
+        if (!slug || typeof slug !== 'string') {
+            throw new Error('Definition slug is required and must be a string');
+        }
+        // TODO: Implement via repository
+        console.log(`[SDK] Would get definition: ${slug}`);
+        return null;
+    }
+    /**
+     * Start a workflow instance from a definition
+     *
+     * @param definitionSlug - Definition to use
+     * @param projectId - Project ID
+     * @returns Running workflow instance
+     * @throws {Error} If definition not found
+     *
+     * @example
+     * ```typescript
+     * const workflow = await sdk.workflows.start('my-workflow', 'project-123');
+     * ```
+     */
+    async start(definitionSlug, projectId) {
+        if (!definitionSlug || typeof definitionSlug !== 'string') {
+            throw new Error('Definition slug is required and must be a string');
+        }
+        if (!projectId || typeof projectId !== 'string') {
+            throw new Error('Project ID is required and must be a string');
+        }
+        const definition = await this.getDefinition(definitionSlug);
+        if (!definition) {
+            throw new Error(`Workflow definition not found: ${definitionSlug}`);
+        }
+        if (!definition.phases || definition.phases.length === 0) {
+            throw new Error(`Workflow definition has no phases: ${definitionSlug}`);
+        }
+        // TODO: Implement via workflow aggregate
+        const workflowId = `wf_${Date.now()}`;
+        const now = new Date().toISOString();
+        const firstPhase = definition.phases[0];
+        if (!firstPhase) {
+            throw new Error(`Invalid workflow definition: first phase is undefined`);
+        }
+        const workflow = {
+            id: workflowId,
+            definitionSlug,
+            projectId,
+            currentPhase: firstPhase.id,
+            status: 'active',
+            phaseHistory: [
+                {
+                    phase: firstPhase.id,
+                    enteredAt: now,
+                    status: 'running',
+                },
+            ],
+            createdAt: now,
+            updatedAt: now,
+        };
+        console.log(`[SDK] Would start workflow: ${workflowId}`);
+        return workflow;
+    }
+    /**
+     * Get workflow instance by ID
+     *
+     * @param workflowId - Workflow instance ID
+     * @returns Workflow or null
+     *
+     * @example
+     * ```typescript
+     * const workflow = await sdk.workflows.getInstance('wf_123');
+     * ```
+     */
+    async getInstance(workflowId) {
+        if (!workflowId || typeof workflowId !== 'string') {
+            throw new Error('Workflow ID is required and must be a string');
+        }
+        // TODO: Implement via repository
+        console.log(`[SDK] Would get workflow instance: ${workflowId}`);
+        return null;
+    }
+    /**
+     * List workflow instances
+     *
+     * @param filter - Optional filter
+     * @returns Array of workflows
+     *
+     * @example
+     * ```typescript
+     * const workflows = await sdk.workflows.listInstances({ status: 'active' });
+     * ```
+     */
+    async listInstances(filter) {
+        // TODO: Implement via repository
+        console.log(`[SDK] Would list instances with filter:`, filter);
+        return [];
+    }
+    /**
+     * Validate definition configuration
+     */
+    validateDefinitionConfig(config) {
+        if (!config.name || typeof config.name !== 'string') {
+            throw new Error('Workflow name is required and must be a string');
+        }
+        if (config.name.length < 3) {
+            throw new Error('Workflow name must be at least 3 characters');
+        }
+        if (!config.phases || !Array.isArray(config.phases)) {
+            throw new Error('Workflow phases are required and must be an array');
+        }
+        if (config.phases.length === 0) {
+            throw new Error('Workflow must have at least one phase');
+        }
+        // Validate each phase
+        config.phases.forEach((phase, index) => {
+            if (!phase.id || typeof phase.id !== 'string') {
+                throw new Error(`Phase ${index}: id is required and must be a string`);
+            }
+            if (!phase.name || typeof phase.name !== 'string') {
+                throw new Error(`Phase ${index}: name is required and must be a string`);
+            }
+            if (!phase.agent || typeof phase.agent !== 'string') {
+                throw new Error(`Phase ${index}: agent is required and must be a string`);
+            }
+        });
+        if (config.tier && !['user', 'community'].includes(config.tier)) {
+            throw new Error('Workflow tier must be "user" or "community"');
+        }
+    }
+    /**
+     * Validate workflow definition
+     */
+    validateDefinition(definition) {
+        if (!definition.slug || typeof definition.slug !== 'string') {
+            throw new Error('Workflow slug is required');
+        }
+        if (!definition.name || typeof definition.name !== 'string') {
+            throw new Error('Workflow name is required');
+        }
+        if (!definition.phases || !Array.isArray(definition.phases)) {
+            throw new Error('Workflow phases are required');
+        }
+        if (definition.phases.length === 0) {
+            throw new Error('Workflow must have at least one phase');
+        }
+    }
+    /**
+     * Convert name to slug
+     */
+    slugify(name) {
+        return name
+            .toLowerCase()
+            .trim()
+            .replace(/[^a-z0-9\s-]/g, '')
+            .replace(/\s+/g, '-')
+            .replace(/-+/g, '-');
+    }
+}
+//# sourceMappingURL=WorkflowAPI.js.map

package/dist/workflows/WorkflowAPI.js.map

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

package/dist/workflows/index.d.ts

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

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

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

package/dist/workflows/index.js

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

package/dist/workflows/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workflows/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}