@senpi/runtime 3.0.149 → 3.0.153

package/dist/prompt/skill-router-hook.d.ts

@@ -0,0 +1,24 @@
+import { type WarnLogger } from "../skill-router/classify-client.js";
+import { type SessionContextSeedHookPluginApi } from "./session-context-seed-hook.js";
+/** The plugin API surface this hook needs (the seed hook's, with `timeoutMs`). */
+export type SkillRouterHookPluginApi = SessionContextSeedHookPluginApi;
+export type SkillRouterMode = "off" | "shadow" | "on";
+/** What registration did: nothing, the real handler in a mode, or the error-emitting stub. */
+export type SkillRouterRegistration = SkillRouterMode | "stub";
+export interface RegisterSkillRouterHookOptions {
+    api: SkillRouterHookPluginApi;
+    /** The box's per-user Senpi token, resolved like the OTel user token in `register()`. */
+    token: string | undefined;
+    /** The skills manager's search path, `resolveSkillsManagerConfig(...).skillsDir`. */
+    searchPath: readonly string[];
+    /** The plugin logger, for the one-time configuration warnings. */
+    logger: WarnLogger;
+    /** Where the router's env vars are read from, once. Defaults to `process.env`. */
+    env?: Readonly<Record<string, string | undefined>>;
+    /** Test seams. */
+    fetch?: typeof fetch;
+    now?: () => number;
+    manifestNames?: readonly string[];
+}
+export declare function registerSkillRouterHook(options: RegisterSkillRouterHookOptions): SkillRouterRegistration;
+//# sourceMappingURL=skill-router-hook.d.ts.map

package/dist/prompt/skill-router-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-router-hook.d.ts","sourceRoot":"","sources":["../../src/prompt/skill-router-hook.ts"],"names":[],"mappings":"AA8BA,OAAO,EAA4C,KAAK,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAG/G,OAAO,EAAgB,KAAK,+BAA+B,EAAE,MAAM,gCAAgC,CAAC;AAIpG,kFAAkF;AAClF,MAAM,MAAM,wBAAwB,GAAG,+BAA+B,CAAC;AAEvE,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,GAAG,IAAI,CAAC;AAEtD,8FAA8F;AAC9F,MAAM,MAAM,uBAAuB,GAAG,eAAe,GAAG,MAAM,CAAC;AAE/D,MAAM,WAAW,8BAA8B;IAC7C,GAAG,EAAE,wBAAwB,CAAC;IAC9B,yFAAyF;IACzF,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,qFAAqF;IACrF,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,kEAAkE;IAClE,MAAM,EAAE,UAAU,CAAC;IACnB,kFAAkF;IAClF,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IACnD,kBAAkB;IAClB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAMD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,8BAA8B,GAAG,uBAAuB,CA2BxG"}

package/dist/prompt/skill-router-hook.js

