teamshare-bridge 0.21.66 → 0.21.70

package/dist/bridge/autostart-launcher.d.ts

@@ -0,0 +1,96 @@
+/** Stable state dir - survives npm upgrades, reinstalls and dist cleans. */
+export declare const TEAMSHARE_STATE_DIR: string;
+/** Registration marker written by `autostart on` / removed by `autostart off`. */
+export declare const AUTOSTART_MARKER_PATH: string;
+/** Watchdog script referenced by the TeamShareBridge scheduled task. */
+export declare const SUPERVISOR_VBS_PATH: string;
+/** Protocol-handler script referenced by HKCU\Software\Classes\teamshare. */
+export declare const SERVE_VBS_PATH: string;
+/** Logon-only fallback when the per-user scheduled task can't be created. */
+export declare const STARTUP_VBS_PATH: string;
+/**
+ * The launcher entry point (`dist/bridge/index.js`). Lives in THIS module's
+ * `__dirname`, which is the same directory the old package-dir copies were
+ * written to - also where `legacyLauncherPath()` looks.
+ */
+export declare function currentEntryPath(): string;
+/** Old package-dir copy (<=0.21.x) of a generated launcher. */
+export declare function legacyLauncherPath(kind: 'supervisor' | 'serve'): string;
+/** Quotes one token of a Windows command line (paths routinely contain spaces). */
+export declare function cmdQuote(value: string): string;
+/** Renders a plain string as a VBScript string literal (`"` -> `""`). */
+export declare function vbsLiteral(value: string): string;
+/**
+ * Builds a hidden Windows Script Host launcher for `cmdline`.
+ *
+ * Two rules, both here because they were once broken:
+ *  - the executable MUST be quoted. `process.execPath` is normally
+ *    `C:\Program Files\nodejs\node.exe`, and an UNQUOTED path with a space
+ *    makes `WScript.Shell.Run` fail with 0x80070002 ("The system cannot find
+ *    the file specified") - the modal Windows Script Host dialog that popped
+ *    up at every logon while the watchdog never actually started.
+ *  - failures never surface as a WSH popup. They are appended to daemon.log
+ *    and reported through a NON-ZERO exit code so Task Scheduler's
+ *    RestartCount/RestartInterval retries every minute instead of leaving a
+ *    dialog on the user's desktop.
+ *
+ * `wait: true` blocks until the child exits and forwards its exit code
+ * (that is what makes the scheduled task a restart-on-failure watchdog).
+ */
+export declare function buildWindowsLauncherVbs(cmdline: string, opts: {
+    wait: boolean;
+    logPath: string;
+}): string;
+/**
+ * Builds the hidden `teamshare://` protocol launcher: wscript.exe is a
+ * GUI-subsystem binary, so no console window is ever created (zero flash on
+ * deep link). The URL arrives as the first argument.
+ */
+export declare function buildServeVbs(nodeBin: string, entry: string): string;
+/** Writes `content` to `path`, creating the parent directory when missing. */
+export declare function writeLauncherFile(path: string, content: string): void;
+/** Reads a UTF-8 text file, or null when it is missing/unreadable. */
+export declare function readTextFile(path: string): string | null;
+/** Best-effort delete of a generated launcher (missing file is fine). */
+export declare function removeLauncherFile(path: string): void;
+export interface AutostartMarker {
+    /** Which mechanism `autostart on` actually registered. */
+    mode: 'task' | 'startup';
+    /** Absolute path of the launcher the mechanism references. */
+    vbs: string;
+    /** Install entry point the launcher was built for (detects reinstalls). */
+    entry: string;
+    /** node binary the launcher was built for. */
+    execPath: string;
+    /** ISO timestamp of the registration. */
+    at: string;
+}
+export declare function readAutostartMarker(path?: string): AutostartMarker | null;
+export declare function writeAutostartMarker(marker: Omit<AutostartMarker, 'at'> & {
+    at?: string;
+}, path?: string): void;
+export declare function removeAutostartMarker(path?: string): void;
+export interface LauncherHealth {
+    ok: boolean;
+    /** Human-readable failure cause ("" when ok). */
+    reason: string;
+}
+/**
+ * Pure health check for a registered launcher: the marker must match the
+ * CURRENT install (entry + node path) and the launcher file must exist and
+ * have been built for that same install. Any mismatch means an upgrade or
+ * reinstall moved the goalposts and the registration must be redone.
+ */
+export declare function launcherHealth(input: {
+    marker: AutostartMarker | null;
+    content: string | null;
+    entry: string;
+    execPath: string;
+}): LauncherHealth;
+/** True when `vbsPath` exists and was built for the current entry + node. */
+export declare function launcherFileHealthy(vbsPath: string, entry?: string, execPath?: string): boolean;
+/**
+ * Health of the registered autostart launcher (whatever mechanism the last
+ * `autostart on` recorded). Read-only - never registers anything itself.
+ */
+export declare function supervisorLauncherHealth(): LauncherHealth;

