@lucern/sdk 0.2.0-alpha.6 → 0.2.0-alpha.7

package/dist/lib/platform/sdk/controlObjectOwnership.d.ts

@@ -1,308 +0,0 @@
-/** All recognized control object kinds in the ownership model. */
-export declare const CONTROL_OBJECT_KINDS: readonly ["tenant", "workspace", "principal", "tool", "pack", "ontology", "belief", "policy_rule"];
-/** A kind of control object (tenant, workspace, principal, tool, etc.). */
-export type ControlObjectKind = (typeof CONTROL_OBJECT_KINDS)[number];
-/** Canonical ownership scopes: platform, tenant, workspace, or resource. */
-export declare const CONTROL_OBJECT_OWNER_SCOPES: readonly ["platform", "tenant", "workspace", "resource"];
-/** The scope level that canonically owns a control object. */
-export type ControlObjectOwnerScope = (typeof CONTROL_OBJECT_OWNER_SCOPES)[number];
-/** UI surfaces authorized to edit control objects. */
-export declare const CONTROL_OBJECT_EDIT_SURFACES: readonly ["platform_admin", "tenant_admin", "workspace_admin", "graph_worktree"];
-/** A UI surface authorized to mutate a control object (platform admin, tenant admin, etc.). */
-export type ControlObjectEditSurface = (typeof CONTROL_OBJECT_EDIT_SURFACES)[number];
-/** Rules governing how control object configuration flows through the scope hierarchy. */
-export declare const CONTROL_OBJECT_INHERITANCE_RULES: readonly ["none", "platform_seed_to_tenant", "tenant_default_to_workspace", "workspace_narrowing_only", "pack_overlay_to_tenant", "topic_lineage_to_resource"];
-/** How a control object's configuration propagates through scope hierarchy. */
-export type ControlObjectInheritanceRule = (typeof CONTROL_OBJECT_INHERITANCE_RULES)[number];
-/** Scope of impact when a control object is modified. */
-export declare const CONTROL_OBJECT_BLAST_RADII: readonly ["platform", "tenant", "workspace", "resource"];
-/** The furthest scope impacted by a mutation to a control object. */
-export type ControlObjectBlastRadius = (typeof CONTROL_OBJECT_BLAST_RADII)[number];
-/** A single row in the ownership matrix describing who owns, edits, and inherits a control object. */
-export type ControlObjectOwnershipCase = {
-    caseKey: string;
-    caseLabel: string;
-    kind: ControlObjectKind;
-    canonicalOwnerScope: ControlObjectOwnerScope;
-    editSurface: ControlObjectEditSurface;
-    inheritanceRule: ControlObjectInheritanceRule;
-    blastRadius: ControlObjectBlastRadius;
-};
-/** Full ownership matrix keyed by control object kind. */
-export type ControlObjectOwnershipMatrix = Record<ControlObjectKind, readonly ControlObjectOwnershipCase[]>;
-/** Versioned ownership contract bundling all enums, the matrix, and flattened rows. */
-export type ControlObjectOwnershipContract = {
-    version: "1.0.0";
-    kinds: readonly ControlObjectKind[];
-    ownerScopes: readonly ControlObjectOwnerScope[];
-    editSurfaces: readonly ControlObjectEditSurface[];
-    inheritanceRules: readonly ControlObjectInheritanceRule[];
-    blastRadii: readonly ControlObjectBlastRadius[];
-    matrix: ControlObjectOwnershipMatrix;
-    rows: readonly ControlObjectOwnershipCase[];
-};
-/** Static ownership matrix mapping each control object kind to its ownership cases. */
-export declare const CONTROL_OBJECT_OWNERSHIP_MATRIX: {
-    readonly tenant: readonly [{
-        readonly caseKey: "platform-record";
-        readonly caseLabel: "Platform Record";
-        readonly kind: "tenant";
-        readonly canonicalOwnerScope: "platform";
-        readonly editSurface: "platform_admin";
-        readonly inheritanceRule: "none";
-        readonly blastRadius: "tenant";
-    }];
-    readonly workspace: readonly [{
-        readonly caseKey: "tenant-workspace";
-        readonly caseLabel: "Tenant Workspace";
-        readonly kind: "workspace";
-        readonly canonicalOwnerScope: "tenant";
-        readonly editSurface: "tenant_admin";
-        readonly inheritanceRule: "tenant_default_to_workspace";
-        readonly blastRadius: "workspace";
-    }];
-    readonly principal: readonly [{
-        readonly caseKey: "tenant-principal";
-        readonly caseLabel: "Tenant Principal";
-        readonly kind: "principal";
-        readonly canonicalOwnerScope: "tenant";
-        readonly editSurface: "tenant_admin";
-        readonly inheritanceRule: "workspace_narrowing_only";
-        readonly blastRadius: "resource";
-    }];
-    readonly tool: readonly [{
-        readonly caseKey: "platform-core";
-        readonly caseLabel: "Platform Core";
-        readonly kind: "tool";
-        readonly canonicalOwnerScope: "platform";
-        readonly editSurface: "platform_admin";
-        readonly inheritanceRule: "platform_seed_to_tenant";
-        readonly blastRadius: "platform";
-    }, {
-        readonly caseKey: "tenant-custom";
-        readonly caseLabel: "Tenant Custom";
-        readonly kind: "tool";
-        readonly canonicalOwnerScope: "tenant";
-        readonly editSurface: "tenant_admin";
-        readonly inheritanceRule: "tenant_default_to_workspace";
-        readonly blastRadius: "tenant";
-    }];
-    readonly pack: readonly [{
-        readonly caseKey: "platform-definition";
-        readonly caseLabel: "Platform Definition";
-        readonly kind: "pack";
-        readonly canonicalOwnerScope: "platform";
-        readonly editSurface: "platform_admin";
-        readonly inheritanceRule: "platform_seed_to_tenant";
-        readonly blastRadius: "platform";
-    }, {
-        readonly caseKey: "tenant-installation";
-        readonly caseLabel: "Tenant Installation";
-        readonly kind: "pack";
-        readonly canonicalOwnerScope: "tenant";
-        readonly editSurface: "tenant_admin";
-        readonly inheritanceRule: "platform_seed_to_tenant";
-        readonly blastRadius: "tenant";
-    }];
-    readonly ontology: readonly [{
-        readonly caseKey: "platform-base";
-        readonly caseLabel: "Platform Base";
-        readonly kind: "ontology";
-        readonly canonicalOwnerScope: "platform";
-        readonly editSurface: "platform_admin";
-        readonly inheritanceRule: "platform_seed_to_tenant";
-        readonly blastRadius: "platform";
-    }, {
-        readonly caseKey: "pack-overlay";
-        readonly caseLabel: "Pack Overlay";
-        readonly kind: "ontology";
-        readonly canonicalOwnerScope: "platform";
-        readonly editSurface: "platform_admin";
-        readonly inheritanceRule: "pack_overlay_to_tenant";
-        readonly blastRadius: "platform";
-    }, {
-        readonly caseKey: "tenant-extension";
-        readonly caseLabel: "Tenant Extension";
-        readonly kind: "ontology";
-        readonly canonicalOwnerScope: "tenant";
-        readonly editSurface: "tenant_admin";
-        readonly inheritanceRule: "topic_lineage_to_resource";
-        readonly blastRadius: "tenant";
-    }];
-    readonly belief: readonly [{
-        readonly caseKey: "topic-resource";
-        readonly caseLabel: "Topic Resource";
-        readonly kind: "belief";
-        readonly canonicalOwnerScope: "resource";
-        readonly editSurface: "graph_worktree";
-        readonly inheritanceRule: "topic_lineage_to_resource";
-        readonly blastRadius: "resource";
-    }];
-    readonly policy_rule: readonly [{
-        readonly caseKey: "platform-baseline";
-        readonly caseLabel: "Platform Baseline";
-        readonly kind: "policy_rule";
-        readonly canonicalOwnerScope: "platform";
-        readonly editSurface: "platform_admin";
-        readonly inheritanceRule: "platform_seed_to_tenant";
-        readonly blastRadius: "platform";
-    }, {
-        readonly caseKey: "tenant-bundle";
-        readonly caseLabel: "Tenant Bundle";
-        readonly kind: "policy_rule";
-        readonly canonicalOwnerScope: "tenant";
-        readonly editSurface: "tenant_admin";
-        readonly inheritanceRule: "tenant_default_to_workspace";
-        readonly blastRadius: "tenant";
-    }, {
-        readonly caseKey: "workspace-override";
-        readonly caseLabel: "Workspace Override";
-        readonly kind: "policy_rule";
-        readonly canonicalOwnerScope: "workspace";
-        readonly editSurface: "workspace_admin";
-        readonly inheritanceRule: "none";
-        readonly blastRadius: "workspace";
-    }];
-};
-/** Flattened array of all ownership cases across all control object kinds. */
-export declare const CONTROL_OBJECT_OWNERSHIP_ROWS: readonly ControlObjectOwnershipCase[];
-/** The canonical ownership contract exposed by the SDK. */
-export declare const CONTROL_OBJECT_OWNERSHIP_CONTRACT: {
-    readonly version: "1.0.0";
-    readonly kinds: readonly ["tenant", "workspace", "principal", "tool", "pack", "ontology", "belief", "policy_rule"];
-    readonly ownerScopes: readonly ["platform", "tenant", "workspace", "resource"];
-    readonly editSurfaces: readonly ["platform_admin", "tenant_admin", "workspace_admin", "graph_worktree"];
-    readonly inheritanceRules: readonly ["none", "platform_seed_to_tenant", "tenant_default_to_workspace", "workspace_narrowing_only", "pack_overlay_to_tenant", "topic_lineage_to_resource"];
-    readonly blastRadii: readonly ["platform", "tenant", "workspace", "resource"];
-    readonly matrix: {
-        readonly tenant: readonly [{
-            readonly caseKey: "platform-record";
-            readonly caseLabel: "Platform Record";
-            readonly kind: "tenant";
-            readonly canonicalOwnerScope: "platform";
-            readonly editSurface: "platform_admin";
-            readonly inheritanceRule: "none";
-            readonly blastRadius: "tenant";
-        }];
-        readonly workspace: readonly [{
-            readonly caseKey: "tenant-workspace";
-            readonly caseLabel: "Tenant Workspace";
-            readonly kind: "workspace";
-            readonly canonicalOwnerScope: "tenant";
-            readonly editSurface: "tenant_admin";
-            readonly inheritanceRule: "tenant_default_to_workspace";
-            readonly blastRadius: "workspace";
-        }];
-        readonly principal: readonly [{
-            readonly caseKey: "tenant-principal";
-            readonly caseLabel: "Tenant Principal";
-            readonly kind: "principal";
-            readonly canonicalOwnerScope: "tenant";
-            readonly editSurface: "tenant_admin";
-            readonly inheritanceRule: "workspace_narrowing_only";
-            readonly blastRadius: "resource";
-        }];
-        readonly tool: readonly [{
-            readonly caseKey: "platform-core";
-            readonly caseLabel: "Platform Core";
-            readonly kind: "tool";
-            readonly canonicalOwnerScope: "platform";
-            readonly editSurface: "platform_admin";
-            readonly inheritanceRule: "platform_seed_to_tenant";
-            readonly blastRadius: "platform";
-        }, {
-            readonly caseKey: "tenant-custom";
-            readonly caseLabel: "Tenant Custom";
-            readonly kind: "tool";
-            readonly canonicalOwnerScope: "tenant";
-            readonly editSurface: "tenant_admin";
-            readonly inheritanceRule: "tenant_default_to_workspace";
-            readonly blastRadius: "tenant";
-        }];
-        readonly pack: readonly [{
-            readonly caseKey: "platform-definition";
-            readonly caseLabel: "Platform Definition";
-            readonly kind: "pack";
-            readonly canonicalOwnerScope: "platform";
-            readonly editSurface: "platform_admin";
-            readonly inheritanceRule: "platform_seed_to_tenant";
-            readonly blastRadius: "platform";
-        }, {
-            readonly caseKey: "tenant-installation";
-            readonly caseLabel: "Tenant Installation";
-            readonly kind: "pack";
-            readonly canonicalOwnerScope: "tenant";
-            readonly editSurface: "tenant_admin";
-            readonly inheritanceRule: "platform_seed_to_tenant";
-            readonly blastRadius: "tenant";
-        }];
-        readonly ontology: readonly [{
-            readonly caseKey: "platform-base";
-            readonly caseLabel: "Platform Base";
-            readonly kind: "ontology";
-            readonly canonicalOwnerScope: "platform";
-            readonly editSurface: "platform_admin";
-            readonly inheritanceRule: "platform_seed_to_tenant";
-            readonly blastRadius: "platform";
-        }, {
-            readonly caseKey: "pack-overlay";
-            readonly caseLabel: "Pack Overlay";
-            readonly kind: "ontology";
-            readonly canonicalOwnerScope: "platform";
-            readonly editSurface: "platform_admin";
-            readonly inheritanceRule: "pack_overlay_to_tenant";
-            readonly blastRadius: "platform";
-        }, {
-            readonly caseKey: "tenant-extension";
-            readonly caseLabel: "Tenant Extension";
-            readonly kind: "ontology";
-            readonly canonicalOwnerScope: "tenant";
-            readonly editSurface: "tenant_admin";
-            readonly inheritanceRule: "topic_lineage_to_resource";
-            readonly blastRadius: "tenant";
-        }];
-        readonly belief: readonly [{
-            readonly caseKey: "topic-resource";
-            readonly caseLabel: "Topic Resource";
-            readonly kind: "belief";
-            readonly canonicalOwnerScope: "resource";
-            readonly editSurface: "graph_worktree";
-            readonly inheritanceRule: "topic_lineage_to_resource";
-            readonly blastRadius: "resource";
-        }];
-        readonly policy_rule: readonly [{
-            readonly caseKey: "platform-baseline";
-            readonly caseLabel: "Platform Baseline";
-            readonly kind: "policy_rule";
-            readonly canonicalOwnerScope: "platform";
-            readonly editSurface: "platform_admin";
-            readonly inheritanceRule: "platform_seed_to_tenant";
-            readonly blastRadius: "platform";
-        }, {
-            readonly caseKey: "tenant-bundle";
-            readonly caseLabel: "Tenant Bundle";
-            readonly kind: "policy_rule";
-            readonly canonicalOwnerScope: "tenant";
-            readonly editSurface: "tenant_admin";
-            readonly inheritanceRule: "tenant_default_to_workspace";
-            readonly blastRadius: "tenant";
-        }, {
-            readonly caseKey: "workspace-override";
-            readonly caseLabel: "Workspace Override";
-            readonly kind: "policy_rule";
-            readonly canonicalOwnerScope: "workspace";
-            readonly editSurface: "workspace_admin";
-            readonly inheritanceRule: "none";
-            readonly blastRadius: "workspace";
-        }];
-    };
-    readonly rows: readonly ControlObjectOwnershipCase[];
-};
-/**
- * List ownership cases for one control-object kind or the full matrix.
- */
-export declare function listControlObjectOwnershipCases(kind?: ControlObjectKind): readonly ControlObjectOwnershipCase[];
-/**
- * Get a specific ownership case by kind and case key.
- */
-export declare function getControlObjectOwnershipCase(kind: ControlObjectKind, caseKey: string): ControlObjectOwnershipCase | undefined;

