newo 3.4.2 → 3.6.0

package/dist/env.d.ts

@@ -10,6 +10,7 @@ export interface ValidatedEnv {
     readonly NEWO_REFRESH_TOKEN: string | undefined;
     readonly NEWO_REFRESH_URL: string | undefined;
     readonly NEWO_DEFAULT_CUSTOMER: string | undefined;
+    readonly NEWO_FORMAT: string | undefined;
     readonly [key: string]: string | undefined;
 }
 /**

package/dist/env.js

@@ -47,6 +47,7 @@ export function validateEnvironment() {
         NEWO_REFRESH_TOKEN: refreshToken,
         NEWO_REFRESH_URL: refreshUrl,
         NEWO_DEFAULT_CUSTOMER: env.NEWO_DEFAULT_CUSTOMER?.trim(),
+        NEWO_FORMAT: env.NEWO_FORMAT?.trim(),
     };
 }
 /**

package/dist/format/detect.d.ts

@@ -0,0 +1,14 @@
+import { type FormatVersion, type FormatConfig } from './types.js';
+/**
+ * Detect format from existing filesystem structure for a customer
+ * Returns null if the customer directory doesn't exist or is empty
+ */
+export declare function detectFormatFromFilesystem(customerIdn: string): FormatVersion | null;
+/**
+ * Resolve the format version for a customer using the full resolution chain
+ *
+ * @param customerIdn - Customer identifier
+ * @param explicitFormat - Optional --format flag value
+ */
+export declare function resolveFormat(customerIdn: string, explicitFormat?: string): FormatConfig;
+//# sourceMappingURL=detect.d.ts.map

package/dist/format/detect.js

@@ -0,0 +1,105 @@
+/**
+ * Format detection and resolution
+ *
+ * Resolution chain per customer (highest to lowest priority):
+ * 1. Explicit --format flag (per-command override)
+ * 2. Filesystem auto-detect (for EXISTING customers):
+ *    - import_version.txt present -> newo_v2
+ *    - projects/ directory present -> cli_v1
+ * 3. NEWO_FORMAT env var (only for NEW customers where nothing exists locally)
+ * 4. Default: cli_v1
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { NEWO_CUSTOMERS_DIR } from '../fsutil.js';
+import { VALID_FORMATS } from './types.js';
+/**
+ * Detect format from existing filesystem structure for a customer
+ * Returns null if the customer directory doesn't exist or is empty
+ */
+export function detectFormatFromFilesystem(customerIdn) {
+    const customerDir = path.join(NEWO_CUSTOMERS_DIR, customerIdn);
+    if (!fs.existsSync(customerDir)) {
+        return null;
+    }
+    // Check for V2 marker: import_version.txt
+    const importVersionFile = path.join(customerDir, 'import_version.txt');
+    if (fs.existsSync(importVersionFile)) {
+        return 'newo_v2';
+    }
+    // Check for V1 marker: projects/ directory
+    const projectsDir = path.join(customerDir, 'projects');
+    if (fs.existsSync(projectsDir)) {
+        return 'cli_v1';
+    }
+    // Check one level down for import_version.txt (V2 exports sometimes have a wrapper dir)
+    try {
+        const entries = fs.readdirSync(customerDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                const nestedImportVersion = path.join(customerDir, entry.name, 'import_version.txt');
+                if (fs.existsSync(nestedImportVersion)) {
+                    return 'newo_v2';
+                }
+            }
+        }
+    }
+    catch {
+        // Ignore read errors
+    }
+    // Directory exists but no format markers found - could be empty or only has attributes
+    return null;
+}
+/**
+ * Get format from NEWO_FORMAT environment variable
+ */
+function getEnvFormat() {
+    const envFormat = process.env['NEWO_FORMAT']?.trim().toLowerCase();
+    if (!envFormat)
+        return null;
+    if (VALID_FORMATS.includes(envFormat)) {
+        return envFormat;
+    }
+    console.warn(`Warning: Invalid NEWO_FORMAT="${envFormat}". Valid values: ${VALID_FORMATS.join(', ')}. Using default.`);
+    return null;
+}
+/**
+ * Validate an explicit format string from --format flag
+ */
+function validateExplicitFormat(format) {
+    const normalized = format.trim().toLowerCase();
+    if (VALID_FORMATS.includes(normalized)) {
+        return normalized;
+    }
+    return null;
+}
+/**
+ * Resolve the format version for a customer using the full resolution chain
+ *
+ * @param customerIdn - Customer identifier
+ * @param explicitFormat - Optional --format flag value
+ */
+export function resolveFormat(customerIdn, explicitFormat) {
+    // 1. Explicit --format flag takes highest priority
+    if (explicitFormat) {
+        const validated = validateExplicitFormat(explicitFormat);
+        if (validated) {
+            return { version: validated, source: 'explicit-flag' };
+        }
+        console.error(`Invalid format "${explicitFormat}". Valid values: ${VALID_FORMATS.join(', ')}`);
+        process.exit(1);
+    }
+    // 2. Filesystem auto-detect for existing customers
+    const detected = detectFormatFromFilesystem(customerIdn);
+    if (detected) {
+        return { version: detected, source: 'auto-detected' };
+    }
+    // 3. NEWO_FORMAT env var (for new customers only)
+    const envFormat = getEnvFormat();
+    if (envFormat) {
+        return { version: envFormat, source: 'env-var' };
+    }
+    // 4. Default: cli_v1
+    return { version: 'cli_v1', source: 'default' };
+}
+//# sourceMappingURL=detect.js.map