@@ -0,0 +1,362 @@
+/**
+ * registerSkillRouterHook: the per-turn skill pointer (ticket skill-router/06).
+ *
+ * On an eligible user turn the `before_prompt_build` handler sends the user's message (envelope
+ * stripped, `preparePromptForClassify`) and the names and versions of the installed skills to
+ * senpi-backend's classify endpoint, narrows the server's `fired` list to what this box may point
+ * at (`resolveInjectable`), and, in mode `on` only, returns a short `prependContext` naming at most
+ * two skills. Every eligible turn emits one `skill_router.decision`; a failure also emits one
+ * `skill_router.error`.
+ *
+ * `SENPI_SKILL_ROUTER` (`off` | `shadow` | `on`, default `off`) is read once at registration:
+ * - `off` or an unknown value registers nothing;
+ * - `shadow` classifies and logs in the background and returns at once, so it never delays a turn;
+ * - `on` awaits the decision (the client's own 1,500 ms budget) and injects the pointer.
+ * A box in `shadow` or `on` with no bearer or a bad `SENPI_SKILL_ROUTER_URL` registers a stub that
+ * emits one `skill_router.error` on its first eligible turn and never calls the endpoint.
+ *
+ * Non-negotiables: the handler never throws (the shadow path included) and any failure means no
+ * injection; no prompt text, prompt hash, token or URL override is ever logged; nothing from the
+ * response body is interpolated into the pointer (names are the catalog's strings, scores are
+ * validated numbers formatted here); the bearer goes only to the validated `*.senpi.ai` origin.
+ */
+import { createLogger } from "../utils/logger.js";
+import { EVENT_NAME, eventAttrs, } from "../utils/event-catalog.js";
+import { createSkillCatalog, skillsForRequest } from "../skill-router/catalog.js";
+import { createClassifyClient, resolveClassifyUrl } from "../skill-router/classify-client.js";
+import { preparePromptForClassify } from "../skill-router/prompt.js";
+import { resolveInjectable, resolveLocalFloor } from "../skill-router/resolve.js";
+import { isSeedPrompt } from "./session-context-seed-hook.js";
+const telemetry = createLogger("[senpi-runtime][skill-router]");
+const MODE_ENV_NAME = "SENPI_SKILL_ROUTER";
+/** OpenClaw's per-hook timeout, a backstop above the client's own 1,500 ms abort. */
+const HOOK_TIMEOUT_MS = 2000;
+export function registerSkillRouterHook(options) {
+    const env = options.env ?? process.env;
+    const mode = resolveMode(env[MODE_ENV_NAME], options.logger);
+    if (mode === "off")
+        return "off";
+    const url = resolveClassifyUrl(env.SENPI_SKILL_ROUTER_URL, options.logger);
+    const token = typeof options.token === "string" && options.token.length > 0 ? options.token : undefined;
+    if (token === undefined) {
+        options.logger.warn("[senpi-runtime][skill-router] no Senpi token (apiKey, SENPI_AUTH_TOKEN or SENPI_API_KEY) is set; the skill router is disabled");
+    }
+    if (url === undefined || token === undefined) {
+        registerStub(options.api, mode, url === undefined ? "bad_url" : "no_bearer");
+        return "stub";
+    }
+    const handler = createRouterHandler({
+        mode,
+        client: createClassifyClient({ url, token, fetch: options.fetch, now: options.now }),
+        catalog: createSkillCatalog({ searchPath: options.searchPath }),
+        floor: resolveLocalFloor(env.SENPI_SKILL_ROUTER_FLOOR, options.logger),
+        manifestNames: options.manifestNames,
+        now: options.now ?? Date.now,
+    });
+    options.api.on("before_prompt_build", handler, { timeoutMs: HOOK_TIMEOUT_MS });
+    return mode;
+}
+function resolveMode(raw, logger) {
+    const value = raw?.trim().toLowerCase() ?? "";
+    if (value === "shadow" || value === "on")
+        return value;
+    if (value !== "" && value !== "off") {
+        logger.warn(`[senpi-runtime][skill-router] ${MODE_ENV_NAME} is not off, shadow or on; the skill router is off`);
+    }
+    return "off";
+}
+/**
+ * A misconfigured box in `shadow` or `on`: emit one `skill_router.error` on the first eligible turn
+ * (not at registration, where the OTel SDK may not be up yet and the record could be lost), then do
+ * nothing forever. It never calls the endpoint.
+ */
+function registerStub(api, mode, code) {
+    let reported = false;
+    api.on("before_prompt_build", (event, agentCtx) => {
+        try {
+            if (reported)
+                return undefined;
+            const turn = readEligibleTurn(event, agentCtx);
+            if (turn === undefined)
+                return undefined;
+            reported = true;
+            emitError({ ...joinAttrs(turn, mode), "senpi.skill_router.status": 0, "senpi.skill_router.code": code });
+        }
+        catch {
+            // Telemetry must never break prompt building.
+        }
+        return undefined;
+    }, { timeoutMs: HOOK_TIMEOUT_MS });
+}
+/** One decision per OpenClaw `runId`: 2026.5.7 can build the prompt more than once per run. */
+const RUN_MEMO_MAX_ENTRIES = 100;
+const RUN_MEMO_TTL_MS = 10 * 60 * 1000;
+function createRouterHandler(deps) {
+    // Search-path indexes already reported as `catalog_unreadable` (once per directory per process).
+    const reportedDirs = new Set();
+    const decisions = createRunMemo(deps.now);
+    return async (event, agentCtx) => {
+        try {
+            const turn = readEligibleTurn(event, agentCtx);
+            if (turn === undefined)
+                return undefined;
+            // A repeat attempt for the same run reuses the decision: no second call, no second event.
+            let decision = turn.runId === undefined ? undefined : decisions.get(turn.runId);
+            if (decision === undefined) {
+                decision = decideOnce(deps, reportedDirs, turn);
+                if (turn.runId !== undefined)
+                    decisions.set(turn.runId, decision);
+            }
+            // Shadow injects nothing, so it doesn't wait: the call and its telemetry finish in the background.
+            if (deps.mode === "shadow") {
+                // decideOnce never rejects; the catch is a last guard against an unhandled rejection.
+                decision.catch(() => undefined);
+                return undefined;
+            }
+            const pointer = await decision;
+            return pointer === undefined ? undefined : { prependContext: pointer };
+        }
+        catch (err) {
+            logHandlerFailure(err);
+            return undefined;
+        }
+    };
+}
+/**
+ * {@link decide}, made total: it never rejects, so the background shadow path can't surface an
+ * unhandled rejection. A throw (none is expected: every helper it calls is documented never-throw)
+ * still records the turn's one decision, as `error` / `hook_error`, unless one was already emitted,
+ * and one `skill_router.error` so the failure counts in the error rate. Those emits are guarded
+ * too: a throwing logger must not turn into a rejection.
+ */
+async function decideOnce(deps, reportedDirs, turn) {
+    const progress = { decided: false };
+    try {
+        return await decide(deps, reportedDirs, turn, progress);
+    }
+    catch (err) {
+        logHandlerFailure(err);
+        try {
+            const join = joinAttrs(turn, deps.mode);
+            emitError({ ...join, "senpi.skill_router.status": 0, "senpi.skill_router.code": "hook_error" });
+            if (!progress.decided) {
+                emitDecisionEvent({
+                    ...join,
+                    "senpi.skill_router.outcome": "error",
+                    "senpi.skill_router.code": "hook_error",
+                    "senpi.skill_router.envelope_stripped": false,
+                    "senpi.skill_router.injected": false,
+                });
+            }
+        }
+        catch {
+            // Telemetry must never break prompt building.
+        }
+        return undefined;
+    }
+}
+/** Only the error's class: a message could quote the prompt, and nothing here may log it. */
+function logHandlerFailure(err) {
+    try {
+        telemetry.warn("skill router handler failed", undefined, {
+            "error.type": err instanceof Error ? err.name : typeof err,
+        });
+    }
+    catch {
+        // Logging must never break prompt building.
+    }
+}
+/** Classify one turn and emit its telemetry. Resolves to the pointer text in `on`, else `undefined`. */
+async function decide(deps, reportedDirs, turn, progress) {
+    const join = joinAttrs(turn, deps.mode);
+    const emitDecision = (attrs) => {
+        progress.decided = true;
+        emitDecisionEvent(attrs);
+    };
+    const prepared = preparePromptForClassify(turn.prompt);
+    if (!prepared.ok) {
+        // The skip reason is the outcome (reset, inter-session, empty, and any reason the hygiene adds).
+        emitDecision({
+            ...join,
+            "senpi.skill_router.outcome": prepared.reason,
+            "senpi.skill_router.envelope_stripped": prepared.envelopeStripped,
+            "senpi.skill_router.injected": false,
+        });
+        return undefined;
+    }
+    const promptAttrs = {
+        "senpi.skill_router.prompt_length": prepared.length,
+        "senpi.skill_router.prompt_truncated": prepared.truncated,
+        "senpi.skill_router.envelope_stripped": prepared.envelopeStripped,
+    };
+    const snapshot = await deps.catalog.read();
+    for (const index of snapshot.unreadableDirs) {
+        if (reportedDirs.has(index))
+            continue;
+        reportedDirs.add(index);
+        emitError({
+            ...join,
+            "senpi.skill_router.status": 0,
+            "senpi.skill_router.code": "catalog_unreadable",
+            "senpi.skill_router.dir_index": index,
+        });
+    }
+    const sent = skillsForRequest(snapshot, deps.manifestNames);
+    if (sent.length === 0) {
+        emitDecision({
+            ...join,
+            ...promptAttrs,
+            "senpi.skill_router.outcome": "no_skills",
+            "senpi.skill_router.skills_sent": 0,
+            "senpi.skill_router.injected": false,
+        });
+        return undefined;
+    }
+    const result = await deps.client.classify({ prompt: prepared.prompt, skills: sent });
+    if (!result.ok) {
+        if (result.code === "backoff") {
+            // An open Retry-After window: no call was made, so the decision alone records it.
+            emitDecision({
+                ...join,
+                ...promptAttrs,
+                "senpi.skill_router.outcome": "backoff",
+                "senpi.skill_router.code": result.code,
+                "senpi.skill_router.skills_sent": sent.length,
+                "senpi.skill_router.retry_after_sec": result.retryAfterSec,
+                "senpi.skill_router.latency_ms": result.latencyMs,
+                "senpi.skill_router.injected": false,
+            });
+            return undefined;
+        }
+        emitError({
+            ...join,
+            "senpi.skill_router.status": result.status,
+            "senpi.skill_router.code": result.code,
+            "senpi.skill_router.reason": result.reason,
+            "senpi.skill_router.latency_ms": result.latencyMs,
+            "senpi.skill_router.retry_after_sec": result.retryAfterSec,
+        });
+        emitDecision({
+            ...join,
+            ...promptAttrs,
+            "senpi.skill_router.outcome": "error",
+            "senpi.skill_router.code": result.code,
+            "senpi.skill_router.skills_sent": sent.length,
+            "senpi.skill_router.latency_ms": result.latencyMs,
+            "senpi.skill_router.injected": false,
+        });
+        return undefined;
+    }
+    const { injectable } = resolveInjectable({ result, sent, catalog: snapshot, floor: deps.floor });
+    const pointer = deps.mode === "on" ? formatPointer(injectable) : undefined;
+    emitDecision({
+        ...join,
+        ...promptAttrs,
+        "senpi.skill_router.outcome": "classified",
+        "senpi.skill_router.decision_id": result.decisionId,
+        "senpi.skill_router.criteria_version": result.criteriaVersion,
+        "senpi.skill_router.model": result.model,
+        "senpi.skill_router.skills_sent": sent.length,
+        "senpi.skill_router.unknown_count": result.unknownCount,
+        "senpi.skill_router.ignored_count": result.ignored,
+        "senpi.skill_router.unanswered_count": result.unansweredCount,
+        "senpi.skill_router.scores": JSON.stringify(result.scores),
+        "senpi.skill_router.fired": JSON.stringify(result.fired),
+        "senpi.skill_router.injectable": JSON.stringify(injectable.map((s) => s.name)),
+        "senpi.skill_router.floor": deps.floor,
+        "senpi.skill_router.injected": pointer !== undefined,
+        "senpi.skill_router.latency_ms": result.latencyMs,
+        "senpi.skill_router.server_latency_ms": result.serverLatencyMs,
+        "senpi.skill_router.usage_input_tokens": result.usage.inputTokens,
+        "senpi.skill_router.usage_output_tokens": result.usage.outputTokens,
+        "senpi.skill_router.usage_cost_usd": result.usage.costUsd,
+    });
+    return pointer;
+}
+/**
+ * The pointer the model sees (PRD, "What it injects"). The names are the catalog's own strings and
+ * the scores validated numbers, formatted here; nothing from the response body is interpolated.
+ */
+function formatPointer(injectable) {
+    if (injectable.length === 0)
+        return undefined;
+    const matches = injectable.map((s) => `${s.name} (${s.score.toFixed(2)})`).join(", ");
+    const instruction = injectable.length === 1
+        ? "Read that skill's SKILL.md and follow it before calling any tools. Do not answer from raw tool output or general knowledge where the skill defines the procedure."
+        : "Read those skills' SKILL.md files and follow them before calling any tools. Do not answer from raw tool output or general knowledge where the skills define the procedure.";
+    return `[senpi skill routing] This question matches: ${matches}.\n${instruction}`;
+}
+function emitDecisionEvent(attrs) {
+    telemetry.event(EVENT_NAME.skillRouterDecision, "info", {
+        body: "Skill router decision",
+        attributes: eventAttrs(attrs),
+    });
+}
+function emitError(attrs) {
+    telemetry.event(EVENT_NAME.skillRouterError, "warn", {
+        body: "Skill router error",
+        attributes: eventAttrs(attrs),
+    });
+}
+/** A small TTL map, capped by evicting the oldest insert. */
+function createRunMemo(now) {
+    const entries = new Map();
+    return {
+        get(key) {
+            const entry = entries.get(key);
+            if (entry === undefined)
+                return undefined;
+            if (entry.expiresAt <= now()) {
+                entries.delete(key);
+                return undefined;
+            }
+            return entry.value;
+        },
+        set(key, value) {
+            const at = now();
+            for (const [k, e] of entries)
+                if (e.expiresAt <= at)
+                    entries.delete(k);
+            while (entries.size >= RUN_MEMO_MAX_ENTRIES) {
+                const oldest = entries.keys().next().value;
+                if (oldest === undefined)
+                    break;
+                entries.delete(oldest);
+            }
+            entries.set(key, { value, expiresAt: at + RUN_MEMO_TTL_MS });
+        },
+    };
+}
+/**
+ * A turn the router looks at (OpenClaw 2026.5.7 `before_prompt_build`, ctx at
+ * `selection-BeP8qtCb.js:7924-7935`): a user-triggered turn (not `heartbeat`, `cron`, `memory` or
+ * `manual`), outside a subagent or cron session, with a non-empty prompt that is not a
+ * session-context seed. Only `event.prompt` is read, never `event.messages`.
+ */
+function readEligibleTurn(event, agentCtx) {
+    const ctx = asRecord(agentCtx);
+    if (ctx?.trigger !== "user")
+        return undefined;
+    const sessionKey = nonEmptyString(ctx.sessionKey);
+    if (sessionKey !== undefined && (sessionKey.includes("subagent:") || sessionKey.includes("cron:"))) {
+        return undefined;
+    }
+    const prompt = asRecord(event)?.prompt;
+    if (typeof prompt !== "string" || prompt.length === 0 || isSeedPrompt(prompt))
+        return undefined;
+    return { prompt, sessionKey, runId: nonEmptyString(ctx.runId) };
+}
+function joinAttrs(turn, mode) {
+    return {
+        "gen_ai.conversation.id": turn.sessionKey,
+        "senpi.openclaw.run_id": turn.runId,
+        "senpi.skill_router.mode": mode,
+    };
+}
+function asRecord(v) {
+    return v && typeof v === "object" && !Array.isArray(v) ? v : undefined;
+}
+function nonEmptyString(v) {
+    return typeof v === "string" && v.length > 0 ? v : undefined;
+}
+//# sourceMappingURL=skill-router-hook.js.map

