@almadar/agent 2.0.5 → 3.2.0

package/dist/builder/builder-tools.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Builder Tools
+ *
+ * Creates the safe subset of agent tools for web/builder use.
+ * No filesystem, git, design-system, or deploy tools.
+ *
+ * Included:
+ * - validate: Validate a schema string
+ * - generate_orbital: Generate a single orbital via LLM subagent
+ * - combine_orbitals: Deterministic merge of orbitals into schema
+ * - query_structure: Introspect a schema's orbital/entity/trait layout
+ * - neural_generate: Run GFlowNet pipeline (if PythonExecutor provided)
+ * - auto_fix: LLM-based validation error repair
+ *
+ * Excluded:
+ * - compile, verify, lint, scaffold, git, filesystem,
+ *   design-system, deploy, screenshot, console
+ */
+import type { BuilderConfig, BuilderToolDefinition } from './types.js';
+/**
+ * Create the builder-mode tool set.
+ *
+ * @param config - Builder configuration with injectable executors
+ * @returns Array of tool definitions ready for use with createSkillAgent
+ */
+export declare function createBuilderTools(config: BuilderConfig): BuilderToolDefinition[];

package/dist/builder/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Builder Module
+ *
+ * Convenience exports for builder-mode consumers (server, web).
+ * Pre-configured for schema generation without workspace/git/filesystem.
+ *
+ * @packageDocumentation
+ */
+export { createBuilderTools } from './builder-tools.js';
+export type { BuilderConfig, BuilderToolDefinition, CommandExecutor, PythonExecutor } from './types.js';

package/dist/builder/index.js