package/dist/format/extensions.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Format-aware file extension mapping
+ *
+ * Handles the extension differences between cli_v1 and newo_v2:
+ *   cli_v1:  guidance -> .guidance,  nsl -> .jinja
+ *   newo_v2: guidance -> .nslg,      nsl -> .nsl
+ */
+import type { RunnerType } from '../types.js';
+import { type FormatVersion } from './types.js';
+/**
+ * Get file extension for a runner type in a specific format
+ */
+export declare function getExtensionForFormat(runnerType: RunnerType, format: FormatVersion): string;
+/**
+ * Get runner type from file extension (works for all 4 extensions)
+ */
+export declare function getRunnerTypeFromExtension(ext: string): RunnerType;
+/**
+ * Check if a filename is a recognized script file (any format)
+ */
+export declare function isScriptFile(filename: string): boolean;
+/**
+ * Infer format version from a file extension
+ */
+export declare function getFormatFromExtension(ext: string): FormatVersion;
+//# sourceMappingURL=extensions.d.ts.map

package/dist/format/extensions.js

@@ -0,0 +1,45 @@
+import { CLI_V1_EXTENSIONS, NEWO_V2_EXTENSIONS, ALL_SCRIPT_EXTENSIONS, } from './types.js';
+/**
+ * Get file extension for a runner type in a specific format
+ */
+export function getExtensionForFormat(runnerType, format) {
+    const map = format === 'newo_v2' ? NEWO_V2_EXTENSIONS : CLI_V1_EXTENSIONS;
+    const ext = map[runnerType];
+    return ext ?? CLI_V1_EXTENSIONS.guidance;
+}
+/**
+ * Get runner type from file extension (works for all 4 extensions)
+ */
+export function getRunnerTypeFromExtension(ext) {
+    const normalized = ext.startsWith('.') ? ext : `.${ext}`;
+    switch (normalized) {
+        case '.guidance':
+        case '.nslg':
+            return 'guidance';
+        case '.jinja':
+        case '.nsl':
+            return 'nsl';
+        default:
+            return 'guidance';
+    }
+}
+/**
+ * Check if a filename is a recognized script file (any format)
+ */
+export function isScriptFile(filename) {
+    const ext = filename.lastIndexOf('.') >= 0
+        ? filename.slice(filename.lastIndexOf('.'))
+        : '';
+    return ALL_SCRIPT_EXTENSIONS.includes(ext.toLowerCase());
+}
+/**
+ * Infer format version from a file extension
+ */
+export function getFormatFromExtension(ext) {
+    const normalized = ext.startsWith('.') ? ext : `.${ext}`;
+    if (normalized === '.nsl' || normalized === '.nslg') {
+        return 'newo_v2';
+    }
+    return 'cli_v1';
+}
+//# sourceMappingURL=extensions.js.map

