@rubytech/create-siteoffice-code 0.1.256

package/payload/platform/services/claude-session-manager/dist/tool-surface.js

@@ -0,0 +1,373 @@
+// Tool-surface resolver.
+//
+// Loaded once at manager boot from a directory walk of every
+// platform/plugins/<name>/PLUGIN.md (plus premium-plugins/<bundle>/PLUGIN.md
+// and premium-plugins/<bundle>/plugins/<sub>/PLUGIN.md). The frontmatter of
+// each PLUGIN.md declares a list of tools; every tool entry must specify
+// `name`, `publicAllowlist: <bool>`, and `adminAllowlist: <bool>`. The
+// resolver produces three sets of qualified tool names. The prefix differs
+// by spawn channel (Task 502):
+//
+//   - admin:  subset where adminAllowlist === true. LONG prefix
+//             `mcp__plugin_<dir>_<dir>__<tool>` — admin spawns take platform
+//             MCPs from installed plugins, which Claude Code serves long.
+//   - public: subset where publicAllowlist === true. SHORT prefix
+//             `mcp__<dir>__<tool>` — public agents keep the per-spawn
+//             `--mcp-config` channel, which registers servers under the short
+//             prefix. Server selection still extracts `<dir>` from these names.
+//   - all:    every declared tool across every plugin (both `tools:` entries
+//             and `hidden:` names), LONG prefix. Used by the boot-time drift
+//             assertion that validates specialists' long-prefix `tools:` names.
+//
+// The third surface — specialists — is declared on each specialist's
+// agent `.md` frontmatter (`tools: <comma-list>`), not here. That list
+// is consumed by Claude Code per-subagent; this resolver does not gate
+// it. The drift assertion (see manager boot in `index.ts`) verifies the
+// listed tools resolve to something — either an `all`-member tool, a
+// CC-native tool, or a known MCP-bridge namespace.
+//
+// A tool missing either allowlist field is a refusal-to-boot condition,
+// not a silent default. The decision belongs at the tool's declaration
+// site; defaulting either way hides the question from the writer.
+//
+// The parser uses a hand-rolled YAML-ish walker over the frontmatter block
+// — there is no js-yaml dependency in this service today and the schema
+// is intentionally narrow (a sequence of `- name: <s>` + `publicAllowlist:
+// <bool>` + `adminAllowlist: <bool>` triples). Anything outside that
+// shape is rejected loudly.
+import { readFileSync, readdirSync, statSync, existsSync } from 'node:fs';
+import { createHash } from 'node:crypto';
+import { join } from 'node:path';
+import { canonicalToolName, qualifyShortToolName } from './canonical-tool-names.js';
+export class ToolSurfaceError extends Error {
+    reason;
+    detail;
+    constructor(reason, detail) {
+        super(`${reason}: ${detail}`);
+        this.reason = reason;
+        this.detail = detail;
+        this.name = 'ToolSurfaceError';
+    }
+}
+const FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---/;
+function extractFrontmatter(raw, pluginDir) {
+    const m = raw.match(FRONTMATTER_RE);
+    if (!m) {
+        throw new ToolSurfaceError('frontmatter-missing', `${pluginDir}/PLUGIN.md has no '---' delimited frontmatter`);
+    }
+    return m[1];
+}
+/** Parse the tools: block out of a PLUGIN.md frontmatter body. Returns an
+ *  empty array when the frontmatter has no tools: key or declares `tools: []`.
+ *  Throws ToolSurfaceError on any malformed entry (missing name, missing or
+ *  non-boolean publicAllowlist or adminAllowlist). */
+export function parseToolsBlock(frontmatter, pluginDir) {
+    const lines = frontmatter.split(/\r?\n/);
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        // Skip blank lines and other top-level keys until we hit `tools:`.
+        if (/^tools:\s*\[\s*\]\s*$/.test(line))
+            return [];
+        if (/^tools:\s*$/.test(line)) {
+            i++;
+            break;
+        }
+        i++;
+    }
+    if (i >= lines.length)
+        return [];
+    const out = [];
+    let current = null;
+    const flush = () => {
+        if (!current)
+            return;
+        if (typeof current.name !== 'string' || current.name.length === 0) {
+            throw new ToolSurfaceError('tool-name-missing', `${pluginDir}/PLUGIN.md has a tool entry with no name`);
+        }
+        if (typeof current.publicAllowlist !== 'boolean') {
+            if (current.publicAllowlist === undefined) {
+                throw new ToolSurfaceError('public-allowlist-missing', `${pluginDir}/${current.name} — every tool must declare publicAllowlist: <true|false>`);
+            }
+            throw new ToolSurfaceError('public-allowlist-not-boolean', `${pluginDir}/${current.name} — publicAllowlist must be a YAML boolean (true|false), got ${JSON.stringify(current.publicAllowlist)}`);
+        }
+        if (typeof current.adminAllowlist !== 'boolean') {
+            if (current.adminAllowlist === undefined) {
+                throw new ToolSurfaceError('admin-allowlist-missing', `${pluginDir}/${current.name} — every tool must declare adminAllowlist: <true|false>`);
+            }
+            throw new ToolSurfaceError('admin-allowlist-not-boolean', `${pluginDir}/${current.name} — adminAllowlist must be a YAML boolean (true|false), got ${JSON.stringify(current.adminAllowlist)}`);
+        }
+        out.push(current);
+        current = null;
+    };
+    for (; i < lines.length; i++) {
+        const line = lines[i];
+        if (line.length === 0)
+            continue;
+        // A top-level key (no leading space) ends the tools block.
+        if (/^[A-Za-z_]/.test(line))
+            break;
+        const newEntry = line.match(/^\s+-\s+name:\s*(.+?)\s*$/);
+        if (newEntry) {
+            flush();
+            current = { name: newEntry[1] };
+            continue;
+        }
+        // A list item that does NOT lead with `name:` is malformed — the entry
+        // has no name field. Surface it loudly rather than silently ignoring.
+        const orphanListItem = line.match(/^\s+-\s+(?!name:)/);
+        if (orphanListItem) {
+            throw new ToolSurfaceError('tool-name-missing', `${pluginDir}/PLUGIN.md tool entry lacks a name field`);
+        }
+        const publicAllow = line.match(/^\s+publicAllowlist:\s*(.+?)\s*$/);
+        if (publicAllow && current) {
+            const v = publicAllow[1].trim();
+            if (v === 'true')
+                current.publicAllowlist = true;
+            else if (v === 'false')
+                current.publicAllowlist = false;
+            else
+                current.publicAllowlist = v;
+            continue;
+        }
+        const adminAllow = line.match(/^\s+adminAllowlist:\s*(.+?)\s*$/);
+        if (adminAllow && current) {
+            const v = adminAllow[1].trim();
+            if (v === 'true')
+                current.adminAllowlist = true;
+            else if (v === 'false')
+                current.adminAllowlist = false;
+            else
+                current.adminAllowlist = v;
+            continue;
+        }
+        // Other per-entry fields (e.g. nested name on its own line, or unknown
+        // keys we don't care about) are ignored — only name, publicAllowlist,
+        // and adminAllowlist affect the resolver.
+    }
+    flush();
+    return out;
+}
+/** Parse the `hidden:` block out of a PLUGIN.md frontmatter body. Returns
+ *  the list of tool names declared as hidden — these tools are served by
+ *  the plugin's MCP server but excluded from agent-visible enumerations.
+ *  They count for the `all` surface so specialists may still name them
+ *  in their `tools:` frontmatter without tripping the drift assertion. */
+export function parseHiddenBlock(frontmatter) {
+    const lines = frontmatter.split(/\r?\n/);
+    let i = 0;
+    while (i < lines.length) {
+        if (/^hidden:\s*$/.test(lines[i])) {
+            i++;
+            break;
+        }
+        i++;
+    }
+    if (i >= lines.length)
+        return [];
+    const out = [];
+    for (; i < lines.length; i++) {
+        const line = lines[i];
+        if (line.length === 0)
+            continue;
+        if (/^[A-Za-z_]/.test(line))
+            break;
+        const item = line.match(/^\s+-\s+(.+?)\s*$/);
+        if (item)
+            out.push(item[1]);
+    }
+    return out;
+}
+/** Parse the optional `mcp:` block out of a PLUGIN.md frontmatter body.
+ *  Returns null when the frontmatter has no `mcp:` key. Throws on a malformed
+ *  shape (missing command, args not a list, env not key:value pairs). The
+ *  schema mirrors Claude Code's `.mcp.json`. Platform plugins anchor on
+ *  ${PLATFORM_ROOT}; premium plugins anchor on ${PREMIUM_PLUGINS_ROOT}
+ *  (the sibling `premium-plugins/` directory).
+ *
+ *    mcp:
+ *      command: node
+ *      args:
+ *        - ${PLATFORM_ROOT}/lib/mcp-spawn-tee/dist/index.js
+ *        - ${PLATFORM_ROOT}/plugins/memory/mcp/dist/index.js
+ *      env:
+ *        MCP_SPAWN_TEE_NAME: memory
+ *        ACCOUNT_ID: ${ACCOUNT_ID}
+ */
+export function parseMcpBlock(frontmatter, pluginDir) {
+    const lines = frontmatter.split(/\r?\n/);
+    let i = 0;
+    while (i < lines.length) {
+        if (/^mcp:\s*$/.test(lines[i])) {
+            i++;
+            break;
+        }
+        i++;
+    }
+    if (i >= lines.length)
+        return null;
+    let command = null;
+    const args = [];
+    const env = {};
+    let envHasEntry = false;
+    let mode = 'top';
+    for (; i < lines.length; i++) {
+        const line = lines[i];
+        if (line.length === 0)
+            continue;
+        // top-level key (no leading space) ends the mcp block
+        if (/^[A-Za-z_]/.test(line))
+            break;
+        const topCommand = line.match(/^\s\s(command):\s*(.+?)\s*$/);
+        const topArgsHeader = line.match(/^\s\s(args):\s*$/);
+        const topEnvHeader = line.match(/^\s\s(env):\s*$/);
+        if (topCommand) {
+            command = topCommand[2];
+            mode = 'top';
+            continue;
+        }
+        if (topArgsHeader) {
+            mode = 'args';
+            continue;
+        }
+        if (topEnvHeader) {
+            mode = 'env';
+            continue;
+        }
+        if (mode === 'args') {
+            const item = line.match(/^\s+-\s+(.+?)\s*$/);
+            if (item) {
+                args.push(item[1]);
+                continue;
+            }
+        }
+        if (mode === 'env') {
+            const kv = line.match(/^\s+([A-Za-z_][A-Za-z0-9_]*):\s*(.+?)\s*$/);
+            if (kv) {
+                env[kv[1]] = kv[2];
+                envHasEntry = true;
+                continue;
+            }
+        }
+    }
+    if (command === null) {
+        throw new ToolSurfaceError('mcp-command-missing', `${pluginDir}/PLUGIN.md mcp: block has no command`);
+    }
+    const desc = { command, args };
+    if (envHasEntry)
+        desc.env = env;
+    return desc;
+}
+/** Walk a plugins root directory, parse every <name>/PLUGIN.md, and return
+ *  the {admin, public, all, mcpServers} sets. Throws on the first malformed
+ *  manifest — the caller (the manager boot) must exit non-zero so the
+ *  operator sees the gap.
+ *
+ *  Invariant: a plugin that declares `tools:` with at least one entry MUST
+ *  also declare an `mcp:` block. Without it the spawn would push
+ *  `--allowed-tools mcp__<plugin>__*` for a server that was never registered
+ *  with Claude Code; the tools would be unreachable and the operator would
+ *  see "tool not found" rather than a boot-time gap. */
+export function loadToolSurface(pluginsRoots) {
+    const roots = Array.isArray(pluginsRoots) ? pluginsRoots : [pluginsRoots];
+    for (const r of roots) {
+        if (!existsSync(r))
+            throw new ToolSurfaceError('plugins-root-missing', r);
+    }
+    const admin = new Set();
+    const pub = new Set();
+    const all = new Set();
+    const mcpServers = new Map();
+    // First-registration manifest path per plugin name. On a second hit we
+    // pull the prior path back out so the enriched error can quote both.
+    const manifestPaths = new Map();
+    /** Process one candidate plugin directory. The plugin's MCP namespace
+     *  is the directory basename; sub-plugins under a premium bundle use
+     *  their own basename, not the bundle's. */
+    const loadOne = (pluginsRoot, plugin) => {
+        const pluginDir = join(pluginsRoot, plugin);
+        try {
+            if (!statSync(pluginDir).isDirectory())
+                return;
+        }
+        catch {
+            return;
+        }
+        const manifestPath = join(pluginDir, 'PLUGIN.md');
+        if (!existsSync(manifestPath))
+            return;
+        const raw = readFileSync(manifestPath, 'utf-8');
+        const frontmatter = extractFrontmatter(raw, plugin);
+        const tools = parseToolsBlock(frontmatter, plugin);
+        if (tools.length === 0)
+            return;
+        const mcp = parseMcpBlock(frontmatter, plugin);
+        if (!mcp) {
+            throw new ToolSurfaceError('mcp-block-missing', `${plugin}/PLUGIN.md declares tools but no mcp: block; spawns would --allowed-tools mcp__${plugin}__* with no registered server`);
+        }
+        if (mcpServers.has(plugin)) {
+            // A second registration is always a real conflict: the premium-tree
+            // flat-copy reaper deletes byte-identical duplicates before boot, so
+            // anything reaching here is either a divergent operator override or a
+            // genuine cross-root collision. Quote both paths and a sha-prefix per
+            // file so the operator can decide which to remove.
+            const priorPath = manifestPaths.get(plugin);
+            if (!priorPath) {
+                throw new ToolSurfaceError('mcp-plugin-duplicate-no-prior-path', `${plugin}: mcpServers has entry but manifestPaths is missing — invariant violated, both maps must be written together`);
+            }
+            const priorSha = createHash('sha256').update(readFileSync(priorPath)).digest('hex').slice(0, 8);
+            const newSha = createHash('sha256').update(raw).digest('hex').slice(0, 8);
+            throw new ToolSurfaceError('mcp-plugin-duplicate', `${plugin} declared by more than one plugins root: ${priorPath} (sha=${priorSha}) vs ${manifestPath} (sha=${newSha})`);
+        }
+        mcpServers.set(plugin, mcp);
+        manifestPaths.set(plugin, manifestPath);
+        for (const t of tools) {
+            // Admin + specialist spawns take platform MCPs from installed plugins,
+            // which Claude Code serves under the long prefix; `all` (drift surface)
+            // and `admin` (admin `--allowed-tools`) bind to that canonical name.
+            // Public agents keep the per-spawn `--mcp-config` channel, so the public
+            // allowlist stays the short prefix the per-spawn `.mcp.json` registers.
+            const canonical = canonicalToolName(plugin, t.name);
+            all.add(canonical);
+            if (t.adminAllowlist)
+                admin.add(canonical);
+            if (t.publicAllowlist)
+                pub.add(qualifyShortToolName(plugin, t.name));
+        }
+        // Hidden tools share the plugin's MCP server but stay out of the
+        // admin/public allowlists. They count for `all` so specialists may
+        // name them without tripping the drift assertion.
+        for (const h of parseHiddenBlock(frontmatter)) {
+            all.add(canonicalToolName(plugin, h));
+        }
+    };
+    for (const root of roots) {
+        const entries = readdirSync(root).sort();
+        for (const plugin of entries) {
+            const pluginDir = join(root, plugin);
+            // Walk the top-level plugin manifest (platform/plugins/<name>/PLUGIN.md
+            // or premium-plugins/<bundle>/PLUGIN.md).
+            loadOne(root, plugin);
+            // A premium bundle may also nest sibling plugins under
+            // `<bundle>/plugins/<sub>/PLUGIN.md`. The bundle itself is often a
+            // wrapper without tools while the sub-plugins carry real namespaces
+            // (loop, property-data under real-agent). The MCP namespace ends up
+            // as `mcp__<sub>__*` — the bundle name does not appear in tool names.
+            const subRoot = join(pluginDir, 'plugins');
+            let subEntries;
+            try {
+                if (!statSync(subRoot).isDirectory())
+                    continue;
+                subEntries = readdirSync(subRoot).sort();
+            }
+            catch {
+                continue;
+            }
+            for (const sub of subEntries) {
+                loadOne(subRoot, sub);
+            }
+        }
+    }
+    return { admin, public: pub, all, mcpServers };
+}
+//# sourceMappingURL=tool-surface.js.map

