@nahisaho/katashiro-orchestrator 0.4.0

package/README.md

@@ -0,0 +1,152 @@
+# @nahisaho/katashiro-orchestrator
+
+> Task decomposition, planning, and multi-agent orchestration for KATASHIRO
+
+## Features
+
+- **Task Decomposition (REQ-009)**: Automatically decompose complex tasks into subtasks with DAG-based dependency management
+- **Action-Observation Pattern (REQ-010)**: Type-safe tool system with risk assessment and approval workflow
+- **Multi-Agent Orchestration (REQ-006)**: Spawn independent sub-agents with isolated contexts
+
+## Installation
+
+```bash
+npm install @nahisaho/katashiro-orchestrator
+```
+
+## Quick Start
+
+### Task Decomposition
+
+```typescript
+import { TaskDecomposer } from '@nahisaho/katashiro-orchestrator';
+
+const decomposer = new TaskDecomposer({
+  maxSubTasks: 50,
+  allowParallel: true,
+});
+
+// Decompose a complex task
+const result = await decomposer.decompose('生成AIの企業活用について調べてレポートにまとめて');
+
+if (result.ok) {
+  const plan = result.value;
+  console.log('Execution Plan:', plan.name);
+  console.log('Subtasks:', plan.tasks.length);
+  console.log('Parallel Groups:', plan.parallelGroups.length);
+  console.log('Estimated Duration:', plan.estimatedTotalDuration, 'seconds');
+}
+```
+
+### Tool Registry
+
+```typescript
+import { ToolRegistry, type ToolDefinition } from '@nahisaho/katashiro-orchestrator';
+
+const registry = new ToolRegistry({
+  enableRiskAssessment: true,
+  approvalRequiredLevel: 'critical',
+});
+
+// Register a tool
+const searchTool: ToolDefinition<{ query: string }, { results: string[] }> = {
+  name: 'web_search',
+  description: 'Search the web for information',
+  category: 'network',
+  paramsSchema: {
+    type: 'object',
+    properties: {
+      query: { type: 'string' },
+    },
+    required: ['query'],
+  },
+  resultSchema: {
+    type: 'object',
+    properties: {
+      results: { type: 'array', items: { type: 'string' } },
+    },
+  },
+  defaultRiskLevel: 'low',
+  defaultTimeout: 30,
+  execute: async (params, context) => {
+    context.logger.info('Searching for:', params.query);
+    // Implementation...
+    return { results: ['result1', 'result2'] };
+  },
+};
+
+registry.register(searchTool);
+
+// Create and execute an action
+const actionResult = registry.createAction({
+  toolName: 'web_search',
+  params: { query: 'KATASHIRO' },
+  requestedBy: 'agent-001',
+});
+
+if (actionResult.ok) {
+  const observation = await registry.execute(actionResult.value);
+  console.log('Observation:', observation);
+}
+```
+
+## API Reference
+
+### TaskDecomposer
+
+#### Constructor
+
+```typescript
+new TaskDecomposer(config?: Partial<DecompositionConfig>)
+```
+
+| Config Option | Type | Default | Description |
+|--------------|------|---------|-------------|
+| maxSubTasks | number | 50 | Maximum number of subtasks |
+| minTaskGranularity | number | 5 | Minimum task duration (seconds) |
+| maxDependencyDepth | number | 10 | Maximum dependency depth |
+| allowParallel | boolean | true | Allow parallel execution |
+
+#### Methods
+
+- `decompose(task: string, context?: Record<string, unknown>): Promise<Result<ExecutionPlan, DecompositionError>>`
+- `registerStrategy(strategy: DecompositionStrategy): void`
+
+### ToolRegistry
+
+#### Constructor
+
+```typescript
+new ToolRegistry(config?: Partial<ToolRegistryConfig>)
+```
+
+| Config Option | Type | Default | Description |
+|--------------|------|---------|-------------|
+| allowUnregistered | boolean | false | Allow unregistered tools |
+| defaultTimeout | number | 30 | Default timeout (seconds) |
+| enforceSchemaValidation | boolean | true | Enforce schema validation |
+| enableRiskAssessment | boolean | true | Enable risk assessment |
+| approvalRequiredLevel | RiskLevel | 'critical' | Risk level requiring approval |
+
+#### Methods
+
+- `register<TParams, TResult>(tool: ToolDefinition<TParams, TResult>): Result<void, ToolRegistryError>`
+- `createAction<TParams>(options: CreateActionOptions<TParams>): Result<Action<TParams>, ToolRegistryError>`
+- `execute<TParams, TResult>(action: Action<TParams>, signal?: AbortSignal): Promise<Result<Observation<TResult>, ToolRegistryError>>`
+- `assessRisk(action: Action): SecurityAssessment`
+
+## EARS Requirements Coverage
+
+This package implements the following EARS requirements:
+
+| Requirement | Pattern | Implementation |
+|------------|---------|----------------|
+| REQ-009 | Event-Driven | TaskDecomposer.decompose() |
+| REQ-009 | Ubiquitous | ExecutionPlan DAG structure |
+| REQ-010 | Event-Driven | ToolRegistry.execute() |
+| REQ-010 | Unwanted | Risk assessment and approval |
+| REQ-006 | State-Driven | AgentContext isolation |
+
+## License
+
+MIT

