@framers/agentos 0.1.113 → 0.1.114

package/dist/emergent/SkillExporter.d.ts

@@ -0,0 +1,119 @@
+/**
+ * @fileoverview Skill exporter for emergent tools.
+ * @module @framers/agentos/emergent/SkillExporter
+ *
+ * Converts runtime-forged {@link EmergentTool} instances into the standard
+ * SKILL.md + CAPABILITY.yaml format consumed by the agentos-skills-registry
+ * and the discovery capability manifest scanner.
+ *
+ * This enables emergent tools that have proven their worth (agent-tier or
+ * shared-tier) to be persisted as first-class skills, discoverable by the
+ * capability discovery engine alongside curated human-authored skills.
+ *
+ * Three export levels:
+ * - `exportToolAsSkill()` — pure in-memory string conversion to SKILL.md markdown
+ * - `writeSkillFile()` — writes a single SKILL.md to disk
+ * - `exportToolAsSkillPack()` — writes both SKILL.md and CAPABILITY.yaml (a full
+ *   capability directory ready for scanner pickup)
+ */
+import type { EmergentTool } from './types.js';
+/**
+ * Converts an {@link EmergentTool} into a SKILL.md markdown string.
+ *
+ * The generated SKILL.md follows the standard format used by the curated
+ * skills in `packages/agentos-skills-registry/registry/curated/`. It includes
+ * YAML frontmatter, a purpose section, usage guidance, a parameter table,
+ * and implementation notes.
+ *
+ * Sandbox tools receive a redaction notice instead of exposed source code —
+ * the SKILL.md documents the tool's interface without leaking runtime code.
+ *
+ * @param tool - The emergent tool to export.
+ * @returns Complete SKILL.md content as a string.
+ *
+ * @example
+ * ```ts
+ * import { exportToolAsSkill } from '../emergent/SkillExporter';
+ *
+ * const markdown = exportToolAsSkill(myEmergentTool);
+ * console.log(markdown);
+ * // ---
+ * // name: fetch-data
+ * // version: '1.0.0'
+ * // ...
+ * // ---
+ * // # Fetch Data
+ * // ...
+ * ```
+ */
+export declare function exportToolAsSkill(tool: EmergentTool): string;
+/**
+ * Builds a CAPABILITY.yaml content string for an emergent tool.
+ *
+ * The format matches the schema expected by the capability manifest scanner:
+ * ```yaml
+ * id: tool:<name>
+ * kind: tool
+ * name: <name>
+ * displayName: <Title Case Name>
+ * description: <description>
+ * category: emergent
+ * tags: [generated, ...]
+ * inputSchema: { ... }
+ * outputSchema: { ... }
+ * skillContent: ./SKILL.md
+ * ```
+ *
+ * @param tool - The emergent tool to export.
+ * @returns CAPABILITY.yaml content string.
+ */
+export declare function buildCapabilityYaml(tool: EmergentTool): string;
+/**
+ * Writes a SKILL.md file to disk for an emergent tool.
+ *
+ * Creates the output directory if it does not exist. The file is written to
+ * `<outputDir>/<tool.name>/SKILL.md`.
+ *
+ * @param tool - The emergent tool to export.
+ * @param outputDir - Base directory where the skill subdirectory will be created.
+ * @returns Absolute path to the written SKILL.md file.
+ *
+ * @throws {Error} If the filesystem write fails (permissions, disk full, etc.).
+ *
+ * @example
+ * ```ts
+ * const skillPath = await writeSkillFile(myTool, '/home/user/.wunderland/capabilities');
+ * // => "/home/user/.wunderland/capabilities/my-tool/SKILL.md"
+ * ```
+ */
+export declare function writeSkillFile(tool: EmergentTool, outputDir: string): Promise<string>;
+/**
+ * Exports an emergent tool as a full skill pack (SKILL.md + CAPABILITY.yaml).
+ *
+ * Creates a directory named after the tool under `outputDir`, containing both
+ * files. This directory structure is compatible with the
+ * capability manifest scanner and can be placed in any scan directory
+ * (`~/.wunderland/capabilities/`, `./.wunderland/capabilities/`, etc.) for
+ * automatic discovery.
+ *
+ * @param tool - The emergent tool to export.
+ * @param outputDir - Base directory where the skill subdirectory will be created.
+ * @returns Paths to the written SKILL.md and CAPABILITY.yaml files.
+ *
+ * @throws {Error} If the filesystem writes fail (permissions, disk full, etc.).
+ *
+ * @example
+ * ```ts
+ * const { skillPath, capabilityPath } = await exportToolAsSkillPack(
+ *   myTool,
+ *   '/home/user/.wunderland/capabilities',
+ * );
+ * // skillPath     => "/home/user/.wunderland/capabilities/my-tool/SKILL.md"
+ * // capabilityPath => "/home/user/.wunderland/capabilities/my-tool/CAPABILITY.yaml"
+ * ```
+ */
+export declare function exportToolAsSkillPack(tool: EmergentTool, outputDir: string): Promise<{
+    skillPath: string;
+    capabilityPath: string;
+}>;
+//# sourceMappingURL=SkillExporter.d.ts.map

