@wirecat/cli-base 0.0.0-stage → 0.22.0

package/dist/sanitize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.js","sourceRoot":"","sources":["../src/sanitize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;;GAOG;AACH,MAAM,OAAO;AACX,4FAA4F;AAC5F,kHAAkH,CAAA;AAEpH,MAAM,gBAAgB,GAAG,2FAA2F,CAAA;AAEpH,MAAM,WAAW,GAAG,qBAAqB,CAAA;AAEzC,MAAM,OAAO,GAAG,CAAC,CAAS,EAAU,EAAE;IACpC,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IAClC,IAAI,IAAI,GAAG,MAAM;QAAE,OAAO,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAA;IACrD,OAAO,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAA;AAC9G,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAY,EAAU,EAAE;IACtD,IAAI,EAAE,GAAG,CAAC,CAAA;IACV,IAAI,MAAM,GAAG,EAAE,CAAA;IACf,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;QACxE,EAAE,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;IAClC,CAAC;IACD,OAAO,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;AAC1D,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA"}

package/dist/skill/index.d.ts

@@ -0,0 +1,78 @@
+import { Command } from "commander";
+import type { Renderer } from "../renderer.js";
+import type { Streams } from "../streams.js";
+type Env = Readonly<Record<string, string | undefined>>;
+export interface SkillApp {
+    /** `tg` — what an agent types. */
+    command: string;
+    /** `tg-cli` — the skill's directory name, and the `name` in its frontmatter. */
+    appName: string;
+    version: string;
+}
+export declare const SKILL_TARGETS: readonly ["claude", "agents"];
+export type SkillTarget = (typeof SKILL_TARGETS)[number];
+/** `~/.claude/skills` is Claude Code's; `~/.agents/skills` is read by Codex and Gemini CLI. */
+export declare const skillPath: (target: SkillTarget, appName: string, env: Env) => string;
+/**
+ * `metadata.version` from the frontmatter — where the Agent Skills specification keeps fields of its
+ * own — or a top-level `version:`, which pre-release builds of this package wrote.
+ */
+export declare const skillVersion: (content: string) => string | undefined;
+/** Adds or replaces `metadata.version` as a string; every other byte stays as it was. */
+export declare const withVersion: (content: string, version: string) => string;
+/** Writes the stamped SKILL.md to each target, creating directories; the same run twice gives the same files. */
+export declare const installSkill: (app: SkillApp, skill: URL, { targets, env }?: {
+    targets?: readonly SkillTarget[];
+    env?: Env;
+}) => string[];
+/** What the command writes to and where home is, for this invocation — the host's own output resolution. */
+export type SkillEnvironment = (command: Command) => {
+    renderer: Renderer;
+    streams: Streams;
+    env?: Env;
+};
+/**
+ * `more`: skills a library ships for every CLI built on it, by name — `skill show <name>` prints one with
+ * `{{command}}` turned into this CLI's command. They are printed, not installed: two CLIs would install
+ * the same name.
+ */
+export declare const skillCommand: (app: SkillApp, skill: URL, environment: SkillEnvironment, more?: Readonly<Record<string, URL>>) => Command;
+export interface SkillHintRequest {
+    app: SkillApp;
+    /** The words the CLI was run with: no hint while it runs `skill` or `complete`. */
+    argv: readonly string[];
+    env: Env;
+    /** The update notice's state file — one file for both daily notices. */
+    statePath: string;
+    /** The setting `skillHint`; `false` turns the hint off. */
+    enabled?: boolean;
+    now?: () => number;
+}
+/**
+ * One line for an agent whose copy of SKILL.md is missing or older than this CLI, at most once a
+ * day, or `undefined`. The host prints it on stderr. Any failure is silence.
+ */
+export declare const skillHint: ({ app, argv, env, statePath, enabled, now }: SkillHintRequest) => string | undefined;
+export interface SkillResource {
+    uri: string;
+    name: string;
+    title: string;
+    description: string;
+    mimeType: "text/markdown";
+    read: () => {
+        contents: {
+            uri: string;
+            mimeType: "text/markdown";
+            text: string;
+        }[];
+    };
+    /** A line for the server's `instructions`. */
+    instruction: string;
+}
+/**
+ * What an MCP server registers to serve SKILL.md as `<command>://skill`, for a client with no shell —
+ * `server.registerResource(r.name, r.uri, { title, description, mimeType }, r.read)`. The SDK stays the host's.
+ */
+export declare const skillResource: (app: SkillApp, skill: URL) => SkillResource;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skill/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAA;AAE3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAG5C,KAAK,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAA;AAEvD,MAAM,WAAW,QAAQ;IACvB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,eAAO,MAAM,aAAa,YAAI,QAAQ,EAAE,QAAQ,CAAU,CAAA;AAC1D,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAA;AAIxD,+FAA+F;AAC/F,eAAO,MAAM,SAAS,WAAY,WAAW,WAAW,MAAM,OAAO,GAAG,KAAG,MACoB,CAAA;AAoB/F;;;GAGG;AACH,eAAO,MAAM,YAAY,YAAa,MAAM,KAAG,MAAM,GAAG,SAMvD,CAAA;AAOD,yFAAyF;AACzF,eAAO,MAAM,WAAW,YAAa,MAAM,WAAW,MAAM,KAAG,MAoB9D,CAAA;AAED,iHAAiH;AACjH,eAAO,MAAM,YAAY,QAClB,QAAQ,SACN,GAAG,qBACsC;IAAE,OAAO,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAAC,GAAG,CAAC,EAAE,GAAG,CAAA;CAAE,KAC9F,MAAM,EAiBR,CAAA;AAED,4GAA4G;AAC5G,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,GAAG,CAAA;CAAE,CAAA;AAExG;;;;GAIG;AACH,eAAO,MAAM,YAAY,QAClB,QAAQ,SACN,GAAG,eACG,gBAAgB,SACvB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,KAClC,OAiDF,CAAA;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,QAAQ,CAAA;IACb,mFAAmF;IACnF,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;IACvB,GAAG,EAAE,GAAG,CAAA;IACR,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAA;IACjB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CACnB;AAgBD;;;GAGG;AACH,eAAO,MAAM,SAAS,gDAAmE,gBAAgB,uBAaxG,CAAA;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,eAAe,CAAA;IACzB,IAAI,EAAE,MAAM;QAAE,QAAQ,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,eAAe,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE,CAAA;IACpF,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,QAAS,QAAQ,SAAS,GAAG,KAAG,aAWzD,CAAA"}

