@senpi/runtime 3.0.150 → 3.0.154

package/dist/skill-router/classify-client.d.ts

@@ -0,0 +1,80 @@
+export interface WarnLogger {
+    warn(message: string): void;
+}
+/**
+ * Resolve the classify URL from the value of `SENPI_SKILL_ROUTER_URL`.
+ *
+ * Unset or blank means prod. Otherwise the value must be an origin only: `https:`, no
+ * userinfo, no port, an empty or `/` path, no query or hash, and a hostname under `.senpi.ai`
+ * with at least one label in front. An invalid value returns `undefined` (the router stays off;
+ * it never falls back to prod) and logs one warning that names the variable, never its value.
+ */
+export declare function resolveClassifyUrl(raw: string | undefined, logger?: WarnLogger): string | undefined;
+/** A skill name as the server accepts it (ticket 01, "Request"). */
+export declare const SKILL_NAME_PATTERN: RegExp;
+/** The server's cap on `skills` and on the `fired` / `scores` it returns. */
+export declare const MAX_SKILLS = 40;
+export interface SkillRef {
+    name: string;
+    version?: string;
+}
+export interface ClassifyRequest {
+    /** The prepared prompt (`preparePromptForClassify`), never the raw hook prompt. */
+    prompt: string;
+    /** `skillsForRequest()`'s list. */
+    skills: readonly SkillRef[];
+}
+export interface ClassifyUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+    costUsd?: number;
+}
+export interface ClassifySuccess {
+    ok: true;
+    decisionId?: string;
+    model?: string;
+    criteriaVersion?: string;
+    /** Validated: at most 40 pattern-matching names, each a finite number in [0, 1]. */
+    scores: Readonly<Record<string, number>>;
+    /** Validated: at most 40 pattern-matching names. The server's list; `resolve.ts` narrows it. */
+    fired: readonly string[];
+    unknownCount: number;
+    ignored: number;
+    unansweredCount: number;
+    usage: ClassifyUsage;
+    /** The server's own `latencyMs.total`. */
+    serverLatencyMs?: number;
+    /** The box's round trip. */
+    latencyMs: number;
+}
+export interface ClassifyFailure {
+    ok: false;
+    /** The HTTP status, or 0 for a timeout, a network error or a backoff. */
+    status: number;
+    /** The server's error code, or the client's: `timeout`, `network`, `bad_response`, `http_<status>`, `backoff`. */
+    code: string;
+    /** The server's 502 `reason`, when it is a plain code. */
+    reason?: string;
+    /** Seconds of the backoff window this result opened (or, for `backoff`, has left). */
+    retryAfterSec?: number;
+    latencyMs: number;
+}
+export type ClassifyResult = ClassifySuccess | ClassifyFailure;
+export interface ClassifyClient {
+    /** Never throws. `signal` is linked to the client's own timeout. */
+    classify(request: ClassifyRequest, opts?: {
+        signal?: AbortSignal;
+    }): Promise<ClassifyResult>;
+}
+export interface ClassifyClientOptions {
+    /** From {@link resolveClassifyUrl}. */
+    url: string;
+    /** The box's per-user Senpi token. */
+    token: string;
+    /** Injectable for tests; defaults to the global `fetch`. */
+    fetch?: typeof fetch;
+    /** Injectable clock (ms) for latency and backoff windows; defaults to `Date.now`. */
+    now?: () => number;
+}
+export declare function createClassifyClient(options: ClassifyClientOptions): ClassifyClient;
+//# sourceMappingURL=classify-client.d.ts.map

package/dist/skill-router/classify-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify-client.d.ts","sourceRoot":"","sources":["../../src/skill-router/classify-client.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAWnG;AA+BD,oEAAoE;AACpE,eAAO,MAAM,kBAAkB,QAA8B,CAAC;AAC9D,6EAA6E;AAC7E,eAAO,MAAM,UAAU,KAAK,CAAC;AAQ7B,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,mFAAmF;IACnF,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,IAAI,CAAC;IACT,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oFAAoF;IACpF,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACzC,gGAAgG;IAChG,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,aAAa,CAAC;IACrB,0CAA0C;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,KAAK,CAAC;IACV,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,kHAAkH;IAClH,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,eAAe,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC9F;AAED,MAAM,WAAW,qBAAqB;IACpC,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,qFAAqF;IACrF,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAuEnF"}

