@spinabot/brigade 1.13.0 → 1.15.0

package/dist/core/sessions-ops.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Session-transcript hygiene behind the `sessions.cleanup` gateway RPC — the
+ * `brigade sessions cleanup --older-than <duration>` surface, reachable from a
+ * remote client.
+ *
+ * OPERATOR-SCOPED maintenance: deletes an agent's OWN idle transcript files
+ * (`~/.brigade/agents/<id>/sessions/<sid>.jsonl`). It does NOT read or disclose
+ * another agent's session CONTENT (unlike sessions.list/history/send, which are
+ * guarded) — it only removes stale files the gateway regenerates on next
+ * access. So no per-session access guard (allowlisted by name in the
+ * guard-sweep).
+ */
+/** Parse a duration like "30d" / "12h" / "2w" into milliseconds. */
+export declare function parseDuration(s: string): number | null;
+export interface SessionsCleanupResult {
+    ok: boolean;
+    agentId: string;
+    candidates: number;
+    deleted: number;
+    dryRun: boolean;
+    wouldDelete?: string[];
+    reason?: string;
+}
+export declare function handleSessionsCleanup(params: unknown): SessionsCleanupResult;
+//# sourceMappingURL=sessions-ops.d.ts.map

package/dist/core/sessions-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions-ops.d.ts","sourceRoot":"","sources":["../../src/core/sessions-ops.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA6BH,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOtD;AAED,MAAM,WAAW,qBAAqB;IACrC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AACD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,qBAAqB,CA+B5E"}

package/dist/core/sessions-ops.js

@@ -0,0 +1,77 @@
+/**
+ * Session-transcript hygiene behind the `sessions.cleanup` gateway RPC — the
+ * `brigade sessions cleanup --older-than <duration>` surface, reachable from a
+ * remote client.
+ *
+ * OPERATOR-SCOPED maintenance: deletes an agent's OWN idle transcript files
+ * (`~/.brigade/agents/<id>/sessions/<sid>.jsonl`). It does NOT read or disclose
+ * another agent's session CONTENT (unlike sessions.list/history/send, which are
+ * guarded) — it only removes stale files the gateway regenerates on next
+ * access. So no per-session access guard (allowlisted by name in the
+ * guard-sweep).
+ */
+import { existsSync, readdirSync, rmSync, statSync } from "node:fs";
+import path from "node:path";
+import { DEFAULT_AGENT_ID, resolveSessionsDir } from "../config/paths.js";
+function listSessionFiles(agentId) {
+    const dir = resolveSessionsDir(agentId);
+    if (!existsSync(dir))
+        return [];
+    const rows = [];
+    for (const name of readdirSync(dir)) {
+        if (!name.endsWith(".jsonl"))
+            continue;
+        try {
+            const st = statSync(path.join(dir, name));
+            rows.push({ sessionId: name.replace(/\.jsonl$/, ""), bytes: st.size, mtimeMs: st.mtimeMs });
+        }
+        catch {
+            /* ignore unreadable entries */
+        }
+    }
+    return rows;
+}
+/** Parse a duration like "30d" / "12h" / "2w" into milliseconds. */
+export function parseDuration(s) {
+    const m = s.match(/^(\d+)\s*(s|m|h|d|w)$/i);
+    if (!m)
+        return null;
+    const n = Number(m[1]);
+    const u = m[2]?.toLowerCase() ?? "d";
+    const mul = { s: 1_000, m: 60_000, h: 3_600_000, d: 86_400_000, w: 604_800_000 }[u] ?? 0;
+    return n * mul;
+}
+export function handleSessionsCleanup(params) {
+    const p = (params ?? {});
+    const agentId = (p.agentId ?? "").trim() || DEFAULT_AGENT_ID;
+    const dryRun = !!p.dryRun;
+    const ms = parseDuration((p.olderThan ?? "").trim());
+    if (ms == null) {
+        return {
+            ok: false,
+            agentId,
+            candidates: 0,
+            deleted: 0,
+            dryRun,
+            reason: `'olderThan' must look like "30d" / "12h" / "2w"`,
+        };
+    }
+    const cutoff = Date.now() - ms;
+    const stale = listSessionFiles(agentId).filter((r) => r.mtimeMs < cutoff);
+    if (dryRun) {
+        return { ok: true, agentId, candidates: stale.length, deleted: 0, dryRun: true, wouldDelete: stale.map((r) => r.sessionId) };
+    }
+    const dir = resolveSessionsDir(agentId);
+    let deleted = 0;
+    for (const r of stale) {
+        try {
+            rmSync(path.join(dir, `${r.sessionId}.jsonl`), { force: true });
+            deleted++;
+        }
+        catch {
+            /* best-effort — skip individual delete failures */
+        }
+    }
+    return { ok: true, agentId, candidates: stale.length, deleted, dryRun: false };
+}
+//# sourceMappingURL=sessions-ops.js.map

