qlogicagent 0.1.0

package/dist/orchestration/skill-candidate.js

@@ -0,0 +1,142 @@
+import { coerceSkillCandidateJsonObject, normalizeSkillCandidateAction, normalizeSkillCandidateArtifact, normalizeSkillCandidateEffectiveness, normalizeSkillCandidateEffectivenessPhase, normalizeSkillCandidateSourceExecution, } from "../contracts/skill-candidate.js";
+const DEFAULT_SKILL_IMPROVEMENT_POLICY = {
+    reviewRequired: true,
+    canaryRequired: true,
+    autoPromote: false,
+    minCanarySampleCount: 10,
+    minSuccessRate: 0.7,
+    maxRegressionRate: 0.1,
+    maxCostIncreaseRate: 0.25,
+    staleAfterHours: 168,
+};
+function normalizeOptionalBoolean(value, fallback) {
+    if (typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value === "string") {
+        const normalized = value.trim().toLowerCase();
+        if (normalized === "true") {
+            return true;
+        }
+        if (normalized === "false") {
+            return false;
+        }
+    }
+    return fallback;
+}
+function normalizeOptionalFiniteNumber(value, fallback) {
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return value;
+    }
+    if (typeof value === "string") {
+        const trimmed = value.trim();
+        if (trimmed) {
+            const parsed = Number(trimmed);
+            if (Number.isFinite(parsed)) {
+                return parsed;
+            }
+        }
+    }
+    return fallback;
+}
+function normalizeOptionalStringArray(value) {
+    return Array.isArray(value)
+        ? value
+            .filter((entry) => typeof entry === "string")
+            .map((entry) => entry.trim())
+            .filter(Boolean)
+        : [];
+}
+export function createDefaultSkillImprovementPolicy(overrides = {}) {
+    return normalizeSkillImprovementPolicy(overrides, DEFAULT_SKILL_IMPROVEMENT_POLICY);
+}
+export function normalizeSkillImprovementPolicy(value, fallback = DEFAULT_SKILL_IMPROVEMENT_POLICY) {
+    const record = coerceSkillCandidateJsonObject(value);
+    return {
+        reviewRequired: normalizeOptionalBoolean(record.reviewRequired, fallback.reviewRequired),
+        canaryRequired: normalizeOptionalBoolean(record.canaryRequired, fallback.canaryRequired),
+        autoPromote: normalizeOptionalBoolean(record.autoPromote, fallback.autoPromote),
+        minCanarySampleCount: Math.max(1, Math.floor(normalizeOptionalFiniteNumber(record.minCanarySampleCount, fallback.minCanarySampleCount))),
+        minSuccessRate: Math.max(0, Math.min(1, normalizeOptionalFiniteNumber(record.minSuccessRate, fallback.minSuccessRate))),
+        maxRegressionRate: Math.max(0, Math.min(1, normalizeOptionalFiniteNumber(record.maxRegressionRate, fallback.maxRegressionRate))),
+        maxCostIncreaseRate: Math.max(0, normalizeOptionalFiniteNumber(record.maxCostIncreaseRate, fallback.maxCostIncreaseRate)),
+        staleAfterHours: Math.max(1, Math.floor(normalizeOptionalFiniteNumber(record.staleAfterHours, fallback.staleAfterHours))),
+    };
+}
+export function buildSkillCandidateEvidencePayload(params) {
+    const evidence = coerceSkillCandidateJsonObject(params.evidence);
+    const artifact = params.artifact ? normalizeSkillCandidateArtifact(params.artifact) : null;
+    const sourceExecution = params.sourceExecution
+        ? normalizeSkillCandidateSourceExecution(params.sourceExecution)
+        : null;
+    const sourceSessionKey = typeof params.sourceSessionKey === "string"
+        ? params.sourceSessionKey.trim()
+        : "";
+    return {
+        ...evidence,
+        ...(artifact ? { artifact } : {}),
+        ...(sourceExecution ? { sourceExecution } : {}),
+        ...(sourceSessionKey ? { sourceSessionKey } : {}),
+    };
+}
+export function buildSkillCandidateImprovementEvidenceBundle(params) {
+    const evidence = buildSkillCandidateEvidencePayload(params);
+    const diffSummary = typeof params.diffSummary === "string" && params.diffSummary.trim()
+        ? params.diffSummary.trim()
+        : "";
+    const baselineCandidateId = typeof params.baselineCandidateId === "string"
+        && params.baselineCandidateId.trim()
+        ? params.baselineCandidateId.trim()
+        : "";
+    const rolloutNotes = typeof params.rolloutNotes === "string" && params.rolloutNotes.trim()
+        ? params.rolloutNotes.trim()
+        : "";
+    const validationRefs = normalizeOptionalStringArray(params.validationRefs);
+    return {
+        ...evidence,
+        ...(diffSummary ? { diffSummary } : {}),
+        ...(baselineCandidateId ? { baselineCandidateId } : {}),
+        ...(rolloutNotes ? { rolloutNotes } : {}),
+        ...(validationRefs.length > 0 ? { validationRefs } : {}),
+    };
+}
+export function buildSkillCandidateLatestReview(params) {
+    return {
+        action: normalizeSkillCandidateAction(params.action) ?? params.action,
+        actor: typeof params.actor === "string" && params.actor.trim() ? params.actor.trim() : null,
+        notes: typeof params.notes === "string" && params.notes.trim() ? params.notes.trim() : null,
+        payload: coerceSkillCandidateJsonObject(params.payload),
+        createdAt: typeof params.createdAt === "string" && params.createdAt.trim()
+            ? params.createdAt.trim()
+            : new Date().toISOString(),
+    };
+}
+export function buildSkillCandidateEffectivenessSummary(params) {
+    const sampleCount = Math.max(0, Math.floor(params.sampleCount ?? 0));
+    const successCount = Math.max(0, Math.floor(params.successCount ?? 0));
+    const failureCount = Math.max(0, Math.floor(params.failureCount ?? Math.max(sampleCount - successCount, 0)));
+    const regressionCount = Math.max(0, Math.floor(params.regressionCount ?? 0));
+    const successRate = sampleCount > 0 ? successCount / sampleCount : 0;
+    const regressionRate = sampleCount > 0 ? regressionCount / sampleCount : 0;
+    const score = typeof params.score === "number" && Number.isFinite(params.score)
+        ? params.score
+        : Number((successRate - regressionRate).toFixed(4));
+    return normalizeSkillCandidateEffectiveness({
+        phase: normalizeSkillCandidateEffectivenessPhase(params.phase) ?? params.phase,
+        sampleCount,
+        successCount,
+        failureCount,
+        regressionCount,
+        successRate,
+        regressionRate,
+        avgLatencyMs: params.avgLatencyMs,
+        avgCostUsd: params.avgCostUsd,
+        score,
+        staleReason: params.staleReason,
+        notes: params.notes,
+        summary: coerceSkillCandidateJsonObject(params.summary),
+        lastObservedAt: params.lastObservedAt ?? new Date().toISOString(),
+        updatedAt: params.updatedAt ?? new Date().toISOString(),
+    });
+}
+//# sourceMappingURL=skill-candidate.js.map

