@qodo/sdk 0.13.4 → 2.0.0-next.0

package/dist/skills/events.d.ts

@@ -0,0 +1,255 @@
+/**
+ * Skills event factories.
+ *
+ * Single source of truth for constructing every `sdk.skill.*` event the
+ * skills layer emits. Call sites import the matching factory rather than
+ * hand-building the discriminated-union object literal, so the wire shape
+ * stays consistent across the codebase and a new field on an event lands
+ * in exactly one place.
+ *
+ * Each factory mirrors the discriminator key on the closed `SkillEvent`
+ * union in `types.ts`; the return type narrows to the matching variant so
+ * downstream consumers see the precise event shape they expect.
+ *
+ * Doc table: `knowledge/doc/skills.md` §9 cross-references each event to
+ * its emission point in the codebase.
+ */
+import type { ParsedSkill, SkillEvent, SkillEventSeverity, SkillSource, SkillTrustTier } from './types.js';
+export declare function skillSourceScanned(args: {
+    source: SkillSource;
+    durationMs: number;
+    count: number;
+    errors: number;
+}): Extract<SkillEvent, {
+    kind: 'sdk.skill.source_scanned';
+}>;
+export declare function skillDiscovered(args: {
+    fqn: string;
+    source: SkillSource;
+    version: string;
+    trustTier: SkillTrustTier;
+}): Extract<SkillEvent, {
+    kind: 'sdk.skill.discovered';
+}>;
+export declare function skillShadowed(args: {
+    fqn: string;
+    winner: {
+        source: SkillSource;
+        version: string;
+    };
+    loser: {
+        source: SkillSource;
+        version: string;
+    };
+}): Extract<SkillEvent, {
+    kind: 'sdk.skill.shadowed';
+}>;
+export declare function skillError(args: {
+    source?: SkillSource;
+    path?: string;
+    severity: SkillEventSeverity;
+    message: string;
+}): Extract<SkillEvent, {
+    kind: 'sdk.skill.error';
+}>;
+export declare function skillUnknownField(args: {
+    path: string;
+    field: string;
+}): Extract<SkillEvent, {
+    kind: 'sdk.skill.unknown_field';
+}>;
+export declare function skillIndexed(args: {
+    catalogSize: number;
+    includedCount: number;
+    source: 'all' | 'truncated' | 'embedding';
+    charsUsed: number;
+}): Extract<SkillEvent, {
+    kind: 'sdk.skill.indexed';
+}>;
+export declare function skillIndexTruncated(args: {
+    reason: 'no_embedder' | 'embedder_failed' | 'over_budget';
+    omittedCount: number;
+}): Extract<SkillEvent, {
+    kind: 'sdk.skill.index_truncated';
+}>;
+export declare function skillIndexFiltered(args: {
+    catalogSize: number;
+    includedCount: number;
+    scoreFloor: number;
+    scoreCeiling: number;
+    embedderId: string;
+}): Extract<SkillEvent, {
+    kind: 'sdk.skill.index_filtered';
+}>;
+export declare function skillIndexOverflowPinned(args: {
+    skill: string;
+    charsRequired: number;
+    budget: number;
+}): Extract<SkillEvent, {
+    kind: 'sdk.skill.index_overflow_pinned';
+}>;
+export declare function skillPinOmitted(args: {
+    skill: string;
+    reason: 'budget_hard_cap_exceeded';
+    charsUsed: number;
+    hardCap: number;
+}): Extract<SkillEvent, {
+    kind: 'sdk.skill.pin_omitted';
+}>;
+export declare function skillActivated(args: {
+    skill: string;
+    source: 'caller' | 'llm';
+    tier: SkillTrustTier;
+}): Extract<SkillEvent, {
+    kind: 'sdk.skill.activated';
+}>;
+export declare function skillLoaded(args: {
+    skill: string;
+    bytes: number;
+    cached: boolean;
+}): Extract<SkillEvent, {
+    kind: 'sdk.skill.loaded';
+}>;
+export declare function skillFileLoaded(args: {
+    skill: string;
+    path: string;
+    bytes: number;
+    cached: boolean;
+}): Extract<SkillEvent, {
+    kind: 'sdk.skill.file_loaded';
+}>;
+export declare function skillFileRejected(args: {
+    skill: string;
+    path: string;
+    reason: string;
+}): Extract<SkillEvent, {
+    kind: 'sdk.skill.file_rejected';
+}>;
+export declare function skillInvocationDenied(args: {
+    skill: string;
+    reason: Extract<SkillEvent, {
+        kind: 'sdk.skill.invocation_denied';
+    }>['reason'];
+}): Extract<SkillEvent, {
+    kind: 'sdk.skill.invocation_denied';
+}>;
+export declare function skillTierAssigned(args: {
+    skill: string;
+    tier: SkillTrustTier;
+}): Extract<SkillEvent, {
+    kind: 'sdk.skill.tier_assigned';
+}>;
+export declare function skillAllowedToolsApplied(args: {
+    skill: string;
+    tools: readonly string[];
+}): Extract<SkillEvent, {
+    kind: 'sdk.skill.allowed_tools_applied';
+}>;
+export declare function skillAllowedToolsAdvisory(args: {
+    skill: string;
+    tools: readonly string[];
+}): Extract<SkillEvent, {
+    kind: 'sdk.skill.allowed_tools_advisory';
+}>;
+export declare function skillAllowedToolsUnmatched(args: {
+    skill: string;
+    missing: readonly string[];
+}): Extract<SkillEvent, {
+    kind: 'sdk.skill.allowed_tools_unmatched';
+}>;
+export declare function skillHooksIgnored(args: {
+    skill: string;
+}): Extract<SkillEvent, {
+    kind: 'sdk.skill.hooks_ignored';
+}>;
+export declare function skillDisableModelInvocationOverridden(args: {
+    skill: string;
+    source: 'caller';
+}): Extract<SkillEvent, {
+    kind: 'sdk.skill.disable_model_invocation_overridden';
+}>;
+export declare function skillRequiresTrustDenied(args: {
+    parent: string;
+    child: string;
+    reason: string;
+}): Extract<SkillEvent, {
+    kind: 'sdk.skill.requires_trust_denied';
+}>;
+export declare function skillRequiresCapExceeded(args: {
+    parent: string;
+    kind_breach: 'depth' | 'breadth' | 'token_budget';
+    limit: number;
+    actual: number;
+}): Extract<SkillEvent, {
+    kind: 'sdk.skill.requires_cap_exceeded';
+}>;
+export declare function skillSubstitutionWarn(args: {
+    skill: string;
+    reference: string;
+    reason: 'out_of_bounds' | 'unknown_named' | 'malformed';
+}): Extract<SkillEvent, {
+    kind: 'sdk.skill.substitution_warn';
+}>;
+export declare function skillLockDrift(args: {
+    fqn: string;
+    expectedSha256: string;
+    actualSha256: string;
+}): Extract<SkillEvent, {
+    kind: 'sdk.skill.lock_drift';
+}>;
+export declare function skillLockUnreachable(args: {
+    fqn: string;
+    source: SkillSource;
+}): Extract<SkillEvent, {
+    kind: 'sdk.skill.lock_unreachable';
+}>;
+export declare function skillPreprocessExecuted(args: {
+    skill: string;
+    command: string;
+    mode: Extract<SkillEvent, {
+        kind: 'sdk.skill.preprocess_executed';
+    }>['mode'];
+    durationMs: number;
+    exitCode: number | null;
+    outputBytes: number;
+    truncated: boolean;
+    timedOut: boolean;
+}): Extract<SkillEvent, {
+    kind: 'sdk.skill.preprocess_executed';
+}>;
+export declare function skillPreprocessBlocked(args: {
+    skill: string;
+    command: string;
+    reason: Extract<SkillEvent, {
+        kind: 'sdk.skill.preprocess_blocked';
+    }>['reason'];
+}): Extract<SkillEvent, {
+    kind: 'sdk.skill.preprocess_blocked';
+}>;
+export declare function skillForkDeclined(args: {
+    skill: string;
+    agent?: string;
+    reason: 'no_multi_agent';
+}): Extract<SkillEvent, {
+    kind: 'sdk.skill.fork_declined';
+}>;
+export declare function skillRemoved(args: {
+    fqn: string;
+    source: SkillSource;
+}): Extract<SkillEvent, {
+    kind: 'sdk.skill.removed';
+}>;
+export declare function skillCatalogEpochBumped(args: {
+    from: number;
+    to: number;
+    reason: 'initial_discover' | 'watcher_event';
+}): Extract<SkillEvent, {
+    kind: 'sdk.skill.catalog_epoch_bumped';
+}>;
+export declare const SKILL_EVENT_KINDS: readonly ["sdk.skill.source_scanned", "sdk.skill.discovered", "sdk.skill.shadowed", "sdk.skill.error", "sdk.skill.unknown_field", "sdk.skill.indexed", "sdk.skill.index_truncated", "sdk.skill.index_filtered", "sdk.skill.index_overflow_pinned", "sdk.skill.pin_omitted", "sdk.skill.loaded", "sdk.skill.file_loaded", "sdk.skill.file_rejected", "sdk.skill.invocation_denied", "sdk.skill.activated", "sdk.skill.disable_model_invocation_overridden", "sdk.skill.allowed_tools_applied", "sdk.skill.allowed_tools_advisory", "sdk.skill.allowed_tools_unmatched", "sdk.skill.hooks_ignored", "sdk.skill.tier_assigned", "sdk.skill.requires_trust_denied", "sdk.skill.requires_cap_exceeded", "sdk.skill.substitution_warn", "sdk.skill.lock_drift", "sdk.skill.lock_unreachable", "sdk.skill.preprocess_executed", "sdk.skill.preprocess_blocked", "sdk.skill.fork_declined", "sdk.skill.removed", "sdk.skill.catalog_epoch_bumped"];
+export declare function eventSubjectFqn(event: SkillEvent): string | null;
+/** Type-narrowing helper exporting the skill associated with a ParsedSkill payload. */
+export declare function tierAssignedFor(skill: ParsedSkill): Extract<SkillEvent, {
+    kind: 'sdk.skill.tier_assigned';
+}>;
+//# sourceMappingURL=events.d.ts.map