package/dist/bridge/autostart-launcher.js

@@ -0,0 +1,218 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STARTUP_VBS_PATH = exports.SERVE_VBS_PATH = exports.SUPERVISOR_VBS_PATH = exports.AUTOSTART_MARKER_PATH = exports.TEAMSHARE_STATE_DIR = void 0;
+exports.currentEntryPath = currentEntryPath;
+exports.legacyLauncherPath = legacyLauncherPath;
+exports.cmdQuote = cmdQuote;
+exports.vbsLiteral = vbsLiteral;
+exports.buildWindowsLauncherVbs = buildWindowsLauncherVbs;
+exports.buildServeVbs = buildServeVbs;
+exports.writeLauncherFile = writeLauncherFile;
+exports.readTextFile = readTextFile;
+exports.removeLauncherFile = removeLauncherFile;
+exports.readAutostartMarker = readAutostartMarker;
+exports.writeAutostartMarker = writeAutostartMarker;
+exports.removeAutostartMarker = removeAutostartMarker;
+exports.launcherHealth = launcherHealth;
+exports.launcherFileHealthy = launcherFileHealthy;
+exports.supervisorLauncherHealth = supervisorLauncherHealth;
+/**
+ * Windows launcher helpers for the two VBS scripts Windows references from
+ * OUTSIDE the package:
+ *   - supervisor.vbs -> scheduled task `TeamShareBridge` (logon watchdog)
+ *   - serve.vbs      -> HKCU `teamshare://` protocol handler
+ *
+ * Both scripts used to be written INSIDE the installed package dir
+ * (`.../node_modules/teamshare-bridge/dist/bridge/`) and were destroyed by
+ * every `npm i -g` upgrade (the file is generated at runtime, never shipped
+ * in the tarball) while the task/registry references survived - producing
+ * the "Can not find script file ...\supervisor.vbs" Windows Script Host
+ * dialog at every logon. They now live under ~/.teamshare (survives
+ * upgrades, reinstalls and `rm -rf dist`), and every registration records a
+ * marker so `ensureAutostartDefault` can detect a missing/stale launcher and
+ * re-register instead of returning early just because "the task exists".
+ *
+ * Everything here is pure/read-only except the explicit write/remove
+ * helpers, which all take an optional path so tests never touch the real
+ * ~/.teamshare.
+ */
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+/** Stable state dir - survives npm upgrades, reinstalls and dist cleans. */
+exports.TEAMSHARE_STATE_DIR = (0, node_path_1.join)((0, node_os_1.homedir)(), '.teamshare');
+/** Registration marker written by `autostart on` / removed by `autostart off`. */
+exports.AUTOSTART_MARKER_PATH = (0, node_path_1.join)(exports.TEAMSHARE_STATE_DIR, 'autostart.json');
+/** Watchdog script referenced by the TeamShareBridge scheduled task. */
+exports.SUPERVISOR_VBS_PATH = (0, node_path_1.join)(exports.TEAMSHARE_STATE_DIR, 'supervisor.vbs');
+/** Protocol-handler script referenced by HKCU\Software\Classes\teamshare. */
+exports.SERVE_VBS_PATH = (0, node_path_1.join)(exports.TEAMSHARE_STATE_DIR, 'serve.vbs');
+/** Logon-only fallback when the per-user scheduled task can't be created. */
+exports.STARTUP_VBS_PATH = (0, node_path_1.join)((0, node_os_1.homedir)(), 'AppData', 'Roaming', 'Microsoft', 'Windows', 'Start Menu', 'Programs', 'Startup', 'teamshare-bridge.vbs');
+/**
+ * The launcher entry point (`dist/bridge/index.js`). Lives in THIS module's
+ * `__dirname`, which is the same directory the old package-dir copies were
+ * written to - also where `legacyLauncherPath()` looks.
+ */
+function currentEntryPath() {
+    return (0, node_path_1.join)(__dirname, 'index.js');
+}
+/** Old package-dir copy (<=0.21.x) of a generated launcher. */
+function legacyLauncherPath(kind) {
+    return (0, node_path_1.join)(__dirname, `${kind}.vbs`);
+}
+// ---------------------------------------------------------------- VBS builds
+/** Quotes one token of a Windows command line (paths routinely contain spaces). */
+function cmdQuote(value) {
+    return `"${value}"`;
+}
+/** Renders a plain string as a VBScript string literal (`"` -> `""`). */
+function vbsLiteral(value) {
+    return `"${value.replace(/"/g, '""')}"`;
+}
+/**
+ * Builds a hidden Windows Script Host launcher for `cmdline`.
+ *
+ * Two rules, both here because they were once broken:
+ *  - the executable MUST be quoted. `process.execPath` is normally
+ *    `C:\Program Files\nodejs\node.exe`, and an UNQUOTED path with a space
+ *    makes `WScript.Shell.Run` fail with 0x80070002 ("The system cannot find
+ *    the file specified") - the modal Windows Script Host dialog that popped
+ *    up at every logon while the watchdog never actually started.
+ *  - failures never surface as a WSH popup. They are appended to daemon.log
+ *    and reported through a NON-ZERO exit code so Task Scheduler's
+ *    RestartCount/RestartInterval retries every minute instead of leaving a
+ *    dialog on the user's desktop.
+ *
+ * `wait: true` blocks until the child exits and forwards its exit code
+ * (that is what makes the scheduled task a restart-on-failure watchdog).
+ */
+function buildWindowsLauncherVbs(cmdline, opts) {
+    const lines = [
+        'On Error Resume Next',
+        'Set sh = CreateObject("WScript.Shell")',
+        'Set fso = CreateObject("Scripting.FileSystemObject")',
+        `cmd = ${vbsLiteral(cmdline)}`,
+        `rc = ${opts.wait ? 1 : 0}`,
+        opts.wait ? 'rc = sh.Run(cmd, 0, True)' : 'sh.Run cmd, 0, False',
+        'If Err.Number <> 0 Then',
+        '  n = Err.Number',
+        '  d = Err.Description',
+        '  Err.Clear',
+        `  Set ts = fso.OpenTextFile(${vbsLiteral(opts.logPath)}, 8, True)`,
+        '  If Not ts Is Nothing Then',
+        '    ts.WriteLine "[" & Now & "] [autostart.vbs] launch failed (" & n & " " & d & "): " & cmd',
+        '    ts.Close',
+        '  End If',
+        '  WScript.Quit 1',
+        'End If',
+        opts.wait ? 'WScript.Quit rc' : "' fire-and-forget: nothing to forward",
+        '',
+    ];
+    return lines.join('\r\n');
+}
+/**
+ * Builds the hidden `teamshare://` protocol launcher: wscript.exe is a
+ * GUI-subsystem binary, so no console window is ever created (zero flash on
+ * deep link). The URL arrives as the first argument.
+ */
+function buildServeVbs(nodeBin, entry) {
+    const escapedNode = nodeBin.replace(/"/g, '""');
+    const escapedScript = entry.replace(/"/g, '""');
+    return [
+        'Set sh = CreateObject("WScript.Shell")',
+        'Dim url',
+        'If WScript.Arguments.Count > 0 Then',
+        '  url = WScript.Arguments(0)',
+        'Else',
+        '  url = ""',
+        'End If',
+        `sh.Run """${escapedNode}"" ""${escapedScript}"" serve """ & url & """ --hidden", 0, False`,
+    ].join('\r\n');
+}
+// ---------------------------------------------------------------- file io
+/** Writes `content` to `path`, creating the parent directory when missing. */
+function writeLauncherFile(path, content) {
+    (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(path), { recursive: true });
+    (0, node_fs_1.writeFileSync)(path, content, 'utf8');
+}
+/** Reads a UTF-8 text file, or null when it is missing/unreadable. */
+function readTextFile(path) {
+    try {
+        return (0, node_fs_1.readFileSync)(path, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+/** Best-effort delete of a generated launcher (missing file is fine). */
+function removeLauncherFile(path) {
+    try {
+        (0, node_fs_1.rmSync)(path, { force: true });
+    }
+    catch {
+        /* best-effort */
+    }
+}
+function readAutostartMarker(path = exports.AUTOSTART_MARKER_PATH) {
+    try {
+        const parsed = JSON.parse((0, node_fs_1.readFileSync)(path, 'utf8'));
+        if (parsed === null || typeof parsed !== 'object')
+            return null;
+        const m = parsed;
+        if (m.mode !== 'task' && m.mode !== 'startup')
+            return null;
+        if (typeof m.vbs === 'string' && typeof m.entry === 'string' && typeof m.execPath === 'string') {
+            return m;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+function writeAutostartMarker(marker, path = exports.AUTOSTART_MARKER_PATH) {
+    writeLauncherFile(path, JSON.stringify({ ...marker, at: marker.at ?? new Date().toISOString() }, null, 2));
+}
+function removeAutostartMarker(path = exports.AUTOSTART_MARKER_PATH) {
+    removeLauncherFile(path);
+}
+/**
+ * Pure health check for a registered launcher: the marker must match the
+ * CURRENT install (entry + node path) and the launcher file must exist and
+ * have been built for that same install. Any mismatch means an upgrade or
+ * reinstall moved the goalposts and the registration must be redone.
+ */
+function launcherHealth(input) {
+    const { marker, content, entry, execPath } = input;
+    if (!marker)
+        return { ok: false, reason: 'no registration marker' };
+    if (marker.entry !== entry || marker.execPath !== execPath) {
+        return { ok: false, reason: 'stale install paths' };
+    }
+    if (content === null)
+        return { ok: false, reason: 'launcher file missing' };
+    if (!content.includes(entry) || !content.includes(execPath)) {
+        return { ok: false, reason: 'launcher content stale' };
+    }
+    return { ok: true, reason: '' };
+}
+/** True when `vbsPath` exists and was built for the current entry + node. */
+function launcherFileHealthy(vbsPath, entry = currentEntryPath(), execPath = process.execPath) {
+    const content = readTextFile(vbsPath);
+    return content !== null && content.includes(entry) && content.includes(execPath);
+}
+/**
+ * Health of the registered autostart launcher (whatever mechanism the last
+ * `autostart on` recorded). Read-only - never registers anything itself.
+ */
+function supervisorLauncherHealth() {
+    const marker = readAutostartMarker();
+    return launcherHealth({
+        marker,
+        content: marker ? readTextFile(marker.vbs) : null,
+        entry: currentEntryPath(),
+        execPath: process.execPath,
+    });
+}
+//# sourceMappingURL=autostart-launcher.js.map

package/dist/bridge/autostart-launcher.js.map

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

package/dist/bridge/daemon-inbox.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Daemon inbox pumps: the periodic mention + stranded-assignment poll and
+ * the reconnect re-sync drain. Both used to be inline in startAgentLoop and
+ * dominated daemon.ts; they only need a small deps bag (API client, config
+ * getter, wake queue, settings cache). Split out of daemon.ts (line budget).
+ */
+import { TeamshareApi } from '../lib/api';
+import { loadConfig } from '../lib/config';
+import { type WakeEvent } from './wake-routing';
+import type { SessionSettings } from './spawn';
+/** Cadence of the periodic mention + stranded-assignment poll. */
+export declare const MENTION_POLL_MS: number;
+/** Everything the two inbox pumps need from the daemon/agent loop. */
+export interface InboxDeps {
+    /** Authenticated API client for this agent (inbox fetches). */
+    api: TeamshareApi;
+    /** Base URL so a fresh client can be built with `TeamshareApi.forAgent`. */
+    apiBase: string;
+    agent: {
+        agentId: string;
+        apiKey: string;
+    };
+    /** Fresh config getter - project links / wake rules apply live. */
+    config: () => ReturnType<typeof loadConfig>;
+    wakeQueue: Map<string, WakeEvent[]>;
+    recentSpawns: Map<string, number>;
+    gateWarned: Set<string>;
+    settingsByAgent: Map<string, SessionSettings | null>;
+}
+/**
+ * Periodic mention poll (catches wakes lost while connected - WS emits are
+ * best-effort, so a silent hiccup loses the wake until the next reconnect)
+ * plus stranded-assignment recovery: open assigned tasks no session has
+ * claimed yet. Queued/deferred/blocked outcomes stay unmarked so the next
+ * cycle retries them.
+ */
+export declare function pollInboxMentions(deps: InboxDeps): Promise<void>;
+/**
+ * Re-sync (IMP-562): a wake emitted while the socket was down is LOST
+ * (nothing queues it server-side). On every (re)connect, drain the agent
+ * inbox and re-wake for assigned tasks still open - the server-side claim
+ * guard makes concurrent spawns safe. Also replays inbox.mentions (task +
+ * document comment mentions) which used to be consumed and dropped.
+ * A drain loop handles >50 item backlogs (server caps each bucket at 50).
+ */
+export declare function resyncInbox(deps: InboxDeps): void;