@panorama-ai/gateway 2.29.14 → 2.30.181

package/dist/gateway-model-run.js

@@ -0,0 +1,205 @@
+import { getGatewayCliProvider, inferGatewayProviderFromModel, } from './cli-providers/registry.js';
+import { assertSafeOutputPath, cleanupWorkDir, createWorkDir, extractGatewayErrorSummary, resolveRunPlanEnv, truncateLog, writeRunPlanFiles, } from './gateway-run-helpers.js';
+import { resolveModelWorkdirRoot } from './runtime-paths.js';
+import { buildSafeGatewayCommandDescriptor } from './debug-redaction.js';
+import { buildProviderFailureMessage, normalizeProviderErrorSummary, } from './gateway-provider-health.js';
+export function parseGatewayModelRunPayload(payload, defaultTimeoutMs) {
+    const prompt = typeof payload.prompt === 'string' ? payload.prompt : null;
+    const model = typeof payload.model === 'string' ? payload.model : null;
+    const jsonSchema = payload.json_schema && typeof payload.json_schema === 'object'
+        ? payload.json_schema
+        : null;
+    const appendSystemPrompt = typeof payload.append_system_prompt === 'string' ? payload.append_system_prompt : undefined;
+    const reasoningEffort = payload.reasoning_effort === 'low' ||
+        payload.reasoning_effort === 'medium' ||
+        payload.reasoning_effort === 'high'
+        ? payload.reasoning_effort
+        : undefined;
+    const timeoutMs = typeof payload.timeout_ms === 'number' && payload.timeout_ms > 0
+        ? payload.timeout_ms
+        : defaultTimeoutMs;
+    if (!prompt || !model) {
+        return {
+            ok: false,
+            result: { message: 'Missing prompt or model for gateway model run' },
+            error: 'Missing prompt or model',
+        };
+    }
+    if (!jsonSchema) {
+        return {
+            ok: false,
+            result: { message: 'Missing json_schema for gateway model run' },
+            error: 'Missing json_schema',
+        };
+    }
+    const providerFromPayload = typeof payload.provider === 'string' ? payload.provider : null;
+    const providerId = providerFromPayload === 'claude_code' ||
+        providerFromPayload === 'codex' ||
+        providerFromPayload === 'gemini'
+        ? providerFromPayload
+        : inferGatewayProviderFromModel(model);
+    return {
+        ok: true,
+        value: {
+            prompt,
+            model,
+            jsonSchema,
+            appendSystemPrompt,
+            reasoningEffort,
+            timeoutMs,
+            providerId,
+        },
+    };
+}
+export async function handleGatewayModelRunJob(params) {
+    const { job, defaultTimeoutMs, processKillGraceMs, activeModelRuns, runCommand, updateJobDebug, updateProviderHealth, requestChildTermination, workRoot = resolveModelWorkdirRoot(), } = params;
+    const parsedPayload = parseGatewayModelRunPayload(job.payload ?? {}, defaultTimeoutMs);
+    if (!parsedPayload.ok)
+        return parsedPayload;
+    const { prompt, model, jsonSchema, appendSystemPrompt, reasoningEffort, timeoutMs, providerId, } = parsedPayload.value;
+    const provider = getGatewayCliProvider(providerId);
+    let normalizedPrompt = prompt;
+    let normalizedSchema = jsonSchema;
+    if (provider.normalizeSchema) {
+        const normalized = provider.normalizeSchema(jsonSchema);
+        normalizedSchema = normalized.schema;
+        if (normalized.promptSuffix) {
+            normalizedPrompt = `${normalizedPrompt}\n\n${normalized.promptSuffix}`;
+        }
+    }
+    const runPlan = provider.buildModelRunPlan({
+        model,
+        prompt: normalizedPrompt,
+        jsonSchema: normalizedSchema,
+        appendSystemPrompt,
+        reasoningEffort,
+        timeoutMs,
+    });
+    let workDir = '';
+    const activeModelRun = {
+        shutdownRequested: false,
+    };
+    activeModelRuns.set(job.id, activeModelRun);
+    try {
+        workDir = await createWorkDir(workRoot, [{ value: job.id, label: 'job id' }]);
+        assertSafeOutputPath(workDir, runPlan.outputPath);
+        await writeRunPlanFiles(workDir, runPlan.files);
+        const resolvedEnv = resolveRunPlanEnv(runPlan.env, workDir);
+        const commandDescriptor = buildSafeGatewayCommandDescriptor(runPlan.command, runPlan.args, {
+            redactLastArg: true,
+        });
+        const debugInfo = {
+            provider_id: providerId,
+            command: commandDescriptor.command,
+            args: commandDescriptor.args,
+            command_line: commandDescriptor.commandLine,
+            work_dir: workDir,
+            prompt_chars: prompt.length,
+            json_schema_chars: JSON.stringify(normalizedSchema).length,
+            reasoning_effort: reasoningEffort ?? null,
+            timeout_ms: timeoutMs,
+            output_mode: runPlan.outputMode,
+            output_path: runPlan.outputPath ?? null,
+        };
+        if (runPlan.files && runPlan.files.length > 0) {
+            debugInfo.files = runPlan.files.map((file) => file.path);
+        }
+        await updateJobDebug(job.id, debugInfo);
+        const runResult = await runCommand(runPlan.command, runPlan.args, {
+            timeoutMs: runPlan.timeoutMs ?? defaultTimeoutMs,
+            cwd: workDir,
+            env: resolvedEnv,
+            onStart: (child) => {
+                activeModelRun.child = child;
+                if (activeModelRun.shutdownRequested) {
+                    requestChildTermination(child, {
+                        reason: activeModelRun.shutdownReason ?? 'Gateway shutting down',
+                        graceMs: processKillGraceMs,
+                        context: 'model_run_shutdown',
+                    });
+                }
+            },
+        });
+        const stdoutInfo = truncateLog(runResult.stdout);
+        const stderrInfo = truncateLog(runResult.stderr);
+        const errorSummary = extractGatewayErrorSummary(stderrInfo.value);
+        debugInfo.stdout = stdoutInfo.value;
+        debugInfo.stdout_truncated = stdoutInfo.truncated;
+        debugInfo.stdout_bytes = stdoutInfo.originalBytes;
+        debugInfo.stderr = stderrInfo.value;
+        debugInfo.stderr_truncated = stderrInfo.truncated;
+        debugInfo.stderr_bytes = stderrInfo.originalBytes;
+        debugInfo.exit_code = runResult.exitCode;
+        debugInfo.duration_ms = runResult.durationMs;
+        debugInfo.timed_out = runResult.timedOut;
+        if (errorSummary) {
+            debugInfo.error_summary = errorSummary;
+        }
+        await updateJobDebug(job.id, debugInfo);
+        if (!runResult.ok) {
+            const summary = normalizeProviderErrorSummary(errorSummary?.message ?? runResult.error ?? 'Gateway model run failed');
+            await updateProviderHealth(providerId, 'unhealthy', summary ?? 'Gateway model run failed');
+            const failureMessage = buildProviderFailureMessage(providerId, summary);
+            return {
+                ok: false,
+                result: {
+                    message: failureMessage,
+                    exit_code: runResult.exitCode,
+                    stderr: stderrInfo.value,
+                    stdout: stdoutInfo.value,
+                    command: commandDescriptor.commandLine,
+                    error_summary: errorSummary ?? null,
+                },
+                error: failureMessage,
+            };
+        }
+        let normalized;
+        try {
+            normalized = provider.normalizeModelRunResult({
+                stdout: runResult.stdout,
+                outputFormat: runPlan.outputFormat,
+                outputMode: runPlan.outputMode,
+                outputPath: runPlan.outputPath,
+                workDir,
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Failed to normalize gateway output';
+            const summary = normalizeProviderErrorSummary(message);
+            await updateProviderHealth(providerId, 'unhealthy', summary ?? message);
+            const failureMessage = buildProviderFailureMessage(providerId, summary ?? message);
+            return {
+                ok: false,
+                result: {
+                    message: failureMessage,
+                    stdout: stdoutInfo.value,
+                    stderr: stderrInfo.value,
+                    command: commandDescriptor.commandLine,
+                },
+                error: failureMessage,
+            };
+        }
+        await updateProviderHealth(providerId, 'healthy');
+        return {
+            ok: true,
+            result: {
+                output: normalized.output,
+                raw: normalized.raw,
+                usage: normalized.usage,
+                model: normalized.model,
+                duration_ms: runResult.durationMs,
+                exit_code: runResult.exitCode,
+                stdout_truncated: runResult.stdoutTruncated,
+                stderr_truncated: runResult.stderrTruncated,
+                command: commandDescriptor.commandLine,
+            },
+        };
+    }
+    finally {
+        activeModelRuns.delete(job.id);
+        if (workDir) {
+            await cleanupWorkDir(workDir, workRoot);
+        }
+    }
+}
+//# sourceMappingURL=gateway-model-run.js.map

package/dist/gateway-model-run.js.map

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

package/dist/gateway-operational-status.d.ts

@@ -1,4 +1,4 @@
-import type { GatewayCapabilitiesV1 } from '@panorama/shared';
+import { type GatewayCapabilitiesV1 } from '@panorama/shared/gateway/capabilities';
 import type { GatewayProviderCapabilities } from './cli-providers/types.js';
 export interface GatewayJobIngressState {
     pending: boolean;

package/dist/gateway-operational-status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gateway-operational-status.d.ts","sourceRoot":"","sources":["../src/gateway-operational-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACtB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAA;AAE3E,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,OAAO,CAAA;CACf;AAED,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAA;AAEpE,wBAAgB,eAAe,CAAC,KAAK,CAAC,EAAE,2BAA2B,GAAG,OAAO,CAM5E;AAED,wBAAgB,oCAAoC,CAClD,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,GACrD,wBAAwB,CAG1B;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE;IACtD,YAAY,EAAE,qBAAqB,GAAG,IAAI,CAAA;IAC1C,eAAe,EAAE,sBAAsB,GAAG,IAAI,CAAA;IAC9C,aAAa,EAAE,OAAO,CAAA;CACvB,GAAG,wBAAwB,CAgB3B"}
+{"version":3,"file":"gateway-operational-status.d.ts","sourceRoot":"","sources":["../src/gateway-operational-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,uCAAuC,CAAA;AAC9C,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAA;AAG3E,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,OAAO,CAAA;CACf;AAED,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAA;AAEpE,wBAAgB,eAAe,CAAC,KAAK,CAAC,EAAE,2BAA2B,GAAG,OAAO,CAE5E;AAED,wBAAgB,oCAAoC,CAClD,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,GACrD,wBAAwB,CAG1B;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE;IACtD,YAAY,EAAE,qBAAqB,GAAG,IAAI,CAAA;IAC1C,eAAe,EAAE,sBAAsB,GAAG,IAAI,CAAA;IAC9C,aAAa,EAAE,OAAO,CAAA;CACvB,GAAG,wBAAwB,CAgB3B"}

package/dist/gateway-operational-status.js

@@ -1,25 +1,18 @@
+import { isGatewayHostAvailable, } from '@panorama/shared/gateway/capabilities';
+import { isGatewayProviderReady } from './gateway-capability-services.js';
 export function isProviderReady(entry) {
-    if (!entry)
-        return false;
-    if (entry.health?.status === 'healthy')
-        return true;
-    if (!entry.available)
-        return false;
-    if (!entry.health)
-        return true;
-    return entry.health.status !== 'unavailable' && entry.health.status !== 'unhealthy';
+    return isGatewayProviderReady(entry);
 }
 export function computeGatewayStatusFromCapabilities(providers) {
     const anyReady = Object.values(providers).some((entry) => isProviderReady(entry));
     return anyReady ? 'ready' : 'error';
 }
 export function computeGatewayOperationalStatus(params) {
-    const providers = params.capabilities?.providers;
-    if (!providers)
+    if (!params.capabilities)
         return 'pending';
-    const providerStatus = computeGatewayStatusFromCapabilities(providers);
-    if (providerStatus !== 'ready')
-        return providerStatus;
+    if (!isGatewayHostAvailable(params.capabilities)) {
+        return 'error';
+    }
     if (!params.acceptingJobs) {
         return 'pending';
     }

package/dist/gateway-operational-status.js.map

@@ -1 +1 @@
-{"version":3,"file":"gateway-operational-status.js","sourceRoot":"","sources":["../src/gateway-operational-status.ts"],"names":[],"mappings":"AAYA,MAAM,UAAU,eAAe,CAAC,KAAmC;IACjE,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAA;IACxB,IAAI,KAAK,CAAC,MAAM,EAAE,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IACnD,IAAI,CAAC,KAAK,CAAC,SAAS;QAAE,OAAO,KAAK,CAAA;IAClC,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IAC9B,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,aAAa,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,WAAW,CAAA;AACrF,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,SAAsD;IAEtD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAA;IACjF,OAAO,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAA;AACrC,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,MAI/C;IACC,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,EAAE,SAAS,CAAA;IAChD,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAA;IAEhC,MAAM,cAAc,GAAG,oCAAoC,CAAC,SAAS,CAAC,CAAA;IACtE,IAAI,cAAc,KAAK,OAAO;QAAE,OAAO,cAAc,CAAA;IAErD,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,eAAe,IAAI,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;QAC9D,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,OAAO,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAA;AACzD,CAAC"}
+{"version":3,"file":"gateway-operational-status.js","sourceRoot":"","sources":["../src/gateway-operational-status.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,GAEvB,MAAM,uCAAuC,CAAA;AAE9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAA;AASzE,MAAM,UAAU,eAAe,CAAC,KAAmC;IACjE,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAA;AACtC,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,SAAsD;IAEtD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAA;IACjF,OAAO,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAA;AACrC,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,MAI/C;IACC,IAAI,CAAC,MAAM,CAAC,YAAY;QAAE,OAAO,SAAS,CAAA;IAE1C,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QACjD,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,eAAe,IAAI,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;QAC9D,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,OAAO,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAA;AACzD,CAAC"}

package/dist/gateway-pairing.d.ts

@@ -0,0 +1,58 @@
+import { type ParsedArgs } from './cli-args.js';
+import { type CliDetail } from './cli-output.js';
+import type { GatewayProviderHealth, GatewayProviderId } from './cli-providers/types.js';
+import type { GatewayProviderCapabilityProgressEvent } from './gateway-provider-capabilities.js';
+import type { GatewayConfig, GatewayPaths } from './gateway-state.js';
+type CliReporter = (message: string, options?: ParsedArgs['options'], details?: CliDetail[]) => void;
+type GatewayPairingFetchResponse = {
+    ok: boolean;
+    status: number;
+    json: () => Promise<unknown>;
+};
+type GatewayPairingFetch = (url: string, init: {
+    method: 'POST';
+    headers: Record<string, string>;
+    body: string;
+}) => Promise<GatewayPairingFetchResponse>;
+export interface GatewayPairingConfigResolution {
+    configDir: string;
+    configPath: string;
+    migratedFrom?: string;
+}
+export interface GatewayPairingEventPayload {
+    level: 'info' | 'warn' | 'error';
+    code?: string;
+    message: string;
+    provider?: string;
+    details?: Record<string, unknown>;
+}
+export interface GatewayPairingDependencies<EventClient = unknown> {
+    resolveGatewayPaths: (options?: ParsedArgs['options']) => GatewayPaths;
+    loadConfig: (options?: ParsedArgs['options']) => Promise<GatewayConfig>;
+    saveConfig: (config: GatewayConfig, options?: ParsedArgs['options']) => Promise<void>;
+    discoverGatewayCliCommands: (options?: ParsedArgs['options']) => Promise<void>;
+    buildCapabilities: (params?: {
+        validationMode?: 'full' | 'light' | 'auto';
+        previousHealth?: Partial<Record<GatewayProviderId, GatewayProviderHealth>>;
+        deviceName?: string | null;
+        installFullControlEnabled?: boolean;
+        onProgress?: (event: GatewayProviderCapabilityProgressEvent) => void;
+    }) => Promise<{
+        providerHealth: Record<GatewayProviderId, GatewayProviderHealth>;
+        anyProviderReady: boolean;
+    }>;
+    createGatewayEventClient: (config: GatewayConfig) => Promise<EventClient | null>;
+    flushGatewayEvents: (client: EventClient, config: GatewayConfig) => Promise<void>;
+    emitGatewayEvent: (client: EventClient, config: GatewayConfig, payload: GatewayPairingEventPayload) => Promise<void>;
+    emitProviderHealthEvents: (client: EventClient, config: GatewayConfig, providerHealth: Record<GatewayProviderId, GatewayProviderHealth>, context: string) => Promise<void>;
+    fetchPairingCode?: GatewayPairingFetch;
+    env?: NodeJS.ProcessEnv;
+    hostname?: () => string;
+    logError: (message: string, data?: Record<string, unknown>) => void;
+    cliSuccess: CliReporter;
+    cliInfo: CliReporter;
+    cliWarn: CliReporter;
+}
+export declare function pairGatewayCommand<EventClient = unknown>(code: string, options: ParsedArgs['options'], configResolution: GatewayPairingConfigResolution | undefined, dependencies: GatewayPairingDependencies<EventClient>): Promise<void>;
+export {};
+//# sourceMappingURL=gateway-pairing.d.ts.map

package/dist/gateway-pairing.d.ts.map

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

package/dist/gateway-pairing.js

@@ -0,0 +1,151 @@
+import os from 'node:os';
+import process from 'node:process';
+import { getStringOption, parseBooleanInput, } from './cli-args.js';
+import { GatewayCliError, formatPathForDisplay, } from './cli-output.js';
+import { formatProviderLabel, formatProviderProgressLine, } from './gateway-provider-health.js';
+import { buildMissingSupabaseConfigError, resolveSupabaseConfig, } from './supabase-config.js';
+async function safeJson(response) {
+    try {
+        const value = await response.json();
+        return value && typeof value === 'object' ? value : null;
+    }
+    catch {
+        return null;
+    }
+}
+function readRequiredPairingField(body, field) {
+    const value = body?.[field];
+    return typeof value === 'string' && value.trim().length > 0 ? value : '';
+}
+export async function pairGatewayCommand(code, options, configResolution, dependencies) {
+    dependencies.cliInfo('Pairing with team...', options);
+    const env = dependencies.env ?? process.env;
+    const resolvedSupabaseConfig = resolveSupabaseConfig({
+        cliSupabaseUrl: getStringOption(options, 'supabase-url'),
+        cliAnonKey: getStringOption(options, 'anon-key'),
+        env,
+    });
+    if (resolvedSupabaseConfig.missingFields.length > 0) {
+        const { message, details } = buildMissingSupabaseConfigError('pair', resolvedSupabaseConfig.missingFields);
+        throw new GatewayCliError(message, details);
+    }
+    const { supabaseUrl, supabaseAnonKey } = resolvedSupabaseConfig;
+    const deviceName = getStringOption(options, 'device-name') ||
+        env.PANORAMA_GATEWAY_DEVICE_NAME ||
+        dependencies.hostname?.() ||
+        os.hostname();
+    const url = `${supabaseUrl.replace(/\/$/, '')}/functions/v1/exchange-gateway-pairing-code`;
+    const fetchPairingCode = dependencies.fetchPairingCode ??
+        ((requestUrl, init) => fetch(requestUrl, init));
+    const response = await fetchPairingCode(url, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            apikey: supabaseAnonKey,
+            Authorization: `Bearer ${supabaseAnonKey}`,
+        },
+        body: JSON.stringify({
+            code: code.trim(),
+            device_name: deviceName,
+        }),
+    });
+    const body = await safeJson(response);
+    if (!response.ok || body?.success === false) {
+        const message = typeof body?.error === 'string' ? body.error : `Pairing failed with status ${response.status}`;
+        throw new Error(message);
+    }
+    const accessToken = readRequiredPairingField(body, 'access_token');
+    const refreshToken = readRequiredPairingField(body, 'refresh_token');
+    const gatewayId = readRequiredPairingField(body, 'gateway_id');
+    const teamId = readRequiredPairingField(body, 'team_id');
+    if (!accessToken || !refreshToken || !gatewayId || !teamId) {
+        throw new Error('Pairing response missing required fields');
+    }
+    const requestedFullControl = parseBooleanInput(options['full-control']);
+    let existingConfig = null;
+    try {
+        existingConfig = await dependencies.loadConfig(options);
+    }
+    catch {
+        existingConfig = null;
+    }
+    const installFullControlEnabled = requestedFullControl ?? existingConfig?.full_control_enabled ?? false;
+    const config = {
+        supabaseUrl,
+        supabaseAnonKey,
+        accessToken,
+        refreshToken,
+        gatewayId,
+        teamId,
+        full_control_enabled: installFullControlEnabled,
+        deviceName,
+    };
+    await dependencies.saveConfig(config, options);
+    let providerHealthSummary = null;
+    let anyProviderReady = false;
+    let providerHealth = null;
+    try {
+        dependencies.cliInfo('Validating providers...', options);
+        await dependencies.discoverGatewayCliCommands(options);
+        const { providerHealth: resolvedHealth, anyProviderReady: ready } = await dependencies.buildCapabilities({
+            validationMode: 'full',
+            installFullControlEnabled: config.full_control_enabled,
+            onProgress: (event) => {
+                if (event.stage === 'start') {
+                    dependencies.cliInfo(`Validating ${formatProviderLabel(event.providerId)}...`, options);
+                    return;
+                }
+                dependencies.cliInfo(formatProviderProgressLine(event), options);
+            },
+        });
+        config.providerHealth = resolvedHealth;
+        providerHealth = resolvedHealth;
+        await dependencies.saveConfig(config, options);
+        providerHealthSummary = Object.entries(providerHealth)
+            .map(([id, health]) => `${id}:${health.status}`)
+            .join(', ');
+        anyProviderReady = ready;
+    }
+    catch (error) {
+        dependencies.logError('Gateway provider validation failed during pairing', {
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+    const { configPath } = dependencies.resolveGatewayPaths(options);
+    dependencies.cliSuccess('Paired to team successfully', options, [
+        { label: 'Config saved', value: formatPathForDisplay(configPath) },
+        { label: 'Gateway ID', value: gatewayId, verboseOnly: true },
+        { label: 'Team ID', value: teamId, verboseOnly: true },
+        { label: 'Device', value: deviceName, verboseOnly: true },
+        {
+            label: 'Host machine control',
+            value: installFullControlEnabled ? 'Enabled' : 'Disabled',
+            verboseOnly: true,
+        },
+        ...(providerHealthSummary
+            ? [{ label: 'Provider health', value: providerHealthSummary, verboseOnly: true }]
+            : []),
+    ]);
+    if (providerHealthSummary && !anyProviderReady) {
+        dependencies.cliWarn('No gateway providers passed validation. Install/authenticate a provider before starting the gateway.', options, [{ label: 'Provider health', value: providerHealthSummary, verboseOnly: true }]);
+    }
+    const eventClient = await dependencies.createGatewayEventClient(config);
+    if (!eventClient)
+        return;
+    await dependencies.flushGatewayEvents(eventClient, config);
+    if (configResolution?.migratedFrom) {
+        await dependencies.emitGatewayEvent(eventClient, config, {
+            level: 'warn',
+            code: 'config_dir_fallback',
+            message: 'Gateway config directory was not writable; using fallback location.',
+            details: {
+                previous: configResolution.migratedFrom,
+                current: configResolution.configDir,
+            },
+        });
+    }
+    if (providerHealth) {
+        await dependencies.emitProviderHealthEvents(eventClient, config, providerHealth, 'pairing');
+    }
+}
+//# sourceMappingURL=gateway-pairing.js.map

package/dist/gateway-pairing.js.map

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

package/dist/gateway-provider-capabilities.d.ts

@@ -0,0 +1,59 @@
+import { type GatewayCapabilitiesV1 } from '@panorama/shared/gateway/capabilities';
+import { type GatewayCliProvider, type GatewayHealthStatus, type GatewayProviderCapabilities, type GatewayProviderHealth, type GatewayProviderId } from './cli-providers/types.js';
+import { type GatewayCommandRunOptions, type GatewayCommandResult } from './gateway-command-runner.js';
+import { type ClaudeSupport } from './subagent-adapters/claude-support.js';
+export type ProviderValidationMode = 'full' | 'light' | 'auto';
+export interface GatewayProviderCapabilityProgressEvent {
+    stage: 'start' | 'complete';
+    providerId: GatewayProviderId;
+    status?: GatewayHealthStatus;
+    durationMs?: number;
+    error?: string;
+}
+export type GatewayProviderValidationCommandRunner = (command: string, args: string[], options: GatewayCommandRunOptions) => Promise<GatewayCommandResult>;
+export interface GatewayProviderCapabilitiesResult {
+    capabilities: GatewayCapabilitiesV1;
+    providerCapabilities: Record<GatewayProviderId, GatewayProviderCapabilities>;
+    providerHealth: Record<GatewayProviderId, GatewayProviderHealth>;
+    anyProviderReady: boolean;
+    claudeSupport: ClaudeSupport | null;
+}
+export declare function coerceGatewayHealthStatus(value: GatewayHealthStatus | undefined): GatewayHealthStatus;
+export declare function runProviderValidation(params: {
+    provider: GatewayCliProvider;
+    model?: string;
+    runCommand?: GatewayProviderValidationCommandRunner;
+    workRoot?: string;
+    createRunId?: () => string;
+}): Promise<{
+    ok: boolean;
+    durationMs: number;
+    error?: string;
+}>;
+export declare function resolveProviderHealth(params: {
+    provider: GatewayCliProvider;
+    capability: GatewayProviderCapabilities;
+    mode: ProviderValidationMode;
+    previous?: GatewayProviderHealth;
+    runValidation?: (provider: GatewayCliProvider, model: string) => Promise<{
+        ok: boolean;
+        durationMs: number;
+        error?: string;
+    }>;
+    now?: () => Date;
+}): Promise<GatewayProviderHealth>;
+export declare function buildGatewayProviderCapabilities(params?: {
+    validationMode?: ProviderValidationMode;
+    previousHealth?: Partial<Record<GatewayProviderId, GatewayProviderHealth>>;
+    deviceName?: string | null;
+    installFullControlEnabled?: boolean;
+    onProgress?: (event: GatewayProviderCapabilityProgressEvent) => void;
+    providers?: GatewayCliProvider[];
+    runCommand?: GatewayProviderValidationCommandRunner;
+    readGatewayVersion?: () => Promise<string | null>;
+    now?: () => Date;
+    platform?: string;
+    arch?: string;
+    nodeVersion?: string;
+}): Promise<GatewayProviderCapabilitiesResult>;
+//# sourceMappingURL=gateway-provider-capabilities.d.ts.map

package/dist/gateway-provider-capabilities.d.ts.map

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