package/dist/lib/platform/sdk/controlObjectOwnership.js

@@ -1,220 +0,0 @@
-/** All recognized control object kinds in the ownership model. */
-export const CONTROL_OBJECT_KINDS = [
-    "tenant",
-    "workspace",
-    "principal",
-    "tool",
-    "pack",
-    "ontology",
-    "belief",
-    "policy_rule",
-];
-/** Canonical ownership scopes: platform, tenant, workspace, or resource. */
-export const CONTROL_OBJECT_OWNER_SCOPES = [
-    "platform",
-    "tenant",
-    "workspace",
-    "resource",
-];
-/** UI surfaces authorized to edit control objects. */
-export const CONTROL_OBJECT_EDIT_SURFACES = [
-    "platform_admin",
-    "tenant_admin",
-    "workspace_admin",
-    "graph_worktree",
-];
-/** Rules governing how control object configuration flows through the scope hierarchy. */
-export const CONTROL_OBJECT_INHERITANCE_RULES = [
-    "none",
-    "platform_seed_to_tenant",
-    "tenant_default_to_workspace",
-    "workspace_narrowing_only",
-    "pack_overlay_to_tenant",
-    "topic_lineage_to_resource",
-];
-/** Scope of impact when a control object is modified. */
-export const CONTROL_OBJECT_BLAST_RADII = [
-    "platform",
-    "tenant",
-    "workspace",
-    "resource",
-];
-function defineCases(cases) {
-    return cases;
-}
-/** Static ownership matrix mapping each control object kind to its ownership cases. */
-export const CONTROL_OBJECT_OWNERSHIP_MATRIX = {
-    tenant: defineCases([
-        {
-            caseKey: "platform-record",
-            caseLabel: "Platform Record",
-            kind: "tenant",
-            canonicalOwnerScope: "platform",
-            editSurface: "platform_admin",
-            inheritanceRule: "none",
-            blastRadius: "tenant",
-        },
-    ]),
-    workspace: defineCases([
-        {
-            caseKey: "tenant-workspace",
-            caseLabel: "Tenant Workspace",
-            kind: "workspace",
-            canonicalOwnerScope: "tenant",
-            editSurface: "tenant_admin",
-            inheritanceRule: "tenant_default_to_workspace",
-            blastRadius: "workspace",
-        },
-    ]),
-    principal: defineCases([
-        {
-            caseKey: "tenant-principal",
-            caseLabel: "Tenant Principal",
-            kind: "principal",
-            canonicalOwnerScope: "tenant",
-            editSurface: "tenant_admin",
-            inheritanceRule: "workspace_narrowing_only",
-            blastRadius: "resource",
-        },
-    ]),
-    tool: defineCases([
-        {
-            caseKey: "platform-core",
-            caseLabel: "Platform Core",
-            kind: "tool",
-            canonicalOwnerScope: "platform",
-            editSurface: "platform_admin",
-            inheritanceRule: "platform_seed_to_tenant",
-            blastRadius: "platform",
-        },
-        {
-            caseKey: "tenant-custom",
-            caseLabel: "Tenant Custom",
-            kind: "tool",
-            canonicalOwnerScope: "tenant",
-            editSurface: "tenant_admin",
-            inheritanceRule: "tenant_default_to_workspace",
-            blastRadius: "tenant",
-        },
-    ]),
-    pack: defineCases([
-        {
-            caseKey: "platform-definition",
-            caseLabel: "Platform Definition",
-            kind: "pack",
-            canonicalOwnerScope: "platform",
-            editSurface: "platform_admin",
-            inheritanceRule: "platform_seed_to_tenant",
-            blastRadius: "platform",
-        },
-        {
-            caseKey: "tenant-installation",
-            caseLabel: "Tenant Installation",
-            kind: "pack",
-            canonicalOwnerScope: "tenant",
-            editSurface: "tenant_admin",
-            inheritanceRule: "platform_seed_to_tenant",
-            blastRadius: "tenant",
-        },
-    ]),
-    ontology: defineCases([
-        {
-            caseKey: "platform-base",
-            caseLabel: "Platform Base",
-            kind: "ontology",
-            canonicalOwnerScope: "platform",
-            editSurface: "platform_admin",
-            inheritanceRule: "platform_seed_to_tenant",
-            blastRadius: "platform",
-        },
-        {
-            caseKey: "pack-overlay",
-            caseLabel: "Pack Overlay",
-            kind: "ontology",
-            canonicalOwnerScope: "platform",
-            editSurface: "platform_admin",
-            inheritanceRule: "pack_overlay_to_tenant",
-            blastRadius: "platform",
-        },
-        {
-            caseKey: "tenant-extension",
-            caseLabel: "Tenant Extension",
-            kind: "ontology",
-            canonicalOwnerScope: "tenant",
-            editSurface: "tenant_admin",
-            inheritanceRule: "topic_lineage_to_resource",
-            blastRadius: "tenant",
-        },
-    ]),
-    belief: defineCases([
-        {
-            caseKey: "topic-resource",
-            caseLabel: "Topic Resource",
-            kind: "belief",
-            canonicalOwnerScope: "resource",
-            editSurface: "graph_worktree",
-            inheritanceRule: "topic_lineage_to_resource",
-            blastRadius: "resource",
-        },
-    ]),
-    policy_rule: defineCases([
-        {
-            caseKey: "platform-baseline",
-            caseLabel: "Platform Baseline",
-            kind: "policy_rule",
-            canonicalOwnerScope: "platform",
-            editSurface: "platform_admin",
-            inheritanceRule: "platform_seed_to_tenant",
-            blastRadius: "platform",
-        },
-        {
-            caseKey: "tenant-bundle",
-            caseLabel: "Tenant Bundle",
-            kind: "policy_rule",
-            canonicalOwnerScope: "tenant",
-            editSurface: "tenant_admin",
-            inheritanceRule: "tenant_default_to_workspace",
-            blastRadius: "tenant",
-        },
-        {
-            caseKey: "workspace-override",
-            caseLabel: "Workspace Override",
-            kind: "policy_rule",
-            canonicalOwnerScope: "workspace",
-            editSurface: "workspace_admin",
-            inheritanceRule: "none",
-            blastRadius: "workspace",
-        },
-    ]),
-};
-function flattenOwnershipMatrix(matrix) {
-    return CONTROL_OBJECT_KINDS.flatMap((kind) => [...matrix[kind]]);
-}
-/** Flattened array of all ownership cases across all control object kinds. */
-export const CONTROL_OBJECT_OWNERSHIP_ROWS = Object.freeze(flattenOwnershipMatrix(CONTROL_OBJECT_OWNERSHIP_MATRIX));
-/** The canonical ownership contract exposed by the SDK. */
-export const CONTROL_OBJECT_OWNERSHIP_CONTRACT = {
-    version: "1.0.0",
-    kinds: CONTROL_OBJECT_KINDS,
-    ownerScopes: CONTROL_OBJECT_OWNER_SCOPES,
-    editSurfaces: CONTROL_OBJECT_EDIT_SURFACES,
-    inheritanceRules: CONTROL_OBJECT_INHERITANCE_RULES,
-    blastRadii: CONTROL_OBJECT_BLAST_RADII,
-    matrix: CONTROL_OBJECT_OWNERSHIP_MATRIX,
-    rows: CONTROL_OBJECT_OWNERSHIP_ROWS,
-};
-/**
- * List ownership cases for one control-object kind or the full matrix.
- */
-export function listControlObjectOwnershipCases(kind) {
-    if (!kind) {
-        return CONTROL_OBJECT_OWNERSHIP_ROWS;
-    }
-    return CONTROL_OBJECT_OWNERSHIP_MATRIX[kind];
-}
-/**
- * Get a specific ownership case by kind and case key.
- */
-export function getControlObjectOwnershipCase(kind, caseKey) {
-    return CONTROL_OBJECT_OWNERSHIP_MATRIX[kind].find((ownershipCase) => ownershipCase.caseKey === caseKey);
-}

