@alpha-clients/terminal 0.1.0

package/README.md

@@ -0,0 +1,23 @@
+# @alpha-clients/terminal
+
+Terminal client for Alpha client-side MCP tools.
+
+Run it directly with `npx`:
+
+```sh
+npx @alpha-clients/terminal
+npx @alpha-clients/terminal -- --env test
+```
+
+When installed globally or linked locally, the executable name is `terminal`.
+`device-mcp-terminal` is also installed as a compatibility alias.
+
+```sh
+terminal --env test
+terminal --base-url http://localhost:3000
+terminal --scope ~/Downloads/projects --allowed git --allowed node
+terminal --include ~/Downloads/projects --allow bash
+terminal --clear-tokens
+```
+
+The client defaults to the live portal and unrestricted command access.

package/dist/commandRunner.d.ts

@@ -0,0 +1,23 @@
+import type { TerminalConfig } from "./config.js";
+export interface RunCommandInput {
+    readonly command: string;
+    readonly args?: readonly string[];
+    readonly cwd?: string;
+    readonly timeoutMs?: number;
+}
+export interface RunCommandResult {
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly cwd: string;
+    readonly exitCode: number | null;
+    readonly signal: string | null;
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly durationMs: number;
+    readonly timedOut: boolean;
+}
+export declare function resolveCommandCwd(config: Pick<TerminalConfig, "scopes">, requestedCwd?: string): string;
+export declare function assertCommandAllowed(command: string, allowedCommands: readonly string[]): void;
+export declare function executeCommand(config: TerminalConfig, input: RunCommandInput): Promise<RunCommandResult>;
+export declare function isWithinScope(candidatePath: string, scopeRoot: string): boolean;
+//# sourceMappingURL=commandRunner.d.ts.map

package/dist/commandRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandRunner.d.ts","sourceRoot":"","sources":["../src/commandRunner.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAKD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAavG;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAS9F;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA4H9G;AAED,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAK/E"}

package/dist/commandRunner.js

