@spinabot/brigade 0.1.2 → 1.0.1

package/dist/cli/commands/org-cmd.templates.js

@@ -0,0 +1,145 @@
+/**
+ * Brigade `brigade org init` starter templates (Stage C).
+ *
+ * Each template returns a JSON snippet of the cfg fragments the
+ * `brigade org init` command writes into `brigade.json`:
+ *
+ *   {
+ *     org: BrigadeOrgConfig,
+ *     agents: Record<string, { org: AgentOrgBlock }>,
+ *   }
+ *
+ * The four templates are:
+ *
+ *   - `solo`     : single agent "main" as Chief of Staff (Office dept).
+ *                  Mirrors the auto-derive output but materialises it on
+ *                  disk so the operator can edit + extend it.
+ *   - `family`   : three flat peers — main + helper + scheduler — in the
+ *                  "household" department. No manager chain.
+ *   - `company`  : multi-department small company shape — exec / eng /
+ *                  ops, four agents. Demonstrates the manager chain.
+ *   - `custom`   : empty scaffold — `topOrder: "main"` + mode "derived"
+ *                  with no agents. The operator fills it in from the
+ *                  editor.
+ *
+ * STAGE-C CONTRACT
+ * ----------------
+ *   - Templates are STATIC fixtures. No runtime branching, no env
+ *     reads, no filesystem access. The command layer (org-cmd.ts) is
+ *     the only consumer; tests pin the shape directly.
+ *   - Templates target the field shapes declared in
+ *     `src/config/io.ts` (`BrigadeOrgConfig` + `AgentConfig.org`); the
+ *     command merges them into the existing config so they do NOT
+ *     replace fields the operator has already set.
+ *
+ * No external agent-codebase
+ * identifiers are referenced from this file.
+ */
+const SOLO_TEMPLATE = {
+    id: "solo",
+    summary: "Single agent (Chief of Staff) in the office department — materialises the auto-derive output on disk.",
+    org: {
+        topOrder: "main",
+        a2a: { mode: "derived" },
+    },
+    agents: {
+        main: {
+            department: "office",
+            reportsTo: null,
+            role: "Chief of Staff",
+        },
+    },
+};
+const FAMILY_TEMPLATE = {
+    id: "family",
+    summary: "Three flat peers in the household department (main + helper + scheduler). No manager chain.",
+    org: {
+        topOrder: "main",
+        a2a: { mode: "derived" },
+    },
+    agents: {
+        main: {
+            department: "household",
+            reportsTo: null,
+            role: "Coordinator",
+        },
+        helper: {
+            department: "household",
+            reportsTo: null,
+            role: "Helper",
+        },
+        scheduler: {
+            department: "household",
+            reportsTo: null,
+            role: "Scheduler",
+        },
+    },
+};
+const COMPANY_TEMPLATE = {
+    id: "company",
+    summary: "Small company: exec + engineering + ops departments, four agents, demonstrates the manager chain.",
+    org: {
+        topOrder: "main",
+        a2a: { mode: "derived" },
+        departmentHeads: {
+            engineering: "eng_lead",
+            ops: "ops_lead",
+        },
+    },
+    agents: {
+        main: {
+            department: "exec",
+            reportsTo: null,
+            role: "Chief of Staff",
+        },
+        eng_lead: {
+            department: "engineering",
+            reportsTo: "main",
+            role: "Engineering Lead",
+        },
+        eng_ic: {
+            department: "engineering",
+            reportsTo: "eng_lead",
+            role: "Engineer",
+        },
+        ops_lead: {
+            department: "ops",
+            reportsTo: "main",
+            role: "Operations Lead",
+        },
+    },
+};
+const CUSTOM_TEMPLATE = {
+    id: "custom",
+    summary: "Empty scaffold: `topOrder: \"main\"` + mode `derived` with no agents. Fill in from $EDITOR.",
+    org: {
+        topOrder: "main",
+        a2a: { mode: "derived" },
+    },
+    agents: {},
+};
+const TEMPLATE_INDEX = {
+    solo: SOLO_TEMPLATE,
+    family: FAMILY_TEMPLATE,
+    company: COMPANY_TEMPLATE,
+    custom: CUSTOM_TEMPLATE,
+};
+/**
+ * Look up a template by id. Returns `undefined` for an unknown id so
+ * the CLI layer can print a helpful list-of-valid-options error.
+ */
+export function getOrgTemplate(id) {
+    if (id !== "solo" && id !== "family" && id !== "company" && id !== "custom") {
+        return undefined;
+    }
+    return TEMPLATE_INDEX[id];
+}
+/** All template ids in stable order. */
+export function listOrgTemplateIds() {
+    return ["solo", "family", "company", "custom"];
+}
+/** Convenience iterator for help-text rendering. */
+export function listOrgTemplates() {
+    return listOrgTemplateIds().map((id) => TEMPLATE_INDEX[id]);
+}
+//# sourceMappingURL=org-cmd.templates.js.map