package/dist/lib/platform/sdk/coreClient.d.ts

@@ -1,139 +0,0 @@
-import type { JsonObject, JsonValue } from "./types";
-/** Tenant and workspace identifiers used to scope gateway requests. */
-export type GatewayScope = {
-    tenantId?: string;
-    workspaceId?: string;
-};
-/** Successful response envelope from the platform gateway with correlation metadata. */
-export type PlatformGatewaySuccess<T> = {
-    success: true;
-    data: T;
-    correlationId: string;
-    policyTraceId: string | null;
-    idempotentReplay: boolean;
-};
-/** Failed response envelope with structured error codes and optional invariant references. */
-export type PlatformGatewayFailure = {
-    success: false;
-    /**
-     * Error string is the canonical envelope field.
-     * Object form is legacy-only compatibility for older gateway responses.
-     */
-    error: string | {
-        code: string;
-        message: string;
-        details?: JsonValue;
-    };
-    code?: string;
-    invariant?: string | null;
-    suggestion?: string | null;
-    details?: JsonValue;
-    legacyError?: {
-        code: string;
-        message: string;
-        details?: JsonValue;
-    };
-    correlationId: string;
-    policyTraceId: string | null;
-};
-/** Discriminated union of success and failure gateway responses. */
-export type PlatformGatewayEnvelope<T> = PlatformGatewaySuccess<T> | PlatformGatewayFailure;
-/**
- * Structured error thrown when a platform API request fails.
- *
- * Includes HTTP status, machine-readable error code, optional invariant
- * reference, and actionable suggestions for common failure modes.
- */
-export declare class LucernApiError extends Error {
-    readonly code: string;
-    readonly status: number;
-    readonly invariant?: string | null;
-    readonly suggestion?: string | null;
-    readonly details?: JsonValue;
-    readonly requestId?: string;
-    readonly correlationId?: string;
-    readonly policyTraceId?: string | null;
-    constructor(args: {
-        code: string;
-        message: string;
-        status: number;
-        invariant?: string | null;
-        suggestion?: string | null;
-        details?: JsonValue;
-        requestId?: string;
-        correlationId?: string;
-        policyTraceId?: string | null;
-    });
-}
-/** Supported HTTP methods for gateway requests. */
-export type GatewayHttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
-type FetchLike = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
-/** Context passed to the `onRequest` hook before each gateway request attempt. */
-export type GatewayRequestHookContext = {
-    requestId: string;
-    attempt: number;
-    maxRetries: number;
-    method: GatewayHttpMethod;
-    path: string;
-    url: string;
-    headers: Headers;
-    body?: string;
-    timeoutMs: number;
-};
-/** Context passed to the `onResponse` hook after each gateway request attempt (including retries and failures). */
-export type GatewayResponseHookContext = GatewayRequestHookContext & {
-    durationMs: number;
-    status?: number;
-    response?: Response;
-    error?: unknown;
-    correlationId?: string;
-    policyTraceId?: string | null;
-    idempotentReplay?: boolean;
-    retryAfterMs?: number | null;
-    willRetry: boolean;
-};
-/**
- * Low-level transport configuration for the platform gateway client.
- *
- * Most developers should use {@link createLucernClient} instead, which wraps
- * this config with higher-level conveniences like `apiKey` and `environment`.
- */
-export type GatewayClientConfig = {
-    baseUrl?: string;
-    fetchImpl?: FetchLike;
-    getAuthHeaders?: (() => Promise<Record<string, string>>) | (() => Record<string, string>);
-    /** Max retries for transient errors (5xx, network). Defaults to 2. */
-    maxRetries?: number;
-    /** Request timeout in ms. Defaults to 15000. */
-    timeoutMs?: number;
-    /** Optional timeout overrides by HTTP method. */
-    timeoutMsByMethod?: Partial<Record<GatewayHttpMethod, number>>;
-    /** Optional request ID factory used for correlation headers. */
-    requestIdFactory?: () => string;
-    /** Invoked before each request attempt, including retries. */
-    onRequest?: ((context: GatewayRequestHookContext) => void) | ((context: GatewayRequestHookContext) => Promise<void>);
-    /** Invoked after each request attempt, including retries and failures. */
-    onResponse?: ((context: GatewayResponseHookContext) => void) | ((context: GatewayResponseHookContext) => Promise<void>);
-};
-/**
- * Serialize a gateway query object into a URL query string.
- */
-export declare function toQueryString(scope: GatewayScope & Record<string, string | number | boolean | undefined>): string;
-/**
- * Generate a random idempotency key for retry-safe writes.
- */
-export declare function randomIdempotencyKey(): string;
-/**
- * Create the transport client used by all SDK modules.
- */
-export declare function createGatewayRequestClient(config?: GatewayClientConfig): {
-    request: <T>(args: {
-        path: string;
-        method?: GatewayHttpMethod;
-        body?: JsonObject;
-        idempotencyKey?: string;
-        requestId?: string;
-        timeoutMs?: number;
-    }) => Promise<PlatformGatewaySuccess<T>>;
-};
-export {};