package/dist/skill/index.js

@@ -0,0 +1,190 @@
+/**
+ * The CLI's own SKILL.md for coding agents: printing it, installing it where agents look for skills,
+ * telling an agent once a day that its copy is missing or old, and serving it to an MCP client.
+ *
+ * Nothing here prints by itself. The command writes through the renderer and streams the host hands
+ * it, and the hint is a string the host puts on stderr — never stdout, which an agent parses.
+ */
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { Command, Option } from "commander";
+import { CliError } from "../errors.js";
+import { CHECK_EVERY_MS, isNewer, readNoticeState, writeUpdateState } from "../update/index.js";
+export const SKILL_TARGETS = ["claude", "agents"];
+const homeOf = (env) => env.HOME || env.USERPROFILE || homedir();
+/** `~/.claude/skills` is Claude Code's; `~/.agents/skills` is read by Codex and Gemini CLI. */
+export const skillPath = (target, appName, env) => join(homeOf(env), target === "claude" ? ".claude" : ".agents", "skills", appName, "SKILL.md");
+const FRONTMATTER = /^---(\r?\n)([\s\S]*?\r?\n)?---(\r?\n|$)/;
+const scalar = (key, indent) => new RegExp(`^${indent}${key}:[ \\t]*["']?([^"'\\r\\n]*?)["']?[ \\t]*\\r?\\n?$`);
+const frontmatterLines = (content) => (FRONTMATTER.exec(content)?.[2] ?? "").split(/(?<=\n)/);
+/** Where `metadata:` and its indented lines are, as `[start, end)`; a flow map (`metadata: {…}`) is refused. */
+const metadataBlock = (lines) => {
+    const start = lines.findIndex((line) => /^metadata:/.test(line));
+    if (start === -1)
+        return undefined;
+    if (!/^metadata:[ \t]*\r?\n?$/.test(lines[start])) {
+        throw new CliError("configuration_error", "SKILL.md: write `metadata` as an indented block, not on one line");
+    }
+    let end = start + 1;
+    while (end < lines.length && /^[ \t]/.test(lines[end]))
+        end++;
+    return [start, end];
+};
+/**
+ * `metadata.version` from the frontmatter — where the Agent Skills specification keeps fields of its
+ * own — or a top-level `version:`, which pre-release builds of this package wrote.
+ */
+export const skillVersion = (content) => {
+    const lines = frontmatterLines(content);
+    const block = metadataBlock(lines);
+    const nested = block && lines.slice(block[0] + 1, block[1]).find((line) => scalar("version", "[ \\t]+").test(line));
+    const line = nested ?? lines.find((line) => scalar("version", "").test(line));
+    return line === undefined ? undefined : scalar("version", "[ \\t]*").exec(line)?.[1];
+};
+const skillName = (content) => {
+    const line = frontmatterLines(content).find((line) => scalar("name", "").test(line));
+    return line === undefined ? undefined : scalar("name", "").exec(line)?.[1];
+};
+/** Adds or replaces `metadata.version` as a string; every other byte stays as it was. */
+export const withVersion = (content, version) => {
+    const match = FRONTMATTER.exec(content);
+    if (!match)
+        return `---\nmetadata:\n  version: "${version}"\n---\n${content}`;
+    const [whole, eol = "\n", body = "", close = ""] = match;
+    const lines = body.split(/(?<=\n)/).filter((line) => line !== "");
+    const block = metadataBlock(lines);
+    if (!block) {
+        lines.push(`metadata:${eol}`, `  version: "${version}"${eol}`);
+    }
+    else {
+        const [start, end] = block;
+        const indent = /^[ \t]+/.exec(lines[start + 1] ?? "")?.[0] ?? "  ";
+        const at = lines.slice(start + 1, end).findIndex((line) => scalar("version", "[ \\t]+").test(line));
+        if (at === -1)
+            lines.splice(start + 1, 0, `${indent}version: "${version}"${eol}`);
+        else {
+            const old = lines[start + 1 + at];
+            const lineEol = /\r?\n$/.exec(old)?.[0] ?? "";
+            lines[start + 1 + at] = `${/^[ \t]+/.exec(old)?.[0]}version: "${version}"${lineEol}`;
+        }
+    }
+    return `---${eol}${lines.join("")}---${close}${content.slice(whole.length)}`;
+};
+/** Writes the stamped SKILL.md to each target, creating directories; the same run twice gives the same files. */
+export const installSkill = (app, skill, { targets = SKILL_TARGETS, env = process.env } = {}) => {
+    const source = readFileSync(skill, "utf8");
+    // The specification requires it, and an agent that checks skips a skill whose name and directory differ.
+    const name = skillName(source);
+    if (name !== app.appName) {
+        throw new CliError("configuration_error", `SKILL.md is named ${name === undefined ? "nothing" : `"${name}"`}, but installs into a directory "${app.appName}"; the two must match`);
+    }
+    const content = withVersion(source, app.version);
+    return targets.map((target) => {
+        const path = skillPath(target, app.appName, env);
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, content);
+        return path;
+    });
+};
+/**
+ * `more`: skills a library ships for every CLI built on it, by name — `skill show <name>` prints one with
+ * `{{command}}` turned into this CLI's command. They are printed, not installed: two CLIs would install
+ * the same name.
+ */
+export const skillCommand = (app, skill, environment, more = {}) => {
+    const command = new Command("skill").description("the instructions an agent is given for this tool");
+    const machine = (self) => {
+        const { json, jsonl } = self.optsWithGlobals();
+        return json === true || jsonl === true;
+    };
+    const named = Object.keys(more);
+    const show = command
+        .command("show")
+        .description(`print SKILL.md — \`${app.command} skill install\` puts it where Claude Code, Codex and Gemini CLI look for it`);
+    if (named.length > 0)
+        show.argument("[name]", `one of the skills shipped for a task: ${named.join(", ")}`);
+    show.action(function (given) {
+        // Without a declared argument Commander passes the options here, not a name.
+        const name = typeof given === "string" ? given : undefined;
+        const { renderer, streams } = environment(this);
+        const source = name === undefined ? skill : more[name];
+        if (!source) {
+            throw new CliError("validation_error", `no skill "${name}" — there are: ${named.join(", ")}`);
+        }
+        const content = name === undefined
+            ? readFileSync(source, "utf8").trimEnd()
+            : readFileSync(source, "utf8").trimEnd().replaceAll("{{command}}", app.command);
+        // The file itself even into a pipe: saving it is a redirect, and a redirect is where every
+        // other command switches to JSON. Asked for by name, it is JSON like the rest.
+        if (machine(this))
+            renderer.result({ name: name ?? app.appName, content });
+        else
+            streams.data(content);
+    });
+    command
+        .command("install")
+        .description(`write SKILL.md to ~/.claude/skills/${app.appName}/ (Claude Code) and ~/.agents/skills/${app.appName}/ (Codex, Gemini CLI)`)
+        .addOption(new Option("--for <agents>", "which agents to install for").choices(["claude", "agents", "all"]).default("all"))
+        .action(function ({ for: chosen }) {
+        const { renderer, env } = environment(this);
+        const targets = chosen === "all" ? SKILL_TARGETS : [chosen];
+        const written = installSkill(app, skill, { targets, ...(env ? { env } : {}) });
+        renderer.result({ name: app.appName, version: app.version, written });
+        renderer.success(`${app.appName} ${app.version} skill installed: ${written.join(", ")}`);
+    });
+    return command;
+};
+const isAgent = (env) => Boolean(env.AI_AGENT || env.CLAUDECODE);
+const needsInstall = (app, env) => {
+    const installed = SKILL_TARGETS.flatMap((target) => {
+        try {
+            return [skillVersion(readFileSync(skillPath(target, app.appName, env), "utf8"))];
+        }
+        catch {
+            return [];
+        }
+    });
+    // A location never installed to is a choice (`--for claude`); only no copy at all, or an old one, is worth a line.
+    return installed.length === 0 || installed.some((version) => version === undefined || isNewer(app.version, version));
+};
+/**
+ * One line for an agent whose copy of SKILL.md is missing or older than this CLI, at most once a
+ * day, or `undefined`. The host prints it on stderr. Any failure is silence.
+ */
+export const skillHint = ({ app, argv, env, statePath, enabled = true, now = Date.now }) => {
+    try {
+        if (!enabled || !isAgent(env))
+            return undefined;
+        if (argv.includes("skill") || argv.includes("complete"))
+            return undefined;
+        const at = now();
+        const shown = readNoticeState(statePath).skillHintAt;
+        if (shown !== undefined && at - shown < CHECK_EVERY_MS)
+            return undefined;
+        if (!needsInstall(app, env))
+            return undefined;
+        writeUpdateState(statePath, { skillHintAt: at });
+        return `agents: \`${app.command} skill install\` installs this tool's guide`;
+    }
+    catch {
+        return undefined;
+    }
+};
+/**
+ * What an MCP server registers to serve SKILL.md as `<command>://skill`, for a client with no shell —
+ * `server.registerResource(r.name, r.uri, { title, description, mimeType }, r.read)`. The SDK stays the host's.
+ */
+export const skillResource = (app, skill) => {
+    const uri = `${app.command}://skill`;
+    return {
+        uri,
+        name: "skill",
+        title: `${app.appName} SKILL.md`,
+        description: `How to use ${app.command}: the guide an agent is given for this tool.`,
+        mimeType: "text/markdown",
+        read: () => ({ contents: [{ uri, mimeType: "text/markdown", text: readFileSync(skill, "utf8") }] }),
+        instruction: `- The full guide is the resource ${uri}; \`${app.command} skill install\` installs it as an agent skill.`,
+    };
+};
+//# sourceMappingURL=index.js.map