package/dist/cli/commands/org-cmd.templates.js.map

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

package/dist/cli/commands/org-slash.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Pure helpers for the `/org` slash command — shared by:
+ *
+ *   - the TUI surface (`connect.ts`)
+ *   - the channel surface (`agent-switch-command.ts` → `/org` ChannelCommand)
+ *
+ * Both call into the SAME parse + filter + render functions so the chart
+ * shape can never drift between surfaces. The gateway `org.snapshot` RPC
+ * already pre-renders `charts.tui / channel / ascii` for the unfiltered
+ * happy path; when an operator asks for a SUB-CHART (`/org <agent-id>`,
+ * `/org --departments`, `/org --explain <from> <to>`) we re-render
+ * client-side against the same Pride template using the `graph` field
+ * returned in the snapshot.
+ *
+ * NO external agent-codebase identifiers.
+ */
+import type { OrgGraph } from "../../agents/org/types.js";
+import { BRIGADE_FOOTER_RULE, BRIGADE_TAUNT, PRIDE_CHART_FLAT_CREW_NOTE, flattenToThreeTiersWithPins, type RenderPrideChartOptions } from "../../agents/org/pride-template.js";
+/** Discriminated union of `/org` invocation shapes. */
+export type ParsedOrgCommand = {
+    kind: "show";
+} | {
+    kind: "departments";
+} | {
+    kind: "subtree";
+    agentId: string;
+} | {
+    kind: "explain";
+    from: string;
+    to: string;
+} | {
+    kind: "error";
+    message: string;
+};
+/**
+ * Parse the args portion of `/org <...>` (everything AFTER the literal
+ * `/org` word). Trims, splits, and matches a small grammar.
+ *
+ *   /org                               → { kind: "show" }
+ *   /org --departments                 → { kind: "departments" }
+ *   /org --explain <from> <to>         → { kind: "explain", from, to }
+ *   /org <agent-id>                    → { kind: "subtree", agentId }
+ *
+ * Any other shape returns `{ kind: "error", message }` so the caller can
+ * print a usage hint.
+ */
+export declare function parseOrgSlash(rawArgs: string): ParsedOrgCommand;
+/**
+ * Filter an OrgGraph to a subtree rooted at `agentId`:
+ *
+ *   - Keep `topOrder` (so the chart still anchors at Higher Office).
+ *   - Keep `agentId` and every transitive descendant (via `reportsTo` —
+ *     a member B is a descendant of A iff walking B's `reportsTo` chain
+ *     reaches A).
+ *   - Recompute the `departments` inverse index so unreferenced
+ *     department slugs vanish.
+ *
+ * Returns the filtered graph. When `agentId` is unknown, the result is
+ * `undefined` so the caller can print a friendly error.
+ */
+export declare function filterGraphToSubtree(graph: OrgGraph, agentId: string): OrgGraph | undefined;
+/**
+ * Render the Pride chart with Higher Office section omitted. Uses the
+ * same template engine so headers, footers, and the Brigade taunt all
+ * remain consistent — we just strip the Higher Office block from the
+ * output.
+ *
+ * Implementation note: rather than fork the template, we run the full
+ * render and surgically excise the Higher Office block by line markers.
+ * The template's section header is the literal string `Higher Office`
+ * preceded by the section bar; we drop from that line through (and
+ * including) the trailing blank line before the next section bar.
+ */
+export declare function renderDepartmentsOnly(graph: OrgGraph, pins: Record<string, string> | undefined, opts?: RenderPrideChartOptions): string;
+/** Result of `formatExplain` — pure data so callers can render to fit. */
+export interface ExplainOutcome {
+    from: string;
+    to: string;
+    status: "allowed" | "denied" | "no-org" | "unknown-member";
+    /** Edge-by-edge reasons when allowed. */
+    chain?: {
+        reason: string;
+        note?: string;
+    }[];
+    /** Denial reason when denied. */
+    reason?: string;
+    /** Identifier of the unknown member when status === "unknown-member". */
+    unknown?: string;
+}
+/**
+ * Compute the explain outcome for a directed `from → to` edge against
+ * the supplied OrgGraph. Mirrors `org_explain` tool semantics so the
+ * TUI / channel surfaces match what an agent would see when calling
+ * `org({action:"explain", from, to})`.
+ */
+export declare function computeExplain(graph: OrgGraph, from: string, to: string): ExplainOutcome;
+/**
+ * Format an ExplainOutcome as a plain-text block for printing in either
+ * the TUI or a channel reply. The output is intentionally compact (one
+ * line per fact) and ASCII-only so channel renderers don't mangle it.
+ */
+export declare function formatExplain(outcome: ExplainOutcome): string;
+/** Re-export so consumers can import the redirect from one place. */
+export { PRIDE_CHART_FLAT_CREW_NOTE, BRIGADE_TAUNT, BRIGADE_FOOTER_RULE };
+/** Re-export the pin-aware flatten for callers that need raw structure. */
+export { flattenToThreeTiersWithPins };
+//# sourceMappingURL=org-slash.d.ts.map

