@spinabot/brigade 0.1.1 → 1.0.0

package/dist/cli/commands/agent.js

@@ -0,0 +1,297 @@
+import { execFileSync } from "node:child_process";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { runSingleTurn } from "../../agents/agent-loop.js";
+import { parseSlashCommand, SLASH_COMMAND_HELP, } from "../../agents/slash-commands.js";
+import { readConfigOrInit } from "../../config/io.js";
+import { DEFAULT_AGENT_ID, resolveAllPaths } from "../../config/paths.js";
+import { defaultSessionKey, readSessionStore, writeSessionStore, } from "../../sessions/session-store.js";
+export function registerAgentCommand(program) {
+    program
+        .command("agent")
+        .description("Drive a single turn through the agent pipeline")
+        .option("--agent-id <id>", "agent id", DEFAULT_AGENT_ID)
+        .option("-m, --message <text>", "user message to send")
+        .option("--session-key <key>", "session key (default: agent:<id>:main)")
+        .option("--provider <name>", "provider id (e.g. anthropic, openrouter, ollama)")
+        .option("--model <id>", "model id (e.g. claude-sonnet-4-6)")
+        .option("--workspace <dir>", "override workspace directory")
+        .option("--thinking-level <level>", "off | low | medium | high (model-dependent)", "off")
+        .option("--autonomous", "drive the message as a task across multiple turns until done or a limit")
+        .option("--max-iterations <n>", "autonomous turn cap (default 25)", (v) => Number.parseInt(v, 10))
+        .action(async (raw) => {
+        await runAgentTurn(raw);
+    });
+}
+export async function runAgentTurn(opts) {
+    const agentId = opts.agentId ?? DEFAULT_AGENT_ID;
+    const sessionKey = opts.sessionKey ?? defaultSessionKey(agentId);
+    const paths = resolveAllPaths(agentId, opts.workspace);
+    // Validation errors throw rather than `process.exitCode = 1; return`.
+    // entry.ts unconditionally calls process.exit(returnedCode) and would
+    // mask exitCode=1 set on the global object — throwing routes through
+    // run-main's mapErrorToExitCode and produces the right non-zero exit.
+    if (!opts.message || opts.message.length === 0) {
+        throw new Error("agent: --message is required.");
+    }
+    // Slash-command intercept. Runs BEFORE provider/model resolution because a
+    // `/model X` invocation can REPLACE the resolved provider/model for THIS
+    // turn, and a `/reset` simply forgets the session and exits.
+    //
+    // Slash commands fire locally — they don't reach the model. The user gets
+    // a one-line confirmation on stderr and (for `/model`) we also persist
+    // the new override to sessions.json so the NEXT user message goes to the
+    // requested model without needing the flag.
+    const slash = parseSlashCommand(opts.message);
+    let messageForAgent = opts.message;
+    let thinkingOverride;
+    switch (slash.type) {
+        case "passthrough":
+            messageForAgent = slash.message;
+            break;
+        case "model":
+            // Persist the switch to sessions.json so the NEXT `brigade agent` turn
+            // picks it up automatically. We do NOT also drive a model call this
+            // turn — that would burn tokens on a confirmation message no one asked
+            // for. A local stdout note + exit is the honest UX.
+            persistSessionModel({
+                agentId,
+                sessionKey,
+                provider: slash.provider,
+                modelId: slash.modelId,
+            });
+            console.error(`[brigade] /model: session ${sessionKey} switched to ${slash.provider}/${slash.modelId} — active on the next turn`);
+            return;
+        case "thinking":
+            thinkingOverride = slash.level;
+            // /thinking on its own line just sets the level for this run. If the
+            // user wanted to combine it with a real prompt, they'd have multi-line
+            // input — we treat that as not-yet-supported and require an explicit
+            // message. Print a note and exit cleanly.
+            console.error(`[brigade] /thinking: level set to '${slash.level}' for the next turn`);
+            return;
+        case "reset":
+            console.error(`[brigade] /reset: forgetting session ${sessionKey} — the next turn will start fresh`);
+            resetSession({ agentId, sessionKey });
+            return;
+        case "help":
+            console.error(`[brigade] available slash commands:`);
+            for (const entry of SLASH_COMMAND_HELP) {
+                console.error(`  ${entry.command.padEnd(34)} ${entry.description}`);
+            }
+            return;
+        case "error":
+            throw new Error(`agent: ${slash.message}`);
+    }
+    // Provider/model resolution order:
+    //   1. CLI flag (`--provider` / `--model`) — explicit user intent for this run.
+    //   2. Persisted session override — set by a prior `/model X` command.
+    //   3. Per-agent legacy slot (`agents.<id>.defaultProvider/defaultModel`)
+    //      — kept for back-compat with pre-wizard configs.
+    //   4. Onboard-wizard defaults (`agents.defaults.{provider, model.primary}`)
+    //      — the canonical onboarding output post-2026-05.
+    // The /model command short-circuits the run before reaching here, so by
+    // this point the persisted override applies to the user's NEXT real
+    // message, not the one carrying the slash command.
+    const cfg = readConfigOrInit();
+    const agentCfg = cfg.agents?.[agentId];
+    const wizardDefaults = cfg.agents?.defaults;
+    const sessionEntry = readSessionStore(agentId).sessions[sessionKey];
+    const provider = opts.provider ??
+        sessionEntry?.provider ??
+        agentCfg?.defaultProvider ??
+        wizardDefaults?.provider;
+    const modelId = opts.model ??
+        sessionEntry?.modelId ??
+        agentCfg?.defaultModel ??
+        wizardDefaults?.model?.primary;
+    if (!provider || !modelId) {
+        throw new Error("agent: --provider and --model are required " +
+            "(or run `brigade onboard --provider X --api-key Y --model Z` to persist defaults).");
+    }
+    console.error(`[brigade] agent=${agentId} provider=${provider} model=${modelId} ` +
+        `sessionKey=${sessionKey} state=${paths.stateDir}`);
+    // Ctrl-C / kill propagates as an AbortSignal into the agent loop. The
+    // first SIGINT requests a graceful abort (drains in-flight retries);
+    // a second SIGINT within the same process tears the run down hard
+    // by exiting with 130 (the conventional shell signal-code).
+    const abortController = new AbortController();
+    let sigintCount = 0;
+    const onSigint = () => {
+        sigintCount++;
+        if (sigintCount === 1) {
+            console.error("\n[brigade] interrupt received — aborting run gracefully (Ctrl-C again to force exit)");
+            abortController.abort(new Error("Interrupted by user"));
+            return;
+        }
+        console.error("\n[brigade] forced exit on second interrupt");
+        process.exit(130);
+    };
+    process.on("SIGINT", onSigint);
+    process.on("SIGTERM", onSigint);
+    // ── Autonomous mode: drive the task across MULTIPLE turns under the loop
+    // guards until the agent emits the completion marker (or doneChecks/guards
+    // fire). The SAME sessionKey each turn carries the conversation + tool
+    // results forward; the done-model is the loop-runner's (marker / objective
+    // checks / max-iterations). Ctrl-C aborts via the shared signal.
+    if (opts.autonomous) {
+        const { DEFAULT_COMPLETION_MARKER, autonomousModePrompt, runAutonomousAgent } = await import("../../agents/loop/autonomous-agent.js");
+        const marker = DEFAULT_COMPLETION_MARKER;
+        // Code Slop-Index gate (Step 33): won't let the run "finish" on a high-slop
+        // diff. Self-disabling outside a git repo / for non-code tasks.
+        const slopGate = buildSlopGate(process.cwd());
+        let turns = 0;
+        try {
+            const auto = await runAutonomousAgent({
+                task: `${autonomousModePrompt(marker)}\n\nYour task:\n${messageForAgent}`,
+                completionMarker: marker,
+                maxIterations: opts.maxIterations && opts.maxIterations > 0 ? opts.maxIterations : 25,
+                ...(slopGate ? { slopGate } : {}),
+                runTurn: async (prompt) => {
+                    turns++;
+                    const r = await runSingleTurn({
+                        agentId,
+                        provider,
+                        modelId,
+                        message: prompt,
+                        sessionKey,
+                        workspaceDir: opts.workspace,
+                        thinkingLevel: opts.thinkingLevel ?? "off",
+                        signal: abortController.signal,
+                    });
+                    process.stdout.write(`\n[turn ${turns}] ${r.reply}\n`);
+                    return r.reply;
+                },
+            });
+            console.error(`[brigade] autonomous run ${auto.done ? "✓ completed" : "stopped"} — ` +
+                `reason=${auto.stopReason}, turns=${auto.outputs.length}` +
+                (auto.slopRepairs > 0 ? `, slop-rewrites=${auto.slopRepairs}` : "") +
+                (auto.completionVetoes > 0 ? `, slop-gate-vetoes=${auto.completionVetoes}` : ""));
+        }
+        finally {
+            process.off("SIGINT", onSigint);
+            process.off("SIGTERM", onSigint);
+        }
+        return;
+    }
+    let result;
+    try {
+        // No try/catch around runSingleTurn for the *non-abort* path — runtime
+        // errors propagate to run-main's mapErrorToExitCode, which prefixes
+        // with `brigade:` and returns the right exit code for entry.ts to
+        // surface. The try/finally exists only to clean up the signal
+        // listeners regardless of outcome.
+        //
+        // NOTE: this headless CLI turn deliberately does NOT schedule background
+        // memory extraction/decay/consolidation — that debounced sweep is owned by
+        // the long-lived gateway (see core/server.ts runExtractionNow), since a
+        // one-shot CLI process exits before any 45s debounce could fire. Auto-recall
+        // still injects facts here (it's synchronous), and `brigade chat` routes
+        // through the gateway, so interactive use is fully covered.
+        result = await runSingleTurn({
+            agentId,
+            provider,
+            modelId,
+            message: messageForAgent,
+            sessionKey,
+            workspaceDir: opts.workspace,
+            thinkingLevel: thinkingOverride ?? opts.thinkingLevel ?? "off",
+            signal: abortController.signal,
+        });
+    }
+    finally {
+        process.off("SIGINT", onSigint);
+        process.off("SIGTERM", onSigint);
+    }
+    if (result.isNewSession) {
+        console.error(`[brigade] new session: ${result.sessionId}`);
+    }
+    else {
+        console.error(`[brigade] continuing session: ${result.sessionId}`);
+    }
+    // Reply goes to stdout so it composes cleanly with shell pipes;
+    // diagnostics go to stderr above.
+    process.stdout.write(result.reply);
+    if (!result.reply.endsWith("\n"))
+        process.stdout.write("\n");
+}
+// Persist the session's model override to sessions.json so the NEXT
+// `brigade agent` invocation against this session uses the new model
+// without the user having to repeat `/model X` or pass --model.
+function persistSessionModel(args) {
+    const store = readSessionStore(args.agentId);
+    const entry = store.sessions[args.sessionKey];
+    if (!entry) {
+        // No session yet (first turn) — the model override will land in the
+        // entry that resolveOrCreateSession creates on this turn. Nothing to
+        // persist here ahead of time. The active turn already uses the
+        // override via the runSingleTurn call.
+        return;
+    }
+    entry.provider = args.provider;
+    entry.modelId = args.modelId;
+    entry.lastUsedAt = new Date().toISOString();
+    writeSessionStore(args.agentId, store);
+}
+// Forget the session entirely. Next `brigade agent` against the same
+// sessionKey will create a fresh session id + a fresh transcript file.
+// We deliberately don't delete the old JSONL — operators can recover it
+// from the transcripts dir if they want; we just stop pointing at it.
+function resetSession(args) {
+    const store = readSessionStore(args.agentId);
+    if (store.sessions[args.sessionKey]) {
+        delete store.sessions[args.sessionKey];
+        writeSessionStore(args.agentId, store);
+    }
+}
+// Source files the code Slop-Index scores (Step 33). Non-code edits (docs,
+// config) are not graded — the gate is about code quality.
+const CODE_FILE = /\.(ts|tsx|js|jsx|mjs|cjs|py|go|rs|java|rb|c|cc|cpp|h|hpp|cs|swift|kt)$/i;
+function gitOutput(cwd, args) {
+    try {
+        return execFileSync("git", ["-C", cwd, ...args], { encoding: "utf8", maxBuffer: 8 * 1024 * 1024 });
+    }
+    catch {
+        return undefined;
+    }
+}
+// Working-tree-dirty paths (relative to the repo root), NUL-separated so paths
+// with spaces are safe. Empty when not a git repo / git missing.
+function gitDirtyPaths(repoRoot) {
+    const out = gitOutput(repoRoot, ["status", "--porcelain", "-z"]);
+    if (out === undefined)
+        return [];
+    return out
+        .split("\0")
+        .map((entry) => entry.slice(3)) // strip the 2-char XY status + space
+        .filter((p) => p.length > 0);
+}
+/**
+ * Build the code Slop-Index completion gate for the LIVE autonomous run. Snapshots
+ * the already-dirty files at run start, then scores only the code files the agent
+ * NEWLY changed — so pre-existing uncommitted work isn't blamed for the agent's
+ * slop. Returns undefined (no gate) when the cwd isn't a git repo or git is absent,
+ * so the gate can never wrongly block a non-git or non-code run.
+ */
+function buildSlopGate(cwd) {
+    const root = gitOutput(cwd, ["rev-parse", "--show-toplevel"])?.trim();
+    if (!root)
+        return undefined;
+    const baseline = new Set(gitDirtyPaths(root));
+    return {
+        getChangedFiles: () => {
+            const fresh = gitDirtyPaths(root).filter((p) => !baseline.has(p) && CODE_FILE.test(p));
+            const files = [];
+            for (const rel of fresh) {
+                try {
+                    files.push({ path: rel, content: fs.readFileSync(path.join(root, rel), "utf8") });
+                }
+                catch {
+                    /* deleted / unreadable since the diff — skip */
+                }
+            }
+            return files;
+        },
+    };
+}
+//# sourceMappingURL=agent.js.map

