lua-cli 3.5.0-alpha.4 → 3.5.0-alpha.6

package/dist/compiler/utils/ast-helpers.js

@@ -1,13 +1,124 @@
 /**
- * AST helper functions for extracting values from ts-morph nodes.
+ * AST helper functions for extracting and evaluating values from ts-morph nodes.
  *
- * These utilities make it easy to extract typed values from
- * object literal expressions in TypeScript source code.
+ * Organized into sections:
+ * 1. EVALUATION ENGINE    — ts-evaluator core with lua-cli passthrough shims
+ * 2. NODE EVALUATION      — resolve a raw AST Node to a typed runtime value
+ * 3. PROPERTY EXTRACTION  — get typed values from ObjectLiteralExpression properties
+ * 4. NODE INSPECTION      — type checks and utilities for AST nodes
+ * 5. IDENTIFIER RESOLUTION — follow variable/import reference chains to declarations
+ * 6. IMPORT RESOLUTION    — locate source files for imported identifiers
  */
-import { Node, SyntaxKind } from 'ts-morph';
+import { Node } from 'ts-morph';
+import ts from 'typescript';
+import { evaluate } from 'ts-evaluator';
+import { PRIMITIVE_SHIMS } from '../../config/compile.constants.js';
+// =============================================================================
+// 1. EVALUATION ENGINE
+//
+// Core ts-evaluator wrapper with lua-cli passthrough shims.
+// Shims are defined in config/compile.constants.ts (single source of truth)
+// and shared with utils/sandbox.ts.
+// =============================================================================
+/**
+ * Evaluate any AST expression node using ts-evaluator.
+ * Handles ALL expression types: literals, concatenation, variables,
+ * imported constants, template literals, function calls, etc.
+ *
+ * Provides lua-cli primitive shims so that expressions like
+ * `defineTool({name: 'foo'})` evaluate successfully.
+ */
+function evaluateNode(node) {
+    if (!node)
+        return undefined;
+    try {
+        const tsNode = node.compilerNode;
+        const typeChecker = node.getSourceFile().getProject().getTypeChecker().compilerObject;
+        const result = evaluate({
+            node: tsNode,
+            typeChecker,
+            typescript: ts,
+            environment: {
+                preset: 'NODE',
+                extra: PRIMITIVE_SHIMS,
+            },
+            policy: {
+                deterministic: false,
+                network: false,
+                console: false,
+                io: { read: true, write: false },
+                process: { exit: false, spawnChild: false },
+            },
+        });
+        if (result.success)
+            return result.value;
+    }
+    catch {
+        // ts-evaluator failed — return undefined
+    }
+    return undefined;
+}
+// =============================================================================
+// 2. NODE EVALUATION
+//
+// Evaluate a raw AST Node to a typed runtime value.
+// Primary path: ts-evaluator. Fallback: resolveIdentifier() + literal check.
+// =============================================================================
+/** Evaluate an AST node as a string. Falls back to AST resolution if ts-evaluator fails. */
+export function evaluateNodeAsString(node) {
+    const val = evaluateNode(node);
+    if (typeof val === 'string')
+        return val;
+    // AST fallback: resolve identifier chain → check for string literal
+    if (node) {
+        const resolved = resolveIdentifier(node);
+        if (resolved && Node.isStringLiteral(resolved))
+            return resolved.getLiteralValue();
+    }
+    return undefined;
+}
+/** Evaluate an AST node as a number. Falls back to AST resolution if ts-evaluator fails. */
+export function evaluateNodeAsNumber(node) {
+    const val = evaluateNode(node);
+    if (typeof val === 'number')
+        return val;
+    // AST fallback: resolve identifier chain → check for numeric literal
+    if (node) {
+        const resolved = resolveIdentifier(node);
+        if (resolved && Node.isNumericLiteral(resolved))
+            return resolved.getLiteralValue();
+    }
+    return undefined;
+}
+/** Evaluate an AST node as a boolean. Falls back to AST resolution if ts-evaluator fails. */
+export function evaluateNodeAsBoolean(node) {
+    const val = evaluateNode(node);
+    if (typeof val === 'boolean')
+        return val;
+    // AST fallback: resolve identifier chain → check for boolean literal
+    if (node) {
+        const resolved = resolveIdentifier(node);
+        if (resolved && Node.isTrueLiteral(resolved))
+            return true;
+        if (resolved && Node.isFalseLiteral(resolved))
+            return false;
+    }
+    return undefined;
+}
+// =============================================================================
+// 3. PROPERTY EXTRACTION
+//
+// All functions that read a named property from an ObjectLiteralExpression.
+//
+// Primitives:    extractStringProperty, extractNumberProperty, extractBooleanProperty
+// Complex:       extractObjectProperty, extractArrayProperty, extractFunctionProperty
+// Raw AST:       extractSchemaProperty (returns Node for downstream Zod processing)
+// Post-eval:     extractNestedProperty (plain key lookup on already-extracted object)
+// Introspection: hasProperty, getPropertyNames
+// =============================================================================
 /**
  * Extract a string value from an object property.
- * Handles string literals and template literals.
+ * Delegates to evaluateNodeAsString for full expression evaluation + AST fallback.
  */
 export function extractStringProperty(obj, propertyName) {
     const prop = obj.getProperty(propertyName);
@@ -16,65 +127,54 @@ export function extractStringProperty(obj, propertyName) {
     const value = prop.getInitializer();
     if (!value)
         return undefined;
-    // String literal: "value" or 'value'
-    if (Node.isStringLiteral(value)) {
-        return value.getLiteralValue();
-    }
-    // Template literal without expressions: `value`
-    if (Node.isNoSubstitutionTemplateLiteral(value)) {
-        return value.getLiteralValue();
-    }
-    // Template literal with expressions: `${x}` - return the full text
-    if (Node.isTemplateExpression(value)) {
-        // For complex templates, return the raw text minus backticks
-        const text = value.getText();
-        return text.slice(1, -1);
-    }
-    return undefined;
+    return evaluateNodeAsString(value);
 }
 /**
  * Extract a boolean value from an object property.
+ * Delegates to evaluateNodeAsBoolean for full expression evaluation + AST fallback.
  */
 export function extractBooleanProperty(obj, propertyName) {
     const prop = obj.getProperty(propertyName);
     if (!prop || !Node.isPropertyAssignment(prop))
         return undefined;
-    const value = prop.getInitializer();
-    if (!value)
-        return undefined;
-    const kind = value.getKind();
-    // TrueKeyword = 110, FalseKeyword = 95 in ts-morph
-    if (kind === SyntaxKind.TrueKeyword)
-        return true;
-    if (kind === SyntaxKind.FalseKeyword)
-        return false;
-    // Handle string "true" or "false"
-    if (Node.isStringLiteral(value)) {
-        const text = value.getLiteralValue();
-        if (text === 'true')
-            return true;
-        if (text === 'false')
-            return false;
-    }
-    return undefined;
+    return evaluateNodeAsBoolean(prop.getInitializer());
 }
 /**
  * Extract a number value from an object property.
+ * Delegates to evaluateNodeAsNumber for full expression evaluation + AST fallback.
  */
 export function extractNumberProperty(obj, propertyName) {
     const prop = obj.getProperty(propertyName);
     if (!prop || !Node.isPropertyAssignment(prop))
         return undefined;
-    const value = prop.getInitializer();
-    if (!value)
+    return evaluateNodeAsNumber(prop.getInitializer());
+}
+/**
+ * Extract a schema node from an object property.
+ * Returns the raw AST node (not evaluated) for downstream Zod processing.
+ */
+export function extractSchemaProperty(obj, propertyName) {
+    const prop = obj.getProperty(propertyName);
+    if (!prop || !Node.isPropertyAssignment(prop))
         return undefined;
-    if (Node.isNumericLiteral(value)) {
-        return value.getLiteralValue();
-    }
-    return undefined;
+    return prop.getInitializer();
 }
 /**
- * Extract an object literal from an object property.
+ * Extract nested property from an already-evaluated object (not AST).
+ * Use after extractObjectProperty() to drill into nested values.
+ *
+ * Example:
+ *   const schedule = extractObjectProperty(config, 'schedule');
+ *   const type = extractNestedProperty(schedule, 'type');
+ */
+export function extractNestedProperty(obj, propertyName) {
+    if (!obj || typeof obj !== 'object')
+        return undefined;
+    return obj[propertyName];
+}
+/**
+ * Extract an object property, evaluated to its runtime value.
+ * Uses ts-evaluator to resolve inline objects, variable references, imports, spreads.
  */
 export function extractObjectProperty(obj, propertyName) {
     const prop = obj.getProperty(propertyName);
@@ -83,46 +183,62 @@ export function extractObjectProperty(obj, propertyName) {
     const value = prop.getInitializer();
     if (!value)
         return undefined;
-    if (Node.isObjectLiteralExpression(value)) {
-        return value;
+    const evaluated = evaluateNode(value);
+    if (evaluated && typeof evaluated === 'object' && !Array.isArray(evaluated)) {
+        return evaluated;
     }
     return undefined;
 }
 /**
- * Extract a schema node from an object property.
- * Returns the initializer node which can be evaluated as a Zod schema.
+ * Extract an array property, evaluated to its runtime value.
+ * Uses ts-evaluator to resolve inline arrays, variable references, imports, spreads.
  */
-export function extractSchemaProperty(obj, propertyName) {
+export function extractArrayProperty(obj, propertyName) {
     const prop = obj.getProperty(propertyName);
     if (!prop || !Node.isPropertyAssignment(prop))
         return undefined;
-    return prop.getInitializer();
+    const value = prop.getInitializer();
+    if (!value)
+        return undefined;
+    const evaluated = evaluateNode(value);
+    return Array.isArray(evaluated) ? evaluated : undefined;
 }
 /**
- * Check if a property exists on an object literal.
+ * Extract a function property, evaluated to its runtime value.
+ * Detects both inline function expressions and variable references to functions.
  */
+export function extractFunctionProperty(obj, propertyName) {
+    const prop = obj.getProperty(propertyName);
+    if (!prop || !Node.isPropertyAssignment(prop))
+        return undefined;
+    const value = prop.getInitializer();
+    if (!value)
+        return undefined;
+    const evaluated = evaluateNode(value);
+    return typeof evaluated === 'function' ? evaluated : undefined;
+}
+/** Check if a property exists on an object literal. */
 export function hasProperty(obj, propertyName) {
     return obj.getProperty(propertyName) !== undefined;
 }
-/**
- * Extract all property names from an object literal.
- */
+/** Extract all property names from an object literal. */
 export function getPropertyNames(obj) {
     return obj.getProperties()
         .filter(prop => Node.isPropertyAssignment(prop))
         .map(prop => prop.getName());
 }
-/**
- * Check if a node is a function (arrow or regular).
- */
+// =============================================================================
+// 4. NODE INSPECTION
+//
+// Type checks and utilities for individual AST nodes.
+// =============================================================================
+/** Check if a node is a function (arrow or regular). */
 export function isFunction(node) {
     if (!node)
         return false;
     return Node.isArrowFunction(node) || Node.isFunctionExpression(node);
 }
-/**
- * Get the text of a function body.
- */
+/** Get the text of a function body. */
 export function getFunctionBody(node) {
     if (!node)
         return undefined;
@@ -136,6 +252,79 @@ export function getFunctionBody(node) {
     }
     return undefined;
 }
+// =============================================================================
+// 5. IDENTIFIER RESOLUTION
+//
+// Follow variable reference chains (same-file and cross-file via imports)
+// to find the underlying declaration/initializer.
+// =============================================================================
+/**
+ * Recursively resolve an Identifier node to its underlying initializer.
+ *
+ * Follows variable reference chains, including across files:
+ *   const a = [x, y];
+ *   const b = a;       // resolveIdentifier(b) → ArrayLiteralExpression [x, y]
+ *   const c = b;       // resolveIdentifier(c) → ArrayLiteralExpression [x, y]
+ *
+ * Resolution strategy:
+ * 1. Same-file lookup via getVariableDeclaration() (fast path)
+ * 2. Cross-file lookup via getDefinitionNodes() (follows imports)
+ *
+ * Stops at non-Identifier initializers (literals, call expressions, etc.)
+ * or when the declaration can't be found.
+ * Max depth of 10 to prevent infinite loops on circular references.
+ */
+export function resolveIdentifier(node, maxDepth = 10) {
+    if (!Node.isIdentifier(node))
+        return node;
+    let identNode = node;
+    for (let i = 0; i < maxDepth; i++) {
+        // Fast path: same-file variable declaration
+        let varDecl = identNode.getSourceFile().getVariableDeclaration(identNode.getText());
+        // Cross-file: follow imports via TypeChecker symbol resolution
+        if (!varDecl) {
+            try {
+                const defs = identNode.getDefinitionNodes();
+                varDecl = defs.find(d => Node.isVariableDeclaration(d));
+            }
+            catch { /* symbol resolution unavailable — file not in project */ }
+        }
+        if (!varDecl)
+            return identNode; // Can't resolve further
+        const init = varDecl.getInitializer();
+        if (!init)
+            return undefined;
+        // If the initializer is another Identifier, keep following the chain
+        if (Node.isIdentifier(init)) {
+            identNode = init;
+            continue;
+        }
+        // Reached a non-Identifier node — this is the resolved value
+        return init;
+    }
+    return identNode;
+}
+/**
+ * Resolve an Identifier to an ArrayLiteralExpression (recursive).
+ * Convenience wrapper over resolveIdentifier().
+ */
+export function resolveIdentifierToArray(node) {
+    const resolved = resolveIdentifier(node);
+    return resolved && Node.isArrayLiteralExpression(resolved) ? resolved : undefined;
+}
+/**
+ * Resolve an Identifier to an ObjectLiteralExpression (recursive).
+ * Convenience wrapper over resolveIdentifier().
+ */
+export function resolveIdentifierToObject(node) {
+    const resolved = resolveIdentifier(node);
+    return resolved && Node.isObjectLiteralExpression(resolved) ? resolved : undefined;
+}
+// =============================================================================
+// 6. IMPORT RESOLUTION
+//
+// Find which source file an imported identifier comes from.
+// =============================================================================
 /**
  * Find the source file path for an imported identifier.
  *

package/dist/compiler/utils/ast-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"ast-helpers.js","sourceRoot":"","sources":["../../../src/compiler/utils/ast-helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ast-helpers.js","sourceRoot":"","sources":["../../../src/compiler/utils/ast-helpers.ts"],"names":[],"mappings":"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"}

package/dist/config/compile.constants.d.ts

@@ -1,6 +1,31 @@
 /**
  * Constants for the compile command
  */
+declare class PassthroughPrimitive {
+    constructor(config: any);
+}
+/**
+ * Map of all lua-cli primitive shims.
+ * Single source of truth — add new primitives here.
+ */
+export declare const PRIMITIVE_SHIMS: {
+    LuaTool: typeof PassthroughPrimitive;
+    LuaSkill: typeof PassthroughPrimitive;
+    LuaJob: typeof PassthroughPrimitive;
+    LuaWebhook: typeof PassthroughPrimitive;
+    PreProcessor: typeof PassthroughPrimitive;
+    LuaPreprocessor: typeof PassthroughPrimitive;
+    PostProcessor: typeof PassthroughPrimitive;
+    LuaPostprocessor: typeof PassthroughPrimitive;
+    LuaMCPServer: typeof PassthroughPrimitive;
+    defineTool: (config: any) => any;
+    defineSkill: (config: any) => any;
+    defineJob: (config: any) => any;
+    defineWebhook: (config: any) => any;
+    definePreProcessor: (config: any) => any;
+    definePostProcessor: (config: any) => any;
+    defineMCPServer: (config: any) => any;
+};
 /**
  * Directory names used during compilation
  */
@@ -46,3 +71,4 @@ export declare const YAML_FORMAT: {
     readonly LINE_WIDTH: -1;
     readonly NO_REFS: true;
 };
+export {};

package/dist/config/compile.constants.js

@@ -1,6 +1,50 @@
 /**
  * Constants for the compile command
  */
+// =============================================================================
+// PRIMITIVE SHIMS
+//
+// Passthrough shims for lua-cli primitives (define* functions and Lua* classes).
+// Used in two places:
+// - compiler/utils/ast-helpers.ts: fed to ts-evaluator so it can resolve
+//   expressions like `defineTool({name: 'foo'})` at compile time
+// - utils/sandbox.ts: injected into the VM context so bundled code that
+//   still references these names at runtime gets a no-op passthrough
+//
+// The define* functions return their config as-is.
+// The Lua* classes assign config properties to `this`.
+// =============================================================================
+class PassthroughPrimitive {
+    constructor(config) { Object.assign(this, config); }
+}
+const passthroughDefine = (config) => config;
+/**
+ * Map of all lua-cli primitive shims.
+ * Single source of truth — add new primitives here.
+ */
+export const PRIMITIVE_SHIMS = {
+    // Class-based constructors
+    LuaTool: PassthroughPrimitive,
+    LuaSkill: PassthroughPrimitive,
+    LuaJob: PassthroughPrimitive,
+    LuaWebhook: PassthroughPrimitive,
+    PreProcessor: PassthroughPrimitive,
+    LuaPreprocessor: PassthroughPrimitive,
+    PostProcessor: PassthroughPrimitive,
+    LuaPostprocessor: PassthroughPrimitive,
+    LuaMCPServer: PassthroughPrimitive,
+    // Function-based define patterns
+    defineTool: passthroughDefine,
+    defineSkill: passthroughDefine,
+    defineJob: passthroughDefine,
+    defineWebhook: passthroughDefine,
+    definePreProcessor: passthroughDefine,
+    definePostProcessor: passthroughDefine,
+    defineMCPServer: passthroughDefine,
+};
+// =============================================================================
+// DIRECTORIES & FILES
+// =============================================================================
 /**
  * Directory names used during compilation
  */

package/dist/config/compile.constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"compile.constants.js","sourceRoot":"","sources":["../../src/config/compile.constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,GAAG,EAAE,MAAM;IACX,KAAK,EAAE,OAAO;CACN,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,eAAe,EAAE,iBAAiB;IAClC,WAAW,EAAE,aAAa;IAC1B,aAAa,EAAE,eAAe;IAC9B,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,YAAY,EAAE,cAAc;IAC5B,aAAa,EAAE,eAAe;IAC9B,cAAc,EAAE,gBAAgB;CACxB,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE,EAAE;IACf,OAAO,EAAE,EAAE;CACH,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM,EAAE,CAAC;CACD,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM,EAAE,CAAC;IACT,UAAU,EAAE,CAAC,CAAC;IACd,OAAO,EAAE,IAAI;CACL,CAAC"}
+{"version":3,"file":"compile.constants.js","sourceRoot":"","sources":["../../src/config/compile.constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,gFAAgF;AAChF,kBAAkB;AAClB,EAAE;AACF,iFAAiF;AACjF,sBAAsB;AACtB,yEAAyE;AACzE,iEAAiE;AACjE,wEAAwE;AACxE,qEAAqE;AACrE,EAAE;AACF,mDAAmD;AACnD,uDAAuD;AACvD,gFAAgF;AAEhF,MAAM,oBAAoB;IAAG,YAAY,MAAW,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;CAAE;AACxF,MAAM,iBAAiB,GAAG,CAAC,MAAW,EAAE,EAAE,CAAC,MAAM,CAAC;AAElD;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,2BAA2B;IAC3B,OAAO,EAAE,oBAAoB;IAC7B,QAAQ,EAAE,oBAAoB;IAC9B,MAAM,EAAE,oBAAoB;IAC5B,UAAU,EAAE,oBAAoB;IAChC,YAAY,EAAE,oBAAoB;IAClC,eAAe,EAAE,oBAAoB;IACrC,aAAa,EAAE,oBAAoB;IACnC,gBAAgB,EAAE,oBAAoB;IACtC,YAAY,EAAE,oBAAoB;IAClC,iCAAiC;IACjC,UAAU,EAAE,iBAAiB;IAC7B,WAAW,EAAE,iBAAiB;IAC9B,SAAS,EAAE,iBAAiB;IAC5B,aAAa,EAAE,iBAAiB;IAChC,kBAAkB,EAAE,iBAAiB;IACrC,mBAAmB,EAAE,iBAAiB;IACtC,eAAe,EAAE,iBAAiB;CACnC,CAAC;AAEF,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,GAAG,EAAE,MAAM;IACX,KAAK,EAAE,OAAO;CACN,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,eAAe,EAAE,iBAAiB;IAClC,WAAW,EAAE,aAAa;IAC1B,aAAa,EAAE,eAAe;IAC9B,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,YAAY,EAAE,cAAc;IAC5B,aAAa,EAAE,eAAe;IAC9B,cAAc,EAAE,gBAAgB;CACxB,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE,EAAE;IACf,OAAO,EAAE,EAAE;CACH,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM,EAAE,CAAC;CACD,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM,EAAE,CAAC;IACT,UAAU,EAAE,CAAC,CAAC;IACd,OAAO,EAAE,IAAI;CACL,CAAC"}

package/dist/primitives/base.handler.d.ts

@@ -9,7 +9,7 @@
  */
 import { PrimitiveKind, CompilationManifest, ManifestPrimitive } from '../compiler/types.js';
 import { YamlConfig } from '../types/yaml.types.js';
-import type { VersionedPrimitiveHandler, PrimitiveHandler, SyncResult, YamlPrimitiveConfig } from './types.js';
+import type { VersionedPrimitiveHandler, PrimitiveHandler, SyncResult, ServerSyncData, YamlPrimitiveConfig } from './types.js';
 /** Default version for new primitives */
 export declare const DEFAULT_VERSION: "1.0.0";
 /**
@@ -29,11 +29,33 @@ export declare abstract class BaseVersionedHandler<T extends {
     abstract readonly yamlConfig: YamlPrimitiveConfig;
     protected abstract getApi(apiKey: string, agentId: string): unknown;
     protected abstract fetchFromServer(api: unknown): Promise<any[] | null>;
-    abstract cleanItem(item: T): T;
-    abstract isActive(serverItem: any): boolean;
-    abstract getActiveVersion(serverItem: any): string | null;
+    /**
+     * Strip a YAML item to only the canonical fields: name, version, [idField].
+     * Override if your YAML type has additional fields.
+     */
+    cleanItem(item: T): T;
+    /**
+     * Whether a server entity is considered active (for orphan detection).
+     * Default: true. Override for primitives with active/status fields.
+     */
+    isActive(_serverItem: any): boolean;
+    /**
+     * Get the active version string from a server entity.
+     * Default: finds version with isActive === true. Override for different field names.
+     */
+    getActiveVersion(serverItem: any): string | null;
     protected getServerItemName(item: any): string;
     protected shouldConsiderForOrphan(_item: any): boolean;
+    /** Phase 1 of parallel sync: fetch server state (HTTP only, no YAML writes) */
+    fetchServerState(apiKey: string, agentId: string): Promise<ServerSyncData>;
+    /**
+     * Phase 2 of parallel sync: apply fetched data to YAML.
+     * Optionally creates missing primitives on server if apiKey+agentId provided.
+     */
+    applySyncToYaml(serverData: ServerSyncData, config: YamlConfig | null, manifest?: CompilationManifest, apiCredentials?: {
+        apiKey: string;
+        agentId: string;
+    }): Promise<SyncResult>;
     syncWithServer(apiKey: string, agentId: string, config: YamlConfig | null, manifest?: CompilationManifest): Promise<SyncResult>;
     /**
      * Create a primitive on the server. Subclasses must implement this.
@@ -75,13 +97,26 @@ export declare abstract class BaseVersionedHandler<T extends {
      * Get the highest version string from the server for conflict avoidance.
      */
     getHighestServerVersion(apiKey: string, agentId: string, entityId: string): Promise<string | null>;
+    /**
+     * Fetch all server items once, extract highest version for each entity ID.
+     * More efficient than calling getHighestServerVersion() per entity.
+     */
+    batchGetHighestVersions(apiKey: string, agentId: string, entityIds: string[]): Promise<Map<string, string | null>>;
     /** Get the server ID from a YAML item using the configured idField. */
     protected getItemId(item: T): string;
-    private buildMaps;
+    protected buildMaps(serverItems: any[], yamlItems: T[]): {
+        yamlById: Map<string, T>;
+        yamlByName: Map<string, T>;
+        serverByName: Map<string, any>;
+    };
     /**
      * For each YAML item, match to server by name, populate missing IDs, update versions.
      */
-    private syncFromServer;
+    protected syncFromServer(yamlItems: T[], serverByName: Map<string, any>): {
+        items: T[];
+        changed: boolean;
+        msgs: string[];
+    };
 }
 /**
  * For primitives without versions (e.g., MCP servers).
@@ -99,6 +134,10 @@ export declare abstract class BaseNonVersionedHandler<T extends {
     abstract cleanItem(item: T): T;
     protected abstract isActive(item: any): boolean;
     protected getServerItemName(item: any): string;
+    /** Phase 1 of parallel sync: fetch server state (HTTP only, no YAML writes) */
+    fetchServerState(apiKey: string, agentId: string): Promise<ServerSyncData>;
+    /** Phase 2 of parallel sync: apply fetched data to YAML (orphan detection only for non-versioned) */
+    applySyncToYaml(serverData: ServerSyncData, config: YamlConfig | null, _manifest?: CompilationManifest): Promise<SyncResult>;
     syncWithServer(apiKey: string, agentId: string, config: YamlConfig | null, _manifest?: CompilationManifest): Promise<SyncResult>;
     updateYaml(items: T[], config: YamlConfig | null): void;
     getFromYaml(config: YamlConfig | null): T[];