@dcyfr/ai 3.0.0 → 3.0.2

package/dist/ai/metacognition/telemetry.js

@@ -0,0 +1,149 @@
+/**
+ * Metacognitive Improvement — Structured Telemetry
+ * TLP:AMBER - Internal Use Only
+ *
+ * Emits structured telemetry events for the metacognitive improvement lifecycle.
+ * Tracks proposal throughput, approval ratio, and rollback rate.
+ *
+ * The telemetry system is intentionally thin and side-effect-free:
+ * - Events are emitted to registered sinks (console, remote, in-memory).
+ * - Sinks are async and non-blocking; errors are caught and ignored.
+ * - The default sink writes structured JSON to stdout (compatible with log aggregators).
+ *
+ * @module ai/metacognition/telemetry
+ */
+// ---------------------------------------------------------------------------
+// MetacogTelemetryEmitter
+// ---------------------------------------------------------------------------
+/**
+ * Emits structured telemetry events and aggregates running metrics.
+ *
+ * Usage:
+ * ```typescript
+ * const emitter = new MetacogTelemetryEmitter([consoleSink]);
+ * emitter.proposalSubmitted({ proposal_id, actor, domain, ... });
+ * const metrics = emitter.getMetrics();
+ * ```
+ */
+export class MetacogTelemetryEmitter {
+    sinks;
+    counts = {
+        submitted: 0,
+        evaluatedPass: 0,
+        evaluatedFail: 0,
+        approved: 0,
+        applied: 0,
+        rolledBack: 0,
+    };
+    constructor(sinks = [defaultConsoleSink]) {
+        this.sinks = sinks;
+    }
+    // -------------------------------------------------------------------------
+    // Emit helpers
+    // -------------------------------------------------------------------------
+    proposalSubmitted(fields) {
+        this.counts.submitted++;
+        this.emit({ event: 'metacog.proposal.submitted', timestamp: now(), ...fields });
+    }
+    proposalEvaluated(fields) {
+        if (fields.passed)
+            this.counts.evaluatedPass++;
+        else
+            this.counts.evaluatedFail++;
+        this.emit({ event: 'metacog.proposal.evaluated', timestamp: now(), ...fields });
+    }
+    proposalApproved(fields) {
+        this.counts.approved++;
+        this.emit({ event: 'metacog.proposal.approved', timestamp: now(), ...fields });
+    }
+    proposalRejected(fields) {
+        this.counts.evaluatedFail++;
+        this.emit({ event: 'metacog.proposal.rejected', timestamp: now(), ...fields });
+    }
+    proposalApplied(fields) {
+        this.counts.applied++;
+        this.emit({ event: 'metacog.proposal.applied', timestamp: now(), ...fields });
+    }
+    proposalRolledBack(fields) {
+        this.counts.rolledBack++;
+        this.emit({ event: 'metacog.proposal.rolled_back', timestamp: now(), ...fields });
+    }
+    transferEvaluated(fields) {
+        this.emit({ event: 'metacog.transfer.evaluated', timestamp: now(), ...fields });
+    }
+    // -------------------------------------------------------------------------
+    // Metrics
+    // -------------------------------------------------------------------------
+    /**
+     * Return computed metrics from all events observed since construction.
+     */
+    getMetrics() {
+        const { submitted, evaluatedPass, evaluatedFail, approved, applied, rolledBack } = this.counts;
+        return {
+            proposals_submitted: submitted,
+            proposals_evaluated_pass: evaluatedPass,
+            proposals_evaluated_fail: evaluatedFail,
+            proposals_approved: approved,
+            proposals_applied: applied,
+            proposals_rolled_back: rolledBack,
+            approval_ratio: submitted > 0 ? approved / submitted : null,
+            rollback_rate: applied > 0 ? rolledBack / applied : null,
+        };
+    }
+    /** Reset all counters (useful for time-windowed metrics). */
+    resetMetrics() {
+        this.counts = {
+            submitted: 0, evaluatedPass: 0, evaluatedFail: 0,
+            approved: 0, applied: 0, rolledBack: 0,
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Internal
+    // -------------------------------------------------------------------------
+    emit(event) {
+        for (const sink of this.sinks) {
+            try {
+                const result = sink(event);
+                if (result instanceof Promise) {
+                    result.catch(() => { });
+                }
+            }
+            catch {
+                // Sinks must not crash the runtime
+            }
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Built-in sinks
+// ---------------------------------------------------------------------------
+/**
+ * Default sink: writes structured JSON to stdout.
+ * Compatible with log aggregators that parse JSON lines.
+ */
+export const defaultConsoleSink = (event) => {
+    console.log(JSON.stringify(event));
+};
+/**
+ * In-memory sink: collects events for test assertions.
+ */
+export class InMemoryTelemetrySink {
+    events = [];
+    sink = (event) => {
+        this.events.push(event);
+    };
+    /** Filter events by type. */
+    byType(type) {
+        return this.events.filter((e) => e.event === type);
+    }
+    clear() {
+        this.events.length = 0;
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function now() {
+    return new Date().toISOString();
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/ai/metacognition/telemetry.js.map

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

package/dist/ai/metacognition/transfer.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Cross-Domain Transfer Evaluation Pipeline
+ * TLP:AMBER - Internal Use Only
+ *
+ * Implements the transfer evaluation contract and gate logic for
+ * cross-domain promotion of improvement proposals.
+ *
+ * Pipeline:
+ *   1. Evaluate proposal in source domain (caller's responsibility).
+ *   2. Call evaluateTransfer() to run target-domain evaluation.
+ *   3. Transfer is allowed only when score ≥ threshold AND regression
+ *      budget is not exceeded.
+ *
+ * @module ai/metacognition/transfer
+ */
+import type { BenchmarkResult, ImprovementProposal } from './types.js';
+/**
+ * A domain definition for transfer evaluation.
+ * Each domain exposes named benchmarks that proposals must satisfy.
+ */
+export interface DomainDefinition {
+    /** Unique domain identifier. Must match domains referenced in proposals. */
+    domain_id: string;
+    /** Human-readable name. */
+    name: string;
+    /** Registered benchmarks available in this domain. */
+    benchmarks: BenchmarkDefinition[];
+}
+/** A single named benchmark within a domain. */
+export interface BenchmarkDefinition {
+    /** Unique within the domain. */
+    benchmark_id: string;
+    /** Human-readable description of what this benchmark measures. */
+    description: string;
+    /**
+     * Minimum score (0.0–1.0) for this benchmark to count as passing.
+     * A result with score >= pass_threshold is considered a pass.
+     */
+    pass_threshold: number;
+    /**
+     * Whether a failure on this benchmark is blocking regardless of
+     * aggregate score or regression budget. Safety/security gates should
+     * set this to true.
+     */
+    blocking: boolean;
+}
+/**
+ * Input to the transfer evaluation gate.
+ * Carries the proposal being evaluated, the source domain's baseline results,
+ * and the target domain configuration.
+ */
+export interface TransferEvaluationInput {
+    proposal: ImprovementProposal;
+    /** Domain the improvement was originally developed in. */
+    source_domain: DomainDefinition;
+    /** Domain the improvement is being promoted to. */
+    target_domain: DomainDefinition;
+    /**
+     * Baseline benchmark results for the target domain
+     * (measured before this proposal was applied).
+     */
+    target_baseline: BaselineRecord[];
+    /**
+     * Minimum aggregate transfer score (0.0–1.0) required for promotion.
+     * Defaults to the proposal's evaluation_criteria.success_threshold.
+     */
+    score_threshold?: number;
+    /**
+     * Maximum fraction of benchmarks allowed to regress (0.0–1.0).
+     * Defaults to the proposal's evaluation_criteria.regression_budget.
+     */
+    regression_budget?: number;
+}
+/** A baseline measurement for a single benchmark in a domain. */
+export interface BaselineRecord {
+    domain_id: string;
+    benchmark_id: string;
+    baseline_score: number;
+    measured_at: string;
+}
+/**
+ * Transfer score and promotion decision for a single proposal.
+ */
+export interface TransferEvaluationResult {
+    proposal_id: string;
+    source_domain_id: string;
+    target_domain_id: string;
+    evaluated_at: string;
+    /** Aggregate transfer score across all target-domain benchmarks (0.0–1.0). */
+    transfer_score: number;
+    /** Score threshold that was applied. */
+    score_threshold: number;
+    /** Whether the transfer score meets the threshold. */
+    score_passed: boolean;
+    /** Whether any benchmark regressed beyond the regression budget. */
+    regression_budget_exceeded: boolean;
+    /** Fraction of benchmarks that regressed. */
+    regression_fraction: number;
+    /** True only when score_passed AND NOT regression_budget_exceeded AND no blocking failures. */
+    transferable: boolean;
+    /** Per-benchmark results in the target domain. */
+    benchmark_results: BenchmarkResult[];
+    /** IDs of blocking benchmarks that failed. */
+    blocking_failures: string[];
+    /** Human-readable explanation of the promotion decision. */
+    decision_reason: string;
+}
+/**
+ * Interface for running benchmarks in a domain.
+ * Implementations provide domain-specific evaluation logic.
+ */
+export interface BenchmarkRunner {
+    domain_id: string;
+    /**
+     * Run a single benchmark against the proposed policy changes.
+     * Returns the achieved score (0.0–1.0).
+     */
+    runBenchmark(benchmark_id: string, proposal: ImprovementProposal): Promise<number>;
+}
+/**
+ * Evaluate whether an improvement proposal is transferable to a target domain.
+ *
+ * Algorithm:
+ *   1. For each benchmark in target domain, run evaluation via `runner`.
+ *   2. Compute delta vs baseline: negative delta = regression.
+ *   3. Check for blocking failures (regardless of aggregate score).
+ *   4. Compute regression fraction vs regression_budget.
+ *   5. Compute aggregate transfer score.
+ *   6. transferable = score_passed AND NOT budget_exceeded AND no blocking failures.
+ *
+ * @param input - Transfer evaluation configuration and baselines.
+ * @param runner - Domain-specific benchmark runner for the target domain.
+ */
+export declare function evaluateTransfer(input: TransferEvaluationInput, runner: BenchmarkRunner): Promise<TransferEvaluationResult>;
+/** Thrown when transfer evaluation configuration is invalid. */
+export declare class TransferEvaluationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Domain A: scoring_strategy
+ * Representative benchmarks for a scoring-weight policy domain.
+ */
+export declare const SCORING_STRATEGY_DOMAIN: DomainDefinition;
+/**
+ * Domain B: delegation_thresholds
+ * Representative benchmarks for a delegation-threshold policy domain.
+ */
+export declare const DELEGATION_THRESHOLDS_DOMAIN: DomainDefinition;
+/** Pre-measured baselines for the scoring_strategy domain. */
+export declare const SCORING_STRATEGY_BASELINES: BaselineRecord[];
+/** Pre-measured baselines for the delegation_thresholds domain. */
+export declare const DELEGATION_THRESHOLDS_BASELINES: BaselineRecord[];
+//# sourceMappingURL=transfer.d.ts.map

package/dist/ai/metacognition/transfer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer.d.ts","sourceRoot":"","sources":["../../../packages/ai/metacognition/transfer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAMvE;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAC;IAElB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IAEb,sDAAsD;IACtD,UAAU,EAAE,mBAAmB,EAAE,CAAC;CACnC;AAED,gDAAgD;AAChD,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IAErB,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,mBAAmB,CAAC;IAE9B,0DAA0D;IAC1D,aAAa,EAAE,gBAAgB,CAAC;IAEhC,mDAAmD;IACnD,aAAa,EAAE,gBAAgB,CAAC;IAEhC;;;OAGG;IACH,eAAe,EAAE,cAAc,EAAE,CAAC;IAElC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,iEAAiE;AACjE,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IAEzB,YAAY,EAAE,MAAM,CAAC;IAErB,8EAA8E;IAC9E,cAAc,EAAE,MAAM,CAAC;IAEvB,wCAAwC;IACxC,eAAe,EAAE,MAAM,CAAC;IAExB,sDAAsD;IACtD,YAAY,EAAE,OAAO,CAAC;IAEtB,oEAAoE;IACpE,0BAA0B,EAAE,OAAO,CAAC;IAEpC,6CAA6C;IAC7C,mBAAmB,EAAE,MAAM,CAAC;IAE5B,+FAA+F;IAC/F,YAAY,EAAE,OAAO,CAAC;IAEtB,kDAAkD;IAClD,iBAAiB,EAAE,eAAe,EAAE,CAAC;IAErC,8CAA8C;IAC9C,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAE5B,4DAA4D;IAC5D,eAAe,EAAE,MAAM,CAAC;CACzB;AAMD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,YAAY,CACV,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,mBAAmB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAAC;CACpB;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,uBAAuB,EAC9B,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,wBAAwB,CAAC,CAgFnC;AA4BD,gEAAgE;AAChE,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM;CAI5B;AAMD;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,gBAuBrC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,4BAA4B,EAAE,gBAuB1C,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,0BAA0B,EAAE,cAAc,EAItD,CAAC;AAEF,mEAAmE;AACnE,eAAO,MAAM,+BAA+B,EAAE,cAAc,EAI3D,CAAC"}

package/dist/ai/metacognition/transfer.js

@@ -0,0 +1,182 @@
+/**
+ * Cross-Domain Transfer Evaluation Pipeline
+ * TLP:AMBER - Internal Use Only
+ *
+ * Implements the transfer evaluation contract and gate logic for
+ * cross-domain promotion of improvement proposals.
+ *
+ * Pipeline:
+ *   1. Evaluate proposal in source domain (caller's responsibility).
+ *   2. Call evaluateTransfer() to run target-domain evaluation.
+ *   3. Transfer is allowed only when score ≥ threshold AND regression
+ *      budget is not exceeded.
+ *
+ * @module ai/metacognition/transfer
+ */
+// ---------------------------------------------------------------------------
+// Transfer gate logic (task 3.2)
+// ---------------------------------------------------------------------------
+/**
+ * Evaluate whether an improvement proposal is transferable to a target domain.
+ *
+ * Algorithm:
+ *   1. For each benchmark in target domain, run evaluation via `runner`.
+ *   2. Compute delta vs baseline: negative delta = regression.
+ *   3. Check for blocking failures (regardless of aggregate score).
+ *   4. Compute regression fraction vs regression_budget.
+ *   5. Compute aggregate transfer score.
+ *   6. transferable = score_passed AND NOT budget_exceeded AND no blocking failures.
+ *
+ * @param input - Transfer evaluation configuration and baselines.
+ * @param runner - Domain-specific benchmark runner for the target domain.
+ */
+export async function evaluateTransfer(input, runner) {
+    if (runner.domain_id !== input.target_domain.domain_id) {
+        throw new TransferEvaluationError(`Runner domain "${runner.domain_id}" does not match target domain "${input.target_domain.domain_id}"`);
+    }
+    const scoreThreshold = input.score_threshold ?? input.proposal.evaluation_criteria.success_threshold;
+    const regressionBudget = input.regression_budget ?? input.proposal.evaluation_criteria.regression_budget;
+    const baselineMap = new Map();
+    for (const b of input.target_baseline) {
+        if (b.domain_id === input.target_domain.domain_id) {
+            baselineMap.set(b.benchmark_id, b.baseline_score);
+        }
+    }
+    const benchmarkResults = [];
+    const blockingFailures = [];
+    for (const bench of input.target_domain.benchmarks) {
+        const score = await runner.runBenchmark(bench.benchmark_id, input.proposal);
+        const baselineScore = baselineMap.get(bench.benchmark_id) ?? 0;
+        const delta = score - baselineScore;
+        const passed = score >= bench.pass_threshold;
+        benchmarkResults.push({
+            domain: input.target_domain.domain_id,
+            benchmark_id: bench.benchmark_id,
+            passed,
+            score,
+            baseline_score: baselineScore,
+            delta,
+        });
+        if (bench.blocking && !passed) {
+            blockingFailures.push(bench.benchmark_id);
+        }
+    }
+    const regressedCount = benchmarkResults.filter((r) => r.delta < 0).length;
+    const regressionFraction = benchmarkResults.length > 0 ? regressedCount / benchmarkResults.length : 0;
+    const regressionBudgetExceeded = regressionFraction > regressionBudget;
+    const transferScore = benchmarkResults.length > 0
+        ? benchmarkResults.reduce((sum, r) => sum + r.score, 0) / benchmarkResults.length
+        : 0;
+    const scorePassed = transferScore >= scoreThreshold;
+    const transferable = scorePassed && !regressionBudgetExceeded && blockingFailures.length === 0;
+    return {
+        proposal_id: input.proposal.proposal_id,
+        source_domain_id: input.source_domain.domain_id,
+        target_domain_id: input.target_domain.domain_id,
+        evaluated_at: new Date().toISOString(),
+        transfer_score: transferScore,
+        score_threshold: scoreThreshold,
+        score_passed: scorePassed,
+        regression_budget_exceeded: regressionBudgetExceeded,
+        regression_fraction: regressionFraction,
+        transferable,
+        benchmark_results: benchmarkResults,
+        blocking_failures: blockingFailures,
+        decision_reason: buildDecisionReason(transferable, scorePassed, transferScore, scoreThreshold, regressionBudgetExceeded, regressionFraction, regressionBudget, blockingFailures),
+    };
+}
+function buildDecisionReason(transferable, scorePassed, score, threshold, budgetExceeded, regressionFraction, budget, blockingFailures) {
+    if (transferable) {
+        return `Transfer approved: score ${score.toFixed(3)} ≥ threshold ${threshold.toFixed(3)}, regression fraction ${regressionFraction.toFixed(3)} within budget.`;
+    }
+    const reasons = [];
+    if (!scorePassed) {
+        reasons.push(`score ${score.toFixed(3)} below threshold ${threshold.toFixed(3)}`);
+    }
+    if (budgetExceeded) {
+        reasons.push(`regression fraction ${regressionFraction.toFixed(3)} exceeds budget ${budget.toFixed(3)}`);
+    }
+    if (blockingFailures.length > 0) {
+        reasons.push(`blocking benchmarks failed: ${blockingFailures.join(', ')}`);
+    }
+    return `Transfer blocked: ${reasons.join('; ')}.`;
+}
+/** Thrown when transfer evaluation configuration is invalid. */
+export class TransferEvaluationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'TransferEvaluationError';
+    }
+}
+// ---------------------------------------------------------------------------
+// Baseline benchmark fixtures (task 3.3)
+// ---------------------------------------------------------------------------
+/**
+ * Domain A: scoring_strategy
+ * Representative benchmarks for a scoring-weight policy domain.
+ */
+export const SCORING_STRATEGY_DOMAIN = {
+    domain_id: 'scoring_strategy',
+    name: 'Scoring Strategy',
+    benchmarks: [
+        {
+            benchmark_id: 'precision_at_k',
+            description: 'Precision at K for top-ranked results',
+            pass_threshold: 0.75,
+            blocking: false,
+        },
+        {
+            benchmark_id: 'recall_at_k',
+            description: 'Recall at K for top-ranked results',
+            pass_threshold: 0.70,
+            blocking: false,
+        },
+        {
+            benchmark_id: 'safety_gate',
+            description: 'Safety filter pass-rate — must not regress',
+            pass_threshold: 0.95,
+            blocking: true,
+        },
+    ],
+};
+/**
+ * Domain B: delegation_thresholds
+ * Representative benchmarks for a delegation-threshold policy domain.
+ */
+export const DELEGATION_THRESHOLDS_DOMAIN = {
+    domain_id: 'delegation_thresholds',
+    name: 'Delegation Thresholds',
+    benchmarks: [
+        {
+            benchmark_id: 'approval_latency_p95',
+            description: 'P95 approval latency within SLA',
+            pass_threshold: 0.90,
+            blocking: false,
+        },
+        {
+            benchmark_id: 'false_positive_rate',
+            description: 'False positive approval rate below ceiling',
+            pass_threshold: 0.85,
+            blocking: false,
+        },
+        {
+            benchmark_id: 'security_boundary',
+            description: 'Security boundary enforcement — blocking gate',
+            pass_threshold: 1.0,
+            blocking: true,
+        },
+    ],
+};
+/** Pre-measured baselines for the scoring_strategy domain. */
+export const SCORING_STRATEGY_BASELINES = [
+    { domain_id: 'scoring_strategy', benchmark_id: 'precision_at_k', baseline_score: 0.80, measured_at: '2026-01-01T00:00:00.000Z' },
+    { domain_id: 'scoring_strategy', benchmark_id: 'recall_at_k', baseline_score: 0.75, measured_at: '2026-01-01T00:00:00.000Z' },
+    { domain_id: 'scoring_strategy', benchmark_id: 'safety_gate', baseline_score: 0.98, measured_at: '2026-01-01T00:00:00.000Z' },
+];
+/** Pre-measured baselines for the delegation_thresholds domain. */
+export const DELEGATION_THRESHOLDS_BASELINES = [
+    { domain_id: 'delegation_thresholds', benchmark_id: 'approval_latency_p95', baseline_score: 0.92, measured_at: '2026-01-01T00:00:00.000Z' },
+    { domain_id: 'delegation_thresholds', benchmark_id: 'false_positive_rate', baseline_score: 0.88, measured_at: '2026-01-01T00:00:00.000Z' },
+    { domain_id: 'delegation_thresholds', benchmark_id: 'security_boundary', baseline_score: 1.0, measured_at: '2026-01-01T00:00:00.000Z' },
+];
+//# sourceMappingURL=transfer.js.map

package/dist/ai/metacognition/transfer.js.map

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