package/dist/format/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Format module - handles cli_v1 and newo_v2 format differences
+ */
+export { type FormatVersion, type FormatConfig, CLI_V1_EXTENSIONS, NEWO_V2_EXTENSIONS, ALL_SCRIPT_EXTENSIONS, V2_IMPORT_VERSION, VALID_FORMATS, } from './types.js';
+export { getExtensionForFormat, getRunnerTypeFromExtension, isScriptFile, getFormatFromExtension, } from './extensions.js';
+export { detectFormatFromFilesystem, resolveFormat, } from './detect.js';
+export { v2CustomerDir, v2ProjectDir, v2AgentDir, v2FlowDir, v2SkillsDir, v2SkillScriptPath, v2FlowYamlPath, v2ProjectYamlPath, v2AgentYamlPath, v2ImportVersionPath, v2AkbDir, v2AkbPath, v2CustomerAttributesPath, v2ProjectAttributesPath, v2LibraryDir, v2LibraryYamlPath, v2LibrarySkillsDir, v2LibrarySkillScriptPath, } from './paths-v2.js';
+export { patchYamlToPyyaml } from './yaml-patch.js';
+export { v2LibrarySkillRelativePath } from './paths-v2.js';
+export { type V2FlowDefinition, type V2InlineSkill, type V2FlowEvent, type V2StateField, type V2ProjectMeta, type V2AgentMeta, type V2LibraryDefinition, parseV2FlowYaml, generateV2FlowYaml, parseV2ProjectYaml, generateV2ProjectYaml, parseV2AgentYaml, generateV2AgentYaml, parseV2LibraryYaml, generateV2LibraryYaml, } from './v2-yaml.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/format/index.js

@@ -0,0 +1,11 @@
+/**
+ * Format module - handles cli_v1 and newo_v2 format differences
+ */
+export { CLI_V1_EXTENSIONS, NEWO_V2_EXTENSIONS, ALL_SCRIPT_EXTENSIONS, V2_IMPORT_VERSION, VALID_FORMATS, } from './types.js';
+export { getExtensionForFormat, getRunnerTypeFromExtension, isScriptFile, getFormatFromExtension, } from './extensions.js';
+export { detectFormatFromFilesystem, resolveFormat, } from './detect.js';
+export { v2CustomerDir, v2ProjectDir, v2AgentDir, v2FlowDir, v2SkillsDir, v2SkillScriptPath, v2FlowYamlPath, v2ProjectYamlPath, v2AgentYamlPath, v2ImportVersionPath, v2AkbDir, v2AkbPath, v2CustomerAttributesPath, v2ProjectAttributesPath, v2LibraryDir, v2LibraryYamlPath, v2LibrarySkillsDir, v2LibrarySkillScriptPath, } from './paths-v2.js';
+export { patchYamlToPyyaml } from './yaml-patch.js';
+export { v2LibrarySkillRelativePath } from './paths-v2.js';
+export { parseV2FlowYaml, generateV2FlowYaml, parseV2ProjectYaml, generateV2ProjectYaml, parseV2AgentYaml, generateV2AgentYaml, parseV2LibraryYaml, generateV2LibraryYaml, } from './v2-yaml.js';
+//# sourceMappingURL=index.js.map

package/dist/format/paths-v2.d.ts

