@framers/agentos 0.6.30 → 0.7.0

package/dist/cognition/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/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 '@framers/agentos/emergent/SkillExporter';
+ *
+ * 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/cognition/emergent/SkillExporter.js.map

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

package/dist/cognition/emergent/ToolPackage.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @fileoverview Portable export/import helpers for emergent tools.
+ * @module @framers/agentos/emergent/ToolPackage
+ */
+import type { EmergentTool, ToolTier, ToolUsageStats, ComposableToolSpec, SandboxAPI, CreationVerdict, PromotionVerdict } from './types.js';
+import type { JSONSchemaObject } from '../../core/tools/ITool.js';
+export declare const EMERGENT_TOOL_PACKAGE_SCHEMA_VERSION: "agentos.emergent-tool.v1";
+export interface PortableSandboxImplementation {
+    mode: 'sandbox';
+    allowlist: SandboxAPI[];
+    sourcePersisted: boolean;
+    redactedAtRest: boolean;
+    code?: string;
+}
+export type PortableToolImplementation = ComposableToolSpec | PortableSandboxImplementation;
+export interface EmergentToolPackageManifest {
+    schemaVersion: typeof EMERGENT_TOOL_PACKAGE_SCHEMA_VERSION;
+    packageType: 'emergent-tool';
+    exportedAt: string;
+    portability: {
+        portable: boolean;
+        warnings: string[];
+    };
+    tool: {
+        originalToolId: string;
+        originalTier: ToolTier;
+        name: string;
+        description: string;
+        inputSchema: JSONSchemaObject;
+        outputSchema: JSONSchemaObject;
+        implementation: PortableToolImplementation;
+        createdBy: string;
+        createdAt: string;
+        source: string;
+        judgeVerdicts: Array<CreationVerdict | PromotionVerdict>;
+        usageStats: ToolUsageStats;
+    };
+}
+export interface BuildEmergentToolPackageOptions {
+    exportedAt?: string;
+    includeJudgeVerdicts?: boolean;
+    includeUsageStats?: boolean;
+}
+export interface MaterializeEmergentToolFromPackageOptions {
+    createdBy: string;
+    tier?: ToolTier;
+    toolId?: string;
+    toolName?: string;
+    createdAt?: string;
+    preserveJudgeVerdicts?: boolean;
+    preserveUsageStats?: boolean;
+}
+export declare function buildEmergentToolPackage(tool: EmergentTool, options?: BuildEmergentToolPackageOptions): EmergentToolPackageManifest;
+export declare function serializeEmergentToolPackage(manifest: EmergentToolPackageManifest, format?: 'yaml' | 'json'): string;
+export declare function parseEmergentToolPackage(raw: string): EmergentToolPackageManifest;
+export declare function materializeEmergentToolFromPackage(manifest: EmergentToolPackageManifest, options: MaterializeEmergentToolFromPackageOptions): EmergentTool;
+//# sourceMappingURL=ToolPackage.d.ts.map

package/dist/cognition/emergent/ToolPackage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolPackage.d.ts","sourceRoot":"","sources":["../../../src/cognition/emergent/ToolPackage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,QAAQ,EACR,cAAc,EAEd,kBAAkB,EAClB,UAAU,EACV,eAAe,EACf,gBAAgB,EACjB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAGlE,eAAO,MAAM,oCAAoC,EAAG,0BAAmC,CAAC;AAExF,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,UAAU,EAAE,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;IACzB,cAAc,EAAE,OAAO,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,0BAA0B,GAClC,kBAAkB,GAClB,6BAA6B,CAAC;AAElC,MAAM,WAAW,2BAA2B;IAC1C,aAAa,EAAE,OAAO,oCAAoC,CAAC;IAC3D,WAAW,EAAE,eAAe,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE;QACX,QAAQ,EAAE,OAAO,CAAC;QAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,IAAI,EAAE;QACJ,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,QAAQ,CAAC;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,gBAAgB,CAAC;QAC9B,YAAY,EAAE,gBAAgB,CAAC;QAC/B,cAAc,EAAE,0BAA0B,CAAC;QAC3C,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,KAAK,CAAC,eAAe,GAAG,gBAAgB,CAAC,CAAC;QACzD,UAAU,EAAE,cAAc,CAAC;KAC5B,CAAC;CACH;AAED,MAAM,WAAW,+BAA+B;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,yCAAyC;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AA2DD,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,YAAY,EAClB,OAAO,GAAE,+BAAoC,GAC5C,2BAA2B,CA6B7B;AAED,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,2BAA2B,EACrC,MAAM,GAAE,MAAM,GAAG,MAAe,GAC/B,MAAM,CAKR;AAED,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,GACV,2BAA2B,CAiB7B;AAED,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,2BAA2B,EACrC,OAAO,EAAE,yCAAyC,GACjD,YAAY,CAkDd"}