package/dist/skills/events.d.ts.map

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

package/dist/skills/events.js

@@ -0,0 +1,224 @@
+/**
+ * Skills event factories.
+ *
+ * Single source of truth for constructing every `sdk.skill.*` event the
+ * skills layer emits. Call sites import the matching factory rather than
+ * hand-building the discriminated-union object literal, so the wire shape
+ * stays consistent across the codebase and a new field on an event lands
+ * in exactly one place.
+ *
+ * Each factory mirrors the discriminator key on the closed `SkillEvent`
+ * union in `types.ts`; the return type narrows to the matching variant so
+ * downstream consumers see the precise event shape they expect.
+ *
+ * Doc table: `knowledge/doc/skills.md` §9 cross-references each event to
+ * its emission point in the codebase.
+ */
+// ---------------------------------------------------------------------------
+// Discovery pipeline events
+// ---------------------------------------------------------------------------
+export function skillSourceScanned(args) {
+    return { kind: 'sdk.skill.source_scanned', ...args };
+}
+export function skillDiscovered(args) {
+    return { kind: 'sdk.skill.discovered', ...args };
+}
+export function skillShadowed(args) {
+    return { kind: 'sdk.skill.shadowed', ...args };
+}
+export function skillError(args) {
+    return {
+        kind: 'sdk.skill.error',
+        severity: args.severity,
+        message: args.message,
+        ...(args.source !== undefined ? { source: args.source } : {}),
+        ...(args.path !== undefined ? { path: args.path } : {}),
+    };
+}
+export function skillUnknownField(args) {
+    return { kind: 'sdk.skill.unknown_field', ...args };
+}
+// ---------------------------------------------------------------------------
+// Slim-index render events
+// ---------------------------------------------------------------------------
+export function skillIndexed(args) {
+    return { kind: 'sdk.skill.indexed', ...args };
+}
+export function skillIndexTruncated(args) {
+    return { kind: 'sdk.skill.index_truncated', ...args };
+}
+export function skillIndexFiltered(args) {
+    return { kind: 'sdk.skill.index_filtered', ...args };
+}
+export function skillIndexOverflowPinned(args) {
+    return { kind: 'sdk.skill.index_overflow_pinned', ...args };
+}
+export function skillPinOmitted(args) {
+    return { kind: 'sdk.skill.pin_omitted', ...args };
+}
+// ---------------------------------------------------------------------------
+// Activation pipeline events
+// ---------------------------------------------------------------------------
+export function skillActivated(args) {
+    return { kind: 'sdk.skill.activated', ...args };
+}
+export function skillLoaded(args) {
+    return { kind: 'sdk.skill.loaded', ...args };
+}
+export function skillFileLoaded(args) {
+    return { kind: 'sdk.skill.file_loaded', ...args };
+}
+export function skillFileRejected(args) {
+    return { kind: 'sdk.skill.file_rejected', ...args };
+}
+export function skillInvocationDenied(args) {
+    return { kind: 'sdk.skill.invocation_denied', ...args };
+}
+export function skillTierAssigned(args) {
+    return { kind: 'sdk.skill.tier_assigned', ...args };
+}
+export function skillAllowedToolsApplied(args) {
+    return { kind: 'sdk.skill.allowed_tools_applied', ...args };
+}
+export function skillAllowedToolsAdvisory(args) {
+    return { kind: 'sdk.skill.allowed_tools_advisory', ...args };
+}
+export function skillAllowedToolsUnmatched(args) {
+    return { kind: 'sdk.skill.allowed_tools_unmatched', ...args };
+}
+export function skillHooksIgnored(args) {
+    return { kind: 'sdk.skill.hooks_ignored', ...args };
+}
+export function skillDisableModelInvocationOverridden(args) {
+    return { kind: 'sdk.skill.disable_model_invocation_overridden', ...args };
+}
+export function skillRequiresTrustDenied(args) {
+    return { kind: 'sdk.skill.requires_trust_denied', ...args };
+}
+export function skillRequiresCapExceeded(args) {
+    return { kind: 'sdk.skill.requires_cap_exceeded', ...args };
+}
+// ---------------------------------------------------------------------------
+// Argument substitution
+// ---------------------------------------------------------------------------
+export function skillSubstitutionWarn(args) {
+    return { kind: 'sdk.skill.substitution_warn', ...args };
+}
+// ---------------------------------------------------------------------------
+// Lockfile drift / unreachable
+// ---------------------------------------------------------------------------
+export function skillLockDrift(args) {
+    return { kind: 'sdk.skill.lock_drift', ...args };
+}
+export function skillLockUnreachable(args) {
+    return { kind: 'sdk.skill.lock_unreachable', ...args };
+}
+// ---------------------------------------------------------------------------
+// `!command` preprocessing — richer payload on `preprocess_executed`,
+// narrower reason set on `preprocess_blocked`.
+// ---------------------------------------------------------------------------
+export function skillPreprocessExecuted(args) {
+    return { kind: 'sdk.skill.preprocess_executed', ...args };
+}
+export function skillPreprocessBlocked(args) {
+    return { kind: 'sdk.skill.preprocess_blocked', ...args };
+}
+// ---------------------------------------------------------------------------
+// `context: fork` advisory
+// ---------------------------------------------------------------------------
+export function skillForkDeclined(args) {
+    return { kind: 'sdk.skill.fork_declined', ...args };
+}
+// ---------------------------------------------------------------------------
+// Hot reload
+// ---------------------------------------------------------------------------
+export function skillRemoved(args) {
+    return { kind: 'sdk.skill.removed', ...args };
+}
+export function skillCatalogEpochBumped(args) {
+    return { kind: 'sdk.skill.catalog_epoch_bumped', ...args };
+}
+// ---------------------------------------------------------------------------
+// Catalog of every emitted event kind. Tested-against to detect drift; if
+// the union grows a new variant, this array must grow too.
+// ---------------------------------------------------------------------------
+export const SKILL_EVENT_KINDS = [
+    'sdk.skill.source_scanned',
+    'sdk.skill.discovered',
+    'sdk.skill.shadowed',
+    'sdk.skill.error',
+    'sdk.skill.unknown_field',
+    'sdk.skill.indexed',
+    'sdk.skill.index_truncated',
+    'sdk.skill.index_filtered',
+    'sdk.skill.index_overflow_pinned',
+    'sdk.skill.pin_omitted',
+    'sdk.skill.loaded',
+    'sdk.skill.file_loaded',
+    'sdk.skill.file_rejected',
+    'sdk.skill.invocation_denied',
+    'sdk.skill.activated',
+    'sdk.skill.disable_model_invocation_overridden',
+    'sdk.skill.allowed_tools_applied',
+    'sdk.skill.allowed_tools_advisory',
+    'sdk.skill.allowed_tools_unmatched',
+    'sdk.skill.hooks_ignored',
+    'sdk.skill.tier_assigned',
+    'sdk.skill.requires_trust_denied',
+    'sdk.skill.requires_cap_exceeded',
+    'sdk.skill.substitution_warn',
+    'sdk.skill.lock_drift',
+    'sdk.skill.lock_unreachable',
+    'sdk.skill.preprocess_executed',
+    'sdk.skill.preprocess_blocked',
+    'sdk.skill.fork_declined',
+    'sdk.skill.removed',
+    'sdk.skill.catalog_epoch_bumped',
+];
+// ---------------------------------------------------------------------------
+// Type-narrowing helper — used by consumer-side OTel adapters.
+// ---------------------------------------------------------------------------
+export function eventSubjectFqn(event) {
+    switch (event.kind) {
+        case 'sdk.skill.discovered':
+        case 'sdk.skill.shadowed':
+        case 'sdk.skill.lock_drift':
+        case 'sdk.skill.lock_unreachable':
+        case 'sdk.skill.removed':
+            return event.fqn;
+        case 'sdk.skill.loaded':
+        case 'sdk.skill.file_loaded':
+        case 'sdk.skill.file_rejected':
+        case 'sdk.skill.invocation_denied':
+        case 'sdk.skill.activated':
+        case 'sdk.skill.disable_model_invocation_overridden':
+        case 'sdk.skill.allowed_tools_applied':
+        case 'sdk.skill.allowed_tools_advisory':
+        case 'sdk.skill.allowed_tools_unmatched':
+        case 'sdk.skill.hooks_ignored':
+        case 'sdk.skill.tier_assigned':
+        case 'sdk.skill.substitution_warn':
+        case 'sdk.skill.preprocess_executed':
+        case 'sdk.skill.preprocess_blocked':
+        case 'sdk.skill.fork_declined':
+        case 'sdk.skill.pin_omitted':
+        case 'sdk.skill.index_overflow_pinned':
+            return event.skill;
+        case 'sdk.skill.requires_trust_denied':
+        case 'sdk.skill.requires_cap_exceeded':
+            return event.parent;
+        case 'sdk.skill.source_scanned':
+        case 'sdk.skill.error':
+        case 'sdk.skill.unknown_field':
+        case 'sdk.skill.indexed':
+        case 'sdk.skill.index_truncated':
+        case 'sdk.skill.catalog_epoch_bumped':
+        case 'sdk.skill.index_filtered':
+            return null;
+    }
+}
+/** Type-narrowing helper exporting the skill associated with a ParsedSkill payload. */
+export function tierAssignedFor(skill) {
+    return { kind: 'sdk.skill.tier_assigned', skill: skill.fqn, tier: skill.trustTier };
+}
+//# sourceMappingURL=events.js.map