@@ -0,0 +1,163 @@
+import { realpathSync } from "node:fs";
+import { spawn } from "node:child_process";
+import path from "node:path";
+import { DEFAULT_TIMEOUT_MS, MAX_TIMEOUT_MS } from "./constants.js";
+import { createSandboxedExecution } from "./macosSandbox.js";
+const WINDOWS_EXECUTABLE_EXTENSIONS = new Set([".exe", ".cmd", ".bat", ".com"]);
+const STREAM_DRAIN_GRACE_MS = 100;
+export function resolveCommandCwd(config, requestedCwd) {
+    const baseCwd = requestedCwd ?? config.scopes[0] ?? process.cwd();
+    const resolvedPath = path.resolve(baseCwd);
+    const canonicalPath = canonicalizePathForComparison(resolvedPath);
+    if (config.scopes.length > 0) {
+        const isAllowed = config.scopes.some((scopeRoot) => isWithinScope(canonicalPath, scopeRoot));
+        if (!isAllowed) {
+            throw new Error(`Working directory is outside allowed scopes: ${resolvedPath}`);
+        }
+    }
+    return resolvedPath;
+}
+export function assertCommandAllowed(command, allowedCommands) {
+    const requestedCommand = normalizeCommandName(path.basename(command));
+    if (allowedCommands.length > 0 &&
+        !allowedCommands.some((candidate) => normalizeCommandName(path.basename(candidate)) === requestedCommand)) {
+        throw new Error(`Command is not allowed: ${command}`);
+    }
+}
+export async function executeCommand(config, input) {
+    if (!input.command.trim()) {
+        throw new Error("command must be a non-empty string.");
+    }
+    assertCommandAllowed(input.command, config.allowedCommands);
+    const cwd = resolveCommandCwd(config, input.cwd);
+    const args = [...(input.args ?? [])];
+    const timeoutMs = input.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    if (timeoutMs > MAX_TIMEOUT_MS) {
+        throw new Error(`timeoutMs must be at most ${MAX_TIMEOUT_MS}.`);
+    }
+    if (timeoutMs <= 0) {
+        throw new Error("timeoutMs must be greater than 0.");
+    }
+    const sandboxedExecution = createSandboxedExecution(config.scopes, cwd, input.command, args);
+    const startedAt = Date.now();
+    let timedOut = false;
+    let settled = false;
+    let stdout = "";
+    let stderr = "";
+    let exitCode = null;
+    let signal = null;
+    let exited = false;
+    let stdoutEnded = false;
+    let stderrEnded = false;
+    let forceKillTimer;
+    let streamDrainGraceTimer;
+    const child = spawn(sandboxedExecution?.command ?? input.command, sandboxedExecution?.args ?? args, {
+        cwd,
+        env: sandboxedExecution?.env ?? process.env,
+        shell: false,
+        windowsHide: true,
+        stdio: ["ignore", "pipe", "pipe"]
+    });
+    child.stdout.setEncoding("utf8");
+    child.stderr.setEncoding("utf8");
+    return await new Promise((resolve, reject) => {
+        const timeoutHandle = setTimeout(() => {
+            timedOut = true;
+            child.kill();
+            forceKillTimer = setTimeout(() => {
+                if (!child.killed) {
+                    child.kill("SIGKILL");
+                }
+            }, 5_000);
+        }, timeoutMs);
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk;
+        });
+        child.stdout.once("end", () => {
+            stdoutEnded = true;
+            settleIfReady();
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk;
+        });
+        child.stderr.once("end", () => {
+            stderrEnded = true;
+            settleIfReady();
+        });
+        child.once("error", (error) => {
+            cleanup();
+            if (!settled) {
+                settled = true;
+                reject(new Error(`Failed to start command "${input.command}": ${error.message}`));
+            }
+        });
+        child.once("exit", (childExitCode, childSignal) => {
+            exited = true;
+            exitCode = childExitCode;
+            signal = childSignal;
+            streamDrainGraceTimer = setTimeout(() => {
+                child.stdout.destroy();
+                child.stderr.destroy();
+                stdoutEnded = true;
+                stderrEnded = true;
+                settleIfReady();
+            }, STREAM_DRAIN_GRACE_MS);
+            settleIfReady();
+        });
+        function cleanup() {
+            clearTimeout(timeoutHandle);
+            if (forceKillTimer) {
+                clearTimeout(forceKillTimer);
+            }
+            if (streamDrainGraceTimer) {
+                clearTimeout(streamDrainGraceTimer);
+            }
+            sandboxedExecution?.cleanup();
+        }
+        function settleIfReady() {
+            if (!exited || settled || !stdoutEnded || !stderrEnded) {
+                return;
+            }
+            cleanup();
+            settled = true;
+            resolve({
+                command: input.command,
+                args,
+                cwd,
+                exitCode,
+                signal,
+                stdout,
+                stderr,
+                durationMs: Date.now() - startedAt,
+                timedOut
+            });
+        }
+    });
+}
+export function isWithinScope(candidatePath, scopeRoot) {
+    const canonicalCandidatePath = canonicalizePathForComparison(candidatePath);
+    const canonicalScopeRoot = canonicalizePathForComparison(scopeRoot);
+    const relativePath = path.relative(canonicalScopeRoot, canonicalCandidatePath);
+    return relativePath === "" || (!relativePath.startsWith("..") && !path.isAbsolute(relativePath));
+}
+function canonicalizePathForComparison(inputPath) {
+    const resolvedPath = path.resolve(inputPath);
+    try {
+        return realpathSync.native(resolvedPath);
+    }
+    catch {
+        return resolvedPath;
+    }
+}
+function normalizeCommandName(command) {
+    const normalized = process.platform === "win32" ? command.toLowerCase() : command;
+    if (process.platform !== "win32") {
+        return normalized;
+    }
+    const extension = path.extname(normalized);
+    if (WINDOWS_EXECUTABLE_EXTENSIONS.has(extension)) {
+        return normalized.slice(0, -extension.length);
+    }
+    return normalized;
+}
+//# sourceMappingURL=commandRunner.js.map

package/dist/commandRunner.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,22 @@
+import { type PortalEnv } from "./constants.js";
+export interface TerminalConfig {
+    readonly baseUrl: string;
+    readonly env?: PortalEnv;
+    readonly name: string;
+    readonly scopes: readonly string[];
+    readonly allowedCommands: readonly string[];
+    readonly clearTokens: boolean;
+    readonly tokenPath: string;
+}
+interface ParseCliArgsOptions {
+    readonly homeDir?: string;
+}
+export declare class HelpRequestedError extends Error {
+    readonly helpText: string;
+    constructor(helpText: string);
+}
+export declare function parseCliArgs(argv: readonly string[], options?: ParseCliArgsOptions): TerminalConfig;
+export declare function formatCliHelp(): string;
+export declare function formatStartupSummary(config: TerminalConfig): string[];
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAKA,OAAO,EAAmC,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEjF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,QAAQ,EAAE,MAAM;CAK7B;AAgBD,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,GAAE,mBAAwB,GAAG,cAAc,CA2DvG;AAED,wBAAgB,aAAa,IAAI,MAAM,CAsBtC;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE,CAQrE"}