package/dist/cli/commands/agent.js.map

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

package/dist/cli/commands/agents-bindings.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Routing-binding helpers for `brigade agents bind / unbind / bindings`.
+ * Brand-scrubbed analogue of the reference codebase's
+ * `src/commands/agents.bindings.ts`, adapted to Brigade's
+ * `cfg.bindings.entries[]` wrapper (vs. the reference's flat `cfg.bindings`).
+ *
+ * v1 lift: `parseBindingSpecs` validates channel ids against a caller-
+ * supplied catalog (Brigade's channel-plugin manager passes
+ * `BUNDLED_MODULES → registry.channels` in). The reference codebase's
+ * per-plugin `resolveBindingAccountId` hook does not exist on Brigade's
+ * adapters yet — when an account id is not supplied explicitly the binding
+ * is recorded without one (treated as any-account by the route resolver).
+ */
+import type { BindingEntry, BrigadeConfig } from "../../config/io.js";
+/**
+ * Brigade's already-existing `BindingEntry` carries the same `match` shape
+ * the reference codebase calls `AgentRouteBinding`. Re-exported under the
+ * alias the spec asks for so downstream call sites can pick whichever name
+ * reads best.
+ */
+export type AgentRouteBinding = BindingEntry;
+/** Read all configured route bindings (`cfg.bindings.entries[]`). */
+export declare function listRouteBindings(cfg: BrigadeConfig | undefined | null): AgentRouteBinding[];
+/** Human-readable single-line description of one binding. */
+export declare function describeBinding(binding: AgentRouteBinding): string;
+/** Minimal channel-catalog entry consumed by parseBindingSpecs. */
+export interface BindingChannelDescriptor {
+    id: string;
+}
+/**
+ * Parse CLI binding specs (e.g. `"whatsapp"` or `"whatsapp:account-1"`)
+ * into BindingEntry records. Channel ids are validated against the supplied
+ * catalog — pass `undefined` to skip validation (useful for tests).
+ */
+export declare function parseBindingSpecs(params: {
+    agentId: string;
+    specs?: string[];
+    config: BrigadeConfig;
+    channels?: BindingChannelDescriptor[];
+}): {
+    bindings: AgentRouteBinding[];
+    errors: string[];
+};
+/**
+ * Upsert bindings into `cfg.bindings.entries[]`. Returns a NEW config plus
+ * categorised buckets so callers can render the result clearly.
+ *
+ *  - `skipped`   : key already present, same agent — no-op.
+ *  - `conflicts` : key already present, different agent — caller decides
+ *                  whether to error or override.
+ *  - `updated`   : same agent + same identity-key but the existing record
+ *                  had no accountId and the incoming does — in-place upgrade.
+ *  - `added`     : net-new binding.
+ */
+export declare function applyAgentBindings(cfg: BrigadeConfig, bindings: AgentRouteBinding[]): {
+    config: BrigadeConfig;
+    added: AgentRouteBinding[];
+    updated: AgentRouteBinding[];
+    skipped: AgentRouteBinding[];
+    conflicts: Array<{
+        binding: AgentRouteBinding;
+        existingAgentId: string;
+    }>;
+};
+/**
+ * Remove bindings from `cfg.bindings.entries[]`. Mirrors `applyAgentBindings`
+ * with inverse buckets: `removed` (key matched + agent matched), `missing`
+ * (no record with that key at all), `conflicts` (key matched but a different
+ * agent owns it — caller decides whether to error).
+ */
+export declare function removeAgentBindings(cfg: BrigadeConfig, bindings: AgentRouteBinding[]): {
+    config: BrigadeConfig;
+    removed: AgentRouteBinding[];
+    missing: AgentRouteBinding[];
+    conflicts: Array<{
+        binding: AgentRouteBinding;
+        existingAgentId: string;
+    }>;
+};
+//# sourceMappingURL=agents-bindings.d.ts.map

package/dist/cli/commands/agents-bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-bindings.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/agents-bindings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAItE;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,YAAY,CAAC;AA6C7C,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,SAAS,GAAG,IAAI,GAAG,iBAAiB,EAAE,CAE5F;AAED,6DAA6D;AAC7D,wBAAgB,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAYlE;AAED,mEAAmE;AACnE,MAAM,WAAW,wBAAwB;IACxC,EAAE,EAAE,MAAM,CAAC;CACX;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,CAAC,EAAE,wBAAwB,EAAE,CAAC;CACtC,GAAG;IAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAmCtD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CACjC,GAAG,EAAE,aAAa,EAClB,QAAQ,EAAE,iBAAiB,EAAE,GAC3B;IACF,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,SAAS,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,iBAAiB,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1E,CAyEA;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,aAAa,EAClB,QAAQ,EAAE,iBAAiB,EAAE,GAC3B;IACF,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,SAAS,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,iBAAiB,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1E,CAqDA"}

package/dist/cli/commands/agents-bindings.js

@@ -0,0 +1,252 @@
+/**
+ * Routing-binding helpers for `brigade agents bind / unbind / bindings`.
+ * Brand-scrubbed analogue of the reference codebase's
+ * `src/commands/agents.bindings.ts`, adapted to Brigade's
+ * `cfg.bindings.entries[]` wrapper (vs. the reference's flat `cfg.bindings`).
+ *
+ * v1 lift: `parseBindingSpecs` validates channel ids against a caller-
+ * supplied catalog (Brigade's channel-plugin manager passes
+ * `BUNDLED_MODULES → registry.channels` in). The reference codebase's
+ * per-plugin `resolveBindingAccountId` hook does not exist on Brigade's
+ * adapters yet — when an account id is not supplied explicitly the binding
+ * is recorded without one (treated as any-account by the route resolver).
+ */
+import { listBindings } from "../../agents/routing/bindings.js";
+import { normalizeAgentId } from "../../agents/routing/session-key.js";
+/* ───────────────────────── match-key helpers (private) ───────────────────── */
+const DEFAULT_ACCOUNT_ID = "default";
+function trimOrEmpty(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+function bindingMatchIdentityKey(match) {
+    const roles = Array.isArray(match?.roles)
+        ? Array.from(new Set(match.roles.filter((r) => typeof r === "string").sort()))
+        : [];
+    return JSON.stringify([
+        match?.channel ?? "",
+        match?.peer?.kind ?? "",
+        match?.peer?.id ?? "",
+        match?.guildId ?? "",
+        match?.teamId ?? "",
+        roles.join(","),
+    ]);
+}
+function bindingMatchKey(match) {
+    const accountId = trimOrEmpty(match?.accountId) || DEFAULT_ACCOUNT_ID;
+    return JSON.stringify([bindingMatchIdentityKey(match), accountId]);
+}
+function canUpgradeBindingAccountScope(params) {
+    if (!trimOrEmpty(params.incoming.match?.accountId))
+        return false;
+    if (trimOrEmpty(params.existing.match?.accountId))
+        return false;
+    if (normalizeAgentId(params.existing.agentId) !== params.normalizedIncomingAgentId)
+        return false;
+    return (bindingMatchIdentityKey(params.existing.match) ===
+        bindingMatchIdentityKey(params.incoming.match));
+}
+/* ───────────────────────── public helpers ───────────────────────── */
+/** Read all configured route bindings (`cfg.bindings.entries[]`). */
+export function listRouteBindings(cfg) {
+    return listBindings(cfg);
+}
+/** Human-readable single-line description of one binding. */
+export function describeBinding(binding) {
+    const match = binding.match ?? {};
+    const parts = [];
+    parts.push(match.channel ?? "(no-channel)");
+    if (match.accountId)
+        parts.push(`accountId=${match.accountId}`);
+    if (match.peer)
+        parts.push(`peer=${match.peer.kind ?? ""}:${match.peer.id ?? ""}`);
+    if (match.guildId)
+        parts.push(`guild=${match.guildId}`);
+    if (match.teamId)
+        parts.push(`team=${match.teamId}`);
+    if (Array.isArray(match.roles) && match.roles.length > 0) {
+        parts.push(`roles=${match.roles.join(",")}`);
+    }
+    return parts.join(" ");
+}
+/**
+ * Parse CLI binding specs (e.g. `"whatsapp"` or `"whatsapp:account-1"`)
+ * into BindingEntry records. Channel ids are validated against the supplied
+ * catalog — pass `undefined` to skip validation (useful for tests).
+ */
+export function parseBindingSpecs(params) {
+    const bindings = [];
+    const errors = [];
+    const specs = params.specs ?? [];
+    const agentId = normalizeAgentId(params.agentId);
+    const knownIds = params.channels?.map((c) => c.id.trim().toLowerCase()) ?? null;
+    for (const raw of specs) {
+        const trimmed = raw?.trim();
+        if (!trimmed)
+            continue;
+        const [channelRaw, ...rest] = trimmed.split(":");
+        const accountRaw = rest.length > 0 ? rest.join(":") : undefined;
+        const channel = channelRaw?.trim().toLowerCase() ?? "";
+        if (!channel) {
+            errors.push(`Invalid binding "${trimmed}" (empty channel).`);
+            continue;
+        }
+        if (knownIds && !knownIds.includes(channel)) {
+            errors.push(`Unknown channel "${channelRaw}".`);
+            continue;
+        }
+        let accountId;
+        if (accountRaw !== undefined) {
+            const tr = accountRaw.trim();
+            if (!tr) {
+                errors.push(`Invalid binding "${trimmed}" (empty account id).`);
+                continue;
+            }
+            accountId = tr;
+        }
+        const match = { channel };
+        if (accountId)
+            match.accountId = accountId;
+        bindings.push({ agentId, match });
+    }
+    return { bindings, errors };
+}
+/**
+ * Upsert bindings into `cfg.bindings.entries[]`. Returns a NEW config plus
+ * categorised buckets so callers can render the result clearly.
+ *
+ *  - `skipped`   : key already present, same agent — no-op.
+ *  - `conflicts` : key already present, different agent — caller decides
+ *                  whether to error or override.
+ *  - `updated`   : same agent + same identity-key but the existing record
+ *                  had no accountId and the incoming does — in-place upgrade.
+ *  - `added`     : net-new binding.
+ */
+export function applyAgentBindings(cfg, bindings) {
+    const existing = [...listRouteBindings(cfg)];
+    const matchMap = new Map();
+    for (const b of existing) {
+        const key = bindingMatchKey(b.match);
+        if (!matchMap.has(key))
+            matchMap.set(key, normalizeAgentId(b.agentId));
+    }
+    const added = [];
+    const updated = [];
+    const skipped = [];
+    const conflicts = [];
+    for (const binding of bindings) {
+        const agentId = normalizeAgentId(binding.agentId);
+        const key = bindingMatchKey(binding.match);
+        const existingAgentId = matchMap.get(key);
+        if (existingAgentId) {
+            if (existingAgentId === agentId) {
+                skipped.push(binding);
+            }
+            else {
+                conflicts.push({ binding, existingAgentId });
+            }
+            continue;
+        }
+        const upgradeIndex = existing.findIndex((candidate) => canUpgradeBindingAccountScope({
+            existing: candidate,
+            incoming: binding,
+            normalizedIncomingAgentId: agentId,
+        }));
+        if (upgradeIndex >= 0) {
+            const current = existing[upgradeIndex];
+            if (!current)
+                continue;
+            const previousKey = bindingMatchKey(current.match);
+            const upgraded = {
+                ...current,
+                agentId,
+                match: {
+                    ...(current.match ?? {}),
+                    accountId: binding.match?.accountId?.trim(),
+                },
+            };
+            existing[upgradeIndex] = upgraded;
+            matchMap.delete(previousKey);
+            matchMap.set(bindingMatchKey(upgraded.match), agentId);
+            updated.push(upgraded);
+            continue;
+        }
+        matchMap.set(key, agentId);
+        const newBinding = { ...binding, agentId };
+        added.push(newBinding);
+    }
+    if (added.length === 0 && updated.length === 0) {
+        return { config: cfg, added, updated, skipped, conflicts };
+    }
+    const nextEntries = [...existing.filter((e) => !updated.includes(e)), ...updated, ...added];
+    return {
+        config: {
+            ...cfg,
+            bindings: { entries: nextEntries },
+        },
+        added,
+        updated,
+        skipped,
+        conflicts,
+    };
+}
+/**
+ * Remove bindings from `cfg.bindings.entries[]`. Mirrors `applyAgentBindings`
+ * with inverse buckets: `removed` (key matched + agent matched), `missing`
+ * (no record with that key at all), `conflicts` (key matched but a different
+ * agent owns it — caller decides whether to error).
+ */
+export function removeAgentBindings(cfg, bindings) {
+    const existing = listRouteBindings(cfg);
+    const removeIndexes = new Set();
+    const removed = [];
+    const missing = [];
+    const conflicts = [];
+    for (const binding of bindings) {
+        const desired = normalizeAgentId(binding.agentId);
+        const key = bindingMatchKey(binding.match);
+        let matchedIndex = -1;
+        let conflicting = null;
+        for (let i = 0; i < existing.length; i += 1) {
+            if (removeIndexes.has(i))
+                continue;
+            const current = existing[i];
+            if (!current)
+                continue;
+            if (bindingMatchKey(current.match) !== key)
+                continue;
+            const currentAgentId = normalizeAgentId(current.agentId);
+            if (currentAgentId === desired) {
+                matchedIndex = i;
+                break;
+            }
+            conflicting = currentAgentId;
+        }
+        if (matchedIndex >= 0) {
+            const matched = existing[matchedIndex];
+            if (matched) {
+                removeIndexes.add(matchedIndex);
+                removed.push(matched);
+            }
+            continue;
+        }
+        if (conflicting) {
+            conflicts.push({ binding, existingAgentId: conflicting });
+            continue;
+        }
+        missing.push(binding);
+    }
+    if (removeIndexes.size === 0) {
+        return { config: cfg, removed, missing, conflicts };
+    }
+    const nextEntries = existing.filter((_, i) => !removeIndexes.has(i));
+    return {
+        config: {
+            ...cfg,
+            bindings: { entries: nextEntries },
+        },
+        removed,
+        missing,
+        conflicts,
+    };
+}
+//# sourceMappingURL=agents-bindings.js.map