package/dist/orchestration/skill-candidate.js.map

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

package/dist/orchestration/skill-consolidation.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Skill consolidation strategy — pure decision logic for
+ * the Autonomous Curator's LLM-driven skill merging phase.
+ *
+ * This module:
+ * 1. Detects prefix clusters among skill names.
+ * 2. Builds the consolidation prompt for the LLM review agent.
+ * 3. Parses structured LLM output into actionable merge/prune plans.
+ * 4. Reconciles LLM intent against ground truth (existing skills).
+ *
+ * No I/O — the caller invokes the LLM and applies the results.
+ */
+/** A skill summary fed to the LLM reviewer. */
+export interface ConsolidationSkillSummary {
+    name: string;
+    description: string;
+    /** Comma-separated tool names the skill uses. */
+    tools: string;
+    useCount: number;
+    lastActivityAt: string | null;
+    state: "active" | "stale";
+}
+/** A single consolidation action proposed by the LLM. */
+export interface ConsolidationAction {
+    /** Source skill to be absorbed. */
+    sourceSkill: string;
+    /** Target umbrella skill (existing or to-be-created). */
+    targetUmbrella: string;
+    /** Whether the target umbrella already exists. */
+    targetExists: boolean;
+    /** LLM's reason for the merge. */
+    reason: string;
+}
+/** A single pruning action proposed by the LLM. */
+export interface PruningAction {
+    /** Skill to be archived (not deleted). */
+    skillName: string;
+    /** Reason for pruning. */
+    reason: string;
+}
+/** Full consolidation plan produced by parsing LLM output. */
+export interface ConsolidationPlan {
+    consolidations: ConsolidationAction[];
+    prunings: PruningAction[];
+    /** Skills mentioned by LLM but not found in ground truth. */
+    hallucinations: string[];
+}
+/** Result of reconciling the LLM plan against ground truth. */
+export interface ReconciledConsolidationPlan {
+    /** Validated consolidation actions (targets exist or are marked for creation). */
+    validConsolidations: ConsolidationAction[];
+    /** Validated pruning actions (skills exist). */
+    validPrunings: PruningAction[];
+    /** Rejected actions due to ground-truth mismatch. */
+    rejected: Array<{
+        action: string;
+        reason: string;
+    }>;
+}
+/** A detected cluster of skills sharing a naming prefix. */
+export interface SkillPrefixCluster {
+    prefix: string;
+    skills: string[];
+}
+/**
+ * Detect prefix clusters among skill names.
+ *
+ * A cluster is ≥2 skills sharing a common hyphenated prefix of ≥2 chars.
+ * E.g. `["pr-review", "pr-merge", "pr-label"]` → cluster `"pr"`.
+ */
+export declare function detectPrefixClusters(skillNames: readonly string[], minClusterSize?: number): SkillPrefixCluster[];
+/**
+ * Build the consolidation review prompt for the LLM curator agent.
+ *
+ * The prompt instructs the model to:
+ * 1. Identify prefix clusters and overlapping skills.
+ * 2. Propose umbrella consolidations.
+ * 3. Mark redundant/trivial skills for pruning (archive, not delete).
+ * 4. Output a structured YAML block.
+ */
+export declare function buildConsolidationPrompt(candidates: readonly ConsolidationSkillSummary[], existingUmbrellas: readonly string[], clusters: readonly SkillPrefixCluster[]): string;
+/**
+ * Parse the LLM's structured YAML response into a ConsolidationPlan.
+ *
+ * Tolerant: handles minor formatting variations, ignores unknown fields.
+ */
+export declare function parseConsolidationOutput(llmOutput: string, knownSkills: ReadonlySet<string>): ConsolidationPlan;
+/**
+ * Reconcile the LLM's consolidation plan against ground truth.
+ *
+ * Validates that:
+ * - Source skills exist and aren't already consolidated in this plan.
+ * - Target umbrellas either exist or are new (will be created).
+ * - Pruning targets aren't also being consolidated.
+ */
+export declare function reconcileConsolidationPlan(plan: ConsolidationPlan, knownSkills: ReadonlySet<string>): ReconciledConsolidationPlan;
+/** Summary of a curator review run. */
+export interface CuratorRunReport {
+    /** ISO-8601 timestamp of the run. */
+    runAt: string;
+    /** Duration in seconds. */
+    durationSeconds: number;
+    /** Number of skills checked for lifecycle transitions. */
+    autoTransitionsChecked: number;
+    /** Number of skills marked stale. */
+    autoMarkedStale: number;
+    /** Number of skills archived. */
+    autoArchived: number;
+    /** Number of skills reactivated. */
+    autoReactivated: number;
+    /** Number of LLM-proposed consolidations accepted. */
+    consolidationsAccepted: number;
+    /** Number of LLM-proposed prunings accepted. */
+    pruningsAccepted: number;
+    /** Number of LLM-proposed actions rejected. */
+    actionsRejected: number;
+    /** Number of hallucinated skill names. */
+    hallucinations: number;
+}
+/**
+ * Build a human-readable summary from a curator run report.
+ */
+export declare function buildCuratorRunSummary(report: CuratorRunReport): string;
+//# sourceMappingURL=skill-consolidation.d.ts.map