package/dist/action-observation-types.d.ts

@@ -0,0 +1,239 @@
+/**
+ * Action-Observation Tool System Types
+ *
+ * @fileoverview REQ-010: Action-Observation型安全ツールシステム
+ * @module @nahisaho/katashiro-orchestrator
+ * @since 0.4.0
+ */
+import type { ID, Timestamp } from '@nahisaho/katashiro-core';
+/**
+ * リスクレベル
+ * EARS: The system shall evaluate action risk level before execution
+ */
+export type RiskLevel = 'low' | 'medium' | 'high' | 'critical';
+/**
+ * アクションカテゴリ
+ */
+export type ActionCategory = 'read' | 'write' | 'execute' | 'network' | 'system' | 'browser' | 'custom';
+/**
+ * Action定義（型安全な入力）
+ * EARS: When a tool is invoked, the system shall validate input against Action schema
+ */
+export interface Action<TParams = Record<string, unknown>> {
+    /** アクションID */
+    readonly id: ID;
+    /** アクション名 */
+    readonly name: string;
+    /** ツール名 */
+    readonly toolName: string;
+    /** カテゴリ */
+    readonly category: ActionCategory;
+    /** パラメータ（型安全） */
+    readonly params: TParams;
+    /** パラメータスキーマ（JSON Schema） */
+    readonly paramsSchema: Record<string, unknown>;
+    /** リスクレベル */
+    readonly riskLevel: RiskLevel;
+    /** タイムアウト（秒） */
+    readonly timeout: number;
+    /** 作成日時 */
+    readonly createdAt: Timestamp;
+    /** リクエスト元エージェントID */
+    readonly requestedBy: ID;
+}
+/**
+ * Observation定義（型安全な出力）
+ * EARS: When a tool execution completes, the system shall return a typed Observation
+ */
+export interface Observation<TResult = unknown> {
+    /** ObservationID */
+    readonly id: ID;
+    /** 対応するActionID */
+    readonly actionId: ID;
+    /** ステータス */
+    readonly status: 'success' | 'error' | 'timeout' | 'cancelled';
+    /** 結果データ（型安全） */
+    readonly result?: TResult;
+    /** 結果スキーマ（JSON Schema） */
+    readonly resultSchema?: Record<string, unknown>;
+    /** エラー情報 */
+    readonly error?: ObservationError;
+    /** 実行時間（ミリ秒） */
+    readonly duration: number;
+    /** 完了日時 */
+    readonly completedAt: Timestamp;
+    /** メタデータ */
+    readonly metadata?: ObservationMetadata;
+}
+/**
+ * Observationエラー
+ */
+export interface ObservationError {
+    /** エラーコード */
+    readonly code: string;
+    /** エラーメッセージ */
+    readonly message: string;
+    /** スタックトレース（デバッグ用） */
+    readonly stack?: string;
+    /** リトライ可能か */
+    readonly retryable: boolean;
+}
+/**
+ * Observationメタデータ
+ */
+export interface ObservationMetadata {
+    /** リソース使用量 */
+    readonly resourceUsage?: ResourceUsage;
+    /** ログ出力 */
+    readonly logs?: string[];
+    /** 警告 */
+    readonly warnings?: string[];
+}
+/**
+ * リソース使用量
+ */
+export interface ResourceUsage {
+    /** CPU時間（ミリ秒） */
+    readonly cpuTime?: number;
+    /** メモリ使用量（バイト） */
+    readonly memoryUsed?: number;
+    /** ネットワーク送信量（バイト） */
+    readonly networkSent?: number;
+    /** ネットワーク受信量（バイト） */
+    readonly networkReceived?: number;
+}
+/**
+ * ツール定義
+ * EARS: The system shall support tool registration with schema validation
+ */
+export interface ToolDefinition<TParams = Record<string, unknown>, TResult = unknown> {
+    /** ツール名（一意） */
+    readonly name: string;
+    /** ツール説明 */
+    readonly description: string;
+    /** カテゴリ */
+    readonly category: ActionCategory;
+    /** パラメータスキーマ（JSON Schema） */
+    readonly paramsSchema: Record<string, unknown>;
+    /** 結果スキーマ（JSON Schema） */
+    readonly resultSchema: Record<string, unknown>;
+    /** デフォルトリスクレベル */
+    readonly defaultRiskLevel: RiskLevel;
+    /** デフォルトタイムアウト（秒） */
+    readonly defaultTimeout: number;
+    /** ツール実行関数 */
+    readonly execute: ToolExecutor<TParams, TResult>;
+    /** 許可されるロール */
+    readonly allowedRoles?: readonly string[];
+    /** 必要な権限 */
+    readonly requiredPermissions?: readonly string[];
+}
+/**
+ * ツール実行関数
+ */
+export type ToolExecutor<TParams, TResult> = (params: TParams, context: ToolExecutionContext) => Promise<TResult>;
+/**
+ * ツール実行コンテキスト
+ */
+export interface ToolExecutionContext {
+    /** 実行エージェントID */
+    readonly agentId: ID;
+    /** アクションID */
+    readonly actionId: ID;
+    /** タイムアウト（秒） */
+    readonly timeout: number;
+    /** キャンセルシグナル */
+    readonly signal: AbortSignal;
+    /** ロガー */
+    readonly logger: ToolLogger;
+    /** サンドボックス環境か */
+    readonly isSandboxed: boolean;
+}
+/**
+ * ツールロガー
+ */
+export interface ToolLogger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+/**
+ * セキュリティ評価結果
+ * EARS: If action risk level is 'critical', the system shall require explicit approval
+ */
+export interface SecurityAssessment {
+    /** 評価ID */
+    readonly id: ID;
+    /** 対象ActionID */
+    readonly actionId: ID;
+    /** 最終リスクレベル */
+    readonly riskLevel: RiskLevel;
+    /** リスク要因 */
+    readonly riskFactors: readonly RiskFactor[];
+    /** 承認必要か */
+    readonly requiresApproval: boolean;
+    /** 推奨事項 */
+    readonly recommendations: readonly string[];
+    /** 評価日時 */
+    readonly assessedAt: Timestamp;
+}
+/**
+ * リスク要因
+ */
+export interface RiskFactor {
+    /** 要因名 */
+    readonly name: string;
+    /** 説明 */
+    readonly description: string;
+    /** 重大度（0-1） */
+    readonly severity: number;
+    /** 対策 */
+    readonly mitigation?: string;
+}
+/**
+ * 承認リクエスト
+ * EARS: When approval is required, the system shall pause and request user confirmation
+ */
+export interface ApprovalRequest {
+    /** リクエストID */
+    readonly id: ID;
+    /** 対象ActionID */
+    readonly actionId: ID;
+    /** セキュリティ評価 */
+    readonly assessment: SecurityAssessment;
+    /** リクエスト理由 */
+    readonly reason: string;
+    /** リクエスト日時 */
+    readonly requestedAt: Timestamp;
+    /** 有効期限 */
+    readonly expiresAt: Timestamp;
+    /** 状態 */
+    status: 'pending' | 'approved' | 'rejected' | 'expired';
+    /** 承認/却下日時 */
+    resolvedAt?: Timestamp;
+    /** 承認/却下者 */
+    resolvedBy?: string;
+}
+/**
+ * ツールレジストリ設定
+ */
+export interface ToolRegistryConfig {
+    /** 未登録ツールの実行を許可 */
+    readonly allowUnregistered: boolean;
+    /** デフォルトタイムアウト（秒） */
+    readonly defaultTimeout: number;
+    /** スキーマバリデーションを強制 */
+    readonly enforceSchemaValidation: boolean;
+    /** リスク評価を有効化 */
+    readonly enableRiskAssessment: boolean;
+    /** 承認が必要なリスクレベル */
+    readonly approvalRequiredLevel: RiskLevel;
+    /** 承認タイムアウト（秒） */
+    readonly approvalTimeout: number;
+}
+/**
+ * デフォルトツールレジストリ設定
+ */
+export declare const DEFAULT_TOOL_REGISTRY_CONFIG: ToolRegistryConfig;
+//# sourceMappingURL=action-observation-types.d.ts.map