package/dist/config.js

@@ -0,0 +1,178 @@
+import { createHash } from "node:crypto";
+import { existsSync, realpathSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { parseArgs } from "node:util";
+import { DEFAULT_PORTAL_ENV, PORTAL_ENVS } from "./constants.js";
+export class HelpRequestedError extends Error {
+    helpText;
+    constructor(helpText) {
+        super("CLI help requested.");
+        this.name = "HelpRequestedError";
+        this.helpText = helpText;
+    }
+}
+const VALID_OPTION_NAMES = new Set([
+    "help",
+    "env",
+    "base-url",
+    "baseUrl",
+    "scope",
+    "include",
+    "allowed",
+    "allow",
+    "name",
+    "clear-tokens",
+    "clearTokens"
+]);
+export function parseCliArgs(argv, options = {}) {
+    const normalizedArgv = argv[0] === "--" ? argv.slice(1) : argv;
+    const parsed = parseArgs({
+        args: [...normalizedArgv],
+        strict: false,
+        allowPositionals: true,
+        tokens: true,
+        options: {
+            help: { type: "boolean", short: "h" },
+            env: { type: "string" },
+            "base-url": { type: "string" },
+            baseUrl: { type: "string" },
+            scope: { type: "string", multiple: true },
+            include: { type: "string", multiple: true },
+            allowed: { type: "string", multiple: true },
+            allow: { type: "string", multiple: true },
+            name: { type: "string" },
+            "clear-tokens": { type: "boolean" },
+            clearTokens: { type: "boolean" }
+        }
+    });
+    if (parsed.values.help) {
+        throw new HelpRequestedError(formatCliHelp());
+    }
+    const unknownOptions = parsed.tokens.flatMap((token) => token.kind === "option" && !VALID_OPTION_NAMES.has(token.name) ? [token.rawName] : []);
+    if (unknownOptions.length > 0) {
+        throw new Error(`Unknown option(s): ${unknownOptions.join(", ")}`);
+    }
+    const positionalEnv = parsed.positionals[0];
+    if (parsed.positionals.length > 1 || (positionalEnv && !isPortalEnv(positionalEnv))) {
+        throw new Error(`Unexpected positional argument(s): ${parsed.positionals.join(", ")}`);
+    }
+    const envValue = parseEnvValue(coerceOptionalString(parsed.values.env) ?? positionalEnv ?? DEFAULT_PORTAL_ENV);
+    const explicitBaseUrl = coerceOptionalString(parsed.values["base-url"]) ?? coerceOptionalString(parsed.values.baseUrl);
+    const baseUrl = normalizeBaseUrl(explicitBaseUrl ?? PORTAL_ENVS[envValue]);
+    const scopes = normalizePathList([...coerceStringList(parsed.values.scope), ...coerceStringList(parsed.values.include)]);
+    const allowedCommands = normalizeCommandList([
+        ...coerceStringList(parsed.values.allowed),
+        ...coerceStringList(parsed.values.allow)
+    ]);
+    const name = coerceOptionalString(parsed.values.name) ?? `Device MCP Terminal (${os.hostname()})`;
+    const clearTokens = Boolean(parsed.values["clear-tokens"] || parsed.values.clearTokens);
+    const tokenPath = buildTokenPath(baseUrl, options.homeDir ?? os.homedir());
+    return {
+        baseUrl,
+        env: explicitBaseUrl ? undefined : envValue,
+        name,
+        scopes,
+        allowedCommands,
+        clearTokens,
+        tokenPath
+    };
+}
+export function formatCliHelp() {
+    return [
+        "Usage: terminal [options]",
+        "       npx @alpha-clients/terminal -- [options]",
+        "",
+        "Options:",
+        "  -h, --help                  Print this help and exit",
+        "  --env <test|staging|live>   Portal environment. Defaults to live",
+        "  --base-url <url>            Explicit portal base URL",
+        "  --scope <path>              Repeatable. Restrict run_command to allowed root directories",
+        "  --include <path>            Alias for --scope",
+        "  --allowed <command>         Repeatable. Restrict run_command.command to allowed executables",
+        "  --allow <command>           Alias for --allowed",
+        "  --name <name>               Client display name",
+        "  --clear-tokens              Clear stored credentials before connecting",
+        "",
+        "Examples:",
+        "  npx @alpha-clients/terminal",
+        "  npx @alpha-clients/terminal -- --env test",
+        `  terminal --scope ${path.join(os.homedir(), "Downloads")} --allowed git --allowed node`,
+        "  terminal --base-url http://localhost:3000 --clear-tokens"
+    ].join("\n");
+}
+export function formatStartupSummary(config) {
+    return [
+        `Device MCP terminal client: ${config.name}`,
+        `Portal: ${config.baseUrl}`,
+        `Token store: ${config.tokenPath}`,
+        `Access scope: ${config.scopes.length > 0 ? config.scopes.join(", ") : "unrestricted"}`,
+        `Allowed commands: ${config.allowedCommands.length > 0 ? config.allowedCommands.join(", ") : "all"}`
+    ];
+}
+function parseEnvValue(value) {
+    if (!isPortalEnv(value)) {
+        throw new Error(`Unknown environment: ${value}. Expected one of: ${Object.keys(PORTAL_ENVS).join(", ")}`);
+    }
+    return value;
+}
+function isPortalEnv(value) {
+    return Object.hasOwn(PORTAL_ENVS, value);
+}
+function coerceOptionalString(value) {
+    if (value === undefined || value === false) {
+        return undefined;
+    }
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new Error("Expected a non-empty string value for the provided option.");
+    }
+    return value.trim();
+}
+function coerceStringList(value) {
+    if (value === undefined || value === false) {
+        return [];
+    }
+    const values = Array.isArray(value) ? value : [value];
+    return values.map((entry) => {
+        if (typeof entry !== "string" || entry.trim().length === 0) {
+            throw new Error("Expected a non-empty string value for the provided option.");
+        }
+        return entry.trim();
+    });
+}
+function normalizePathList(values) {
+    return [...new Set(values.map((entry) => resolveExistingDirectory(entry)))];
+}
+function normalizeCommandList(values) {
+    return [...new Set(values.map((entry) => entry.trim()).filter(Boolean))];
+}
+function resolveExistingDirectory(inputPath) {
+    const resolvedPath = path.resolve(inputPath);
+    if (!existsSync(resolvedPath)) {
+        throw new Error(`Path does not exist: ${inputPath}`);
+    }
+    try {
+        return realpathSync.native(resolvedPath);
+    }
+    catch {
+        return resolvedPath;
+    }
+}
+function normalizeBaseUrl(value) {
+    const trimmed = value.trim().replace(/\/+$/, "");
+    if (/^https?:\/\//i.test(trimmed)) {
+        return trimmed;
+    }
+    if (/^ws:\/\//i.test(trimmed)) {
+        return `http://${trimmed.slice("ws://".length)}`;
+    }
+    if (/^wss:\/\//i.test(trimmed)) {
+        return `https://${trimmed.slice("wss://".length)}`;
+    }
+    return `https://${trimmed}`;
+}
+function buildTokenPath(baseUrl, homeDir) {
+    const digest = createHash("sha256").update(baseUrl).digest("hex").slice(0, 16);
+    return path.join(homeDir, ".device-mcp", "terminal-tokens", `${digest}.json`);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,10 @@
+export declare const PORTAL_ENVS: {
+    readonly test: "https://ai.test.insea.io";
+    readonly staging: "https://ai.staging.insea.io";
+    readonly live: "https://ai.insea.io";
+};
+export type PortalEnv = keyof typeof PORTAL_ENVS;
+export declare const DEFAULT_PORTAL_ENV: PortalEnv;
+export declare const DEFAULT_TIMEOUT_MS = 30000;
+export declare const MAX_TIMEOUT_MS = 900000;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW;;;;CAId,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,WAAW,CAAC;AAEjD,eAAO,MAAM,kBAAkB,EAAE,SAAkB,CAAC;AACpD,eAAO,MAAM,kBAAkB,QAAS,CAAC;AACzC,eAAO,MAAM,cAAc,SAAU,CAAC"}

package/dist/constants.js

@@ -0,0 +1,9 @@
+export const PORTAL_ENVS = {
+    test: "https://ai.test.insea.io",
+    staging: "https://ai.staging.insea.io",
+    live: "https://ai.insea.io"
+};
+export const DEFAULT_PORTAL_ENV = "live";
+export const DEFAULT_TIMEOUT_MS = 30_000;
+export const MAX_TIMEOUT_MS = 900_000;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,0BAA0B;IAChC,OAAO,EAAE,6BAA6B;IACtC,IAAI,EAAE,qBAAqB;CACnB,CAAC;AAIX,MAAM,CAAC,MAAM,kBAAkB,GAAc,MAAM,CAAC;AACpD,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AACzC,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC"}

package/dist/deviceInfo.d.ts

@@ -0,0 +1,3 @@
+import type { JsonObject } from "@alpha-clients/client-connection";
+export declare function getDeviceInfo(): JsonObject;
+//# sourceMappingURL=deviceInfo.d.ts.map

package/dist/deviceInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deviceInfo.d.ts","sourceRoot":"","sources":["../src/deviceInfo.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAEnE,wBAAgB,aAAa,IAAI,UAAU,CAW1C"}

package/dist/deviceInfo.js

@@ -0,0 +1,14 @@
+import os from "node:os";
+export function getDeviceInfo() {
+    return {
+        platform: process.platform,
+        type: os.type(),
+        release: os.release(),
+        version: os.version(),
+        arch: process.arch,
+        hostname: os.hostname(),
+        nodeVersion: process.version,
+        cwd: process.cwd()
+    };
+}
+//# sourceMappingURL=deviceInfo.js.map

package/dist/deviceInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deviceInfo.js","sourceRoot":"","sources":["../src/deviceInfo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAGzB,MAAM,UAAU,aAAa;IAC3B,OAAO;QACL,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE;QACf,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE;QACrB,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE;QACrB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE;QACvB,WAAW,EAAE,OAAO,CAAC,OAAO;QAC5B,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;KACnB,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+import process from "node:process";
+import WebSocket from "ws";
+import { CLIENT_TYPE_DESKTOP, DeviceMcpClient } from "@alpha-clients/client-connection";
+import { HelpRequestedError, formatStartupSummary, parseCliArgs } from "./config.js";
+import { createFileTokenStore } from "./tokenStore.js";
+import { getDeviceInfo } from "./deviceInfo.js";
+import { createTerminalTools } from "./tools.js";
+const RECONNECT_DELAY_MS = 2_000;
+async function main() {
+    const config = parseCliArgs(process.argv.slice(2));
+    const tokenStore = createFileTokenStore(config.tokenPath);
+    if (config.clearTokens) {
+        await tokenStore.clear();
+    }
+    for (const line of formatStartupSummary(config)) {
+        console.log(line);
+    }
+    let stopped = false;
+    let activeClient;
+    const shutdown = (signal) => {
+        stopped = true;
+        console.log(`Received ${signal}, shutting down.`);
+        activeClient?.disconnect(1000, signal);
+        process.exit(0);
+    };
+    process.on("SIGINT", () => shutdown("SIGINT"));
+    process.on("SIGTERM", () => shutdown("SIGTERM"));
+    while (!stopped) {
+        activeClient = new DeviceMcpClient({
+            baseUrl: config.baseUrl,
+            clientType: CLIENT_TYPE_DESKTOP,
+            name: config.name,
+            deviceInfo: getDeviceInfo(),
+            authorizationMode: "header",
+            tokenStore,
+            fetch,
+            webSocketFactory(url, options) {
+                console.log(`[device-mcp-terminal] connecting ${url}`);
+                return new WebSocket(url, {
+                    headers: options?.headers
+                });
+            },
+            onAuthSession(session) {
+                console.log(`[device-mcp-terminal] auth session ${session.authSessionId} expiresAt=${session.expiresAt}`);
+            },
+            openLoginUrl(loginUrl) {
+                console.log("");
+                console.log("Open this URL in your browser and complete login:");
+                console.log(loginUrl);
+                console.log("");
+            },
+            logger: consoleLogger(),
+            tools: createTerminalTools(config)
+        });
+        try {
+            const result = await activeClient.connect();
+            console.log(`[device-mcp-terminal] connected clientId=${result.client.clientId}`);
+            await waitForSocketClose(result.socket);
+            if (!stopped) {
+                console.warn(`[device-mcp-terminal] connection closed; reconnecting in ${RECONNECT_DELAY_MS}ms.`);
+                await sleep(RECONNECT_DELAY_MS);
+            }
+        }
+        catch (error) {
+            if (stopped) {
+                return;
+            }
+            console.error("[device-mcp-terminal] connection failed");
+            console.error(formatLogData(error));
+            await sleep(RECONNECT_DELAY_MS);
+        }
+        finally {
+            activeClient.disconnect();
+            activeClient = undefined;
+        }
+    }
+}
+main().catch((error) => {
+    if (error instanceof HelpRequestedError) {
+        console.log(error.helpText);
+        process.exit(0);
+    }
+    console.error(formatLogData(error));
+    process.exit(1);
+});
+function waitForSocketClose(socket) {
+    return new Promise((resolve) => {
+        if (socket.readyState === 3) {
+            resolve();
+            return;
+        }
+        if (socket.addEventListener) {
+            socket.addEventListener("close", () => resolve());
+            socket.addEventListener("error", () => resolve());
+            return;
+        }
+        socket.once?.("close", () => resolve());
+        socket.once?.("error", () => resolve());
+    });
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function consoleLogger() {
+    return {
+        debug: (message, data) => log("debug", message, data),
+        info: (message, data) => log("info", message, data),
+        warn: (message, data) => log("warn", message, data),
+        error: (message, data) => log("error", message, data)
+    };
+}
+function log(level, message, data) {
+    const suffix = data === undefined ? "" : ` ${formatLogData(data)}`;
+    console[level](`[device-mcp-terminal] ${message}${suffix}`);
+}
+function formatLogData(data) {
+    if (data instanceof Error) {
+        return data.stack ?? data.message;
+    }
+    try {
+        return JSON.stringify(data);
+    }
+    catch {
+        return String(data);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/macosSandbox.d.ts

@@ -0,0 +1,15 @@
+export interface SandboxedExecution {
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly env: NodeJS.ProcessEnv;
+    cleanup(): void;
+}
+export declare function createSandboxedExecution(scopes: readonly string[], cwd: string, command: string, args: readonly string[]): SandboxedExecution | undefined;
+interface MacOsSeatbeltProfileOptions {
+    readonly scopeRoots: readonly string[];
+    readonly extraReadRoots: readonly string[];
+    readonly commandTempDir: string;
+}
+export declare function createMacOsSeatbeltProfile(options: MacOsSeatbeltProfileOptions): string;
+export {};
+//# sourceMappingURL=macosSandbox.d.ts.map

package/dist/macosSandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"macosSandbox.d.ts","sourceRoot":"","sources":["../src/macosSandbox.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,kBAAkB,GAAG,SAAS,CA0BhC;AAED,UAAU,2BAA2B;IACnC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,2BAA2B,GAAG,MAAM,CAqBvF"}

package/dist/macosSandbox.js

@@ -0,0 +1,89 @@
+import { existsSync, mkdirSync, realpathSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+const SANDBOX_EXECUTABLE = "/usr/bin/sandbox-exec";
+const SYSTEM_READ_PATHS = ["/bin", "/dev", "/etc", "/Library", "/opt", "/private/etc", "/System", "/usr", "/usr/local"];
+const SYSTEM_TEMP_PATHS = ["/tmp", "/private/tmp"];
+export function createSandboxedExecution(scopes, cwd, command, args) {
+    if (process.platform !== "darwin" || scopes.length === 0 || !existsSync(SANDBOX_EXECUTABLE)) {
+        return undefined;
+    }
+    const commandTempDir = path.join(cwd, ".device-mcp-tmp");
+    mkdirSync(commandTempDir, { recursive: true });
+    const profile = createMacOsSeatbeltProfile({
+        scopeRoots: scopes.map((scopeRoot) => canonicalizePath(scopeRoot)),
+        extraReadRoots: resolveExecutableSearchPaths(process.env.PATH),
+        commandTempDir
+    });
+    return {
+        command: SANDBOX_EXECUTABLE,
+        args: ["-p", profile, command, ...args],
+        env: {
+            ...process.env,
+            HOME: cwd,
+            TEMP: commandTempDir,
+            TMP: commandTempDir,
+            TMPDIR: commandTempDir
+        },
+        cleanup() { }
+    };
+}
+export function createMacOsSeatbeltProfile(options) {
+    const allowedReadRoots = dedupePaths([
+        ...SYSTEM_READ_PATHS,
+        ...SYSTEM_TEMP_PATHS,
+        ...options.extraReadRoots,
+        ...options.scopeRoots,
+        options.commandTempDir
+    ]);
+    const allowedWriteRoots = dedupePaths([...options.scopeRoots, ...SYSTEM_TEMP_PATHS, options.commandTempDir]);
+    const metadataRoots = dedupePaths(collectAncestorPaths([...allowedReadRoots, ...allowedWriteRoots]));
+    const lines = ["(version 1)", "(deny default)", '(import "system.sb")', "(allow network*)", "(allow process*)"];
+    if (metadataRoots.length > 0) {
+        lines.push(formatRule("allow", "file-read-metadata", "literal", metadataRoots));
+    }
+    lines.push(formatRule("allow", "file-read*", "subpath", allowedReadRoots));
+    lines.push(formatRule("allow", "file-write*", "subpath", allowedWriteRoots));
+    return lines.join("\n");
+}
+function formatRule(action, operation, matcher, paths) {
+    return [`(${action} ${operation}`, ...paths.map((entry) => `  (${matcher} ${JSON.stringify(entry)})`), ")"].join("\n");
+}
+function collectAncestorPaths(paths) {
+    const ancestors = new Set();
+    for (const inputPath of paths) {
+        const resolvedPath = canonicalizePath(inputPath);
+        let currentPath = path.dirname(resolvedPath);
+        while (currentPath !== path.dirname(currentPath)) {
+            ancestors.add(currentPath);
+            currentPath = path.dirname(currentPath);
+        }
+    }
+    return [...ancestors];
+}
+function resolveExecutableSearchPaths(pathValue) {
+    if (!pathValue) {
+        return [];
+    }
+    const homeDirectory = os.homedir();
+    return dedupePaths(pathValue
+        .split(path.delimiter)
+        .map((entry) => entry.trim())
+        .filter(Boolean)
+        .map((entry) => (entry.startsWith("~/") ? path.join(homeDirectory, entry.slice(2)) : entry))
+        .filter((entry) => path.isAbsolute(entry))
+        .map((entry) => canonicalizePath(entry)));
+}
+function dedupePaths(paths) {
+    return [...new Set(paths.map((entry) => canonicalizePath(entry)))];
+}
+function canonicalizePath(inputPath) {
+    const resolvedPath = path.resolve(inputPath);
+    try {
+        return realpathSync.native(resolvedPath);
+    }
+    catch {
+        return resolvedPath;
+    }
+}
+//# sourceMappingURL=macosSandbox.js.map

package/dist/macosSandbox.js.map

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

package/dist/tokenStore.d.ts

@@ -0,0 +1,3 @@
+import type { TokenStore } from "@alpha-clients/client-connection";
+export declare function createFileTokenStore(path: string): TokenStore;
+//# sourceMappingURL=tokenStore.d.ts.map

package/dist/tokenStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenStore.d.ts","sourceRoot":"","sources":["../src/tokenStore.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAe,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAEhF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAqB7D"}

package/dist/tokenStore.js

@@ -0,0 +1,28 @@
+import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+export function createFileTokenStore(path) {
+    return {
+        async load() {
+            try {
+                return JSON.parse(await readFile(path, "utf8"));
+            }
+            catch (error) {
+                if (isNodeError(error) && error.code === "ENOENT") {
+                    return null;
+                }
+                throw error;
+            }
+        },
+        async save(tokens) {
+            await mkdir(dirname(path), { recursive: true });
+            await writeFile(path, `${JSON.stringify(tokens, null, 2)}\n`, "utf8");
+        },
+        async clear() {
+            await rm(path, { force: true });
+        }
+    };
+}
+function isNodeError(error) {
+    return error instanceof Error;
+}
+//# sourceMappingURL=tokenStore.js.map

package/dist/tokenStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenStore.js","sourceRoot":"","sources":["../src/tokenStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO;QACL,KAAK,CAAC,IAAI;YACR,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAgB,CAAC;YACjE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAClD,OAAO,IAAI,CAAC;gBACd,CAAC;gBAED,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,MAAM;YACf,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAChD,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACxE,CAAC;QACD,KAAK,CAAC,KAAK;YACT,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAClC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,KAAK,YAAY,KAAK,CAAC;AAChC,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,5 @@
+import type { ClientTool, JsonObject } from "@alpha-clients/client-connection";
+import type { TerminalConfig } from "./config.js";
+export declare function createTerminalTools(config: TerminalConfig): ClientTool[];
+export declare function createInfoPayload(config: TerminalConfig): JsonObject;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,UAAU,EAAE,UAAU,EAAa,MAAM,kCAAkC,CAAC;AAI1G,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,UAAU,EAAE,CAExE;AA+DD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,UAAU,CAgBpE"}

package/dist/tools.js

@@ -0,0 +1,116 @@
+import { DEFAULT_TIMEOUT_MS, MAX_TIMEOUT_MS } from "./constants.js";
+import { executeCommand } from "./commandRunner.js";
+import { getDeviceInfo } from "./deviceInfo.js";
+export function createTerminalTools(config) {
+    return [createGetInfoTool(config), createRunCommandTool(config)];
+}
+function createGetInfoTool(config) {
+    return {
+        definition: {
+            name: "get_info",
+            description: "Get device info, access scope, and command whitelist for this terminal client.",
+            inputSchema: {
+                type: "object",
+                properties: {},
+                additionalProperties: false
+            }
+        },
+        handler() {
+            const structuredContent = createInfoPayload(config);
+            return jsonResult(structuredContent);
+        }
+    };
+}
+function createRunCommandTool(config) {
+    return {
+        definition: {
+            name: "run_command",
+            description: "Run a terminal command and return stdout and stderr.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    command: {
+                        type: "string",
+                        description: "Command executable to run."
+                    },
+                    args: {
+                        type: "array",
+                        items: {
+                            type: "string"
+                        },
+                        description: "Optional command arguments."
+                    },
+                    cwd: {
+                        type: "string",
+                        description: "Working directory for the command."
+                    },
+                    timeoutMs: {
+                        type: "number",
+                        description: `Optional timeout in milliseconds. Defaults to ${DEFAULT_TIMEOUT_MS}; max ${MAX_TIMEOUT_MS}.`
+                    }
+                },
+                required: ["command"],
+                additionalProperties: false
+            }
+        },
+        async handler(args) {
+            const input = parseRunCommandArgs(args);
+            const result = await executeCommand(config, input);
+            return jsonResult({
+                ...result,
+                args: [...result.args]
+            });
+        }
+    };
+}
+export function createInfoPayload(config) {
+    return {
+        deviceInfo: getDeviceInfo(),
+        runtime: {
+            defaultTimeoutMs: DEFAULT_TIMEOUT_MS,
+            maxTimeoutMs: MAX_TIMEOUT_MS
+        },
+        accessScope: {
+            unrestricted: config.scopes.length === 0,
+            roots: [...config.scopes]
+        },
+        commandWhitelist: {
+            unrestricted: config.allowedCommands.length === 0,
+            commands: [...config.allowedCommands]
+        }
+    };
+}
+function parseRunCommandArgs(args) {
+    if (typeof args.command !== "string" || args.command.trim().length === 0) {
+        throw new Error("command must be a non-empty string.");
+    }
+    const commandArgs = args.args;
+    if (commandArgs !== undefined && (!Array.isArray(commandArgs) || !commandArgs.every((entry) => typeof entry === "string"))) {
+        throw new Error("args must be an array of strings.");
+    }
+    if (args.cwd !== undefined && typeof args.cwd !== "string") {
+        throw new Error("cwd must be a string.");
+    }
+    const timeoutMs = args.timeoutMs;
+    if (timeoutMs !== undefined && (typeof timeoutMs !== "number" || !Number.isInteger(timeoutMs) || timeoutMs <= 0)) {
+        throw new Error("timeoutMs must be a positive integer.");
+    }
+    return {
+        command: args.command,
+        ...(commandArgs === undefined ? {} : { args: commandArgs }),
+        ...(args.cwd === undefined ? {} : { cwd: args.cwd }),
+        ...(timeoutMs === undefined ? {} : { timeoutMs })
+    };
+}
+function jsonResult(structuredContent) {
+    return {
+        structuredContent,
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(structuredContent, null, 2)
+            }
+        ]
+    };
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@alpha-clients/terminal",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Terminal client for Alpha client-side MCP tools.",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "terminal": "./dist/index.js",
+    "device-mcp-terminal": "./dist/index.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "start": "node dist/index.js",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@alpha-clients/client-connection": "workspace:^",
+    "ws": "^8.18.3"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.18.1"
+  }
+}