@nxuss/lemma 1.7.0 → 1.7.2

package/dist/esm/speculative/index.js

@@ -3,8 +3,8 @@
  *
  * Exports all speculative execution components for Phase 3.
  */
-export { PredictionEngine } from './PredictionEngine';
-export { WorkerPool } from './WorkerPool';
-export { SpeculativeCache } from './SpeculativeCache';
-export { SpeculativeEngine } from './SpeculativeEngine';
+export { PredictionEngine } from './PredictionEngine.js';
+export { WorkerPool } from './WorkerPool.js';
+export { SpeculativeCache } from './SpeculativeCache.js';
+export { SpeculativeEngine } from './SpeculativeEngine.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/subconscious/SemanticCache.d.ts

@@ -1,5 +1,5 @@
-import { VectorStore } from './VectorStore';
-import { EmbeddingService } from './EmbeddingService';
+import { VectorStore } from './VectorStore.js';
+import { EmbeddingService } from './EmbeddingService.js';
 /**
  * Result of a cache lookup operation.
  */

package/dist/esm/subconscious/SemanticCache.js

@@ -1,5 +1,5 @@
-import { EmbeddingService } from './EmbeddingService';
-import { createLogger } from '../utils/logger';
+import { EmbeddingService } from './EmbeddingService.js';
+import { createLogger } from '../utils/logger.js';
 const logger = createLogger('SemanticCache');
 /**
  * SemanticCache implements the "short-circuit" logic for semantic caching.

package/dist/esm/subconscious/SubconsciousEngine.d.ts

@@ -1,4 +1,4 @@
-import { CacheResult } from './SemanticCache';
+import { CacheResult } from './SemanticCache.js';
 import { EventEmitter } from 'events';
 /**
  * Configuration options for SubconsciousEngine.

package/dist/esm/subconscious/SubconsciousEngine.js

@@ -1,6 +1,6 @@
-import { VectorStore } from './VectorStore';
-import { EmbeddingService } from './EmbeddingService';
-import { SemanticCache } from './SemanticCache';
+import { VectorStore } from './VectorStore.js';
+import { EmbeddingService } from './EmbeddingService.js';
+import { SemanticCache } from './SemanticCache.js';
 import { EventEmitter } from 'events';
 /**
  * SubconsciousEngine is the main orchestrator for semantic caching.

package/dist/esm/subconscious/index.d.ts

@@ -5,8 +5,8 @@
  * Provides "short-circuit" logic to return cached results for similar tasks,
  * reducing latency from seconds to milliseconds.
  */
-export { VectorStore } from './VectorStore';
-export { EmbeddingService } from './EmbeddingService';
-export { SemanticCache, CacheResult } from './SemanticCache';
-export { SubconsciousEngine, SubconsciousConfig, Task, TaskResult, EngineMetrics, } from './SubconsciousEngine';
+export { VectorStore } from './VectorStore.js';
+export { EmbeddingService } from './EmbeddingService.js';
+export { SemanticCache, CacheResult } from './SemanticCache.js';
+export { SubconsciousEngine, SubconsciousConfig, Task, TaskResult, EngineMetrics, } from './SubconsciousEngine.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/subconscious/index.js

@@ -5,8 +5,8 @@
  * Provides "short-circuit" logic to return cached results for similar tasks,
  * reducing latency from seconds to milliseconds.
  */
-export { VectorStore } from './VectorStore';
-export { EmbeddingService } from './EmbeddingService';
-export { SemanticCache } from './SemanticCache';
-export { SubconsciousEngine, } from './SubconsciousEngine';
+export { VectorStore } from './VectorStore.js';
+export { EmbeddingService } from './EmbeddingService.js';
+export { SemanticCache } from './SemanticCache.js';
+export { SubconsciousEngine, } from './SubconsciousEngine.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/utils/AutoContextBundle.d.ts

