@jait/gateway 0.1.0

package/dist/tools/registry.js.map

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

package/dist/tools/screen-share-tools.d.ts

@@ -0,0 +1,31 @@
+import type { ScreenShareService } from "@jait/screen-share";
+import type { WsControlPlane } from "../ws.js";
+import type { ToolDefinition } from "./contracts.js";
+interface ScreenShareInput {
+    action: "connect" | "disconnect" | "list-devices" | "start";
+    targetDeviceId?: string;
+    hostDeviceId?: string;
+    viewerDeviceIds?: string[];
+}
+interface OsToolInput {
+    action: "state" | "register-device" | "transfer-control" | "transport-update";
+    device?: {
+        id: string;
+        name: string;
+        platform: "electron" | "react-native" | "web";
+        authorized?: boolean;
+        capabilities?: string[];
+    };
+    controllerDeviceId?: string;
+    transport?: {
+        deviceId: string;
+        latencyMs: number;
+        preferP2P?: boolean;
+    };
+}
+export declare function createScreenShareTool(screenShare: ScreenShareService, ws?: WsControlPlane): ToolDefinition<ScreenShareInput>;
+export declare function createScreenCaptureTool(screenShare: ScreenShareService): ToolDefinition<Record<string, never>>;
+export declare function createScreenRecordTool(screenShare: ScreenShareService): ToolDefinition<Record<string, never>>;
+export declare function createOsTool(screenShare: ScreenShareService, name: "os.tool" | "os_tool"): ToolDefinition<OsToolInput>;
+export {};
+//# sourceMappingURL=screen-share-tools.d.ts.map

package/dist/tools/screen-share-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen-share-tools.d.ts","sourceRoot":"","sources":["../../src/tools/screen-share-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAe,cAAc,EAAc,MAAM,gBAAgB,CAAC;AAE9E,UAAU,gBAAgB;IACxB,MAAM,EAAE,SAAS,GAAG,YAAY,GAAG,cAAc,GAAG,OAAO,CAAC;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,UAAU,WAAW;IACnB,MAAM,EAAE,OAAO,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,kBAAkB,CAAC;IAC9E,MAAM,CAAC,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,UAAU,GAAG,cAAc,GAAG,KAAK,CAAC;QAC9C,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;IACF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE;QACV,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,CAAC;CACH;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,kBAAkB,EAAE,EAAE,CAAC,EAAE,cAAc,GAAG,cAAc,CAAC,gBAAgB,CAAC,CA2G5H;AAED,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,kBAAkB,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAY9G;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,kBAAkB,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAY7G;AAED,wBAAgB,YAAY,CAAC,WAAW,EAAE,kBAAkB,EAAE,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,cAAc,CAAC,WAAW,CAAC,CAoDtH"}

package/dist/tools/screen-share-tools.js