package/dist/cognition/emergent/ToolPackage.js.map

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

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

@@ -0,0 +1,45 @@
+/**
+ * @fileoverview Emergent Capability Engine — public API barrel.
+ * @module @framers/agentos/emergent
+ *
+ * Re-exports all types, interfaces, and constants from the emergent module.
+ * Import from this barrel to avoid deep path coupling to internal files.
+ *
+ * @example
+ * ```ts
+ * import type { EmergentTool, ForgeToolRequest, DEFAULT_EMERGENT_CONFIG } from '@framers/agentos/emergent';
+ * ```
+ */
+export * from './types.js';
+export { type SelfImprovementConfig, DEFAULT_SELF_IMPROVEMENT_CONFIG } from './SelfImprovementConfig.js';
+export { ComposableToolBuilder } from './ComposableToolBuilder.js';
+export { SandboxedToolForge } from './SandboxedToolForge.js';
+export type { SandboxedToolForgeConfig } from './SandboxedToolForge.js';
+export { EmergentToolRegistry } from './EmergentToolRegistry.js';
+export type { IStorageAdapter as EmergentRegistryStorageAdapter, AuditEntry, } from './EmergentToolRegistry.js';
+export { EMERGENT_TOOL_PACKAGE_SCHEMA_VERSION, buildEmergentToolPackage, serializeEmergentToolPackage, parseEmergentToolPackage, materializeEmergentToolFromPackage, } from './ToolPackage.js';
+export type { PortableSandboxImplementation, PortableToolImplementation, EmergentToolPackageManifest, BuildEmergentToolPackageOptions, MaterializeEmergentToolFromPackageOptions, } from './ToolPackage.js';
+export { EmergentJudge } from './EmergentJudge.js';
+export type { ToolCandidate, EmergentJudgeConfig } from './EmergentJudge.js';
+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';
+export { AdaptPersonalityTool } from './AdaptPersonalityTool.js';
+export { ManageSkillsTool } from './ManageSkillsTool.js';
+export { CreateWorkflowTool } from './CreateWorkflowTool.js';
+export { SelfEvaluateTool } from './SelfEvaluateTool.js';
+export { PersonalityMutationStore } from './PersonalityMutationStore.js';
+export type { PersonalityMutation, RecordMutationInput, DecayResult } from './PersonalityMutationStore.js';
+export type { SelfImprovementToolDeps } from './EmergentCapabilityEngine.js';
+export { classifyForgeRejection, type ForgeRejectionCategory, } from './ForgeRejectionClassifier.js';
+export { validateForgeShape, type ForgeShapeRequest, } from './ForgeShapeValidator.js';
+export { inferSchemaFromTestCases, type ForgeSchemaInferenceRequest, } from './ForgeSchemaInference.js';
+export { wrapForgeTool, type CapturedForge, type ForgeLogEvent, type WrapForgeToolOptions, } from './wrapForgeTool.js';
+export { ForgeStatsAggregator, emptyForgeStats, type ForgeStats, } from './ForgeStatsAggregator.js';
+export { EmergentAgentForge } from './EmergentAgentForge.js';
+export type { AgentSpec, ForgeDefaults, ForgeResult, } from './EmergentAgentForge.js';
+export { EmergentAgentJudge } from './EmergentAgentJudge.js';
+export type { EmergentAgentJudgeConfig, AgentVerdict, JudgeGenerateText, } from './EmergentAgentJudge.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cognition/emergent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,KAAK,qBAAqB,EAAE,+BAA+B,EAAE,MAAM,4BAA4B,CAAC;AACzG,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;AAC5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC3G,YAAY,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAM7E,OAAO,EACL,sBAAsB,EACtB,KAAK,sBAAsB,GAC5B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,kBAAkB,EAClB,KAAK,iBAAiB,GACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,wBAAwB,EACxB,KAAK,2BAA2B,GACjC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,oBAAoB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,KAAK,UAAU,GAChB,MAAM,2BAA2B,CAAC;AAInC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EACV,SAAS,EACT,aAAa,EACb,WAAW,GACZ,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EACV,wBAAwB,EACxB,YAAY,EACZ,iBAAiB,GAClB,MAAM,yBAAyB,CAAC"}

package/dist/cognition/emergent/index.js