package/dist/orchestration/skill-consolidation.d.ts.map

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

package/dist/orchestration/skill-consolidation.js

@@ -0,0 +1,221 @@
+/**
+ * Skill consolidation strategy — pure decision logic for
+ * the Autonomous Curator's LLM-driven skill merging phase.
+ *
+ * This module:
+ * 1. Detects prefix clusters among skill names.
+ * 2. Builds the consolidation prompt for the LLM review agent.
+ * 3. Parses structured LLM output into actionable merge/prune plans.
+ * 4. Reconciles LLM intent against ground truth (existing skills).
+ *
+ * No I/O — the caller invokes the LLM and applies the results.
+ */
+/**
+ * Detect prefix clusters among skill names.
+ *
+ * A cluster is ≥2 skills sharing a common hyphenated prefix of ≥2 chars.
+ * E.g. `["pr-review", "pr-merge", "pr-label"]` → cluster `"pr"`.
+ */
+export function detectPrefixClusters(skillNames, minClusterSize = 2) {
+    const prefixMap = new Map();
+    for (const name of skillNames) {
+        const dashIdx = name.indexOf("-");
+        if (dashIdx < 2)
+            continue;
+        const prefix = name.slice(0, dashIdx);
+        const existing = prefixMap.get(prefix);
+        if (existing) {
+            existing.push(name);
+        }
+        else {
+            prefixMap.set(prefix, [name]);
+        }
+    }
+    const clusters = [];
+    for (const [prefix, skills] of prefixMap) {
+        if (skills.length >= minClusterSize) {
+            clusters.push({ prefix, skills: skills.sort() });
+        }
+    }
+    return clusters.sort((a, b) => b.skills.length - a.skills.length);
+}
+// ── LLM prompt construction ────────────────────────────────────────
+/**
+ * Build the consolidation review prompt for the LLM curator agent.
+ *
+ * The prompt instructs the model to:
+ * 1. Identify prefix clusters and overlapping skills.
+ * 2. Propose umbrella consolidations.
+ * 3. Mark redundant/trivial skills for pruning (archive, not delete).
+ * 4. Output a structured YAML block.
+ */
+export function buildConsolidationPrompt(candidates, existingUmbrellas, clusters) {
+    const candidateList = candidates.map((c) => `- **${c.name}** (${c.state}, uses: ${c.useCount}, tools: ${c.tools})${c.lastActivityAt ? ` last active: ${c.lastActivityAt}` : ""}`).join("\n");
+    const umbrellaList = existingUmbrellas.length > 0
+        ? existingUmbrellas.map((u) => `- ${u}`).join("\n")
+        : "(none)";
+    const clusterList = clusters.length > 0
+        ? clusters.map((c) => `- **${c.prefix}-***: ${c.skills.join(", ")}`).join("\n")
+        : "(no clusters detected)";
+    return `You are the Autonomous Curator for a skill library.
+
+## Goal
+
+Transform narrow, session-specific skills into a well-organized library of
+class-level umbrella skills. A collection of hundreds of narrow skills is FAILURE.
+
+## Ground Rules
+
+1. **NEVER delete** — only archive (prune). Archived skills can be restored.
+2. **Do NOT touch pinned or bundled skills** — they are already filtered out.
+3. **Identify prefix clusters** and merge them into umbrella skills.
+4. **Move session-specific details** into the umbrella's references/ folder.
+5. **Preserve unique value** — only merge if the source is genuinely redundant
+   or a subset of the target.
+
+## Detected Prefix Clusters
+
+${clusterList}
+
+## Existing Umbrella Skills
+
+${umbrellaList}
+
+## Candidate Skills for Review
+
+${candidateList}
+
+## Required Output Format
+
+Respond with EXACTLY this YAML block (no extra text outside the block):
+
+\`\`\`yaml
+consolidations:
+  - source: "skill-name-a"
+    target: "umbrella-skill"
+    reason: "subset of umbrella functionality"
+  - source: "skill-name-b"
+    target: "new-umbrella-name"
+    reason: "cluster merge"
+
+prunings:
+  - skill: "skill-name-c"
+    reason: "trivial single-use, no ongoing value"
+\`\`\`
+
+If no consolidations or prunings are warranted, use empty lists.
+Respond ONLY with the YAML block.`;
+}
+// ── LLM output parsing ─────────────────────────────────────────────
+/**
+ * Parse the LLM's structured YAML response into a ConsolidationPlan.
+ *
+ * Tolerant: handles minor formatting variations, ignores unknown fields.
+ */
+export function parseConsolidationOutput(llmOutput, knownSkills) {
+    const consolidations = [];
+    const prunings = [];
+    const hallucinations = [];
+    // Extract YAML block if wrapped in ```yaml ... ```
+    const yamlMatch = llmOutput.match(/```(?:yaml)?\s*\n([\s\S]*?)```/);
+    const yaml = yamlMatch ? yamlMatch[1] : llmOutput;
+    // Parse consolidations
+    const consolidationBlock = yaml.match(/consolidations:\s*\n((?:\s+-[\s\S]*?)?)(?=prunings:|$)/);
+    if (consolidationBlock?.[1]) {
+        const entries = consolidationBlock[1].matchAll(/- source:\s*"([^"]+)"\s*\n\s*target:\s*"([^"]+)"\s*\n\s*reason:\s*"([^"]+)"/g);
+        for (const [, source, target, reason] of entries) {
+            if (!knownSkills.has(source)) {
+                hallucinations.push(source);
+                continue;
+            }
+            consolidations.push({
+                sourceSkill: source,
+                targetUmbrella: target,
+                targetExists: knownSkills.has(target),
+                reason,
+            });
+        }
+    }
+    // Parse prunings
+    const pruningBlock = yaml.match(/prunings:\s*\n([\s\S]*?)$/);
+    if (pruningBlock?.[1]) {
+        const entries = pruningBlock[1].matchAll(/- skill:\s*"([^"]+)"\s*\n\s*reason:\s*"([^"]+)"/g);
+        for (const [, skill, reason] of entries) {
+            if (!knownSkills.has(skill)) {
+                hallucinations.push(skill);
+                continue;
+            }
+            prunings.push({ skillName: skill, reason });
+        }
+    }
+    return { consolidations, prunings, hallucinations };
+}
+// ── Reconciliation ─────────────────────────────────────────────────
+/**
+ * Reconcile the LLM's consolidation plan against ground truth.
+ *
+ * Validates that:
+ * - Source skills exist and aren't already consolidated in this plan.
+ * - Target umbrellas either exist or are new (will be created).
+ * - Pruning targets aren't also being consolidated.
+ */
+export function reconcileConsolidationPlan(plan, knownSkills) {
+    const validConsolidations = [];
+    const validPrunings = [];
+    const rejected = [];
+    const consolidatedSources = new Set();
+    for (const c of plan.consolidations) {
+        if (!knownSkills.has(c.sourceSkill)) {
+            rejected.push({
+                action: `consolidate ${c.sourceSkill} → ${c.targetUmbrella}`,
+                reason: `source skill "${c.sourceSkill}" not found`,
+            });
+            continue;
+        }
+        if (consolidatedSources.has(c.sourceSkill)) {
+            rejected.push({
+                action: `consolidate ${c.sourceSkill} → ${c.targetUmbrella}`,
+                reason: `source skill "${c.sourceSkill}" already consolidated in this plan`,
+            });
+            continue;
+        }
+        if (c.sourceSkill === c.targetUmbrella) {
+            rejected.push({
+                action: `consolidate ${c.sourceSkill} → ${c.targetUmbrella}`,
+                reason: "source and target are the same skill",
+            });
+            continue;
+        }
+        consolidatedSources.add(c.sourceSkill);
+        validConsolidations.push(c);
+    }
+    for (const p of plan.prunings) {
+        if (!knownSkills.has(p.skillName)) {
+            rejected.push({
+                action: `prune ${p.skillName}`,
+                reason: `skill "${p.skillName}" not found`,
+            });
+            continue;
+        }
+        if (consolidatedSources.has(p.skillName)) {
+            rejected.push({
+                action: `prune ${p.skillName}`,
+                reason: `skill "${p.skillName}" is being consolidated, not pruned`,
+            });
+            continue;
+        }
+        validPrunings.push(p);
+    }
+    return { validConsolidations, validPrunings, rejected };
+}
+/**
+ * Build a human-readable summary from a curator run report.
+ */
+export function buildCuratorRunSummary(report) {
+    const parts = [];
+    parts.push(`Curator run at ${report.runAt} (${report.durationSeconds.toFixed(1)}s)`);
+    parts.push(`Auto: ${report.autoTransitionsChecked} checked, ${report.autoMarkedStale} stale, ${report.autoArchived} archived, ${report.autoReactivated} reactivated`);
+    parts.push(`LLM: ${report.consolidationsAccepted} consolidated, ${report.pruningsAccepted} pruned, ${report.actionsRejected} rejected, ${report.hallucinations} hallucinated`);
+    return parts.join("; ");
+}
+//# sourceMappingURL=skill-consolidation.js.map