package/payload/platform/services/claude-session-manager/dist/tool-surface.js.map

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

package/payload/platform/services/claude-session-manager/dist/types.d.ts

@@ -0,0 +1,41 @@
+export type Role = 'admin' | 'public';
+export type Channel = 'browser' | 'whatsapp' | 'telegram' | 'webchat' | 'email';
+export interface SpawnRequest {
+    senderId: string;
+    role: Role;
+    channel: Channel;
+}
+export interface Session {
+    /** intrinsic claude session id (the JSONL basename Claude
+     *  Code wrote on disk). Single identifier per Claude process for its
+     *  entire lifetime; identical across alive→ended and across manager
+     *  restarts. The manager mints zero ids of its own. */
+    sessionId: string;
+    pid: number;
+    url: string;
+    startedAt: string;
+    senderId: string;
+    role: Role;
+    channel: Channel;
+}
+export interface PtyHandle {
+    readonly pid: number;
+    onData(cb: (data: string) => void): {
+        dispose(): void;
+    };
+    onExit(cb: (e: {
+        exitCode: number;
+        signal?: number;
+    }) => void): {
+        dispose(): void;
+    };
+    write(data: string): void;
+    kill(signal?: string): void;
+    /** Release the pty master fd. Task 170 — node-pty's IPty typings omit
+     *  this, but UnixTerminal exposes it; without it the master fd lingers
+     *  until V8 GC finalizes the IPty's socket, accumulating under load.
+     *  stopSession calls this with `?.()` so test mocks may omit it. */
+    destroy?(): void;
+}
+export type Logger = (line: string) => void;
+//# sourceMappingURL=types.d.ts.map