@@ -0,0 +1,183 @@
+export function createScreenShareTool(screenShare, ws) {
+    return {
+        name: "screen.share",
+        description: "Connect to a remote device and view its screen, or manage remote screen viewing sessions. " +
+            "Use 'list-devices' to discover connected devices. The response distinguishes the user's local device " +
+            "(the browser they are chatting from — platform 'web') from remote devices (Electron desktop, mobile, etc.). " +
+            "Only remote devices are valid targets for 'connect'. " +
+            "Use 'connect' with a targetDeviceId to view that device's screen remotely. " +
+            "Use 'disconnect' to end the current viewing session.",
+        tier: "standard",
+        category: "screen",
+        source: "builtin",
+        parameters: {
+            type: "object",
+            properties: {
+                action: {
+                    type: "string",
+                    enum: ["connect", "disconnect", "list-devices", "start"],
+                    description: "Action to perform. Use 'list-devices' to discover devices, 'connect'/'start' to view a remote screen, 'disconnect' to stop.",
+                },
+                targetDeviceId: {
+                    type: "string",
+                    description: "Device ID to connect to and view its screen. Required for 'connect'.",
+                },
+            },
+            required: ["action"],
+        },
+        async execute(input) {
+            if (input.action === "list-devices") {
+                const state = screenShare.getState();
+                const webDevices = state.devices.filter((d) => d.platform === "web");
+                const localDevice = webDevices.length === 1 ? webDevices[0] : null;
+                // Build a concise device list with "(current)" marker
+                const deviceLines = state.devices.map((d) => {
+                    const isCurrent = localDevice && d.id === localDevice.id;
+                    return `- ${d.name} [${d.platform}] id=${d.id}${isCurrent ? " (current — cannot connect to this)" : ""}`;
+                });
+                const remoteDevices = state.devices.filter((d) => !localDevice || d.id !== localDevice.id);
+                return {
+                    ok: true,
+                    message: deviceLines.length > 0
+                        ? `Devices:\n${deviceLines.join("\n")}${remoteDevices.length === 0 ? "\n\nNo remote devices available to connect to." : ""}`
+                        : "No devices registered. The user needs to open Jait on another device first.",
+                    data: {
+                        localDeviceId: localDevice?.id ?? null,
+                        devices: state.devices.map((d) => ({
+                            id: d.id,
+                            name: d.name,
+                            platform: d.platform,
+                            isCurrent: localDevice ? d.id === localDevice.id : false,
+                            capabilities: d.capabilities,
+                        })),
+                        activeSession: state.activeSession
+                            ? { id: state.activeSession.id, status: state.activeSession.status, hostDeviceId: state.activeSession.hostDeviceId }
+                            : null,
+                    },
+                };
+            }
+            if (input.action === "connect" || input.action === "start") {
+                const hostDeviceId = input.targetDeviceId ?? input.hostDeviceId;
+                if (!hostDeviceId) {
+                    const devices = screenShare.getState().devices;
+                    if (devices.length === 0) {
+                        return {
+                            ok: false,
+                            message: "No devices registered. The user needs to open Jait on the target device (desktop app, mobile app, or browser) first. Each device auto-registers when it opens.",
+                        };
+                    }
+                    return {
+                        ok: false,
+                        message: `targetDeviceId/hostDeviceId is required. Available devices: ${devices.map((d) => `${d.name} (${d.id})`).join(", ")}`,
+                    };
+                }
+                // Start a session with the target device as the host (screen sharer)
+                // Determine which connected devices are viewers (all except the host)
+                const viewerDeviceIds = ws
+                    ? (input.viewerDeviceIds ?? ws.getConnectedDeviceIds().filter((id) => id !== hostDeviceId))
+                    : (input.viewerDeviceIds ?? []);
+                const state = screenShare.startShare({ hostDeviceId, viewerDeviceIds });
+                // Tell the host device to begin screen capture via WS
+                // and open the Screen Share panel in the viewer's UI
+                if (ws) {
+                    ws.sendScreenShareStartRequest(state.id, hostDeviceId, viewerDeviceIds);
+                    ws.broadcastScreenShareState(state);
+                    ws.sendUICommand({ command: "screen-share.open", data: { sessionId: state.id, targetDeviceId: hostDeviceId } });
+                }
+                return {
+                    ok: true,
+                    message: `Connecting to remote device "${hostDeviceId}". The remote device will start sharing its screen. The Screen Share panel has been opened automatically.`,
+                    data: state,
+                };
+            }
+            if (input.action === "disconnect") {
+                return { ok: true, message: "Screen viewing session ended.", data: screenShare.stopShare() };
+            }
+            return { ok: false, message: `Unknown action: ${String(input.action)}` };
+        },
+    };
+}
+export function createScreenCaptureTool(screenShare) {
+    return {
+        name: "screen.capture",
+        description: "Capture a point-in-time screenshot from active screen source.",
+        tier: "standard",
+        category: "screen",
+        source: "builtin",
+        parameters: { type: "object", properties: {} },
+        async execute() {
+            return { ok: true, message: "Screen captured.", data: screenShare.captureScreen() };
+        },
+    };
+}
+export function createScreenRecordTool(screenShare) {
+    return {
+        name: "screen.record",
+        description: "Start recording an active screen share session for audit/playback.",
+        tier: "standard",
+        category: "screen",
+        source: "builtin",
+        parameters: { type: "object", properties: {} },
+        async execute() {
+            return { ok: true, message: "Screen recording started.", data: screenShare.startRecording() };
+        },
+    };
+}
+export function createOsTool(screenShare, name) {
+    return {
+        name,
+        description: "Distributed OS control plane for screen-share network state and control transfer.",
+        tier: "standard",
+        category: "screen",
+        source: "builtin",
+        parameters: {
+            type: "object",
+            properties: {
+                action: { type: "string", enum: ["state", "register-device", "transfer-control", "transport-update"] },
+            },
+            required: ["action"],
+        },
+        async execute(input, _context) {
+            try {
+                switch (input.action) {
+                    case "state":
+                        return { ok: true, message: "OS tool network state.", data: screenShare.getState() };
+                    case "register-device": {
+                        if (!input.device)
+                            return { ok: false, message: "device payload is required." };
+                        const device = screenShare.registerDevice({
+                            id: input.device.id,
+                            name: input.device.name,
+                            platform: input.device.platform,
+                            authorized: input.device.authorized ?? true,
+                            capabilities: input.device.capabilities ?? [],
+                        });
+                        return { ok: true, message: "Device registered.", data: device };
+                    }
+                    case "transfer-control": {
+                        if (!input.controllerDeviceId)
+                            return { ok: false, message: "controllerDeviceId is required." };
+                        const state = screenShare.transferControl(input.controllerDeviceId);
+                        return { ok: true, message: "Control transferred.", data: state };
+                    }
+                    case "transport-update": {
+                        if (!input.transport)
+                            return { ok: false, message: "transport payload is required." };
+                        const state = screenShare.updateViewerTransport({
+                            deviceId: input.transport.deviceId,
+                            latencyMs: input.transport.latencyMs,
+                            preferP2P: input.transport.preferP2P ?? true,
+                        });
+                        return { ok: true, message: "Transport updated.", data: state };
+                    }
+                    default:
+                        return { ok: false, message: `Unsupported os_tool action: ${String(input.action)}` };
+                }
+            }
+            catch (error) {
+                return { ok: false, message: error instanceof Error ? error.message : "OS tool action failed." };
+            }
+        },
+    };
+}
+//# sourceMappingURL=screen-share-tools.js.map

