upstream-radar 0.43.4 → 0.44.0

package/dist/src/dsh-surface-observation.d.ts

@@ -0,0 +1,160 @@
+export declare const DSH_SURFACE_OBSERVATION_SCHEMA: 'upstream-radar.dsh-surface-observation/v1alpha1';
+export type DshExecutionPlane = 'web' | 'tui';
+export type DshSurfaceObservationResult = 'compatible' | 'surface-incompatible' | 'environment-unsupported' | 'unknown';
+export type DshSurfaceFailedStage = 'host' | 'surface' | 'interaction' | 'shutdown';
+export type DshSurfaceIsolationProvider = 'github-actions-hosted-runner' | 'firecracker' | 'other';
+export interface DshSurfaceStage {
+    status: 'passed' | 'failed' | 'skipped';
+    code?: number | null;
+    detail?: string;
+    timedOut?: boolean;
+    outputExceeded?: boolean;
+}
+export interface DshWebSurfaceEvidence {
+    plane: 'web';
+    url: string;
+    httpStatus?: number;
+    title?: string;
+    rootMounted: boolean;
+    bootManifestPresent: boolean;
+    /** Bounded module ids exposed by DSH, retained to make id mismatches diagnosable. */
+    bootEntryIds?: string[];
+    pluginEntryPresent: boolean;
+    pluginBundleUrl?: string;
+    pluginBundleStatus?: number;
+    /** The framework-free DSH boot page handed the root to the assembled app. */
+    applicationMounted: boolean;
+    /** Inferred from DSH's guarantee that hand-off follows activation of every graph entry. */
+    pluginMaterialized: boolean;
+    bootFailureText?: string;
+    consoleErrors: string[];
+    pageErrors: string[];
+    failedRequests: string[];
+    blockedExternalRequests?: string[];
+    screenshot?: string;
+    trace?: string;
+    hostLog?: string;
+}
+export interface DshTuiSurfaceEvidence {
+    plane: 'tui';
+    terminal: 'xterm-256color';
+    columns: number;
+    rows: number;
+    frameObserved: boolean;
+    inputSent: boolean;
+    exitedAfterShutdown: boolean;
+    exitCode?: number;
+    signal?: number;
+    transcript?: string;
+    normalizedFrame: string;
+    capturedBytes: number;
+    truncated: boolean;
+}
+export interface DshSurfaceObservationReport {
+    schema: typeof DSH_SURFACE_OBSERVATION_SCHEMA;
+    tool: {
+        name: 'upstream-radar';
+        version: string;
+    };
+    probe: 'dsh-surface';
+    scope: 'surface-runtime-behavior';
+    startedAt: string;
+    completedAt: string;
+    caseId: string;
+    sourceCaseId: string;
+    sourceFingerprint: string;
+    contractFingerprint: string;
+    plugin: string;
+    dshVersion: string;
+    plane: DshExecutionPlane;
+    profile: string;
+    runtimeId: string;
+    runtime: {
+        nodeMajor: number;
+        nodeVersion: string;
+        platform: string;
+        architecture: string;
+        pnpmVersion?: string;
+    };
+    artifact: {
+        sha256?: string;
+        bytes?: number;
+        integrity?: string;
+    };
+    stages: {
+        runtime: DshSurfaceStage;
+        artifact: DshSurfaceStage;
+        profile: DshSurfaceStage;
+        install: DshSurfaceStage;
+        registration: DshSurfaceStage;
+        host: DshSurfaceStage;
+        surface: DshSurfaceStage;
+        interaction: DshSurfaceStage;
+        shutdown: DshSurfaceStage;
+    };
+    evidence: DshWebSurfaceEvidence | DshTuiSurfaceEvidence;
+    result: DshSurfaceObservationResult;
+    reason: string;
+    boundary: {
+        isolationProviderClaim: DshSurfaceIsolationProvider;
+        isolationVerifiedByRadar: false;
+        disposableEnvironmentRequired: true;
+        inheritedHostSecrets: false;
+        externalBrowserRequestsBlocked: boolean;
+        approvedDependencyBuilds: string[];
+        note: string;
+    };
+}
+export interface DshWebEvaluationInput {
+    driverAvailable: boolean;
+    hostStarted: boolean;
+    httpStatus?: number;
+    rootMounted: boolean;
+    bootManifestPresent: boolean;
+    pluginEntryPresent: boolean;
+    pluginBundleStatus?: number;
+    applicationMounted: boolean;
+    pluginMaterialized: boolean;
+    bootFailureText?: string;
+    consoleErrors: readonly string[];
+    pageErrors: readonly string[];
+    failedRequests: readonly string[];
+}
+export interface DshTuiEvaluationInput {
+    driverAvailable: boolean;
+    frameObserved: boolean;
+    inputSent: boolean;
+    exitedAfterShutdown: boolean;
+    exitCode?: number;
+}
+export interface DshSurfaceEvaluation {
+    result: DshSurfaceObservationResult;
+    failedStage: DshSurfaceFailedStage | undefined;
+    reason: string;
+}
+export interface DshSurfaceObservationOptions {
+    packageSpec: string;
+    dshVersion: string;
+    caseId: string;
+    sourceCaseId: string;
+    sourceFingerprint: string;
+    contractFingerprint: string;
+    plane: DshExecutionPlane;
+    profile: string;
+    runtimeId: string;
+    expectedArtifactSha256: string;
+    allowedBuilds?: readonly string[];
+    allowExecution: boolean;
+    isolationProvider: DshSurfaceIsolationProvider;
+    timeoutMs?: number;
+    artifactsDirectory?: string;
+    hostEnvironment?: NodeJS.ProcessEnv;
+    driverRoot?: string;
+    chromiumExecutable?: string;
+}
+export declare function evaluateDshWebEvidence(input: DshWebEvaluationInput): DshSurfaceEvaluation;
+export declare function evaluateDshTuiEvidence(input: DshTuiEvaluationInput): DshSurfaceEvaluation;
+export declare function dshSurfaceProfileStrategy(plane: DshExecutionPlane): 'initialize-stock-profile' | 'create-with-plugin-add';
+export declare function observeDshPluginSurface(options: DshSurfaceObservationOptions): Promise<DshSurfaceObservationReport>;
+export declare function renderDshSurfaceObservation(report: DshSurfaceObservationReport): string;
+//# sourceMappingURL=dsh-surface-observation.d.ts.map

package/dist/src/dsh-surface-observation.d.ts.map

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