package/dist/core/sessions-ops.js.map

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

package/dist/core/skills-ops.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Skill authoring behind the `skills.create` / `skills.delete` /
+ * `skills.write-file` gateway RPCs — reachable from a remote client.
+ *
+ * Skills are SKILL.md files on disk (NOT config), so `config.set` can't author
+ * them; `skills.status`/`skills.install`/`skills.update` already cover read /
+ * install / enable. These close create/delete/support-file. Reuses the
+ * `manage_skill` tool (ctx-free execute, owner-gated via wrapper). Operator-
+ * scoped (no per-session guard — allowlisted in the guard-sweep).
+ */
+export declare function handleSkillsCreate(params: unknown): Promise<unknown>;
+export declare function handleSkillsDelete(params: unknown): Promise<unknown>;
+export declare function handleSkillsWriteFile(params: unknown): Promise<unknown>;
+//# sourceMappingURL=skills-ops.d.ts.map

package/dist/core/skills-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-ops.d.ts","sourceRoot":"","sources":["../../src/core/skills-ops.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAaH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAE1E;AACD,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAE1E;AACD,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAE7E"}

package/dist/core/skills-ops.js

@@ -0,0 +1,28 @@
+/**
+ * Skill authoring behind the `skills.create` / `skills.delete` /
+ * `skills.write-file` gateway RPCs — reachable from a remote client.
+ *
+ * Skills are SKILL.md files on disk (NOT config), so `config.set` can't author
+ * them; `skills.status`/`skills.install`/`skills.update` already cover read /
+ * install / enable. These close create/delete/support-file. Reuses the
+ * `manage_skill` tool (ctx-free execute, owner-gated via wrapper). Operator-
+ * scoped (no per-session guard — allowlisted in the guard-sweep).
+ */
+import { DEFAULT_AGENT_ID } from "../agents/routing/session-key.js";
+import { makeManageSkillTool } from "../agents/tools/manage-skill-tool.js";
+async function runManageSkill(args) {
+    const requesterAgentId = typeof args.agentId === "string" && args.agentId.trim().length > 0 ? args.agentId : DEFAULT_AGENT_ID;
+    const tool = makeManageSkillTool({ requesterAgentId });
+    const res = await tool.execute("gateway", args);
+    return res.details;
+}
+export async function handleSkillsCreate(params) {
+    return runManageSkill({ ...(params ?? {}), action: "create" });
+}
+export async function handleSkillsDelete(params) {
+    return runManageSkill({ ...(params ?? {}), action: "delete" });
+}
+export async function handleSkillsWriteFile(params) {
+    return runManageSkill({ ...(params ?? {}), action: "write_file" });
+}
+//# sourceMappingURL=skills-ops.js.map

package/dist/core/skills-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-ops.js","sourceRoot":"","sources":["../../src/core/skills-ops.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAE3E,KAAK,UAAU,cAAc,CAAC,IAA6B;IAC1D,MAAM,gBAAgB,GACrB,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC;IACtG,MAAM,IAAI,GAAG,mBAAmB,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC;IACvD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAa,CAAC,CAAC;IACzD,OAAO,GAAG,CAAC,OAAO,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAe;IACvD,OAAO,cAAc,CAAC,EAAE,GAAI,CAAC,MAAM,IAAI,EAAE,CAA6B,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC7F,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAe;IACvD,OAAO,cAAc,CAAC,EAAE,GAAI,CAAC,MAAM,IAAI,EAAE,CAA6B,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC7F,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAAe;IAC1D,OAAO,cAAc,CAAC,EAAE,GAAI,CAAC,MAAM,IAAI,EAAE,CAA6B,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;AACjG,CAAC"}