package/dist/prompt/skill-router-hook.js.map

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

package/dist/skill-router/catalog.d.ts

@@ -0,0 +1,30 @@
+import { type SkillRef } from "./classify-client.js";
+export interface InstalledSkill {
+    /** The top-level frontmatter `name`, else the directory name. */
+    name: string;
+    /** From `parseSkillMdVersion`; absent when the frontmatter has none. */
+    version?: string;
+    /** Absolute path of the skill's `SKILL.md`. */
+    skillMdPath: string;
+}
+export interface CatalogSnapshot {
+    /** Installed skills by name, in search-path order. */
+    skills: ReadonlyMap<string, InstalledSkill>;
+    /** Indexes into the search path whose `readdir` failed (a missing directory is not a failure). */
+    unreadableDirs: readonly number[];
+}
+export interface SkillCatalog {
+    read(): Promise<CatalogSnapshot>;
+}
+export declare function createSkillCatalog(options: {
+    searchPath: readonly string[];
+}): SkillCatalog;
+/**
+ * The skill list sent with a classify call: names matching the server's pattern, deduped, at
+ * most 40. Manifest skills come first (manifest order), then the rest in name order, so a
+ * managed skill is never the one cut. User-installed skills are still sent: the server doesn't
+ * route them in v1 but counts them as `unknown`, the demand signal for a v2 hybrid. An empty
+ * list means no call.
+ */
+export declare function skillsForRequest(snapshot: CatalogSnapshot, manifestNames?: readonly string[]): SkillRef[];
+//# sourceMappingURL=catalog.d.ts.map