package/dist/tools/screen-share-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen-share-tools.js","sourceRoot":"","sources":["../../src/tools/screen-share-tools.ts"],"names":[],"mappings":"AA4BA,MAAM,UAAU,qBAAqB,CAAC,WAA+B,EAAE,EAAmB;IACxF,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,4FAA4F;YAC5F,uGAAuG;YACvG,8GAA8G;YAC9G,uDAAuD;YACvD,6EAA6E;YAC7E,sDAAsD;QACxD,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,QAAQ;QAClB,MAAM,EAAE,SAAS;QACjB,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,OAAO,CAAC;oBACxD,WAAW,EAAE,6HAA6H;iBAC3I;gBACD,cAAc,EAAE;oBACd,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sEAAsE;iBACpF;aACF;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;QACD,KAAK,CAAC,OAAO,CAAC,KAAK;YACjB,IAAI,KAAK,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;gBACpC,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,EAAE,CAAC;gBACrC,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC;gBACrE,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;gBAEnE,sDAAsD;gBACtD,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;oBAC1C,MAAM,SAAS,GAAG,WAAW,IAAI,CAAC,CAAC,EAAE,KAAK,WAAW,CAAC,EAAE,CAAC;oBACzD,OAAO,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,QAAQ,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,qCAAqC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;gBAC3G,CAAC,CAAC,CAAC;gBAEH,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,EAAE,KAAK,WAAW,CAAC,EAAE,CAAC,CAAC;gBAE3F,OAAO;oBACL,EAAE,EAAE,IAAI;oBACR,OAAO,EAAE,WAAW,CAAC,MAAM,GAAG,CAAC;wBAC7B,CAAC,CAAC,aAAa,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,gDAAgD,CAAC,CAAC,CAAC,EAAE,EAAE;wBAC5H,CAAC,CAAC,6EAA6E;oBACjF,IAAI,EAAE;wBACJ,aAAa,EAAE,WAAW,EAAE,EAAE,IAAI,IAAI;wBACtC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;4BACjC,EAAE,EAAE,CAAC,CAAC,EAAE;4BACR,IAAI,EAAE,CAAC,CAAC,IAAI;4BACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;4BACpB,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK;4BACxD,YAAY,EAAE,CAAC,CAAC,YAAY;yBAC7B,CAAC,CAAC;wBACH,aAAa,EAAE,KAAK,CAAC,aAAa;4BAChC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,CAAC,aAAa,CAAC,YAAY,EAAE;4BACpH,CAAC,CAAC,IAAI;qBACT;iBACF,CAAC;YACJ,CAAC;YAED,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;gBAC3D,MAAM,YAAY,GAAG,KAAK,CAAC,cAAc,IAAI,KAAK,CAAC,YAAY,CAAC;gBAChE,IAAI,CAAC,YAAY,EAAE,CAAC;oBAClB,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC;oBAC/C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBACzB,OAAO;4BACL,EAAE,EAAE,KAAK;4BACT,OAAO,EAAE,gKAAgK;yBAC1K,CAAC;oBACJ,CAAC;oBACD,OAAO;wBACL,EAAE,EAAE,KAAK;wBACT,OAAO,EAAE,+DAA+D,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;qBAC/H,CAAC;gBACJ,CAAC;gBACD,qEAAqE;gBACrE,sEAAsE;gBACtE,MAAM,eAAe,GAAG,EAAE;oBACxB,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,IAAI,EAAE,CAAC,qBAAqB,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,YAAY,CAAC,CAAC;oBAC3F,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC;gBAClC,MAAM,KAAK,GAAG,WAAW,CAAC,UAAU,CAAC,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC,CAAC;gBAExE,sDAAsD;gBACtD,qDAAqD;gBACrD,IAAI,EAAE,EAAE,CAAC;oBACP,EAAE,CAAC,2BAA2B,CAAC,KAAK,CAAC,EAAE,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;oBACxE,EAAE,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC;oBACpC,EAAE,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,mBAAmB,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,EAAE,cAAc,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC;gBAClH,CAAC;gBAED,OAAO;oBACL,EAAE,EAAE,IAAI;oBACR,OAAO,EAAE,gCAAgC,YAAY,2GAA2G;oBAChK,IAAI,EAAE,KAAK;iBACZ,CAAC;YACJ,CAAC;YAED,IAAI,KAAK,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;gBAClC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,+BAA+B,EAAE,IAAI,EAAE,WAAW,CAAC,SAAS,EAAE,EAAE,CAAC;YAC/F,CAAC;YAED,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QAC3E,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,WAA+B;IACrE,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,+DAA+D;QAC5E,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,QAAQ;QAClB,MAAM,EAAE,SAAS;QACjB,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;QAC9C,KAAK,CAAC,OAAO;YACX,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,WAAW,CAAC,aAAa,EAAE,EAAE,CAAC;QACtF,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,WAA+B;IACpE,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,oEAAoE;QACjF,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,QAAQ;QAClB,MAAM,EAAE,SAAS;QACjB,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;QAC9C,KAAK,CAAC,OAAO;YACX,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,2BAA2B,EAAE,IAAI,EAAE,WAAW,CAAC,cAAc,EAAE,EAAE,CAAC;QAChG,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,WAA+B,EAAE,IAA2B;IACvF,OAAO;QACL,IAAI;QACJ,WAAW,EAAE,mFAAmF;QAChG,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,QAAQ;QAClB,MAAM,EAAE,SAAS;QACjB,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,kBAAkB,CAAC,EAAE;aACvG;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;QACD,KAAK,CAAC,OAAO,CAAC,KAAkB,EAAE,QAAqB;YACrD,IAAI,CAAC;gBACH,QAAQ,KAAK,CAAC,MAAM,EAAE,CAAC;oBACrB,KAAK,OAAO;wBACV,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,wBAAwB,EAAE,IAAI,EAAE,WAAW,CAAC,QAAQ,EAAE,EAAE,CAAC;oBACvF,KAAK,iBAAiB,CAAC,CAAC,CAAC;wBACvB,IAAI,CAAC,KAAK,CAAC,MAAM;4BAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC;wBAChF,MAAM,MAAM,GAAG,WAAW,CAAC,cAAc,CAAC;4BACxC,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE;4BACnB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI;4BACvB,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ;4BAC/B,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU,IAAI,IAAI;4BAC3C,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE;yBAC9C,CAAC,CAAC;wBACH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,oBAAoB,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;oBACnE,CAAC;oBACD,KAAK,kBAAkB,CAAC,CAAC,CAAC;wBACxB,IAAI,CAAC,KAAK,CAAC,kBAAkB;4BAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;wBAChG,MAAM,KAAK,GAAG,WAAW,CAAC,eAAe,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;wBACpE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,sBAAsB,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;oBACpE,CAAC;oBACD,KAAK,kBAAkB,CAAC,CAAC,CAAC;wBACxB,IAAI,CAAC,KAAK,CAAC,SAAS;4BAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC;wBACtF,MAAM,KAAK,GAAG,WAAW,CAAC,qBAAqB,CAAC;4BAC9C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,QAAQ;4BAClC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,SAAS;4BACpC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,SAAS,IAAI,IAAI;yBAC7C,CAAC,CAAC;wBACH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,oBAAoB,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;oBAClE,CAAC;oBACD;wBACE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,+BAA+B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;gBACzF,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,EAAE,CAAC;YACnG,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/surface-tools.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Surface Control Tools — Sprint 3.8
+ *
+ * surfaces.list  — list all active surfaces
+ * surfaces.start — start a new surface
+ * surfaces.stop  — stop a surface by ID
+ */
+import type { ToolDefinition } from "./contracts.js";
+import type { SurfaceRegistry } from "../surfaces/registry.js";
+export declare function createSurfacesListTool(registry: SurfaceRegistry): ToolDefinition<Record<string, never>>;
+interface SurfaceStartInput {
+    type: string;
+    sessionId?: string;
+    workspaceRoot?: string;
+}
+export declare function createSurfacesStartTool(registry: SurfaceRegistry): ToolDefinition<SurfaceStartInput>;
+interface SurfaceStopInput {
+    surfaceId: string;
+    reason?: string;
+}
+export declare function createSurfacesStopTool(registry: SurfaceRegistry): ToolDefinition<SurfaceStopInput>;
+export {};
+//# sourceMappingURL=surface-tools.d.ts.map