@@ -0,0 +1,41 @@
+/**
+ * @fileoverview Emergent Capability Engine — public API barrel.
+ * @module @framers/agentos/emergent
+ *
+ * Re-exports all types, interfaces, and constants from the emergent module.
+ * Import from this barrel to avoid deep path coupling to internal files.
+ *
+ * @example
+ * ```ts
+ * import type { EmergentTool, ForgeToolRequest, DEFAULT_EMERGENT_CONFIG } from '@framers/agentos/emergent';
+ * ```
+ */
+export * from './types.js';
+export { DEFAULT_SELF_IMPROVEMENT_CONFIG } from './SelfImprovementConfig.js';
+export { ComposableToolBuilder } from './ComposableToolBuilder.js';
+export { SandboxedToolForge } from './SandboxedToolForge.js';
+export { EmergentToolRegistry } from './EmergentToolRegistry.js';
+export { EMERGENT_TOOL_PACKAGE_SCHEMA_VERSION, buildEmergentToolPackage, serializeEmergentToolPackage, parseEmergentToolPackage, materializeEmergentToolFromPackage, } from './ToolPackage.js';
+export { EmergentJudge } from './EmergentJudge.js';
+export { EmergentCapabilityEngine } from './EmergentCapabilityEngine.js';
+export { ForgeToolMetaTool } from './ForgeToolMetaTool.js';
+export { exportToolAsSkill, buildCapabilityYaml, writeSkillFile, exportToolAsSkillPack, } from './SkillExporter.js';
+export { AdaptPersonalityTool } from './AdaptPersonalityTool.js';
+export { ManageSkillsTool } from './ManageSkillsTool.js';
+export { CreateWorkflowTool } from './CreateWorkflowTool.js';
+export { SelfEvaluateTool } from './SelfEvaluateTool.js';
+export { PersonalityMutationStore } from './PersonalityMutationStore.js';
+// Forge observability — instrumentation for consumers that want live
+// visibility into forge health (rejection-reason histogram, shape-check
+// pre-validator, schema inference from testCases, capture wrapper,
+// aggregator).
+export { classifyForgeRejection, } from './ForgeRejectionClassifier.js';
+export { validateForgeShape, } from './ForgeShapeValidator.js';
+export { inferSchemaFromTestCases, } from './ForgeSchemaInference.js';
+export { wrapForgeTool, } from './wrapForgeTool.js';
+export { ForgeStatsAggregator, emptyForgeStats, } from './ForgeStatsAggregator.js';
+// Emergent agent synthesis — used by the hierarchical strategy when
+// emergent.enabled is true to spawn new specialist sub-agents at runtime.
+export { EmergentAgentForge } from './EmergentAgentForge.js';
+export { EmergentAgentJudge } from './EmergentAgentJudge.js';
+//# sourceMappingURL=index.js.map

package/dist/cognition/emergent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cognition/emergent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAA8B,+BAA+B,EAAE,MAAM,4BAA4B,CAAC;AACzG,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;AAC5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAIzE,qEAAqE;AACrE,wEAAwE;AACxE,mEAAmE;AACnE,eAAe;AACf,OAAO,EACL,sBAAsB,GAEvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,kBAAkB,GAEnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,wBAAwB,GAEzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,aAAa,GAId,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,oBAAoB,EACpB,eAAe,GAEhB,MAAM,2BAA2B,CAAC;AAEnC,oEAAoE;AACpE,0EAA0E;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAM7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/cognition/emergent/sessionScope.d.ts

@@ -0,0 +1,10 @@
+import type { ToolExecutionContext } from '../../core/tools/ITool.js';
+/**
+ * Resolve a stable session key for self-improvement tools.
+ *
+ * Prefer explicit session-scoped identifiers when available so multiple tool
+ * calls in the same run share state, even if each call has a unique
+ * correlation ID.
+ */
+export declare function resolveSelfImprovementSessionKey(context: ToolExecutionContext): string;
+//# sourceMappingURL=sessionScope.d.ts.map

package/dist/cognition/emergent/sessionScope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionScope.d.ts","sourceRoot":"","sources":["../../../src/cognition/emergent/sessionScope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAWtE;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,oBAAoB,GAC5B,MAAM,CA2BR"}

package/dist/cognition/emergent/sessionScope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionScope.js","sourceRoot":"","sources":["../../../src/cognition/emergent/sessionScope.ts"],"names":[],"mappings":"AAEA,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,IAAI,SAAS,CAAC;AAC9B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gCAAgC,CAC9C,OAA6B;IAE7B,MAAM,SAAS,GAAG,cAAc,CAAC,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACjE,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,WAAW,SAAS,EAAE,CAAC;IAChC,CAAC;IAED,MAAM,cAAc,GAAG,cAAc,CAAC,OAAO,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAC3E,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,gBAAgB,cAAc,EAAE,CAAC;IAC1C,CAAC;IAED,MAAM,aAAa,GAAG,cAAc,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5D,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,eAAe,aAAa,EAAE,CAAC;IACxC,CAAC;IAED,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,OAAO,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,MAAM,SAAS,GAAG,cAAc,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACpD,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,WAAW,SAAS,EAAE,CAAC;IAChC,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}