@jait/gateway 0.1.0

package/dist/tools/token-estimator.js

@@ -0,0 +1,82 @@
+/**
+ * Lightweight token estimation — no external tokenizer dependency.
+ *
+ * Uses a char/token ratio of ~3.7 (empirically close to GPT-4 BPE for
+ * mixed English text + code). JSON overhead is slightly higher (~4.0)
+ * so we use that for structured payloads.
+ */
+const TEXT_CHARS_PER_TOKEN = 3.7;
+const JSON_CHARS_PER_TOKEN = 4.0;
+/** Estimate tokens for a plain-text string. */
+export function estimateTokens(text) {
+    if (!text)
+        return 0;
+    return Math.ceil(text.length / TEXT_CHARS_PER_TOKEN);
+}
+/** Estimate tokens for a JSON-stringified payload. */
+export function estimateJsonTokens(obj) {
+    const json = typeof obj === "string" ? obj : JSON.stringify(obj);
+    return Math.ceil(json.length / JSON_CHARS_PER_TOKEN);
+}
+/**
+ * Per-message overhead: ~4 tokens for role/formatting delimiters
+ * (matches OpenAI's documented `tokens_per_message` for gpt-4).
+ */
+const TOKENS_PER_MESSAGE = 4;
+/** Estimate token cost of a single chat message. */
+export function estimateMessageTokens(msg) {
+    let tokens = TOKENS_PER_MESSAGE;
+    tokens += estimateTokens(msg.content);
+    if (msg.name)
+        tokens += estimateTokens(msg.name);
+    if (msg.tool_call_id)
+        tokens += estimateTokens(msg.tool_call_id);
+    if (msg.tool_calls) {
+        // Tool calls are JSON-heavy
+        tokens += estimateJsonTokens(msg.tool_calls);
+    }
+    return tokens;
+}
+/** Estimate total token cost of a message array. */
+export function estimateHistoryTokens(messages) {
+    let total = 3; // every request has ~3 priming tokens
+    for (const msg of messages) {
+        total += estimateMessageTokens(msg);
+    }
+    return total;
+}
+/** Estimate token cost of tool schemas. */
+export function estimateToolSchemaTokens(schemas) {
+    if (!schemas.length)
+        return 0;
+    // Tool schemas get ~16 base + 8 per tool + schema content
+    let tokens = 16;
+    for (const schema of schemas) {
+        tokens += 8 + estimateJsonTokens(schema);
+    }
+    // Apply 1.1× safety margin (same as Copilot)
+    return Math.ceil(tokens * 1.1);
+}
+/** Compute context usage breakdown from current state. */
+export function computeContextUsage(messages, toolSchemas, contextWindow) {
+    let system = 0;
+    let history = 0;
+    let toolResults = 0;
+    for (const msg of messages) {
+        const cost = estimateMessageTokens(msg);
+        if (msg.role === "system") {
+            system += cost;
+        }
+        else if (msg.role === "tool") {
+            toolResults += cost;
+        }
+        else {
+            history += cost;
+        }
+    }
+    const tools = estimateToolSchemaTokens(toolSchemas);
+    const total = system + history + toolResults + tools;
+    const ratio = contextWindow > 0 ? Math.min(total / contextWindow, 1.0) : 0;
+    return { system, history, toolResults, tools, total, limit: contextWindow, ratio };
+}
+//# sourceMappingURL=token-estimator.js.map

package/dist/tools/token-estimator.js.map

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