package/dist/emergent/SkillExporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillExporter.d.ts","sourceRoot":"","sources":["../../src/emergent/SkillExporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAyC,MAAM,YAAY,CAAC;AAgGtF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAyH5D;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAoB9D;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS3F;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,YAAY,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAAC,CAiBxD"}

package/dist/emergent/SkillExporter.js

@@ -0,0 +1,344 @@
+/**
+ * @fileoverview Skill exporter for emergent tools.
+ * @module @framers/agentos/emergent/SkillExporter
+ *
+ * Converts runtime-forged {@link EmergentTool} instances into the standard
+ * SKILL.md + CAPABILITY.yaml format consumed by the agentos-skills-registry
+ * and the discovery capability manifest scanner.
+ *
+ * This enables emergent tools that have proven their worth (agent-tier or
+ * shared-tier) to be persisted as first-class skills, discoverable by the
+ * capability discovery engine alongside curated human-authored skills.
+ *
+ * Three export levels:
+ * - `exportToolAsSkill()` — pure in-memory string conversion to SKILL.md markdown
+ * - `writeSkillFile()` — writes a single SKILL.md to disk
+ * - `exportToolAsSkillPack()` — writes both SKILL.md and CAPABILITY.yaml (a full
+ *   capability directory ready for scanner pickup)
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import YAML from 'yaml';
+// ============================================================================
+// FRONTMATTER HELPERS
+// ============================================================================
+/**
+ * Derives a human-readable title from a tool's machine-readable name.
+ * Replaces underscores and hyphens with spaces, then title-cases each word.
+ *
+ * @param name - Machine-readable tool name (e.g. "fetch_github_pr_summary").
+ * @returns Title-cased display name (e.g. "Fetch Github Pr Summary").
+ *
+ * @example
+ * ```ts
+ * titleCase('fetch_github_pr_summary'); // "Fetch Github Pr Summary"
+ * ```
+ */
+function titleCase(name) {
+    return name.replace(/[-_]/g, ' ').replace(/\b\w/g, (c) => c.toUpperCase());
+}
+/**
+ * Extracts the list of sub-tool names required by a composable implementation.
+ * Sandboxed tools declare their API allowlist instead.
+ *
+ * @param impl - The tool's implementation specification.
+ * @returns Deduplicated array of required tool names.
+ */
+function extractRequiredTools(impl) {
+    if (impl.mode === 'compose') {
+        // Collect all unique tool names referenced across pipeline steps
+        const tools = new Set(impl.steps.map((s) => s.tool));
+        return [...tools];
+    }
+    // Sandbox tools don't depend on named tools — they have an API allowlist
+    return [];
+}
+/**
+ * Extracts tags from the tool's metadata and implementation mode.
+ * Always includes 'generated' and 'emergent' to distinguish forged skills
+ * from hand-authored ones.
+ *
+ * @param tool - The emergent tool to derive tags from.
+ * @returns Array of tag strings.
+ */
+function deriveTags(tool) {
+    const tags = new Set(['generated', 'emergent']);
+    tags.add(tool.implementation.mode);
+    tags.add(tool.tier);
+    return [...tags];
+}
+// ============================================================================
+// PARAMETER TABLE
+// ============================================================================
+/**
+ * Builds a markdown table describing the tool's input parameters from its
+ * JSON Schema `inputSchema`.
+ *
+ * Only processes top-level `properties` from an object schema. Nested schemas
+ * are represented as their `type` string with a note to see the full schema.
+ *
+ * @param schema - The tool's inputSchema (JSON Schema object).
+ * @returns Markdown table string, or empty string if no properties exist.
+ */
+function buildParameterTable(schema) {
+    const properties = schema.properties;
+    if (!properties || typeof properties !== 'object') {
+        return '';
+    }
+    const required = new Set(Array.isArray(schema.required) ? schema.required : []);
+    const rows = [];
+    rows.push('| Parameter | Type | Required | Description |');
+    rows.push('|-----------|------|----------|-------------|');
+    for (const [name, prop] of Object.entries(properties)) {
+        const p = prop;
+        const type = String(p.type ?? 'unknown');
+        const isRequired = required.has(name) ? 'Yes' : 'No';
+        const description = String(p.description ?? '');
+        rows.push(`| ${name} | ${type} | ${isRequired} | ${description} |`);
+    }
+    return rows.join('\n');
+}
+// ============================================================================
+// SKILL.md EXPORT
+// ============================================================================
+/**
+ * Converts an {@link EmergentTool} into a SKILL.md markdown string.
+ *
+ * The generated SKILL.md follows the standard format used by the curated
+ * skills in `packages/agentos-skills-registry/registry/curated/`. It includes
+ * YAML frontmatter, a purpose section, usage guidance, a parameter table,
+ * and implementation notes.
+ *
+ * Sandbox tools receive a redaction notice instead of exposed source code —
+ * the SKILL.md documents the tool's interface without leaking runtime code.
+ *
+ * @param tool - The emergent tool to export.
+ * @returns Complete SKILL.md content as a string.
+ *
+ * @example
+ * ```ts
+ * import { exportToolAsSkill } from '../emergent/SkillExporter.js';
+ *
+ * const markdown = exportToolAsSkill(myEmergentTool);
+ * console.log(markdown);
+ * // ---
+ * // name: fetch-data
+ * // version: '1.0.0'
+ * // ...
+ * // ---
+ * // # Fetch Data
+ * // ...
+ * ```
+ */
+export function exportToolAsSkill(tool) {
+    const tags = deriveTags(tool);
+    const requiredTools = extractRequiredTools(tool.implementation);
+    const displayName = titleCase(tool.name);
+    // -- YAML frontmatter --
+    const frontmatter = {
+        name: tool.name,
+        version: '1.0.0',
+        description: tool.description,
+        author: 'emergent-engine',
+        namespace: 'emergent',
+        category: 'emergent',
+        tags,
+        requires_secrets: [],
+        requires_tools: requiredTools,
+        metadata: {
+            agentos: {
+                tier: tool.tier,
+                createdBy: tool.createdBy,
+                createdAt: tool.createdAt,
+                mode: tool.implementation.mode,
+            },
+        },
+    };
+    // Serialize frontmatter with the yaml library for consistent formatting
+    const frontmatterYaml = YAML.stringify(frontmatter).trim();
+    // -- Body sections --
+    const sections = [];
+    sections.push(`# ${displayName}`);
+    sections.push('');
+    // Purpose
+    sections.push('## Purpose');
+    sections.push('');
+    sections.push(tool.description);
+    sections.push('');
+    // Usage
+    sections.push('## Usage');
+    sections.push('');
+    if (tool.implementation.mode === 'compose') {
+        const steps = tool.implementation.steps;
+        sections.push(`This tool is a composable pipeline of ${steps.length} step(s) that chains ` +
+            `the following tools in sequence: ${steps.map((s) => `\`${s.tool}\``).join(' -> ')}.`);
+    }
+    else {
+        // Sandbox tools — explain without exposing code
+        const sandbox = tool.implementation;
+        sections.push('This tool executes sandboxed code with the following API allowlist: ' +
+            `${sandbox.allowlist.map((a) => `\`${a}\``).join(', ')}.`);
+        sections.push('');
+        sections.push('> **Note:** Sandbox source code is redacted in the skill export for security. ' +
+            'The tool must be re-forged or the original sandbox source must be provided separately.');
+    }
+    sections.push('');
+    // Parameters
+    const paramTable = buildParameterTable(tool.inputSchema);
+    if (paramTable) {
+        sections.push('## Parameters');
+        sections.push('');
+        sections.push(paramTable);
+        sections.push('');
+    }
+    // Output schema
+    if (tool.outputSchema && Object.keys(tool.outputSchema).length > 0) {
+        sections.push('## Output');
+        sections.push('');
+        sections.push('```json');
+        sections.push(JSON.stringify(tool.outputSchema, null, 2));
+        sections.push('```');
+        sections.push('');
+    }
+    // Implementation details (for composable tools only — sandbox code is redacted)
+    if (tool.implementation.mode === 'compose') {
+        const steps = tool.implementation.steps;
+        sections.push('## Pipeline Steps');
+        sections.push('');
+        for (let i = 0; i < steps.length; i++) {
+            const step = steps[i];
+            sections.push(`${i + 1}. **${step.name}** — calls \`${step.tool}\``);
+            if (step.condition) {
+                sections.push(`   - Condition: \`${step.condition}\``);
+            }
+            const mappingEntries = Object.entries(step.inputMapping);
+            if (mappingEntries.length > 0) {
+                sections.push(`   - Input mapping: ${mappingEntries.map(([k, v]) => `\`${k}\` = \`${String(v)}\``).join(', ')}`);
+            }
+        }
+        sections.push('');
+    }
+    // Provenance
+    sections.push('## Provenance');
+    sections.push('');
+    sections.push(`- **Source:** ${tool.source}`);
+    sections.push(`- **Tier:** ${tool.tier}`);
+    sections.push(`- **Total uses:** ${tool.usageStats.totalUses}`);
+    sections.push(`- **Success rate:** ${tool.usageStats.totalUses > 0
+        ? ((tool.usageStats.successCount / tool.usageStats.totalUses) * 100).toFixed(1)
+        : '0.0'}%`);
+    sections.push(`- **Confidence:** ${tool.usageStats.confidenceScore.toFixed(2)}`);
+    sections.push('');
+    return `---\n${frontmatterYaml}\n---\n\n${sections.join('\n')}`;
+}
+// ============================================================================
+// CAPABILITY.yaml EXPORT
+// ============================================================================
+/**
+ * Builds a CAPABILITY.yaml content string for an emergent tool.
+ *
+ * The format matches the schema expected by the capability manifest scanner:
+ * ```yaml
+ * id: tool:<name>
+ * kind: tool
+ * name: <name>
+ * displayName: <Title Case Name>
+ * description: <description>
+ * category: emergent
+ * tags: [generated, ...]
+ * inputSchema: { ... }
+ * outputSchema: { ... }
+ * skillContent: ./SKILL.md
+ * ```
+ *
+ * @param tool - The emergent tool to export.
+ * @returns CAPABILITY.yaml content string.
+ */
+export function buildCapabilityYaml(tool) {
+    const tags = deriveTags(tool);
+    const manifest = {
+        id: `tool:${tool.name}`,
+        kind: 'tool',
+        name: tool.name,
+        displayName: titleCase(tool.name),
+        description: tool.description,
+        category: 'emergent',
+        tags,
+        requiredSecrets: [],
+        requiredTools: extractRequiredTools(tool.implementation),
+        inputSchema: tool.inputSchema,
+        outputSchema: tool.outputSchema,
+        // Relative path to the SKILL.md companion file in the same directory
+        skillContent: './SKILL.md',
+    };
+    return YAML.stringify(manifest);
+}
+// ============================================================================
+// FILE I/O
+// ============================================================================
+/**
+ * Writes a SKILL.md file to disk for an emergent tool.
+ *
+ * Creates the output directory if it does not exist. The file is written to
+ * `<outputDir>/<tool.name>/SKILL.md`.
+ *
+ * @param tool - The emergent tool to export.
+ * @param outputDir - Base directory where the skill subdirectory will be created.
+ * @returns Absolute path to the written SKILL.md file.
+ *
+ * @throws {Error} If the filesystem write fails (permissions, disk full, etc.).
+ *
+ * @example
+ * ```ts
+ * const skillPath = await writeSkillFile(myTool, '/home/user/.wunderland/capabilities');
+ * // => "/home/user/.wunderland/capabilities/my-tool/SKILL.md"
+ * ```
+ */
+export async function writeSkillFile(tool, outputDir) {
+    const skillDir = path.join(outputDir, tool.name);
+    await fs.mkdir(skillDir, { recursive: true });
+    const skillPath = path.join(skillDir, 'SKILL.md');
+    const content = exportToolAsSkill(tool);
+    await fs.writeFile(skillPath, content, 'utf-8');
+    return skillPath;
+}
+/**
+ * Exports an emergent tool as a full skill pack (SKILL.md + CAPABILITY.yaml).
+ *
+ * Creates a directory named after the tool under `outputDir`, containing both
+ * files. This directory structure is compatible with the
+ * capability manifest scanner and can be placed in any scan directory
+ * (`~/.wunderland/capabilities/`, `./.wunderland/capabilities/`, etc.) for
+ * automatic discovery.
+ *
+ * @param tool - The emergent tool to export.
+ * @param outputDir - Base directory where the skill subdirectory will be created.
+ * @returns Paths to the written SKILL.md and CAPABILITY.yaml files.
+ *
+ * @throws {Error} If the filesystem writes fail (permissions, disk full, etc.).
+ *
+ * @example
+ * ```ts
+ * const { skillPath, capabilityPath } = await exportToolAsSkillPack(
+ *   myTool,
+ *   '/home/user/.wunderland/capabilities',
+ * );
+ * // skillPath     => "/home/user/.wunderland/capabilities/my-tool/SKILL.md"
+ * // capabilityPath => "/home/user/.wunderland/capabilities/my-tool/CAPABILITY.yaml"
+ * ```
+ */
+export async function exportToolAsSkillPack(tool, outputDir) {
+    const skillDir = path.join(outputDir, tool.name);
+    await fs.mkdir(skillDir, { recursive: true });
+    // Write both files in parallel — they are independent
+    const skillContent = exportToolAsSkill(tool);
+    const capabilityContent = buildCapabilityYaml(tool);
+    const skillPath = path.join(skillDir, 'SKILL.md');
+    const capabilityPath = path.join(skillDir, 'CAPABILITY.yaml');
+    await Promise.all([
+        fs.writeFile(skillPath, skillContent, 'utf-8'),
+        fs.writeFile(capabilityPath, capabilityContent, 'utf-8'),
+    ]);
+    return { skillPath, capabilityPath };
+}
+//# sourceMappingURL=SkillExporter.js.map

package/dist/emergent/SkillExporter.js.map

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

package/dist/emergent/index.d.ts

@@ -24,4 +24,5 @@ export { EmergentCapabilityEngine } from './EmergentCapabilityEngine.js';
 export type { EmergentCapabilityEngineDeps } from './EmergentCapabilityEngine.js';
 export { ForgeToolMetaTool } from './ForgeToolMetaTool.js';
 export type { ForgeToolInput } from './ForgeToolMetaTool.js';
+export { exportToolAsSkill, buildCapabilityYaml, writeSkillFile, exportToolAsSkillPack, } from './SkillExporter.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/emergent/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/emergent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,YAAY,EACV,eAAe,IAAI,8BAA8B,EACjD,UAAU,GACX,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,oCAAoC,EACpC,wBAAwB,EACxB,4BAA4B,EAC5B,wBAAwB,EACxB,kCAAkC,GACnC,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,6BAA6B,EAC7B,0BAA0B,EAC1B,2BAA2B,EAC3B,+BAA+B,EAC/B,yCAAyC,GAC1C,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,YAAY,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/emergent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,YAAY,EACV,eAAe,IAAI,8BAA8B,EACjD,UAAU,GACX,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,oCAAoC,EACpC,wBAAwB,EACxB,4BAA4B,EAC5B,wBAAwB,EACxB,kCAAkC,GACnC,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,6BAA6B,EAC7B,0BAA0B,EAC1B,2BAA2B,EAC3B,+BAA+B,EAC/B,yCAAyC,GAC1C,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,YAAY,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,qBAAqB,GACtB,MAAM,oBAAoB,CAAC"}

package/dist/emergent/index.js

@@ -18,4 +18,5 @@ export { EMERGENT_TOOL_PACKAGE_SCHEMA_VERSION, buildEmergentToolPackage, seriali
 export { EmergentJudge } from './EmergentJudge.js';
 export { EmergentCapabilityEngine } from './EmergentCapabilityEngine.js';
 export { ForgeToolMetaTool } from './ForgeToolMetaTool.js';
+export { exportToolAsSkill, buildCapabilityYaml, writeSkillFile, exportToolAsSkillPack, } from './SkillExporter.js';
 //# sourceMappingURL=index.js.map

package/dist/emergent/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/emergent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAKjE,OAAO,EACL,oCAAoC,EACpC,wBAAwB,EACxB,4BAA4B,EAC5B,wBAAwB,EACxB,kCAAkC,GACnC,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/emergent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAKjE,OAAO,EACL,oCAAoC,EACpC,wBAAwB,EACxB,4BAA4B,EAC5B,wBAAwB,EACxB,kCAAkC,GACnC,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,qBAAqB,GACtB,MAAM,oBAAoB,CAAC"}

package/dist/emergent/types.d.ts

@@ -59,7 +59,7 @@ export interface ComposableStep {
     name: string;
     /**
      * The registered tool name to invoke for this step.
-     * Must match the `name` property of an {@link ITool} available to the agent.
+     * Must match the `name` property of an `ITool` available to the agent.
      * @example "web_search"
      */
     tool: string;
@@ -139,7 +139,7 @@ export type ToolImplementation = ComposableToolSpec | SandboxedToolSpec;
  */
 export interface SandboxExecutionRequest {
     /**
-     * Source code of the sandboxed module (same format as {@link SandboxedToolSpec.code}).
+     * Source code of the sandboxed module (same format as `SandboxedToolSpec.code`).
      */
     code: string;
     /**
@@ -574,13 +574,13 @@ export interface EmergentConfig {
     persistSandboxSource: boolean;
     /**
      * Memory limit in megabytes for each sandboxed tool execution.
-     * Passed as {@link SandboxExecutionRequest.memoryMB}.
+     * Passed as `SandboxExecutionRequest.memoryMB`.
      * @default 128
      */
     sandboxMemoryMB: number;
     /**
      * Wall-clock timeout in milliseconds for each sandboxed tool execution.
-     * Passed as {@link SandboxExecutionRequest.timeoutMs}.
+     * Passed as `SandboxExecutionRequest.timeoutMs`.
      * @default 5000
      */
     sandboxTimeoutMs: number;

package/dist/index.d.ts

@@ -7,9 +7,11 @@ export * from './api/AgentOS.js';
 export * from './api/AgentOSOrchestrator';
 export * from './api/types/AgentOSInput';
 export * from './api/types/AgentOSResponse';
+export * from './api/types/AgentOSExternalToolRequest';
+export * from './api/types/AgentOSToolResult';
 export * from './cognitive_substrate/IGMI';
 export * from './cognitive_substrate/GMIManager';
-export type { ITool, ToolExecutionResult, ToolExecutionContext, JSONSchemaObject } from './core/tools/ITool';
+export type { ITool, ToolExecutionResult, ToolExecutionContext, JSONSchemaObject, } from './core/tools/ITool';
 export * from './core/llm/IPromptEngine';
 export * from './config/ToolOrchestratorConfig';
 export * from './core/tools/permissions/IToolPermissionManager';
@@ -51,6 +53,9 @@ export * from './channels';
 export * from './voice';
 export * from './speech';
 export * from './core/images';
+export { VisionPipeline, createVisionPipeline, LLMVisionProvider, PipelineVisionProvider } from './core/vision/index.js';
+export type { VisionPipelineConfig, VisionResult, VisionStrategy, VisionTier, ContentCategory as VisionContentCategory, TierResult as VisionTierResult, TextRegion as VisionTextRegion, DocumentLayout, DocumentPage, LayoutBlock, VisionPreprocessingConfig, } from './core/vision/types.js';
+export type { LLMVisionProviderConfig } from './core/vision/providers/LLMVisionProvider.js';
 export * from './skills';
 export * from './core/language/interfaces';
 export * from './core/language/LanguageService';
@@ -61,30 +66,50 @@ export * from './core/storage';
 export * from './core/usage/UsageLedger';
 export * from './rag';
 export * from './memory';
+export { QueryClassifier, QueryDispatcher, QueryGenerator, QueryRouter, TopicExtractor, KeywordFallback, } from './query-router/index.js';
+export type { QueryTier, ClassificationResult, RetrievedChunk, SourceCitation, RetrievalResult, ConversationMessage, QueryRouterConfig, ClassifyStartEvent, ClassifyCompleteEvent, ClassifyErrorEvent, RetrieveStartEvent, RetrieveVectorEvent, RetrieveGraphEvent, RetrieveRerankEvent, RetrieveCompleteEvent, RetrieveFallbackEvent, ResearchStartEvent, ResearchPhaseEvent, ResearchCompleteEvent, GenerateStartEvent, GenerateCompleteEvent, RouteCompleteEvent, QueryRouterEventUnion, CorpusChunk, TopicEntry, QueryResult as QueryRouterResult, } from './query-router/types.js';
 export * from './orchestration/index.js';
 export * from './core/provenance';
 export * from './core/safety';
 export * from './emergent/index.js';
 export { EXTENSION_SECRET_DEFINITIONS, type ExtensionSecretDefinition, getSecretDefinition, resolveSecretForProvider, } from './config/extensionSecrets.js';
 export { generateText } from './api/generateText.js';
-export type { GenerateTextOptions, GenerateTextResult, Message, ToolCallRecord, TokenUsage } from './api/generateText.js';
+export type { GenerateTextOptions, GenerateTextResult, Message, ToolCallRecord, TokenUsage, } from './api/generateText.js';
 export { streamText } from './api/streamText.js';
 export type { StreamTextResult, StreamPart } from './api/streamText.js';
 export { agent } from './api/agent.js';
 export type { Agent, AgentSession, AgentOptions } from './api/agent.js';
 export { agency } from './api/agency.js';
+export { exportAgentConfig, exportAgentConfigJSON, exportAgentConfigYAML, importAgent, importAgentFromJSON, importAgentFromYAML, validateAgentExport, } from './api/agentExport.js';
+export type { AgentExportConfig } from './api/agentExport.js';
 export { hitl } from './api/hitl.js';
 export type { HitlHandler } from './api/hitl.js';
+export * from './api/processRequestWithExternalTools.js';
+export * from './api/externalToolRegistry.js';
+export * from './api/processRequestWithRegisteredTools.js';
+export * from './api/resumeExternalToolRequestWithRegisteredTools.js';
 export type { AgencyOptions, AgencyStrategy, AgencyConfigError as AgencyConfigErrorType, AgencyCallbacks, AgencyStreamPart, AgencyTraceEvent, AgentCallRecord, ApprovalRequest, ApprovalDecision, ResourceControls, HitlConfig, CompiledStrategy, Agency, } from './api/types.js';
 export { AgencyConfigError } from './api/types.js';
 export { generateImage } from './api/generateImage.js';
 export type { GenerateImageOptions, GenerateImageResult } from './api/generateImage.js';
-export { parseModelString, resolveProvider, resolveModelOption, } from './api/model.js';
+export { editImage } from './api/editImage.js';
+export type { EditImageOptions, EditImageResult } from './api/editImage.js';
+export { upscaleImage } from './api/upscaleImage.js';
+export type { UpscaleImageOptions, UpscaleImageResult } from './api/upscaleImage.js';
+export { variateImage } from './api/variateImage.js';
+export type { VariateImageOptions, VariateImageResult } from './api/variateImage.js';
+export { generateObject, ObjectGenerationError } from './api/generateObject.js';
+export type { GenerateObjectOptions, GenerateObjectResult } from './api/generateObject.js';
+export { streamObject } from './api/streamObject.js';
+export type { StreamObjectOptions, StreamObjectResult, DeepPartial } from './api/streamObject.js';
+export { embedText } from './api/embedText.js';
+export type { EmbedTextOptions, EmbedTextResult } from './api/embedText.js';
+export { parseModelString, resolveProvider, resolveModelOption } from './api/model.js';
 export { PROVIDER_DEFAULTS, autoDetectProvider } from './api/provider-defaults.js';
 export type { ProviderDefaults } from './api/provider-defaults.js';
 export type { TaskType, ModelOption } from './api/model.js';
-export { adaptTools } from './api/toolAdapter.js';
-export type { ToolDefinitionMap } from './api/toolAdapter.js';
+export { adaptTools, adaptToolsToMap, mergeAdaptableTools } from './api/toolAdapter.js';
+export type { AdaptableToolInput, ToolDefinitionMap } from './api/toolAdapter.js';
 export { getDefaultAgentOSUsageLedgerPath, resolveAgentOSUsageLedgerPath, readRecordedAgentOSUsageEvents, recordAgentOSUsage, getRecordedAgentOSUsage, clearRecordedAgentOSUsage, } from './api/usageLedger.js';
 export type { AgentOSUsageLedgerOptions, AgentOSUsageEvent, AgentOSUsageRecordInput, AgentOSUsageAggregate, } from './api/usageLedger.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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