package/payload/platform/services/claude-session-manager/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,IAAI,GAAG,OAAO,GAAG,QAAQ,CAAA;AAErC,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAA;AAE/E,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,IAAI,CAAA;IACV,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,OAAO;IACtB;;;2DAGuD;IACvD,SAAS,EAAE,MAAM,CAAA;IACjB,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,IAAI,CAAA;IACV,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG;QAAE,OAAO,IAAI,IAAI,CAAA;KAAE,CAAA;IACvD,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG;QAAE,OAAO,IAAI,IAAI,CAAA;KAAE,CAAA;IACnF,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B;;;wEAGoE;IACpE,OAAO,CAAC,IAAI,IAAI,CAAA;CACjB;AAED,MAAM,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA"}

package/payload/platform/services/claude-session-manager/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/payload/platform/services/claude-session-manager/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/payload/platform/services/claude-session-manager/dist/url-capture.d.ts

@@ -0,0 +1,12 @@
+import type { Logger, PtyHandle } from './types.js';
+export interface UrlCaptureOptions {
+    pty: PtyHandle;
+    timeoutMs: number;
+    onUrl: (url: string, ms: number) => void;
+    onTimeout: () => void;
+    logger: Logger;
+}
+export declare function startUrlCapture(opts: UrlCaptureOptions): {
+    cancel: () => void;
+};
+//# sourceMappingURL=url-capture.d.ts.map

