@almadar/agent 3.2.0 → 3.5.1

package/dist/gates/types.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Gated Construction Types
+ *
+ * Uses @almadar/core types directly. Each gate accepts an OrbitalSchema
+ * and returns an enriched OrbitalSchema (except Gate 0 which creates from prompt).
+ *
+ * @packageDocumentation
+ */
+import type { OrbitalSchema } from '@almadar/core/types';
+/** Providers available for gated construction. Both route through OpenRouter. */
+export type GateProvider = 'deepseek' | 'zhipu';
+/** Whether the behavior source is injected into the user prompt. */
+export type GateMode = 'guided' | 'pure';
+/** Options passed to individual gate functions. */
+export interface GateOpts {
+    /** Max tokens per gate call. Default 4096. */
+    maxTokens?: number;
+    /** Golden .orb schema for guided mode. */
+    goldenOrb?: OrbitalSchema;
+    /** Whether to validate after this gate. */
+    validateAfterGate?: boolean;
+    /** Working directory for orbital validate temp files. */
+    workDir?: string;
+}
+export interface GatePipelineConfig {
+    provider: GateProvider;
+    mode: GateMode;
+    /** Override model for this run (otherwise uses provider default). */
+    model?: string;
+    /** Max tokens per gate call. Default 4096. */
+    maxTokens?: number;
+    /** Temperature. Default 0.3. */
+    temperature?: number;
+    /** Working directory for orbital validate temp files. */
+    workDir: string;
+    /** Validate after each gate (failures logged but don't abort). */
+    validateAfterEachGate?: boolean;
+    /** Run orbital-verify on the final .orb (compile + server + browser). */
+    verify?: boolean;
+    /** Show browser during verification. */
+    verifyHeaded?: boolean;
+    /** Capture screenshots during verification. */
+    verifyScreenshots?: boolean;
+}
+export interface GateTimings {
+    gate0Ms: number;
+    gate1Ms: number[];
+    gate2Ms: number[];
+    gate3Ms: number[];
+    gate4Ms: number[];
+    totalMs: number;
+}
+export interface VerifyResult {
+    totalPassed: number;
+    totalFailed: number;
+    totalChecks: number;
+    coverage?: {
+        ratio: number;
+        coveredItems: number;
+        totalItems: number;
+    };
+    phases: Array<{
+        phase: number;
+        name: string;
+        passed: number;
+        failed: number;
+        checks: Array<{
+            label: string;
+            passed: boolean;
+            detail?: string;
+        }>;
+    }>;
+}
+export interface GatePipelineResult {
+    config: GatePipelineConfig;
+    orbAfterGate0: OrbitalSchema;
+    orbAfterGate1: OrbitalSchema;
+    orbAfterGate2: OrbitalSchema;
+    orbAfterGate3: OrbitalSchema;
+    orbFinal: OrbitalSchema;
+    validation: {
+        valid: boolean;
+        errors: Array<{
+            code: string;
+            path: string;
+            message: string;
+        }>;
+    };
+    verify?: VerifyResult;
+    timings: GateTimings;
+}
+export interface GateScore {
+    gate: number;
+    score: number;
+    details: Record<string, number>;
+}
+export interface PipelineScore {
+    overall: number;
+    gates: GateScore[];
+    provider: GateProvider;
+    mode: GateMode;
+    behaviorName: string;
+}
+export interface BehaviorGateData {
+    /** Gate 0 level: orbital count, entity names, trait names. */
+    appLevel: {
+        orbitalCount: number;
+        entityNames: string[];
+        traitNames: string[];
+    };
+    /** Gate 1 level per orbital. */
+    orbitalLevels: Array<{
+        orbitalName: string;
+        entity: Record<string, unknown>;
+        traitNames: string[];
+        pages: Record<string, unknown>[];
+    }>;
+    /** Gate 2 level per trait. */
+    traitLevels: Array<{
+        traitName: string;
+        states: string[];
+        events: string[];
+        transitionEdges: Array<{
+            from: string;
+            event: string;
+            to: string;
+        }>;
+    }>;
+    /** Gate 3 level per transition. */
+    transitionLevels: Array<{
+        from: string;
+        event: string;
+        to: string;
+        guard: unknown[] | null;
+        nonRenderEffects: unknown[];
+    }>;
+    /** Gate 4 level per transition with render-ui. */
+    renderUiLevels: Array<{
+        from: string;
+        event: string;
+        to: string;
+        renderEffects: Array<{
+            slot: string;
+            tree: Record<string, unknown>;
+        }>;
+    }>;
+}

package/dist/index.js

@@ -6802,7 +6802,7 @@ IMPORTANT:
   if (githubTools && verbose) {
     console.log(`[SkillAgent] GitHub tools enabled`);
   }
-  let tools = [
+  let tools = options.extraToolsOnly ? [...options.extraTools || [], finishTaskTool] : [
     executeTool,
     finishTaskTool,
     validateSchemaTool,
@@ -6820,7 +6820,9 @@ IMPORTANT:
     ...githubTools || [],
     // Add orchestrated tools when enabled
     ...orchestratedGenerationTool ? [orchestratedGenerationTool] : [],
-    ...orchestratedFixingTool ? [orchestratedFixingTool] : []
+    ...orchestratedFixingTool ? [orchestratedFixingTool] : [],
+    // Add extra tools if provided
+    ...options.extraTools || []
   ];
   if (options.toolWrapper) {
     tools = tools.map(options.toolWrapper);