@almadar/agent 3.5.11 → 3.5.12

package/dist/evals/online-sampling.d.ts

@@ -110,5 +110,19 @@ export interface ReviewOptions {
     minScore?: number;
     format?: 'json' | 'table';
 }
+/**
+ * Review collected online evaluation samples.
+ *
+ * Displays a table or JSON summary of sampled evaluations for a given date,
+ * including scores, latency, provider, and success status.
+ *
+ * @param {OnlineEvalSampler} sampler - The sampler instance to pull samples from
+ * @param {ReviewOptions} [options] - Options for filtering and formatting output
+ * @param {string} [options.date] - Date to review (YYYY-MM-DD format, defaults to today)
+ * @param {number} [options.limit] - Maximum number of samples to show (default: 20)
+ * @param {number} [options.minScore] - Minimum score filter
+ * @param {string} [options.format] - Output format: 'json' or 'table' (default: table)
+ * @returns {Promise<void>}
+ */
 export declare function reviewSamples(sampler: OnlineEvalSampler, options?: ReviewOptions): Promise<void>;
 export declare function createOnlineEvalSampler(config?: Partial<SamplingConfig>): OnlineEvalSampler;

package/dist/gates/behavior-gates/behavior-orchestrator.d.ts

@@ -10,6 +10,17 @@
  */
 import type { LLMClient } from '@almadar/llm';
 import type { BehaviorPipelineConfig, BehaviorPipelineResult } from './types.js';
+/**
+ * Execute the complete Behavior Pipeline.
+ *
+ * Chains all behavior gates: BG0-A (decompose, 1 LLM call) -> BG0-B (match, 1 LLM call)
+ * -> BG1 -> BG2 -> BG3 (all deterministic). Total: 2 LLM calls for any app size.
+ *
+ * @param {LLMClient} client - The LLM client to use for generation
+ * @param {string} prompt - The user's natural language request
+ * @param {BehaviorPipelineConfig} [config] - Optional pipeline configuration
+ * @returns {Promise<BehaviorPipelineResult>} The complete pipeline result with schema
+ */
 export declare function runBehaviorPipeline(client: LLMClient, prompt: string, config?: BehaviorPipelineConfig): Promise<BehaviorPipelineResult>;
 /** Create the default Mistral Small client for behavior pipeline */
 export declare function createBehaviorClient(): LLMClient;

package/dist/gates/behavior-gates/bg0-behavior-selection.d.ts

@@ -8,4 +8,16 @@
  */
 import type { LLMClient } from '@almadar/llm';
 import type { BehaviorPlan, BehaviorPipelineConfig } from './types.js';
+/**
+ * Execute BG0: Behavior Selection.
+ *
+ * Selects behaviors from the standard library based on a natural language
+ * prompt and produces a BehaviorPlan. This is the first step in the
+ * behavior-based generation pipeline.
+ *
+ * @param {LLMClient} client - The LLM client to use for selection
+ * @param {string} prompt - The user's natural language request
+ * @param {BehaviorPipelineConfig} [_config] - Optional pipeline configuration
+ * @returns {Promise<BehaviorPlan>} The selected behavior plan
+ */
 export declare function runBG0(client: LLMClient, prompt: string, _config?: BehaviorPipelineConfig): Promise<BehaviorPlan>;

package/dist/gates/behavior-gates/bg0b-match.d.ts

@@ -12,4 +12,18 @@
 import type { LLMClient } from '@almadar/llm';
 import type { BehaviorPlan, BehaviorPipelineConfig } from './types.js';
 import type { DecomposeResult } from './bg0a-decompose.js';
+/**
+ * Execute BG0-B: Per-Orbital Behavior Matching.
+ *
+ * Second LLM call in the behavior pipeline. For each orbital description
+ * from BG0-A, selects the best behavior from the catalog.
+ *
+ * Uses a single batched LLM call for all orbitals to keep total LLM calls at 2.
+ *
+ * @param {LLMClient} client - The LLM client to use for matching
+ * @param {DecomposeResult} decomposed - The decomposed result from BG0-A
+ * @param {string} originalPrompt - The original user request for context
+ * @param {BehaviorPipelineConfig} [_config] - Optional pipeline configuration
+ * @returns {Promise<BehaviorPlan>} The matched behavior plan
+ */
 export declare function runBG0B(client: LLMClient, decomposed: DecomposeResult, originalPrompt: string, _config?: BehaviorPipelineConfig): Promise<BehaviorPlan>;

package/dist/gates/behavior-gates/bg2-wiring.d.ts

@@ -8,4 +8,14 @@
  */
 import type { OrbitalDefinition } from '@almadar/core/types';
 import type { BehaviorPlan } from './types.js';
+/**
+ * Execute BG2: Event Wiring.
+ *
+ * Zero LLM calls. Applies cross-orbital event wiring from the BehaviorPlan's
+ * suggestedWiring entries to connect orbitals via events.
+ *
+ * @param {OrbitalDefinition[]} orbitals - The orbitals to wire together
+ * @param {BehaviorPlan} plan - The behavior plan containing wiring suggestions
+ * @returns {Promise<OrbitalDefinition[]>} The wired orbitals
+ */
 export declare function runBG2(orbitals: OrbitalDefinition[], plan: BehaviorPlan): Promise<OrbitalDefinition[]>;

package/dist/gates/behavior-gates/bg3-composition.d.ts

@@ -9,4 +9,14 @@
 import type { ComposeBehaviorsResult } from '@almadar/core/builders';
 import type { OrbitalDefinition } from '@almadar/core/types';
 import type { BehaviorPlan } from './types.js';
+/**
+ * Execute BG3: Application Composition.
+ *
+ * Zero LLM calls. Uses composeBehaviors from @almadar/core to produce
+ * a complete OrbitalSchema with pages and layout.
+ *
+ * @param {OrbitalDefinition[]} orbitals - The wired orbitals to compose
+ * @param {BehaviorPlan} plan - The behavior plan containing composition settings
+ * @returns {Promise<ComposeBehaviorsResult>} The composed application schema
+ */
 export declare function runBG3(orbitals: OrbitalDefinition[], plan: BehaviorPlan): Promise<ComposeBehaviorsResult>;

package/dist/gates/gate0-application.d.ts

@@ -10,4 +10,17 @@
 import type { LLMClient } from '@almadar/llm';
 import type { OrbitalSchema } from '@almadar/core/types';
 import type { GateOpts, BehaviorGateData } from './types.js';
+/**
+ * Execute Gate 0: Application Decomposition.
+ *
+ * Decomposes a natural language prompt into an initial orbital schema
+ * with entities, traits, and pages. This is the first gate in the
+ * multi-gate generation pipeline.
+ *
+ * @param {LLMClient} client - The LLM client to use for generation
+ * @param {string} prompt - The user's natural language request
+ * @param {GateOpts} [opts] - Optional configuration for the gate
+ * @param {BehaviorGateData} [behaviorData] - Optional guidance from behavior analysis
+ * @returns {Promise<OrbitalSchema>} The decomposed orbital schema
+ */
 export declare function runGate0(client: LLMClient, prompt: string, opts?: GateOpts, behaviorData?: BehaviorGateData): Promise<OrbitalSchema>;