agents-library 1.1.0

package/dist/common/result.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Result Type Pattern for Predictable Error Handling
+ *
+ * Provides a type-safe way to handle success and error cases without throwing exceptions.
+ * Inspired by Rust's Result<T, E> type.
+ *
+ * @example
+ * ```typescript
+ * const result = await someOperation();
+ * if (result.success) {
+ *   console.log(result.data);
+ * } else {
+ *   console.error(result.error);
+ * }
+ * ```
+ */
+/**
+ * Result type representing either success with data or failure with error
+ */
+export type Result<T, E> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: E;
+};
+/**
+ * Helper function to create a successful Result
+ *
+ * @param data - The success data
+ * @returns Success Result
+ *
+ * @example
+ * ```typescript
+ * return ok({ message: 'Success!' });
+ * ```
+ */
+export declare function ok<T, E = never>(data: T): Result<T, E>;
+/**
+ * Helper function to create a failed Result
+ *
+ * @param error - The error data
+ * @returns Error Result
+ *
+ * @example
+ * ```typescript
+ * return err(new Error('Something went wrong'));
+ * ```
+ */
+export declare function err<T = never, E = unknown>(error: E): Result<T, E>;
+//# sourceMappingURL=result.d.ts.map

package/dist/common/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/common/result.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;GAEG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,IACnB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC1B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAEjC;;;;;;;;;;GAUG;AACH,wBAAgB,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAEtD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,GAAG,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAElE"}

package/dist/common/result.js

@@ -0,0 +1,45 @@
+/**
+ * Result Type Pattern for Predictable Error Handling
+ *
+ * Provides a type-safe way to handle success and error cases without throwing exceptions.
+ * Inspired by Rust's Result<T, E> type.
+ *
+ * @example
+ * ```typescript
+ * const result = await someOperation();
+ * if (result.success) {
+ *   console.log(result.data);
+ * } else {
+ *   console.error(result.error);
+ * }
+ * ```
+ */
+/**
+ * Helper function to create a successful Result
+ *
+ * @param data - The success data
+ * @returns Success Result
+ *
+ * @example
+ * ```typescript
+ * return ok({ message: 'Success!' });
+ * ```
+ */
+export function ok(data) {
+    return { success: true, data };
+}
+/**
+ * Helper function to create a failed Result
+ *
+ * @param error - The error data
+ * @returns Error Result
+ *
+ * @example
+ * ```typescript
+ * return err(new Error('Something went wrong'));
+ * ```
+ */
+export function err(error) {
+    return { success: false, error };
+}
+//# sourceMappingURL=result.js.map

package/dist/common/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/common/result.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AASH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,EAAE,CAAe,IAAO;IACtC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACjC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,GAAG,CAAyB,KAAQ;IAClD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACnC,CAAC"}

