@qodo/sdk 0.13.3 → 2.0.0-next.0

package/dist/skills/types.d.ts

@@ -0,0 +1,627 @@
+/**
+ * Skills foundation types.
+ *
+ * SDK 2.0 is a thin typed wire binding to QAR (Qodo Agent Runtime); it does
+ * not execute agents. Skills here are a *consumer-side* concept: the SDK
+ * reads `SKILL.md` files from the configured sources, builds an in-memory
+ * catalog, and injects a slim `<available_skills>` index into
+ * `InlineAgentSpec.instructions` so the QAR-side model loop sees what
+ * skills exist. Runtime body loading lives in the `qodo-skills` MCP
+ * server.
+ *
+ * The frontmatter shape mirrors the Agent Skills open standard
+ * (`name` / `description` / `when_to_use` / `allowed-tools` / ...) plus
+ * Qodo extensions (`vendor`, `version`, `min_sdk_version`, `requires`).
+ * Unknown fields are preserved on `unknown_fields` so forward-compat is
+ * by silence, not error.
+ */
+import type { JsonValue } from '../qar/json.js';
+/**
+ * Type tag for a source's trust derivation. Set at discovery time from
+ * the source type; the trust layer gates `allowed-tools` / preprocessing
+ * / `disable-model-invocation` waivers off this value.
+ *
+ * Stored on every `ParsedSkill` so downstream consumers (and the future
+ * trust ticket) read it without re-walking the source list. Three tiers:
+ *
+ *   - `'trusted'` — `project`, `config`, `bundled`. The consumer's own
+ *     code-reviewed surfaces.
+ *   - `'operator'` — `user`. Local-machine; trusted by virtue of being on
+ *     the operator's box, but not in the project's source tree.
+ *   - `'third-party'` — `package`, `cli-fetched`. Authored by someone the
+ *     consumer didn't write the code of.
+ */
+export type SkillTrustTier = 'trusted' | 'operator' | 'third-party';
+/**
+ * One configured discovery source. The default precedence is
+ * project > config > user > package > cli-fetched > bundled.
+ *
+ * Each variant carries its own optional `path` / `packageName` / `ref`
+ * fields per `skills-discovery.md` §1.
+ */
+export type SkillSource = {
+    readonly type: 'project';
+    readonly path?: string;
+} | {
+    readonly type: 'config';
+    readonly path: string;
+} | {
+    readonly type: 'user';
+    readonly path?: string;
+} | {
+    readonly type: 'package';
+    readonly packageName: string;
+    readonly path?: string;
+} | {
+    readonly type: 'cli-fetched';
+    readonly ref?: string;
+} | {
+    readonly type: 'bundled';
+    readonly path?: string;
+};
+/** The discriminator for `SkillSource`. */
+export type SkillSourceType = SkillSource['type'];
+/**
+ * Parsed `allowed-tools` entry. The standard accepts both a flat tool name
+ * (`Read`) and the tool-with-args form (`Bash(git:*)`); both normalize to
+ * this shape with `args === undefined` for the bare case.
+ */
+export interface AllowedToolEntry {
+    readonly tool: string;
+    readonly args?: string;
+}
+/**
+ * Named-argument descriptor from `arguments:` frontmatter. Per the standard,
+ * authors can declare positional names so the body can reference `$issue`
+ * instead of `$1`.
+ *
+ * The standard's syntax is informal; we accept either a string list (bare
+ * names) or an object list (`{ name, description? }`). The parser
+ * normalizes to this shape.
+ */
+export interface SkillArgument {
+    readonly name: string;
+    readonly description?: string;
+}
+/**
+ * Skill frontmatter — the open standard's surface plus the Qodo extensions
+ * documented in `skills.md` §2. Every field is optional at the type level;
+ * the validator enforces shape rules and emits `sdk.skill.error` events for
+ * the violations the SDK considers fatal.
+ *
+ * Unknown fields stay on `unknown_fields` for forward compatibility; the
+ * raw object is also preserved on `raw` so a later wave that needs a field
+ * the SDK doesn't know about yet can read it without re-parsing.
+ */
+export interface SkillFrontmatter {
+    readonly name?: string;
+    readonly description?: string;
+    readonly when_to_use?: string;
+    readonly 'allowed-tools'?: readonly AllowedToolEntry[];
+    readonly 'disable-model-invocation'?: boolean;
+    readonly 'user-invocable'?: boolean;
+    readonly model?: string;
+    readonly effort?: 'low' | 'medium' | 'high' | 'max';
+    readonly context?: 'fork' | 'inherit';
+    readonly agent?: string;
+    readonly paths?: readonly string[];
+    readonly arguments?: readonly SkillArgument[];
+    readonly 'argument-hint'?: string;
+    readonly shell?: 'bash' | 'powershell';
+    readonly hooks?: JsonValue;
+    readonly vendor?: string;
+    readonly version?: string;
+    readonly min_sdk_version?: string;
+    readonly requires?: readonly string[];
+    /** Unknown frontmatter fields preserved verbatim. Emits `sdk.skill.unknown_field` at parse. */
+    readonly unknown_fields?: Readonly<Record<string, JsonValue>>;
+}
+/**
+ * One catalog entry — the result of parsing + validating a `SKILL.md`.
+ *
+ * The `fqn` is the catalog key: `<vendor>/<name>@<version>`. Bare-name
+ * and `<vendor>/<name>` lookups resolve to the latest version.
+ *
+ * `body` carries the post-frontmatter markdown verbatim. The slim-index
+ * renderer reads `frontmatter.description` + `frontmatter.when_to_use`;
+ * the body is served to the model via the `get_skill` MCP tool.
+ */
+export interface ParsedSkill {
+    /** Fully-qualified identifier — `<vendor>/<name>@<version>`. Catalog key. */
+    readonly fqn: string;
+    /** `<vendor>/<name>` — version-stripped. Used for shadowing / latest-version lookups. */
+    readonly fqnNoVersion: string;
+    readonly name: string;
+    readonly vendor: string;
+    readonly version: string;
+    /** Absolute path to the skill directory. */
+    readonly path: string;
+    /** Absolute path to the `SKILL.md` file inside the directory. */
+    readonly skillFile: string;
+    /** Modification time of `SKILL.md` (epoch ms). Used by the slim-index truncation order. */
+    readonly mtimeMs: number;
+    /** Parsed frontmatter — fields per the open standard + Qodo extensions. */
+    readonly frontmatter: SkillFrontmatter;
+    /** Markdown body verbatim, with frontmatter stripped. */
+    readonly body: string;
+    /** Source this skill was discovered from. */
+    readonly source: SkillSource;
+    /** Trust tier derived from `source.type` (operator / trusted / third-party). */
+    readonly trustTier: SkillTrustTier;
+    /** Raw frontmatter object — preserves unknown fields, used by forward-compat readers. */
+    readonly raw: JsonValue;
+}
+/**
+ * Embedding pre-filter interface for catalogs that overflow the
+ * slim-index budget.
+ */
+export interface SkillEmbedder {
+    readonly id: string;
+    readonly dim: number;
+    embed(text: string | readonly string[]): Promise<readonly (readonly number[])[]>;
+}
+/**
+ * Caller-pinned skill specifier. Either a bare name (`'code-review'`),
+ * a fully-qualified name without version (`'qodo/code-review'`), or a
+ * fully-qualified-with-version (`'qodo/code-review@1.2.0'`).
+ */
+export type SkillSpecifier = string;
+/**
+ * `!command` preprocessing policy.
+ *
+ * - `disabled` — `!command` blocks left literal; no execution; default.
+ * - `allowlisted` — block executes only if the parsed first token matches
+ *   one of `allow`. Non-matches replaced with a disable marker; the
+ *   skill still loads.
+ * - `full` — every block executes. Reserved for trusted environments;
+ *   third-party skills always bypass this mode (tier gate).
+ *
+ * Defaults: `timeoutMs: 5000`, `maxOutputBytes: 64_000`.
+ */
+export type SkillsPreprocessingMode = 'disabled' | 'allowlisted' | 'full';
+export interface SkillsPreprocessingConfig {
+    readonly mode: SkillsPreprocessingMode;
+    /**
+     * Left-anchored command-name allowlist used when `mode: 'allowlisted'`.
+     * Matched against the first shell-tokenized argv of the command line
+     * AFTER `${QODO_*}` substitution. Bare command names match (`git`),
+     * absolute / path-bearing forms must match exactly
+     * (`/usr/bin/jq`). Wildcards are not supported — list each command
+     * explicitly.
+     */
+    readonly allow?: readonly string[];
+    /** Hard kill timeout, default 5000 ms. */
+    readonly timeoutMs?: number;
+    /** Per-command stdout+stderr cap, default 64 KB. */
+    readonly maxOutputBytes?: number;
+    /** Optional override cwd. Defaults to the skill's directory (`${QODO_SKILL_DIR}`). */
+    readonly cwd?: string;
+}
+/** Preprocessing config defaults — exported so tests stay in sync with the runtime. */
+export declare const PREPROCESS_DEFAULT_TIMEOUT_MS = 5000;
+export declare const PREPROCESS_DEFAULT_MAX_OUTPUT_BYTES: number;
+/**
+ * Per-render activation tuning for the optional embedding pre-filter.
+ * The pre-filter only kicks in when the catalog can't fit in the
+ * slim-index budget AND an embedder is configured; otherwise these
+ * fields are ignored.
+ */
+export interface SkillsActivationConfig {
+    /** Top-K skills to keep after cosine ranking. Default 8. */
+    readonly topK?: number;
+    /** Minimum cosine similarity (after `normalize`) to include. Default 0.35. */
+    readonly minScore?: number;
+}
+/** Default top-K when `SkillsConfig.activation.topK` is unset. */
+export declare const ACTIVATION_DEFAULT_TOP_K = 8;
+/** Default minimum cosine score when `SkillsConfig.activation.minScore` is unset. */
+export declare const ACTIVATION_DEFAULT_MIN_SCORE = 0.35;
+/**
+ * Public config object accepted as `ClientOptions.skills`. Each field is
+ * optional and degrades gracefully when omitted:
+ *
+ *   - `sources` — discovery list, highest precedence first. Omitted ⇒ the
+ *     default order (`project`, `user`, `bundled`). Passing `[]`
+ *     disables skills entirely (catalog stays empty).
+ *   - `activate` — caller-pinned skills applied as the constructor-level
+ *     default. Per-call `tasks.startWithAgent({ ..., skills })` overrides.
+ *   - `trustedSources` — opt-in trust elevation for `package` /
+ *     `cli-fetched` sources.
+ *   - `embedder` — pre-filter for catalogs > slim-index budget.
+ *   - `indexCharBudget` — total cap for the rendered `<available_skills>`
+ *     block. Default `8000` (the SDK doesn't know the model's context
+ *     window without a runtime lookup, so the conservative cap wins).
+ *   - `preprocessing` — `!command` policy.
+ *   - `watch` — dev-only hot reload.
+ *   - `emit` — optional telemetry sink. The SDK calls this once per
+ *     `sdk.skill.*` event. Omitting it suppresses telemetry; no events
+ *     emit by default.
+ */
+export interface SkillsConfig {
+    readonly sources?: readonly SkillSource[];
+    /**
+     * Caller-pinned skills applied as the constructor-level default. Per-call
+     * `tasks.startWithAgent({ skills })` overrides per the
+     * `undefined` / `[]` / named-array semantics in `skills-activation.md` §2.
+     *
+     * **Trust scoping.** `activate` (and the per-call `TaskOptions.skills`)
+     * is a **trusted-application-code input**, not an end-user input. Caller
+     * pinning bypasses the trust gate that blocks model-driven loading of
+     * third-party skills — that's intentional: the caller is the
+     * human-in-the-loop signal. If a consumer plumbs `activate` from an
+     * end-user-controlled surface (a Slack message, a URL param), the
+     * consumer **must** apply its own allowlist before forwarding to the
+     * SDK.
+     */
+    readonly activate?: readonly SkillSpecifier[];
+    /**
+     * Opt-in allowlist of source identities trusted at the same level as
+     * `bundled` / `project` / `user`. Entries key on **immutable source
+     * identity** — npm package name (`'@anthropic-skills/core'`), the
+     * full `<type>:<discriminator>` key (`'package:@anthropic-skills/core'`,
+     * `'config:my-skills.json'`), or the literals `'project'` / `'user'`
+     * / `'bundled'`. Vendor-name strings from frontmatter are **never**
+     * accepted — a malicious package could declare
+     * `vendor: anthropic-skills` and inherit pre-existing opt-ins.
+     *
+     * The validator runs at `SkillsManager` construction; entries that don't
+     * match a configured source identity throw `SkillsTrustConfigError`.
+     * Wildcards (`*`) are rejected — list each source explicitly.
+     */
+    readonly trustedSources?: readonly string[];
+    readonly embedder?: SkillEmbedder | undefined;
+    readonly indexCharBudget?: number;
+    readonly preprocessing?: SkillsPreprocessingConfig;
+    /**
+     * Caps applied to the `requires:` resolution graph at activation
+     * time. Defense against malicious or malformed dependency chains.
+     * Any breach causes the parent's activation to fail closed with
+     * `sdk.skill.requires_cap_exceeded`.
+     */
+    readonly requires?: SkillsRequiresConfig;
+    /**
+     * Tuning for the optional embedding pre-filter. Ignored when
+     * `embedder` is not configured.
+     */
+    readonly activation?: SkillsActivationConfig;
+    readonly watch?: boolean;
+    readonly emit?: SkillsEventSink;
+    /**
+     * SDK semver used for `min_sdk_version` compatibility checks. The default
+     * reads `package.json`; tests inject a value so they don't have to
+     * round-trip through the package surface.
+     */
+    readonly sdkVersion?: string;
+    /**
+     * Lockfile policy. When set to `'discover'` (the default), the
+     * manager searches `qodo.lock.yaml` at the configured CWD and beside
+     * `agent.toml`; when set to `{ path }`, that path is loaded directly;
+     * when `'off'`, no lockfile is consulted regardless of on-disk state.
+     *
+     * On drift or unreachable, boot throws `LockfileValidationError` and
+     * emits `sdk.skill.lock_drift` / `sdk.skill.lock_unreachable`. Skills
+     * not in the lockfile are still discovered + included.
+     */
+    readonly lockfile?: 'discover' | 'off' | {
+        readonly path: string;
+    };
+}
+/**
+ * Caps on `requires:` chain resolution. All three are independent —
+ * the resolver fails closed on the first breach.
+ */
+export interface SkillsRequiresConfig {
+    /** Maximum nesting depth of the resolution chain. Default `3`. */
+    readonly maxDepth?: number;
+    /** Maximum transitive (non-root) dependencies. Default `8`. */
+    readonly maxTransitive?: number;
+    /** Maximum sum of activated body sizes in bytes. Default `50 * 1024`. */
+    readonly maxTransitiveTokens?: number;
+}
+/** Resolved cap defaults used when `SkillsConfig.requires` fields are absent. */
+export declare const REQUIRES_DEFAULT_MAX_DEPTH = 3;
+export declare const REQUIRES_DEFAULT_MAX_TRANSITIVE = 8;
+export declare const REQUIRES_DEFAULT_MAX_TRANSITIVE_TOKENS: number;
+export type SkillEventSeverity = 'error' | 'warning' | 'info';
+/**
+ * Closed union of `sdk.skill.*` events emitted across discovery,
+ * rendering, activation, MCP runtime, preprocessing, lockfile, and
+ * hot-reload. `kind`-discriminated so consumers `switch (ev.kind)`
+ * cleanly.
+ */
+export type SkillEvent = {
+    readonly kind: 'sdk.skill.source_scanned';
+    readonly source: SkillSource;
+    readonly durationMs: number;
+    readonly count: number;
+    readonly errors: number;
+} | {
+    readonly kind: 'sdk.skill.discovered';
+    readonly fqn: string;
+    readonly source: SkillSource;
+    readonly version: string;
+    readonly trustTier: SkillTrustTier;
+} | {
+    readonly kind: 'sdk.skill.shadowed';
+    readonly fqn: string;
+    readonly winner: {
+        readonly source: SkillSource;
+        readonly version: string;
+    };
+    readonly loser: {
+        readonly source: SkillSource;
+        readonly version: string;
+    };
+} | {
+    readonly kind: 'sdk.skill.error';
+    readonly source?: SkillSource;
+    readonly path?: string;
+    readonly severity: SkillEventSeverity;
+    readonly message: string;
+} | {
+    readonly kind: 'sdk.skill.unknown_field';
+    readonly path: string;
+    readonly field: string;
+} | {
+    readonly kind: 'sdk.skill.indexed';
+    readonly catalogSize: number;
+    readonly includedCount: number;
+    readonly source: 'all' | 'truncated' | 'embedding';
+    readonly charsUsed: number;
+} | {
+    readonly kind: 'sdk.skill.index_truncated';
+    readonly reason: 'no_embedder' | 'embedder_failed' | 'over_budget';
+    readonly omittedCount: number;
+} | {
+    /**
+     * Emitted on a successful embedding-prefilter pass: the
+     * catalog was larger than the slim-index budget, an embedder was
+     * configured, and ranking by cosine similarity reduced the
+     * candidate set to `includedCount`. Caller-pinned skills are
+     * always counted.
+     *
+     * `scoreFloor` is the lowest cosine score that made the cut;
+     * `scoreCeiling` is the highest. When the ranked set is empty
+     * (every survivor is pinned / transitive-pinned and nothing was
+     * scored), both fields are emitted as `0` (NOT `±Infinity`) so
+     * the wire payload serialises cleanly. Use `includedCount` vs
+     * caller-pinned size to tell "no ranking happened" apart from
+     * "ranking happened and everything cleared at score 0".
+     */
+    readonly kind: 'sdk.skill.index_filtered';
+    readonly catalogSize: number;
+    readonly includedCount: number;
+    readonly scoreFloor: number;
+    readonly scoreCeiling: number;
+    readonly embedderId: string;
+} | {
+    readonly kind: 'sdk.skill.index_overflow_pinned';
+    readonly skill: string;
+    readonly charsRequired: number;
+    readonly budget: number;
+} | {
+    readonly kind: 'sdk.skill.pin_omitted';
+    readonly skill: string;
+    readonly reason: 'budget_hard_cap_exceeded';
+    readonly charsUsed: number;
+    readonly hardCap: number;
+} | {
+    readonly kind: 'sdk.skill.loaded';
+    readonly skill: string;
+    readonly bytes: number;
+    readonly cached: boolean;
+} | {
+    readonly kind: 'sdk.skill.file_loaded';
+    readonly skill: string;
+    readonly path: string;
+    readonly bytes: number;
+    readonly cached: boolean;
+} | {
+    readonly kind: 'sdk.skill.file_rejected';
+    readonly skill: string;
+    readonly path: string;
+    readonly reason: string;
+} | {
+    readonly kind: 'sdk.skill.invocation_denied';
+    readonly skill: string;
+    readonly reason: 'not_found' | 'user_invocable_only' | 'third_party_without_trust' | 'min_sdk_version_unmet' | 'requires_cycle' | 'requires_unresolved' | 'requires_trust_violation' | 'requires_cap_exceeded';
+} | {
+    readonly kind: 'sdk.skill.activated';
+    readonly skill: string;
+    readonly source: 'caller' | 'llm';
+    readonly tier: SkillTrustTier;
+} | {
+    /**
+     * Caller pin overrode the skill's `disable-model-invocation: true`
+     * gate. Audit-only — caller intent is treated as the human-in-the-loop
+     * waiver per `skills-activation.md` §2.85.
+     */
+    readonly kind: 'sdk.skill.disable_model_invocation_overridden';
+    readonly skill: string;
+    readonly source: 'caller';
+} | {
+    /**
+     * `allowed-tools` was honored — tools are eligible for auto-approval
+     * while the skill is active. Emitted on trusted-tier activation
+     * (or third-party + `trustedSources` opt-in).
+     *
+     * SDK 2.0 doesn't own the model loop, so the SDK records the intent
+     * via this event for downstream observability + future auto-approval
+     * wire field; effective auto-approval is QAR-side.
+     */
+    readonly kind: 'sdk.skill.allowed_tools_applied';
+    readonly skill: string;
+    readonly tools: readonly string[];
+} | {
+    /**
+     * Third-party skill's `allowed-tools` parsed but NOT honored. Surfaces
+     * what the skill *would* grant if added to `trustedSources`.
+     */
+    readonly kind: 'sdk.skill.allowed_tools_advisory';
+    readonly skill: string;
+    readonly tools: readonly string[];
+} | {
+    /**
+     * One or more entries in a skill's `allowed-tools` referenced tools
+     * that don't exist in the configured MCP catalog. The skill still
+     * activates; the missing tools just won't be auto-approved.
+     */
+    readonly kind: 'sdk.skill.allowed_tools_unmatched';
+    readonly skill: string;
+    readonly missing: readonly string[];
+} | {
+    /**
+     * Third-party skill declared lifecycle `hooks:` that were ignored.
+     * Hooks are too powerful to gate by content-substring; for the
+     * third-party tier the only safe policy is "never honor"
+     * (`skills-trust.md` §6).
+     */
+    readonly kind: 'sdk.skill.hooks_ignored';
+    readonly skill: string;
+} | {
+    /**
+     * Trust tier was assigned at discovery time. Emitted once per skill
+     * during catalog construction for security-audit log replay.
+     * (`skills-trust.md` §7.)
+     */
+    readonly kind: 'sdk.skill.tier_assigned';
+    readonly skill: string;
+    readonly tier: SkillTrustTier;
+} | {
+    /**
+     * A skill's `requires:` chain pulled in a third-party dependency
+     * whose source isn't in `trustedSources`. Parent activation fails
+     * closed; no partial body leak (`skills-trust.md` §3 — "requires
+     * enforces the trust gate transitively").
+     */
+    readonly kind: 'sdk.skill.requires_trust_denied';
+    readonly parent: string;
+    readonly child: string;
+    readonly reason: string;
+} | {
+    /**
+     * A `requires:` chain breached one of the three caps (depth /
+     * breadth / token budget). Parent activation fails closed.
+     */
+    readonly kind: 'sdk.skill.requires_cap_exceeded';
+    readonly parent: string;
+    readonly kind_breach: 'depth' | 'breadth' | 'token_budget';
+    readonly limit: number;
+    readonly actual: number;
+} | {
+    readonly kind: 'sdk.skill.substitution_warn';
+    readonly skill: string;
+    readonly reference: string;
+    readonly reason: 'out_of_bounds' | 'unknown_named' | 'malformed';
+} | {
+    readonly kind: 'sdk.skill.lock_drift';
+    readonly fqn: string;
+    readonly expectedSha256: string;
+    readonly actualSha256: string;
+} | {
+    readonly kind: 'sdk.skill.lock_unreachable';
+    readonly fqn: string;
+    readonly source: SkillSource;
+} | {
+    /**
+     * A `!command` block was rendered but its execution was suppressed.
+     *
+     * Reasons:
+     *   - `'tier_third_party'` — skill is third-party; tier gate blocks
+     *     all execution regardless of mode.
+     *   - `'not_allowlisted'` — `allowlisted` mode and the first
+     *     argv token was not in `allow` (or any line in a multi-line
+     *     body failed the allowlist gate).
+     *   - `'powershell_disabled'` — skill declared `shell: powershell`
+     *     but the consumer hasn't set the env-var gate.
+     */
+    readonly kind: 'sdk.skill.preprocess_blocked';
+    readonly skill: string;
+    readonly command: string;
+    readonly reason: 'tier_third_party' | 'not_allowlisted' | 'powershell_disabled';
+} | {
+    /**
+     * A `!command` block was executed and its output spliced into the
+     * rendered body. Emitted for every execution, including errors.
+     */
+    readonly kind: 'sdk.skill.preprocess_executed';
+    readonly skill: string;
+    readonly command: string;
+    readonly mode: SkillsPreprocessingMode;
+    readonly durationMs: number;
+    /** Process exit code; `null` when the process was killed by timeout. */
+    readonly exitCode: number | null;
+    /** Bytes of stdout+stderr buffered (post-truncation). */
+    readonly outputBytes: number;
+    /** `true` iff output exceeded `maxOutputBytes` and was cut. */
+    readonly truncated: boolean;
+    /** `true` iff timeout fired and the process was killed. */
+    readonly timedOut: boolean;
+} | {
+    readonly kind: 'sdk.skill.fork_declined';
+    readonly skill: string;
+    readonly agent?: string;
+    readonly reason: 'no_multi_agent';
+} | {
+    /**
+     * A previously-discovered skill no longer satisfies discovery
+     * (file deleted, parse error introduced, source path removed).
+     * Emitted during a watcher-triggered rebuild only — the initial
+     * `discover()` has no prior catalog to diff against.
+     */
+    readonly kind: 'sdk.skill.removed';
+    readonly fqn: string;
+    readonly source: SkillSource;
+} | {
+    /**
+     * The catalog epoch counter advanced. Every successful rebuild
+     * (initial discover OR watcher-triggered rebuild that produced
+     * any delta) increments the epoch by one.
+     *
+     * Body caches that key by `(fqn, epoch)` evict stale entries
+     * once no in-flight run references them; this event surfaces
+     * the bump so observability dashboards can correlate cache-miss
+     * rate with hot-reload activity.
+     */
+    readonly kind: 'sdk.skill.catalog_epoch_bumped';
+    readonly from: number;
+    readonly to: number;
+    readonly reason: 'initial_discover' | 'watcher_event';
+};
+/** The kind discriminator value for `SkillEvent`. */
+export type SkillEventKind = SkillEvent['kind'];
+/** Optional consumer-supplied telemetry sink. Errors thrown inside are caught and ignored. */
+export type SkillsEventSink = (event: SkillEvent) => void;
+/**
+ * Per-entry `description + when_to_use` cap in the slim index. Mirrors
+ * Claude Code's `SLASH_COMMAND_TOOL_CHAR_BUDGET` so OSS skills land
+ * identically.
+ */
+export declare const SLIM_INDEX_ENTRY_BUDGET = 1536;
+/** Default total cap on the `<available_skills>` block. */
+export declare const DEFAULT_INDEX_CHAR_BUDGET = 8000;
+/** Hard cap on `SKILL.md` body size — exclusion threshold. */
+export declare const SKILL_BODY_HARD_BYTES: number;
+/**
+ * Hard cap on total `SKILL.md` file size (frontmatter + body + structure)
+ * enforced *before* `fs.readFile` — files larger than this are rejected
+ * with `sdk.skill.error` severity `'error'` and never read into memory.
+ * Comfortably above `SKILL_BODY_HARD_BYTES` so a generous frontmatter
+ * fits, but tight enough to defend against a third-party `package` /
+ * `cli-fetched` source shipping multi-megabyte SKILL.md files —
+ * defense-in-depth against DoS via unbounded `fs.readFile`.
+ */
+export declare const SKILL_FILE_HARD_BYTES: number;
+/** Soft cap on `SKILL.md` body lines — emits warning, does not exclude. */
+export declare const SKILL_BODY_SOFT_LINES = 500;
+/** Max chars in a skill `name`. Reserved-word + character-class checks live in the validator. */
+export declare const SKILL_NAME_MAX_CHARS = 64;
+/** Reserved words a skill `name` cannot include (case-insensitive substring). */
+export declare const SKILL_NAME_RESERVED_WORDS: readonly string[];
+/** Default `vendor` per source type. Frontmatter `vendor:` overrides. */
+export declare const SOURCE_DEFAULT_VENDORS: Readonly<Record<SkillSourceType, string>>;
+/** Trust tier per source type. Mirror of `SkillTrustTier` documentation. */
+export declare const SOURCE_TRUST_TIERS: Readonly<Record<SkillSourceType, SkillTrustTier>>;
+/** Default precedence (highest first). */
+export declare const DEFAULT_SOURCE_ORDER: readonly SkillSourceType[];
+//# sourceMappingURL=types.d.ts.map

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

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