@almadar/agent 2.0.3 → 2.0.5

package/dist/index.d.ts

@@ -39,8 +39,8 @@ export { MemorySessionBackend, FirestoreCheckpointer, FirestoreSessionStore, Fir
 export type { FirestoreCheckpointerOptions, FirestoreDb, FirestoreTimestamp, FirestoreSessionStoreOptions, FirestoreStoreOptions, Session, } from './persistence/index.js';
 export { transformAgentEvent, transformAgentEventMulti, hasInterrupt, extractInterruptData, isTodoUpdate, isFileOperation, extractFileOperation, } from './event-transformer/index.js';
 export type { RawAgentEvent, } from './event-transformer/index.js';
-export { MemoryOrbitalSchema, MemoryManager, PreferenceLearner, createPreferenceLearner, AgenticSearchEngine, createAgenticSearchEngine, ObservabilityCollector, getObservabilityCollector, resetObservabilityCollector, recordEvent, startObservabilitySession, endObservabilitySession, getPerformanceSnapshot, MultiUserManager, getMultiUserManager, resetMultiUserManager, createUserContext, isAdmin, requireOwnership, StateSyncManager, getStateSyncManager, resetStateSyncManager, withSync, debounceSync, } from './memory/index.js';
-export type { UserPreference, GenerationSession, ProjectContext, UserFeedback, PatternAffinity, InterruptRecord, ToolApprovalPreference, CheckpointRecord, MemoryManagerOptions, PreferenceLearnerOptions, InferredPreference, PreferenceAnalysis, SearchStrategy, AgenticSearchParams, SearchResult, AgenticSearchResponse, ObservableEventType, ObservableEvent, SessionTelemetry, PerformanceSnapshot, HealthCheckResult, UserContext, ScopedSessionMetadata, AccessCheckResult, UserSessionStats, StateChangeType, StateChangeEvent, VersionVector, StateSyncSnapshot, ConflictResolution, StateSyncConfig, } from './memory/index.js';
+export { MemoryOrbitalSchema, MemoryManager, PreferenceLearner, createPreferenceLearner, AgenticSearchEngine, createAgenticSearchEngine, ObservabilityCollector, getObservabilityCollector, resetObservabilityCollector, recordEvent, startObservabilitySession, endObservabilitySession, getPerformanceSnapshot, MultiUserManager, getMultiUserManager, resetMultiUserManager, createUserContext, isAdmin, requireOwnership, StateSyncManager, getStateSyncManager, resetStateSyncManager, withSync, debounceSync, LocalMemoryBackend, } from './memory/index.js';
+export type { UserPreference, GenerationSession, ProjectContext, UserFeedback, PatternAffinity, InterruptRecord, ToolApprovalPreference, CheckpointRecord, MemoryManagerOptions, PreferenceLearnerOptions, InferredPreference, PreferenceAnalysis, SearchStrategy, AgenticSearchParams, SearchResult, AgenticSearchResponse, ObservableEventType, ObservableEvent, SessionTelemetry, PerformanceSnapshot, HealthCheckResult, UserContext, ScopedSessionMetadata, AccessCheckResult, UserSessionStats, StateChangeType, StateChangeEvent, VersionVector, StateSyncSnapshot, ConflictResolution, StateSyncConfig, LocalMemoryBackendOptions, ErrorResolution, } from './memory/index.js';
 export { OnlineEvalSampler, createOnlineEvalSampler, reviewSamples, } from './evals/online-sampling.js';
 export type { SamplingConfig, EvalSample, ErrorAlert, SamplingStats, ReviewOptions, } from './evals/online-sampling.js';
 export { WorkflowEngine, WorkflowBuilder, createWorkflowEngine, createSchemaGenerationWorkflow, } from './tools/composition.js';

package/dist/index.js

@@ -3792,27 +3792,27 @@ var CombineSchemaInputSchema = z.object({
   validate: z.boolean().optional().default(true)
 });
 async function autoCollectOrbitals(workDir) {
-  const fs10 = await import('fs');
-  const path11 = await import('path');
-  const orbitalsDir = path11.join(workDir, ".orbitals");
-  if (!fs10.existsSync(orbitalsDir)) {
-    const files2 = fs10.readdirSync(workDir).filter(
+  const fs12 = await import('fs');
+  const path13 = await import('path');
+  const orbitalsDir = path13.join(workDir, ".orbitals");
+  if (!fs12.existsSync(orbitalsDir)) {
+    const files2 = fs12.readdirSync(workDir).filter(
       (f) => f.endsWith(".json") && (f.startsWith("orbital-") || f.includes("orbital"))
     );
     if (files2.length === 0) {
       throw new Error("No orbitals found. Generate orbitals first using generate_orbital, or provide them directly.");
     }
     return files2.map((f) => {
-      const content = fs10.readFileSync(path11.join(workDir, f), "utf-8");
+      const content = fs12.readFileSync(path13.join(workDir, f), "utf-8");
       return JSON.parse(content);
     });
   }
-  const files = fs10.readdirSync(orbitalsDir).filter((f) => f.endsWith(".json"));
+  const files = fs12.readdirSync(orbitalsDir).filter((f) => f.endsWith(".json"));
   if (files.length === 0) {
     throw new Error("No orbitals found in .orbitals/ directory.");
   }
   return files.map((f) => {
-    const content = fs10.readFileSync(path11.join(orbitalsDir, f), "utf-8");
+    const content = fs12.readFileSync(path13.join(orbitalsDir, f), "utf-8");
     return JSON.parse(content);
   });
 }
@@ -6972,6 +6972,7 @@ function createEvalWorkflowWrapper(options = {}) {
     }
   };
 }
+path__default.join(os.homedir(), ".almadar", "sessions");
 var FirestoreStore = class extends BaseStore {
   constructor(options) {
     super();
@@ -7129,9 +7130,9 @@ var FirestoreStore = class extends BaseStore {
     let query = this.db.collection(this.collection);
     if (op.matchConditions) {
       for (const condition of op.matchConditions) {
-        const path11 = condition.path.filter((p) => p !== "*").join("/");
+        const path13 = condition.path.filter((p) => p !== "*").join("/");
         if (condition.matchType === "prefix") {
-          query = query.where("namespaceKey", ">=", path11).where("namespaceKey", "<", path11 + "\uFFFF");
+          query = query.where("namespaceKey", ">=", path13).where("namespaceKey", "<", path13 + "\uFFFF");
         }
       }
     }
@@ -9173,6 +9174,147 @@ function debounceSync(syncManager, delay = 100) {
     }, delay);
   };
 }
+var DEFAULT_MEMORY_DIR = path__default.join(os.homedir(), ".almadar", "memory");
+var LocalMemoryBackend = class {
+  constructor(options = {}) {
+    this.memoryDir = options.memoryDir ?? DEFAULT_MEMORY_DIR;
+    fs3__default.mkdirSync(this.memoryDir, { recursive: true });
+  }
+  filePath(name) {
+    return path__default.join(this.memoryDir, `${name}.orb`);
+  }
+  readInstances(name) {
+    const fp = this.filePath(name);
+    if (!fs3__default.existsSync(fp)) return [];
+    try {
+      const raw = JSON.parse(fs3__default.readFileSync(fp, "utf-8"));
+      return raw?.orbitals?.[0]?.instances ?? [];
+    } catch {
+      return [];
+    }
+  }
+  writeInstances(name, instances) {
+    const schema = {
+      name: `memory-${name}`,
+      version: "1.0.0",
+      orbitals: [
+        {
+          name,
+          entity: { name, fields: [] },
+          instances
+        }
+      ]
+    };
+    fs3__default.writeFileSync(this.filePath(name), JSON.stringify(schema, null, 2));
+  }
+  // =========================================================================
+  // Error Resolution Memory (ACTIVE)
+  // =========================================================================
+  async recordErrorResolution(resolution) {
+    const instances = this.readInstances("errors");
+    const id = `err_${Date.now()}_${Math.random().toString(36).slice(2, 7)}`;
+    const existing = instances.find(
+      (e) => e.errorSignature === resolution.errorSignature
+    );
+    if (existing) {
+      existing.resolution = resolution.resolution;
+      existing.usageCount++;
+      this.writeInstances("errors", instances);
+      return existing.id;
+    }
+    instances.push({
+      ...resolution,
+      id,
+      createdAt: Date.now(),
+      usageCount: 0
+    });
+    this.writeInstances("errors", instances);
+    return id;
+  }
+  async findErrorResolution(errorSignature) {
+    const instances = this.readInstances("errors");
+    return instances.find((e) => e.errorSignature === errorSignature) ?? null;
+  }
+  async searchErrorResolutions(query) {
+    const instances = this.readInstances("errors");
+    const lower = query.toLowerCase();
+    return instances.filter(
+      (e) => e.errorMessage.toLowerCase().includes(lower) || e.errorSignature.toLowerCase().includes(lower) || e.resolution.toLowerCase().includes(lower)
+    );
+  }
+  async getAllErrorResolutions() {
+    return this.readInstances("errors");
+  }
+  // =========================================================================
+  // User Preferences (STUBBED - returns empty until eval proves value)
+  // =========================================================================
+  async getUserPreferences(_userId) {
+    return null;
+  }
+  async updateUserPreferences(_userId, _preferences) {
+  }
+  // =========================================================================
+  // Generation Session History (STUBBED)
+  // =========================================================================
+  async recordGeneration(_userId, _session) {
+    return `stub_${Date.now()}`;
+  }
+  async getGenerationSession(_sessionId) {
+    return null;
+  }
+  async getUserGenerationHistory(_userId, _limit) {
+    return [];
+  }
+  // =========================================================================
+  // Project Context (STUBBED)
+  // =========================================================================
+  async getProjectContext(_appId) {
+    return null;
+  }
+  async updateProjectContext(_appId, _update) {
+  }
+  // =========================================================================
+  // Pattern Affinity (STUBBED)
+  // =========================================================================
+  async updatePatternAffinity(_userId, _patternId, _outcome, _context) {
+  }
+  async getPatternAffinity(_userId, _patternId) {
+    return null;
+  }
+  async getUserPatterns(_userId) {
+    return [];
+  }
+  // =========================================================================
+  // User Feedback (STUBBED)
+  // =========================================================================
+  async recordFeedback(_sessionId, _feedback) {
+  }
+  // =========================================================================
+  // Interrupt / Tool Approval (STUBBED)
+  // =========================================================================
+  async recordInterruptDecision(_sessionId, _userId, _interruptData) {
+  }
+  async getSessionInterrupts(_sessionId) {
+    return [];
+  }
+  async getToolApprovalPreference(_userId, _toolName) {
+    return null;
+  }
+  async shouldAutoApproveTool(_userId, _toolName) {
+    return false;
+  }
+  // =========================================================================
+  // Checkpoints (STUBBED)
+  // =========================================================================
+  async recordCheckpoint(_userId, _checkpointData) {
+  }
+  async getUserCheckpoints(_userId, _limit) {
+    return [];
+  }
+  async getThreadCheckpoints(_threadId) {
+    return [];
+  }
+};
 var OnlineEvalSampler = class extends EventEmitter {
   constructor(config = {}) {
     super();
@@ -10113,10 +10255,10 @@ var SinkManager = class {
    * Notify all sinks that a file was written.
    * Returns results from each sink — failures in one don't affect others.
    */
-  async notifyFileWritten(path11, content, meta) {
+  async notifyFileWritten(path13, content, meta) {
     if (this.sinks.length === 0) return [];
     const results = await Promise.allSettled(
-      this.sinks.map((sink) => sink.onFileWritten(path11, content, meta))
+      this.sinks.map((sink) => sink.onFileWritten(path13, content, meta))
     );
     return results.map((result, i) => ({
       sinkName: this.sinks[i].name,
@@ -10305,11 +10447,11 @@ var GitSink = class {
   getCwd() {
     return this.client.getCwd();
   }
-  async onFileWritten(path11, _content, meta) {
+  async onFileWritten(path13, _content, meta) {
     if (!this.available) return;
     this.commitQueue = this.commitQueue.then(async () => {
-      const message = formatCommitMessage(path11, meta);
-      await this.client.add([path11]);
+      const message = formatCommitMessage(path13, meta);
+      await this.client.add([path13]);
       await this.client.commit(message);
     });
     await this.commitQueue;
@@ -10351,8 +10493,8 @@ var GitSink = class {
     }
   }
 };
-function formatCommitMessage(path11, meta) {
-  const filename = basename(path11);
+function formatCommitMessage(path13, meta) {
+  const filename = basename(path13);
   switch (meta.fileType) {
     case "orbital":
       return `add(${meta.orbitalName ?? filename}): orbital generated`;
@@ -10802,6 +10944,6 @@ var export_convertDomainToSchema = domain_language_exports.convertDomainToSchema
 var export_convertSchemaToDomain = domain_language_exports.convertSchemaToDomain;
 var export_deleteSection = domain_language_exports.deleteSection;
 
-export { AgenticSearchEngine, AuditLog, CRITICAL_COMMAND_PATTERNS, CircuitBreaker, CircuitState, ContinueRequestSchema, DEFAULT_COMPACTION_CONFIG, EVENT_BUDGETS, ExtractedRequirementsSchema, FirestoreCheckpointer, FirestoreSessionStore, FirestoreSink, FirestoreStore, GenerateRequestSchema, GitClient, GitSink, MemoryManager, MemoryOrbitalSchema, MemorySessionBackend, MetricsCollector, MultiUserManager, ObservabilityCollector, OnlineEvalSampler, PreferenceLearner, RateLimiter, ResumeRequestSchema, SessionManager, SinkManager, StateSyncManager, TOOL_GATES, ThresholdAuthorizer, WORKSPACE_LAYOUT, WorkflowBuilder, WorkflowEngine, WorkspaceManager, analyzeFailures, export_applySectionUpdate as applySectionUpdate, classifyCommand, classifyComplexity, combineOrbitals, combineOrbitalsToSchema, consumeToken, export_convertDomainToSchema as convertDomainToSchema, export_convertSchemaToDomain as convertSchemaToDomain, createAgentTools, createAgenticSearchEngine, createApplyChunkTool, createCombineSchemasTool, createConstructCombinedDomainTool, createDomainOrbitalTools, createErrorFixerSubagent, createEvalWorkflowWrapper, createExecuteTool, createExtractChunkTool, createFinishTaskTool, createGenerateOrbitalDomainTool, createGenerateSchemaTool, createOnlineEvalSampler, createOrbitalSubagentTool, createPreferenceLearner, createProjectOrbTemplate, createQuerySchemaStructureTool, createSSEEvent, createSchemaChunkingTools, createSchemaGenerationWorkflow, createSchemaGeneratorSubagent, createSchemaOrbTemplate, createSkillAgent, createSubagentConfigs, createSubagentEventWrapper, createSubagents, createSummaryPrompt, createTestAnalyzerSubagent, createTraitEventWrapper, createTraitSubagentTool, createUserContext, createUserOrbTemplate, createValidateSchemaTool, createWorkflowEngine, createWorkflowToolWrapper, debounceSync, export_deleteSection as deleteSection, endObservabilitySession, estimateCacheSavings, estimateCombineComplexity, estimateComplexity, estimateTokens, executeSandboxed, extractFileOperation, extractInterruptData, formatSSEEvent, formatSummary, generateFullOrbital, getBudgetWarningMessage, getEventBudget, getExecutionStrategy, getInterruptConfig, getMultiUserManager, getObservabilityCollector, getPerformanceSnapshot, getStateSyncManager, hasInterrupt, isAdmin, isCompleteEvent, isErrorEvent, isExecutionEvent, isFileOperation, isSSECompleteEvent, isSSEErrorEvent, isSSEGenerationLogEvent, isSSEInterruptEvent, isSSEMessageEvent, isSSEStartEvent, isSSESubagentEvent, isSSETodoDetailEvent, isSSETodoUpdateEvent, isSSEToolCallEvent, isSchemaEvent, isStartEvent, isTodoUpdate, isTokenValid, issueToken, needsCompaction, parseDeepAgentEvent, parseOrb, parseSSEEvent, quickComplexityCheck, readOrb, readOrbInstances, recordEvent, requireOwnership, resetMultiUserManager, resetObservabilityCollector, resetStateSyncManager, resumeSkillAgent, reviewSamples, revokeToken, routeGeneration, serializeOrb, startObservabilitySession, transformAgentEvent, transformAgentEventMulti, validateCommandPaths, verifyToken, withSync, writeOrb, writeOrbInstances };
+export { AgenticSearchEngine, AuditLog, CRITICAL_COMMAND_PATTERNS, CircuitBreaker, CircuitState, ContinueRequestSchema, DEFAULT_COMPACTION_CONFIG, EVENT_BUDGETS, ExtractedRequirementsSchema, FirestoreCheckpointer, FirestoreSessionStore, FirestoreSink, FirestoreStore, GenerateRequestSchema, GitClient, GitSink, LocalMemoryBackend, MemoryManager, MemoryOrbitalSchema, MemorySessionBackend, MetricsCollector, MultiUserManager, ObservabilityCollector, OnlineEvalSampler, PreferenceLearner, RateLimiter, ResumeRequestSchema, SessionManager, SinkManager, StateSyncManager, TOOL_GATES, ThresholdAuthorizer, WORKSPACE_LAYOUT, WorkflowBuilder, WorkflowEngine, WorkspaceManager, analyzeFailures, export_applySectionUpdate as applySectionUpdate, classifyCommand, classifyComplexity, combineOrbitals, combineOrbitalsToSchema, consumeToken, export_convertDomainToSchema as convertDomainToSchema, export_convertSchemaToDomain as convertSchemaToDomain, createAgentTools, createAgenticSearchEngine, createApplyChunkTool, createCombineSchemasTool, createConstructCombinedDomainTool, createDomainOrbitalTools, createErrorFixerSubagent, createEvalWorkflowWrapper, createExecuteTool, createExtractChunkTool, createFinishTaskTool, createGenerateOrbitalDomainTool, createGenerateSchemaTool, createOnlineEvalSampler, createOrbitalSubagentTool, createPreferenceLearner, createProjectOrbTemplate, createQuerySchemaStructureTool, createSSEEvent, createSchemaChunkingTools, createSchemaGenerationWorkflow, createSchemaGeneratorSubagent, createSchemaOrbTemplate, createSkillAgent, createSubagentConfigs, createSubagentEventWrapper, createSubagents, createSummaryPrompt, createTestAnalyzerSubagent, createTraitEventWrapper, createTraitSubagentTool, createUserContext, createUserOrbTemplate, createValidateSchemaTool, createWorkflowEngine, createWorkflowToolWrapper, debounceSync, export_deleteSection as deleteSection, endObservabilitySession, estimateCacheSavings, estimateCombineComplexity, estimateComplexity, estimateTokens, executeSandboxed, extractFileOperation, extractInterruptData, formatSSEEvent, formatSummary, generateFullOrbital, getBudgetWarningMessage, getEventBudget, getExecutionStrategy, getInterruptConfig, getMultiUserManager, getObservabilityCollector, getPerformanceSnapshot, getStateSyncManager, hasInterrupt, isAdmin, isCompleteEvent, isErrorEvent, isExecutionEvent, isFileOperation, isSSECompleteEvent, isSSEErrorEvent, isSSEGenerationLogEvent, isSSEInterruptEvent, isSSEMessageEvent, isSSEStartEvent, isSSESubagentEvent, isSSETodoDetailEvent, isSSETodoUpdateEvent, isSSEToolCallEvent, isSchemaEvent, isStartEvent, isTodoUpdate, isTokenValid, issueToken, needsCompaction, parseDeepAgentEvent, parseOrb, parseSSEEvent, quickComplexityCheck, readOrb, readOrbInstances, recordEvent, requireOwnership, resetMultiUserManager, resetObservabilityCollector, resetStateSyncManager, resumeSkillAgent, reviewSamples, revokeToken, routeGeneration, serializeOrb, startObservabilitySession, transformAgentEvent, transformAgentEventMulti, validateCommandPaths, verifyToken, withSync, writeOrb, writeOrbInstances };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map