package/dist/cli/commands/org-slash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"org-slash.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/org-slash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,0BAA0B,EAC1B,2BAA2B,EAE3B,KAAK,uBAAuB,EAC7B,MAAM,oCAAoC,CAAC;AAI5C,uDAAuD;AACvD,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAqD/D;AAID;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,GACd,QAAQ,GAAG,SAAS,CAiDtB;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,QAAQ,EACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACxC,IAAI,GAAE,uBAA4B,GACjC,MAAM,CAqCR;AAID,0EAA0E;AAC1E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,gBAAgB,CAAC;IAC3D,yCAAyC;IACzC,KAAK,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5C,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,QAAQ,EACf,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,cAAc,CA8BhB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CA2B7D;AAID,qEAAqE;AACrE,OAAO,EAAE,0BAA0B,EAAE,aAAa,EAAE,mBAAmB,EAAE,CAAC;AAE1E,2EAA2E;AAC3E,OAAO,EAAE,2BAA2B,EAAE,CAAC"}

package/dist/cli/commands/org-slash.js

@@ -0,0 +1,263 @@
+/**
+ * Pure helpers for the `/org` slash command — shared by:
+ *
+ *   - the TUI surface (`connect.ts`)
+ *   - the channel surface (`agent-switch-command.ts` → `/org` ChannelCommand)
+ *
+ * Both call into the SAME parse + filter + render functions so the chart
+ * shape can never drift between surfaces. The gateway `org.snapshot` RPC
+ * already pre-renders `charts.tui / channel / ascii` for the unfiltered
+ * happy path; when an operator asks for a SUB-CHART (`/org <agent-id>`,
+ * `/org --departments`, `/org --explain <from> <to>`) we re-render
+ * client-side against the same Pride template using the `graph` field
+ * returned in the snapshot.
+ *
+ * NO external agent-codebase identifiers.
+ */
+import { BRIGADE_FOOTER_RULE, BRIGADE_TAUNT, PRIDE_CHART_FLAT_CREW_NOTE, flattenToThreeTiersWithPins, renderPrideChartWithPins, } from "../../agents/org/pride-template.js";
+/**
+ * Parse the args portion of `/org <...>` (everything AFTER the literal
+ * `/org` word). Trims, splits, and matches a small grammar.
+ *
+ *   /org                               → { kind: "show" }
+ *   /org --departments                 → { kind: "departments" }
+ *   /org --explain <from> <to>         → { kind: "explain", from, to }
+ *   /org <agent-id>                    → { kind: "subtree", agentId }
+ *
+ * Any other shape returns `{ kind: "error", message }` so the caller can
+ * print a usage hint.
+ */
+export function parseOrgSlash(rawArgs) {
+    const trimmed = (rawArgs ?? "").trim();
+    if (trimmed.length === 0)
+        return { kind: "show" };
+    const tokens = trimmed.split(/\s+/).filter(Boolean);
+    if (tokens.length === 0)
+        return { kind: "show" };
+    const first = tokens[0] ?? "";
+    if (first === "--departments" || first === "-d") {
+        if (tokens.length !== 1) {
+            return {
+                kind: "error",
+                message: "Usage: /org --departments",
+            };
+        }
+        return { kind: "departments" };
+    }
+    if (first === "--explain" || first === "-e") {
+        if (tokens.length !== 3) {
+            return {
+                kind: "error",
+                message: "Usage: /org --explain <from> <to>",
+            };
+        }
+        const from = (tokens[1] ?? "").trim();
+        const to = (tokens[2] ?? "").trim();
+        if (!from || !to) {
+            return {
+                kind: "error",
+                message: "Usage: /org --explain <from> <to>",
+            };
+        }
+        return { kind: "explain", from, to };
+    }
+    if (first.startsWith("-")) {
+        return {
+            kind: "error",
+            message: "Usage: /org [<agent-id>] | /org --departments | /org --explain <from> <to>",
+        };
+    }
+    if (tokens.length !== 1) {
+        return {
+            kind: "error",
+            message: "Usage: /org [<agent-id>] | /org --departments | /org --explain <from> <to>",
+        };
+    }
+    return { kind: "subtree", agentId: first };
+}
+/* ─── Subtree filter ─────────────────────────────────────────────────── */
+/**
+ * Filter an OrgGraph to a subtree rooted at `agentId`:
+ *
+ *   - Keep `topOrder` (so the chart still anchors at Higher Office).
+ *   - Keep `agentId` and every transitive descendant (via `reportsTo` —
+ *     a member B is a descendant of A iff walking B's `reportsTo` chain
+ *     reaches A).
+ *   - Recompute the `departments` inverse index so unreferenced
+ *     department slugs vanish.
+ *
+ * Returns the filtered graph. When `agentId` is unknown, the result is
+ * `undefined` so the caller can print a friendly error.
+ */
+export function filterGraphToSubtree(graph, agentId) {
+    if (!graph.members[agentId])
+        return undefined;
+    const keep = new Set([graph.topOrder, agentId]);
+    // For every member, walk its reportsTo chain. If we reach `agentId`,
+    // the member is a descendant.
+    for (const id of Object.keys(graph.members)) {
+        if (keep.has(id))
+            continue;
+        let cursor = id;
+        const seen = new Set();
+        let steps = 0;
+        while (cursor && !seen.has(cursor) && steps < 1024) {
+            seen.add(cursor);
+            const m = graph.members[cursor];
+            if (!m)
+                break;
+            if (cursor === agentId) {
+                // The member walked up to agentId — it's a descendant.
+                keep.add(id);
+                break;
+            }
+            cursor = m.reportsTo;
+            steps += 1;
+        }
+    }
+    const members = {};
+    for (const id of keep) {
+        const m = graph.members[id];
+        if (m)
+            members[id] = m;
+    }
+    const departments = {};
+    for (const [id, m] of Object.entries(members)) {
+        const bucket = departments[m.department] ?? [];
+        bucket.push(id);
+        departments[m.department] = bucket;
+    }
+    for (const key of Object.keys(departments)) {
+        const b = departments[key];
+        if (b)
+            b.sort();
+    }
+    return {
+        topOrder: graph.topOrder,
+        members,
+        departments,
+        edges: graph.edges.filter((e) => keep.has(e.from) && keep.has(e.to)),
+        mode: graph.mode,
+    };
+}
+/* ─── Departments-only render ───────────────────────────────────────── */
+/**
+ * Render the Pride chart with Higher Office section omitted. Uses the
+ * same template engine so headers, footers, and the Brigade taunt all
+ * remain consistent — we just strip the Higher Office block from the
+ * output.
+ *
+ * Implementation note: rather than fork the template, we run the full
+ * render and surgically excise the Higher Office block by line markers.
+ * The template's section header is the literal string `Higher Office`
+ * preceded by the section bar; we drop from that line through (and
+ * including) the trailing blank line before the next section bar.
+ */
+export function renderDepartmentsOnly(graph, pins, opts = {}) {
+    const full = renderPrideChartWithPins(graph, pins, opts);
+    // Match a contiguous "Higher Office" section: from the line containing
+    // "Higher Office" until the next blank line that precedes a non-blank
+    // line. Drop the matched block entirely.
+    const lines = full.split("\n");
+    const out = [];
+    let i = 0;
+    // Anchor to the section-bar glyph `▌` so we don't accidentally strip
+    // footer rules / taunts / stories that mention "Higher Office"
+    // verbatim (the bank has a few such entries).
+    const HEADING_RE = /^\s*▌\s*Higher Office\b/;
+    while (i < lines.length) {
+        const line = lines[i] ?? "";
+        // Strip ANSI before matching so the test runs with both colour modes.
+        const stripped = line.replace(/\[[0-9;]*m/g, "");
+        if (HEADING_RE.test(stripped)) {
+            // Skip lines until we hit a blank then a non-blank section bar/heading.
+            i += 1;
+            // Eat the topOrder member line(s) + optional bio + trailing blank.
+            while (i < lines.length) {
+                const peek = lines[i] ?? "";
+                const peekStripped = peek.replace(/\[[0-9;]*m/g, "");
+                if (peekStripped.trim() === "") {
+                    // Consume the blank line and stop — next iteration resumes at
+                    // the next section.
+                    i += 1;
+                    break;
+                }
+                i += 1;
+            }
+            continue;
+        }
+        out.push(line);
+        i += 1;
+    }
+    return out.join("\n");
+}
+/**
+ * Compute the explain outcome for a directed `from → to` edge against
+ * the supplied OrgGraph. Mirrors `org_explain` tool semantics so the
+ * TUI / channel surfaces match what an agent would see when calling
+ * `org({action:"explain", from, to})`.
+ */
+export function computeExplain(graph, from, to) {
+    const f = graph.members[from];
+    const t = graph.members[to];
+    if (!f) {
+        return { from, to, status: "unknown-member", unknown: from };
+    }
+    if (!t) {
+        return { from, to, status: "unknown-member", unknown: to };
+    }
+    const edges = graph.edges.filter((e) => e.from === from && e.to === to);
+    if (edges.length > 0) {
+        return {
+            from,
+            to,
+            status: "allowed",
+            chain: edges.map((e) => ({
+                reason: e.reason,
+                ...(e.note ? { note: e.note } : {}),
+            })),
+        };
+    }
+    let denial;
+    if (f.department !== t.department) {
+        denial = `cross-department edge ${JSON.stringify(f.department)} → ${JSON.stringify(t.department)} is closed by rule (v)`;
+    }
+    else {
+        denial = "no direct edge in derived graph";
+    }
+    return { from, to, status: "denied", reason: denial };
+}
+/**
+ * Format an ExplainOutcome as a plain-text block for printing in either
+ * the TUI or a channel reply. The output is intentionally compact (one
+ * line per fact) and ASCII-only so channel renderers don't mangle it.
+ */
+export function formatExplain(outcome) {
+    const lines = [];
+    if (outcome.status === "unknown-member") {
+        lines.push(`${outcome.from} → ${outcome.to}: UNKNOWN`);
+        lines.push(`  ${JSON.stringify(outcome.unknown ?? "")} is not a member of the org`);
+        return lines.join("\n");
+    }
+    if (outcome.status === "no-org") {
+        lines.push("(no cfg.org block — derived A2A is not in effect)");
+        return lines.join("\n");
+    }
+    if (outcome.status === "allowed") {
+        lines.push(`${outcome.from} → ${outcome.to}: ALLOWED`);
+        for (const e of outcome.chain ?? []) {
+            lines.push(`  reason: ${e.reason}${e.note ? ` (${e.note})` : ""}`);
+        }
+        return lines.join("\n");
+    }
+    lines.push(`${outcome.from} → ${outcome.to}: DENIED`);
+    if (outcome.reason)
+        lines.push(`  reason: ${outcome.reason}`);
+    return lines.join("\n");
+}
+/* ─── Constants ──────────────────────────────────────────────────────── */
+/** Re-export so consumers can import the redirect from one place. */
+export { PRIDE_CHART_FLAT_CREW_NOTE, BRIGADE_TAUNT, BRIGADE_FOOTER_RULE };
+/** Re-export the pin-aware flatten for callers that need raw structure. */
+export { flattenToThreeTiersWithPins };
+//# sourceMappingURL=org-slash.js.map

package/dist/cli/commands/org-slash.js.map

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

package/dist/cli/commands/pairing.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `brigade pairing …` — approve/revoke pending pairing codes.
+ *
+ * When `channels.<id>.dmPolicy` is `pairing` (the default), a stranger DMing
+ * the bot gets an 8-char code in the reply and asks the operator to approve
+ * it. The operator runs `brigade pairing approve <CODE>` here, which moves
+ * the sender from "pending" to the channel's allow-from list — subsequent DMs
+ * from that sender reach the agent.
+ *
+ * Channel resolution mirrors `brigade channels …` (auto-pick when only one
+ * channel is available).
+ */
+import type { ChannelAdapter } from "../../agents/extensions/types.js";
+/** @internal — tests only. */
+export declare function __setPairingChannelsForTests(channels: ChannelAdapter[] | undefined): void;
+export declare function runPairingList(args: {
+    channel?: string;
+}, opts?: {
+    json?: boolean;
+}): Promise<number>;
+export declare function runPairingApprove(args: {
+    code: string;
+    channel?: string;
+}, opts?: {
+    json?: boolean;
+}): Promise<number>;
+export declare function runPairingRevoke(args: {
+    code: string;
+    channel?: string;
+}, opts?: {
+    json?: boolean;
+}): Promise<number>;
+//# sourceMappingURL=pairing.d.ts.map

package/dist/cli/commands/pairing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pairing.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/pairing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAavE,8BAA8B;AAC9B,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,SAAS,GAAG,IAAI,CAEzF;AAsDD,wBAAsB,cAAc,CACnC,IAAI,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAC1B,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GAC3B,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAID,wBAAsB,iBAAiB,CACtC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EACxC,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GAC3B,OAAO,CAAC,MAAM,CAAC,CAgCjB;AAID,wBAAsB,gBAAgB,CACrC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EACxC,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GAC3B,OAAO,CAAC,MAAM,CAAC,CAajB"}