package/dist/orchestration/skill-consolidation.js.map

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

package/dist/orchestration/skill-improvement.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Skill self-learning: decides whether a completed turn should
+ * trigger skill creation or improvement instructions.
+ */
+export interface SkillTurnResult {
+    ok: boolean;
+    /** Number of tool invocations in this turn */
+    toolCallCount: number;
+    /** Number of distinct tool names used */
+    distinctToolCount: number;
+    /** Was a multi-step orchestration (≥2 rounds) used? */
+    multiStep: boolean;
+    /** Did the turn involve a sidechain? */
+    hasSidechain: boolean;
+    /** Optional user feedback signal (positive/negative/none) */
+    feedback?: "positive" | "negative" | null;
+    /** Skill name if an existing skill was used */
+    existingSkillName?: string | null;
+}
+export interface SkillCreateInstruction {
+    type: "skill.create";
+    /** Suggested skill name derived from tool usage pattern */
+    suggestedName: string;
+    /** Short description of what the skill does */
+    description: string;
+    /** Tool names involved */
+    tools: string[];
+    /** Number of orchestration steps */
+    stepCount: number;
+}
+export interface SkillImproveInstruction {
+    type: "skill.improve";
+    /** Existing skill to improve */
+    skillName: string;
+    /** Reason for improvement */
+    reason: string;
+}
+export type SkillInstruction = SkillCreateInstruction | SkillImproveInstruction;
+/**
+ * Determine whether a completed turn should produce a skill instruction.
+ *
+ * A new skill is suggested when:
+ * - The turn succeeded
+ * - It involved multi-step orchestration
+ * - It used ≥3 tool calls across ≥2 distinct tools
+ * - No existing skill was already applied
+ *
+ * An improvement is suggested when:
+ * - The turn used an existing skill but got negative feedback
+ */
+export declare function shouldCreateSkill(result: SkillTurnResult): boolean;
+export declare function shouldImproveSkill(result: SkillTurnResult): boolean;
+/**
+ * Build a skill instruction from a turn result, or null if none is warranted.
+ */
+export declare function buildSkillInstruction(result: SkillTurnResult, context: {
+    tools: string[];
+    suggestedName?: string;
+}): SkillInstruction | null;
+//# sourceMappingURL=skill-improvement.d.ts.map

