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

package/dist/compiler/plugins/webhook.plugin.js

@@ -6,7 +6,6 @@
  * 2. Function-based (new): const myWebhook = defineWebhook({ ... })
  */
 import { Node } from 'ts-morph';
-import { PrimitiveKind, } from '../types.js';
 import { BasePlugin, validationError, validationWarning } from './base.js';
 import { extractSchemaProperty } from '../utils/ast-helpers.js';
 import { zodToJsonSchema } from '../utils/schema-converter.js';
@@ -42,18 +41,10 @@ export class WebhookPlugin extends BasePlugin {
         };
     }
     validate(metadata) {
-        const errors = [];
-        const warnings = [];
-        if (!metadata.name) {
-            errors.push(validationError('Webhook must have a name', { line: metadata.line }));
-        }
+        const { errors, warnings } = this.baseValidation(metadata);
         if (!metadata.metadata.hasExecute) {
             errors.push(validationError('Webhook must have an execute function', { line: metadata.line }));
         }
-        if (!metadata.description) {
-            warnings.push(validationWarning('Webhook should have a description', { line: metadata.line }));
-        }
-        // Validate name format (URL-safe)
         if (metadata.name && !/^[a-z][a-z0-9-]*$/.test(metadata.name)) {
             warnings.push(validationWarning('Webhook name should be URL-safe (lowercase, hyphens only)', { line: metadata.line }));
         }
@@ -108,20 +99,14 @@ export class WebhookPlugin extends BasePlugin {
         return Object.keys(schemas).length > 0 ? schemas : undefined;
     }
     toManifestEntry(compiled, _context) {
-        const webhook = {
-            kind: PrimitiveKind.WEBHOOK,
-            name: compiled.name,
-            description: compiled.description,
-            path: `artifacts/${compiled.kind}/${compiled.name}.js`,
-            sourcePath: compiled.sourcePath,
-            hash: compiled.artifact.hash,
+        return {
+            ...this.baseManifestFields(compiled),
             schemas: compiled.schemas ? {
                 query: compiled.schemas.query,
                 headers: compiled.schemas.headers,
                 body: compiled.schemas.body,
             } : undefined,
         };
-        return webhook;
     }
 }
 //# sourceMappingURL=webhook.plugin.js.map

package/dist/compiler/plugins/webhook.plugin.js.map

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

package/dist/compiler/types.d.ts

@@ -204,6 +204,10 @@ export interface ProjectFile {
     size: number;
     type: 'source' | 'config' | 'other';
 }
+/** Manifest format version. Referenced by entry points, manifests, and minimal manifests. */
+export declare const COMPILER_VERSION = "2.0.0";
+/** esbuild compilation target. Referenced by bundler and MCP resolver bundler. */
+export declare const ESBUILD_TARGET = "node18";
 export declare enum PrimitiveKind {
     TOOL = "tool",
     SKILL = "skill",
@@ -225,6 +229,7 @@ export interface ManifestTool extends ManifestPrimitiveBase {
         input?: JSONSchema;
         output?: JSONSchema;
     };
+    hasCondition?: boolean;
 }
 export interface ManifestSkill extends ManifestPrimitiveBase {
     kind: PrimitiveKind.SKILL;

package/dist/compiler/types.js

@@ -5,6 +5,13 @@
  * Uses discriminated unions for type-safe primitive handling.
  */
 // =============================================================================
+// COMPILER CONSTANTS
+// =============================================================================
+/** Manifest format version. Referenced by entry points, manifests, and minimal manifests. */
+export const COMPILER_VERSION = '2.0.0';
+/** esbuild compilation target. Referenced by bundler and MCP resolver bundler. */
+export const ESBUILD_TARGET = 'node18';
+// =============================================================================
 // MANIFEST PRIMITIVES
 // =============================================================================
 export var PrimitiveKind;

package/dist/compiler/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/compiler/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgRH,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF,MAAM,CAAN,IAAY,aAQX;AARD,WAAY,aAAa;IACvB,8BAAa,CAAA;IACb,gCAAe,CAAA;IACf,4BAAW,CAAA;IACX,oCAAmB,CAAA;IACnB,8CAA6B,CAAA;IAC7B,gDAA+B,CAAA;IAC/B,0CAAyB,CAAA;AAC3B,CAAC,EARW,aAAa,KAAb,aAAa,QAQxB"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/compiler/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgRH,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF,6FAA6F;AAC7F,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAExC,kFAAkF;AAClF,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC;AAEvC,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF,MAAM,CAAN,IAAY,aAQX;AARD,WAAY,aAAa;IACvB,8BAAa,CAAA;IACb,gCAAe,CAAA;IACf,4BAAW,CAAA;IACX,oCAAmB,CAAA;IACnB,8CAA6B,CAAA;IAC7B,gDAA+B,CAAA;IAC/B,0CAAyB,CAAA;AAC3B,CAAC,EARW,aAAa,KAAb,aAAa,QAQxB"}

package/dist/compiler/utils/ast-helpers.d.ts

@@ -3,19 +3,31 @@
  *
  * These utilities make it easy to extract typed values from
  * object literal expressions in TypeScript source code.
+ *
+ * Uses ts-evaluator for full expression evaluation — handles any expression
+ * that can be statically resolved (literals, concatenation, variables,
+ * imported constants, template literals, function calls, etc.).
  */
 import { Node, ObjectLiteralExpression, SourceFile } from 'ts-morph';
+/** Evaluate an AST node as a string. */
+export declare function evaluateNodeAsString(node: Node | undefined): string | undefined;
+/** Evaluate an AST node as a number. */
+export declare function evaluateNodeAsNumber(node: Node | undefined): number | undefined;
+/** Evaluate an AST node as a boolean. */
+export declare function evaluateNodeAsBoolean(node: Node | undefined): boolean | undefined;
 /**
  * Extract a string value from an object property.
- * Handles string literals and template literals.
+ * Uses ts-evaluator for full expression evaluation.
  */
 export declare function extractStringProperty(obj: ObjectLiteralExpression, propertyName: string): string | undefined;
 /**
  * Extract a boolean value from an object property.
+ * Uses ts-evaluator for full expression evaluation.
  */
 export declare function extractBooleanProperty(obj: ObjectLiteralExpression, propertyName: string): boolean | undefined;
 /**
  * Extract a number value from an object property.
+ * Uses ts-evaluator for full expression evaluation.
  */
 export declare function extractNumberProperty(obj: ObjectLiteralExpression, propertyName: string): number | undefined;
 /**

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

@@ -3,11 +3,66 @@
  *
  * These utilities make it easy to extract typed values from
  * object literal expressions in TypeScript source code.
+ *
+ * Uses ts-evaluator for full expression evaluation — handles any expression
+ * that can be statically resolved (literals, concatenation, variables,
+ * imported constants, template literals, function calls, etc.).
+ */
+import { Node } from 'ts-morph';
+import ts from 'typescript';
+import { evaluate } from 'ts-evaluator';
+/**
+ * Evaluate any AST expression node using ts-evaluator.
+ * Handles ALL expression types: literals, concatenation, variables,
+ * imported constants, template literals, function calls, etc.
+ *
+ * Uses the same sandboxed evaluation approach as zodToJsonSchema() in schema-converter.ts.
  */
-import { Node, SyntaxKind } from 'ts-morph';
+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' },
+            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;
+}
+/** Evaluate an AST node as a string. */
+export function evaluateNodeAsString(node) {
+    const val = evaluateNode(node);
+    return typeof val === 'string' ? val : undefined;
+}
+/** Evaluate an AST node as a number. */
+export function evaluateNodeAsNumber(node) {
+    const val = evaluateNode(node);
+    return typeof val === 'number' ? val : undefined;
+}
+/** Evaluate an AST node as a boolean. */
+export function evaluateNodeAsBoolean(node) {
+    const val = evaluateNode(node);
+    return typeof val === 'boolean' ? val : undefined;
+}
 /**
  * Extract a string value from an object property.
- * Handles string literals and template literals.
+ * Uses ts-evaluator for full expression evaluation.
  */
 export function extractStringProperty(obj, propertyName) {
     const prop = obj.getProperty(propertyName);
@@ -16,62 +71,27 @@ 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.
+ * Uses ts-evaluator for full expression evaluation.
  */
 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.
+ * Uses ts-evaluator for full expression evaluation.
  */
 export function extractNumberProperty(obj, propertyName) {
     const prop = obj.getProperty(propertyName);
     if (!prop || !Node.isPropertyAssignment(prop))
         return undefined;
-    const value = prop.getInitializer();
-    if (!value)
-        return undefined;
-    if (Node.isNumericLiteral(value)) {
-        return value.getLiteralValue();
-    }
-    return undefined;
+    return evaluateNodeAsNumber(prop.getInitializer());
 }
 /**
  * Extract an object literal from an object property.

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/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[];

package/dist/primitives/base.handler.js

@@ -11,6 +11,7 @@ import { readYamlConfig, writeYamlConfig } from '../utils/files.js';
 import { SKILL_DEFAULTS } from '../config/compile.constants.js';
 import { findPrimitive, loadArtifact, compressForPush } from '../utils/artifact-loader.js';
 import { maxSemver } from '../utils/semver.js';
+import { AuthenticationError } from '../errors/auth.error.js';
 /** Default version for new primitives */
 export const DEFAULT_VERSION = SKILL_DEFAULTS.VERSION;
 // =============================================================================
@@ -23,6 +24,32 @@ export const DEFAULT_VERSION = SKILL_DEFAULTS.VERSION;
  *     Must have at least { name: string; version: string; [idField]: string }.
  */
 export class BaseVersionedHandler {
+    /**
+     * Strip a YAML item to only the canonical fields: name, version, [idField].
+     * Override if your YAML type has additional fields.
+     */
+    cleanItem(item) {
+        return {
+            name: item.name || '',
+            version: item.version || DEFAULT_VERSION,
+            [this.yamlConfig.idField]: this.getItemId(item) || '',
+        };
+    }
+    /**
+     * Whether a server entity is considered active (for orphan detection).
+     * Default: true. Override for primitives with active/status fields.
+     */
+    isActive(_serverItem) {
+        return true;
+    }
+    /**
+     * Get the active version string from a server entity.
+     * Default: finds version with isActive === true. Override for different field names.
+     */
+    getActiveVersion(serverItem) {
+        const active = serverItem.versions?.find((v) => v.isActive === true);
+        return active?.version ?? null;
+    }
     getServerItemName(item) {
         return item.name || 'unknown';
     }
@@ -32,21 +59,41 @@ export class BaseVersionedHandler {
     // ===========================================================================
     // SERVER SYNC
     // ===========================================================================
-    async syncWithServer(apiKey, agentId, config, manifest) {
+    /** Phase 1 of parallel sync: fetch server state (HTTP only, no YAML writes) */
+    async fetchServerState(apiKey, agentId) {
+        try {
+            const api = this.getApi(apiKey, agentId);
+            const serverItems = await this.fetchFromServer(api);
+            return { serverItems };
+        }
+        catch (error) {
+            if (AuthenticationError.isAuthenticationError(error))
+                throw error;
+            return { serverItems: null, fetchError: error instanceof Error ? error.message : String(error) };
+        }
+    }
+    /**
+     * Phase 2 of parallel sync: apply fetched data to YAML.
+     * Optionally creates missing primitives on server if apiKey+agentId provided.
+     */
+    async applySyncToYaml(serverData, config, manifest, apiCredentials) {
         const messages = [];
         let yamlUpdated = false;
         let orphanedCount = 0;
         try {
-            const api = this.getApi(apiKey, agentId);
-            const serverItems = await this.fetchFromServer(api);
-            if (!serverItems) {
-                console.warn(`⚠️  Could not retrieve server ${this.displayNamePlural}. Skipping sync.`);
+            if (!serverData.serverItems) {
+                if (serverData.fetchError) {
+                    console.error(`❌ Error syncing server ${this.displayNamePlural}: ${serverData.fetchError}`);
+                }
+                else {
+                    console.warn(`⚠️  Could not retrieve server ${this.displayNamePlural}. Skipping sync.`);
+                }
                 return { messages, yamlUpdated, orphanedCount };
             }
             const yamlItems = this.getFromYaml(config);
-            const { yamlById, yamlByName, serverByName } = this.buildMaps(serverItems, yamlItems);
-            // Part 1: Detect orphaned items (on server, not in local code)
-            const orphans = serverItems.filter(item => {
+            const { yamlById, yamlByName, serverByName } = this.buildMaps(serverData.serverItems, yamlItems);
+            // Part 1: Detect orphaned items
+            const orphans = serverData.serverItems.filter(item => {
                 const id = item.id;
                 const name = item.name;
                 return !yamlById.has(id) && !yamlByName.has(name) &&
@@ -70,8 +117,9 @@ export class BaseVersionedHandler {
                 console.log(`✅ YAML ${this.displayNamePlural} synced with server`);
                 yamlUpdated = true;
             }
-            // Part 3: Create primitives that don't exist on server (if manifest provided)
-            if (manifest) {
+            // Part 3: Create primitives that don't exist on server (if manifest + credentials provided)
+            if (manifest && apiCredentials) {
+                const api = this.getApi(apiCredentials.apiKey, apiCredentials.agentId);
                 const { created, updated: creationUpdated } = await this.createMissingOnServer(api, manifest);
                 if (created.length > 0) {
                     messages.push(...created.map(name => `Created "${name}" on server`));
@@ -87,6 +135,10 @@ export class BaseVersionedHandler {
         }
         return { messages, yamlUpdated, orphanedCount };
     }
+    async syncWithServer(apiKey, agentId, config, manifest) {
+        const serverData = await this.fetchServerState(apiKey, agentId);
+        return this.applySyncToYaml(serverData, config, manifest, { apiKey, agentId });
+    }
     /**
      * Create primitives that have empty IDs in YAML.
      * Called internally by syncWithServer when manifest is provided.
@@ -240,6 +292,38 @@ export class BaseVersionedHandler {
             return null;
         }
     }
+    /**
+     * Fetch all server items once, extract highest version for each entity ID.
+     * More efficient than calling getHighestServerVersion() per entity.
+     */
+    async batchGetHighestVersions(apiKey, agentId, entityIds) {
+        const result = new Map();
+        try {
+            const api = this.getApi(apiKey, agentId);
+            const serverItems = await this.fetchFromServer(api);
+            if (!serverItems) {
+                entityIds.forEach(id => result.set(id, null));
+                return result;
+            }
+            for (const entityId of entityIds) {
+                const entity = serverItems.find((item) => item.id === entityId);
+                if (!entity?.versions || !Array.isArray(entity.versions)) {
+                    result.set(entityId, null);
+                    continue;
+                }
+                const versions = entity.versions
+                    .map((v) => v.version)
+                    .filter((v) => typeof v === 'string');
+                result.set(entityId, versions.length > 0
+                    ? versions.reduce((h, v) => maxSemver(h, v), '0.0.0')
+                    : null);
+            }
+        }
+        catch {
+            entityIds.forEach(id => result.set(id, null));
+        }
+        return result;
+    }
     // ===========================================================================
     // INTERNAL
     // ===========================================================================
@@ -310,15 +394,31 @@ export class BaseNonVersionedHandler {
     getServerItemName(item) {
         return item.name || 'unknown';
     }
-    async syncWithServer(apiKey, agentId, config, _manifest // Not used by non-versioned handlers
-    ) {
-        const messages = [];
-        let orphanedCount = 0;
+    /** Phase 1 of parallel sync: fetch server state (HTTP only, no YAML writes) */
+    async fetchServerState(apiKey, agentId) {
         try {
             const api = this.getApi(apiKey, agentId);
             const serverItems = await this.fetchFromServer(api);
-            if (!serverItems) {
-                console.warn(`⚠️  Could not retrieve server ${this.displayNamePlural}. Skipping sync.`);
+            return { serverItems };
+        }
+        catch (error) {
+            if (AuthenticationError.isAuthenticationError(error))
+                throw error;
+            return { serverItems: null, fetchError: error instanceof Error ? error.message : String(error) };
+        }
+    }
+    /** Phase 2 of parallel sync: apply fetched data to YAML (orphan detection only for non-versioned) */
+    async applySyncToYaml(serverData, config, _manifest) {
+        const messages = [];
+        let orphanedCount = 0;
+        try {
+            if (!serverData.serverItems) {
+                if (serverData.fetchError) {
+                    console.error(`❌ Error syncing server ${this.displayNamePlural}: ${serverData.fetchError}`);
+                }
+                else {
+                    console.warn(`⚠️  Could not retrieve server ${this.displayNamePlural}. Skipping sync.`);
+                }
                 return { messages, yamlUpdated: false, orphanedCount };
             }
             const yamlItems = this.getFromYaml(config);
@@ -326,7 +426,7 @@ export class BaseNonVersionedHandler {
             const getId = (item) => item[idField] || '';
             const yamlById = new Map(yamlItems.filter(i => getId(i)).map(i => [getId(i), i]));
             const yamlByName = new Map(yamlItems.map(i => [i.name, i]));
-            const orphans = serverItems.filter(item => {
+            const orphans = serverData.serverItems.filter(item => {
                 const id = item.id;
                 const name = item.name;
                 return !yamlById.has(id) && !yamlByName.has(name) && this.isActive(item);
@@ -350,6 +450,10 @@ export class BaseNonVersionedHandler {
         }
         return { messages, yamlUpdated: false, orphanedCount };
     }
+    async syncWithServer(apiKey, agentId, config, _manifest) {
+        const serverData = await this.fetchServerState(apiKey, agentId);
+        return this.applySyncToYaml(serverData, config);
+    }
     updateYaml(items, config) {
         const updatedConfig = {
             ...(config || {}),