package/dist/skills/events.js.map

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

package/dist/skills/index.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Public surface of the skills foundation.
+ *
+ * Consumers reach the skills layer two ways:
+ *
+ *   1. Via `ClientOptions.skills` at `new QodoClient()` time. The client
+ *      owns a `SkillsManager` instance and the `tasks.startWithAgent` /
+ *      `tasks.startWithGraph` paths auto-inject the slim index into
+ *      inline-agent `instructions`. Consumers don't have to call any
+ *      skills API directly for the common case.
+ *   2. Via `client.skills` for direct introspection: `await
+ *      client.skills.list()` returns the catalog, `await client.skills.get('foo')`
+ *      resolves a specifier. Useful for UIs that want to surface the
+ *      available skills before dispatch.
+ *
+ * The foundation includes parser + validator + manager + renderer +
+ * injection helpers + the in-process `qodo-skills` MCP server for
+ * runtime `get_skill` / `list_skills` / `get_skill_file` tool calls,
+ * trust enforcement, lockfile, and hot reload.
+ */
+export { SkillsManager, SkillNotFoundError, SkillAmbiguousPinError, SkillsBudgetExceededError, QodoSkillError, } from './manager.js';
+export type { CatalogSnapshot, ResolvedRequiresCaps, SkillGetOptions } from './manager.js';
+export { isSkillTrusted, SkillsTrustConfigError, sourceIdentityKey, validateTrustedSources, } from './trust.js';
+export { activationFailureMessage, lookupFromSnapshot, renderActiveSkillsBlock, resolveActivationGraph, resolveAllActivations, } from './activation.js';
+export type { ActivationGraph, ActivationGraphResult, ActiveSkillsRenderResult, MultiActivationResult, SkillLookup, } from './activation.js';
+export { renderSlimIndex } from './render.js';
+export type { RenderOptions, RenderResult } from './render.js';
+export { injectIntoAgentSpec, injectIntoGraphSpec } from './inject.js';
+export type { InjectionResult } from './inject.js';
+export { parseSkillDocument, SkillParseError } from './parser.js';
+export type { FrontmatterParseResult } from './parser.js';
+export { parseArgv, substitute, substituteWithArgumentsTrailer, } from './substitute.js';
+export type { SubstitutionContext, SubstitutionResult, SubstitutionWarning, } from './substitute.js';
+export { SKILL_EVENT_KINDS, eventSubjectFqn, skillActivated, skillAllowedToolsAdvisory, skillAllowedToolsApplied, skillAllowedToolsUnmatched, skillDisableModelInvocationOverridden, skillDiscovered, skillError, skillFileLoaded, skillFileRejected, skillForkDeclined, skillHooksIgnored, skillIndexOverflowPinned, skillIndexTruncated, skillIndexed, skillInvocationDenied, skillLoaded, skillLockDrift, skillLockUnreachable, skillPinOmitted, skillPreprocessBlocked, skillPreprocessExecuted, skillRemoved, skillRequiresCapExceeded, skillRequiresTrustDenied, skillShadowed, skillSourceScanned, skillSubstitutionWarn, skillTierAssigned, skillUnknownField, tierAssignedFor, } from './events.js';
+export { findCommandBlocks, isAllowlisted, parseFirstToken, POWERSHELL_GATE_ENV_VAR, preprocessBody, substituteQodoVars, } from './preprocess.js';
+export type { PreprocessContext, PreprocessResult } from './preprocess.js';
+export { cosine, fnv1a32, prefilterCatalog, skillEmbedText, SkillEmbeddingCache, } from './prefilter.js';
+export type { PrefilterOptions, PrefilterOutcome } from './prefilter.js';
+export { validateFrontmatter, validateBody } from './validator.js';
+export type { ValidatedFrontmatter, ValidatedBody, ValidationIssue } from './validator.js';
+export { LOCKFILE_BASENAME, LOCKFILE_SCHEMA_VERSION, LockfileParseError, LockfileValidationError, buildLockfile, computeSkillHash, findLockfile, loadLockfile, parseLockfile, validateLockfileEntry, writeLockfile, } from './lockfile.js';
+export type { Lockfile, LockfileEntry, LockfileValidation } from './lockfile.js';
+export type { AllowedToolEntry, ParsedSkill, SkillArgument, SkillEmbedder, SkillEvent, SkillEventKind, SkillEventSeverity, SkillFrontmatter, SkillSource, SkillSourceType, SkillSpecifier, SkillTrustTier, SkillsConfig, SkillsEventSink, SkillsActivationConfig, SkillsPreprocessingConfig, SkillsPreprocessingMode, SkillsRequiresConfig, } from './types.js';
+export { ACTIVATION_DEFAULT_MIN_SCORE, ACTIVATION_DEFAULT_TOP_K, DEFAULT_INDEX_CHAR_BUDGET, DEFAULT_SOURCE_ORDER, PREPROCESS_DEFAULT_MAX_OUTPUT_BYTES, PREPROCESS_DEFAULT_TIMEOUT_MS, REQUIRES_DEFAULT_MAX_DEPTH, REQUIRES_DEFAULT_MAX_TRANSITIVE, REQUIRES_DEFAULT_MAX_TRANSITIVE_TOKENS, SKILL_BODY_HARD_BYTES, SKILL_BODY_SOFT_LINES, SKILL_NAME_MAX_CHARS, SKILL_NAME_RESERVED_WORDS, SLIM_INDEX_ENTRY_BUDGET, SOURCE_DEFAULT_VENDORS, SOURCE_TRUST_TIERS, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/skills/index.js

@@ -0,0 +1,34 @@
+/**
+ * Public surface of the skills foundation.
+ *
+ * Consumers reach the skills layer two ways:
+ *
+ *   1. Via `ClientOptions.skills` at `new QodoClient()` time. The client
+ *      owns a `SkillsManager` instance and the `tasks.startWithAgent` /
+ *      `tasks.startWithGraph` paths auto-inject the slim index into
+ *      inline-agent `instructions`. Consumers don't have to call any
+ *      skills API directly for the common case.
+ *   2. Via `client.skills` for direct introspection: `await
+ *      client.skills.list()` returns the catalog, `await client.skills.get('foo')`
+ *      resolves a specifier. Useful for UIs that want to surface the
+ *      available skills before dispatch.
+ *
+ * The foundation includes parser + validator + manager + renderer +
+ * injection helpers + the in-process `qodo-skills` MCP server for
+ * runtime `get_skill` / `list_skills` / `get_skill_file` tool calls,
+ * trust enforcement, lockfile, and hot reload.
+ */
+export { SkillsManager, SkillNotFoundError, SkillAmbiguousPinError, SkillsBudgetExceededError, QodoSkillError, } from './manager.js';
+export { isSkillTrusted, SkillsTrustConfigError, sourceIdentityKey, validateTrustedSources, } from './trust.js';
+export { activationFailureMessage, lookupFromSnapshot, renderActiveSkillsBlock, resolveActivationGraph, resolveAllActivations, } from './activation.js';
+export { renderSlimIndex } from './render.js';
+export { injectIntoAgentSpec, injectIntoGraphSpec } from './inject.js';
+export { parseSkillDocument, SkillParseError } from './parser.js';
+export { parseArgv, substitute, substituteWithArgumentsTrailer, } from './substitute.js';
+export { SKILL_EVENT_KINDS, eventSubjectFqn, skillActivated, skillAllowedToolsAdvisory, skillAllowedToolsApplied, skillAllowedToolsUnmatched, skillDisableModelInvocationOverridden, skillDiscovered, skillError, skillFileLoaded, skillFileRejected, skillForkDeclined, skillHooksIgnored, skillIndexOverflowPinned, skillIndexTruncated, skillIndexed, skillInvocationDenied, skillLoaded, skillLockDrift, skillLockUnreachable, skillPinOmitted, skillPreprocessBlocked, skillPreprocessExecuted, skillRemoved, skillRequiresCapExceeded, skillRequiresTrustDenied, skillShadowed, skillSourceScanned, skillSubstitutionWarn, skillTierAssigned, skillUnknownField, tierAssignedFor, } from './events.js';
+export { findCommandBlocks, isAllowlisted, parseFirstToken, POWERSHELL_GATE_ENV_VAR, preprocessBody, substituteQodoVars, } from './preprocess.js';
+export { cosine, fnv1a32, prefilterCatalog, skillEmbedText, SkillEmbeddingCache, } from './prefilter.js';
+export { validateFrontmatter, validateBody } from './validator.js';
+export { LOCKFILE_BASENAME, LOCKFILE_SCHEMA_VERSION, LockfileParseError, LockfileValidationError, buildLockfile, computeSkillHash, findLockfile, loadLockfile, parseLockfile, validateLockfileEntry, writeLockfile, } from './lockfile.js';
+export { ACTIVATION_DEFAULT_MIN_SCORE, ACTIVATION_DEFAULT_TOP_K, DEFAULT_INDEX_CHAR_BUDGET, DEFAULT_SOURCE_ORDER, PREPROCESS_DEFAULT_MAX_OUTPUT_BYTES, PREPROCESS_DEFAULT_TIMEOUT_MS, REQUIRES_DEFAULT_MAX_DEPTH, REQUIRES_DEFAULT_MAX_TRANSITIVE, REQUIRES_DEFAULT_MAX_TRANSITIVE_TOKENS, SKILL_BODY_HARD_BYTES, SKILL_BODY_SOFT_LINES, SKILL_NAME_MAX_CHARS, SKILL_NAME_RESERVED_WORDS, SLIM_INDEX_ENTRY_BUDGET, SOURCE_DEFAULT_VENDORS, SOURCE_TRUST_TIERS, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,yBAAyB,EACzB,cAAc,GACf,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AASzB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9C,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGvE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGlE,OAAO,EACL,SAAS,EACT,UAAU,EACV,8BAA8B,GAC/B,MAAM,iBAAiB,CAAC;AAOzB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,EAC1B,qCAAqC,EACrC,eAAe,EACf,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,EACnB,YAAY,EACZ,qBAAqB,EACrB,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,sBAAsB,EACtB,uBAAuB,EACvB,YAAY,EACZ,wBAAwB,EACxB,wBAAwB,EACxB,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,uBAAuB,EACvB,cAAc,EACd,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,MAAM,EACN,OAAO,EACP,gBAAgB,EAChB,cAAc,EACd,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGnE,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,qBAAqB,EACrB,aAAa,GACd,MAAM,eAAe,CAAC;AAwBvB,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,EACpB,mCAAmC,EACnC,6BAA6B,EAC7B,0BAA0B,EAC1B,+BAA+B,EAC/B,sCAAsC,EACtC,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/skills/inject.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Slim-index injection.
+ *
+ * Couples the pure renderer (`./render.ts`) to the wire shapes:
+ * `InlineAgentSpec` (Pattern B) and `InlineGraphSpec` (Pattern C). The
+ * SDK 2.0 by-id path (`tasks.start({ agent_id })`) has no `instructions`
+ * field on the wire — the agent body lives on QAR's side — so the SDK
+ * cannot inject for that variant.
+ *
+ * The rendered text appends to the consumer's existing `instructions`
+ * content. Injection helpers are pure: input = spec + catalog, output =
+ * new spec. No side effects.
+ */
+import type { InlineAgentSpec, InlineGraphSpec } from '../qar/specs.js';
+import type { SkillsManager } from './manager.js';
+import { type RenderOptions } from './render.js';
+import type { ParsedSkill, SkillEvent } from './types.js';
+/**
+ * Result of an injection pass. The caller dispatches `events` to the
+ * configured telemetry sink (the renderer doesn't know about it). Both
+ * `spec` and `inserted` reflect the post-injection state.
+ */
+export interface InjectionResult<TSpec> {
+    /** Spec with slim index appended to its `instructions`. */
+    readonly spec: TSpec;
+    /** `true` iff anything was actually appended. False on empty catalog. */
+    readonly inserted: boolean;
+    /** Skills that landed in the slim index. */
+    readonly included: readonly ParsedSkill[];
+    /** Telemetry events the renderer produced. */
+    readonly events: readonly SkillEvent[];
+    /**
+     * Pinned skills the renderer omitted because rendering them would
+     * push the block past the absolute hard cap (F5). Non-empty signals
+     * the SDK boundary to throw `SkillsBudgetExceededError`.
+     */
+    readonly omittedPinned: readonly ParsedSkill[];
+}
+/**
+ * Append the rendered slim index to a single `InlineAgentSpec`'s
+ * `instructions` field. Mutates nothing; returns a new spec.
+ *
+ * For `Instructions === string`: append the rendered block on a new line.
+ * For `Instructions === InstructionsPreset`: append into the preset's
+ * `append` field (creating it if absent).
+ *
+ * Returns the original spec unchanged when the catalog is empty.
+ */
+export declare function injectIntoAgentSpec(spec: InlineAgentSpec, manager: SkillsManager, opts?: RenderOptions): InjectionResult<InlineAgentSpec>;
+/**
+ * Walk every agent inside an `InlineGraphSpec` and apply the slim-index
+ * injection to nodes whose `spec` is an `InlineAgentSpec`. Static-ref
+ * nodes (`{ agent_id }`) and recursive sub-graphs are returned untouched
+ * (the static ref has no client-side instructions; sub-graphs recurse).
+ */
+export declare function injectIntoGraphSpec(graph: InlineGraphSpec, manager: SkillsManager, opts?: RenderOptions): InjectionResult<InlineGraphSpec>;
+//# sourceMappingURL=inject.d.ts.map