@sowonai/crewx-sdk 0.1.0-dev.1 → 0.1.0-dev.10

package/README.md

@@ -439,7 +439,113 @@ The SDK provides reusable components that were previously CLI-only. These abstra
 
 ### Message Formatting (Phase 1)
 
-Create platform-specific message formatters:
+The SDK provides a flexible message formatting system that supports multiple platforms (Slack, Terminal, API, etc.) and allows custom formatters.
+
+#### Platform-Specific Formatters
+
+**Terminal Formatter (Built-in)**
+
+```typescript
+import { BaseMessageFormatter, type StructuredMessage } from '@sowonai/crewx-sdk';
+
+const formatter = new BaseMessageFormatter();
+
+// Format messages for terminal display
+const history = formatter.formatHistory(messages, {
+  includeUserId: true,
+  includeTimestamp: true,
+  timestampFormat: 'iso', // 'iso' | 'relative' | 'unix'
+});
+
+console.log(history);
+// Output:
+// [2025-10-17T10:00:00Z] user123: Hello!
+// [2025-10-17T10:00:05Z] assistant: How can I help?
+```
+
+**Slack Formatter (Built-in)**
+
+For Slack bot integrations, use the Slack-specific formatter that handles threading, mentions, and rich formatting:
+
+```typescript
+import { SlackMessageFormatter } from '@sowonai/crewx-sdk';
+
+const slackFormatter = new SlackMessageFormatter();
+
+// Format for Slack with rich text support
+const formatted = slackFormatter.formatForSlack(messages, {
+  includeTimestamp: true,
+  useThreading: true,
+  preserveMentions: true,
+});
+
+// Format agent response with Slack-specific blocks
+const response = slackFormatter.formatAgentResponse({
+  content: 'Task completed successfully!',
+  agentId: 'backend',
+  metadata: { status: 'success' }
+});
+
+// Send to Slack
+await slackClient.chat.postMessage({
+  channel: channelId,
+  blocks: response.blocks,
+  thread_ts: threadId,
+});
+```
+
+**API/JSON Formatter**
+
+For API responses or structured data:
+
+```typescript
+import {
+  BaseMessageFormatter,
+  type StructuredMessage,
+  type ConversationMetadata
+} from '@sowonai/crewx-sdk';
+
+class APIFormatter extends BaseMessageFormatter {
+  formatForAPI(messages: StructuredMessage[]): {
+    messages: Array<{
+      id: string;
+      author: { id: string; isBot: boolean };
+      content: string;
+      timestamp: string;
+      metadata?: Record<string, unknown>;
+    }>;
+    meta: ConversationMetadata;
+  } {
+    return {
+      messages: messages.map(msg => ({
+        id: msg.id,
+        author: {
+          id: msg.userId || 'unknown',
+          isBot: msg.isAssistant || false,
+        },
+        content: msg.text,
+        timestamp: msg.timestamp,
+        metadata: msg.metadata,
+      })),
+      meta: {
+        platform: 'api',
+        totalMessages: messages.length,
+        generatedAt: new Date().toISOString(),
+      },
+    };
+  }
+}
+
+const apiFormatter = new APIFormatter();
+const response = apiFormatter.formatForAPI(messages);
+
+// Return as JSON API response
+res.json(response);
+```
+
+#### Custom Formatter Extension
+
+Create your own formatter for custom platforms:
 
 ```typescript
 import {
@@ -448,20 +554,243 @@ import {
   FormatterOptions
 } from '@sowonai/crewx-sdk';
 
-class CustomFormatter extends BaseMessageFormatter {
+class DiscordFormatter extends BaseMessageFormatter {
   formatMessage(msg: StructuredMessage, options: FormatterOptions): string {
-    // Implement custom formatting
-    return `[${msg.userId}] ${msg.text}`;
+    const timestamp = options.includeTimestamp
+      ? `<t:${Math.floor(new Date(msg.timestamp).getTime() / 1000)}:R> `
+      : '';
+
+    const author = msg.isAssistant ? '🤖 **Bot**' : `👤 **${msg.userId}**`;
+
+    return `${timestamp}${author}: ${msg.text}`;
+  }
+
+  formatForDiscordEmbed(
+    message: string,
+    options: { color?: number; title?: string }
+  ) {
+    return {
+      embeds: [{
+        title: options.title || 'Agent Response',
+        description: message,
+        color: options.color || 0x5865F2,
+        timestamp: new Date().toISOString(),
+      }],
+    };
   }
 }
 
-const formatter = new CustomFormatter();
-const history = formatter.formatHistory(messages, {
+const discordFormatter = new DiscordFormatter();
+const embed = discordFormatter.formatForDiscordEmbed(
+  'Analysis complete!',
+  { title: 'Backend Agent', color: 0x00FF00 }
+);
+
+await discordChannel.send(embed);
+```
+
+#### Metadata Handling
+
+The formatter system supports rich metadata for enhanced context:
+
+```typescript
+import {
+  BaseMessageFormatter,
+  type StructuredMessage,
+  type ConversationMetadata
+} from '@sowonai/crewx-sdk';
+
+const messages: StructuredMessage[] = [
+  {
+    id: 'msg-1',
+    userId: 'user123',
+    text: 'What is the status?',
+    timestamp: new Date().toISOString(),
+    isAssistant: false,
+    metadata: {
+      platform: 'slack',
+      channelId: 'C123456',
+      threadTs: '1234567890.123456',
+      userAgent: 'SlackBot/1.0',
+    },
+  },
+  {
+    id: 'msg-2',
+    userId: 'backend-agent',
+    text: 'All systems operational.',
+    timestamp: new Date().toISOString(),
+    isAssistant: true,
+    metadata: {
+      agentId: 'backend',
+      model: 'claude-3-5-sonnet',
+      processingTime: 1234,
+      tokenUsage: { input: 50, output: 100 },
+    },
+  },
+];
+
+const formatter = new BaseMessageFormatter();
+
+// Format with metadata extraction
+const formatted = formatter.formatHistory(messages, {
+  includeUserId: true,
+  includeTimestamp: true,
+  extractMetadata: true,
+});
+
+// Access metadata
+messages.forEach(msg => {
+  if (msg.metadata?.tokenUsage) {
+    console.log(`Tokens used: ${msg.metadata.tokenUsage.input + msg.metadata.tokenUsage.output}`);
+  }
+});
+```
+
+#### Migration Guide for Existing Formatter Users
+
+If you're migrating from the CLI's internal formatter to the SDK formatter:
+
+**Before (CLI internal)**
+```typescript
+// This was CLI-only code
+import { MessageFormatter } from '../cli/src/utils/message-formatter';
+
+const formatter = new MessageFormatter();
+const result = formatter.format(messages);
+```
+
+**After (SDK)**
+```typescript
+// Now use SDK's BaseMessageFormatter
+import { BaseMessageFormatter } from '@sowonai/crewx-sdk';
+
+const formatter = new BaseMessageFormatter();
+const result = formatter.formatHistory(messages, {
   includeUserId: true,
   includeTimestamp: true,
 });
 ```
 
