@spinabot/brigade 0.1.1 → 1.0.0

package/dist/agents/skills/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/agents/skills/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAQH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAmBxD,+EAA+E;AAC/E,MAAM,WAAW,uBAAuB;IACvC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,QAAQ,EAAE,OAAO,CAAC;IAClB,wEAAwE;IACxE,kBAAkB,EAAE,OAAO,CAAC;IAC5B,oEAAoE;IACpE,QAAQ,EAAE,OAAO,CAAC;IAClB,0EAA0E;IAC1E,YAAY,EAAE,uBAAuB,CAAC;IACtC,mEAAmE;IACnE,OAAO,EAAE,uBAAuB,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AA2ED,MAAM,WAAW,0BAA0B;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,0BAA0B,GAAG,iBAAiB,CA+C1F"}

package/dist/agents/skills/status.js

@@ -0,0 +1,147 @@
+/**
+ * Skill status reporter — the diagnostic surface behind the `skills.status`
+ * RPC. Built by walking the same discovery roots the per-turn assembler
+ * walks, then projecting each candidate skill (eligible OR not) into a
+ * stable wire shape so the operator can see WHY a skill was hidden:
+ *
+ *   - `eligible: false` + `missing.{bins,anyBins,env,config}` populated
+ *     → skill failed an os/bins/env/config requirement
+ *   - `eligible: false` + `blockedByAllowlist: true`
+ *     → per-agent `cfg.agents.<id>.skills` (or `defaults.skills`) hides it
+ *   - `eligible: false` + `disabled: true`
+ *     → operator turned the skill off via `cfg.skills.entries[<name>].enabled`
+ *
+ * Brand-scrubbed analogue of the reference codebase's `skills-status.ts` +
+ * the `skills.status` gateway method. Brigade omits the install-option
+ * picker (no ClawHub-style remote registry yet); the per-skill `install`
+ * field is reserved for the SkillInstallSpec block authored in SKILL.md
+ * frontmatter and is intentionally undefined for hand-authored skills.
+ */
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { loadSkillsFromDir } from "@mariozechner/pi-coding-agent";
+import { resolveBundledSkillsDir, resolveManagedSkillsDir, } from "../../config/paths.js";
+import { resolveEffectiveAgentSkillFilter } from "./agent-filter.js";
+import { SOURCE_MANAGED, SOURCE_PERSONAL, SOURCE_PROJECT, } from "./discovery.js";
+import { hasBinary, isConfigPathTruthy, isSkillEligible, readSkillEligibility, } from "./eligibility.js";
+/** Source roots, lowest → highest precedence. Mirrors discoverSkills(). */
+function buildRoots(workspaceDir, config) {
+    const out = [];
+    const push = (dir, source) => {
+        if (dir && dir.length > 0)
+            out.push({ dir, source });
+    };
+    push(resolveBundledSkillsDir(), "bundled");
+    for (const p of config.skills?.paths ?? [])
+        push(p, "config");
+    push(resolveManagedSkillsDir(), SOURCE_MANAGED);
+    push(path.join(os.homedir(), ".agents", "skills"), SOURCE_PERSONAL);
+    push(path.join(workspaceDir, ".agents", "skills"), SOURCE_PROJECT);
+    push(path.join(workspaceDir, "skills"), "workspace");
+    return out;
+}
+function scanRoot(dir, source) {
+    if (!fs.existsSync(dir))
+        return [];
+    try {
+        const res = loadSkillsFromDir({ dir, source });
+        return res.skills.map((skill) => ({ skill, source }));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Compute the missing subset of a skill's declared requirements. Mirrors the
+ * decision pattern in `isSkillEligible` so the report agrees with the
+ * runtime gate.
+ */
+function computeMissing(meta, platform, env, config) {
+    const missing = {};
+    if (meta.os.length > 0 && !meta.os.includes(platform)) {
+        missing.os = [platform];
+    }
+    const missingBins = meta.requiresBins.filter((bin) => !hasBinary(bin, env));
+    if (missingBins.length > 0)
+        missing.bins = missingBins;
+    if (meta.requiresAnyBins.length > 0 &&
+        !meta.requiresAnyBins.some((bin) => hasBinary(bin, env))) {
+        missing.anyBins = [...meta.requiresAnyBins];
+    }
+    const missingEnv = meta.requiresEnv.filter((key) => {
+        const v = env[key];
+        return !v || v.trim().length === 0;
+    });
+    if (missingEnv.length > 0)
+        missing.env = missingEnv;
+    const missingConfig = meta.requiresConfig.filter((dottedPath) => !isConfigPathTruthy(config, dottedPath));
+    if (missingConfig.length > 0)
+        missing.config = missingConfig;
+    return missing;
+}
+function toRequirements(meta) {
+    const r = {};
+    if (meta.os.length > 0)
+        r.os = [...meta.os];
+    if (meta.requiresBins.length > 0)
+        r.bins = [...meta.requiresBins];
+    if (meta.requiresAnyBins.length > 0)
+        r.anyBins = [...meta.requiresAnyBins];
+    if (meta.requiresEnv.length > 0)
+        r.env = [...meta.requiresEnv];
+    if (meta.requiresConfig.length > 0)
+        r.config = [...meta.requiresConfig];
+    return r;
+}
+/**
+ * Build a full status report for the supplied workspace + config. Walks every
+ * known scan root, dedupes by name (highest precedence wins, matching the
+ * runtime discovery order), and projects each candidate to a wire-stable
+ * `SkillStatusEntry`. Used by the `skills.status` RPC.
+ */
+export function buildSkillStatusReport(args) {
+    const platform = args.platform ?? process.platform;
+    const env = args.env ?? process.env;
+    const allowlist = resolveEffectiveAgentSkillFilter(args.config, args.agentId);
+    const disabledEntries = args.config.skills?.entries ?? {};
+    const byName = new Map();
+    for (const root of buildRoots(args.workspaceDir, args.config)) {
+        for (const found of scanRoot(root.dir, root.source)) {
+            byName.set(found.skill.name, found);
+        }
+    }
+    const skills = [];
+    for (const { skill, source } of byName.values()) {
+        const eligibility = readSkillEligibility(skill.filePath);
+        const requirements = toRequirements(eligibility);
+        const missing = computeMissing(eligibility, platform, env, args.config);
+        const requirementsOk = isSkillEligible(eligibility, {
+            platform,
+            env,
+            config: args.config,
+        });
+        const disabledEntry = disabledEntries[skill.name];
+        const disabled = disabledEntry?.enabled === false;
+        const blockedByAllowlist = allowlist !== undefined && !allowlist.includes(skill.name);
+        const eligible = requirementsOk && !disabled && !blockedByAllowlist;
+        skills.push({
+            name: skill.name,
+            description: skill.description,
+            source,
+            filePath: skill.filePath,
+            disabled,
+            blockedByAllowlist,
+            eligible,
+            requirements,
+            missing,
+        });
+    }
+    skills.sort((a, b) => a.name.localeCompare(b.name));
+    return {
+        workspaceDir: args.workspaceDir,
+        managedSkillsDir: resolveManagedSkillsDir(),
+        skills,
+    };
+}
+//# sourceMappingURL=status.js.map

package/dist/agents/skills/status.js.map

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

package/dist/agents/skills/update-config.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Pure config-mutation helper behind the `skills.update` RPC.
+ *
+ * Given the current config + a partial update (enabled flag, apiKey, env
+ * overrides) for one skill, return the next config with
+ * `skills.entries[<name>]` patched. The gateway handler wraps this with the
+ * load → mutate → save cycle; keeping the mutation pure means the test
+ * suite can assert "passing enabled=false flips the entry" without booting
+ * a server.
+ */
+import type { BrigadeConfig, BrigadeSkillEntry } from "../../config/io.js";
+export interface SkillUpdateRequest {
+    /** Skill name to patch (e.g. `gh`). Required. */
+    name: string;
+    /** Toggle the skill on/off. Unset means "leave existing value alone". */
+    enabled?: boolean;
+    /** Replace the skill's api key. Empty/whitespace → delete the field. */
+    apiKey?: string;
+    /** Per-key env override patch. Empty/whitespace values delete keys. */
+    env?: Record<string, string>;
+}
+export interface SkillUpdateResult {
+    config: BrigadeConfig;
+    entry: BrigadeSkillEntry;
+}
+/**
+ * Apply a single `skills.update` patch and return the next config + the
+ * resulting entry. Does not touch disk — the caller is responsible for
+ * persistence.
+ */
+export declare function applySkillUpdate(current: BrigadeConfig, patch: SkillUpdateRequest): SkillUpdateResult;
+//# sourceMappingURL=update-config.d.ts.map

package/dist/agents/skills/update-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-config.d.ts","sourceRoot":"","sources":["../../../src/agents/skills/update-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE3E,MAAM,WAAW,kBAAkB;IAClC,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IACjC,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,iBAAiB,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,kBAAkB,GACvB,iBAAiB,CAgCnB"}

package/dist/agents/skills/update-config.js

@@ -0,0 +1,53 @@
+/**
+ * Pure config-mutation helper behind the `skills.update` RPC.
+ *
+ * Given the current config + a partial update (enabled flag, apiKey, env
+ * overrides) for one skill, return the next config with
+ * `skills.entries[<name>]` patched. The gateway handler wraps this with the
+ * load → mutate → save cycle; keeping the mutation pure means the test
+ * suite can assert "passing enabled=false flips the entry" without booting
+ * a server.
+ */
+/**
+ * Apply a single `skills.update` patch and return the next config + the
+ * resulting entry. Does not touch disk — the caller is responsible for
+ * persistence.
+ */
+export function applySkillUpdate(current, patch) {
+    const name = patch.name.trim();
+    if (!name)
+        throw new Error("skills.update: name is required");
+    const next = { ...current };
+    const skillsBlock = { ...(next.skills ?? {}) };
+    const entries = { ...(skillsBlock.entries ?? {}) };
+    const existing = entries[name] ?? {};
+    const merged = { ...existing };
+    if (typeof patch.enabled === "boolean")
+        merged.enabled = patch.enabled;
+    if (typeof patch.apiKey === "string") {
+        const trimmed = patch.apiKey.trim();
+        if (trimmed.length > 0)
+            merged.apiKey = trimmed;
+        else
+            delete merged.apiKey;
+    }
+    if (patch.env && typeof patch.env === "object") {
+        const nextEnv = { ...(merged.env ?? {}) };
+        for (const [k, v] of Object.entries(patch.env)) {
+            const tk = k.trim();
+            if (!tk)
+                continue;
+            const tv = (v ?? "").trim();
+            if (!tv)
+                delete nextEnv[tk];
+            else
+                nextEnv[tk] = tv;
+        }
+        merged.env = nextEnv;
+    }
+    entries[name] = merged;
+    skillsBlock.entries = entries;
+    next.skills = skillsBlock;
+    return { config: next, entry: merged };
+}
+//# sourceMappingURL=update-config.js.map

package/dist/agents/skills/update-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-config.js","sourceRoot":"","sources":["../../../src/agents/skills/update-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAoBH;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC/B,OAAsB,EACtB,KAAyB;IAEzB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAE9D,MAAM,IAAI,GAAkB,EAAE,GAAG,OAAO,EAAE,CAAC;IAC3C,MAAM,WAAW,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAG,EAAE,GAAG,CAAC,WAAW,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;IACnD,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACrC,MAAM,MAAM,GAA4B,EAAE,GAAG,QAAQ,EAAE,CAAC;IAExD,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,SAAS;QAAE,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IACvE,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACpC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC;;YAC3C,OAAO,MAAM,CAAC,MAAM,CAAC;IAC3B,CAAC;IACD,IAAI,KAAK,CAAC,GAAG,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,OAAO,GAAG,EAAE,GAAG,CAAE,MAAM,CAAC,GAA0C,IAAI,EAAE,CAAC,EAAE,CAAC;QAClF,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YAChD,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YACpB,IAAI,CAAC,EAAE;gBAAE,SAAS;YAClB,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,EAAE;gBAAE,OAAO,OAAO,CAAC,EAAE,CAAC,CAAC;;gBACvB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC;QACvB,CAAC;QACD,MAAM,CAAC,GAAG,GAAG,OAAO,CAAC;IACtB,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,GAAG,MAA2B,CAAC;IAC5C,WAAW,CAAC,OAAO,GAAG,OAAO,CAAC;IAC9B,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC;IAC1B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAA2B,EAAE,CAAC;AAC7D,CAAC"}

package/dist/agents/slash-commands.d.ts

@@ -0,0 +1,25 @@
+export type SlashCommandResult = {
+    type: "passthrough";
+    message: string;
+} | {
+    type: "model";
+    provider: string;
+    modelId: string;
+} | {
+    type: "thinking";
+    level: "off" | "low" | "medium" | "high";
+} | {
+    type: "reset";
+} | {
+    type: "help";
+} | {
+    type: "error";
+    message: string;
+};
+export interface SlashCommandHelpEntry {
+    command: string;
+    description: string;
+}
+export declare const SLASH_COMMAND_HELP: SlashCommandHelpEntry[];
+export declare function parseSlashCommand(rawMessage: string): SlashCommandResult;
+//# sourceMappingURL=slash-commands.d.ts.map

package/dist/agents/slash-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slash-commands.d.ts","sourceRoot":"","sources":["../../src/agents/slash-commands.ts"],"names":[],"mappings":"AAoBA,MAAM,MAAM,kBAAkB,GAC1B;IACE,IAAI,EAAE,aAAa,CAAC;IAEpB,OAAO,EAAE,MAAM,CAAC;CACjB,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IAGd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CAC1C,GACD;IACE,IAAI,EAAE,OAAO,CAAC;CACf,GACD;IACE,IAAI,EAAE,MAAM,CAAC;CACd,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IAEd,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,kBAAkB,EAAE,qBAAqB,EAsBrD,CAAC;AAIF,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,CAsCxE"}

package/dist/agents/slash-commands.js

@@ -0,0 +1,151 @@
+// Slash-command intercepts that run BEFORE the message reaches the agent
+// loop. The CLI / gateway calls `parseSlashCommand` on every inbound user
+// message; if it returns a `Handled` result, the loop short-circuits and
+// the side-effect (model switch, session reset, etc.) runs locally
+// without burning a model call.
+//
+// Why local intercepts and not let the model handle it: the model can't
+// switch its own model. The model can't truncate its own session. These
+// are operator-level commands and need to fire deterministically.
+//
+// The current command set is small on purpose — slash commands are a UX
+// surface the user has to remember. We only ship what's load-bearing for
+// running the loop:
+//
+//   /model <provider/modelId>   change the model used for the NEXT turn
+//   /model                      print the active model
+//   /thinking <off|low|med|high>  set thinking level for next turn
+//   /reset                      forget the running session and start fresh
+//   /help                       list available commands
+export const SLASH_COMMAND_HELP = [
+    {
+        command: "/model <provider/modelId>",
+        description: "Switch the model for the next turn (e.g. `/model anthropic/claude-opus-4-7`).",
+    },
+    {
+        command: "/model",
+        description: "Print the active provider/model for this session.",
+    },
+    {
+        command: "/thinking <off|low|medium|high>",
+        description: "Set the thinking level for the next turn.",
+    },
+    {
+        command: "/reset",
+        description: "Forget the running session and start a new one on the next turn.",
+    },
+    {
+        command: "/help",
+        description: "Show this list.",
+    },
+];
+const KNOWN_THINKING_LEVELS = new Set(["off", "low", "medium", "high"]);
+export function parseSlashCommand(rawMessage) {
+    if (typeof rawMessage !== "string") {
+        return { type: "passthrough", message: String(rawMessage ?? "") };
+    }
+    const trimmed = rawMessage.trimStart();
+    if (trimmed.length === 0 || trimmed[0] !== "/") {
+        return { type: "passthrough", message: rawMessage };
+    }
+    const newlineIdx = trimmed.indexOf("\n");
+    // Slash commands occupy ONE line. If the first line is a slash command
+    // and there's content after a newline, keep the post-newline content as
+    // a follow-up message and let the command run first. The caller can
+    // re-invoke the parser on the rest.
+    const commandLine = newlineIdx >= 0 ? trimmed.slice(0, newlineIdx) : trimmed;
+    // Tokenise. Quoted strings are NOT special — we don't need them yet.
+    const parts = commandLine.split(/\s+/u).filter((p) => p.length > 0);
+    const head = parts[0]?.toLowerCase() ?? "";
+    const rest = parts.slice(1);
+    switch (head) {
+        case "/model":
+            return parseModelCommand(rest);
+        case "/thinking":
+            return parseThinkingCommand(rest);
+        case "/reset":
+            if (rest.length > 0) {
+                return { type: "error", message: "/reset takes no arguments" };
+            }
+            return { type: "reset" };
+        case "/help":
+            return { type: "help" };
+        default:
+            // Unknown slash command — pass through as-is (the model may know
+            // what to do with it). This is intentional: we don't want to error
+            // on user-defined / future-defined commands.
+            return { type: "passthrough", message: rawMessage };
+    }
+}
+function parseModelCommand(rest) {
+    if (rest.length === 0) {
+        // /model with no args = print active model. Caller decides how to
+        // surface; we encode it as a help-style result for now.
+        return { type: "help" };
+    }
+    if (rest.length > 1) {
+        return {
+            type: "error",
+            message: "/model expects exactly one argument (provider/modelId)",
+        };
+    }
+    const ref = rest[0];
+    // Split on the FIRST slash — provider names never contain slashes, but
+    // model IDs do. OpenRouter uses `openrouter` as provider and routes via
+    // model IDs like `openai/gpt-5.4-mini`, so `/model openrouter/openai/gpt-5.4-mini`
+    // must produce provider=`openrouter`, modelId=`openai/gpt-5.4-mini`.
+    const slash = ref.indexOf("/");
+    if (slash <= 0 || slash >= ref.length - 1) {
+        return {
+            type: "error",
+            message: "/model argument must be in 'provider/modelId' form " +
+                "(e.g. anthropic/claude-opus-4-7 or openrouter/openai/gpt-5.4-mini)",
+        };
+    }
+    const provider = ref.slice(0, slash).trim();
+    const modelId = ref.slice(slash + 1).trim();
+    if (!isValidProvider(provider) || !isValidModelId(modelId)) {
+        return {
+            type: "error",
+            message: "/model provider and modelId must be non-empty identifiers",
+        };
+    }
+    return { type: "model", provider, modelId };
+}
+function parseThinkingCommand(rest) {
+    if (rest.length !== 1) {
+        return {
+            type: "error",
+            message: "/thinking expects exactly one argument (off | low | medium | high)",
+        };
+    }
+    const level = rest[0].toLowerCase();
+    if (!KNOWN_THINKING_LEVELS.has(level)) {
+        return {
+            type: "error",
+            message: `/thinking expects one of: ${[...KNOWN_THINKING_LEVELS].join(", ")}`,
+        };
+    }
+    return {
+        type: "thinking",
+        level: level,
+    };
+}
+function isValidProvider(value) {
+    // Provider names are short, never contain slashes (we split on the first
+    // slash to separate provider from modelId).
+    if (value.length === 0 || value.length > 64)
+        return false;
+    return /^[a-z0-9._\-:@]+$/i.test(value);
+}
+function isValidModelId(value) {
+    // Model IDs are wider — OpenRouter routes via `openai/gpt-5.4-mini`,
+    // `anthropic/claude-opus-4-7`, `mistralai/mixtral-8x7b-instruct` etc.,
+    // so we MUST permit slashes in the modelId portion. Bedrock + others
+    // also use colons (e.g. `anthropic.claude-3-5-sonnet-20241022-v2:0`).
+    // We just refuse whitespace and shell metacharacters.
+    if (value.length === 0 || value.length > 128)
+        return false;
+    return /^[a-z0-9._\-:@/]+$/i.test(value);
+}
+//# sourceMappingURL=slash-commands.js.map

package/dist/agents/slash-commands.js.map

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

package/dist/agents/smart-compaction.d.ts

@@ -0,0 +1,105 @@
+export declare const MAX_TOOL_RESULT_CONTEXT_SHARE = 0.3;
+export declare const DEFAULT_MAX_LIVE_TOOL_RESULT_CHARS = 16000;
+export declare const MIN_KEEP_CHARS = 2000;
+export interface ResolveToolResultLimitArgs {
+    contextWindowTokens: number;
+    hardCharOverride?: number;
+}
+export declare function resolveToolResultMaxChars(args: ResolveToolResultLimitArgs): number;
+export interface TruncateToolResultArgs {
+    text: string;
+    maxChars: number;
+}
+export interface TruncationOutcome {
+    text: string;
+    truncated: boolean;
+    droppedChars: number;
+}
+export declare function truncateToolResultText(args: TruncateToolResultArgs): TruncationOutcome;
+export declare function formatTruncationSuffix(droppedChars: number): string;
+export declare const MIN_PROMPT_BUDGET_TOKENS = 8000;
+export declare const MIN_PROMPT_BUDGET_RATIO = 0.5;
+export declare const COMPACTION_TRIGGER_RATIO = 0.85;
+export interface CompactionDecisionArgs {
+    contextWindowTokens: number;
+    estimatedUsageTokens: number;
+}
+export interface CompactionDecision {
+    shouldRecommendCompaction: boolean;
+    triggerThresholdTokens: number;
+    promptBudgetTokens: number;
+    reason: "below-threshold" | "headroom-tight" | "headroom-too-tight" | "ready";
+}
+export declare function evaluateCompactionDecision(args: CompactionDecisionArgs): CompactionDecision;
+import type { BrigadeConfig } from "../config/io.js";
+import type { BrigadeExtensionRegistry } from "./extensions/registry.js";
+export interface CompactWithSlotResolutionArgs {
+    /** Messages handed to the slot-resolved compactor (caller-owned shape). */
+    messages: ReadonlyArray<unknown>;
+    /** 0..1 target compression ratio. Smaller = more aggressive. */
+    compressionRatio: number;
+    /** Extension registry — when omitted the resolver short-circuits to fallback. */
+    registry?: BrigadeExtensionRegistry;
+    /** Active brigade.json. The resolver reads `extensions.slots.compaction`. */
+    config: BrigadeConfig;
+    /** Optional abort signal passed through to the provider's summarize call. */
+    signal?: AbortSignal;
+}
+/**
+ * Resolve the active compaction provider via the slot config and call its
+ * `summarize` if pinned + registered; otherwise return `{fallback: true}`
+ * so the caller can fall back to the built-in head+tail truncation.
+ *
+ * No behaviour change today — Brigade ships no compaction-provider plugin
+ * and the in-tree compactor (`smartCompactToolResults` below) remains the
+ * single source of truth. This shim is the seam a future plugin slots into.
+ */
+export declare function compactWithSlotResolution(args: CompactWithSlotResolutionArgs): Promise<string | {
+    fallback: true;
+}>;
+import type { AgentMessage } from "@mariozechner/pi-agent-core";
+export interface SmartCompactionOptions {
+    /**
+     * Hard cap per individual tool-result text block. Defaults to
+     * 30% of `contextWindowTokens × 4` (rough chars-per-token), then
+     * capped at 16KB. Pass an explicit number to override.
+     */
+    maxCharsPerResult?: number;
+    /**
+     * Total budget across ALL tool results combined. Defaults to
+     * 50% of the context window in chars, then capped at 64KB.
+     */
+    aggregateBudgetChars?: number;
+    /** Minimum chars kept per result after truncation. Default 2000. */
+    minKeepChars?: number;
+    /**
+     * Context window size in tokens (used to derive the defaults above).
+     * Defaults to 32_000 (conservative open-source baseline) when unknown.
+     */
+    contextWindowTokens?: number;
+    /**
+     * If true, when a result contains error / traceback / "FAIL" patterns,
+     * preserve the LAST ~40% of the text so the diagnostic survives. Default true.
+     */
+    preserveImportantTail?: boolean;
+}
+export interface CompactionStats {
+    oversizedCount: number;
+    aggregateReducibleChars: number;
+    totalSavedChars: number;
+}
+/**
+ * Walk message history, shrinking tool-result text blocks per the two-tier
+ * algorithm. Returns a new array; never mutates the input.
+ *
+ * Image / non-text content blocks pass through untouched (truncating base64
+ * would corrupt them).
+ *
+ * `transformContext` callers should run this BEFORE sanitizeMessages so
+ * truncation markers added here don't get a surrogate-strip pass over them.
+ */
+export declare function smartCompactToolResults(messages: AgentMessage[], options?: SmartCompactionOptions): {
+    messages: AgentMessage[];
+    stats: CompactionStats;
+};
+//# sourceMappingURL=smart-compaction.d.ts.map

package/dist/agents/smart-compaction.d.ts.map

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