/** Validate a public-tool input against the canonical package-schema grammar. */
export declare function assertTapContributionId(value: string, manifestSchema: unknown, label?: string): string;

/** Validate exact SDK pinning, descriptor inputs, matrix coverage, and tests. */
export declare function doctorTapTests(options: TapProjectOptions, schemas: TapToolingSchemas, sdkVersion: string, now?: Date): Promise<TapDoctorResult>;

export declare function inspectTapManifest(options: TapProjectOptions, schemas: TapToolingSchemas): Promise<TapManifestInventory>;

export declare function inspectTapMatrix(options: TapProjectOptions, schemas: TapToolingSchemas): Promise<Readonly<{
    descriptor: JsonObject;
    rows: readonly TapMatrixRow[];
}>>;

export declare type JsonObject = {
    [key: string]: JsonValue;
};

declare type JsonPrimitive = boolean | null | number | string;

export declare type JsonValue = JsonPrimitive | JsonValue[] | JsonObject;

export declare function loadTapToolingSchemas(manifestSchemaPath: string | URL, testDescriptorSchemaPath: string | URL): Promise<TapToolingSchemas>;

export declare function matrixRows(value: JsonValue): TapMatrixRow[];

/** Deterministically project a strict v1 `tap.test.json` into schema v2. */
export declare function migrateTapTestDescriptorV1(value: JsonValue): JsonObject;

export declare function migrateTapTests(options: TapProjectOptions & {
    dryRun?: boolean;
}, schemas: TapToolingSchemas): Promise<TapMigrateResult>;

/** Parse the executing public SDK package identity without accepting aliases. */
export declare function parseTapSdkPackageVersion(source: string): string;

export declare function scaffoldTapTests(options: TapProjectOptions & {
    check?: boolean;
}, schemas: TapToolingSchemas): Promise<TapScaffoldResult>;

export declare type TapContributionIdConstraint = Readonly<{
    minLength: number;
    maxLength: number;
    pattern: string;
}>;

/** Read the contribution-ID grammar from the Rust-generated package schema. */
export declare function tapContributionIdConstraint(manifestSchema: unknown): TapContributionIdConstraint;

export declare type TapDoctorDiagnostic = Readonly<{
    code: string;
    severity: 'error' | 'warning';
    message: string;
    path?: string;
}>;

export declare type TapDoctorResult = Readonly<{
    schemaVersion: 1;
    command: 'doctor';
    ok: boolean;
    packageId?: string;
    sdkVersion: string;
    root: string;
    diagnostics: readonly TapDoctorDiagnostic[];
}>;

export declare type TapManifestInventory = Readonly<{
    packageId: string;
    sdkVersion: string;
    targets: readonly string[];
    surfaces: readonly TapManifestSurface[];
}>;

export declare type TapManifestSurface = Readonly<{
    id: string;
    targets: readonly string[];
    authorizationActions: readonly string[];
    authorizationEffects: readonly string[];
    effectDenialActions: Readonly<Record<string, readonly string[]>>;
    highRiskCapabilities: readonly string[];
    requiredOrigins: readonly string[];
}>;

export declare type TapMatrixRow = Readonly<{
    id: string;
    profile: string;
    surface: string;
    target: string;
    mode: string;
    permissionScenario: string;
    deniedActions: readonly string[];
    requiredEffects: readonly string[];
    capabilities: readonly string[];
    testMatch: readonly string[];
}>;

export declare type TapMigrateResult = Readonly<{
    schemaVersion: 1;
    command: 'migrate';
    ok: boolean;
    changed: boolean;
    dryRun: boolean;
    descriptorPath: string;
    backupPath?: string;
    descriptor: JsonObject;
}>;

export declare type TapProjectOptions = Readonly<{
    root: string;
    manifestPath?: string;
    descriptorPath?: string;
}>;

export declare type TapScaffoldFileStatus = Readonly<{
    path: string;
    status: 'created' | 'missing' | 'preserved';
}>;

export declare type TapScaffoldResult = Readonly<{
    schemaVersion: 1;
    command: 'scaffold';
    ok: boolean;
    check: boolean;
    packageId: string;
    root: string;
    files: readonly TapScaffoldFileStatus[];
}>;

export declare type TapToolingSchemas = Readonly<{
    manifest: JsonValue;
    testDescriptor: JsonValue;
}>;

export { }