@@ -0,0 +1,31 @@
+import type { RunnerType } from '../types.js';
+export declare function v2CustomerDir(customerIdn: string): string;
+export declare function v2ImportVersionPath(customerIdn: string): string;
+export declare function v2CustomerAttributesPath(customerIdn: string): string;
+export declare function v2AkbDir(customerIdn: string): string;
+export declare function v2AkbPath(customerIdn: string, agentIdn: string): string;
+export declare function v2ProjectDir(customerIdn: string, projectIdn: string): string;
+export declare function v2ProjectYamlPath(customerIdn: string, projectIdn: string): string;
+export declare function v2ProjectAttributesPath(customerIdn: string, projectIdn: string): string;
+export declare function v2AgentDir(customerIdn: string, projectIdn: string, agentIdn: string): string;
+export declare function v2AgentYamlPath(customerIdn: string, projectIdn: string, agentIdn: string): string;
+export declare function v2FlowDir(customerIdn: string, projectIdn: string, agentIdn: string, flowIdn: string): string;
+export declare function v2FlowYamlPath(customerIdn: string, projectIdn: string, agentIdn: string, flowIdn: string): string;
+export declare function v2SkillsDir(customerIdn: string, projectIdn: string, agentIdn: string, flowIdn: string): string;
+export declare function v2SkillScriptPath(customerIdn: string, projectIdn: string, agentIdn: string, flowIdn: string, skillIdn: string, runnerType: RunnerType): string;
+/**
+ * Build the relative prompt_script path as it appears in V2 flow YAML
+ * e.g., "flows/MainFlow/skills/GreetingSkill.nsl"
+ */
+export declare function v2SkillRelativePath(flowIdn: string, skillIdn: string, runnerType: RunnerType): string;
+export declare function v2LibraryDir(customerIdn: string, projectIdn: string, libraryIdn: string): string;
+export declare function v2LibraryYamlPath(customerIdn: string, projectIdn: string, libraryIdn: string): string;
+export declare function v2LibrarySkillsDir(customerIdn: string, projectIdn: string, libraryIdn: string): string;
+export declare function v2LibrarySkillScriptPath(customerIdn: string, projectIdn: string, libraryIdn: string, skillIdn: string, runnerType: RunnerType): string;
+/**
+ * Build relative prompt_script path for library skill in V2 YAML
+ * The V2 export includes the project prefix:
+ *   e.g., "naf/libraries/testLib/skills/utilSkill.nsl"
+ */
+export declare function v2LibrarySkillRelativePath(projectIdn: string, libraryIdn: string, skillIdn: string, runnerType: RunnerType): string;
+//# sourceMappingURL=paths-v2.d.ts.map

package/dist/format/paths-v2.js

