@hypertabai/mcp 0.2.0 → 1.0.0

package/dist/bridge/command-contract.d.ts

@@ -0,0 +1,14 @@
+export declare const BRIDGE_COMMAND_TYPES: readonly ["agent.status_request", "agent.prompt", "agent.cancel", "artifact.upload_request", "bridge.health_request"];
+export type BridgeCommandType = (typeof BRIDGE_COMMAND_TYPES)[number];
+export interface BridgeCommandContractResult {
+    allowed: boolean;
+    command_type: string;
+    reason?: string;
+    message?: string;
+}
+export declare function classifyBridgeCommandContract(input: {
+    command_type?: unknown;
+    payload?: unknown;
+}): BridgeCommandContractResult;
+export declare function isBridgeCommandType(value: string): value is BridgeCommandType;
+//# sourceMappingURL=command-contract.d.ts.map

package/dist/bridge/command-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-contract.d.ts","sourceRoot":"","sources":["../../src/bridge/command-contract.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,uHAMvB,CAAA;AAEV,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAA;AAErE,MAAM,WAAW,2BAA2B;IAC3C,OAAO,EAAE,OAAO,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AA+BD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACpD,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,OAAO,CAAC,EAAE,OAAO,CAAA;CACjB,GAAG,2BAA2B,CAsB9B;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,iBAAiB,CAE7E"}

package/dist/bridge/command-contract.js