@@ -0,0 +1,424 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// 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);
+        }
+      }
+    };
+  }
+});
+
+// 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 } = await import('@almadar/skills');
+      const { LLMClient } = await import('@almadar/llm');
+      const systemPrompt = getSubagentSystemPrompt();
+      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 LLMClient({
+        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: getEntityName(o.entity),
+            traits: getTraitNames(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 } = await import('@almadar/skills');
+      const { LLMClient } = await import('@almadar/llm');
+      const orbitalKnowledge = getSubagentSystemPrompt();
+      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 LLMClient({
+        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 getEntityName(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 getTraitNames(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;
+}
+
+export { createBuilderTools };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/builder/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/neural/masar-client.ts","../../src/builder/builder-tools.ts"],"names":["MasarClient"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Masar HTTP Client\n *\n * Calls the Masar server's /generate endpoint via HTTP instead of\n * orchestrating the neural pipeline (GFlowNet + LLM fix loop) directly.\n *\n * The Masar server runs the full pipeline server-side and returns\n * a NeuralPipelineResult-compatible response.\n */\n\nimport type { NeuralPipelineResult } from './types.js';\n\n/** Response shape returned by the Masar /generate endpoint (snake_case from Python). */\ninterface MasarGenerateResponse {\n  success: boolean;\n  schema: string | null;\n  validation_pass: boolean;\n  goal_match: number;\n  total_steps: number;\n  fix_rounds: number;\n  llm_calls: number;\n  duration_ms: number;\n  actions: string[];\n  validation_errors: string[];\n  error: string | null;\n}\n\n/** Options for constructing a MasarClient. */\nexport interface MasarClientOptions {\n  /** Base URL of the Masar server. Defaults to MASAR_URL env var or http://localhost:8080 */\n  baseUrl?: string;\n  /** Request timeout in milliseconds. Defaults to 120000 (2 minutes). */\n  timeoutMs?: number;\n  /** Optional callback for progress updates. */\n  onProgress?: (phase: string, detail: string) => void;\n}\n\n/**\n * HTTP client for the Masar schema generation server.\n *\n * Usage:\n * ```ts\n * const client = new MasarClient();\n * const result = await client.generate('Build a todo app with projects and tasks');\n * ```\n */\nexport class MasarClient {\n  private readonly baseUrl: string;\n  private readonly timeoutMs: number;\n  private readonly onProgress: ((phase: string, detail: string) => void) | null;\n\n  constructor(options?: MasarClientOptions) {\n    this.baseUrl = (options?.baseUrl ?? process.env['MASAR_URL'] ?? 'https://masar-345008351456.europe-west4.run.app').replace(/\\/$/, '');\n    this.timeoutMs = options?.timeoutMs ?? 120_000;\n    this.onProgress = options?.onProgress ?? null;\n  }\n\n  /**\n   * Generate an .orb schema from a natural language prompt.\n   *\n   * Sends the prompt to the Masar server which runs the full neural pipeline\n   * (goal parsing, GFlowNet generation, validation, LLM fix loop) and returns\n   * the result.\n   */\n  async generate(prompt: string): Promise<NeuralPipelineResult> {\n    this.onProgress?.('request', `Sending prompt to Masar at ${this.baseUrl}`);\n\n    const url = `${this.baseUrl}/generate`;\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);\n\n    try {\n      const response = await fetch(url, {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({ prompt }),\n        signal: controller.signal,\n      });\n\n      if (!response.ok) {\n        const body = await response.text().catch(() => '');\n        return makeErrorResult(\n          `Masar server returned ${response.status} ${response.statusText}${body ? `: ${body}` : ''}`,\n        );\n      }\n\n      const data: MasarGenerateResponse = await response.json() as MasarGenerateResponse;\n      this.onProgress?.('response', data.success ? 'Generation succeeded' : `Generation failed: ${data.error ?? 'unknown'}`);\n\n      return toNeuralPipelineResult(data);\n    } catch (err: unknown) {\n      if (err instanceof DOMException && err.name === 'AbortError') {\n        return makeErrorResult(`Masar request timed out after ${this.timeoutMs}ms`);\n      }\n      const message = err instanceof Error ? err.message : String(err);\n      return makeErrorResult(`Masar request failed: ${message}`);\n    } finally {\n      clearTimeout(timeout);\n    }\n  }\n}\n\n/**\n * Map the Masar server response to a NeuralPipelineResult.\n * Provides defaults for any missing fields so the result always satisfies the full interface.\n */\nfunction toNeuralPipelineResult(data: MasarGenerateResponse): NeuralPipelineResult {\n  return {\n    success: data.success,\n    validationPass: data.validation_pass,\n    compilationPass: false,\n    goalMatch: data.goal_match ?? 0,\n    totalSteps: data.total_steps ?? 0,\n    fixRounds: data.fix_rounds ?? 0,\n    llmCalls: data.llm_calls ?? 0,\n    durationMs: data.duration_ms ?? 0,\n    schema: data.schema ?? null,\n    schemaPath: null,\n    actions: data.actions ?? [],\n    validationErrors: data.validation_errors ?? [],\n    compilationErrors: [],\n    error: data.error ?? null,\n  };\n}\n\nfunction makeErrorResult(error: string): NeuralPipelineResult {\n  return {\n    success: false,\n    validationPass: false,\n    compilationPass: false,\n    goalMatch: 0,\n    totalSteps: 0,\n    fixRounds: 0,\n    llmCalls: 0,\n    durationMs: 0,\n    schema: null,\n    schemaPath: null,\n    actions: [],\n    validationErrors: [],\n    compilationErrors: [],\n    error,\n  };\n}\n","/**\n * Builder Tools\n *\n * Creates the safe subset of agent tools for web/builder use.\n * No filesystem, git, design-system, or deploy tools.\n *\n * Included:\n * - validate: Validate a schema string\n * - generate_orbital: Generate a single orbital via LLM subagent\n * - combine_orbitals: Deterministic merge of orbitals into schema\n * - query_structure: Introspect a schema's orbital/entity/trait layout\n * - neural_generate: Run GFlowNet pipeline (if PythonExecutor provided)\n * - auto_fix: LLM-based validation error repair\n *\n * Excluded:\n * - compile, verify, lint, scaffold, git, filesystem,\n *   design-system, deploy, screenshot, console\n */\n\nimport type { BuilderConfig, BuilderToolDefinition } from './types.js';\nimport type { ValidationResult } from '../neural/types.js';\n\n/**\n * Create the builder-mode tool set.\n *\n * @param config - Builder configuration with injectable executors\n * @returns Array of tool definitions ready for use with createSkillAgent\n */\nexport function createBuilderTools(config: BuilderConfig): BuilderToolDefinition[] {\n  const tools: BuilderToolDefinition[] = [\n    createValidateBuilderTool(config),\n    createGenerateOrbitalBuilderTool(),\n    createCombineOrbitalsBuilderTool(),\n    createQueryStructureBuilderTool(),\n    createAutoFixBuilderTool(config),\n  ];\n\n  if (config.pythonExecutor) {\n    tools.push(createNeuralGenerateBuilderTool(config));\n  }\n\n  return tools;\n}\n\n// ============================================================================\n// Tool Implementations\n// ============================================================================\n\nfunction createValidateBuilderTool(config: BuilderConfig): BuilderToolDefinition {\n  return {\n    name: 'validate',\n    description: 'Validate an .orb schema. Returns errors and warnings.',\n    parameters: {\n      type: 'object',\n      properties: {\n        schema: { type: 'string', description: 'The .orb schema JSON string to validate' },\n      },\n      required: ['schema'],\n    },\n    async execute(args) {\n      const schema = args.schema as string;\n      return config.executor.validateSchema(schema);\n    },\n  };\n}\n\nfunction createGenerateOrbitalBuilderTool(): BuilderToolDefinition {\n  return {\n    name: 'generate_orbital',\n    description: 'Generate a single orbital definition from a spec using an LLM subagent.',\n    parameters: {\n      type: 'object',\n      properties: {\n        name: { type: 'string', description: 'Orbital name' },\n        entityName: { type: 'string', description: 'Entity name (PascalCase)' },\n        traitNames: { type: 'array', description: 'List of trait names' },\n        fields: { type: 'array', description: 'Optional field definitions [{name, type, required?}]' },\n        description: { type: 'string', description: 'Optional entity description' },\n        provider: { type: 'string', description: 'LLM provider (deepseek, anthropic, openrouter)' },\n        model: { type: 'string', description: 'LLM model name' },\n      },\n      required: ['name', 'entityName', 'traitNames'],\n    },\n    async execute(args) {\n      const { getSubagentSystemPrompt } = await import('@almadar/skills');\n      const { LLMClient } = await import('@almadar/llm');\n\n      const systemPrompt = getSubagentSystemPrompt();\n      const provider = (args.provider as string) ?? 'deepseek';\n      const model = (args.model as string) ?? 'deepseek-chat';\n\n      const fields = args.fields as Array<{ name: string; type: string; required?: boolean }> | undefined;\n      const fieldsList = fields?.length\n        ? fields.map((f) => `  - ${f.name}: ${f.type}${f.required ? ' (required)' : ''}`).join('\\n')\n        : '  (infer appropriate fields from the entity name and description)';\n\n      const userPrompt = `Generate a complete FullOrbitalUnit for this orbital:\n\nName: ${args.name}\nEntity: ${args.entityName}\nTraits: ${(args.traitNames as string[]).join(', ')}\n${args.description ? `Description: ${args.description}` : ''}\n\nFields:\n${fieldsList}\n\nReturn ONLY valid JSON matching the FullOrbitalUnit schema. No markdown fences, no explanation text.`;\n\n      const client = new LLMClient({\n        provider: provider as 'anthropic' | 'deepseek' | 'openrouter',\n        model,\n      });\n\n      const text = await client.callRaw({\n        systemPrompt,\n        userPrompt,\n        maxTokens: 8192,\n      });\n\n      const orbital = extractJson(text);\n      if (!orbital) {\n        return { success: false, error: 'Failed to parse orbital JSON from LLM response' };\n      }\n\n      const obj = orbital as Record<string, unknown>;\n      if (!obj.name || !obj.entity || !obj.traits) {\n        return { success: false, error: 'Generated orbital missing required fields (name, entity, traits)' };\n      }\n\n      return { success: true, orbital };\n    },\n  };\n}\n\nfunction createCombineOrbitalsBuilderTool(): BuilderToolDefinition {\n  return {\n    name: 'combine_orbitals',\n    description: 'Combine multiple orbital definitions into a single .orb schema JSON string.',\n    parameters: {\n      type: 'object',\n      properties: {\n        appName: { type: 'string', description: 'Application name' },\n        orbitals: { type: 'array', description: 'Array of orbital definition objects' },\n      },\n      required: ['appName', 'orbitals'],\n    },\n    async execute(args) {\n      const orbitals = args.orbitals as unknown[];\n      const appName = args.appName as string;\n\n      if (!orbitals.length) {\n        return { success: false, error: 'No orbitals provided' };\n      }\n\n      const schema = {\n        name: appName,\n        version: '1.0.0',\n        orbitals,\n      };\n\n      return {\n        success: true,\n        schema: JSON.stringify(schema, null, 2),\n        orbitalCount: orbitals.length,\n      };\n    },\n  };\n}\n\nfunction createQueryStructureBuilderTool(): BuilderToolDefinition {\n  return {\n    name: 'query_structure',\n    description: 'Get a lightweight map of a schema (orbital names, entities, traits, field counts).',\n    parameters: {\n      type: 'object',\n      properties: {\n        schema: { type: 'string', description: 'The .orb schema JSON string' },\n      },\n      required: ['schema'],\n    },\n    async execute(args) {\n      try {\n        const parsed = JSON.parse(args.schema as string);\n        const orbitals = (parsed.orbitals ?? []) as Array<Record<string, unknown>>;\n\n        return {\n          name: parsed.name,\n          orbitals: orbitals.map((o) => ({\n            name: o.name,\n            entityName: getEntityName(o.entity),\n            traits: getTraitNames(o.traits as unknown[] ?? []),\n            totalFields: countFields(o.entity),\n            totalStates: countStates(o.traits as unknown[] ?? []),\n          })),\n        };\n      } catch (err) {\n        return { error: `Failed to parse schema: ${err instanceof Error ? err.message : String(err)}` };\n      }\n    },\n  };\n}\n\nfunction createAutoFixBuilderTool(config: BuilderConfig): BuilderToolDefinition {\n  return {\n    name: 'auto_fix',\n    description: 'Attempt to fix validation errors in a schema using LLM repair.',\n    parameters: {\n      type: 'object',\n      properties: {\n        schema: { type: 'string', description: 'The .orb schema JSON string with errors' },\n        errors: { type: 'array', description: 'Validation errors to fix [{code, message}]' },\n        warnings: { type: 'array', description: 'Validation warnings to fix [{code, message}]' },\n        provider: { type: 'string', description: 'LLM provider' },\n        model: { type: 'string', description: 'LLM model' },\n      },\n      required: ['schema', 'errors'],\n    },\n    async execute(args) {\n      const { getSubagentSystemPrompt } = await import('@almadar/skills');\n      const { LLMClient } = await import('@almadar/llm');\n\n      const orbitalKnowledge = getSubagentSystemPrompt();\n      const provider = (args.provider as string) ?? 'deepseek';\n      const model = (args.model as string) ?? 'deepseek-chat';\n\n      const errors = args.errors as Array<{ code: string; message: string }>;\n      const warnings = (args.warnings as Array<{ code: string; message: string }>) ?? [];\n\n      const issues = [\n        ...errors.map((e) => `ERROR [${e.code}]: ${e.message}`),\n        ...warnings.map((w) => `WARNING [${w.code}]: ${w.message}`),\n      ].join('\\n');\n\n      const client = new LLMClient({\n        provider: provider as 'anthropic' | 'deepseek' | 'openrouter',\n        model,\n      });\n\n      const text = await client.callRaw({\n        systemPrompt: `You are a schema repair tool for .orb orbital schemas.\\n\\n${orbitalKnowledge}\\n\\nReturn ONLY valid JSON.`,\n        userPrompt: `Fix ALL validation errors and warnings in this schema.\\n\\nISSUES:\\n${issues}\\n\\nSCHEMA:\\n${args.schema}\\n\\nReturn the COMPLETE corrected schema as valid JSON.`,\n        maxTokens: 8192,\n      });\n\n      const fixed = extractJson(text);\n      if (!fixed) {\n        return { success: false, error: 'Failed to parse fixed schema from LLM response' };\n      }\n\n      // Validate the fix\n      const fixedStr = JSON.stringify(fixed, null, 2);\n      const valResult = await config.executor.validateSchema(fixedStr);\n\n      return {\n        success: valResult.success,\n        schema: fixedStr,\n        remainingErrors: valResult.errors.length,\n        remainingWarnings: valResult.warnings.length,\n      };\n    },\n  };\n}\n\nfunction createNeuralGenerateBuilderTool(config: BuilderConfig): BuilderToolDefinition {\n  return {\n    name: 'neural_generate',\n    description: 'Generate a schema using the GFlowNet neural pipeline. Fast (2-10s) but best for simple apps (1-2 entities).',\n    parameters: {\n      type: 'object',\n      properties: {\n        prompt: { type: 'string', description: 'Natural language description of the app to build' },\n        provider: { type: 'string', description: 'LLM provider for goal parsing and auto-fix' },\n        model: { type: 'string', description: 'LLM model' },\n        samples: { type: 'number', description: 'Number of GFlowNet samples (default: 5)' },\n        temperature: { type: 'number', description: 'Sampling temperature (default: 0.8)' },\n      },\n      required: ['prompt'],\n    },\n    async execute(args) {\n      const { MasarClient } = await import('../neural/masar-client.js');\n\n      const client = new MasarClient({\n        timeoutMs: 120_000,\n      });\n\n      const result = await client.generate(args.prompt as string);\n      return result;\n    },\n  };\n}\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\nfunction getEntityName(entity: unknown): string {\n  if (!entity) return 'Unknown';\n  if (typeof entity === 'string') return entity.replace('.entity', '');\n  if (typeof entity === 'object' && entity !== null && 'name' in entity) {\n    return (entity as { name: string }).name;\n  }\n  return 'Unknown';\n}\n\nfunction getTraitNames(traits: unknown[]): string[] {\n  const names: string[] = [];\n  for (const t of traits) {\n    if (typeof t === 'object' && t !== null) {\n      if ('ref' in t) names.push((t as { ref: string }).ref);\n      else if ('name' in t) names.push((t as { name: string }).name);\n    }\n  }\n  return names;\n}\n\nfunction countFields(entity: unknown): number {\n  if (!entity || typeof entity !== 'object') return 0;\n  const e = entity as { fields?: unknown[] };\n  return Array.isArray(e.fields) ? e.fields.length : 0;\n}\n\nfunction countStates(traits: unknown[]): number {\n  let total = 0;\n  for (const t of traits) {\n    if (typeof t === 'object' && t !== null && 'stateMachine' in t) {\n      const sm = (t as { stateMachine?: { states?: unknown[] } }).stateMachine;\n      if (sm?.states) total += sm.states.length;\n    }\n  }\n  return total;\n}\n\nfunction extractJson(text: string): unknown | null {\n  try {\n    return JSON.parse(text.trim());\n  } catch {\n    // noop\n  }\n\n  const fenceMatch = /```(?:json)?\\s*\\n?([\\s\\S]*?)\\n?```/.exec(text);\n  if (fenceMatch) {\n    try {\n      return JSON.parse(fenceMatch[1].trim());\n    } catch {\n      // noop\n    }\n  }\n\n  const braceStart = text.indexOf('{');\n  if (braceStart >= 0) {\n    let depth = 0;\n    let inString = false;\n    let escape = false;\n    for (let i = braceStart; i < text.length; i++) {\n      const ch = text[i];\n      if (escape) { escape = false; continue; }\n      if (ch === '\\\\' && inString) { escape = true; continue; }\n      if (ch === '\"') { inString = !inString; continue; }\n      if (inString) continue;\n      if (ch === '{') depth++;\n      if (ch === '}') {\n        depth--;\n        if (depth === 0) {\n          try { return JSON.parse(text.slice(braceStart, i + 1)); } catch { /* noop */ }\n          break;\n        }\n      }\n    }\n  }\n\n  return null;\n}\n"]}

package/dist/builder/types.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Builder Module Types
+ *
+ * Types for the builder-mode subset of the agent framework.
+ * Builder mode provides schema generation without workspace/git/filesystem.
+ */
+import type { CommandExecutor, PythonExecutor } from '../neural/types.js';
+export type { CommandExecutor, PythonExecutor };
+export interface BuilderConfig {
+    /** How to run `orbital validate` */
+    executor: CommandExecutor;
+    /** How to run GFlowNet inference (optional, enables neural mode) */
+    pythonExecutor?: PythonExecutor;
+}
+export interface BuilderToolDefinition {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    execute: (args: Record<string, unknown>) => Promise<unknown>;
+}

package/dist/index.d.ts

@@ -58,3 +58,7 @@ export type { SandboxOptions, SandboxResult } from './tools/sandbox-executor.js'
 export { classifyCommand, TOOL_GATES, CRITICAL_COMMAND_PATTERNS } from './agent/interrupt-config.js';
 export type { ActionGate } from './agent/interrupt-config.js';
 export type { SessionActions, SessionServiceContract, MemoryActions, MemoryServiceContract, AgentActions, AgentServiceContract, AgentServiceContracts, } from './contracts.js';
+export { MasarClient } from './neural/index.js';
+export type { GoalSpec, NeuralGenerateResult, NeuralPipelineResult, NeuralPipelineOptions, MasarClientOptions, CommandExecutor, PythonExecutor, InferOptions, InferResult, } from './neural/index.js';
+export { createBuilderTools } from './builder/index.js';
+export type { BuilderConfig, BuilderToolDefinition } from './builder/index.js';