package/dist/skill/index.js.map

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

package/dist/standards/errors.d.ts

@@ -0,0 +1,40 @@
+import * as v from "valibot";
+/** The one error object, on stderr in machine mode and as MCP's `isError` content alike. */
+export declare const errorObjectSchema: v.StrictObjectSchema<{
+    readonly error: v.StrictObjectSchema<{
+        readonly code: v.PicklistSchema<readonly ["validation_error", "configuration_error", "authentication_error", "permission_error", "not_found", "confirmation_required", "rate_limited", "timeout", "network_error", "provider_error", "provider_unavailable", "invalid_response", "outcome_unknown", "cancelled"], undefined>;
+        readonly reason: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "dotted lower-case words, such as `page.next`">]>;
+        readonly message: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "must not be empty">]>;
+        /** The option or argument at fault. */
+        readonly param: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "must not be empty">]>, undefined>;
+        readonly details: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
+        readonly next: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StrictObjectSchema<{
+            readonly step: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "dotted lower-case words, such as `page.next`">]>;
+            readonly command: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "must not be empty">]>;
+            readonly args: v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>;
+            readonly why: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "must not be empty">]>;
+        }, undefined>, undefined>, v.MaxLengthAction<{
+            step: string;
+            command: string;
+            args: {
+                [x: string]: unknown;
+            };
+            why: string;
+        }[], 3, undefined>]>, undefined>;
+        readonly runId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "must not be empty">]>;
+    }, undefined>;
+}, undefined>;
+export type ErrorObject = v.InferOutput<typeof errorObjectSchema>;
+declare const reasonSchema: v.StrictObjectSchema<{
+    readonly reason: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "dotted lower-case words, such as `page.next`">]>;
+    readonly code: v.PicklistSchema<readonly ["validation_error", "configuration_error", "authentication_error", "permission_error", "not_found", "confirmation_required", "rate_limited", "timeout", "network_error", "provider_error", "provider_unavailable", "invalid_response", "outcome_unknown", "cancelled"], undefined>;
+    /** `{name}` placeholders, each one of `details`. */
+    readonly message: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "must not be empty">]>, v.MaxLengthAction<string, 120, undefined>]>;
+    readonly details: v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a camelCase key">]>, undefined>;
+    readonly step: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "dotted lower-case words, such as `page.next`">]>, undefined>;
+}, undefined>;
+export type ErrorReason = v.InferOutput<typeof reasonSchema>;
+/** Reasons live where they are raised; each package defines its own list with this. */
+export declare const defineReasons: (input: unknown) => ErrorReason[];
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/standards/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/standards/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAK5B,4FAA4F;AAC5F,eAAO,MAAM,iBAAiB;;;;;QAK1B,uCAAuC;;;;;;;;;;;;;;;;;;aAMzC,CAAA;AAEF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAEjE,QAAA,MAAM,YAAY;;;IAGhB,oDAAoD;;;;aAIpD,CAAA;AAEF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,YAAY,CAAC,CAAA;AAE5D,uFAAuF;AACvF,eAAO,MAAM,aAAa,UAAW,OAAO,KAAG,WAAW,EAQtD,CAAA"}