@@ -0,0 +1,152 @@
+export const BRIDGE_COMMAND_TYPES = [
+    'agent.status_request',
+    'agent.prompt',
+    'agent.cancel',
+    'artifact.upload_request',
+    'bridge.health_request',
+];
+const DISALLOWED_COMMAND_TYPES = new Set([
+    'shell',
+    'exec',
+    'eval',
+    'run_script',
+    'write_file',
+    'delete_file',
+    'network_request',
+]);
+const DISALLOWED_PAYLOAD_KEYS = new Set([
+    'command',
+    'script',
+    'code',
+    'curl',
+    'sql',
+    'dangerously_execute',
+    'shell',
+    'exec',
+    'eval',
+    'run_script',
+    'write_file',
+    'delete_file',
+    'network_request',
+]);
+const SECRET_VALUE_PATTERN = /\b(?:ht_sk_[A-Za-z0-9_-]{16,}|sk_(?:live|test)_[A-Za-z0-9_-]{16,}|sk-[A-Za-z0-9_-]{16,}|ghp_[A-Za-z0-9_]{20,}|github_pat_[A-Za-z0-9_]{20,}|xox[baprs]-[A-Za-z0-9-]{20,}|AKIA[0-9A-Z]{16}|AIza[0-9A-Za-z_-]{25,}|ya29\.[0-9A-Za-z_-]{20,}|eyJ[A-Za-z0-9_-]{20,}\.[A-Za-z0-9_-]{20,})\b/;
+export function classifyBridgeCommandContract(input) {
+    const commandType = typeof input.command_type === 'string' ? input.command_type.trim() : '';
+    if (!commandType)
+        return rejected('', 'missing_command_type', 'Command is missing command_type.');
+    if (DISALLOWED_COMMAND_TYPES.has(commandType)) {
+        return rejected(commandType, 'execution_command_type', `Command type ${commandType} is direct execution and is not allowed.`);
+    }
+    if (!isBridgeCommandType(commandType)) {
+        return rejected(commandType, 'unknown_command_type', `Command type ${commandType} is not in the v1 allowlist.`);
+    }
+    const payload = asRecord(input.payload);
+    if (!payload)
+        return rejected(commandType, 'invalid_payload', 'Command payload must be a JSON object.');
+    const unsafe = findUnsafePayload(payload);
+    if (unsafe) {
+        return rejected(commandType, unsafe.reason, `Command payload contains unsafe field ${unsafe.path}.`);
+    }
+    const shapeError = validatePayloadShape(commandType, payload);
+    if (shapeError)
+        return rejected(commandType, 'invalid_payload_shape', shapeError);
+    return { allowed: true, command_type: commandType };
+}
+export function isBridgeCommandType(value) {
+    return BRIDGE_COMMAND_TYPES.includes(value);
+}
+function rejected(commandType, reason, message) {
+    return { allowed: false, command_type: commandType, reason, message };
+}
+function validatePayloadShape(commandType, payload) {
+    const keys = Object.keys(payload);
+    if (commandType === 'agent.status_request') {
+        if (hasUnknownKeys(keys, ['run_id', 'detail']))
+            return 'agent.status_request only accepts run_id and detail.';
+        if ('run_id' in payload && !isString(payload.run_id))
+            return 'agent.status_request run_id must be a string.';
+        if ('detail' in payload && payload.detail !== 'summary' && payload.detail !== 'full') {
+            return 'agent.status_request detail must be summary or full.';
+        }
+        return null;
+    }
+    if (commandType === 'agent.prompt') {
+        if (hasUnknownKeys(keys, ['objective', 'requires_confirmation', 'expected_artifacts'])) {
+            return 'agent.prompt only accepts objective, requires_confirmation, and expected_artifacts.';
+        }
+        if (!isString(payload.objective))
+            return 'agent.prompt objective is required.';
+        if ('requires_confirmation' in payload && typeof payload.requires_confirmation !== 'boolean') {
+            return 'agent.prompt requires_confirmation must be boolean.';
+        }
+        if ('expected_artifacts' in payload && !isStringArray(payload.expected_artifacts)) {
+            return 'agent.prompt expected_artifacts must be a string array.';
+        }
+        return null;
+    }
+    if (commandType === 'agent.cancel') {
+        if (hasUnknownKeys(keys, ['run_id', 'reason']))
+            return 'agent.cancel only accepts run_id and reason.';
+        if ('run_id' in payload && !isString(payload.run_id))
+            return 'agent.cancel run_id must be a string.';
+        if ('reason' in payload && !isString(payload.reason))
+            return 'agent.cancel reason must be a string.';
+        return null;
+    }
+    if (commandType === 'artifact.upload_request') {
+        if (hasUnknownKeys(keys, ['path', 'artifact_type', 'name'])) {
+            return 'artifact.upload_request only accepts path, artifact_type, and name.';
+        }
+        if (!isString(payload.path))
+            return 'artifact.upload_request path is required.';
+        if ('artifact_type' in payload && !isString(payload.artifact_type)) {
+            return 'artifact.upload_request artifact_type must be a string.';
+        }
+        if ('name' in payload && !isString(payload.name))
+            return 'artifact.upload_request name must be a string.';
+        return null;
+    }
+    if (hasUnknownKeys(keys, ['client_id']))
+        return 'bridge.health_request only accepts client_id.';
+    if ('client_id' in payload && !isString(payload.client_id))
+        return 'bridge.health_request client_id must be a string.';
+    return null;
+}
+function hasUnknownKeys(keys, allowed) {
+    return keys.some((key) => !allowed.includes(key));
+}
+function isString(value) {
+    return typeof value === 'string' && value.length > 0;
+}
+function isStringArray(value) {
+    return Array.isArray(value) && value.every(isString);
+}
+function asRecord(value) {
+    if (value === undefined || value === null)
+        return {};
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : null;
+}
+function findUnsafePayload(value, path = 'payload') {
+    if (typeof value === 'string')
+        return SECRET_VALUE_PATTERN.test(value) ? { path, reason: 'secret_shaped_value' } : null;
+    if (Array.isArray(value)) {
+        for (let index = 0; index < value.length; index += 1) {
+            const unsafe = findUnsafePayload(value[index], `${path}[${index}]`);
+            if (unsafe)
+                return unsafe;
+        }
+        return null;
+    }
+    if (!value || typeof value !== 'object')
+        return null;
+    for (const [key, child] of Object.entries(value)) {
+        const childPath = `${path}.${key}`;
+        if (DISALLOWED_PAYLOAD_KEYS.has(key.toLowerCase()))
+            return { path: childPath, reason: 'execution_shaped_key' };
+        const unsafe = findUnsafePayload(child, childPath);
+        if (unsafe)
+            return unsafe;
+    }
+    return null;
+}
+//# sourceMappingURL=command-contract.js.map

package/dist/bridge/command-contract.js.map

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

package/dist/bridge/index.d.ts