package/dist/action-observation-types.d.ts.map

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

package/dist/action-observation-types.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Action-Observation Tool System Types
+ *
+ * @fileoverview REQ-010: Action-Observation型安全ツールシステム
+ * @module @nahisaho/katashiro-orchestrator
+ * @since 0.4.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_TOOL_REGISTRY_CONFIG = void 0;
+/**
+ * デフォルトツールレジストリ設定
+ */
+exports.DEFAULT_TOOL_REGISTRY_CONFIG = {
+    allowUnregistered: false,
+    defaultTimeout: 30,
+    enforceSchemaValidation: true,
+    enableRiskAssessment: true,
+    approvalRequiredLevel: 'critical',
+    approvalTimeout: 30, // 30秒タイムアウト
+};
+//# sourceMappingURL=action-observation-types.js.map

package/dist/action-observation-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-observation-types.js","sourceRoot":"","sources":["../src/action-observation-types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AA+QH;;GAEG;AACU,QAAA,4BAA4B,GAAuB;IAC9D,iBAAiB,EAAE,KAAK;IACxB,cAAc,EAAE,EAAE;IAClB,uBAAuB,EAAE,IAAI;IAC7B,oBAAoB,EAAE,IAAI;IAC1B,qBAAqB,EAAE,UAAU;IACjC,eAAe,EAAE,EAAE,EAAE,YAAY;CAClC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * KATASHIRO Orchestrator Package
+ *
+ * @fileoverview REQ-006, REQ-009, REQ-010の実装エントリーポイント
+ * @module @nahisaho/katashiro-orchestrator
+ * @since 0.4.0
+ */
+export type { TaskPriority, TaskStatus, SubTask, TaskInput, TaskResult, TaskError, ExecutionPlan, DecompositionConfig, AgentRole, AgentState, SubAgent, AgentContext, ConversationMessage, ToolCallInfo, OrchestrationConfig, OrchestrationResult, OrchestratorEventType, OrchestratorEvent, OrchestratorEventListener, } from './types';
+export type { RiskLevel, ActionCategory, Action, Observation, ObservationError, ObservationMetadata, ResourceUsage, ToolDefinition, ToolExecutor, ToolExecutionContext, ToolLogger, SecurityAssessment, RiskFactor, ApprovalRequest, ToolRegistryConfig, } from './action-observation-types';
+export { DEFAULT_DECOMPOSITION_CONFIG, DEFAULT_ORCHESTRATION_CONFIG, } from './types';
+export { DEFAULT_TOOL_REGISTRY_CONFIG } from './action-observation-types';
+export { TaskDecomposer, DecompositionError, type DecompositionStrategy, type DecomposedTask, } from './task-decomposer';
+export { ToolRegistry, ToolRegistryError, type CreateActionOptions, type ApprovalRequestEvent, type ApprovalResolvedEvent, type ToolRegistryEvents, } from './tool-registry';
+export { MultiAgentOrchestrator, type MultiAgentOrchestratorOptions, type ResultAggregatorConfig, type AggregatedResult, } from './multi-agent-orchestrator';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EAEV,YAAY,EACZ,UAAU,EACV,OAAO,EACP,SAAS,EACT,UAAU,EACV,SAAS,EACT,aAAa,EACb,mBAAmB,EAEnB,SAAS,EACT,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,SAAS,CAAC;AAEjB,YAAY,EAEV,SAAS,EACT,cAAc,EACd,MAAM,EACN,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,UAAU,EACV,kBAAkB,EAClB,UAAU,EACV,eAAe,EACf,kBAAkB,GACnB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAG1E,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,GACxB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,sBAAsB,EACtB,KAAK,6BAA6B,EAClC,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,GACtB,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * KATASHIRO Orchestrator Package
+ *
+ * @fileoverview REQ-006, REQ-009, REQ-010の実装エントリーポイント
+ * @module @nahisaho/katashiro-orchestrator
+ * @since 0.4.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultiAgentOrchestrator = exports.ToolRegistryError = exports.ToolRegistry = exports.DecompositionError = exports.TaskDecomposer = exports.DEFAULT_TOOL_REGISTRY_CONFIG = exports.DEFAULT_ORCHESTRATION_CONFIG = exports.DEFAULT_DECOMPOSITION_CONFIG = void 0;
+// 定数
+var types_1 = require("./types");
+Object.defineProperty(exports, "DEFAULT_DECOMPOSITION_CONFIG", { enumerable: true, get: function () { return types_1.DEFAULT_DECOMPOSITION_CONFIG; } });
+Object.defineProperty(exports, "DEFAULT_ORCHESTRATION_CONFIG", { enumerable: true, get: function () { return types_1.DEFAULT_ORCHESTRATION_CONFIG; } });
+var action_observation_types_1 = require("./action-observation-types");
+Object.defineProperty(exports, "DEFAULT_TOOL_REGISTRY_CONFIG", { enumerable: true, get: function () { return action_observation_types_1.DEFAULT_TOOL_REGISTRY_CONFIG; } });
+// クラス
+var task_decomposer_1 = require("./task-decomposer");
+Object.defineProperty(exports, "TaskDecomposer", { enumerable: true, get: function () { return task_decomposer_1.TaskDecomposer; } });
+Object.defineProperty(exports, "DecompositionError", { enumerable: true, get: function () { return task_decomposer_1.DecompositionError; } });
+var tool_registry_1 = require("./tool-registry");
+Object.defineProperty(exports, "ToolRegistry", { enumerable: true, get: function () { return tool_registry_1.ToolRegistry; } });
+Object.defineProperty(exports, "ToolRegistryError", { enumerable: true, get: function () { return tool_registry_1.ToolRegistryError; } });
+// REQ-006: マルチエージェントオーケストレーター
+var multi_agent_orchestrator_1 = require("./multi-agent-orchestrator");
+Object.defineProperty(exports, "MultiAgentOrchestrator", { enumerable: true, get: function () { return multi_agent_orchestrator_1.MultiAgentOrchestrator; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AA8CH,KAAK;AACL,iCAGiB;AAFf,qHAAA,4BAA4B,OAAA;AAC5B,qHAAA,4BAA4B,OAAA;AAG9B,uEAA0E;AAAjE,wIAAA,4BAA4B,OAAA;AAErC,MAAM;AACN,qDAK2B;AAJzB,iHAAA,cAAc,OAAA;AACd,qHAAA,kBAAkB,OAAA;AAKpB,iDAOyB;AANvB,6GAAA,YAAY,OAAA;AACZ,kHAAA,iBAAiB,OAAA;AAOnB,8BAA8B;AAC9B,uEAKoC;AAJlC,kIAAA,sBAAsB,OAAA"}

package/dist/multi-agent-orchestrator.d.ts

@@ -0,0 +1,147 @@
+/**
+ * MultiAgentOrchestrator - マルチエージェント並列実行オーケストレーター
+ *
+ * @requirement REQ-006
+ * @design REQ-006-01 複雑タスクを独立サブタスクに分解
+ * @design REQ-006-02 1秒以内にサブエージェント生成
+ * @design REQ-006-03 1-100の並列実行管理
+ * @design REQ-006-04 コンテキスト汚染防止
+ * @design REQ-006-05 結果集約・重複除去
+ * @design REQ-006-06 部分失敗でも継続
+ */
+import { TaskDecomposer } from './task-decomposer';
+import { SubTask, SubAgent, TaskResult, TaskError, OrchestrationConfig, OrchestratorEventListener, OrchestratorEventType } from './types';
+/**
+ * 結果集約設定
+ */
+export interface ResultAggregatorConfig {
+    /** 重複除去を有効化 */
+    deduplication: boolean;
+    /** 重複判定の類似度閾値（0-1） */
+    similarityThreshold: number;
+    /** 結果のソート順 */
+    sortBy: 'priority' | 'completion_time' | 'relevance';
+}
+/**
+ * 集約結果
+ */
+export interface AggregatedResult {
+    /** 成功/失敗 */
+    success: boolean;
+    /** 集約された出力 */
+    output: unknown;
+    /** 元の結果数 */
+    originalCount: number;
+    /** 重複除去後の結果数 */
+    dedupedCount: number;
+    /** 失敗したサブタスク */
+    failures: Array<{
+        taskId: string;
+        error: TaskError;
+    }>;
+    /** メタデータ */
+    metadata: {
+        totalDuration: number;
+        agentsUsed: number;
+        deduplicationApplied: boolean;
+    };
+}
+/**
+ * MultiAgentOrchestratorオプション
+ */
+export interface MultiAgentOrchestratorOptions {
+    /** オーケストレーション設定 */
+    config?: Partial<OrchestrationConfig>;
+    /** タスク分解器 */
+    taskDecomposer?: TaskDecomposer;
+    /** 結果集約設定 */
+    aggregatorConfig?: Partial<ResultAggregatorConfig>;
+    /** サブタスク実行関数 */
+    taskExecutor?: (task: SubTask, agent: SubAgent) => Promise<TaskResult>;
+}
+/**
+ * マルチエージェントオーケストレーター
+ */
+export declare class MultiAgentOrchestrator {
+    private readonly config;
+    private readonly taskDecomposer;
+    private readonly aggregatorConfig;
+    private readonly taskExecutor;
+    private readonly agents;
+    private readonly listeners;
+    private runningAgents;
+    constructor(options?: MultiAgentOrchestratorOptions);
+    /**
+     * タスクを実行（REQ-006-01）
+     */
+    execute(taskDescription: string): Promise<AggregatedResult>;
+    /**
+     * サブエージェントを生成（REQ-006-02）
+     */
+    spawnSubAgents(tasks: SubTask[]): Promise<SubAgent[]>;
+    /**
+     * タスクを並列実行（REQ-006-03, REQ-006-04, REQ-006-06）
+     */
+    private executeParallel;
+    /**
+     * 単一タスクを実行
+     */
+    private executeTask;
+    /**
+     * 結果を集約（REQ-006-05）
+     */
+    aggregate(results: Map<string, TaskResult>): Promise<Omit<AggregatedResult, 'metadata'>>;
+    /**
+     * 結果の重複を除去
+     */
+    private deduplicateResults;
+    /**
+     * 結果をソート
+     */
+    private sortResults;
+    /**
+     * 結果のハッシュを生成
+     */
+    private hashResult;
+    /**
+     * エージェントを作成（REQ-006-04: 独立コンテキスト）
+     */
+    private createAgent;
+    /**
+     * タスクからエージェントロールを決定
+     */
+    private determineAgentRole;
+    /**
+     * デフォルトのタスク実行関数
+     */
+    private defaultTaskExecutor;
+    /**
+     * タイムアウト付きPromise
+     */
+    private withTimeout;
+    /**
+     * 全エージェントを終了
+     */
+    private terminateAllAgents;
+    /**
+     * イベントリスナーを登録
+     */
+    on(event: OrchestratorEventType, listener: OrchestratorEventListener): void;
+    /**
+     * イベントを発行
+     */
+    private emit;
+    /**
+     * 設定を取得
+     */
+    getConfig(): OrchestrationConfig;
+    /**
+     * 現在のエージェント数を取得
+     */
+    getRunningAgentCount(): number;
+    /**
+     * 全エージェントを取得
+     */
+    getAgents(): SubAgent[];
+}
+//# sourceMappingURL=multi-agent-orchestrator.d.ts.map

package/dist/multi-agent-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-agent-orchestrator.d.ts","sourceRoot":"","sources":["../src/multi-agent-orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EACL,OAAO,EACP,QAAQ,EAGR,UAAU,EACV,SAAS,EACT,mBAAmB,EAEnB,yBAAyB,EACzB,qBAAqB,EAEtB,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,eAAe;IACf,aAAa,EAAE,OAAO,CAAC;IACvB,sBAAsB;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc;IACd,MAAM,EAAE,UAAU,GAAG,iBAAiB,GAAG,WAAW,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB;IAChB,QAAQ,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IACtD,YAAY;IACZ,QAAQ,EAAE;QACR,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,oBAAoB,EAAE,OAAO,CAAC;KAC/B,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,mBAAmB;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACtC,aAAa;IACb,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,aAAa;IACb,gBAAgB,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACnD,gBAAgB;IAChB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CACxE;AAWD;;GAEG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyB;IAC1D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0D;IACvF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAC3D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsE;IAChG,OAAO,CAAC,aAAa,CAAa;gBAEtB,OAAO,GAAE,6BAAkC;IAiBvD;;OAEG;IACG,OAAO,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA2DjE;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAa3D;;OAEG;YACW,eAAe;IAkE7B;;OAEG;YACW,WAAW;IA4CzB;;OAEG;IACG,SAAS,CACb,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;IA6B9C;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACH,OAAO,CAAC,WAAW;IAiCnB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;YACW,mBAAmB;IAgBjC;;OAEG;YACW,WAAW;IAmBzB;;OAEG;YACW,kBAAkB;IAQhC;;OAEG;IACH,EAAE,CAAC,KAAK,EAAE,qBAAqB,EAAE,QAAQ,EAAE,yBAAyB,GAAG,IAAI;IAM3E;;OAEG;IACH,OAAO,CAAC,IAAI;IAiBZ;;OAEG;IACH,SAAS,IAAI,mBAAmB;IAIhC;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAI9B;;OAEG;IACH,SAAS,IAAI,QAAQ,EAAE;CAGxB"}