@@ -0,0 +1,104 @@
+/**
+ * V2 (newo_v2) path utilities
+ *
+ * Generates paths for the NEWO platform export format:
+ *   newo_customers/{cust}/
+ *     import_version.txt
+ *     attributes.yaml
+ *     akb/{AgentIdn}.yaml
+ *     {ProjectIdn}/
+ *       {project_idn}.yaml
+ *       attributes.yaml
+ *       agents/{AgentIdn}/
+ *         agent.yaml
+ *         flows/{FlowIdn}/
+ *           {FlowIdn}.yaml
+ *           skills/{SkillIdn}.nsl|.nslg
+ *       libraries/{LibIdn}/
+ *         {lib_idn}.yaml
+ *         skills/{SkillIdn}.nsl|.nslg
+ */
+import path from 'path';
+import { NEWO_CUSTOMERS_DIR } from '../fsutil.js';
+import { getExtensionForFormat } from './extensions.js';
+// ── Customer level ──
+export function v2CustomerDir(customerIdn) {
+    return path.posix.join(NEWO_CUSTOMERS_DIR, customerIdn);
+}
+export function v2ImportVersionPath(customerIdn) {
+    return path.posix.join(v2CustomerDir(customerIdn), 'import_version.txt');
+}
+export function v2CustomerAttributesPath(customerIdn) {
+    return path.posix.join(v2CustomerDir(customerIdn), 'attributes.yaml');
+}
+// ── AKB level ──
+export function v2AkbDir(customerIdn) {
+    return path.posix.join(v2CustomerDir(customerIdn), 'akb');
+}
+export function v2AkbPath(customerIdn, agentIdn) {
+    return path.posix.join(v2AkbDir(customerIdn), `${agentIdn}.yaml`);
+}
+// ── Project level ──
+export function v2ProjectDir(customerIdn, projectIdn) {
+    return path.posix.join(v2CustomerDir(customerIdn), projectIdn);
+}
+export function v2ProjectYamlPath(customerIdn, projectIdn) {
+    return path.posix.join(v2ProjectDir(customerIdn, projectIdn), `${projectIdn}.yaml`);
+}
+export function v2ProjectAttributesPath(customerIdn, projectIdn) {
+    return path.posix.join(v2ProjectDir(customerIdn, projectIdn), 'attributes.yaml');
+}
+// ── Agent level ──
+export function v2AgentDir(customerIdn, projectIdn, agentIdn) {
+    return path.posix.join(v2ProjectDir(customerIdn, projectIdn), 'agents', agentIdn);
+}
+export function v2AgentYamlPath(customerIdn, projectIdn, agentIdn) {
+    return path.posix.join(v2AgentDir(customerIdn, projectIdn, agentIdn), 'agent.yaml');
+}
+// ── Flow level ──
+export function v2FlowDir(customerIdn, projectIdn, agentIdn, flowIdn) {
+    return path.posix.join(v2AgentDir(customerIdn, projectIdn, agentIdn), 'flows', flowIdn);
+}
+export function v2FlowYamlPath(customerIdn, projectIdn, agentIdn, flowIdn) {
+    return path.posix.join(v2FlowDir(customerIdn, projectIdn, agentIdn, flowIdn), `${flowIdn}.yaml`);
+}
+// ── Skill level ──
+export function v2SkillsDir(customerIdn, projectIdn, agentIdn, flowIdn) {
+    return path.posix.join(v2FlowDir(customerIdn, projectIdn, agentIdn, flowIdn), 'skills');
+}
+export function v2SkillScriptPath(customerIdn, projectIdn, agentIdn, flowIdn, skillIdn, runnerType) {
+    const ext = getExtensionForFormat(runnerType, 'newo_v2');
+    return path.posix.join(v2SkillsDir(customerIdn, projectIdn, agentIdn, flowIdn), `${skillIdn}${ext}`);
+}
+/**
+ * Build the relative prompt_script path as it appears in V2 flow YAML
+ * e.g., "flows/MainFlow/skills/GreetingSkill.nsl"
+ */
+export function v2SkillRelativePath(flowIdn, skillIdn, runnerType) {
+    const ext = getExtensionForFormat(runnerType, 'newo_v2');
+    return `flows/${flowIdn}/skills/${skillIdn}${ext}`;
+}
+// ── Library level ──
+export function v2LibraryDir(customerIdn, projectIdn, libraryIdn) {
+    return path.posix.join(v2ProjectDir(customerIdn, projectIdn), 'libraries', libraryIdn);
+}
+export function v2LibraryYamlPath(customerIdn, projectIdn, libraryIdn) {
+    return path.posix.join(v2LibraryDir(customerIdn, projectIdn, libraryIdn), `${libraryIdn}.yaml`);
+}
+export function v2LibrarySkillsDir(customerIdn, projectIdn, libraryIdn) {
+    return path.posix.join(v2LibraryDir(customerIdn, projectIdn, libraryIdn), 'skills');
+}
+export function v2LibrarySkillScriptPath(customerIdn, projectIdn, libraryIdn, skillIdn, runnerType) {
+    const ext = getExtensionForFormat(runnerType, 'newo_v2');
+    return path.posix.join(v2LibrarySkillsDir(customerIdn, projectIdn, libraryIdn), `${skillIdn}${ext}`);
+}
+/**
+ * Build relative prompt_script path for library skill in V2 YAML
+ * The V2 export includes the project prefix:
+ *   e.g., "naf/libraries/testLib/skills/utilSkill.nsl"
+ */
+export function v2LibrarySkillRelativePath(projectIdn, libraryIdn, skillIdn, runnerType) {
+    const ext = getExtensionForFormat(runnerType, 'newo_v2');
+    return `${projectIdn}/libraries/${libraryIdn}/skills/${skillIdn}${ext}`;
+}
+//# sourceMappingURL=paths-v2.js.map