package/dist/tools/surface-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-tools.d.ts","sourceRoot":"","sources":["../../src/tools/surface-tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAA2B,MAAM,gBAAgB,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,eAAe,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAuBvG;AAED,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,cAAc,CAAC,iBAAiB,CAAC,CAsCpG;AAED,UAAU,gBAAgB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,eAAe,GAAG,cAAc,CAAC,gBAAgB,CAAC,CA2BlG"}

package/dist/tools/surface-tools.js

@@ -0,0 +1,99 @@
+/**
+ * Surface Control Tools — Sprint 3.8
+ *
+ * surfaces.list  — list all active surfaces
+ * surfaces.start — start a new surface
+ * surfaces.stop  — stop a surface by ID
+ */
+export function createSurfacesListTool(registry) {
+    return {
+        name: "surfaces.list",
+        description: "List all active surfaces and their current state",
+        tier: "standard",
+        category: "surfaces",
+        source: "builtin",
+        parameters: {
+            type: "object",
+            properties: {},
+        },
+        async execute(_input, _context) {
+            const snapshots = registry.listSnapshots();
+            return {
+                ok: true,
+                message: `${snapshots.length} active surface(s)`,
+                data: {
+                    surfaces: snapshots,
+                    registeredTypes: registry.registeredTypes,
+                },
+            };
+        },
+    };
+}
+export function createSurfacesStartTool(registry) {
+    return {
+        name: "surfaces.start",
+        description: "Start a new surface of the given type (terminal, filesystem, browser)",
+        tier: "standard",
+        category: "surfaces",
+        source: "builtin",
+        parameters: {
+            type: "object",
+            properties: {
+                type: { type: "string", description: "Surface type to start", enum: ["terminal", "filesystem", "browser"] },
+                sessionId: { type: "string", description: "Session to attach the surface to" },
+                workspaceRoot: { type: "string", description: "Working directory for the surface" },
+            },
+            required: ["type"],
+        },
+        async execute(input, context) {
+            try {
+                const { uuidv7 } = await import("../lib/uuidv7.js");
+                const surfaceId = `${input.type}-${uuidv7()}`;
+                const surface = await registry.startSurface(input.type, surfaceId, {
+                    sessionId: input.sessionId ?? context.sessionId,
+                    workspaceRoot: input.workspaceRoot ?? context.workspaceRoot,
+                });
+                return {
+                    ok: true,
+                    message: `Started ${input.type} surface: ${surfaceId}`,
+                    data: surface.snapshot(),
+                };
+            }
+            catch (err) {
+                return {
+                    ok: false,
+                    message: err instanceof Error ? err.message : "Failed to start surface",
+                };
+            }
+        },
+    };
+}
+export function createSurfacesStopTool(registry) {
+    return {
+        name: "surfaces.stop",
+        description: "Stop a running surface by its ID",
+        tier: "standard",
+        category: "surfaces",
+        source: "builtin",
+        parameters: {
+            type: "object",
+            properties: {
+                surfaceId: { type: "string", description: "ID of the surface to stop" },
+                reason: { type: "string", description: "Reason for stopping" },
+            },
+            required: ["surfaceId"],
+        },
+        async execute(input, _context) {
+            const stopped = await registry.stopSurface(input.surfaceId, input.reason);
+            if (!stopped) {
+                return { ok: false, message: `Surface not found: ${input.surfaceId}` };
+            }
+            return {
+                ok: true,
+                message: `Stopped surface: ${input.surfaceId}`,
+                data: { surfaceId: input.surfaceId },
+            };
+        },
+    };
+}
+//# sourceMappingURL=surface-tools.js.map

