@framers/agentos 0.1.112 → 0.1.114

package/dist/api/agent.js

@@ -8,9 +8,10 @@
  * are not actively enforced in this lightweight layer — use the full AgentOS
  * runtime (`AgentOSOrchestrator`) or `agency()` for guardrail enforcement.
  */
-import { generateText } from './generateText.js';
+import { generateText, } from './generateText.js';
 import { streamText } from './streamText.js';
 import { getRecordedAgentOSUsage, } from './usageLedger.js';
+import { exportAgentConfig, exportAgentConfigJSON } from './agentExport.js';
 function mergeUsageLedgerOptions(...parts) {
     const merged = Object.assign({}, ...parts.filter(Boolean));
     return Object.keys(merged).length > 0 ? merged : undefined;
@@ -38,10 +39,10 @@ function buildSystemPrompt(opts) {
  *
  * The agent wraps {@link generateText} and {@link streamText} with a persistent
  * system prompt built from `instructions`, `name`, and `personality` fields.
- * Multiple independent sessions can be opened via {@link Agent.session}.
+ * Multiple independent sessions can be opened via `Agent.session()`.
  *
  * @param opts - Agent configuration including model, instructions, and optional tools.
- *   All {@link BaseAgentConfig} fields are accepted; advanced fields (rag, discovery,
+ *   All `BaseAgentConfig` fields are accepted; advanced fields (rag, discovery,
  *   permissions, emergent, voice, guardrails, etc.) are stored but not actively
  *   wired in the lightweight layer — they are consumed by `agency()` and the full runtime.
  * @returns An {@link Agent} instance with `generate`, `stream`, `session`, and `close` methods.
@@ -74,13 +75,15 @@ export function agent(opts) {
         baseUrl: opts.baseUrl,
         usageLedger: effectiveLedger,
     };
-    return {
+    const agentInstance = {
         async generate(prompt, extra) {
             return generateText({
                 ...baseOpts,
                 ...extra,
                 prompt,
-                usageLedger: mergeUsageLedgerOptions(baseOpts.usageLedger, extra?.usageLedger, { source: extra?.usageLedger?.source ?? 'agent.generate' }),
+                usageLedger: mergeUsageLedgerOptions(baseOpts.usageLedger, extra?.usageLedger, {
+                    source: extra?.usageLedger?.source ?? 'agent.generate',
+                }),
             });
         },
         stream(prompt, extra) {
@@ -88,7 +91,9 @@ export function agent(opts) {
                 ...baseOpts,
                 ...extra,
                 prompt,
-                usageLedger: mergeUsageLedgerOptions(baseOpts.usageLedger, extra?.usageLedger, { source: extra?.usageLedger?.source ?? 'agent.stream' }),
+                usageLedger: mergeUsageLedgerOptions(baseOpts.usageLedger, extra?.usageLedger, {
+                    source: extra?.usageLedger?.source ?? 'agent.stream',
+                }),
             });
         },
         session(id) {
@@ -105,7 +110,10 @@ export function agent(opts) {
                     const result = await generateText({
                         ...baseOpts,
                         messages: requestMessages,
-                        usageLedger: mergeUsageLedgerOptions(baseOpts.usageLedger, { sessionId, source: 'agent.session.send' }),
+                        usageLedger: mergeUsageLedgerOptions(baseOpts.usageLedger, {
+                            sessionId,
+                            source: 'agent.session.send',
+                        }),
                     });
                     if (useMemory) {
                         history.push({ role: 'user', content: text });
@@ -119,12 +127,19 @@ export function agent(opts) {
                         messages: useMemory
                             ? [...history, { role: 'user', content: text }]
                             : [{ role: 'user', content: text }],
-                        usageLedger: mergeUsageLedgerOptions(baseOpts.usageLedger, { sessionId, source: 'agent.session.stream' }),
+                        usageLedger: mergeUsageLedgerOptions(baseOpts.usageLedger, {
+                            sessionId,
+                            source: 'agent.session.stream',
+                        }),
                     });
                     // Capture text for history when done
                     if (useMemory) {
                         history.push({ role: 'user', content: text });
-                        void result.text.then((replyText) => history.push({ role: 'assistant', content: replyText })).catch(() => { });
+                        void result.text
+                            .then((replyText) => history.push({ role: 'assistant', content: replyText }))
+                            .catch(() => {
+                            /* history update failed, non-critical */
+                        });
                     }
                     return result;
                 },
@@ -153,6 +168,30 @@ export function agent(opts) {
         async close() {
             sessions.clear();
         },
+        /**
+         * Exports this agent's configuration as a portable object.
+         * @param metadata - Optional human-readable metadata to attach.
+         * @returns A portable {@link AgentExportConfig} object.
+         */
+        export(metadata) {
+            return exportAgentConfig(agentInstance, metadata);
+        },
+        /**
+         * Exports this agent's configuration as a pretty-printed JSON string.
+         * @param metadata - Optional human-readable metadata to attach.
+         * @returns JSON string with 2-space indentation.
+         */
+        exportJSON(metadata) {
+            return exportAgentConfigJSON(agentInstance, metadata);
+        },
     };
+    // Stash the original config as a non-enumerable property so that
+    // exportAgentConfig() can retrieve it without polluting the public API.
+    Object.defineProperty(agentInstance, '__config', {
+        value: opts,
+        enumerable: false,
+        configurable: true,
+    });
+    return agentInstance;
 }
 //# sourceMappingURL=agent.js.map

package/dist/api/agent.js.map

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

package/dist/api/agentExport.d.ts

@@ -0,0 +1,202 @@
+/**
+ * @fileoverview Agent configuration export/import for AgentOS.
+ * @module @framers/agentos/api/agentExport
+ *
+ * Provides portable serialization and deserialization of agent and agency
+ * configurations. Agents can be exported as JSON or YAML, transferred across
+ * environments, and re-imported to create identical agent instances.
+ *
+ * The export captures the full `BaseAgentConfig` surface — model, tools,
+ * personality, guardrails, memory, RAG, voice, channels, etc. — as well as
+ * agency-specific fields (sub-agent roster, strategy, rounds).
+ *
+ * Security note: API keys and base URLs are intentionally **included** in the
+ * export for self-contained portability. Callers that publish or share exports
+ * should strip sensitive fields first, or use `validateAgentExport()` to
+ * inspect the payload before distribution.
+ *
+ * @example
+ * ```ts
+ * import { agent } from '@framers/agentos';
+ * import { exportAgentConfig, importAgent, exportAgentConfigJSON } from '../api/agentExport';
+ *
+ * const myAgent = agent({ model: 'openai:gpt-4o', instructions: 'Be helpful.' });
+ * const json = exportAgentConfigJSON(myAgent);
+ *
+ * // Later, in another process:
+ * const restored = importAgentFromJSON(json);
+ * const reply = await restored.generate('Hello!');
+ * ```
+ */
+import type { BaseAgentConfig, AgencyStrategy, Agent } from './types.js';
+/**
+ * Portable agent configuration envelope.
+ *
+ * Wraps a `BaseAgentConfig` with version metadata, export timestamp,
+ * and type discriminator so import logic can reconstruct the correct agent
+ * variant (single agent vs. multi-agent agency).
+ */
+export interface AgentExportConfig {
+    /** Schema version for forward-compatible deserialization. */
+    version: '1.0.0';
+    /** ISO 8601 timestamp of when the export was created. */
+    exportedAt: string;
+    /**
+     * Discriminator: `'agent'` for a single-agent export, `'agency'` for
+     * a multi-agent export that includes a sub-agent roster.
+     */
+    type: 'agent' | 'agency';
+    /** The full agent configuration. */
+    config: BaseAgentConfig;
+    /** Sub-agent roster keyed by agent name. Present for agency exports. */
+    agents?: Record<string, BaseAgentConfig>;
+    /** Orchestration strategy. Present for agency exports. */
+    strategy?: AgencyStrategy;
+    /** Whether runtime strategy adaptation is enabled. */
+    adaptive?: boolean;
+    /** Maximum orchestration rounds for iterative strategies. */
+    maxRounds?: number;
+    /** Human-readable metadata about the export (name, author, tags, etc.). */
+    metadata?: {
+        /** Display name for the exported agent. */
+        name?: string;
+        /** Free-text description of what this agent does. */
+        description?: string;
+        /** Author identifier (person or system). */
+        author?: string;
+        /** Searchable tags for categorization. */
+        tags?: string[];
+    };
+}
+/**
+ * Exports an agent's configuration as a portable {@link AgentExportConfig} object.
+ *
+ * Captures the full `BaseAgentConfig` including model, instructions,
+ * personality, tools, guardrails, memory, RAG, voice, channels, and all
+ * other configuration surfaces. For agency instances, the sub-agent roster,
+ * strategy, and round limits are also included.
+ *
+ * @param agentInstance - The agent (or agency) instance to export.
+ * @param metadata - Optional human-readable metadata to attach to the export.
+ * @returns A portable config object that can be serialized to JSON or YAML.
+ *
+ * @example
+ * ```ts
+ * const config = exportAgentConfig(myAgent, {
+ *   name: 'Research Assistant',
+ *   author: 'team-alpha',
+ *   tags: ['research', 'summarization'],
+ * });
+ * ```
+ */
+export declare function exportAgentConfig(agentInstance: Agent, metadata?: AgentExportConfig['metadata']): AgentExportConfig;
+/**
+ * Exports an agent's configuration as a pretty-printed JSON string.
+ *
+ * @param agentInstance - The agent (or agency) instance to export.
+ * @param metadata - Optional human-readable metadata to attach.
+ * @returns JSON string with 2-space indentation.
+ *
+ * @example
+ * ```ts
+ * const json = exportAgentConfigJSON(myAgent);
+ * fs.writeFileSync('agent.json', json);
+ * ```
+ */
+export declare function exportAgentConfigJSON(agentInstance: Agent, metadata?: AgentExportConfig['metadata']): string;
+/**
+ * Exports an agent's configuration as a YAML string.
+ *
+ * Uses the `yaml` npm package for consistent, human-readable output.
+ *
+ * @param agentInstance - The agent (or agency) instance to export.
+ * @param metadata - Optional human-readable metadata to attach.
+ * @returns YAML-formatted string.
+ *
+ * @example
+ * ```ts
+ * const yamlStr = exportAgentConfigYAML(myAgent);
+ * fs.writeFileSync('agent.yaml', yamlStr);
+ * ```
+ */
+export declare function exportAgentConfigYAML(agentInstance: Agent, metadata?: AgentExportConfig['metadata']): string;
+/**
+ * Imports an agent from an {@link AgentExportConfig} object.
+ *
+ * For `type: 'agent'`, calls the `agent()` factory with the stored config.
+ * For `type: 'agency'`, calls the `agency()` factory with the stored config
+ * plus the sub-agent roster and strategy.
+ *
+ * The imported agent is a fully functional instance with `generate`, `stream`,
+ * `session`, and `close` methods.
+ *
+ * @param exportConfig - A validated export config object.
+ * @returns A new Agent instance constructed from the config.
+ *
+ * @throws {Error} If the config is invalid or missing required fields.
+ *
+ * @example
+ * ```ts
+ * const config = JSON.parse(fs.readFileSync('agent.json', 'utf-8'));
+ * const agent = importAgent(config);
+ * const reply = await agent.generate('Hello!');
+ * ```
+ */
+export declare function importAgent(exportConfig: AgentExportConfig): Agent;
+/**
+ * Imports an agent from a JSON string.
+ *
+ * Parses the string and delegates to {@link importAgent}.
+ *
+ * @param json - JSON string containing an {@link AgentExportConfig}.
+ * @returns A new Agent instance.
+ *
+ * @throws {SyntaxError} If the JSON is malformed.
+ * @throws {Error} If the parsed config fails validation.
+ *
+ * @example
+ * ```ts
+ * const agent = importAgentFromJSON(fs.readFileSync('agent.json', 'utf-8'));
+ * ```
+ */
+export declare function importAgentFromJSON(json: string): Agent;
+/**
+ * Imports an agent from a YAML string.
+ *
+ * Parses the string using the `yaml` npm package and delegates to
+ * {@link importAgent}.
+ *
+ * @param yamlStr - YAML string containing an {@link AgentExportConfig}.
+ * @returns A new Agent instance.
+ *
+ * @throws {Error} If the YAML is malformed or the config fails validation.
+ *
+ * @example
+ * ```ts
+ * const agent = importAgentFromYAML(fs.readFileSync('agent.yaml', 'utf-8'));
+ * ```
+ */
+export declare function importAgentFromYAML(yamlStr: string): Agent;
+/**
+ * Validates an export config object without importing it.
+ *
+ * Checks structural correctness: schema version, required fields, type
+ * discriminator, and agency-specific field consistency. Does NOT validate
+ * the semantic correctness of the config (e.g. whether the model exists).
+ *
+ * @param config - Unknown value to validate as an {@link AgentExportConfig}.
+ * @returns Object with `valid` boolean and an array of error messages.
+ *
+ * @example
+ * ```ts
+ * const result = validateAgentExport(someObject);
+ * if (!result.valid) {
+ *   console.error('Validation errors:', result.errors);
+ * }
+ * ```
+ */
+export declare function validateAgentExport(config: unknown): {
+    valid: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=agentExport.d.ts.map

package/dist/api/agentExport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentExport.d.ts","sourceRoot":"","sources":["../../src/api/agentExport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAiB,cAAc,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAMxF;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,OAAO,EAAE,OAAO,CAAC;IAEjB,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IAEzB,oCAAoC;IACpC,MAAM,EAAE,eAAe,CAAC;IAIxB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAEzC,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,cAAc,CAAC;IAE1B,sDAAsD;IACtD,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IAInB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE;QACT,2CAA2C;QAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,qDAAqD;QACrD,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,4CAA4C;QAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,0CAA0C;QAC1C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;CACH;AAsDD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,KAAK,EACpB,QAAQ,CAAC,EAAE,iBAAiB,CAAC,UAAU,CAAC,GACvC,iBAAiB,CA0BnB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,KAAK,EACpB,QAAQ,CAAC,EAAE,iBAAiB,CAAC,UAAU,CAAC,GACvC,MAAM,CAER;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,KAAK,EACpB,QAAQ,CAAC,EAAE,iBAAiB,CAAC,UAAU,CAAC,GACvC,MAAM,CAER;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,iBAAiB,GAAG,KAAK,CAiDlE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAGvD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAG1D;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAyDzF"}

package/dist/api/agentExport.js

@@ -0,0 +1,323 @@
+/**
+ * @fileoverview Agent configuration export/import for AgentOS.
+ * @module @framers/agentos/api/agentExport
+ *
+ * Provides portable serialization and deserialization of agent and agency
+ * configurations. Agents can be exported as JSON or YAML, transferred across
+ * environments, and re-imported to create identical agent instances.
+ *
+ * The export captures the full `BaseAgentConfig` surface — model, tools,
+ * personality, guardrails, memory, RAG, voice, channels, etc. — as well as
+ * agency-specific fields (sub-agent roster, strategy, rounds).
+ *
+ * Security note: API keys and base URLs are intentionally **included** in the
+ * export for self-contained portability. Callers that publish or share exports
+ * should strip sensitive fields first, or use `validateAgentExport()` to
+ * inspect the payload before distribution.
+ *
+ * @example
+ * ```ts
+ * import { agent } from '@framers/agentos';
+ * import { exportAgentConfig, importAgent, exportAgentConfigJSON } from '../api/agentExport.js';
+ *
+ * const myAgent = agent({ model: 'openai:gpt-4o', instructions: 'Be helpful.' });
+ * const json = exportAgentConfigJSON(myAgent);
+ *
+ * // Later, in another process:
+ * const restored = importAgentFromJSON(json);
+ * const reply = await restored.generate('Hello!');
+ * ```
+ */
+import YAML from 'yaml';
+import { agent as createAgent } from './agent.js';
+import { agency as createAgency } from './agency.js';
+// ============================================================================
+// EXPORT FUNCTIONS
+// ============================================================================
+/**
+ * Extracts the stored configuration from an Agent instance.
+ *
+ * The agent's config is captured at creation time by the `agent()` and
+ * `agency()` factories and attached as a non-enumerable `__config` property.
+ * If the property is absent (e.g. the agent was created by external code),
+ * we return an empty config.
+ *
+ * @param agentInstance - The agent to extract config from.
+ * @returns The stored BaseAgentConfig or an empty object.
+ */
+function extractConfig(agentInstance) {
+    // The __config property is set by our patched agent/agency factories
+    const config = agentInstance.__config;
+    if (config && typeof config === 'object') {
+        return config;
+    }
+    // Fallback: no stored config — return empty
+    return {};
+}
+/**
+ * Extracts agency-specific fields from an Agent instance that was created
+ * by the `agency()` factory.
+ *
+ * @param agentInstance - The agent/agency to extract from.
+ * @returns Agency fields if present, or undefined for plain agents.
+ */
+function extractAgencyFields(agentInstance) {
+    const raw = agentInstance.__agencyConfig;
+    if (raw && typeof raw === 'object') {
+        return raw;
+    }
+    return undefined;
+}
+/**
+ * Exports an agent's configuration as a portable {@link AgentExportConfig} object.
+ *
+ * Captures the full `BaseAgentConfig` including model, instructions,
+ * personality, tools, guardrails, memory, RAG, voice, channels, and all
+ * other configuration surfaces. For agency instances, the sub-agent roster,
+ * strategy, and round limits are also included.
+ *
+ * @param agentInstance - The agent (or agency) instance to export.
+ * @param metadata - Optional human-readable metadata to attach to the export.
+ * @returns A portable config object that can be serialized to JSON or YAML.
+ *
+ * @example
+ * ```ts
+ * const config = exportAgentConfig(myAgent, {
+ *   name: 'Research Assistant',
+ *   author: 'team-alpha',
+ *   tags: ['research', 'summarization'],
+ * });
+ * ```
+ */
+export function exportAgentConfig(agentInstance, metadata) {
+    const config = extractConfig(agentInstance);
+    const agencyFields = extractAgencyFields(agentInstance);
+    const isAgency = !!agencyFields?.agents;
+    const exportConfig = {
+        version: '1.0.0',
+        exportedAt: new Date().toISOString(),
+        type: isAgency ? 'agency' : 'agent',
+        config,
+    };
+    // Attach agency-specific fields when present
+    if (isAgency && agencyFields) {
+        exportConfig.agents = agencyFields.agents;
+        exportConfig.strategy = agencyFields.strategy;
+        exportConfig.adaptive = agencyFields.adaptive;
+        exportConfig.maxRounds = agencyFields.maxRounds;
+    }
+    if (metadata) {
+        exportConfig.metadata = metadata;
+    }
+    return exportConfig;
+}
+/**
+ * Exports an agent's configuration as a pretty-printed JSON string.
+ *
+ * @param agentInstance - The agent (or agency) instance to export.
+ * @param metadata - Optional human-readable metadata to attach.
+ * @returns JSON string with 2-space indentation.
+ *
+ * @example
+ * ```ts
+ * const json = exportAgentConfigJSON(myAgent);
+ * fs.writeFileSync('agent.json', json);
+ * ```
+ */
+export function exportAgentConfigJSON(agentInstance, metadata) {
+    return JSON.stringify(exportAgentConfig(agentInstance, metadata), null, 2);
+}
+/**
+ * Exports an agent's configuration as a YAML string.
+ *
+ * Uses the `yaml` npm package for consistent, human-readable output.
+ *
+ * @param agentInstance - The agent (or agency) instance to export.
+ * @param metadata - Optional human-readable metadata to attach.
+ * @returns YAML-formatted string.
+ *
+ * @example
+ * ```ts
+ * const yamlStr = exportAgentConfigYAML(myAgent);
+ * fs.writeFileSync('agent.yaml', yamlStr);
+ * ```
+ */
+export function exportAgentConfigYAML(agentInstance, metadata) {
+    return YAML.stringify(exportAgentConfig(agentInstance, metadata));
+}
+// ============================================================================
+// IMPORT FUNCTIONS
+// ============================================================================
+/**
+ * Imports an agent from an {@link AgentExportConfig} object.
+ *
+ * For `type: 'agent'`, calls the `agent()` factory with the stored config.
+ * For `type: 'agency'`, calls the `agency()` factory with the stored config
+ * plus the sub-agent roster and strategy.
+ *
+ * The imported agent is a fully functional instance with `generate`, `stream`,
+ * `session`, and `close` methods.
+ *
+ * @param exportConfig - A validated export config object.
+ * @returns A new Agent instance constructed from the config.
+ *
+ * @throws {Error} If the config is invalid or missing required fields.
+ *
+ * @example
+ * ```ts
+ * const config = JSON.parse(fs.readFileSync('agent.json', 'utf-8'));
+ * const agent = importAgent(config);
+ * const reply = await agent.generate('Hello!');
+ * ```
+ */
+export function importAgent(exportConfig) {
+    const validation = validateAgentExport(exportConfig);
+    if (!validation.valid) {
+        throw new Error(`Invalid agent export config: ${validation.errors.join('; ')}`);
+    }
+    if (exportConfig.type === 'agency' && exportConfig.agents) {
+        // Reconstruct an agency with its sub-agent roster
+        const agencyOpts = {
+            ...exportConfig.config,
+            agents: exportConfig.agents,
+            strategy: exportConfig.strategy,
+            adaptive: exportConfig.adaptive,
+            maxRounds: exportConfig.maxRounds,
+        };
+        const agencyInstance = createAgency(agencyOpts);
+        // Stash config for re-export round-tripping
+        Object.defineProperty(agencyInstance, '__config', {
+            value: exportConfig.config,
+            enumerable: false,
+            configurable: true,
+        });
+        Object.defineProperty(agencyInstance, '__agencyConfig', {
+            value: {
+                agents: exportConfig.agents,
+                strategy: exportConfig.strategy,
+                adaptive: exportConfig.adaptive,
+                maxRounds: exportConfig.maxRounds,
+            },
+            enumerable: false,
+            configurable: true,
+        });
+        return agencyInstance;
+    }
+    // Single agent
+    const agentInstance = createAgent(exportConfig.config);
+    // Stash config for re-export round-tripping
+    Object.defineProperty(agentInstance, '__config', {
+        value: exportConfig.config,
+        enumerable: false,
+        configurable: true,
+    });
+    return agentInstance;
+}
+/**
+ * Imports an agent from a JSON string.
+ *
+ * Parses the string and delegates to {@link importAgent}.
+ *
+ * @param json - JSON string containing an {@link AgentExportConfig}.
+ * @returns A new Agent instance.
+ *
+ * @throws {SyntaxError} If the JSON is malformed.
+ * @throws {Error} If the parsed config fails validation.
+ *
+ * @example
+ * ```ts
+ * const agent = importAgentFromJSON(fs.readFileSync('agent.json', 'utf-8'));
+ * ```
+ */
+export function importAgentFromJSON(json) {
+    const parsed = JSON.parse(json);
+    return importAgent(parsed);
+}
+/**
+ * Imports an agent from a YAML string.
+ *
+ * Parses the string using the `yaml` npm package and delegates to
+ * {@link importAgent}.
+ *
+ * @param yamlStr - YAML string containing an {@link AgentExportConfig}.
+ * @returns A new Agent instance.
+ *
+ * @throws {Error} If the YAML is malformed or the config fails validation.
+ *
+ * @example
+ * ```ts
+ * const agent = importAgentFromYAML(fs.readFileSync('agent.yaml', 'utf-8'));
+ * ```
+ */
+export function importAgentFromYAML(yamlStr) {
+    const parsed = YAML.parse(yamlStr);
+    return importAgent(parsed);
+}
+// ============================================================================
+// VALIDATION
+// ============================================================================
+/**
+ * Validates an export config object without importing it.
+ *
+ * Checks structural correctness: schema version, required fields, type
+ * discriminator, and agency-specific field consistency. Does NOT validate
+ * the semantic correctness of the config (e.g. whether the model exists).
+ *
+ * @param config - Unknown value to validate as an {@link AgentExportConfig}.
+ * @returns Object with `valid` boolean and an array of error messages.
+ *
+ * @example
+ * ```ts
+ * const result = validateAgentExport(someObject);
+ * if (!result.valid) {
+ *   console.error('Validation errors:', result.errors);
+ * }
+ * ```
+ */
+export function validateAgentExport(config) {
+    const errors = [];
+    if (!config || typeof config !== 'object') {
+        return { valid: false, errors: ['Config must be a non-null object'] };
+    }
+    const c = config;
+    // Version check
+    if (c.version !== '1.0.0') {
+        errors.push(`Unsupported version: ${String(c.version ?? 'missing')}. Expected "1.0.0".`);
+    }
+    // Type discriminator
+    if (c.type !== 'agent' && c.type !== 'agency') {
+        errors.push(`Invalid type: ${String(c.type ?? 'missing')}. Expected "agent" or "agency".`);
+    }
+    // exportedAt must be a string (ISO 8601)
+    if (typeof c.exportedAt !== 'string') {
+        errors.push('Missing or invalid "exportedAt" field. Expected an ISO 8601 string.');
+    }
+    // config must be an object
+    if (!c.config || typeof c.config !== 'object') {
+        errors.push('Missing or invalid "config" field. Expected an object.');
+    }
+    // Agency-specific: agents must be present when type is 'agency'
+    if (c.type === 'agency') {
+        if (!c.agents || typeof c.agents !== 'object' || Object.keys(c.agents).length === 0) {
+            errors.push('Agency export requires a non-empty "agents" roster.');
+        }
+        // Strategy, if present, must be a valid value
+        const validStrategies = new Set([
+            'sequential',
+            'parallel',
+            'debate',
+            'review-loop',
+            'hierarchical',
+            'graph',
+        ]);
+        if (c.strategy !== undefined && !validStrategies.has(c.strategy)) {
+            errors.push(`Invalid strategy: ${String(c.strategy)}. Expected one of: ${[...validStrategies].join(', ')}.`);
+        }
+    }
+    // Metadata validation (optional, but if present must be an object)
+    if (c.metadata !== undefined && (typeof c.metadata !== 'object' || c.metadata === null)) {
+        errors.push('"metadata" must be an object when present.');
+    }
+    return { valid: errors.length === 0, errors };
+}
+//# sourceMappingURL=agentExport.js.map