package/payload/platform/services/claude-session-manager/dist/url-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-capture.d.ts","sourceRoot":"","sources":["../src/url-capture.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAcnD,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,SAAS,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACxC,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,iBAAiB,GAAG;IAAE,MAAM,EAAE,MAAM,IAAI,CAAA;CAAE,CAwC/E"}

package/payload/platform/services/claude-session-manager/dist/url-capture.js

@@ -0,0 +1,79 @@
+// URL capture for `claude --verbose --remote-control`.
+//
+// Claude Code prints the line:
+//
+//     /remote-control is active · <url>
+//
+// On 2.1.142 the inter-word separators were literal U+0020 spaces. On
+// 2.1.143 they switched to `\x1b[1C` (CSI Cursor Forward 1) — same visual
+// layout, different bytes. The 2.1.142-only regex required literal spaces
+// between `is`/`active` and silently timed out on 2.1.143.
+//
+// Strategy:
+//   1. Strip every CSI sequence (`ESC [ ... letter`) from a buffer copy.
+//      `\x1b[1C` becomes empty; `\x1b[38;5;246m` colour prefixes drop too.
+//   2. Match on the stripped buffer with a pattern that anchors only on
+//      `/remote-control` (the slash-prefixed keyword claude always prints
+//      verbatim). Whatever sits between the anchor and the URL is
+//      `[\s\S]*?` so a future release reverting to literal spaces, or
+//      changing the middle-dot, still matches.
+//   3. Capture stops at whitespace or ESC so the URL is clean.
+//
+// We accumulate onData chunks into a buffer so a multi-byte split across
+// two callbacks still matches. After the first URL is captured, the handler
+// unregisters itself so subsequent PTY bytes flow through unchanged.
+// Bounded, non-backtracking: a CSI sequence is ESC `[`, then zero-or-more
+// digits/semicolons/question-marks, terminated by a single letter.
+const CSI = /\x1b\[[0-9;?]*[A-Za-z]/g;
+function stripCsi(s) {
+    return s.replace(CSI, '');
+}
+// `[^\s\x1b]+` terminates the URL at the first whitespace or ESC, so even
+// if a colour-code prefix snuck through stripCsi the URL stays clean.
+const URL_PATTERN = /\/remote-control[\s\S]*?(https?:\/\/[^\s\x1b]+)/;
+export function startUrlCapture(opts) {
+    const start = Date.now();
+    let buffer = '';
+    let settled = false;
+    let dataSub = null;
+    const timeout = setTimeout(() => {
+        if (settled)
+            return;
+        settled = true;
+        if (dataSub)
+            dataSub.dispose();
+        opts.onTimeout();
+    }, opts.timeoutMs);
+    dataSub = opts.pty.onData((data) => {
+        if (settled)
+            return;
+        buffer += data;
+        const match = stripCsi(buffer).match(URL_PATTERN);
+        if (!match) {
+            // Cap the raw buffer so PTY scroll output does not grow unbounded.
+            const keep = 16 * 1024;
+            if (buffer.length > keep)
+                buffer = buffer.slice(buffer.length - keep);
+            return;
+        }
+        settled = true;
+        clearTimeout(timeout);
+        if (dataSub)
+            dataSub.dispose();
+        const url = match[1];
+        const ms = Date.now() - start;
+        opts.logger(`url-captured pid=${opts.pty.pid} url=${url} ms=${ms}`);
+        opts.onUrl(url, ms);
+    });
+    return {
+        cancel: () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timeout);
+            if (dataSub)
+                dataSub.dispose();
+        },
+    };
+}
+//# sourceMappingURL=url-capture.js.map