package/dist/format/types.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Format version types and constants
+ *
+ * Defines the two supported project formats:
+ * - cli_v1: Native CLI format (full feature support, per-entity metadata)
+ * - newo_v2: NEWO platform export format (compatible with platform UI exports)
+ */
+import type { RunnerType } from '../types.js';
+export type FormatVersion = 'cli_v1' | 'newo_v2';
+export interface FormatConfig {
+    version: FormatVersion;
+    source: 'explicit-flag' | 'env-var' | 'auto-detected' | 'default';
+}
+/**
+ * Extension mapping per format
+ *
+ * cli_v1: guidance -> .guidance, nsl -> .jinja
+ * newo_v2: guidance -> .nslg, nsl -> .nsl
+ */
+export declare const CLI_V1_EXTENSIONS: Record<RunnerType, string>;
+export declare const NEWO_V2_EXTENSIONS: Record<RunnerType, string>;
+/** All recognized script file extensions across both formats */
+export declare const ALL_SCRIPT_EXTENSIONS: readonly [".guidance", ".jinja", ".nsl", ".nslg"];
+/** V2 import version marker content */
+export declare const V2_IMPORT_VERSION = "v2.0.0";
+/** Valid format values for CLI flag and env var validation */
+export declare const VALID_FORMATS: readonly FormatVersion[];
+//# sourceMappingURL=types.d.ts.map

package/dist/format/types.js

@@ -0,0 +1,21 @@
+/**
+ * Extension mapping per format
+ *
+ * cli_v1: guidance -> .guidance, nsl -> .jinja
+ * newo_v2: guidance -> .nslg, nsl -> .nsl
+ */
+export const CLI_V1_EXTENSIONS = {
+    guidance: '.guidance',
+    nsl: '.jinja',
+};
+export const NEWO_V2_EXTENSIONS = {
+    guidance: '.nslg',
+    nsl: '.nsl',
+};
+/** All recognized script file extensions across both formats */
+export const ALL_SCRIPT_EXTENSIONS = ['.guidance', '.jinja', '.nsl', '.nslg'];
+/** V2 import version marker content */
+export const V2_IMPORT_VERSION = 'v2.0.0';
+/** Valid format values for CLI flag and env var validation */
+export const VALID_FORMATS = ['cli_v1', 'newo_v2'];
+//# sourceMappingURL=types.js.map

package/dist/format/v2-yaml.d.ts