package/dist/standards/errors.js

@@ -0,0 +1,33 @@
+import * as v from "valibot";
+import { errorCodes } from "../errors.js";
+import { MAX_NEXT_STEPS, nextStepSchema } from "./output.js";
+import { dottedId, duplicates, parseRegistry, placeholders, text } from "./registry.js";
+/** The one error object, on stderr in machine mode and as MCP's `isError` content alike. */
+export const errorObjectSchema = v.strictObject({
+    error: v.strictObject({
+        code: v.picklist(errorCodes),
+        reason: dottedId,
+        message: text,
+        /** The option or argument at fault. */
+        param: v.optional(text),
+        details: v.optional(v.record(v.string(), v.unknown())),
+        next: v.optional(v.pipe(v.array(nextStepSchema), v.maxLength(MAX_NEXT_STEPS))),
+        runId: text,
+    }),
+});
+const reasonSchema = v.strictObject({
+    reason: dottedId,
+    code: v.picklist(errorCodes),
+    /** `{name}` placeholders, each one of `details`. */
+    message: v.pipe(text, v.maxLength(120)),
+    details: v.array(v.pipe(v.string(), v.regex(/^[a-z][a-zA-Z0-9]*$/, "a camelCase key"))),
+    step: v.optional(dottedId),
+});
+/** Reasons live where they are raised; each package defines its own list with this. */
+export const defineReasons = (input) => parseRegistry("error reasons", v.array(reasonSchema), input, (reasons) => [
+    ...duplicates(reasons.map((entry) => entry.reason)).map((reason) => `"${reason}" is listed twice`),
+    ...reasons.flatMap((entry) => placeholders(entry.message)
+        .filter((name) => !entry.details.includes(name))
+        .map((name) => `${entry.reason}: the message names {${name}}, which is not one of its details`)),
+]);
+//# sourceMappingURL=errors.js.map