package/payload/platform/services/claude-session-manager/dist/url-capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-capture.js","sourceRoot":"","sources":["../src/url-capture.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,EAAE;AACF,+BAA+B;AAC/B,EAAE;AACF,wCAAwC;AACxC,EAAE;AACF,sEAAsE;AACtE,0EAA0E;AAC1E,0EAA0E;AAC1E,2DAA2D;AAC3D,EAAE;AACF,YAAY;AACZ,yEAAyE;AACzE,2EAA2E;AAC3E,wEAAwE;AACxE,0EAA0E;AAC1E,kEAAkE;AAClE,sEAAsE;AACtE,+CAA+C;AAC/C,+DAA+D;AAC/D,EAAE;AACF,yEAAyE;AACzE,4EAA4E;AAC5E,qEAAqE;AAIrE,0EAA0E;AAC1E,mEAAmE;AACnE,MAAM,GAAG,GAAG,yBAAyB,CAAA;AAErC,SAAS,QAAQ,CAAC,CAAS;IACzB,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;AAC3B,CAAC;AAED,0EAA0E;AAC1E,sEAAsE;AACtE,MAAM,WAAW,GAAG,iDAAiD,CAAA;AAUrE,MAAM,UAAU,eAAe,CAAC,IAAuB;IACrD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IACxB,IAAI,MAAM,GAAG,EAAE,CAAA;IACf,IAAI,OAAO,GAAG,KAAK,CAAA;IACnB,IAAI,OAAO,GAA+B,IAAI,CAAA;IAE9C,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;QAC9B,IAAI,OAAO;YAAE,OAAM;QACnB,OAAO,GAAG,IAAI,CAAA;QACd,IAAI,OAAO;YAAE,OAAO,CAAC,OAAO,EAAE,CAAA;QAC9B,IAAI,CAAC,SAAS,EAAE,CAAA;IAClB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;IAElB,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QACjC,IAAI,OAAO;YAAE,OAAM;QACnB,MAAM,IAAI,IAAI,CAAA;QACd,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;QACjD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,mEAAmE;YACnE,MAAM,IAAI,GAAG,EAAE,GAAG,IAAI,CAAA;YACtB,IAAI,MAAM,CAAC,MAAM,GAAG,IAAI;gBAAE,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;YACrE,OAAM;QACR,CAAC;QACD,OAAO,GAAG,IAAI,CAAA;QACd,YAAY,CAAC,OAAO,CAAC,CAAA;QACrB,IAAI,OAAO;YAAE,OAAO,CAAC,OAAO,EAAE,CAAA;QAC9B,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;QACpB,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAA;QAC7B,IAAI,CAAC,MAAM,CAAC,oBAAoB,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,GAAG,OAAO,EAAE,EAAE,CAAC,CAAA;QACnE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;IACrB,CAAC,CAAC,CAAA;IAEF,OAAO;QACL,MAAM,EAAE,GAAG,EAAE;YACX,IAAI,OAAO;gBAAE,OAAM;YACnB,OAAO,GAAG,IAAI,CAAA;YACd,YAAY,CAAC,OAAO,CAAC,CAAA;YACrB,IAAI,OAAO;gBAAE,OAAO,CAAC,OAAO,EAAE,CAAA;QAChC,CAAC;KACF,CAAA;AACH,CAAC"}