package/dist/protocol/errors.d.ts

@@ -23,6 +23,20 @@ export declare const ErrorCodes: {
     readonly APPROVAL_NOT_FOUND: "APPROVAL_NOT_FOUND";
     /** Subsystem is loading / draining; caller may retry shortly. */
     readonly UNAVAILABLE: "UNAVAILABLE";
+    /**
+     * The remaining codes the gateway actually emits today (previously
+     * undocumented string literals — catalogued here so a web/mobile client has
+     * the COMPLETE, stable set to branch on). Values match the on-the-wire
+     * strings the server already sends.
+     */
+    /** Per-connection rate limiter tripped; honour `retryAfterMs`. */
+    readonly RATE_LIMITED: "rate-limited";
+    /** Unexpected server-side failure handling the request. */
+    readonly INTERNAL: "internal";
+    /** Caller lacks permission for the target (owner/session gate). */
+    readonly FORBIDDEN: "forbidden";
+    /** Caller's operator scope is insufficient for this method. */
+    readonly SCOPE_INSUFFICIENT: "scope-insufficient";
 };
 export type ErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes];
 export interface ErrorShapeOptions {

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/protocol/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD,eAAO,MAAM,UAAU;IACtB,oEAAoE;;IAEpE,kDAAkD;;IAElD,sEAAsE;;IAEtE,uCAAuC;;IAEvC,2EAA2E;;IAE3E,iEAAiE;;CAExD,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAErE,MAAM,WAAW,iBAAiB;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,oFAAoF;AACpF,wBAAgB,UAAU,CACzB,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,iBAAsB,GAC1B,kBAAkB,CAQpB"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/protocol/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD,eAAO,MAAM,UAAU;IACtB,oEAAoE;;IAEpE,kDAAkD;;IAElD,sEAAsE;;IAEtE,uCAAuC;;IAEvC,2EAA2E;;IAE3E,iEAAiE;;IAEjE;;;;;OAKG;IACH,kEAAkE;;IAElE,2DAA2D;;IAE3D,mEAAmE;;IAEnE,+DAA+D;;CAEtD,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAErE,MAAM,WAAW,iBAAiB;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,oFAAoF;AACpF,wBAAgB,UAAU,CACzB,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,iBAAsB,GAC1B,kBAAkB,CAQpB"}

package/dist/protocol/errors.js