package/dist/standards/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/standards/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AAEvF,4FAA4F;AAC5F,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,YAAY,CAAC;IAC9C,KAAK,EAAE,CAAC,CAAC,YAAY,CAAC;QACpB,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC5B,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,IAAI;QACb,uCAAuC;QACvC,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QACvB,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACtD,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC;QAC9E,KAAK,EAAE,IAAI;KACZ,CAAC;CACH,CAAC,CAAA;AAIF,MAAM,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC;IAClC,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;IAC5B,oDAAoD;IACpD,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,EAAE,iBAAiB,CAAC,CAAC,CAAC;IACvF,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;CAC3B,CAAC,CAAA;AAIF,uFAAuF;AACvF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAc,EAAiB,EAAE,CAC7D,aAAa,CAAC,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC;IACxE,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,MAAM,mBAAmB,CAAC;IAClG,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAC3B,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC;SACxB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;SAC/C,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,wBAAwB,IAAI,oCAAoC,CAAC,CAClG;CACF,CAAC,CAAA"}

package/dist/standards/index.d.ts

@@ -0,0 +1,8 @@
+export { defineReasons, type ErrorObject, type ErrorReason, errorObjectSchema } from "./errors.js";
+export { baselineProblems, baselineSchema, defineLintRules, LINT_RULES, LINT_SEVERITIES, type LintRule, type LintSeverity, OVERRIDE_BUDGET, type Override, overridesProblems, overridesSchema, } from "./lint.js";
+export { LOG_SEVERITIES, type LogRecord, type LogSeverity, logRecordSchema } from "./log.js";
+export { defineFieldRules, FIELD_RULES, type FieldRule, type ItemEnvelope, isoTime, itemEnvelopeSchema, type ListEnvelope, listEnvelopeSchema, MAX_NEXT_STEPS, type Meta, type Missing, metaSchema, missingSchema, type NextStep, nextStepSchema, type Page, pageSchema, } from "./output.js";
+export { fill, jsonSchemaOf, RegistryError } from "./registry.js";
+export { defineSteps, SAME_COMMAND, STEPS, type StepDefinition, type StepInput, stepOf } from "./steps.js";
+export { defineVocabulary, FLAG_TYPES, type FlagType, VOCABULARY, type Vocabulary, type VocabularyFlag, type VocabularyNoun, type VocabularyVerb, vocabularySchema, } from "./vocabulary.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/standards/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAClG,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,UAAU,EACV,eAAe,EACf,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,eAAe,EACf,KAAK,QAAQ,EACb,iBAAiB,EACjB,eAAe,GAChB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,cAAc,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAC5F,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,OAAO,EACP,kBAAkB,EAClB,KAAK,YAAY,EACjB,kBAAkB,EAClB,cAAc,EACd,KAAK,IAAI,EACT,KAAK,OAAO,EACZ,UAAU,EACV,aAAa,EACb,KAAK,QAAQ,EACb,cAAc,EACd,KAAK,IAAI,EACT,UAAU,GACX,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AACjE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,cAAc,EAAE,KAAK,SAAS,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAC1G,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,KAAK,QAAQ,EACb,UAAU,EACV,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,gBAAgB,GACjB,MAAM,iBAAiB,CAAA"}