+**Key Changes:**
+1. Import from `@sowonai/crewx-sdk` instead of CLI internals
+2. Use `formatHistory()` method instead of `format()`
+3. Options are now explicitly passed as second parameter
+4. Metadata handling is built-in with `extractMetadata` option
+
+**Slack Migration**
+```typescript
+// Before (CLI)
+import { SlackFormatter } from '../cli/src/slack/formatter';
+
+// After (SDK)
+import { SlackMessageFormatter } from '@sowonai/crewx-sdk';
+
+const formatter = new SlackMessageFormatter();
+// Same API, now available in SDK
+```
+
+#### CLI Developer Guide: Adding Slack Formatting
+
+If you're building a CLI tool and want to add Slack formatting support:
+
+**Step 1: Install SDK**
+```bash
+npm install @sowonai/crewx-sdk
+```
+
+**Step 2: Import Slack Formatter**
+```typescript
+import { SlackMessageFormatter } from '@sowonai/crewx-sdk';
+import { WebClient } from '@slack/web-api';
+
+const slackClient = new WebClient(process.env.SLACK_BOT_TOKEN);
+const formatter = new SlackMessageFormatter();
+```
+
+**Step 3: Format Messages for Slack**
+```typescript
+async function sendToSlack(
+  channelId: string,
+  content: string,
+  threadTs?: string
+) {
+  // Format using SDK formatter
+  const formatted = formatter.formatAgentResponse({
+    content,
+    agentId: 'my-cli-agent',
+    metadata: {
+      source: 'cli',
+      timestamp: new Date().toISOString(),
+    },
+  });
+
+  // Send to Slack
+  await slackClient.chat.postMessage({
+    channel: channelId,
+    text: content, // Fallback text
+    blocks: formatted.blocks,
+    thread_ts: threadTs,
+  });
+}
+```
+
+**Step 4: Handle Conversation History**
+```typescript
+import {
+  SlackMessageFormatter,
+  type StructuredMessage
+} from '@sowonai/crewx-sdk';
+
+async function formatSlackThread(threadTs: string) {
+  // Fetch Slack thread
+  const thread = await slackClient.conversations.replies({
+    channel: channelId,
+    ts: threadTs,
+  });
+
+  // Convert to StructuredMessage format
+  const messages: StructuredMessage[] = thread.messages.map(msg => ({
+    id: msg.ts,
+    userId: msg.user || 'bot',
+    text: msg.text || '',
+    timestamp: new Date(parseFloat(msg.ts) * 1000).toISOString(),
+    isAssistant: !!msg.bot_id,
+    metadata: {
+      platform: 'slack',
+      threadTs: msg.thread_ts,
+    },
+  }));
+
+  // Format for display or processing
+  const formatter = new SlackMessageFormatter();
+  const formatted = formatter.formatHistory(messages, {
+    includeTimestamp: true,
+    useThreading: true,
+  });
+
+  return formatted;
+}
+```
+
+**Step 5: Error Handling**
+```typescript
+try {
+  await sendToSlack(channelId, 'Task completed!', threadTs);
+} catch (error) {
+  // Format error for Slack
+  const errorMessage = formatter.formatAgentResponse({
+    content: `❌ Error: ${error.message}`,
+    agentId: 'cli-agent',
+    metadata: { status: 'error' },
+  });
+
+  await slackClient.chat.postMessage({
+    channel: channelId,
+    blocks: errorMessage.blocks,
+  });
+}
+```
+
 ### AI Providers (Phase 2)
 
 Use built-in providers or create custom ones:

package/dist/config/yaml-loader.d.ts

@@ -0,0 +1,8 @@
+import { CrewxAgentConfig } from '../core/agent/agent-factory';
+export declare class YamlConfigError extends Error {
+    readonly cause?: Error | undefined;
+    constructor(message: string, cause?: Error | undefined);
+}
+export declare function loadAgentConfigFromYaml(yamlString: string): CrewxAgentConfig;
+export declare function loadAgentConfigFromFile(filePath: string): CrewxAgentConfig;
+export declare function validateAgentConfig(config: CrewxAgentConfig): boolean;

package/dist/config/yaml-loader.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.YamlConfigError = void 0;
+exports.loadAgentConfigFromYaml = loadAgentConfigFromYaml;
+exports.loadAgentConfigFromFile = loadAgentConfigFromFile;
+exports.validateAgentConfig = validateAgentConfig;
+const js_yaml_1 = require("js-yaml");
+const fs_1 = require("fs");
+class YamlConfigError extends Error {
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'YamlConfigError';
+    }
+}
+exports.YamlConfigError = YamlConfigError;
+function loadAgentConfigFromYaml(yamlString) {
+    if (!yamlString || typeof yamlString !== 'string') {
+        throw new YamlConfigError('YAML string is required and must be a non-empty string');
+    }
+    let parsed;
+    try {
+        const trimmed = yamlString.trim();
+        parsed = (0, js_yaml_1.load)(trimmed);
+        if (process.env.DEBUG_YAML === '1') {
+            console.log('[YAML DEBUG] Input length:', yamlString.length);
+            console.log('[YAML DEBUG] Trimmed length:', trimmed.length);
+            console.log('[YAML DEBUG] Parsed:', JSON.stringify(parsed));
+            console.log('[YAML DEBUG] Type:', typeof parsed);
+            console.log('[YAML DEBUG] Is null:', parsed === null);
+            console.log('[YAML DEBUG] Is array:', Array.isArray(parsed));
+            console.log('[YAML DEBUG] Truthy check:', !parsed);
+        }
+    }
+    catch (error) {
+        throw new YamlConfigError(`Failed to parse YAML: ${error instanceof Error ? error.message : 'Unknown error'}`, error instanceof Error ? error : undefined);
+    }
+    if (parsed === null || parsed === undefined || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new YamlConfigError('YAML must contain a valid object structure');
+    }
+    return parseYamlConfig(parsed);
+}
+function loadAgentConfigFromFile(filePath) {
+    if (!filePath || typeof filePath !== 'string') {
+        throw new YamlConfigError('File path is required and must be a non-empty string');
+    }
+    let fileContent;
+    try {
+        fileContent = (0, fs_1.readFileSync)(filePath, 'utf-8');
+    }
+    catch (error) {
+        throw new YamlConfigError(`Failed to read YAML file '${filePath}': ${error instanceof Error ? error.message : 'Unknown error'}`, error instanceof Error ? error : undefined);
+    }
+    return loadAgentConfigFromYaml(fileContent);
+}
+function parseYamlConfig(raw) {
+    const config = {};
+    if (raw.agents && typeof raw.agents === 'object') {
+        const agentIds = Object.keys(raw.agents);
+        if (agentIds.length > 0) {
+            const firstAgentId = agentIds[0];
+            const agentConfig = raw.agents[firstAgentId];
+            if (agentConfig) {
+                config.defaultAgentId = firstAgentId;
+                if (agentConfig.provider) {
+                    config.provider = parseProvider(agentConfig.provider, agentConfig.inline);
+                }
+                if (agentConfig.knowledgeBase) {
+                    config.knowledgeBase = parseKnowledgeBase(agentConfig.knowledgeBase);
+                }
+            }
+        }
+    }
+    if (raw.defaults && typeof raw.defaults === 'object') {
+        if (raw.defaults.provider && !config.provider) {
+            config.provider = parseProvider(raw.defaults.provider);
+        }
+        if (raw.defaults.knowledgeBase && !config.knowledgeBase) {
+            config.knowledgeBase = parseKnowledgeBase(raw.defaults.knowledgeBase);
+        }
+    }
+    return config;
+}
+function parseProvider(providerString, inline) {
+    if (!providerString || typeof providerString !== 'string') {
+        throw new YamlConfigError('Provider must be a non-empty string');
+    }
+    const parts = providerString.split('/');
+    if (parts.length !== 2) {
+        throw new YamlConfigError(`Invalid provider format '${providerString}'. Expected format: 'namespace/id' (e.g., 'cli/claude')`);
+    }
+    const [namespace, id] = parts;
+    if (!namespace || !id) {
+        throw new YamlConfigError(`Provider namespace and id cannot be empty. Got: '${providerString}'`);
+    }
+    const config = {
+        namespace,
+        id,
+    };
+    if (inline && typeof inline === 'object') {
+        if (inline.model && typeof inline.model === 'string') {
+            config.model = inline.model;
+        }
+        if (inline.apiKey && typeof inline.apiKey === 'string') {
+            config.apiKey = inline.apiKey;
+        }
+    }
+    return config;
+}
+function parseKnowledgeBase(value) {
+    if (typeof value === 'string') {
+        return { path: value };
+    }
+    if (Array.isArray(value)) {
+        return { sources: value.filter((s) => typeof s === 'string') };
+    }
+    throw new YamlConfigError('Knowledge base must be a string (path) or array of strings (sources)');
+}
+function validateAgentConfig(config) {
+    if (!config || typeof config !== 'object') {
+        throw new YamlConfigError('Configuration must be a valid object');
+    }
+    if (config.provider) {
+        if (!config.provider.namespace || !config.provider.id) {
+            throw new YamlConfigError('Provider must have both namespace and id');
+        }
+    }
+    if (config.knowledgeBase) {
+        const hasPath = config.knowledgeBase.path && typeof config.knowledgeBase.path === 'string';
+        const hasSources = Array.isArray(config.knowledgeBase.sources) && config.knowledgeBase.sources.length > 0;
+        if (!hasPath && !hasSources) {
+            throw new YamlConfigError('Knowledge base must have either path or sources');
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=yaml-loader.js.map

package/dist/config/yaml-loader.js.map

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

package/dist/core/agent/agent-factory.d.ts

@@ -27,4 +27,4 @@ export interface CrewxAgentResult {
     eventBus: EventBus;
 }
 export declare function createCrewxAgent(config?: CrewxAgentConfig): Promise<CrewxAgentResult>;
-export declare function loadAgentConfigFromYaml(yamlString: string): CrewxAgentConfig;
+export { loadAgentConfigFromYaml, loadAgentConfigFromFile } from '../../config/yaml-loader';

package/dist/core/agent/agent-factory.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadAgentConfigFromFile = exports.loadAgentConfigFromYaml = void 0;
 exports.createCrewxAgent = createCrewxAgent;
-exports.loadAgentConfigFromYaml = loadAgentConfigFromYaml;
 const agent_runtime_1 = require("./agent-runtime");
 const event_bus_1 = require("./event-bus");
 async function createCrewxAgent(config = {}) {
@@ -23,9 +23,7 @@ async function createCrewxAgent(config = {}) {
         eventBus,
     };
 }
-function loadAgentConfigFromYaml(yamlString) {
-    return {
-        defaultAgentId: 'crewx',
-    };
-}
+var yaml_loader_1 = require("../../config/yaml-loader");
+Object.defineProperty(exports, "loadAgentConfigFromYaml", { enumerable: true, get: function () { return yaml_loader_1.loadAgentConfigFromYaml; } });
+Object.defineProperty(exports, "loadAgentConfigFromFile", { enumerable: true, get: function () { return yaml_loader_1.loadAgentConfigFromFile; } });
 //# sourceMappingURL=agent-factory.js.map

package/dist/core/agent/agent-factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-factory.js","sourceRoot":"","sources":["../../../src/core/agent/agent-factory.ts"],"names":[],"mappings":";;AAoFA,4CA6BC;AAMD,0DAMC;AAxHD,mDAAoE;AACpE,2CAAsD;AA8E/C,KAAK,UAAU,gBAAgB,CACpC,SAA2B,EAAE;IAG7B,MAAM,QAAQ,GAAG,IAAI,oBAAQ,EAAE,CAAC;IAGhC,MAAM,cAAc,GAAwB;QAC1C,QAAQ;QACR,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,KAAK;QAChD,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,OAAO;KACjD,CAAC;IAGF,MAAM,OAAO,GAAG,IAAI,4BAAY,CAAC,cAAc,CAAC,CAAC;IAGjD,MAAM,KAAK,GAAe;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;QAClC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;QACtC,YAAY,EAAE,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC;KACjD,CAAC;IAGF,OAAO;QACL,KAAK;QACL,OAAO,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;QAClE,QAAQ;KACT,CAAC;AACJ,CAAC;AAMD,SAAgB,uBAAuB,CAAC,UAAkB;IAGxD,OAAO;QACL,cAAc,EAAE,OAAO;KACxB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"agent-factory.js","sourceRoot":"","sources":["../../../src/core/agent/agent-factory.ts"],"names":[],"mappings":";;;AAoFA,4CA6BC;AA5GD,mDAAoE;AACpE,2CAAsD;AA8E/C,KAAK,UAAU,gBAAgB,CACpC,SAA2B,EAAE;IAG7B,MAAM,QAAQ,GAAG,IAAI,oBAAQ,EAAE,CAAC;IAGhC,MAAM,cAAc,GAAwB;QAC1C,QAAQ;QACR,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,KAAK;QAChD,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,OAAO;KACjD,CAAC;IAGF,MAAM,OAAO,GAAG,IAAI,4BAAY,CAAC,cAAc,CAAC,CAAC;IAGjD,MAAM,KAAK,GAAe;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;QAClC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;QACtC,YAAY,EAAE,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC;KACjD,CAAC;IAGF,OAAO;QACL,KAAK;QACL,OAAO,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;QAClE,QAAQ;KACT,CAAC;AACJ,CAAC;AAQD,wDAA4F;AAAnF,sHAAA,uBAAuB,OAAA;AAAE,sHAAA,uBAAuB,OAAA"}

package/dist/core/agent/index.d.ts

@@ -1,3 +1,3 @@
-export { createCrewxAgent, loadAgentConfigFromYaml, type CrewxAgent, type CrewxAgentConfig, type CrewxAgentResult, type ProviderConfig, type KnowledgeBaseConfig, } from './agent-factory';
+export { createCrewxAgent, loadAgentConfigFromYaml, loadAgentConfigFromFile, type CrewxAgent, type CrewxAgentConfig, type CrewxAgentResult, type ProviderConfig, type KnowledgeBaseConfig, } from './agent-factory';
 export { AgentRuntime, type AgentQueryRequest, type AgentExecuteRequest, type AgentResult, type AgentRuntimeOptions, } from './agent-runtime';
 export { EventBus, type EventListener, type CallStackFrame, type AgentEvent, } from './event-bus';

package/dist/core/agent/index.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EventBus = exports.AgentRuntime = exports.loadAgentConfigFromYaml = exports.createCrewxAgent = void 0;
+exports.EventBus = exports.AgentRuntime = exports.loadAgentConfigFromFile = exports.loadAgentConfigFromYaml = exports.createCrewxAgent = void 0;
 var agent_factory_1 = require("./agent-factory");
 Object.defineProperty(exports, "createCrewxAgent", { enumerable: true, get: function () { return agent_factory_1.createCrewxAgent; } });
 Object.defineProperty(exports, "loadAgentConfigFromYaml", { enumerable: true, get: function () { return agent_factory_1.loadAgentConfigFromYaml; } });
+Object.defineProperty(exports, "loadAgentConfigFromFile", { enumerable: true, get: function () { return agent_factory_1.loadAgentConfigFromFile; } });
 var agent_runtime_1 = require("./agent-runtime");
 Object.defineProperty(exports, "AgentRuntime", { enumerable: true, get: function () { return agent_runtime_1.AgentRuntime; } });
 var event_bus_1 = require("./event-bus");

package/dist/core/agent/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/agent/index.ts"],"names":[],"mappings":";;;AAIA,iDAQyB;AAPvB,iHAAA,gBAAgB,OAAA;AAChB,wHAAA,uBAAuB,OAAA;AAQzB,iDAMyB;AALvB,6GAAA,YAAY,OAAA;AAOd,yCAKqB;AAJnB,qGAAA,QAAQ,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/agent/index.ts"],"names":[],"mappings":";;;AAIA,iDASyB;AARvB,iHAAA,gBAAgB,OAAA;AAChB,wHAAA,uBAAuB,OAAA;AACvB,wHAAA,uBAAuB,OAAA;AAQzB,iDAMyB;AALvB,6GAAA,YAAY,OAAA;AAOd,yCAKqB;AAJnB,qGAAA,QAAQ,OAAA"}

package/dist/core/parallel/helpers.d.ts

@@ -0,0 +1,27 @@
+import type { ParallelRunnerMetrics } from './types';
+import { type AgentQueryRequest, type AgentExecuteRequest, type AgentResult } from '../agent';
+export interface RetryPolicy {
+    maxRetries: number;
+    retryDelay: number;
+}
+export interface ParallelConfig {
+    concurrency?: number;
+    timeout?: number;
+    retryPolicy?: RetryPolicy;
+    onProgress?: (completed: number, total: number) => void;
+    onComplete?: (result: HelperResult<AgentResult>) => void;
+}
+export interface HelperResult<T = AgentResult> {
+    total: number;
+    completed: number;
+    successCount: number;
+    failureCount: number;
+    results: T[];
+    errors: Array<{
+        index: number;
+        error: Error;
+    }>;
+    metrics: ParallelRunnerMetrics;
+}
+export declare const runQueriesParallel: (queries: AgentQueryRequest[], config?: ParallelConfig) => Promise<AgentResult[]>;
+export declare const runExecutesParallel: (requests: AgentExecuteRequest[], config?: ParallelConfig) => Promise<AgentResult[]>;