@@ -22,6 +22,20 @@ export const ErrorCodes = {
     APPROVAL_NOT_FOUND: "APPROVAL_NOT_FOUND",
     /** Subsystem is loading / draining; caller may retry shortly. */
     UNAVAILABLE: "UNAVAILABLE",
+    /**
+     * The remaining codes the gateway actually emits today (previously
+     * undocumented string literals — catalogued here so a web/mobile client has
+     * the COMPLETE, stable set to branch on). Values match the on-the-wire
+     * strings the server already sends.
+     */
+    /** Per-connection rate limiter tripped; honour `retryAfterMs`. */
+    RATE_LIMITED: "rate-limited",
+    /** Unexpected server-side failure handling the request. */
+    INTERNAL: "internal",
+    /** Caller lacks permission for the target (owner/session gate). */
+    FORBIDDEN: "forbidden",
+    /** Caller's operator scope is insufficient for this method. */
+    SCOPE_INSUFFICIENT: "scope-insufficient",
 };
 /** Helper to construct a typed `ProtocolErrorShape` from one of the known codes. */
 export function errorShape(code, message, opts = {}) {

package/dist/protocol/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/protocol/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,MAAM,CAAC,MAAM,UAAU,GAAG;IACzB,oEAAoE;IACpE,UAAU,EAAE,YAAY;IACxB,kDAAkD;IAClD,UAAU,EAAE,YAAY;IACxB,sEAAsE;IACtE,aAAa,EAAE,eAAe;IAC9B,uCAAuC;IACvC,eAAe,EAAE,iBAAiB;IAClC,2EAA2E;IAC3E,kBAAkB,EAAE,oBAAoB;IACxC,iEAAiE;IACjE,WAAW,EAAE,aAAa;CACjB,CAAC;AAUX,oFAAoF;AACpF,MAAM,UAAU,UAAU,CACzB,IAAe,EACf,OAAe,EACf,OAA0B,EAAE;IAE5B,OAAO;QACN,IAAI;QACJ,OAAO;QACP,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,IAAI,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/E,CAAC;AACH,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/protocol/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,MAAM,CAAC,MAAM,UAAU,GAAG;IACzB,oEAAoE;IACpE,UAAU,EAAE,YAAY;IACxB,kDAAkD;IAClD,UAAU,EAAE,YAAY;IACxB,sEAAsE;IACtE,aAAa,EAAE,eAAe;IAC9B,uCAAuC;IACvC,eAAe,EAAE,iBAAiB;IAClC,2EAA2E;IAC3E,kBAAkB,EAAE,oBAAoB;IACxC,iEAAiE;IACjE,WAAW,EAAE,aAAa;IAC1B;;;;;OAKG;IACH,kEAAkE;IAClE,YAAY,EAAE,cAAc;IAC5B,2DAA2D;IAC3D,QAAQ,EAAE,UAAU;IACpB,mEAAmE;IACnE,SAAS,EAAE,WAAW;IACtB,+DAA+D;IAC/D,kBAAkB,EAAE,oBAAoB;CAC/B,CAAC;AAUX,oFAAoF;AACpF,MAAM,UAAU,UAAU,CACzB,IAAe,EACf,OAAe,EACf,OAA0B,EAAE;IAE5B,OAAO;QACN,IAAI;QACJ,OAAO;QACP,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,IAAI,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/E,CAAC;AACH,CAAC"}

package/dist/protocol/handshake.d.ts

@@ -81,6 +81,16 @@ export interface HelloOk {
     server: {
         version: string;
         connId: string;
+        /**
+         * Per-process boot id (session generation / "epoch"). Changes whenever
+         * the gateway process restarts. A client compares the epoch across
+         * (re)connections: if it changed, the server's per-session seq counters
+         * reset, so the client must invalidate its seq cursors and re-`resume`
+         * rather than infer a restart from a backwards seq. This makes cursor
+         * invalidation explicit + correct, rather than inferred from a
+         * backwards-jumping seq.
+         */
+        epoch: string;
     };
     features: {
         methods: readonly string[];

package/dist/protocol/handshake.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handshake.d.ts","sourceRoot":"","sources":["../../src/protocol/handshake.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,gBAAgB,EAAG,CAAU,CAAC;AAI3C,eAAO,MAAM,gBAAgB;;;;;;;;;;;;CAYnB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAEvF,eAAO,MAAM,kBAAkB;;;;;;;;CAQrB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE7F,MAAM,WAAW,iBAAiB;IACjC,EAAE,EAAE,eAAe,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,iBAAiB,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,eAAO,MAAM,cAAc;;;;;;;CAOjB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAIjF,MAAM,WAAW,aAAa;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,MAAM,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAClC,IAAI,CAAC,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,MAAM,WAAW,OAAO;IACvB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KACf,CAAC;IACF,QAAQ,EAAE;QACT,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;QAC3B,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;KAC1B,CAAC;IACF,MAAM,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;QACzB,cAAc,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,IAAI,CAAC,EAAE;QACN,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;QAClC,UAAU,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACF"}
+{"version":3,"file":"handshake.d.ts","sourceRoot":"","sources":["../../src/protocol/handshake.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,gBAAgB,EAAG,CAAU,CAAC;AAI3C,eAAO,MAAM,gBAAgB;;;;;;;;;;;;CAYnB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAEvF,eAAO,MAAM,kBAAkB;;;;;;;;CAQrB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE7F,MAAM,WAAW,iBAAiB;IACjC,EAAE,EAAE,eAAe,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,iBAAiB,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,eAAO,MAAM,cAAc;;;;;;;CAOjB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAIjF,MAAM,WAAW,aAAa;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,MAAM,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAClC,IAAI,CAAC,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,MAAM,WAAW,OAAO;IACvB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf;;;;;;;;WAQG;QACH,KAAK,EAAE,MAAM,CAAC;KACd,CAAC;IACF,QAAQ,EAAE;QACT,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;QAC3B,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;KAC1B,CAAC;IACF,MAAM,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;QACzB,cAAc,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,IAAI,CAAC,EAAE;QACN,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;QAClC,UAAU,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACF"}