package/dist/tools/surface-tools.js.map

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

package/dist/tools/terminal-tools.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Terminal Tools — persistent-terminal edition (OSC 633 shell integration)
+ *
+ * terminal.run    — execute a command in a persistent interactive terminal (like VS Code)
+ * terminal.stream — start a new interactive terminal
+ *
+ * Commands run inside a real, visible terminal that the user can open and
+ * interact with in the frontend.  Output is captured via OSC 633 escape
+ * sequences emitted by the shell integration scripts — the command itself
+ * is sent unmodified.
+ *
+ * Terminals persist between commands (up to 10 globally — oldest is
+ * stopped when the limit is exceeded).
+ */
+import type { ToolDefinition } from "./contracts.js";
+import type { SurfaceRegistry } from "../surfaces/registry.js";
+import { SandboxManager, type SandboxMountMode } from "../security/sandbox-manager.js";
+import type { WsControlPlane } from "../ws.js";
+export declare function detectInteractivePrompt(output: string): boolean;
+interface TerminalRunInput {
+    command: string;
+    sessionId?: string;
+    terminalId?: string;
+    timeout?: number;
+    sandbox?: boolean;
+    sandboxMountMode?: SandboxMountMode;
+}
+interface TerminalStreamInput {
+    sessionId: string;
+    workspaceRoot?: string;
+    cols?: number;
+    rows?: number;
+}
+export declare function createTerminalRunTool(registry: SurfaceRegistry, sandboxManager?: SandboxManager, ws?: WsControlPlane): ToolDefinition<TerminalRunInput>;
+export declare function createTerminalStreamTool(registry: SurfaceRegistry): ToolDefinition<TerminalStreamInput>;
+export {};
+//# sourceMappingURL=terminal-tools.d.ts.map

package/dist/tools/terminal-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-tools.d.ts","sourceRoot":"","sources":["../../src/tools/terminal-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,cAAc,EAA2B,MAAM,gBAAgB,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG/D,OAAO,EAAE,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AA0C/C,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAG/D;AA6RD,UAAU,gBAAgB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED,UAAU,mBAAmB;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,eAAe,EACzB,cAAc,iBAAuB,EACrC,EAAE,CAAC,EAAE,cAAc,GAClB,cAAc,CAAC,gBAAgB,CAAC,CAgIlC;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,eAAe,GAAG,cAAc,CAAC,mBAAmB,CAAC,CAoCvG"}