@@ -0,0 +1,143 @@
+export interface V2InlineSkill {
+    title: string;
+    idn: string;
+    prompt_script: string;
+    runner_type: string;
+    model: {
+        model_idn: string;
+        provider_idn: string;
+    };
+    parameters: Array<{
+        name: string;
+        default_value: string;
+    }>;
+}
+export interface V2FlowEvent {
+    idn: string;
+    skill_selector: string;
+    skill_idn: string | null;
+    state_idn: string | null;
+    integration_idn: string | null;
+    connector_idn: string | null;
+    interrupt_mode: string;
+}
+export interface V2StateField {
+    title: string;
+    idn: string;
+    default_value: string;
+    scope: string;
+}
+export interface V2FlowDefinition {
+    title: string;
+    idn: string;
+    description: string | null;
+    agent_id: string | null;
+    skills: V2InlineSkill[];
+    events: V2FlowEvent[];
+    state_fields: V2StateField[];
+    default_runner_type: string;
+    default_provider_idn: string;
+    default_model_idn: string;
+    publication_type: string | null;
+}
+export interface V2ProjectMeta {
+    idn: string;
+    name: string;
+    version: string;
+    description: string;
+    is_auto_update_enabled: boolean;
+    registry: string;
+    registry_item_idn: string;
+}
+export interface V2AgentMeta {
+    idn: string;
+    title: string | null;
+    description: string | null;
+}
+export interface V2LibraryDefinition {
+    title: string;
+    idn: string;
+    description: string | null;
+    skills: V2InlineSkill[];
+}
+/**
+ * Sort skills in V2 export order (case-sensitive ASCII sort within groups):
+ * 1. CamelCase (public) - case-sensitive alphabetically
+ * 2. _prefixed (private) - case-sensitive alphabetically
+ * 3. snake_case - case-sensitive alphabetically
+ */
+export declare function sortV2Skills<T extends {
+    idn: string;
+}>(skills: T[]): T[];
+/**
+ * Sort parameters alphabetically by name (case-sensitive, V2 export order)
+ */
+export declare function sortV2Parameters<T extends {
+    name: string;
+}>(params: T[]): T[];
+export declare function parseV2FlowYaml(filePath: string): Promise<V2FlowDefinition>;
+/**
+ * Generate V2 flow YAML content from API data
+ *
+ * Produces the exact format found in the reference V2 export:
+ *   title, idn, description, agent_id, skills[], events[], state_fields[],
+ *   default_runner_type, default_provider_idn, default_model_idn, publication_type
+ */
+export declare function generateV2FlowYaml(flowIdn: string, flowTitle: string, flowDescription: string | null, defaultRunnerType: string, defaultProviderIdn: string, defaultModelIdn: string, skills: V2InlineSkill[], events: V2FlowEvent[], stateFields: V2StateField[]): string;
+export declare function parseV2ProjectYaml(filePath: string): Promise<V2ProjectMeta>;
+/**
+ * Generate V2 project YAML
+ *
+ * Format:
+ *   project:
+ *     idn: naf
+ *     name: naf
+ *     version: 4.1.0
+ *     description: ""
+ *     is_auto_update_enabled: true
+ *     registry: production
+ *     registry_item_idn: naf
+ */
+export declare function generateV2ProjectYaml(meta: V2ProjectMeta): string;
+export declare function parseV2AgentYaml(filePath: string): Promise<V2AgentMeta>;
+/**
+ * Generate V2 agent YAML
+ *
+ * Format:
+ *   agent:
+ *     idn: TaskManager
+ *     title: TaskManager
+ *     description: null
+ *
+ * V2 export preserves description exactly as provided (null stays null, "" stays "")
+ */
+export declare function generateV2AgentYaml(meta: V2AgentMeta): string;
+export declare function parseV2LibraryYaml(filePath: string): Promise<V2LibraryDefinition>;
+/**
+ * Generate V2 library YAML
+ *
+ * Format:
+ *   title: Test Library
+ *   idn: testLib
+ *   description: Shared utility library
+ *   skills:
+ *     - idn: utilSkill
+ *       ...
+ */
+export declare function generateV2LibraryYaml(lib: V2LibraryDefinition): string;
+/**
+ * Build a V2InlineSkill entry from API skill data
+ */
+export declare function buildV2InlineSkill(skillIdn: string, skillTitle: string, runnerType: string, modelIdn: string, providerIdn: string, parameters: Array<{
+    name: string;
+    default_value: string;
+}>, promptScriptRelPath: string): V2InlineSkill;
+/**
+ * Build a V2FlowEvent entry from API event data
+ */
+export declare function buildV2FlowEvent(eventIdn: string, skillSelector: string, skillIdn: string | null, stateIdn: string | null, integrationIdn: string | null, connectorIdn: string | null, interruptMode: string): V2FlowEvent;
+/**
+ * Build a V2StateField entry from API state data
+ */
+export declare function buildV2StateField(stateIdn: string, stateTitle: string, defaultValue: string, scope: string): V2StateField;
+//# sourceMappingURL=v2-yaml.d.ts.map