@@ -1,4 +1,4 @@
-import { ImportEntry } from './ImportTreeContext';
+import { ImportEntry } from './ImportTreeContext.js';
 export interface TelepathicHint {
     query: string;
     response: string;

package/dist/esm/utils/AutoContextBundle.js

@@ -1,9 +1,9 @@
 import fs from 'fs';
 import path from 'path';
-import { computeFingerprint } from './FileFingerprint';
-import { squeezeCode } from './ContextSqueezer';
-import { buildImportTree } from './ImportTreeContext';
-import { getBrain, deriveProjectId } from '../subconscious/TheBrainV2';
+import { computeFingerprint } from './FileFingerprint.js';
+import { squeezeCode } from './ContextSqueezer.js';
+import { buildImportTree } from './ImportTreeContext.js';
+import { getBrain, deriveProjectId } from '../subconscious/TheBrainV2.js';
 import * as ts from 'typescript';
 function estimateTokens(text) {
     return Math.ceil(text.length / 4);

package/dist/esm/utils/BulkFileDigest.js

@@ -1,7 +1,7 @@
 import fs from 'fs';
 import path from 'path';
-import { computeFingerprint } from './FileFingerprint';
-import { squeezeCode } from './ContextSqueezer';
+import { computeFingerprint } from './FileFingerprint.js';
+import { squeezeCode } from './ContextSqueezer.js';
 function estimateTokens(text) {
     return Math.ceil(text.length / 4);
 }

package/dist/esm/utils/ClipboardWatcher.js

@@ -1,6 +1,6 @@
 import { execSync, spawn } from 'child_process';
-import { squeezeCode } from './ContextSqueezer';
-import { savingsLedger } from './SavingsLedger';
+import { squeezeCode } from './ContextSqueezer.js';
+import { savingsLedger } from './SavingsLedger.js';
 /**
  * Reads text content from the macOS system clipboard using native pbpaste
  */

package/dist/esm/utils/ContextCollapser.js

@@ -5,7 +5,7 @@
  * Algorithm: Query-Focused TF-IDF Centroid sentence extraction + Jaccard dedup.
  * Latency:   <15ms for 100k characters.
  */
-import { tokenize } from '../subconscious/TheBrainV2';
+import { tokenize } from '../subconscious/TheBrainV2.js';
 /**
  * Split text into logical blocks (sentences or log chunks).
  */

package/dist/esm/utils/ExecutiveReport.js

@@ -7,7 +7,7 @@
  */
 import fs from 'fs';
 import path from 'path';
-import { savingsLedger } from './SavingsLedger';
+import { savingsLedger } from './SavingsLedger.js';
 /**
  * Calculates metrics and writes a highly structured Markdown corporate report.
  */

package/dist/esm/utils/StructuralSearch.d.ts

@@ -1,4 +1,4 @@
-import type { SearchMatch } from "./WorkspaceSearch";
+import type { SearchMatch } from "./WorkspaceSearch.js";
 export interface DeclaredSymbol {
     kind: "function" | "class" | "method" | "interface" | "type" | "enum" | "arrow";
     name: string;

package/dist/esm/utils/SurgicalASTInsert.js

@@ -9,7 +9,7 @@
  */
 import fs from 'fs';
 import * as ts from 'typescript';
-import { safeResolvePath } from '../mcp/utils';
+import { safeResolvePath } from '../mcp/utils.js';
 /**
  * Finds a class or interface node by name.
  */

package/dist/esm/utils/SymbolSurgicalContext.js

@@ -10,7 +10,7 @@
 import fs from 'fs';
 import path from 'path';
 import * as ts from 'typescript';
-import { safeResolvePath } from '../mcp/utils';
+import { safeResolvePath } from '../mcp/utils.js';
 /**
  * Traverses AST to find the node defining the specified symbol name.
  */

package/dist/esm/utils/TestAutofixInterceptor.js

@@ -1,5 +1,5 @@
 import { execSync } from 'child_process';
-import { getBrain, deriveProjectId } from '../subconscious/TheBrainV2';
+import { getBrain, deriveProjectId } from '../subconscious/TheBrainV2.js';
 function extractFailures(output) {
     const failures = [];
     // Jest/Vitest failure pattern

package/dist/esm/utils/TokenReceipt.d.ts

@@ -14,6 +14,12 @@ export interface ReceiptEvent {
     meta?: Record<string, unknown>;
 }
 export declare function recordReceiptEvent(type: ReceiptEventType, label: string, meta?: Record<string, unknown>): void;
+/**
+ * Number of events recorded so far. The dispatcher samples this around a handler to
+ * tell whether the handler already logged something specific (a cache hit, a miss)
+ * before falling back to a generic tool_call entry.
+ */
+export declare function getLedgerLength(): number;
 export interface ReceiptSummary {
     totalEvents: number;
     byType: Record<ReceiptEventType, number>;

package/dist/esm/utils/TokenReceipt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TokenReceipt.d.ts","sourceRoot":"","sources":["../../../src/utils/TokenReceipt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,MAAM,gBAAgB,GACxB,iBAAiB,GACjB,oBAAoB,GACpB,WAAW,GACX,WAAW,GACX,WAAW,CAAC;AAEhB,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAID,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAK9G;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;IACzC,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,SAAK,GAAG,cAAc,CAc5D;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}
+{"version":3,"file":"TokenReceipt.d.ts","sourceRoot":"","sources":["../../../src/utils/TokenReceipt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,MAAM,gBAAgB,GACxB,iBAAiB,GACjB,oBAAoB,GACpB,WAAW,GACX,WAAW,GACX,WAAW,CAAC;AAEhB,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAID,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAK9G;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;IACzC,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,SAAK,GAAG,cAAc,CAc5D;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/dist/esm/utils/TokenReceipt.js

@@ -14,6 +14,14 @@ export function recordReceiptEvent(type, label, meta) {
         sessionLedger.splice(0, sessionLedger.length - MAX_EVENTS);
     }
 }
+/**
+ * Number of events recorded so far. The dispatcher samples this around a handler to
+ * tell whether the handler already logged something specific (a cache hit, a miss)
+ * before falling back to a generic tool_call entry.
+ */
+export function getLedgerLength() {
+    return sessionLedger.length;
+}
 export function getReceiptSummary(limit = 20) {
     const byType = {
         exact_cache_hit: 0,

package/dist/esm/utils/TokenReceipt.js.map

@@ -1 +1 @@
-{"version":3,"file":"TokenReceipt.js","sourceRoot":"","sources":["../../../src/utils/TokenReceipt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,UAAU,GAAG,IAAI,CAAC;AAgBxB,MAAM,aAAa,GAAmB,EAAE,CAAC;AAEzC,MAAM,UAAU,kBAAkB,CAAC,IAAsB,EAAE,KAAa,EAAE,IAA8B;IACtG,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,IAAI,aAAa,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;QACtC,aAAa,CAAC,MAAM,CAAC,CAAC,EAAE,aAAa,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC;AAQD,MAAM,UAAU,iBAAiB,CAAC,KAAK,GAAG,EAAE;IAC1C,MAAM,MAAM,GAAqC;QAC/C,eAAe,EAAE,CAAC;QAClB,kBAAkB,EAAE,CAAC;QACrB,SAAS,EAAE,CAAC;QACZ,SAAS,EAAE,CAAC;QACZ,SAAS,EAAE,CAAC;KACb,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,aAAa;QAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;IAChD,OAAO;QACL,WAAW,EAAE,aAAa,CAAC,MAAM;QACjC,MAAM;QACN,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"TokenReceipt.js","sourceRoot":"","sources":["../../../src/utils/TokenReceipt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,UAAU,GAAG,IAAI,CAAC;AAgBxB,MAAM,aAAa,GAAmB,EAAE,CAAC;AAEzC,MAAM,UAAU,kBAAkB,CAAC,IAAsB,EAAE,KAAa,EAAE,IAA8B;IACtG,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,IAAI,aAAa,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;QACtC,aAAa,CAAC,MAAM,CAAC,CAAC,EAAE,aAAa,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,aAAa,CAAC,MAAM,CAAC;AAC9B,CAAC;AAQD,MAAM,UAAU,iBAAiB,CAAC,KAAK,GAAG,EAAE;IAC1C,MAAM,MAAM,GAAqC;QAC/C,eAAe,EAAE,CAAC;QAClB,kBAAkB,EAAE,CAAC;QACrB,SAAS,EAAE,CAAC;QACZ,SAAS,EAAE,CAAC;QACZ,SAAS,EAAE,CAAC;KACb,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,aAAa;QAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;IAChD,OAAO;QACL,WAAW,EAAE,aAAa,CAAC,MAAM;QACjC,MAAM;QACN,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;AAC3B,CAAC"}

package/dist/esm/utils/logger.js

@@ -1,6 +1,6 @@
 import fs from 'fs';
 import path from 'path';
-import { config } from '../config';
+import { config } from '../config/index.js';
 /**
  * Log levels
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nxuss/lemma",
-  "version": "1.7.0",
+  "version": "1.7.2",
   "description": "Intelligent AI Gateway for IDEs & Agents — Semantic cache, Privacy Firewall, Infrastructure Command Center, and Autonomous Cost-Optimization.",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
@@ -71,10 +71,6 @@
         "default": "./dist/cjs/protocol/index.js"
       }
     },
-    "./langchain": {
-      "types": "./sdks/langchain/dist/index.d.ts",
-      "default": "./sdks/langchain/dist/index.js"
-    },
     "./crewai": {
       "types": "./sdks/crewai/dist/index.d.ts",
       "default": "./sdks/crewai/dist/index.js"
@@ -91,6 +87,7 @@
     "bin/cli.js",
     "bin/checkpoint.js",
     "dashboard/dist/**/*",
+    "sdks/crewai/dist/**/*",
     "!dist/examples/**",
     "README.md",
     "LICENSE"
@@ -100,12 +97,12 @@
     "proxy:stop": "node lemma-proxy.cjs stop",
     "proxy:stats": "node lemma-proxy.cjs stats",
     "proxy:status": "node lemma-proxy.cjs status",
-    "build": "npm run build:esm && npm run build:cjs && npm run postbuild",
-    "build:full": "npm run build && npm run build:sdks",
+    "build": "npm run build:esm && npm run build:cjs && npm run build:sdks",
+    "build:full": "npm run build",
     "build:esm": "tsc --outDir ./dist/esm",
     "build:cjs": "tsc --project tsconfig.cjs.json",
     "build:sdks": "npm run sdk:build",
-    "postbuild": "node scripts/post-build.js",
+    "postbuild": "node scripts/post-build.js && node scripts/fix-esm-extensions.js",
     "dev": "npx tsx start-dev.ts",
     "start": "node dist/cjs/index.js",
     "test": "jest",
@@ -139,7 +136,7 @@
     "stack:all": "bash scripts/launch-all.sh",
     "sdk:langchain:build": "cd sdks/langchain && npm run build",
     "sdk:crewai:build": "cd sdks/crewai && npm run build",
-    "sdk:build": "npm run sdk:langchain:build && npm run sdk:crewai:build",
+    "sdk:build": "npm run sdk:crewai:build",
     "keys:generate": "npx tsx scripts/manage-keys.ts generate",
     "keys:list": "npx tsx scripts/manage-keys.ts list",
     "keys:revoke": "npx tsx scripts/manage-keys.ts revoke"

package/sdks/crewai/README.md

@@ -0,0 +1,178 @@
+# @lemma/crewai
+
+CrewAI integration for Lemma agent orchestration hub.
+
+## Installation
+
+```bash
+npm install @lemma/crewai
+```
+
+## Quick Start
+
+```typescript
+import { LemmaCrewAgent } from '@lemma/crewai';
+
+// Create an agent connected to Lemma
+const agent = new LemmaCrewAgent({
+  routerUrl: 'ws://localhost:8080',
+  agentId: 'research-agent',
+  role: 'Researcher',
+  goal: 'Find and analyze information',
+  backstory: 'Expert researcher with deep analytical skills',
+  capabilities: ['research', 'analysis', 'web-search'],
+});
+
+// Connect to the hub
+await agent.connect();
+
+// Execute a task
+const result = await agent.execute({
+  description: 'Research the latest trends in AI',
+  expectedOutput: 'A comprehensive report on AI trends',
+});
+
+console.log(result);
+
+// Disconnect when done
+agent.disconnect();
+```
+
+## Features
+
+- **Semantic Caching**: Automatic caching of similar tasks
+- **Agent Collaboration**: Discover and delegate to other agents
+- **Task Routing**: Receive tasks from the orchestration hub
+- **Real-time Monitoring**: Track performance through Lemma dashboard
+- **CrewAI Compatible**: Works with existing CrewAI patterns
+
+## Configuration
+
+```typescript
+interface LemmaCrewConfig {
+  routerUrl: string;        // WebSocket URL of Lemma router
+  agentId: string;          // Unique agent identifier
+  role: string;             // Agent role (CrewAI concept)
+  goal: string;             // Agent goal
+  backstory?: string;       // Agent backstory
+  capabilities?: string[];  // Agent capabilities
+  verbose?: boolean;        // Enable verbose logging
+  allowDelegation?: boolean; // Allow task delegation
+}
+```
+
+## Advanced Usage
+
+### Multi-Agent Crew
+
+```typescript
+import { EngramCrew } from '@engram/crewai';
+
+const crew = new EngramCrew({
+  routerUrl: 'ws://localhost:8080',
+  agents: [
+    {
+      agentId: 'researcher',
+      role: 'Researcher',
+      goal: 'Research information',
+      capabilities: ['research', 'web-search'],
+    },
+    {
+      agentId: 'writer',
+      role: 'Writer',
+      goal: 'Write compelling content',
+      capabilities: ['writing', 'editing'],
+    },
+    {
+      agentId: 'reviewer',
+      role: 'Reviewer',
+      goal: 'Review and improve content',
+      capabilities: ['review', 'quality-assurance'],
+    },
+  ],
+});
+
+await crew.connect();
+
+// Execute a multi-step workflow
+const result = await crew.kickoff({
+  task: 'Create a blog post about quantum computing',
+  process: 'sequential', // or 'hierarchical'
+});
+
+console.log(result);
+```
+
+### Task Delegation
+
+```typescript
+const agent = new EngramCrewAgent({
+  routerUrl: 'ws://localhost:8080',
+  agentId: 'manager-agent',
+  role: 'Manager',
+  goal: 'Coordinate team tasks',
+  allowDelegation: true,
+  capabilities: ['management', 'coordination'],
+});
+
+await agent.connect();
+
+// Agent can delegate subtasks to other agents
+const result = await agent.execute({
+  description: 'Create a marketing campaign',
+  allowDelegation: true,
+});
+```
+
+## Benefits
+
+1. **60-80% Cost Reduction**: Semantic caching eliminates redundant LLM calls
+2. **Sub-50ms Responses**: Cached results return instantly
+3. **Agent Discovery**: Automatically find capable agents for tasks
+4. **Centralized Monitoring**: Real-time visibility through dashboard
+5. **Fault Tolerance**: Auto-reconnection and error handling
+
+## Examples
+
+### Research Agent
+
+```typescript
+const researcher = new EngramCrewAgent({
+  routerUrl: 'ws://localhost:8080',
+  agentId: 'researcher-001',
+  role: 'Senior Researcher',
+  goal: 'Conduct thorough research on any topic',
+  backstory: 'PhD in Computer Science with 10 years of research experience',
+  capabilities: ['research', 'analysis', 'fact-checking'],
+});
+
+await researcher.connect();
+
+const findings = await researcher.execute({
+  description: 'Research the impact of AI on healthcare',
+  expectedOutput: 'Detailed research report with citations',
+});
+```
+
+### Code Review Agent
+
+```typescript
+const reviewer = new EngramCrewAgent({
+  routerUrl: 'ws://localhost:8080',
+  agentId: 'code-reviewer',
+  role: 'Senior Code Reviewer',
+  goal: 'Review code for quality and security',
+  capabilities: ['code-review', 'security-audit', 'best-practices'],
+});
+
+await reviewer.connect();
+
+const review = await reviewer.execute({
+  description: 'Review this TypeScript code for issues',
+  context: { code: '...' },
+});
+```
+
+## License
+
+MIT

package/sdks/crewai/dist/index.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Lemma Crew Configuration
+ */
+export interface LemmaCrewConfig {
+    /** WebSocket URL of the Lemma router */
+    routerUrl: string;
+    /** Agent ID */
+    agentId: string;
+    /** Agent role (CrewAI concept) */
+    role: string;
+    /** Agent goal */
+    goal: string;
+    /** Agent backstory */
+    backstory?: string;
+    /** Capabilities this agent provides */
+    capabilities?: string[];
+    /** Enable verbose logging */
+    verbose?: boolean;
+    /** Allow task delegation */
+    allowDelegation?: boolean;
+}
+/**
+ * Task execution request
+ */
+export interface TaskRequest {
+    description: string;
+    expectedOutput?: string;
+    context?: any;
+    allowDelegation?: boolean;
+}
+/**
+ * Task execution result
+ */
+export interface TaskResult {
+    success: boolean;
+    output?: string;
+    error?: string;
+    executionTime: number;
+    cached?: boolean;
+    similarity?: number;
+}
+/**
+ * CrewAI Agent integrated with Lemma Router
+ */
+export declare class LemmaCrewAgent {
+    private ws;
+    private config;
+    private connected;
+    private pendingTasks;
+    constructor(config: LemmaCrewConfig);
+    /**
+     * Connect to Lemma router
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from router
+     */
+    disconnect(): void;
+    /**
+     * Execute a task
+     */
+    execute(task: TaskRequest): Promise<TaskResult>;
+    /**
+     * Handle incoming message from router
+     */
+    private handleMessage;
+    /**
+     * Handle task assignment from router
+     */
+    private handleTaskAssign;
+    /**
+     * Handle task response from router
+     */
+    private handleTaskResponse;
+    /**
+     * Perform task (override in subclasses)
+     */
+    protected performTask(description: string, parameters: any): Promise<string>;
+    /**
+     * Send message to router
+     */
+    private send;
+    /**
+     * Log message if verbose
+     */
+    private log;
+    /**
+     * Get agent info
+     */
+    getInfo(): {
+        agentId: string;
+        role: string;
+        goal: string;
+        backstory: string;
+        capabilities: string[];
+    };
+}
+/**
+ * Lemma Crew - Multi-agent orchestration
+ */
+export interface LemmaCrewOptions {
+    routerUrl: string;
+    agents: Omit<LemmaCrewConfig, 'routerUrl'>[];
+    verbose?: boolean;
+}
+export declare class LemmaCrew {
+    private agents;
+    private config;
+    constructor(config: LemmaCrewOptions);
+    /**
+     * Connect all agents
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect all agents
+     */
+    disconnect(): void;
+    /**
+     * Execute a multi-agent workflow
+     */
+    kickoff(options: {
+        task: string;
+        process?: 'sequential' | 'hierarchical';
+    }): Promise<any>;
+    /**
+     * Get all agents
+     */
+    getAgents(): LemmaCrewAgent[];
+}
+export default LemmaCrewAgent;