package/dist/standards/index.js

@@ -0,0 +1,8 @@
+export { defineReasons, errorObjectSchema } from "./errors.js";
+export { baselineProblems, baselineSchema, defineLintRules, LINT_RULES, LINT_SEVERITIES, OVERRIDE_BUDGET, overridesProblems, overridesSchema, } from "./lint.js";
+export { LOG_SEVERITIES, logRecordSchema } from "./log.js";
+export { defineFieldRules, FIELD_RULES, isoTime, itemEnvelopeSchema, listEnvelopeSchema, MAX_NEXT_STEPS, metaSchema, missingSchema, nextStepSchema, pageSchema, } from "./output.js";
+export { fill, jsonSchemaOf, RegistryError } from "./registry.js";
+export { defineSteps, SAME_COMMAND, STEPS, stepOf } from "./steps.js";
+export { defineVocabulary, FLAG_TYPES, VOCABULARY, vocabularySchema, } from "./vocabulary.js";
+//# sourceMappingURL=index.js.map

package/dist/standards/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/standards/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAsC,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAClG,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,UAAU,EACV,eAAe,EAGf,eAAe,EAEf,iBAAiB,EACjB,eAAe,GAChB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,cAAc,EAAoC,eAAe,EAAE,MAAM,UAAU,CAAA;AAC5F,OAAO,EACL,gBAAgB,EAChB,WAAW,EAGX,OAAO,EACP,kBAAkB,EAElB,kBAAkB,EAClB,cAAc,EAGd,UAAU,EACV,aAAa,EAEb,cAAc,EAEd,UAAU,GACX,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AACjE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,EAAuC,MAAM,EAAE,MAAM,YAAY,CAAA;AAC1G,OAAO,EACL,gBAAgB,EAChB,UAAU,EAEV,UAAU,EAKV,gBAAgB,GACjB,MAAM,iBAAiB,CAAA"}

package/dist/standards/lint.d.ts

