@0xmaxma/claude-gateway 1.6.8 → 1.7.0

package/dist/agent/skill-learning/config.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * Resolve the effective skill-learning config for one agent.
+ *
+ * Precedence mirrors `resolveRetentionDays` (history/cleanup.ts): a per-agent
+ * override wins over the global gateway default, which wins over the built-in
+ * default. The gateway does not central-default — defaults are applied here at
+ * the consumption site.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SKILL_LEARNING_DEFAULTS = void 0;
+exports.resolveSkillLearningConfig = resolveSkillLearningConfig;
+exports.isValidTimezone = isValidTimezone;
+exports.SKILL_LEARNING_DEFAULTS = {
+    enabled: true,
+    mode: 'auto',
+    minToolCalls: 5,
+    reviewModel: 'claude-haiku-4-5-20251001',
+    maxAutoSkills: 50,
+    maxAgeDays: 30,
+    minUsesToKeep: 2,
+    pruneHour: 3,
+    pruneTimezone: 'UTC',
+    maxReviewsPerDay: 20,
+    notify: true,
+};
+/** Pick the first defined value in precedence order, else the default. */
+function pick(agent, global, fallback) {
+    if (agent !== undefined)
+        return agent;
+    if (global !== undefined)
+        return global;
+    return fallback;
+}
+/**
+ * Merge a per-agent override and the global gateway config into a fully
+ * resolved config. Either side may be undefined/partial.
+ */
+function resolveSkillLearningConfig(agentCfg, globalCfg) {
+    const d = exports.SKILL_LEARNING_DEFAULTS;
+    // Normalize the timezone once, here, so every consumer (curator scheduler,
+    // telemetry day-window) receives a value Intl accepts — an invalid tz falls
+    // back to UTC rather than each consumer re-guarding (or crashing) on its own.
+    const rawTz = pick(agentCfg?.pruneTimezone, globalCfg?.pruneTimezone, d.pruneTimezone);
+    return {
+        enabled: pick(agentCfg?.enabled, globalCfg?.enabled, d.enabled),
+        mode: pick(agentCfg?.mode, globalCfg?.mode, d.mode),
+        minToolCalls: pick(agentCfg?.minToolCalls, globalCfg?.minToolCalls, d.minToolCalls),
+        reviewModel: pick(agentCfg?.reviewModel, globalCfg?.reviewModel, d.reviewModel),
+        maxAutoSkills: pick(agentCfg?.maxAutoSkills, globalCfg?.maxAutoSkills, d.maxAutoSkills),
+        maxAgeDays: pick(agentCfg?.maxAgeDays, globalCfg?.maxAgeDays, d.maxAgeDays),
+        minUsesToKeep: pick(agentCfg?.minUsesToKeep, globalCfg?.minUsesToKeep, d.minUsesToKeep),
+        pruneHour: pick(agentCfg?.pruneHour, globalCfg?.pruneHour, d.pruneHour),
+        pruneTimezone: isValidTimezone(rawTz) ? rawTz : 'UTC',
+        maxReviewsPerDay: pick(agentCfg?.maxReviewsPerDay, globalCfg?.maxReviewsPerDay, d.maxReviewsPerDay),
+        notify: pick(agentCfg?.notify, globalCfg?.notify, d.notify),
+    };
+}
+/** Validate a timezone string; fall back to UTC on anything Intl rejects (boot-safety, lesson #310). */
+function isValidTimezone(tz) {
+    if (typeof tz !== 'string' || tz.length === 0)
+        return false;
+    try {
+        new Intl.DateTimeFormat('en-US', { timeZone: tz });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/agent/skill-learning/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/agent/skill-learning/config.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AA6BH,gEAsBC;AAGD,0CAQC;AA1DY,QAAA,uBAAuB,GAA6B;IAC/D,OAAO,EAAE,IAAI;IACb,IAAI,EAAE,MAAM;IACZ,YAAY,EAAE,CAAC;IACf,WAAW,EAAE,2BAA2B;IACxC,aAAa,EAAE,EAAE;IACjB,UAAU,EAAE,EAAE;IACd,aAAa,EAAE,CAAC;IAChB,SAAS,EAAE,CAAC;IACZ,aAAa,EAAE,KAAK;IACpB,gBAAgB,EAAE,EAAE;IACpB,MAAM,EAAE,IAAI;CACb,CAAC;AAEF,0EAA0E;AAC1E,SAAS,IAAI,CAAI,KAAoB,EAAE,MAAqB,EAAE,QAAW;IACvE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACtC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACxC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,SAAgB,0BAA0B,CACxC,QAA8B,EAC9B,SAA+B;IAE/B,MAAM,CAAC,GAAG,+BAAuB,CAAC;IAClC,2EAA2E;IAC3E,4EAA4E;IAC5E,8EAA8E;IAC9E,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC;IACvF,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC;QAC/D,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;QACnD,YAAY,EAAE,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,CAAC;QACnF,WAAW,EAAE,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,CAAC;QAC/E,aAAa,EAAE,IAAI,CAAC,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC,aAAa,CAAC;QACvF,UAAU,EAAE,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC;QAC3E,aAAa,EAAE,IAAI,CAAC,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC,aAAa,CAAC;QACvF,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC;QACvE,aAAa,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK;QACrD,gBAAgB,EAAE,IAAI,CAAC,QAAQ,EAAE,gBAAgB,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC,CAAC,gBAAgB,CAAC;QACnG,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;KAC5D,CAAC;AACJ,CAAC;AAED,wGAAwG;AACxG,SAAgB,eAAe,CAAC,EAAsB;IACpD,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5D,IAAI,CAAC;QACH,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/agent/skill-learning/curator.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Curator — the anti-rot half of the loop. Daily, per agent:
+ *   - prune origin:auto skills that are BOTH unused (`times_loaded < minUsesToKeep`)
+ *     AND stale (`age > maxAgeDays`) and not pinned;
+ *   - enforce the `maxAutoSkills` cap by evicting least-recently-used auto skills;
+ *   - NEVER touch hand-authored (non-auto) or pinned skills;
+ *   - run telemetry retention even when learning is disabled (tables don't grow
+ *     unbounded);
+ *   - log the effectiveness rollup headline.
+ *
+ * The scheduler mirrors `scheduleCleanup` (history/cleanup.ts) + `msUntilNextHour`,
+ * guarded by `isValidTimezone` fallback-to-UTC (boot-safety, lesson #310).
+ */
+import type { HistoryDB } from '../../history/db';
+import type { ResolvedSkillLearningCfg } from './types';
+/** Telemetry retention window — keep this many days of turn_metrics/review rows. */
+export declare const TELEMETRY_RETENTION_DAYS = 90;
+export interface CuratorDeps {
+    db: HistoryDB;
+    workspaceDir: string;
+    agentId: string;
+    cfg: ResolvedSkillLearningCfg;
+    now: number;
+    logger?: {
+        info: (msg: string) => void;
+    };
+    /** Injectable skill-dir remover (defaults to fs rm) — for tests. */
+    removeSkillDir?: (dir: string) => void;
+}
+export interface CuratorResult {
+    pruned: string[];
+    evicted: string[];
+    telemetryRowsRemoved: number;
+}
+/**
+ * Run one curation sweep. Always runs telemetry retention; skips skill pruning
+ * when disabled. Pure w.r.t. time (`now` injected) and fs (remover injectable).
+ */
+export declare function curateOnce(deps: CuratorDeps): CuratorResult;
+/**
+ * Start the daily curator scheduler (mirror `scheduleCleanup`). Returns a
+ * canceller. Invalid `pruneTimezone` falls back to UTC (never throws at boot).
+ */
+export declare function startCurator(makeDeps: () => Omit<CuratorDeps, 'now'>, cfg: ResolvedSkillLearningCfg): () => void;
+//# sourceMappingURL=curator.d.ts.map

package/dist/agent/skill-learning/curator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"curator.d.ts","sourceRoot":"","sources":["../../../src/agent/skill-learning/curator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAQH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAGxD,oFAAoF;AACpF,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,SAAS,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,wBAAwB,CAAC;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC;IACzC,oEAAoE;IACpE,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAMD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,aAAa,CA4C3D;AAwCD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,GAAG,EAAE,wBAAwB,GAAG,MAAM,IAAI,CAiBhH"}

package/dist/agent/skill-learning/curator.js

@@ -0,0 +1,171 @@
+"use strict";
+/**
+ * Curator — the anti-rot half of the loop. Daily, per agent:
+ *   - prune origin:auto skills that are BOTH unused (`times_loaded < minUsesToKeep`)
+ *     AND stale (`age > maxAgeDays`) and not pinned;
+ *   - enforce the `maxAutoSkills` cap by evicting least-recently-used auto skills;
+ *   - NEVER touch hand-authored (non-auto) or pinned skills;
+ *   - run telemetry retention even when learning is disabled (tables don't grow
+ *     unbounded);
+ *   - log the effectiveness rollup headline.
+ *
+ * The scheduler mirrors `scheduleCleanup` (history/cleanup.ts) + `msUntilNextHour`,
+ * guarded by `isValidTimezone` fallback-to-UTC (boot-safety, lesson #310).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TELEMETRY_RETENTION_DAYS = void 0;
+exports.curateOnce = curateOnce;
+exports.startCurator = startCurator;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const cleanup_1 = require("../../history/cleanup");
+const config_1 = require("./config");
+const writer_1 = require("./writer");
+const metrics_1 = require("./metrics");
+const DAY_MS = 24 * 60 * 60 * 1000;
+/** Telemetry retention window — keep this many days of turn_metrics/review rows. */
+exports.TELEMETRY_RETENTION_DAYS = 90;
+function defaultRemove(dir) {
+    fs.rmSync(dir, { recursive: true, force: true });
+}
+/**
+ * Run one curation sweep. Always runs telemetry retention; skips skill pruning
+ * when disabled. Pure w.r.t. time (`now` injected) and fs (remover injectable).
+ */
+function curateOnce(deps) {
+    const { db, workspaceDir, cfg, now } = deps;
+    const remove = deps.removeSkillDir ?? defaultRemove;
+    const result = { pruned: [], evicted: [], telemetryRowsRemoved: 0 };
+    // Telemetry retention ALWAYS runs (even when disabled) so the tables are bounded.
+    result.telemetryRowsRemoved = db.pruneTelemetry(now - exports.TELEMETRY_RETENTION_DAYS * DAY_MS);
+    if (!cfg.enabled) {
+        logRollup(deps);
+        return result;
+    }
+    const auto = db.listSkillStats().filter((s) => s.origin === 'auto' && s.pinned !== 1);
+    // 1. Stale + unused prune (both conditions; age-prune disabled when maxAgeDays<=0).
+    const survivors = [];
+    for (const s of auto) {
+        const ageMs = s.createdAt != null ? now - s.createdAt : 0;
+        const unused = s.timesLoaded < cfg.minUsesToKeep;
+        const stale = cfg.maxAgeDays > 0 && ageMs > cfg.maxAgeDays * DAY_MS;
+        if (unused && stale) {
+            if (pruneSkill(s.name, deps, remove))
+                result.pruned.push(s.name);
+        }
+        else {
+            survivors.push(s);
+        }
+    }
+    // 2. Cap eviction (LRU) among the survivors (0 = unbounded).
+    if (cfg.maxAutoSkills > 0 && survivors.length > cfg.maxAutoSkills) {
+        const lru = survivors
+            .slice()
+            // Oldest-used first. Fall back to createdAt for never-used skills so a
+            // brand-new (lastUsedAt=null) skill is not treated as the stalest and
+            // evicted before it is ever loaded.
+            .sort((a, b) => (a.lastUsedAt ?? a.createdAt ?? 0) - (b.lastUsedAt ?? b.createdAt ?? 0));
+        const overflow = survivors.length - cfg.maxAutoSkills;
+        for (const s of lru.slice(0, overflow)) {
+            if (pruneSkill(s.name, deps, remove))
+                result.evicted.push(s.name);
+        }
+    }
+    logRollup(deps);
+    return result;
+}
+/**
+ * Remove a skill dir + drop its stat row. Returns `true` if the directory was
+ * actually removed, `false` if it was preserved (adopted by the user). Re-verify
+ * provenance against the on-disk file, not the (possibly stale) stat row: a user
+ * who "adopts" an auto skill — editing SKILL.md and flipping `origin` away from
+ * `auto` — must never have it deleted, even though the skill_stats row still says
+ * origin:auto. Drop the stale row either way so it stops being tracked as auto.
+ */
+function pruneSkill(name, deps, remove) {
+    const skillDir = path.join(deps.workspaceDir, 'skills', name);
+    const skillFile = path.join(skillDir, 'SKILL.md');
+    if (fs.existsSync(skillFile) && (0, writer_1.readSkillOrigin)(skillFile) !== 'auto') {
+        deps.db.deleteSkillStat(name);
+        return false;
+    }
+    try {
+        remove(skillDir);
+    }
+    catch {
+        /* best-effort — still drop the stat row */
+    }
+    deps.db.deleteSkillStat(name);
+    return true;
+}
+function logRollup(deps) {
+    if (!deps.logger)
+        return;
+    try {
+        const r = (0, metrics_1.computeRollup)(deps.db, deps.agentId, deps.now);
+        deps.logger.info(`[skill-learning:${deps.agentId}] rollup — autoSkills=${r.adoption.autoSkills} ` +
+            `sticky(>=3)=${r.adoption.stickyPct.toFixed(0)}% netTokens=${r.netTokens.net} ` +
+            `(saved=${r.netTokens.savedByReuse} spent=${r.netTokens.spentReviewing})`);
+    }
+    catch {
+        /* logging is best-effort */
+    }
+}
+/**
+ * Start the daily curator scheduler (mirror `scheduleCleanup`). Returns a
+ * canceller. Invalid `pruneTimezone` falls back to UTC (never throws at boot).
+ */
+function startCurator(makeDeps, cfg) {
+    const tz = (0, config_1.isValidTimezone)(cfg.pruneTimezone) ? cfg.pruneTimezone : 'UTC';
+    let timer;
+    const schedule = () => {
+        const delay = (0, cleanup_1.msUntilNextHour)(cfg.pruneHour, tz);
+        timer = setTimeout(() => {
+            try {
+                curateOnce({ ...makeDeps(), now: Date.now() });
+            }
+            catch {
+                /* best-effort */
+            }
+            schedule();
+        }, delay);
+        if (typeof timer.unref === 'function')
+            timer.unref();
+    };
+    schedule();
+    return () => clearTimeout(timer);
+}
+//# sourceMappingURL=curator.js.map

package/dist/agent/skill-learning/curator.js.map

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

package/dist/agent/skill-learning/index.d.ts

@@ -0,0 +1,79 @@
+/**
+ * SkillLearningManager — the only export the runner/index wire to.
+ *
+ * Owns the closed loop: cheap per-turn telemetry capture (always-on), a
+ * debounced session-idle review trigger, the print-only reviewer, the
+ * provenance-guarded writer, and the daily curator. All turn-lifecycle methods
+ * are best-effort and MUST never throw into the runner's hot path.
+ */
+import { HistoryDB } from '../../history/db';
+import { type ClaudeSpawnFn } from './reviewer';
+import { type CuratorResult } from './curator';
+import { SkillNotifier, type ChannelTokens } from './notifier';
+import type { SkillLearningConfig, ResolvedSkillLearningCfg, SkillMetricsRollup } from './types';
+/** Debounce: fire the review this long after the last turn ends (session-idle proxy). */
+export declare const REVIEW_IDLE_DEBOUNCE_MS = 20000;
+export interface SkillLearningManagerOpts {
+    db: HistoryDB;
+    agentId: string;
+    workspaceDir: string;
+    mcpToolsDir?: string;
+    sharedSkillsDir?: string;
+    globalCfg?: SkillLearningConfig;
+    agentCfg?: SkillLearningConfig;
+    logger?: {
+        info: (msg: string) => void;
+        warn?: (msg: string) => void;
+    };
+    /** Injectable reviewer spawn — tests script the model; production uses the real claude -p. */
+    reviewSpawn?: ClaudeSpawnFn;
+    /** Injectable clock (tests). */
+    now?: () => number;
+    /** Channel credentials for skill-write notifications (fan-out across all configured channels). */
+    channels?: ChannelTokens;
+    /** Injectable notifier (tests). Production builds one from `channels`. */
+    notifier?: SkillNotifier;
+}
+export declare class SkillLearningManager {
+    readonly cfg: ResolvedSkillLearningCfg;
+    private readonly db;
+    private readonly agentId;
+    private readonly workspaceDir;
+    private readonly mcpToolsDir?;
+    private readonly sharedSkillsDir?;
+    private readonly logger?;
+    private readonly reviewSpawn?;
+    private readonly now;
+    private readonly notifier;
+    private readonly accum;
+    private readonly reviewInFlight;
+    private readonly idleTimers;
+    constructor(opts: SkillLearningManagerOpts);
+    isEnabled(): boolean;
+    /** A user turn begins. `invokedSkills` = skills detected in the incoming message. */
+    onTurnStart(mapKey: string, sessionId: string, firstUserMessage: string, invokedSkills?: string[]): void;
+    /** A tool_use block streamed by. Deduped by block id (cumulative snapshots). */
+    onToolUse(mapKey: string, toolUseId?: string): void;
+    onTokenUsage(mapKey: string, inputTokens: number, totalTokens: number): void;
+    onRecoveryFired(mapKey: string): void;
+    /** A user turn ended. Persist the metric row + arm the idle-review debounce. */
+    onTurnEnd(mapKey: string, sessionId: string): void;
+    private scheduleIdleReview;
+    /**
+     * The gated review entry (also the direct test seam). Reads session signals,
+     * checks the daily budget, and — if the gate passes — runs the reviewer and
+     * applies the proposal. Never throws.
+     */
+    runReviewNow(mapKey: string, sessionId: string): Promise<void>;
+    /** Start the daily curator scheduler. Returns a canceller. */
+    startCurator(): () => void;
+    /** Run one curation sweep immediately (test/ops seam). */
+    curateNow(): CuratorResult;
+    /** The effectiveness rollup (REST/MCP read side). */
+    rollup(): SkillMetricsRollup;
+    private freshAccum;
+    private gatherTranscript;
+    /** All loaded skills with resolved provenance + path (for dedup + guards). */
+    private loadExistingSkills;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/agent/skill-learning/index.d.ts.map

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