package/dist/tools/tool-names.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Canonical tool name constants.
+ *
+ * Using a const object instead of an enum for zero-cost at runtime
+ * (enums generate a reverse-mapping object; const objects are erased).
+ *
+ * Borrowed from VS Code Copilot Chat's ToolName enum — prevents string
+ * typo bugs and enables IDE autocomplete for tool references.
+ */
+export declare const ToolName: {
+    readonly TerminalRun: "terminal.run";
+    readonly TerminalStream: "terminal.stream";
+    readonly FileRead: "file.read";
+    readonly FileWrite: "file.write";
+    readonly FilePatch: "file.patch";
+    readonly FileList: "file.list";
+    readonly FileStat: "file.stat";
+    readonly OsQuery: "os.query";
+    readonly OsInstall: "os.install";
+    readonly OsTool: "os.tool";
+    readonly OsToolAlt: "os_tool";
+    readonly SurfacesList: "surfaces.list";
+    readonly SurfacesStart: "surfaces.start";
+    readonly SurfacesStop: "surfaces.stop";
+    readonly CronAdd: "cron.add";
+    readonly CronList: "cron.list";
+    readonly CronRemove: "cron.remove";
+    readonly CronUpdate: "cron.update";
+    readonly GatewayStatus: "gateway.status";
+    readonly ScreenShare: "screen.share";
+    readonly ScreenCapture: "screen.capture";
+    readonly ScreenRecord: "screen.record";
+    readonly BrowserNavigate: "browser.navigate";
+    readonly BrowserSnapshot: "browser.snapshot";
+    readonly BrowserClick: "browser.click";
+    readonly BrowserType: "browser.type";
+    readonly BrowserSelect: "browser.select";
+    readonly BrowserScroll: "browser.scroll";
+    readonly BrowserWait: "browser.wait";
+    readonly BrowserScreenshot: "browser.screenshot";
+    readonly BrowserSandboxStart: "browser.sandbox.start";
+    readonly WebFetch: "web.fetch";
+    readonly WebSearch: "web.search";
+    readonly MemorySave: "memory.save";
+    readonly MemorySearch: "memory.search";
+    readonly MemoryForget: "memory.forget";
+    readonly VoiceSpeak: "voice.speak";
+    readonly AgentSpawn: "agent.spawn";
+    readonly ThreadControl: "thread.control";
+    readonly ToolsList: "tools.list";
+    readonly ToolsSearch: "tools.search";
+    readonly NetworkScan: "network.scan";
+    readonly CoreRead: "read";
+    readonly CoreEdit: "edit";
+    readonly CoreExecute: "execute";
+    readonly CoreSearch: "search";
+    readonly CoreWeb: "web";
+    readonly CoreAgent: "agent";
+    readonly CoreTodo: "todo";
+    readonly CoreJait: "jait";
+};
+/** Union of all known tool name values. */
+export type ToolNameValue = (typeof ToolName)[keyof typeof ToolName];
+//# sourceMappingURL=tool-names.d.ts.map

package/dist/tools/tool-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-names.d.ts","sourceRoot":"","sources":["../../src/tools/tool-names.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8EX,CAAC;AAEX,2CAA2C;AAC3C,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC"}

package/dist/tools/tool-names.js