package/dist/skill-router/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/skill-router/catalog.ts"],"names":[],"mappings":"AA+BA,OAAO,EAAkC,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErF,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC5C,kGAAkG;IAClG,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;CAClC;AAgBD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAAE,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAAG,YAAY,CA2D3F;AASD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,eAAe,EACzB,aAAa,GAAE,SAAS,MAAM,EAA4B,GACzD,QAAQ,EAAE,CAgBZ"}

package/dist/skill-router/catalog.js

@@ -0,0 +1,131 @@
+/**
+ * The installed-skill catalog the skill router classifies against (ticket skill-router/05).
+ *
+ * Under D3 option A the server holds the routing criteria, so the box reads only each skill's
+ * `name` and `version` (plus its `SKILL.md` path, for telemetry and tests), never its
+ * `description` or a `routing:` field.
+ *
+ * It scans the skills manager's search path (`resolveSkillsManagerConfig(...).skillsDir`,
+ * passed in by the hook), with the skills manager's rules: immediate subdirectories, hidden
+ * (`.tmp-*` staging, `.bak-*` backup) ones skipped, merged across the path, first found wins.
+ * Parsed entries are cached in memory and validated on every read by a `readdir` of each
+ * directory and a `stat` of each `SKILL.md`, so an install by the skills manager's tick, a
+ * manual `senpi skills update` or anything else that writes there shows up on the next turn.
+ *
+ * Limitation (accepted for v1): OpenClaw 2026.5.7 also loads skills from `<workspace>/skills`,
+ * `<workspace>/.agents/skills` and `~/.agents/skills` (`workspace-B4eaH2KK.js:698-740`), and a
+ * workspace skill overrides a managed one of the same name. Those directories are not scanned,
+ * so a skill the agent installs there is not sent, and if one shadows a managed name,
+ * `skillMdPath` points at the managed file rather than the one OpenClaw loaded.
+ *
+ * `read()` never throws: an unreadable directory or file skips what it holds, and the snapshot
+ * reports which search-path entries failed `readdir`, by index (never the path text).
+ */
+import { readdir, readFile, stat } from "node:fs/promises";
+import { resolve } from "node:path";
+import { getManifestSkillNames } from "../skills-manager/manifest.js";
+import { extractSkillMdFrontmatter, parseSkillMdName, parseSkillMdVersion, } from "../skills-manager/version-manager.js";
+import { MAX_SKILLS, SKILL_NAME_PATTERN } from "./classify-client.js";
+/**
+ * OpenClaw 2026.5.7 skips a larger `SKILL.md` (`DEFAULT_MAX_SKILL_FILE_BYTES`,
+ * `workspace-B4eaH2KK.js:310`, applied at :604-615), so it is not installed as far as the model
+ * is concerned, and it bounds what this reads.
+ */
+const MAX_SKILL_MD_BYTES = 256_000;
+export function createSkillCatalog(options) {
+    const searchPath = [...options.searchPath];
+    const cache = new Map();
+    return {
+        async read() {
+            const skills = new Map();
+            const unreadableDirs = [];
+            const claimedDirNames = new Set();
+            const seenPaths = new Set();
+            for (const [index, dir] of searchPath.entries()) {
+                let dirNames;
+                try {
+                    const entries = await readdir(dir, { withFileTypes: true });
+                    dirNames = entries
+                        .filter((e) => e.isDirectory() && !e.name.startsWith("."))
+                        .map((e) => e.name)
+                        .sort();
+                }
+                catch (err) {
+                    if (err?.code !== "ENOENT")
+                        unreadableDirs.push(index);
+                    continue;
+                }
+                for (const dirName of dirNames) {
+                    if (claimedDirNames.has(dirName))
+                        continue;
+                    const skillMdPath = resolve(dir, dirName, "SKILL.md");
+                    let info;
+                    try {
+                        info = await stat(skillMdPath);
+                    }
+                    catch {
+                        continue; // no SKILL.md here: not a skill, and it claims nothing
+                    }
+                    // First found wins: this directory holds the name even if its file turns out bad.
+                    claimedDirNames.add(dirName);
+                    if (!info.isFile() || info.size > MAX_SKILL_MD_BYTES)
+                        continue;
+                    seenPaths.add(skillMdPath);
+                    let cached = cache.get(skillMdPath);
+                    if (!cached || cached.mtimeMs !== info.mtimeMs || cached.size !== info.size) {
+                        let content;
+                        try {
+                            content = await readFile(skillMdPath, "utf8");
+                        }
+                        catch {
+                            cache.delete(skillMdPath);
+                            continue;
+                        }
+                        cached = { mtimeMs: info.mtimeMs, size: info.size, skill: parseSkill(content, dirName) };
+                        cache.set(skillMdPath, cached);
+                    }
+                    if (!cached.skill || skills.has(cached.skill.name))
+                        continue;
+                    skills.set(cached.skill.name, { ...cached.skill, skillMdPath });
+                }
+            }
+            for (const path of cache.keys())
+                if (!seenPaths.has(path))
+                    cache.delete(path);
+            return { skills, unreadableDirs };
+        },
+    };
+}
+function parseSkill(content, dirName) {
+    if (extractSkillMdFrontmatter(content) === null)
+        return null;
+    const name = parseSkillMdName(content) ?? dirName;
+    const version = parseSkillMdVersion(content);
+    return version === null ? { name } : { name, version };
+}
+/**
+ * The skill list sent with a classify call: names matching the server's pattern, deduped, at
+ * most 40. Manifest skills come first (manifest order), then the rest in name order, so a
+ * managed skill is never the one cut. User-installed skills are still sent: the server doesn't
+ * route them in v1 but counts them as `unknown`, the demand signal for a v2 hybrid. An empty
+ * list means no call.
+ */
+export function skillsForRequest(snapshot, manifestNames = getManifestSkillNames()) {
+    const rank = new Map(manifestNames.map((name, i) => [name, i]));
+    const byRank = (s) => rank.get(s.name) ?? Number.POSITIVE_INFINITY;
+    const candidates = [...snapshot.skills.values()]
+        .filter((s) => SKILL_NAME_PATTERN.test(s.name))
+        .sort((a, b) => byRank(a) - byRank(b) || (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+    const seen = new Set();
+    const sent = [];
+    for (const s of candidates) {
+        if (seen.has(s.name))
+            continue;
+        seen.add(s.name);
+        sent.push(s.version === undefined ? { name: s.name } : { name: s.name, version: s.version });
+        if (sent.length === MAX_SKILLS)
+            break;
+    }
+    return sent;
+}
+//# sourceMappingURL=catalog.js.map

package/dist/skill-router/catalog.js.map

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