@@ -0,0 +1,29 @@
+import * as v from "valibot";
+export declare const LINT_SEVERITIES: readonly ["high", "medium", "low"];
+declare const lintRuleSchema: v.StrictObjectSchema<{
+    readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a lower-case word, words joined by -">]>;
+    readonly severity: v.PicklistSchema<readonly ["high", "medium", "low"], undefined>;
+    /** What the rule looks at; a violation's target names one of these. */
+    readonly scope: v.PicklistSchema<["command", "group", "argument", "option", "flag"], undefined>;
+    readonly summary: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "must not be empty">]>;
+}, undefined>;
+export type LintRule = v.InferOutput<typeof lintRuleSchema>;
+export type LintSeverity = (typeof LINT_SEVERITIES)[number];
+export declare const defineLintRules: (input: unknown) => LintRule[];
+/** Ids and severities follow the Azure CLI linter (`azdev linter`): a rule is named after what it finds. */
+export declare const LINT_RULES: LintRule[];
+/** `lint/baseline/<rule-id>.json`: today's violations of one rule, by target. It may only shrink. */
+export declare const baselineSchema: v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "must not be empty">]>, undefined>;
+/** `lint/overrides.json`: permanent exceptions, each with its reason, counted against a budget. */
+export declare const overridesSchema: v.ArraySchema<v.StrictObjectSchema<{
+    readonly rule: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a lower-case word, words joined by -">]>;
+    readonly target: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "must not be empty">]>;
+    readonly reason: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "must not be empty">]>, v.MinLengthAction<string, 10, "say why, in a sentence">]>;
+}, undefined>, undefined>;
+export type Override = v.InferOutput<typeof overridesSchema>[number];
+/** What the schemas cannot say, so they stay convertible to JSON Schema: no entry twice. */
+export declare const baselineProblems: (targets: readonly string[]) => string[];
+export declare const overridesProblems: (entries: readonly Override[]) => string[];
+export declare const OVERRIDE_BUDGET = 10;
+export {};
+//# sourceMappingURL=lint.d.ts.map

package/dist/standards/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/standards/lint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAG5B,eAAO,MAAM,eAAe,YAAI,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAU,CAAA;AAEjE,QAAA,MAAM,cAAc;;;IAGlB,uEAAuE;;;aAGvE,CAAA;AAEF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,cAAc,CAAC,CAAA;AAC3D,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAA;AAE3D,eAAO,MAAM,eAAe,UAAW,OAAO,KAAG,QAAQ,EAGtD,CAAA;AAEH,4GAA4G;AAC5G,eAAO,MAAM,UAAU,EAAE,QAAQ,EA4B/B,CAAA;AAEF,qGAAqG;AACrG,eAAO,MAAM,cAAc,8HAAgB,CAAA;AAE3C,mGAAmG;AACnG,eAAO,MAAM,eAAe;;;;yBAE3B,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAA;AAEpE,4FAA4F;AAC5F,eAAO,MAAM,gBAAgB,YAAa,SAAS,MAAM,EAAE,KAAG,MAAM,EACA,CAAA;AAEpE,eAAO,MAAM,iBAAiB,YAAa,SAAS,QAAQ,EAAE,KAAG,MAAM,EACyC,CAAA;AAEhH,eAAO,MAAM,eAAe,KAAK,CAAA"}

package/dist/standards/lint.js

@@ -0,0 +1,50 @@
+import * as v from "valibot";
+import { duplicates, parseRegistry, text, word } from "./registry.js";
+export const LINT_SEVERITIES = ["high", "medium", "low"];
+const lintRuleSchema = v.strictObject({
+    id: word,
+    severity: v.picklist(LINT_SEVERITIES),
+    /** What the rule looks at; a violation's target names one of these. */
+    scope: v.picklist(["command", "group", "argument", "option", "flag"]),
+    summary: text,
+});
+export const defineLintRules = (input) => parseRegistry("lint rules", v.array(lintRuleSchema), input, (rules) => duplicates(rules.map((rule) => rule.id)).map((id) => `"${id}" is listed twice`));
+/** Ids and severities follow the Azure CLI linter (`azdev linter`): a rule is named after what it finds. */
+export const LINT_RULES = defineLintRules([
+    {
+        id: "unknown-verb",
+        severity: "high",
+        scope: "command",
+        summary: "a command's last word is a verb or view noun from the vocabulary; a top-level one may be a root word",
+    },
+    {
+        id: "unknown-resource",
+        severity: "medium",
+        scope: "group",
+        summary: "a group is a resource from the vocabulary (plural, or a registered singular) or a root word",
+    },
+    {
+        id: "flag-two-meanings",
+        severity: "high",
+        scope: "flag",
+        summary: "a flag takes the same kind of value in every command, and the one the vocabulary gives it",
+    },
+    { id: "missing-command-help", severity: "high", scope: "command", summary: "every command has a summary" },
+    {
+        id: "command-help-too-long",
+        severity: "low",
+        scope: "command",
+        summary: "a summary is at most 80 characters",
+    },
+    { id: "missing-argument-help", severity: "high", scope: "argument", summary: "every argument is described" },
+    { id: "missing-option-help", severity: "high", scope: "option", summary: "every option is described" },
+]);
+/** `lint/baseline/<rule-id>.json`: today's violations of one rule, by target. It may only shrink. */
+export const baselineSchema = v.array(text);
+/** `lint/overrides.json`: permanent exceptions, each with its reason, counted against a budget. */
+export const overridesSchema = v.array(v.strictObject({ rule: word, target: text, reason: v.pipe(text, v.minLength(10, "say why, in a sentence")) }));
+/** What the schemas cannot say, so they stay convertible to JSON Schema: no entry twice. */
+export const baselineProblems = (targets) => duplicates(targets).map((target) => `"${target}" is listed twice`);
+export const overridesProblems = (entries) => duplicates(entries.map((entry) => `${entry.rule} ${entry.target}`)).map((both) => `"${both}" is listed twice`);
+export const OVERRIDE_BUDGET = 10;
+//# sourceMappingURL=lint.js.map

