@almadar/agent 2.0.5 → 3.1.0

package/dist/index.js

@@ -1299,6 +1299,98 @@ var init_orbital_batch_subagent = __esm({
     });
   }
 });
+
+// src/neural/masar-client.ts
+var masar_client_exports = {};
+__export(masar_client_exports, {
+  MasarClient: () => MasarClient
+});
+function toNeuralPipelineResult(data) {
+  return {
+    success: data.success,
+    validationPass: data.validation_pass,
+    compilationPass: false,
+    goalMatch: data.goal_match ?? 0,
+    totalSteps: data.total_steps ?? 0,
+    fixRounds: data.fix_rounds ?? 0,
+    llmCalls: data.llm_calls ?? 0,
+    durationMs: data.duration_ms ?? 0,
+    schema: data.schema ?? null,
+    schemaPath: null,
+    actions: data.actions ?? [],
+    validationErrors: data.validation_errors ?? [],
+    compilationErrors: [],
+    error: data.error ?? null
+  };
+}
+function makeErrorResult(error) {
+  return {
+    success: false,
+    validationPass: false,
+    compilationPass: false,
+    goalMatch: 0,
+    totalSteps: 0,
+    fixRounds: 0,
+    llmCalls: 0,
+    durationMs: 0,
+    schema: null,
+    schemaPath: null,
+    actions: [],
+    validationErrors: [],
+    compilationErrors: [],
+    error
+  };
+}
+var MasarClient;
+var init_masar_client = __esm({
+  "src/neural/masar-client.ts"() {
+    MasarClient = class {
+      constructor(options) {
+        this.baseUrl = (options?.baseUrl ?? process.env["MASAR_URL"] ?? "https://masar-345008351456.europe-west4.run.app").replace(/\/$/, "");
+        this.timeoutMs = options?.timeoutMs ?? 12e4;
+        this.onProgress = options?.onProgress ?? null;
+      }
+      /**
+       * Generate an .orb schema from a natural language prompt.
+       *
+       * Sends the prompt to the Masar server which runs the full neural pipeline
+       * (goal parsing, GFlowNet generation, validation, LLM fix loop) and returns
+       * the result.
+       */
+      async generate(prompt) {
+        this.onProgress?.("request", `Sending prompt to Masar at ${this.baseUrl}`);
+        const url = `${this.baseUrl}/generate`;
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+          const response = await fetch(url, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ prompt }),
+            signal: controller.signal
+          });
+          if (!response.ok) {
+            const body = await response.text().catch(() => "");
+            return makeErrorResult(
+              `Masar server returned ${response.status} ${response.statusText}${body ? `: ${body}` : ""}`
+            );
+          }
+          const data = await response.json();
+          this.onProgress?.("response", data.success ? "Generation succeeded" : `Generation failed: ${data.error ?? "unknown"}`);
+          return toNeuralPipelineResult(data);
+        } catch (err) {
+          if (err instanceof DOMException && err.name === "AbortError") {
+            return makeErrorResult(`Masar request timed out after ${this.timeoutMs}ms`);
+          }
+          const message = err instanceof Error ? err.message : String(err);
+          return makeErrorResult(`Masar request failed: ${message}`);
+        } finally {
+          clearTimeout(timeout);
+        }
+      }
+    };
+  }
+});
 var ExtractedRequirementsSchema = z.object({
   /** Entity names to create */
   entities: z.array(z.string()).optional().default([]),
@@ -9254,16 +9346,31 @@ var LocalMemoryBackend = class {
   async updateUserPreferences(_userId, _preferences) {
   }
   // =========================================================================
-  // Generation Session History (STUBBED)
+  // Generation Session History (ACTIVE)
   // =========================================================================
-  async recordGeneration(_userId, _session) {
-    return `stub_${Date.now()}`;
+  async recordGeneration(_userId, session) {
+    const instances = this.readInstances("sessions");
+    const id = `gen_${Date.now()}_${Math.random().toString(36).slice(2, 7)}`;
+    instances.push({
+      ...session,
+      id,
+      userId: _userId,
+      createdAt: /* @__PURE__ */ new Date()
+    });
+    const trimmed = instances.slice(-50);
+    this.writeInstances("sessions", trimmed);
+    return id;
   }
-  async getGenerationSession(_sessionId) {
-    return null;
+  async getGenerationSession(sessionId) {
+    const instances = this.readInstances("sessions");
+    return instances.find((s) => s.id === sessionId) ?? null;
   }
-  async getUserGenerationHistory(_userId, _limit) {
-    return [];
+  async getUserGenerationHistory(_userId, limit) {
+    const instances = this.readInstances("sessions");
+    const sorted = instances.sort(
+      (a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime()
+    );
+    return limit ? sorted.slice(0, limit) : sorted;
   }
   // =========================================================================
   // Project Context (STUBBED)
@@ -10939,11 +11046,333 @@ async function executeSandboxedFallback(code, inputs, timeoutMs) {
     return { success: false, error: message, timedOut };
   }
 }
+
+// src/neural/index.ts
+init_masar_client();
+
+// src/builder/builder-tools.ts
+function createBuilderTools(config) {
+  const tools = [
+    createValidateBuilderTool(config),
+    createGenerateOrbitalBuilderTool(),
+    createCombineOrbitalsBuilderTool(),
+    createQueryStructureBuilderTool(),
+    createAutoFixBuilderTool(config)
+  ];
+  if (config.pythonExecutor) {
+    tools.push(createNeuralGenerateBuilderTool());
+  }
+  return tools;
+}
+function createValidateBuilderTool(config) {
+  return {
+    name: "validate",
+    description: "Validate an .orb schema. Returns errors and warnings.",
+    parameters: {
+      type: "object",
+      properties: {
+        schema: { type: "string", description: "The .orb schema JSON string to validate" }
+      },
+      required: ["schema"]
+    },
+    async execute(args) {
+      const schema = args.schema;
+      return config.executor.validateSchema(schema);
+    }
+  };
+}
+function createGenerateOrbitalBuilderTool() {
+  return {
+    name: "generate_orbital",
+    description: "Generate a single orbital definition from a spec using an LLM subagent.",
+    parameters: {
+      type: "object",
+      properties: {
+        name: { type: "string", description: "Orbital name" },
+        entityName: { type: "string", description: "Entity name (PascalCase)" },
+        traitNames: { type: "array", description: "List of trait names" },
+        fields: { type: "array", description: "Optional field definitions [{name, type, required?}]" },
+        description: { type: "string", description: "Optional entity description" },
+        provider: { type: "string", description: "LLM provider (deepseek, anthropic, openrouter)" },
+        model: { type: "string", description: "LLM model name" }
+      },
+      required: ["name", "entityName", "traitNames"]
+    },
+    async execute(args) {
+      const { getSubagentSystemPrompt: getSubagentSystemPrompt2 } = await import('@almadar/skills');
+      const { LLMClient: LLMClient8 } = await import('@almadar/llm');
+      const systemPrompt = getSubagentSystemPrompt2();
+      const provider = args.provider ?? "deepseek";
+      const model = args.model ?? "deepseek-chat";
+      const fields = args.fields;
+      const fieldsList = fields?.length ? fields.map((f) => `  - ${f.name}: ${f.type}${f.required ? " (required)" : ""}`).join("\n") : "  (infer appropriate fields from the entity name and description)";
+      const userPrompt = `Generate a complete FullOrbitalUnit for this orbital:
+
+Name: ${args.name}
+Entity: ${args.entityName}
+Traits: ${args.traitNames.join(", ")}
+${args.description ? `Description: ${args.description}` : ""}
+
+Fields:
+${fieldsList}
+
+Return ONLY valid JSON matching the FullOrbitalUnit schema. No markdown fences, no explanation text.`;
+      const client = new LLMClient8({
+        provider,
+        model
+      });
+      const text = await client.callRaw({
+        systemPrompt,
+        userPrompt,
+        maxTokens: 8192
+      });
+      const orbital = extractJson(text);
+      if (!orbital) {
+        return { success: false, error: "Failed to parse orbital JSON from LLM response" };
+      }
+      const obj = orbital;
+      if (!obj.name || !obj.entity || !obj.traits) {
+        return { success: false, error: "Generated orbital missing required fields (name, entity, traits)" };
+      }
+      return { success: true, orbital };
+    }
+  };
+}
+function createCombineOrbitalsBuilderTool() {
+  return {
+    name: "combine_orbitals",
+    description: "Combine multiple orbital definitions into a single .orb schema JSON string.",
+    parameters: {
+      type: "object",
+      properties: {
+        appName: { type: "string", description: "Application name" },
+        orbitals: { type: "array", description: "Array of orbital definition objects" }
+      },
+      required: ["appName", "orbitals"]
+    },
+    async execute(args) {
+      const orbitals = args.orbitals;
+      const appName = args.appName;
+      if (!orbitals.length) {
+        return { success: false, error: "No orbitals provided" };
+      }
+      const schema = {
+        name: appName,
+        version: "1.0.0",
+        orbitals
+      };
+      return {
+        success: true,
+        schema: JSON.stringify(schema, null, 2),
+        orbitalCount: orbitals.length
+      };
+    }
+  };
+}
+function createQueryStructureBuilderTool() {
+  return {
+    name: "query_structure",
+    description: "Get a lightweight map of a schema (orbital names, entities, traits, field counts).",
+    parameters: {
+      type: "object",
+      properties: {
+        schema: { type: "string", description: "The .orb schema JSON string" }
+      },
+      required: ["schema"]
+    },
+    async execute(args) {
+      try {
+        const parsed = JSON.parse(args.schema);
+        const orbitals = parsed.orbitals ?? [];
+        return {
+          name: parsed.name,
+          orbitals: orbitals.map((o) => ({
+            name: o.name,
+            entityName: getEntityName5(o.entity),
+            traits: getTraitNames2(o.traits ?? []),
+            totalFields: countFields(o.entity),
+            totalStates: countStates(o.traits ?? [])
+          }))
+        };
+      } catch (err) {
+        return { error: `Failed to parse schema: ${err instanceof Error ? err.message : String(err)}` };
+      }
+    }
+  };
+}
+function createAutoFixBuilderTool(config) {
+  return {
+    name: "auto_fix",
+    description: "Attempt to fix validation errors in a schema using LLM repair.",
+    parameters: {
+      type: "object",
+      properties: {
+        schema: { type: "string", description: "The .orb schema JSON string with errors" },
+        errors: { type: "array", description: "Validation errors to fix [{code, message}]" },
+        warnings: { type: "array", description: "Validation warnings to fix [{code, message}]" },
+        provider: { type: "string", description: "LLM provider" },
+        model: { type: "string", description: "LLM model" }
+      },
+      required: ["schema", "errors"]
+    },
+    async execute(args) {
+      const { getSubagentSystemPrompt: getSubagentSystemPrompt2 } = await import('@almadar/skills');
+      const { LLMClient: LLMClient8 } = await import('@almadar/llm');
+      const orbitalKnowledge = getSubagentSystemPrompt2();
+      const provider = args.provider ?? "deepseek";
+      const model = args.model ?? "deepseek-chat";
+      const errors = args.errors;
+      const warnings = args.warnings ?? [];
+      const issues = [
+        ...errors.map((e) => `ERROR [${e.code}]: ${e.message}`),
+        ...warnings.map((w) => `WARNING [${w.code}]: ${w.message}`)
+      ].join("\n");
+      const client = new LLMClient8({
+        provider,
+        model
+      });
+      const text = await client.callRaw({
+        systemPrompt: `You are a schema repair tool for .orb orbital schemas.
+
+${orbitalKnowledge}
+
+Return ONLY valid JSON.`,
+        userPrompt: `Fix ALL validation errors and warnings in this schema.
+
+ISSUES:
+${issues}
+
+SCHEMA:
+${args.schema}
+
+Return the COMPLETE corrected schema as valid JSON.`,
+        maxTokens: 8192
+      });
+      const fixed = extractJson(text);
+      if (!fixed) {
+        return { success: false, error: "Failed to parse fixed schema from LLM response" };
+      }
+      const fixedStr = JSON.stringify(fixed, null, 2);
+      const valResult = await config.executor.validateSchema(fixedStr);
+      return {
+        success: valResult.success,
+        schema: fixedStr,
+        remainingErrors: valResult.errors.length,
+        remainingWarnings: valResult.warnings.length
+      };
+    }
+  };
+}
+function createNeuralGenerateBuilderTool(config) {
+  return {
+    name: "neural_generate",
+    description: "Generate a schema using the GFlowNet neural pipeline. Fast (2-10s) but best for simple apps (1-2 entities).",
+    parameters: {
+      type: "object",
+      properties: {
+        prompt: { type: "string", description: "Natural language description of the app to build" },
+        provider: { type: "string", description: "LLM provider for goal parsing and auto-fix" },
+        model: { type: "string", description: "LLM model" },
+        samples: { type: "number", description: "Number of GFlowNet samples (default: 5)" },
+        temperature: { type: "number", description: "Sampling temperature (default: 0.8)" }
+      },
+      required: ["prompt"]
+    },
+    async execute(args) {
+      const { MasarClient: MasarClient2 } = await Promise.resolve().then(() => (init_masar_client(), masar_client_exports));
+      const client = new MasarClient2({
+        timeoutMs: 12e4
+      });
+      const result = await client.generate(args.prompt);
+      return result;
+    }
+  };
+}
+function getEntityName5(entity) {
+  if (!entity) return "Unknown";
+  if (typeof entity === "string") return entity.replace(".entity", "");
+  if (typeof entity === "object" && entity !== null && "name" in entity) {
+    return entity.name;
+  }
+  return "Unknown";
+}
+function getTraitNames2(traits) {
+  const names = [];
+  for (const t of traits) {
+    if (typeof t === "object" && t !== null) {
+      if ("ref" in t) names.push(t.ref);
+      else if ("name" in t) names.push(t.name);
+    }
+  }
+  return names;
+}
+function countFields(entity) {
+  if (!entity || typeof entity !== "object") return 0;
+  const e = entity;
+  return Array.isArray(e.fields) ? e.fields.length : 0;
+}
+function countStates(traits) {
+  let total = 0;
+  for (const t of traits) {
+    if (typeof t === "object" && t !== null && "stateMachine" in t) {
+      const sm = t.stateMachine;
+      if (sm?.states) total += sm.states.length;
+    }
+  }
+  return total;
+}
+function extractJson(text) {
+  try {
+    return JSON.parse(text.trim());
+  } catch {
+  }
+  const fenceMatch = /```(?:json)?\s*\n?([\s\S]*?)\n?```/.exec(text);
+  if (fenceMatch) {
+    try {
+      return JSON.parse(fenceMatch[1].trim());
+    } catch {
+    }
+  }
+  const braceStart = text.indexOf("{");
+  if (braceStart >= 0) {
+    let depth = 0;
+    let inString = false;
+    let escape = false;
+    for (let i = braceStart; i < text.length; i++) {
+      const ch = text[i];
+      if (escape) {
+        escape = false;
+        continue;
+      }
+      if (ch === "\\" && inString) {
+        escape = true;
+        continue;
+      }
+      if (ch === '"') {
+        inString = !inString;
+        continue;
+      }
+      if (inString) continue;
+      if (ch === "{") depth++;
+      if (ch === "}") {
+        depth--;
+        if (depth === 0) {
+          try {
+            return JSON.parse(text.slice(braceStart, i + 1));
+          } catch {
+          }
+          break;
+        }
+      }
+    }
+  }
+  return null;
+}
 var export_applySectionUpdate = domain_language_exports.applySectionUpdate;
 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, 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 };
+export { AgenticSearchEngine, AuditLog, CRITICAL_COMMAND_PATTERNS, CircuitBreaker, CircuitState, ContinueRequestSchema, DEFAULT_COMPACTION_CONFIG, EVENT_BUDGETS, ExtractedRequirementsSchema, FirestoreCheckpointer, FirestoreSessionStore, FirestoreSink, FirestoreStore, GenerateRequestSchema, GitClient, GitSink, LocalMemoryBackend, MasarClient, 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, createBuilderTools, 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