package/dist/skill-router/classify-client.js

@@ -0,0 +1,283 @@
+/**
+ * Client for senpi-backend's skill-router classify endpoint (tickets skill-router/01, /02, /05).
+ *
+ * This is not a Jev client: the box never talks to OpenRouter and holds no Jev key (D2). It
+ * sends the user's prompt (envelope already stripped, see `prompt.ts`) and the names and
+ * versions of the skills installed on the box, and gets back the server's scores and `fired`
+ * list (D3 option A: the server holds the criteria).
+ *
+ * The bearer is the box's per-user Senpi token: 180 days long and also good for MCP trading
+ * calls. So it is only ever sent to a validated `https://*.senpi.ai` origin, with
+ * `redirect: "error"`, and never logged or put in a URL.
+ *
+ * Nothing here throws to its caller: every failure is a typed `{ ok: false }` result, which the
+ * hook treats as "no opinion" (no injection).
+ */
+import { z } from "zod";
+/** The fixed path on the classify origin. */
+const CLASSIFY_PATH = "/v1/skill-router/classify";
+/** Prod origin; dev is `https://moxie-backend.dev.senpi.ai`. */
+const DEFAULT_CLASSIFY_ORIGIN = "https://moxie-backend.prod.senpi.ai";
+const URL_ENV_NAME = "SENPI_SKILL_ROUTER_URL";
+/**
+ * Resolve the classify URL from the value of `SENPI_SKILL_ROUTER_URL`.
+ *
+ * Unset or blank means prod. Otherwise the value must be an origin only: `https:`, no
+ * userinfo, no port, an empty or `/` path, no query or hash, and a hostname under `.senpi.ai`
+ * with at least one label in front. An invalid value returns `undefined` (the router stays off;
+ * it never falls back to prod) and logs one warning that names the variable, never its value.
+ */
+export function resolveClassifyUrl(raw, logger) {
+    const value = raw?.trim() ?? "";
+    if (value.length === 0)
+        return `${DEFAULT_CLASSIFY_ORIGIN}${CLASSIFY_PATH}`;
+    const origin = validOrigin(value);
+    if (origin === undefined) {
+        logger?.warn(`[senpi-runtime][skill-router] ${URL_ENV_NAME} is invalid (it must be an origin like https://<host>.senpi.ai); the skill router is disabled`);
+        return undefined;
+    }
+    return `${origin}${CLASSIFY_PATH}`;
+}
+function validOrigin(value) {
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        return undefined;
+    }
+    if (url.protocol !== "https:")
+        return undefined;
+    if (url.username !== "" || url.password !== "")
+        return undefined;
+    if (url.port !== "")
+        return undefined;
+    if (url.pathname !== "/" || url.search !== "" || url.hash !== "")
+        return undefined;
+    // The WHATWG parser drops a default port (`:443`) and an empty query or hash (`?`, `#`), so
+    // check the text as well: any of them means the value is not a bare origin.
+    if (/[?#@]/.test(value) || hasExplicitPort(value))
+        return undefined;
+    const labels = url.hostname.toLowerCase().split(".");
+    if (labels.length < 3 || labels.some((l) => l.length === 0))
+        return undefined;
+    if (labels[labels.length - 2] !== "senpi" || labels[labels.length - 1] !== "ai")
+        return undefined;
+    return url.origin;
+}
+function hasExplicitPort(value) {
+    const start = value.indexOf("//");
+    if (start === -1)
+        return true;
+    const authority = value.slice(start + 2).split(/[/\\?#]/, 1)[0];
+    return authority.includes(":");
+}
+// ─── The classify call ──────────────────────────────────────────────────────
+/** A skill name as the server accepts it (ticket 01, "Request"). */
+export const SKILL_NAME_PATTERN = /^[a-z0-9][a-z0-9-]{0,63}$/;
+/** The server's cap on `skills` and on the `fired` / `scores` it returns. */
+export const MAX_SKILLS = 40;
+/** The box's budget for the whole round trip (DNS, connect, TLS, request, response body). */
+const CLASSIFY_TIMEOUT_MS = 1500;
+/** The most of a response body the client reads. */
+const MAX_RESPONSE_BYTES = 64 * 1024;
+/** The server drops a longer version; the box doesn't send one. */
+const MAX_VERSION_CHARS = 32;
+export function createClassifyClient(options) {
+    const doFetch = options.fetch ?? fetch;
+    const now = options.now ?? Date.now;
+    // The Retry-After window, in memory only: a restart clears it, which is also when a box-side
+    // mode change lands. One client per process, so this is per box.
+    let backoffUntilMs = 0;
+    return {
+        async classify(request, opts = {}) {
+            const remainingMs = backoffUntilMs - now();
+            if (remainingMs > 0) {
+                return { ok: false, status: 0, code: "backoff", retryAfterSec: Math.ceil(remainingMs / 1000), latencyMs: 0 };
+            }
+            const startedAt = now();
+            const elapsed = () => Math.max(0, now() - startedAt);
+            // One AbortController owns the whole round trip, body read included. A caller signal is
+            // linked to it (ported from senpi-jev-router `src/jev/client.ts:130-136`); the 2026.5.7
+            // `before_prompt_build` ctx carries none, so that link is for tests and future hosts.
+            const timer = new AbortController();
+            const timeout = setTimeout(() => timer.abort(), CLASSIFY_TIMEOUT_MS);
+            const signal = opts.signal && typeof AbortSignal.any === "function"
+                ? AbortSignal.any([timer.signal, opts.signal])
+                : timer.signal;
+            const failed = (status, code) => ({
+                ok: false,
+                status,
+                code,
+                latencyMs: elapsed(),
+            });
+            // A timer or caller abort is a timeout; anything else thrown on the wire is `network`.
+            // No error text is kept: it could carry the URL, and nothing here may carry the token.
+            const wireFailure = () => failed(0, signal.aborted ? "timeout" : "network");
+            try {
+                let res;
+                let text;
+                try {
+                    res = await doFetch(options.url, {
+                        method: "POST",
+                        headers: { Authorization: `Bearer ${options.token}`, "Content-Type": "application/json" },
+                        body: JSON.stringify(buildBody(request)),
+                        redirect: "error",
+                        signal,
+                    });
+                    text = await readCapped(res, MAX_RESPONSE_BYTES);
+                }
+                catch {
+                    return wireFailure();
+                }
+                if (res.status !== 200) {
+                    const body = errorBodySchema.parse(text === undefined ? undefined : parseJson(text));
+                    const failure = failed(res.status, body.error ?? `http_${res.status}`);
+                    if (res.status === 502 && body.reason !== undefined)
+                        failure.reason = body.reason;
+                    const windowSec = parseRetryAfter(res.headers.get("retry-after"), now()) ?? DEFAULT_BACKOFF_SEC[res.status];
+                    if (windowSec !== undefined) {
+                        backoffUntilMs = Math.max(backoffUntilMs, now() + windowSec * 1000);
+                        failure.retryAfterSec = windowSec;
+                    }
+                    return failure;
+                }
+                const parsed = text === undefined ? undefined : parseSuccess(parseJson(text));
+                if (parsed === undefined)
+                    return failed(200, "bad_response");
+                return { ok: true, ...parsed, latencyMs: elapsed() };
+            }
+            finally {
+                clearTimeout(timeout);
+            }
+        },
+    };
+}
+const MIN_BACKOFF_SEC = 1;
+const MAX_BACKOFF_SEC = 86_400;
+/**
+ * The box's own window when a non-200 carries no `Retry-After`: these statuses (a bad or
+ * unenrolled token, a wrong route) won't clear by retrying. Every other status opens none.
+ * Whatever `Retry-After` the server does send is honoured instead (ticket 01's table: 503
+ * `disabled` 3,600 / 900 s, 429 `rate_limited`, 503 `budget_exhausted` to 00:00Z, 502
+ * `breaker_open` = the breaker's remaining TTL).
+ */
+const DEFAULT_BACKOFF_SEC = { 401: 3600, 403: 3600, 404: 3600, 405: 3600 };
+/** `Retry-After` as delta-seconds or an HTTP-date, clamped to 1..86,400 s; `undefined` when absent or unparsable. */
+function parseRetryAfter(header, nowMs) {
+    const value = header?.trim();
+    if (!value)
+        return undefined;
+    let seconds;
+    if (/^\d+$/.test(value)) {
+        seconds = Number(value);
+    }
+    else {
+        const at = Date.parse(value);
+        if (!Number.isFinite(at) || /^[+-]?\d/.test(value))
+            return undefined;
+        seconds = Math.ceil((at - nowMs) / 1000);
+    }
+    return Math.min(MAX_BACKOFF_SEC, Math.max(MIN_BACKOFF_SEC, seconds));
+}
+/** The body as UTF-8 text, or `undefined` when it is over `maxBytes` (the rest is not read). */
+async function readCapped(res, maxBytes) {
+    const declared = Number(res.headers.get("content-length"));
+    if (Number.isFinite(declared) && declared > maxBytes) {
+        await res.body?.cancel().catch(() => undefined);
+        return undefined;
+    }
+    if (!res.body)
+        return "";
+    const reader = res.body.getReader();
+    const chunks = [];
+    let total = 0;
+    for (;;) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        total += value.byteLength;
+        if (total > maxBytes) {
+            await reader.cancel().catch(() => undefined);
+            return undefined;
+        }
+        chunks.push(value);
+    }
+    return Buffer.concat(chunks).toString("utf8");
+}
+function parseJson(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Exactly `{prompt, skills: [{name, version?}]}`: the server answers 400 to any other key. */
+function buildBody(request) {
+    return {
+        prompt: request.prompt,
+        skills: request.skills.map((s) => typeof s.version === "string" && s.version.length > 0 && s.version.length <= MAX_VERSION_CHARS
+            ? { name: s.name, version: s.version }
+            : { name: s.name }),
+    };
+}
+/** Ticket 01's codes are all of this shape; anything else becomes `http_<status>`. */
+const ERROR_CODE_PATTERN = /^[a-z_]{1,32}$/;
+/** A 502's Jev reason (`http_429`, `breaker_open`, ...); anything else is dropped. */
+const REASON_PATTERN = /^[a-z0-9_]{1,32}$/;
+const DECISION_ID_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;
+const CRITERIA_VERSION_PATTERN = /^[A-Za-z0-9]{1,64}$/;
+const MODEL_PATTERN = /^[A-Za-z0-9._/:-]{1,64}$/;
+const skillName = z.string().regex(SKILL_NAME_PATTERN);
+const optionalMatching = (pattern) => z.string().regex(pattern).optional().catch(undefined);
+const optionalNonNegative = z.number().finite().nonnegative().optional().catch(undefined);
+/** The length of an array, capped at 40; 0 for anything else. */
+const cappedCount = z.unknown().transform((v) => (Array.isArray(v) ? Math.min(v.length, MAX_SKILLS) : 0));
+/**
+ * A 200 body. `fired` and `scores` must be well-formed or the whole response is refused; every
+ * other field is dropped or zeroed when bad. Unlisted keys are stripped, so only these
+ * validated values ever leave the client.
+ */
+const successBodySchema = z.object({
+    fired: z.array(skillName).max(MAX_SKILLS),
+    scores: z
+        .record(skillName, z.number().finite().min(0).max(1))
+        .refine((scores) => Object.keys(scores).length <= MAX_SKILLS),
+    decisionId: optionalMatching(DECISION_ID_PATTERN),
+    model: optionalMatching(MODEL_PATTERN),
+    criteriaVersion: optionalMatching(CRITERIA_VERSION_PATTERN),
+    unknown: cappedCount,
+    ignored: z.number().int().safe().nonnegative().catch(0),
+    unanswered: cappedCount,
+    usage: z
+        .object({ inputTokens: optionalNonNegative, outputTokens: optionalNonNegative, costUsd: optionalNonNegative })
+        .catch({}),
+    latencyMs: z.object({ total: optionalNonNegative }).catch({}),
+});
+/** A non-200 body: `{"error": "<code>", "reason": "<jev reason, 502 only>"}`, each kept only when plain. */
+const errorBodySchema = z
+    .object({ error: optionalMatching(ERROR_CODE_PATTERN), reason: optionalMatching(REASON_PATTERN) })
+    .catch({});
+function parseSuccess(raw) {
+    const parsed = successBodySchema.safeParse(raw);
+    if (!parsed.success)
+        return undefined;
+    const body = parsed.data;
+    return {
+        decisionId: body.decisionId,
+        model: body.model,
+        criteriaVersion: body.criteriaVersion,
+        scores: body.scores,
+        fired: body.fired,
+        unknownCount: body.unknown,
+        ignored: body.ignored,
+        unansweredCount: body.unanswered,
+        usage: dropUndefined(body.usage),
+        serverLatencyMs: body.latencyMs.total,
+    };
+}
+function dropUndefined(o) {
+    return Object.fromEntries(Object.entries(o).filter(([, v]) => v !== undefined));
+}
+//# sourceMappingURL=classify-client.js.map

package/dist/skill-router/classify-client.js.map

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

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

@@ -0,0 +1,36 @@
+/**
+ * Prompt hygiene for the skill-router classify call (ticket skill-router/05).
+ *
+ * On OpenClaw 2026.5.7 (the fleet version) the `before_prompt_build` hook receives get-reply's
+ * `prefixedCommandBody`, which wraps the user's message in an AI-facing envelope: a media note,
+ * a thread note, queued system events, the aborted-run hint, the inbound metadata blocks
+ * (`Sender (untrusted metadata):` and friends), the `chat.send` timestamp and a trailing
+ * Untrusted-context block. The owner approved sending user prompts to senpi-backend, OpenRouter
+ * and TypeSafe only with that envelope stripped, so this module removes it, in assembly order,
+ * before anything leaves the box. It is pure and never throws.
+ *
+ * Every literal below is copied from the openclaw@2026.5.7 dist (`npm pack openclaw@2026.5.7`);
+ * the file and line are named next to each. The vendored node_modules copy is 2026.6.9 and is
+ * not the reference.
+ */
+export type PromptSkipReason = "reset_turn" | "inter_session" | "queued_batch" | "unknown_envelope" | "empty_prompt";
+export type PreparedPrompt = {
+    ok: true;
+    /** The text to send: the user's message alone, at most {@link CLASSIFY_PROMPT_MAX_CHARS}. */
+    prompt: string;
+    /** `prompt.length`, the sent length. */
+    length: number;
+    truncated: boolean;
+    /** True when any envelope part was removed. */
+    envelopeStripped: boolean;
+} | {
+    ok: false;
+    reason: PromptSkipReason;
+    envelopeStripped: boolean;
+};
+/**
+ * Turn a prompt into the text the classify endpoint may see, or say why the turn is not
+ * classified at all.
+ */
+export declare function preparePromptForClassify(raw: string): PreparedPrompt;
+//# sourceMappingURL=prompt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/skill-router/prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,MAAM,MAAM,gBAAgB,GACxB,YAAY,GACZ,eAAe,GACf,cAAc,GACd,kBAAkB,GAClB,cAAc,CAAC;AAEnB,MAAM,MAAM,cAAc,GACtB;IACE,EAAE,EAAE,IAAI,CAAC;IACT,6FAA6F;IAC7F,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,+CAA+C;IAC/C,gBAAgB,EAAE,OAAO,CAAC;CAC3B,GACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAC;IAAC,gBAAgB,EAAE,OAAO,CAAA;CAAE,CAAC;AAsDvE;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAkEpE"}