package/dist/standards/lint.js.map

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

package/dist/standards/log.d.ts

@@ -0,0 +1,21 @@
+import * as v from "valibot";
+/** pino's level names, so a record maps to OpenTelemetry's SeverityText by upper-casing it. */
+export declare const LOG_SEVERITIES: readonly ["trace", "debug", "info", "warn", "error", "fatal"];
+/** One log record, OpenTelemetry's field names, one flat JSON line. */
+export declare const logRecordSchema: v.StrictObjectSchema<{
+    readonly time: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>;
+    readonly severity: v.PicklistSchema<readonly ["trace", "debug", "info", "warn", "error", "fatal"], undefined>;
+    readonly body: v.StringSchema<undefined>;
+    readonly runId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "must not be empty">]>;
+    /** From an MCP caller's `_meta.traceparent`, when it sent one. */
+    readonly traceId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "32 lower-case hex digits">]>, undefined>;
+    readonly command: v.StringSchema<undefined>;
+    readonly attributes: v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>;
+    readonly resource: v.StrictObjectSchema<{
+        readonly service: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "must not be empty">]>;
+        readonly version: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "must not be empty">]>;
+    }, undefined>;
+}, undefined>;
+export type LogRecord = v.InferOutput<typeof logRecordSchema>;
+export type LogSeverity = (typeof LOG_SEVERITIES)[number];
+//# sourceMappingURL=log.d.ts.map

package/dist/standards/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/standards/log.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAI5B,+FAA+F;AAC/F,eAAO,MAAM,cAAc,YAAI,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAU,CAAA;AAE3F,uEAAuE;AACvE,eAAO,MAAM,eAAe;;;;;IAK1B,kEAAkE;;;;;;;;aAKlE,CAAA;AAEF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,eAAe,CAAC,CAAA;AAC7D,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA"}

package/dist/standards/log.js

@@ -0,0 +1,18 @@
+import * as v from "valibot";
+import { isoTime } from "./output.js";
+import { text } from "./registry.js";
+/** pino's level names, so a record maps to OpenTelemetry's SeverityText by upper-casing it. */
+export const LOG_SEVERITIES = ["trace", "debug", "info", "warn", "error", "fatal"];
+/** One log record, OpenTelemetry's field names, one flat JSON line. */
+export const logRecordSchema = v.strictObject({
+    time: isoTime,
+    severity: v.picklist(LOG_SEVERITIES),
+    body: v.string(),
+    runId: text,
+    /** From an MCP caller's `_meta.traceparent`, when it sent one. */
+    traceId: v.optional(v.pipe(v.string(), v.regex(/^[0-9a-f]{32}$/, "32 lower-case hex digits"))),
+    command: v.string(),
+    attributes: v.record(v.string(), v.unknown()),
+    resource: v.strictObject({ service: text, version: text }),
+});
+//# sourceMappingURL=log.js.map

package/dist/standards/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/standards/log.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AAEpC,+FAA+F;AAC/F,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAU,CAAA;AAE3F,uEAAuE;AACvE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,YAAY,CAAC;IAC5C,IAAI,EAAE,OAAO;IACb,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,IAAI;IACX,kEAAkE;IAClE,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,EAAE,0BAA0B,CAAC,CAAC,CAAC;IAC9F,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IAC7C,QAAQ,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;CAC3D,CAAC,CAAA"}