package/dist/orchestration/skill-improvement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-improvement.d.ts","sourceRoot":"","sources":["../../src/orchestration/skill-improvement.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uDAAuD;IACvD,SAAS,EAAE,OAAO,CAAC;IACnB,wCAAwC;IACxC,YAAY,EAAE,OAAO,CAAC;IACtB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAAC;IAC1C,+CAA+C;IAC/C,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAID,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,cAAc,CAAC;IACrB,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,eAAe,CAAC;IACtB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,gBAAgB,GAAG,sBAAsB,GAAG,uBAAuB,CAAC;AAehF;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAOlE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAGnE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GACnD,gBAAgB,GAAG,IAAI,CAoBzB"}

package/dist/orchestration/skill-improvement.js

@@ -0,0 +1,67 @@
+/**
+ * Skill self-learning: decides whether a completed turn should
+ * trigger skill creation or improvement instructions.
+ */
+// ── Decision logic ─────────────────────────────────────────────────
+/**
+ * Minimum tool call count to consider a turn "complex enough"
+ * to warrant creating a reusable skill.
+ */
+const MIN_TOOL_CALLS_FOR_SKILL = 3;
+/**
+ * Minimum distinct tools to suggest a new skill.
+ */
+const MIN_DISTINCT_TOOLS_FOR_SKILL = 2;
+/**
+ * Determine whether a completed turn should produce a skill instruction.
+ *
+ * A new skill is suggested when:
+ * - The turn succeeded
+ * - It involved multi-step orchestration
+ * - It used ≥3 tool calls across ≥2 distinct tools
+ * - No existing skill was already applied
+ *
+ * An improvement is suggested when:
+ * - The turn used an existing skill but got negative feedback
+ */
+export function shouldCreateSkill(result) {
+    if (!result.ok)
+        return false;
+    if (result.existingSkillName)
+        return false;
+    if (!result.multiStep)
+        return false;
+    if (result.toolCallCount < MIN_TOOL_CALLS_FOR_SKILL)
+        return false;
+    if (result.distinctToolCount < MIN_DISTINCT_TOOLS_FOR_SKILL)
+        return false;
+    return true;
+}
+export function shouldImproveSkill(result) {
+    if (!result.existingSkillName)
+        return false;
+    return result.feedback === "negative";
+}
+/**
+ * Build a skill instruction from a turn result, or null if none is warranted.
+ */
+export function buildSkillInstruction(result, context) {
+    if (shouldImproveSkill(result)) {
+        return {
+            type: "skill.improve",
+            skillName: result.existingSkillName,
+            reason: "negative user feedback on existing skill execution",
+        };
+    }
+    if (shouldCreateSkill(result)) {
+        return {
+            type: "skill.create",
+            suggestedName: context.suggestedName ?? `auto-skill-${context.tools.slice(0, 3).join("-")}`,
+            description: `Multi-step orchestration using ${context.tools.join(", ")}`,
+            tools: context.tools,
+            stepCount: result.toolCallCount,
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=skill-improvement.js.map

package/dist/orchestration/skill-improvement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-improvement.js","sourceRoot":"","sources":["../../src/orchestration/skill-improvement.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4CH,sEAAsE;AAEtE;;;GAGG;AACH,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAEnC;;GAEG;AACH,MAAM,4BAA4B,GAAG,CAAC,CAAC;AAEvC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAuB;IACvD,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,KAAK,CAAC;IAC7B,IAAI,MAAM,CAAC,iBAAiB;QAAE,OAAO,KAAK,CAAC;IAC3C,IAAI,CAAC,MAAM,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IACpC,IAAI,MAAM,CAAC,aAAa,GAAG,wBAAwB;QAAE,OAAO,KAAK,CAAC;IAClE,IAAI,MAAM,CAAC,iBAAiB,GAAG,4BAA4B;QAAE,OAAO,KAAK,CAAC;IAC1E,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAuB;IACxD,IAAI,CAAC,MAAM,CAAC,iBAAiB;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,MAAM,CAAC,QAAQ,KAAK,UAAU,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAuB,EACvB,OAAoD;IAEpD,IAAI,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/B,OAAO;YACL,IAAI,EAAE,eAAe;YACrB,SAAS,EAAE,MAAM,CAAC,iBAAkB;YACpC,MAAM,EAAE,oDAAoD;SAC7D,CAAC;IACJ,CAAC;IAED,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,OAAO;YACL,IAAI,EAAE,cAAc;YACpB,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,cAAc,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;YAC3F,WAAW,EAAE,kCAAkC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACzE,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,SAAS,EAAE,MAAM,CAAC,aAAa;SAChC,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}