@@ -0,0 +1,76 @@
+/**
+ * Canonical tool name constants.
+ *
+ * Using a const object instead of an enum for zero-cost at runtime
+ * (enums generate a reverse-mapping object; const objects are erased).
+ *
+ * Borrowed from VS Code Copilot Chat's ToolName enum — prevents string
+ * typo bugs and enables IDE autocomplete for tool references.
+ */
+export const ToolName = {
+    // ── Terminal ──
+    TerminalRun: "terminal.run",
+    TerminalStream: "terminal.stream",
+    // ── File system ──
+    FileRead: "file.read",
+    FileWrite: "file.write",
+    FilePatch: "file.patch",
+    FileList: "file.list",
+    FileStat: "file.stat",
+    // ── OS ──
+    OsQuery: "os.query",
+    OsInstall: "os.install",
+    OsTool: "os.tool",
+    OsToolAlt: "os_tool",
+    // ── Surfaces ──
+    SurfacesList: "surfaces.list",
+    SurfacesStart: "surfaces.start",
+    SurfacesStop: "surfaces.stop",
+    // ── Scheduler / cron ──
+    CronAdd: "cron.add",
+    CronList: "cron.list",
+    CronRemove: "cron.remove",
+    CronUpdate: "cron.update",
+    // ── Gateway ──
+    GatewayStatus: "gateway.status",
+    // ── Screen share ──
+    ScreenShare: "screen.share",
+    ScreenCapture: "screen.capture",
+    ScreenRecord: "screen.record",
+    // ── Browser & web ──
+    BrowserNavigate: "browser.navigate",
+    BrowserSnapshot: "browser.snapshot",
+    BrowserClick: "browser.click",
+    BrowserType: "browser.type",
+    BrowserSelect: "browser.select",
+    BrowserScroll: "browser.scroll",
+    BrowserWait: "browser.wait",
+    BrowserScreenshot: "browser.screenshot",
+    BrowserSandboxStart: "browser.sandbox.start",
+    WebFetch: "web.fetch",
+    WebSearch: "web.search",
+    // ── Memory ──
+    MemorySave: "memory.save",
+    MemorySearch: "memory.search",
+    MemoryForget: "memory.forget",
+    // ── Voice ──
+    VoiceSpeak: "voice.speak",
+    // ── Agent ──
+    AgentSpawn: "agent.spawn",
+    ThreadControl: "thread.control",
+    // ── Meta (tool discovery) ──
+    ToolsList: "tools.list",
+    ToolsSearch: "tools.search",
+    // ── Network ──
+    NetworkScan: "network.scan",
+    // ── Core tools (simplified set) ──
+    CoreRead: "read",
+    CoreEdit: "edit",
+    CoreExecute: "execute",
+    CoreSearch: "search",
+    CoreWeb: "web",
+    CoreAgent: "agent",
+    CoreTodo: "todo",
+    CoreJait: "jait",
+};
+//# sourceMappingURL=tool-names.js.map

package/dist/tools/tool-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-names.js","sourceRoot":"","sources":["../../src/tools/tool-names.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,iBAAiB;IACjB,WAAW,EAAE,cAAc;IAC3B,cAAc,EAAE,iBAAiB;IAEjC,oBAAoB;IACpB,QAAQ,EAAE,WAAW;IACrB,SAAS,EAAE,YAAY;IACvB,SAAS,EAAE,YAAY;IACvB,QAAQ,EAAE,WAAW;IACrB,QAAQ,EAAE,WAAW;IAErB,WAAW;IACX,OAAO,EAAE,UAAU;IACnB,SAAS,EAAE,YAAY;IACvB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,SAAS;IAEpB,iBAAiB;IACjB,YAAY,EAAE,eAAe;IAC7B,aAAa,EAAE,gBAAgB;IAC/B,YAAY,EAAE,eAAe;IAE7B,yBAAyB;IACzB,OAAO,EAAE,UAAU;IACnB,QAAQ,EAAE,WAAW;IACrB,UAAU,EAAE,aAAa;IACzB,UAAU,EAAE,aAAa;IAEzB,gBAAgB;IAChB,aAAa,EAAE,gBAAgB;IAE/B,qBAAqB;IACrB,WAAW,EAAE,cAAc;IAC3B,aAAa,EAAE,gBAAgB;IAC/B,YAAY,EAAE,eAAe;IAE7B,sBAAsB;IACtB,eAAe,EAAE,kBAAkB;IACnC,eAAe,EAAE,kBAAkB;IACnC,YAAY,EAAE,eAAe;IAC7B,WAAW,EAAE,cAAc;IAC3B,aAAa,EAAE,gBAAgB;IAC/B,aAAa,EAAE,gBAAgB;IAC/B,WAAW,EAAE,cAAc;IAC3B,iBAAiB,EAAE,oBAAoB;IACvC,mBAAmB,EAAE,uBAAuB;IAC5C,QAAQ,EAAE,WAAW;IACrB,SAAS,EAAE,YAAY;IAEvB,eAAe;IACf,UAAU,EAAE,aAAa;IACzB,YAAY,EAAE,eAAe;IAC7B,YAAY,EAAE,eAAe;IAE7B,cAAc;IACd,UAAU,EAAE,aAAa;IAEzB,cAAc;IACd,UAAU,EAAE,aAAa;IACzB,aAAa,EAAE,gBAAgB;IAE/B,8BAA8B;IAC9B,SAAS,EAAE,YAAY;IACvB,WAAW,EAAE,cAAc;IAE3B,gBAAgB;IAChB,WAAW,EAAE,cAAc;IAE3B,oCAAoC;IACpC,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,WAAW,EAAE,SAAS;IACtB,UAAU,EAAE,QAAQ;IACpB,OAAO,EAAE,KAAK;IACd,SAAS,EAAE,OAAO;IAClB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;CACR,CAAC"}