package/payload/platform/services/claude-session-manager/dist/user-title-store.d.ts

@@ -0,0 +1,39 @@
+import type { Logger } from './types.js';
+export interface UserTitleEntry {
+    title: string;
+    renamedAt: string;
+}
+export type ValidateResult = {
+    ok: true;
+    title: string;
+} | {
+    ok: false;
+    reason: 'empty' | 'too-long' | 'control-chars';
+};
+/** Single source of truth for user-title validation. Mirrored in
+ *  Sidebar.tsx + SessionMetadataPane.tsx as length-only client-side checks;
+ *  the control-char rejection is server-only. */
+export declare function validateUserTitle(raw: unknown): ValidateResult;
+export declare class UserTitleStore {
+    private readonly bySessionId;
+    private readonly filePath;
+    private readonly logger;
+    private loaded;
+    constructor(filePath: string, logger: Logger);
+    /** Read the persisted file into the in-memory map. Boot-resilient: any
+     *  failure (missing file, malformed JSON, permission denied) is logged
+     *  and the store starts empty. Never throws. */
+    loadFromDisk(): void;
+    get(sessionId: string): UserTitleEntry | undefined;
+    /** Persist `title` for `sessionId`. Caller is responsible for validating
+     *  via `validateUserTitle` first; the store stores whatever it's given. */
+    set(sessionId: string, title: string): UserTitleEntry;
+    /** Remove the entry for `sessionId` if present. Called on session
+     *  purge/delete cascade so the file doesn't accrete orphans.
+     *  Returns true when an entry was removed. */
+    remove(sessionId: string): boolean;
+    /** Current in-memory snapshot — diagnostic only. */
+    size(): number;
+    private persistAtomic;
+}
+//# sourceMappingURL=user-title-store.d.ts.map

package/payload/platform/services/claude-session-manager/dist/user-title-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-title-store.d.ts","sourceRoot":"","sources":["../src/user-title-store.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAExC,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC3B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,eAAe,CAAA;CAAE,CAAA;AAKjE;;iDAEiD;AACjD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAO9D;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoC;IAChE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,MAAM,CAAQ;gBAEV,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAK5C;;oDAEgD;IAChD,YAAY,IAAI,IAAI;IA0CpB,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIlD;+EAC2E;IAC3E,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc;IAOrD;;kDAE8C;IAC9C,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAMlC,oDAAoD;IACpD,IAAI,IAAI,MAAM;IAId,OAAO,CAAC,aAAa;CActB"}