@b00dea/cockpit 0.0.0-bootstrap.0 → 0.1.0

package/dist/surfaces/render.d.ts

@@ -0,0 +1,118 @@
+import { type CustomHarness as CustomHarnessValue } from '../schema.js';
+import { type SurfaceFeature, type SurfaceTarget } from './contract.js';
+import { type SurfaceGenerationOutcome, type SurfaceGenerationWarning } from './generator-adapter.js';
+import type { SurfaceMergeResult } from './merge.js';
+import type { McpCollectionOutcome } from './mcp.js';
+import type { ProjectionPlanResult } from './projection.js';
+import type { RestrictionExpansionResult } from './restrictions.js';
+import { type SurfaceDesiredEntry, type SurfaceDiagnostic } from './ownership.js';
+export type SurfaceInputEvidence = Readonly<{
+    kind: 'guide';
+    root: string;
+    path: string;
+    sha256: string;
+    identity: string;
+}> | Readonly<{
+    kind: 'mcp';
+    root: string;
+    path: string;
+    sha256: string;
+    identity: string;
+}> | Readonly<{
+    kind: 'custom-harness';
+    harness: string;
+    feature: SurfaceFeature;
+    state: 'enforced' | 'instructed';
+    measuredOn: string;
+    module: string;
+    export: string;
+    sourceSha256: string;
+    resultSha256: string;
+}>;
+export interface NativeSurfaceFragment {
+    readonly target: SurfaceTarget;
+    readonly path: string;
+    readonly baseSha256: string;
+    readonly bytes: string;
+    readonly sha256: string;
+}
+export interface CustomSurfaceReceipt {
+    readonly harness: string;
+    readonly feature: SurfaceFeature;
+    readonly state: 'enforced' | 'instructed';
+    readonly measuredOn: string;
+    readonly module: string;
+    readonly export: string;
+    readonly sourceSha256: string;
+    readonly resultSha256: string;
+    readonly files: readonly Readonly<{
+        path: string;
+        bytes: string;
+        sha256: string;
+        scope: 'always' | 'scoped';
+    }>[];
+}
+export type SurfaceRenderResult = Readonly<{
+    kind: 'complete';
+    entries: readonly SurfaceDesiredEntry[];
+    inputs: readonly SurfaceInputEvidence[];
+    warnings: readonly SurfaceGenerationWarning[];
+}> | Readonly<{
+    kind: 'refusal';
+    diagnostic: SurfaceDiagnostic;
+}>;
+export interface NativeFragmentSet {
+    readonly modelSha256: string;
+    readonly fragments: readonly NativeSurfaceFragment[];
+}
+/** A reference file pulled on demand by one shipped skill; rendered beside that skill's entry point on every built-in harness. */
+export interface SkillReference {
+    readonly skill: string;
+    readonly path: string;
+    readonly bytes: string;
+}
+export interface SurfaceRenderInput {
+    readonly configuredHarnesses: readonly string[];
+    readonly merge: Extract<SurfaceMergeResult, {
+        kind: 'complete';
+    }>;
+    readonly generated: Extract<SurfaceGenerationOutcome, {
+        kind: 'complete';
+    }>;
+    readonly projection: Extract<ProjectionPlanResult, {
+        kind: 'complete';
+    }>;
+    readonly mcp: Extract<McpCollectionOutcome, {
+        kind: 'complete';
+    }>;
+    readonly restrictions: Extract<RestrictionExpansionResult, {
+        kind: 'complete';
+    }>;
+    readonly nativeMcp: NativeFragmentSet;
+    readonly nativeGrants: NativeFragmentSet;
+    readonly browser: unknown | null;
+    readonly browserReference: string | null;
+    readonly skillReferences: readonly SkillReference[];
+    readonly testing: unknown | null;
+    readonly customHarnesses: readonly CustomHarnessValue[];
+    readonly customReceipts: readonly CustomSurfaceReceipt[];
+    readonly sourceEvidence: readonly Extract<SurfaceInputEvidence, {
+        kind: 'guide' | 'mcp';
+    }>[];
+}
+export declare function surfaceModelSha256(value: unknown): string | undefined;
+export type HookSettingsComposition = Readonly<{
+    kind: 'complete';
+    value: Record<string, unknown>;
+}> | Readonly<{
+    kind: 'refusal';
+    key: string;
+    reason: 'malformed' | 'divergent';
+}>;
+/**
+ * The composition rule for a hook-registration settings file with several producers: every
+ * PreToolUse row is kept once, and every other top-level key and hook event must agree exactly.
+ * A refusal names the key so the producer that disagrees can be found.
+ */
+export declare function composeHookSettings(values: readonly unknown[]): HookSettingsComposition;
+export declare function renderSurfaceSet(input: unknown): SurfaceRenderResult;