package/dist/common/types.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Common Types
+ *
+ * Shared type definitions used across the application
+ */
+/**
+ * File error types
+ */
+export declare enum FileErrorType {
+    READ_ERROR = "READ_ERROR",
+    WRITE_ERROR = "WRITE_ERROR",
+    PARSE_ERROR = "PARSE_ERROR",
+    NOT_FOUND = "NOT_FOUND",
+    PERMISSION_DENIED = "PERMISSION_DENIED",
+    UNKNOWN = "UNKNOWN",
+    START_SERVER_FAILED = "START_SERVER_FAILED",
+    STOP_SERVER_FAILED = "STOP_SERVER_FAILED",
+    UPLOAD_FAILED = "UPLOAD_FAILED",
+    DOWNLOAD_FAILED = "DOWNLOAD_FAILED",
+    LIST_FILES_FAILED = "LIST_FILES_FAILED",
+    SHARE_CONTAINER_FAILED = "SHARE_CONTAINER_FAILED",
+    STOP_REGISTRY_FAILED = "STOP_REGISTRY_FAILED",
+    SSH_UPLOAD_FAILED = "SSH_UPLOAD_FAILED",
+    SSH_DOWNLOAD_FAILED = "SSH_DOWNLOAD_FAILED",
+    SSH_COMMAND_FAILED = "SSH_COMMAND_FAILED",
+    KADI_PROTOCOL_ERROR = "KADI_PROTOCOL_ERROR"
+}
+/**
+ * File operation error
+ */
+export interface FileError {
+    type: FileErrorType;
+    message: string;
+    filePath: string;
+    originalError?: unknown;
+}
+/**
+ * Database error types
+ */
+export declare enum DatabaseErrorType {
+    CONNECTION_ERROR = "CONNECTION_ERROR",
+    QUERY_ERROR = "QUERY_ERROR",
+    AUTH_ERROR = "AUTH_ERROR",
+    NOT_CONNECTED = "NOT_CONNECTED",
+    TIMEOUT = "TIMEOUT",
+    UNKNOWN = "UNKNOWN"
+}
+/**
+ * Database operation error
+ */
+export interface DatabaseError {
+    type: DatabaseErrorType;
+    message: string;
+    query?: string;
+    originalError?: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/common/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,oBAAY,aAAa;IACvB,UAAU,eAAe;IACzB,WAAW,gBAAgB;IAC3B,WAAW,gBAAgB;IAC3B,SAAS,cAAc;IACvB,iBAAiB,sBAAsB;IACvC,OAAO,YAAY;IAEnB,mBAAmB,wBAAwB;IAC3C,kBAAkB,uBAAuB;IACzC,aAAa,kBAAkB;IAC/B,eAAe,oBAAoB;IACnC,iBAAiB,sBAAsB;IACvC,sBAAsB,2BAA2B;IACjD,oBAAoB,yBAAyB;IAC7C,iBAAiB,sBAAsB;IACvC,mBAAmB,wBAAwB;IAC3C,kBAAkB,uBAAuB;IACzC,mBAAmB,wBAAwB;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,oBAAY,iBAAiB;IAC3B,gBAAgB,qBAAqB;IACrC,WAAW,gBAAgB;IAC3B,UAAU,eAAe;IACzB,aAAa,kBAAkB;IAC/B,OAAO,YAAY;IACnB,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB"}

package/dist/common/types.js

@@ -0,0 +1,42 @@
+/**
+ * Common Types
+ *
+ * Shared type definitions used across the application
+ */
+/**
+ * File error types
+ */
+export var FileErrorType;
+(function (FileErrorType) {
+    FileErrorType["READ_ERROR"] = "READ_ERROR";
+    FileErrorType["WRITE_ERROR"] = "WRITE_ERROR";
+    FileErrorType["PARSE_ERROR"] = "PARSE_ERROR";
+    FileErrorType["NOT_FOUND"] = "NOT_FOUND";
+    FileErrorType["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+    FileErrorType["UNKNOWN"] = "UNKNOWN";
+    // File management errors
+    FileErrorType["START_SERVER_FAILED"] = "START_SERVER_FAILED";
+    FileErrorType["STOP_SERVER_FAILED"] = "STOP_SERVER_FAILED";
+    FileErrorType["UPLOAD_FAILED"] = "UPLOAD_FAILED";
+    FileErrorType["DOWNLOAD_FAILED"] = "DOWNLOAD_FAILED";
+    FileErrorType["LIST_FILES_FAILED"] = "LIST_FILES_FAILED";
+    FileErrorType["SHARE_CONTAINER_FAILED"] = "SHARE_CONTAINER_FAILED";
+    FileErrorType["STOP_REGISTRY_FAILED"] = "STOP_REGISTRY_FAILED";
+    FileErrorType["SSH_UPLOAD_FAILED"] = "SSH_UPLOAD_FAILED";
+    FileErrorType["SSH_DOWNLOAD_FAILED"] = "SSH_DOWNLOAD_FAILED";
+    FileErrorType["SSH_COMMAND_FAILED"] = "SSH_COMMAND_FAILED";
+    FileErrorType["KADI_PROTOCOL_ERROR"] = "KADI_PROTOCOL_ERROR";
+})(FileErrorType || (FileErrorType = {}));
+/**
+ * Database error types
+ */
+export var DatabaseErrorType;
+(function (DatabaseErrorType) {
+    DatabaseErrorType["CONNECTION_ERROR"] = "CONNECTION_ERROR";
+    DatabaseErrorType["QUERY_ERROR"] = "QUERY_ERROR";
+    DatabaseErrorType["AUTH_ERROR"] = "AUTH_ERROR";
+    DatabaseErrorType["NOT_CONNECTED"] = "NOT_CONNECTED";
+    DatabaseErrorType["TIMEOUT"] = "TIMEOUT";
+    DatabaseErrorType["UNKNOWN"] = "UNKNOWN";
+})(DatabaseErrorType || (DatabaseErrorType = {}));
+//# sourceMappingURL=types.js.map

package/dist/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/common/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,aAmBX;AAnBD,WAAY,aAAa;IACvB,0CAAyB,CAAA;IACzB,4CAA2B,CAAA;IAC3B,4CAA2B,CAAA;IAC3B,wCAAuB,CAAA;IACvB,wDAAuC,CAAA;IACvC,oCAAmB,CAAA;IACnB,yBAAyB;IACzB,4DAA2C,CAAA;IAC3C,0DAAyC,CAAA;IACzC,gDAA+B,CAAA;IAC/B,oDAAmC,CAAA;IACnC,wDAAuC,CAAA;IACvC,kEAAiD,CAAA;IACjD,8DAA6C,CAAA;IAC7C,wDAAuC,CAAA;IACvC,4DAA2C,CAAA;IAC3C,0DAAyC,CAAA;IACzC,4DAA2C,CAAA;AAC7C,CAAC,EAnBW,aAAa,KAAb,aAAa,QAmBxB;AAYD;;GAEG;AACH,MAAM,CAAN,IAAY,iBAOX;AAPD,WAAY,iBAAiB;IAC3B,0DAAqC,CAAA;IACrC,gDAA2B,CAAA;IAC3B,8CAAyB,CAAA;IACzB,oDAA+B,CAAA;IAC/B,wCAAmB,CAAA;IACnB,wCAAmB,CAAA;AACrB,CAAC,EAPW,iBAAiB,KAAjB,iBAAiB,QAO5B"}

package/dist/index.d.ts

@@ -0,0 +1,94 @@
+/**
+ * agents-library
+ * ==============
+ *
+ * Shared utilities and factories for KĀDI multi-agent orchestration system.
+ *
+ * This package eliminates code duplication across worker agents, shadow agents,
+ * and agent-producer by providing reusable factories, utilities, and type definitions.
+ *
+ * ## Exports
+ *
+ * ### Utilities
+ * - **BaseBot** - Abstract base class with circuit breaker pattern and retry logic
+ * - **KadiEventPublisher** - Event publishing utility for KĀDI broker with connection retry
+ * - **validateTopicPattern** - Topic pattern validation for KĀDI broker
+ *
+ * ### Factories
+ * - **WorkerAgentFactory** - Factory for creating worker agents (artist, designer, programmer)
+ * - **BaseWorkerAgent** - Base class for worker agents with lifecycle management
+ * - **createWorkerAgent** - Convenience function for worker agent creation
+ * - **ShadowAgentFactory** - Factory for creating shadow backup agents
+ * - **BaseShadowAgent** - Base class for shadow agents with filesystem and git monitoring
+ * - **createShadowAgent** - Convenience function for shadow agent creation
+ * - **ShadowAgentConfigSchema** - Zod schema for shadow agent configuration validation
+ *
+ * ### Producer Utilities
+ * - **invokeShrimTool** - Invoke shrimp-task-manager tools via KĀDI protocol with retry logic
+ * - **orchestrateWithClaude** - Claude API orchestration with tool invocation (Option C pattern)
+ * - **publishToolEvent** - Standardized tool event publishing to KĀDI broker
+ * - **classifyToolError** - Enhanced error classification for intelligent retry logic
+ * - **isToolSuccess** - Type guard for successful tool invocations
+ * - **isToolFailure** - Type guard for failed tool invocations
+ *
+ * ### Types
+ *
+ * #### Agent Configuration Types
+ * - **AgentRole** - Union type for agent roles (artist, designer, programmer)
+ * - **WorkerAgentConfig** - Configuration interface for worker agents
+ * - **ShadowAgentConfig** - Configuration interface for shadow agents
+ * - **WorkerBehaviors** - Custom behavior overrides for worker agents
+ * - **PathConfig** - Path configuration for agent worktrees
+ * - **NetworkConfig** - Network configuration for KĀDI broker
+ *
+ * #### Event Schema Types
+ * - **TaskAssignedEvent** - Event schema for task assignments
+ * - **TaskCompletedEvent** - Event schema for task completions
+ * - **TaskFailedEvent** - Event schema for task failures
+ * - **TaskRejectedEvent** - Event schema for task rejections (capability mismatch)
+ * - **BackupEvent** - Event schema for shadow agent backups
+ * - Event validation schemas and type guards
+ *
+ * #### Tool Schema Types
+ * - **ErrorType** - Enum for error classification (transient, permanent)
+ * - **ErrorClassification** - Detailed error classification with category and retry info
+ * - **ToolSchema** - Tool definition interface for KĀDI tool registration
+ * - **ToolInvocationSuccess** - Success result from tool invocation
+ * - **ToolInvocationFailure** - Failure result from tool invocation
+ * - **ToolInvocationResult** - Discriminated union for tool results
+ * - **ToolInvocationParams** - Parameters for tool invocation via KĀDI protocol
+ * - Tool validation schemas and type guards
+ *
+ * #### Producer Utility Types
+ * - **InvokeOptions** - Options for invokeShrimTool
+ * - **ShrimpToolResult** - Result structure for shrimp tool invocations
+ * - **ToolDefinition** - Claude API tool definition
+ * - **ToolInvocation** - Record of a tool invocation during orchestration
+ * - **OrchestrationOptions** - Options for orchestrateWithClaude
+ * - **OrchestrationResult** - Result from orchestrateWithClaude
+ * - **EventMetadata** - Metadata for tool event publication
+ *
+ * @module agents-library
+ */
+export { BaseBot, BaseBotConfig } from './base-bot.js';
+export { BaseAgent, type BaseAgentConfig, type BaseAgentProviderConfig, type BaseAgentMemoryConfig } from './base-agent.js';
+export { KadiEventPublisher, PublisherConfig, validateTopicPattern } from './kadi-event-publisher.js';
+export { logger, MODULE_AGENT, MODULE_SLACK_BOT, MODULE_DISCORD_BOT, MODULE_TASK_HANDLER, MODULE_TOOLS } from './utils/logger.js';
+export { timer, type Timer } from './utils/timer.js';
+export { invokeShrimTool, isToolSuccess, isToolFailure, orchestrateWithClaude, publishToolEvent, type InvokeOptions, type ShrimpToolResult, type ToolDefinition, type ToolInvocation, type OrchestrationOptions, type OrchestrationResult, type EventMetadata } from './producer-tool-utils.js';
+export { BaseWorkerAgent, WorkerAgentFactory, createWorkerAgent } from './worker-agent-factory.js';
+export { BaseShadowAgent, ShadowAgentFactory, ShadowAgentConfigSchema, createShadowAgent } from './shadow-agent-factory.js';
+export { type AgentRole, type WorkerAgentConfig, type ShadowAgentConfig, type WorkerBehaviors, type PathConfig, type NetworkConfig } from './types/agent-config.js';
+export { type TaskAssignedEvent, type TaskCompletedEvent, type TaskFailedEvent, type TaskRejectedEvent, type BackupEvent, TaskAssignedEventSchema, TaskCompletedEventSchema, TaskFailedEventSchema, TaskRejectedEventSchema, BackupEventSchema, isTaskAssignedEvent, isTaskCompletedEvent, isTaskFailedEvent, isTaskRejectedEvent, isBackupEvent, parseTaskAssignedEvent, parseTaskCompletedEvent, parseTaskFailedEvent, parseTaskRejectedEvent, parseBackupEvent } from './types/event-schemas.js';
+export { ErrorType, type ToolSchema, type ToolInvocationSuccess, type ToolInvocationFailure, type ToolInvocationResult, type ToolInvocationParams, type ErrorClassification, ToolInvocationSuccessSchema, ToolInvocationFailureSchema, ToolInvocationResultSchema, ToolInvocationParamsSchema, isToolInvocationSuccess, isToolInvocationFailure, classifyToolError } from './types/tool-schemas.js';
+export { ProviderManager } from './providers/provider-manager.js';
+export { AnthropicProvider } from './providers/anthropic-provider.js';
+export { ModelManagerProvider } from './providers/model-manager-provider.js';
+export * from './providers/types.js';
+export { MemoryService } from './memory/memory-service.js';
+export { FileStorageAdapter } from './memory/file-storage-adapter.js';
+export { ArcadeDBAdapter, ArcadeDBClient } from './memory/arcadedb-adapter.js';
+export { type MemoryType, type MemoryEntry, type ConversationMessage, type ConversationSummary, type UserPreference, type PublicKnowledge, MemoryErrorType, type MemoryError } from './memory/types.js';
+export { type Result, ok, err } from './common/result.js';
+export * from './common/types.js';
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,108 @@
+/**
+ * agents-library
+ * ==============
+ *
+ * Shared utilities and factories for KĀDI multi-agent orchestration system.
+ *
+ * This package eliminates code duplication across worker agents, shadow agents,
+ * and agent-producer by providing reusable factories, utilities, and type definitions.
+ *
+ * ## Exports
+ *
+ * ### Utilities
+ * - **BaseBot** - Abstract base class with circuit breaker pattern and retry logic
+ * - **KadiEventPublisher** - Event publishing utility for KĀDI broker with connection retry
+ * - **validateTopicPattern** - Topic pattern validation for KĀDI broker
+ *
+ * ### Factories
+ * - **WorkerAgentFactory** - Factory for creating worker agents (artist, designer, programmer)
+ * - **BaseWorkerAgent** - Base class for worker agents with lifecycle management
+ * - **createWorkerAgent** - Convenience function for worker agent creation
+ * - **ShadowAgentFactory** - Factory for creating shadow backup agents
+ * - **BaseShadowAgent** - Base class for shadow agents with filesystem and git monitoring
+ * - **createShadowAgent** - Convenience function for shadow agent creation
+ * - **ShadowAgentConfigSchema** - Zod schema for shadow agent configuration validation
+ *
+ * ### Producer Utilities
+ * - **invokeShrimTool** - Invoke shrimp-task-manager tools via KĀDI protocol with retry logic
+ * - **orchestrateWithClaude** - Claude API orchestration with tool invocation (Option C pattern)
+ * - **publishToolEvent** - Standardized tool event publishing to KĀDI broker
+ * - **classifyToolError** - Enhanced error classification for intelligent retry logic
+ * - **isToolSuccess** - Type guard for successful tool invocations
+ * - **isToolFailure** - Type guard for failed tool invocations
+ *
+ * ### Types
+ *
+ * #### Agent Configuration Types
+ * - **AgentRole** - Union type for agent roles (artist, designer, programmer)
+ * - **WorkerAgentConfig** - Configuration interface for worker agents
+ * - **ShadowAgentConfig** - Configuration interface for shadow agents
+ * - **WorkerBehaviors** - Custom behavior overrides for worker agents
+ * - **PathConfig** - Path configuration for agent worktrees
+ * - **NetworkConfig** - Network configuration for KĀDI broker
+ *
+ * #### Event Schema Types
+ * - **TaskAssignedEvent** - Event schema for task assignments
+ * - **TaskCompletedEvent** - Event schema for task completions
+ * - **TaskFailedEvent** - Event schema for task failures
+ * - **TaskRejectedEvent** - Event schema for task rejections (capability mismatch)
+ * - **BackupEvent** - Event schema for shadow agent backups
+ * - Event validation schemas and type guards
+ *
+ * #### Tool Schema Types
+ * - **ErrorType** - Enum for error classification (transient, permanent)
+ * - **ErrorClassification** - Detailed error classification with category and retry info
+ * - **ToolSchema** - Tool definition interface for KĀDI tool registration
+ * - **ToolInvocationSuccess** - Success result from tool invocation
+ * - **ToolInvocationFailure** - Failure result from tool invocation
+ * - **ToolInvocationResult** - Discriminated union for tool results
+ * - **ToolInvocationParams** - Parameters for tool invocation via KĀDI protocol
+ * - Tool validation schemas and type guards
+ *
+ * #### Producer Utility Types
+ * - **InvokeOptions** - Options for invokeShrimTool
+ * - **ShrimpToolResult** - Result structure for shrimp tool invocations
+ * - **ToolDefinition** - Claude API tool definition
+ * - **ToolInvocation** - Record of a tool invocation during orchestration
+ * - **OrchestrationOptions** - Options for orchestrateWithClaude
+ * - **OrchestrationResult** - Result from orchestrateWithClaude
+ * - **EventMetadata** - Metadata for tool event publication
+ *
+ * @module agents-library
+ */
+// ============================================================================
+// Utilities
+// ============================================================================
+export { BaseBot } from './base-bot.js';
+export { BaseAgent } from './base-agent.js';
+export { KadiEventPublisher, validateTopicPattern } from './kadi-event-publisher.js';
+export { logger, MODULE_AGENT, MODULE_SLACK_BOT, MODULE_DISCORD_BOT, MODULE_TASK_HANDLER, MODULE_TOOLS } from './utils/logger.js';
+export { timer } from './utils/timer.js';
+export { invokeShrimTool, isToolSuccess, isToolFailure, orchestrateWithClaude, publishToolEvent } from './producer-tool-utils.js';
+// ============================================================================
+// Factories
+// ============================================================================
+export { BaseWorkerAgent, WorkerAgentFactory, createWorkerAgent } from './worker-agent-factory.js';
+export { BaseShadowAgent, ShadowAgentFactory, ShadowAgentConfigSchema, createShadowAgent } from './shadow-agent-factory.js';
+export { TaskAssignedEventSchema, TaskCompletedEventSchema, TaskFailedEventSchema, TaskRejectedEventSchema, BackupEventSchema, isTaskAssignedEvent, isTaskCompletedEvent, isTaskFailedEvent, isTaskRejectedEvent, isBackupEvent, parseTaskAssignedEvent, parseTaskCompletedEvent, parseTaskFailedEvent, parseTaskRejectedEvent, parseBackupEvent } from './types/event-schemas.js';
+export { ErrorType, ToolInvocationSuccessSchema, ToolInvocationFailureSchema, ToolInvocationResultSchema, ToolInvocationParamsSchema, isToolInvocationSuccess, isToolInvocationFailure, classifyToolError } from './types/tool-schemas.js';
+// ============================================================================
+// Providers
+// ============================================================================
+export { ProviderManager } from './providers/provider-manager.js';
+export { AnthropicProvider } from './providers/anthropic-provider.js';
+export { ModelManagerProvider } from './providers/model-manager-provider.js';
+export * from './providers/types.js';
+// ============================================================================
+// Memory Services
+// ============================================================================
+export { MemoryService } from './memory/memory-service.js';
+export { FileStorageAdapter } from './memory/file-storage-adapter.js';
+export { ArcadeDBAdapter, ArcadeDBClient } from './memory/arcadedb-adapter.js';
+export { MemoryErrorType } from './memory/types.js';
+// ============================================================================
+// Common Utilities
+// ============================================================================
+export { ok, err } from './common/result.js';
+export * from './common/types.js';
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuEG;AAEH,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,OAAO,EAAE,OAAO,EAAiB,MAAM,eAAe,CAAC;AACvD,OAAO,EACL,SAAS,EAIV,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAmB,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtG,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAClI,OAAO,EAAE,KAAK,EAAc,MAAM,kBAAkB,CAAC;AACrD,OAAO,EACL,eAAe,EACf,aAAa,EACb,aAAa,EACb,qBAAqB,EACrB,gBAAgB,EAQjB,MAAM,0BAA0B,CAAC;AAElC,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EAClB,MAAM,2BAA2B,CAAC;AAenC,OAAO,EAML,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,SAAS,EAOT,2BAA2B,EAC3B,2BAA2B,EAC3B,0BAA0B,EAC1B,0BAA0B,EAC1B,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,EAClB,MAAM,yBAAyB,CAAC;AAEjC,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,cAAc,sBAAsB,CAAC;AAErC,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC/E,OAAO,EAOL,eAAe,EAEhB,MAAM,mBAAmB,CAAC;AAE3B,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,OAAO,EAAe,EAAE,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC1D,cAAc,mBAAmB,CAAC"}

package/dist/kadi-event-publisher.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Shared KĀDI Event Publisher Utility
+ * ====================================
+ *
+ * Common publisher logic extracted from mcp-client-slack and mcp-client-discord
+ * to eliminate code duplication (DRY principle).
+ *
+ * Architecture:
+ * - Generic event publishing to KĀDI broker
+ * - Platform-agnostic connection management
+ * - Graceful degradation pattern (stub mode if broker unavailable)
+ * - Retry logic with exponential backoff
+ *
+ * Usage:
+ * ```typescript
+ * const publisher = new KadiEventPublisher({
+ *   brokerUrl: 'ws://localhost:8080/kadi',
+ *   clientName: 'mcp-client-slack',
+ *   networks: ['slack']
+ * });
+ * await publisher.connect();
+ * await publisher.publishEvent('slack.app_mention.U12345', event);
+ * ```
+ */
+/**
+ * Validates topic pattern against standard format: {platform}.{event_type}.{bot_id}
+ *
+ * @param topic - Topic string to validate
+ * @returns True if topic matches pattern, false otherwise
+ *
+ * @example
+ * ```typescript
+ * validateTopicPattern('slack.app_mention.U12345') // true
+ * validateTopicPattern('discord.mention.67890') // true
+ * validateTopicPattern('invalid-topic') // false
+ * validateTopicPattern('slack.app_mention') // false (missing bot_id)
+ * ```
+ */
+export declare function validateTopicPattern(topic: string): boolean;
+/**
+ * Configuration interface for KĀDI Event Publisher
+ */
+export interface PublisherConfig {
+    /** KĀDI broker WebSocket URL (e.g., 'ws://localhost:8080/kadi') */
+    brokerUrl: string;
+    /** Client name for identification in broker logs */
+    clientName: string;
+    /** Network(s) this publisher belongs to (e.g., ['slack'], ['discord']) */
+    networks: string[];
+    /** Client version (default: '1.0.0') */
+    version?: string;
+}
+/**
+ * Shared KĀDI Event Publisher
+ *
+ * Provides common event publishing functionality for all MCP clients.
+ * Handles connection management, retry logic, graceful degradation,
+ * and error handling.
+ */
+export declare class KadiEventPublisher {
+    private client;
+    private enabled;
+    private config;
+    /**
+     * Create a new KĀDI Event Publisher
+     *
+     * @param config - Publisher configuration with broker URL, client name, and networks
+     *
+     * @example
+     * ```typescript
+     * const publisher = new KadiEventPublisher({
+     *   brokerUrl: 'ws://localhost:8080/kadi',
+     *   clientName: 'mcp-client-slack',
+     *   networks: ['slack']
+     * });
+     * ```
+     */
+    constructor(config: PublisherConfig);
+    /**
+     * Create a new KadiClient instance
+     * Must be called before each connection attempt to avoid handshake state issues
+     *
+     * @private
+     */
+    private createClient;
+    /**
+     * Connect to KĀDI broker with retry logic
+     *
+     * Establishes WebSocket connection and performs authentication handshake.
+     * Retries with exponential backoff when broker is not ready (e.g., during startup).
+     * Logs connection status for debugging.
+     *
+     * Retry schedule: 5 attempts with exponential backoff (1s, 2s, 4s, 8s, 16s)
+     *
+     * @throws {Error} If connection fails after all retries
+     *
+     * @example
+     * ```typescript
+     * await publisher.connect();
+     * console.log('Connected to KĀDI broker');
+     * ```
+     */
+    connect(): Promise<void>;
+    /**
+     * Publish an event to a specific KĀDI broker topic
+     *
+     * Generic event publishing method. Accepts any event data and publishes
+     * it to the specified topic. Validation should be done by the caller.
+     *
+     * @param topic - Topic pattern (e.g., 'slack.app_mention.U12345', 'discord.mention.67890')
+     * @param event - Event data to publish (must be JSON-serializable)
+     * @param metadata - Optional metadata for logging (e.g., { eventId, user, textPreview })
+     *
+     * @throws {Error} If publish fails (fail-fast, no retry)
+     *
+     * @example
+     * ```typescript
+     * await publisher.publishEvent(
+     *   'slack.app_mention.U12345',
+     *   {
+     *     id: '1234567890.123456',
+     *     user: 'U12345678',
+     *     text: 'Hello bot!',
+     *     channel: 'C12345678',
+     *     bot_id: 'U87654321',
+     *     timestamp: '2025-11-29T12:00:00Z'
+     *   },
+     *   { eventId: '1234567890.123456', user: 'U12345678', textPreview: 'Hello bot!' }
+     * );
+     * ```
+     */
+    publishEvent(topic: string, event: Record<string, any>, metadata?: {
+        eventId?: string;
+        user?: string;
+        textPreview?: string;
+    }): Promise<void>;
+    /**
+     * Disconnect from KĀDI broker
+     *
+     * Performs cleanup and gracefully closes WebSocket connection.
+     * Safe to call multiple times (idempotent).
+     *
+     * @example
+     * ```typescript
+     * await publisher.disconnect();
+     * console.log('Disconnected from KĀDI broker');
+     * ```
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Check if publisher is connected and enabled
+     *
+     * @returns True if connected to broker and publishing is enabled
+     */
+    isConnected(): boolean;
+    /**
+     * Get current publisher configuration
+     *
+     * @returns Current publisher configuration
+     */
+    getConfig(): Readonly<Required<PublisherConfig>>;
+}
+//# sourceMappingURL=kadi-event-publisher.d.ts.map

package/dist/kadi-event-publisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kadi-event-publisher.d.ts","sourceRoot":"","sources":["../src/kadi-event-publisher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAO3D;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAElB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IAEnB,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,MAAM,CAA4B;IAE1C;;;;;;;;;;;;;OAaG;gBACS,MAAM,EAAE,eAAe;IAuBnC;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAkCpB;;;;;;;;;;;;;;;;OAgBG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA2C9B;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACG,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1B,QAAQ,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GACnE,OAAO,CAAC,IAAI,CAAC;IAqChB;;;;;;;;;;;OAWG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBjC;;;;OAIG;IACI,WAAW,IAAI,OAAO;IAI7B;;;;OAIG;IACI,SAAS,IAAI,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;CAGxD"}