package/dist/tools/validate.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Lightweight JSON Schema validator for tool input parameters.
+ *
+ * Handles only the subset of JSON Schema used by ToolParametersSchema:
+ *   - `type: "object"` with `properties` and `required`
+ *   - Property types: string, number, boolean, array, object
+ *   - `enum` constraints
+ *
+ * This is intentionally minimal — ~60 lines vs Ajv's 124 KB.
+ * For our use-case (validating LLM-generated tool arguments), it's
+ * 5-10× faster than Ajv because there's no schema compilation step.
+ */
+import type { ToolParametersSchema } from "./contracts.js";
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+/**
+ * Validate an input value against a ToolParametersSchema.
+ *
+ * If `input` is nullish, it's treated as `{}` (matching Ajv behaviour
+ * for schemas that only have optional properties).
+ *
+ * Returns `{ valid: true, errors: [] }` on success.
+ */
+export declare function validateToolInput(schema: ToolParametersSchema, input: unknown): ValidationResult;
+//# sourceMappingURL=validate.d.ts.map

package/dist/tools/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/tools/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAWD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,oBAAoB,EAC5B,KAAK,EAAE,OAAO,GACb,gBAAgB,CA2ElB"}

package/dist/tools/validate.js

@@ -0,0 +1,99 @@
+/**
+ * Lightweight JSON Schema validator for tool input parameters.
+ *
+ * Handles only the subset of JSON Schema used by ToolParametersSchema:
+ *   - `type: "object"` with `properties` and `required`
+ *   - Property types: string, number, boolean, array, object
+ *   - `enum` constraints
+ *
+ * This is intentionally minimal — ~60 lines vs Ajv's 124 KB.
+ * For our use-case (validating LLM-generated tool arguments), it's
+ * 5-10× faster than Ajv because there's no schema compilation step.
+ */
+const TYPE_CHECKS = {
+    string: (v) => typeof v === "string",
+    number: (v) => typeof v === "number",
+    integer: (v) => typeof v === "number" && Number.isInteger(v),
+    boolean: (v) => typeof v === "boolean",
+    array: (v) => Array.isArray(v),
+    object: (v) => typeof v === "object" && v !== null && !Array.isArray(v),
+};
+/**
+ * Validate an input value against a ToolParametersSchema.
+ *
+ * If `input` is nullish, it's treated as `{}` (matching Ajv behaviour
+ * for schemas that only have optional properties).
+ *
+ * Returns `{ valid: true, errors: [] }` on success.
+ */
+export function validateToolInput(schema, input) {
+    const errors = [];
+    const obj = (input ?? {});
+    if (typeof obj !== "object" || obj === null || Array.isArray(obj)) {
+        return { valid: false, errors: ["Input must be an object"] };
+    }
+    // Required fields
+    if (schema.required) {
+        for (const key of schema.required) {
+            if (!(key in obj) || obj[key] === undefined) {
+                errors.push(`Missing required property: ${key}`);
+            }
+        }
+    }
+    // Property type + enum checks
+    for (const [key, propSchema] of Object.entries(schema.properties)) {
+        const value = obj[key];
+        if (value === undefined || value === null)
+            continue; // skip optional absent
+        // Type check (with coercion attempt for strings→numbers from LLM)
+        const checker = TYPE_CHECKS[propSchema.type];
+        if (checker && !checker(value)) {
+            // Try coercing string→number if the schema expects a number
+            if ((propSchema.type === "number" || propSchema.type === "integer") &&
+                typeof value === "string") {
+                const num = Number(value);
+                if (!Number.isNaN(num)) {
+                    obj[key] = num;
+                    // Re-check integer constraint
+                    if (propSchema.type === "integer" && !Number.isInteger(num)) {
+                        errors.push(`Property '${key}' must be an integer, got ${num}`);
+                    }
+                    continue;
+                }
+            }
+            // Try coercing string→boolean
+            if (propSchema.type === "boolean" && typeof value === "string") {
+                if (value === "true") {
+                    obj[key] = true;
+                    continue;
+                }
+                if (value === "false") {
+                    obj[key] = false;
+                    continue;
+                }
+            }
+            // Try parsing JSON string→object/array
+            if ((propSchema.type === "object" || propSchema.type === "array") &&
+                typeof value === "string") {
+                try {
+                    const parsed = JSON.parse(value);
+                    if (checker(parsed)) {
+                        obj[key] = parsed;
+                        continue;
+                    }
+                }
+                catch { /* not valid JSON, fall through */ }
+            }
+            errors.push(`Property '${key}' expected type '${propSchema.type}', got '${typeof value}'`);
+        }
+        // Enum check
+        if (propSchema.enum && propSchema.enum.length > 0) {
+            const current = obj[key]; // may have been coerced
+            if (!propSchema.enum.includes(String(current))) {
+                errors.push(`Property '${key}' must be one of [${propSchema.enum.join(", ")}], got '${current}'`);
+            }
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+//# sourceMappingURL=validate.js.map

package/dist/tools/validate.js.map

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

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

@@ -0,0 +1,8 @@
+import type { ToolDefinition } from "./contracts.js";
+import type { VoiceService } from "../voice/service.js";
+interface SpeakInput {
+    text: string;
+}
+export declare function createVoiceSpeakTool(voiceService: VoiceService): ToolDefinition<SpeakInput>;
+export {};
+//# sourceMappingURL=voice-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"voice-tools.d.ts","sourceRoot":"","sources":["../../src/tools/voice-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,YAAY,GAAG,cAAc,CAAC,UAAU,CAAC,CA8B3F"}

package/dist/tools/voice-tools.js

@@ -0,0 +1,32 @@
+export function createVoiceSpeakTool(voiceService) {
+    return {
+        name: "voice.speak",
+        description: "Speak text via the configured TTS output",
+        tier: "standard",
+        category: "voice",
+        source: "builtin",
+        parameters: {
+            type: "object",
+            properties: {
+                text: { type: "string", description: "Message to speak." },
+            },
+            required: ["text"],
+        },
+        async execute(input, context) {
+            const text = typeof input?.text === "string" ? input.text.trim() : "";
+            if (!text) {
+                return { ok: false, message: "text is required" };
+            }
+            const spoken = voiceService.speak({ sessionId: context.sessionId, text });
+            return {
+                ok: true,
+                message: "Spoken",
+                data: {
+                    mimeType: spoken.mimeType,
+                    bytes: spoken.audioBase64.length,
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=voice-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"voice-tools.js","sourceRoot":"","sources":["../../src/tools/voice-tools.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,oBAAoB,CAAC,YAA0B;IAC7D,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,0CAA0C;QACvD,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,OAAO;QACjB,MAAM,EAAE,SAAS;QACjB,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;aAC3D;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;SACnB;QACD,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO;YAC1B,MAAM,IAAI,GAAG,OAAO,KAAK,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtE,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;YACpD,CAAC;YACD,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1E,OAAO;gBACL,EAAE,EAAE,IAAI;gBACR,OAAO,EAAE,QAAQ;gBACjB,IAAI,EAAE;oBACJ,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM;iBACjC;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/voice/service.d.ts

@@ -0,0 +1,42 @@
+import type { ConsentManager } from "../security/consent-manager.js";
+export interface VoiceState {
+    sessionId: string;
+    wakeWordEnabled: boolean;
+    talkModeEnabled: boolean;
+    listening: boolean;
+    lastTranscriptAt?: string;
+    lastSpokenAt?: string;
+}
+export interface TranscriptionResult {
+    text: string;
+    wakeWordDetected: boolean;
+    sentToAgent: boolean;
+}
+export declare class VoiceService {
+    private readonly bySession;
+    getState(sessionId: string): VoiceState;
+    updateState(sessionId: string, patch: Partial<Omit<VoiceState, "sessionId">>): VoiceState;
+    transcribe(input: {
+        transcript?: string;
+        audioBase64?: string;
+        sessionId: string;
+    }): TranscriptionResult;
+    speak(input: {
+        sessionId: string;
+        text: string;
+    }): {
+        ok: true;
+        audioBase64: string;
+        mimeType: string;
+    };
+    resolveConsentFromUtterance(consentManager: ConsentManager, input: {
+        text: string;
+        sessionId?: string;
+    }): {
+        handled: boolean;
+        approved?: boolean;
+        requestId?: string;
+    };
+    private decodeAudioAsText;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/voice/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/voice/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAErE,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;IAE3D,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU;IAavC,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,GAAG,UAAU;IAOzF,UAAU,CAAC,KAAK,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,mBAAmB;IAoBxG,KAAK,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;IAStG,2BAA2B,CACzB,cAAc,EAAE,cAAc,EAC9B,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1C;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;IAoB/D,OAAO,CAAC,iBAAiB;CAQ1B"}

package/dist/voice/service.js

@@ -0,0 +1,75 @@
+export class VoiceService {
+    bySession = new Map();
+    getState(sessionId) {
+        const existing = this.bySession.get(sessionId);
+        if (existing)
+            return existing;
+        const created = {
+            sessionId,
+            wakeWordEnabled: true,
+            talkModeEnabled: false,
+            listening: false,
+        };
+        this.bySession.set(sessionId, created);
+        return created;
+    }
+    updateState(sessionId, patch) {
+        const current = this.getState(sessionId);
+        const next = { ...current, ...patch, sessionId };
+        this.bySession.set(sessionId, next);
+        return next;
+    }
+    transcribe(input) {
+        const text = (input.transcript ?? this.decodeAudioAsText(input.audioBase64) ?? "").trim();
+        const wakeWordDetected = /\bhey\s+jait\b/i.test(text);
+        const state = this.getState(input.sessionId);
+        if (wakeWordDetected && state.wakeWordEnabled) {
+            this.updateState(input.sessionId, { listening: true });
+        }
+        if (text.length > 0) {
+            this.updateState(input.sessionId, { lastTranscriptAt: new Date().toISOString() });
+        }
+        return {
+            text,
+            wakeWordDetected,
+            sentToAgent: text.length > 0,
+        };
+    }
+    speak(input) {
+        this.updateState(input.sessionId, { lastSpokenAt: new Date().toISOString() });
+        return {
+            ok: true,
+            audioBase64: Buffer.from(input.text, "utf8").toString("base64"),
+            mimeType: "text/plain;base64",
+        };
+    }
+    resolveConsentFromUtterance(consentManager, input) {
+        const normalized = input.text.trim().toLowerCase();
+        const pending = consentManager.listPending(input.sessionId);
+        if (pending.length === 0)
+            return { handled: false };
+        const target = pending[0];
+        if (!target)
+            return { handled: false };
+        if (/^yes\b/.test(normalized)) {
+            consentManager.approve(target.id, "voice", input.text);
+            return { handled: true, approved: true, requestId: target.id };
+        }
+        if (/^(no|stop)\b/.test(normalized)) {
+            consentManager.reject(target.id, "voice", input.text);
+            return { handled: true, approved: false, requestId: target.id };
+        }
+        return { handled: false };
+    }
+    decodeAudioAsText(audioBase64) {
+        if (!audioBase64)
+            return null;
+        try {
+            return Buffer.from(audioBase64, "base64").toString("utf8");
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/voice/service.js.map

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

package/dist/ws.d.ts

@@ -0,0 +1,90 @@
+import type { WsEvent } from "@jait/shared";
+import type { UICommandPayload } from "@jait/shared";
+import type { ScreenShareSessionState, FsNode, FsBrowseEntry } from "@jait/shared";
+import type { AppConfig } from "./config.js";
+import type { Server as HttpServer } from "node:http";
+export declare class WsControlPlane {
+    private config;
+    private wss;
+    private clients;
+    private jwtSecret;
+    /** Filesystem nodes registered by clients (keyed by node ID) */
+    private fsNodes;
+    /** Pending fs browse requests waiting for a response from a remote node */
+    private pendingFsBrowse;
+    constructor(config: AppConfig);
+    /**
+     * Attach the WebSocket server to an existing HTTP server (shares port).
+     * Falls back to standalone port if no httpServer is provided.
+     */
+    start(httpServer?: HttpServer): void;
+    private extractBearerToken;
+    private authenticateClient;
+    private handleMessage;
+    /** Send an event to a specific client by ID */
+    sendToClient(clientId: string, event: WsEvent): void;
+    /** Broadcast an event to all clients subscribed to a session */
+    broadcast(sessionId: string, event: WsEvent): void;
+    /** Broadcast to all connected clients */
+    broadcastAll(event: WsEvent): void;
+    /** Send a typed UI command to all clients subscribed to the session (server → frontend) */
+    sendUICommand(command: UICommandPayload, sessionId?: string): void;
+    /**
+     * Broadcast to all clients subscribed to a session, excluding one client.
+     * Used to relay state changes to other clients without echoing back to the sender.
+     */
+    broadcastExcluding(sessionId: string, excludeClientId: string, event: WsEvent): void;
+    /** Send terminal output data to all clients subscribed to this terminal */
+    broadcastTerminalOutput(terminalId: string, data: string): void;
+    /** Callback for terminal input from WS clients */
+    onTerminalInput?: (terminalId: string, data: string) => void;
+    /** Callback for terminal resize from WS clients */
+    onTerminalResize?: (terminalId: string, cols: number, rows: number) => void;
+    /** Callback to replay buffered output when a client subscribes to a terminal */
+    onTerminalReplay?: (terminalId: string) => string | null;
+    /** Callback for consent approval from WS clients */
+    onConsentApprove?: (requestId: string) => void;
+    /** Callback for consent rejection from WS clients */
+    onConsentReject?: (requestId: string, reason?: string) => void;
+    /** Callback when a client updates UI component state (panel open/close) */
+    onUIStateUpdate?: (sessionId: string, key: string, value: unknown | null, clientId: string) => void;
+    /** Callback when a client subscribes to a session — used to push full state */
+    onClientSubscribe?: (sessionId: string, clientId: string) => void;
+    /** Callback when a screen-share start is requested via WS */
+    onScreenShareStart?: (hostDeviceId: string, viewerDeviceIds?: string[]) => void;
+    /** Callback when a screen-share stop is requested via WS */
+    onScreenShareStop?: (sessionId: string) => void;
+    /** Relay a signaling message to a specific device ID */
+    private relayToDevice;
+    /** Broadcast a screen-share state update to all connected clients */
+    broadcastScreenShareState(state: ScreenShareSessionState): void;
+    /**
+     * Programmatically send a screen-share start-request to all connected clients.
+     * Used by tools/routes when the session is created server-side and the host
+     * device needs to be told to begin capture.
+     */
+    sendScreenShareStartRequest(sessionId: string, hostDeviceId: string, viewerDeviceIds?: string[]): void;
+    /** Find all connected device IDs */
+    getConnectedDeviceIds(): string[];
+    /** List all registered filesystem nodes */
+    getFsNodes(): FsNode[];
+    /** Register the gateway itself as a filesystem node */
+    registerGatewayFsNode(node: FsNode): void;
+    /**
+     * Proxy a browse request to a remote filesystem node.
+     * Sends a WS message to the owning client and waits for a response.
+     */
+    proxyFsBrowse(nodeId: string, path: string): Promise<{
+        path: string;
+        parent: string | null;
+        entries: FsBrowseEntry[];
+    }>;
+    /**
+     * Proxy a roots request to a remote filesystem node.
+     */
+    proxyFsRoots(nodeId: string): Promise<FsBrowseEntry[]>;
+    get clientCount(): number;
+    private send;
+    stop(): void;
+}
+//# sourceMappingURL=ws.d.ts.map