@@ -0,0 +1,248 @@
+import type { Command } from 'commander';
+import { type BridgeClientType, type BridgeCommandResultStatus } from './api-client.js';
+export declare const DEFAULT_BRIDGE_API_URL = "https://api.hypertab.ai";
+export declare const BRIDGE_CLIENT_TYPES: readonly ["codex", "claude_code", "cursor", "browser", "cloud", "other"];
+interface Writer {
+    write(chunk: string): unknown;
+}
+export interface BridgeStartOptions {
+    apiKey?: string;
+    apiUrl: string;
+    clientName?: string;
+    clientType: BridgeClientType;
+    heartbeatIntervalMs: number;
+    commandIntervalMs: number;
+    commandLimit: number;
+    session: boolean;
+    objective?: string;
+    runTitle?: string;
+    source: string;
+    once: boolean;
+    json: boolean;
+    spool: boolean;
+    spoolFile: string;
+    timeoutMs?: number;
+    fetchImpl?: typeof fetch;
+    stdout?: Writer;
+    stderr?: Writer;
+    sleep?: (ms: number) => Promise<void>;
+    maxIterations?: number;
+}
+export interface BridgeResultOptions {
+    apiKey?: string;
+    apiUrl: string;
+    commandId: string;
+    clientId?: string;
+    status: BridgeCommandResultStatus;
+    errorMessage?: string;
+    json: boolean;
+    spool: boolean;
+    spoolFile: string;
+    timeoutMs?: number;
+    fetchImpl?: typeof fetch;
+    stdout?: Writer;
+    stderr?: Writer;
+}
+export interface BridgeStatusOptions {
+    apiKey?: string;
+    apiUrl: string;
+    clientId?: string;
+    limit: number;
+    json: boolean;
+    timeoutMs?: number;
+    fetchImpl?: typeof fetch;
+    stdout?: Writer;
+    stderr?: Writer;
+}
+export interface BridgeTokenCreateOptions {
+    apiKey?: string;
+    apiUrl: string;
+    name?: string;
+    clientName: string;
+    clientType: BridgeClientType;
+    expiresInDays: number;
+    json: boolean;
+    timeoutMs?: number;
+    fetchImpl?: typeof fetch;
+    stdout?: Writer;
+    stderr?: Writer;
+}
+export interface BridgeEventBatchOptions {
+    apiKey?: string;
+    apiUrl: string;
+    file: string;
+    json: boolean;
+    spool: boolean;
+    spoolFile: string;
+    timeoutMs?: number;
+    fetchImpl?: typeof fetch;
+    stdout?: Writer;
+    stderr?: Writer;
+}
+export interface BridgeFlushOptions {
+    apiKey?: string;
+    apiUrl: string;
+    spoolFile: string;
+    json: boolean;
+    timeoutMs?: number;
+    fetchImpl?: typeof fetch;
+    stdout?: Writer;
+    stderr?: Writer;
+}
+export interface BridgeArtifactUploadOptions {
+    apiKey?: string;
+    apiUrl: string;
+    file: string;
+    runId?: string;
+    name?: string;
+    artifactType?: string;
+    mimeType?: string;
+    metadata?: string;
+    json: boolean;
+    timeoutMs?: number;
+    fetchImpl?: typeof fetch;
+    stdout?: Writer;
+    stderr?: Writer;
+}
+export interface BridgeWrapperInitOptions {
+    type: 'node' | 'shell';
+    out?: string;
+    force: boolean;
+    json: boolean;
+    stdout?: Writer;
+    stderr?: Writer;
+}
+export interface BridgeWrapperDoctorOptions {
+    path?: string;
+    apiKey?: string;
+    json: boolean;
+    spoolFile: string;
+    env?: NodeJS.ProcessEnv;
+    stdout?: Writer;
+    stderr?: Writer;
+}
+interface RawBridgeStartOptions {
+    apiKey?: string;
+    apiUrl: string;
+    clientName?: string;
+    clientType: string;
+    heartbeatIntervalMs: number;
+    commandIntervalMs: number;
+    commandLimit: number;
+    session?: boolean;
+    objective?: string;
+    runTitle?: string;
+    source: string;
+    once?: boolean;
+    json?: boolean;
+    spool?: boolean;
+    spoolFile?: string;
+    timeoutMs?: number;
+}
+interface RawBridgeResultOptions {
+    apiKey?: string;
+    apiUrl: string;
+    commandId: string;
+    clientId?: string;
+    status: string;
+    errorMessage?: string;
+    json?: boolean;
+    spool?: boolean;
+    spoolFile?: string;
+    timeoutMs?: number;
+}
+interface RawBridgeStatusOptions {
+    apiKey?: string;
+    apiUrl: string;
+    clientId?: string;
+    limit: number;
+    json?: boolean;
+    timeoutMs?: number;
+}
+interface RawBridgeTokenCreateOptions {
+    apiKey?: string;
+    apiUrl: string;
+    name?: string;
+    clientName?: string;
+    clientType?: string;
+    expiresInDays?: number;
+    json?: boolean;
+    timeoutMs?: number;
+}
+interface RawBridgeEventBatchOptions {
+    apiKey?: string;
+    apiUrl: string;
+    file: string;
+    json?: boolean;
+    spool?: boolean;
+    spoolFile?: string;
+    timeoutMs?: number;
+}
+interface RawBridgeFlushOptions {
+    apiKey?: string;
+    apiUrl: string;
+    spoolFile?: string;
+    json?: boolean;
+    timeoutMs?: number;
+}
+interface RawBridgeArtifactUploadOptions {
+    apiKey?: string;
+    apiUrl: string;
+    file: string;
+    runId?: string;
+    name?: string;
+    artifactType?: string;
+    mimeType?: string;
+    metadata?: string;
+    json?: boolean;
+    timeoutMs?: number;
+}
+interface RawBridgeWrapperInitOptions {
+    type?: string;
+    out?: string;
+    force?: boolean;
+    json?: boolean;
+}
+interface RawBridgeWrapperDoctorOptions {
+    path?: string;
+    apiKey?: string;
+    json?: boolean;
+    spoolFile?: string;
+}
+interface BridgeCommandDependencies {
+    runStart?: (options: BridgeStartOptions) => Promise<number>;
+    runResult?: (options: BridgeResultOptions) => Promise<number>;
+    runStatus?: (options: BridgeStatusOptions) => Promise<number>;
+    runTokenCreate?: (options: BridgeTokenCreateOptions) => Promise<number>;
+    runEventBatch?: (options: BridgeEventBatchOptions) => Promise<number>;
+    runFlush?: (options: BridgeFlushOptions) => Promise<number>;
+    runArtifactUpload?: (options: BridgeArtifactUploadOptions) => Promise<number>;
+    runWrapperInit?: (options: BridgeWrapperInitOptions) => Promise<number>;
+    runWrapperDoctor?: (options: BridgeWrapperDoctorOptions) => Promise<number>;
+    exit?: (code: number) => void;
+}
+export declare function registerBridgeCommand(program: Command, deps?: BridgeCommandDependencies): void;
+export declare function normalizeBridgeStartOptions(opts: RawBridgeStartOptions): BridgeStartOptions;
+export declare function normalizeBridgeResultOptions(opts: RawBridgeResultOptions): BridgeResultOptions;
+export declare function normalizeBridgeStatusOptions(opts: RawBridgeStatusOptions): BridgeStatusOptions;
+export declare function normalizeBridgeTokenCreateOptions(opts: RawBridgeTokenCreateOptions): BridgeTokenCreateOptions;
+export declare function normalizeBridgeEventBatchOptions(opts: RawBridgeEventBatchOptions): BridgeEventBatchOptions;
+export declare function normalizeBridgeFlushOptions(opts: RawBridgeFlushOptions): BridgeFlushOptions;
+export declare function normalizeBridgeArtifactUploadOptions(opts: RawBridgeArtifactUploadOptions): BridgeArtifactUploadOptions;
+export declare function normalizeBridgeWrapperInitOptions(opts: RawBridgeWrapperInitOptions): BridgeWrapperInitOptions;
+export declare function normalizeBridgeWrapperDoctorOptions(opts: RawBridgeWrapperDoctorOptions): BridgeWrapperDoctorOptions;
+export declare function resolveBridgeApiKey(input: {
+    apiKey?: string;
+    env?: NodeJS.ProcessEnv;
+}): string | null;
+export declare function runBridgeDaemon(options: BridgeStartOptions): Promise<number>;
+export declare function runBridgeResult(options: BridgeResultOptions): Promise<number>;
+export declare function runBridgeStatus(options: BridgeStatusOptions): Promise<number>;
+export declare function runBridgeTokenCreate(options: BridgeTokenCreateOptions): Promise<number>;
+export declare function runBridgeEventBatch(options: BridgeEventBatchOptions): Promise<number>;
+export declare function runBridgeFlush(options: BridgeFlushOptions): Promise<number>;
+export declare function runBridgeArtifactUpload(options: BridgeArtifactUploadOptions): Promise<number>;
+export declare function runBridgeWrapperInit(options: BridgeWrapperInitOptions): Promise<number>;
+export declare function runBridgeWrapperDoctor(options: BridgeWrapperDoctorOptions): Promise<number>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/bridge/index.d.ts.map

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