@happyvertical/smrt-types 0.51.32 → 0.51.34

package/dist/ai-usage.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Shared AI usage tracking types for SMRT.
+ *
+ * These types are intentionally provider-agnostic so SMRT can normalize
+ * telemetry emitted by the underlying AI SDK into a stable internal shape.
+ */
+/**
+ * Normalized token usage information for an AI call.
+ */
+export interface AiTokenUsage {
+    /** Number of input tokens consumed by the request */
+    promptTokens?: number;
+    /** Number of output tokens produced by the response */
+    completionTokens?: number;
+    /** Total tokens consumed across the call */
+    totalTokens?: number;
+}
+/**
+ * Stable usage event shape emitted inside SMRT after every AI call.
+ */
+export interface SmrtAiUsageEvent {
+    /** AI provider identifier (e.g. "openai", "anthropic") */
+    provider: string;
+    /** Model identifier used for the call */
+    model: string;
+    /** High-level operation name (e.g. "chat", "embed", "stream") */
+    operation: string;
+    /** Token usage reported by the provider, when available */
+    usage?: AiTokenUsage;
+    /** Wall-clock duration in milliseconds */
+    duration: number;
+    /** Event timestamp */
+    timestamp: Date;
+    /** Optional provider- or application-specific tags */
+    tags?: Record<string, string>;
+    /** SMRT class responsible for the call */
+    className?: string;
+    /** Tenant identifier when available */
+    tenantId?: string | null;
+    /** Best-effort estimated cost in USD */
+    estimatedCost?: number;
+}
+/**
+ * Persisted AI usage record returned from query helpers.
+ */
+export interface SmrtAiUsageRecord extends SmrtAiUsageEvent {
+    /** Persistent record identifier */
+    id: string;
+}
+/**
+ * Aggregated statistics bucket for AI usage reporting.
+ */
+export interface AiUsageStats {
+    /** Number of calls represented in the bucket */
+    callCount: number;
+    /** Sum of prompt/input tokens */
+    promptTokens: number;
+    /** Sum of completion/output tokens */
+    completionTokens: number;
+    /** Sum of total tokens */
+    totalTokens: number;
+    /** Sum of durations in milliseconds */
+    totalDuration: number;
+    /** Sum of estimated costs in USD */
+    estimatedCost: number;
+    /** Timestamp of the most recent event in epoch milliseconds */
+    lastUsed: number;
+}
+/**
+ * In-memory snapshot returned by the collector.
+ */
+export interface AiUsageSnapshot {
+    /** Usage aggregated by "provider:model" */
+    byModel: Record<string, AiUsageStats>;
+    /** Usage aggregated by "className:operation" */
+    byClass: Record<string, AiUsageStats>;
+    /** Total number of calls observed by the collector */
+    totalCalls: number;
+    /** Collector start time in epoch milliseconds */
+    startTime: number;
+}
+/**
+ * Callback interface for handling normalized AI usage events.
+ */
+export interface AiUsageHandler {
+    /**
+     * Handle a normalized AI usage event.
+     */
+    handle(event: SmrtAiUsageEvent): Promise<void>;
+}
+/**
+ * Grouping dimensions supported by summary helpers.
+ */
+export type AiUsageGroupBy = 'provider' | 'model' | 'class' | 'tenant' | 'operation' | 'day';
+/**
+ * Options for listing raw AI usage records from persistence.
+ */
+export interface AiUsageListOptions {
+    /** Only include records on or after this timestamp */
+    since?: Date;
+    /** Only include records before or at this timestamp */
+    until?: Date;
+    /** Filter by provider */
+    provider?: string;
+    /** Filter by model */
+    model?: string;
+    /** Filter by operation */
+    operation?: string;
+    /** Filter by SMRT class name */
+    className?: string;
+    /** Filter by tenant ID */
+    tenantId?: string | null;
+    /** Maximum number of rows to return */
+    limit?: number;
+    /** Number of rows to skip */
+    offset?: number;
+    /** Sort order */
+    orderBy?: 'timestamp DESC' | 'timestamp ASC';
+}
+/**
+ * Options for summarized AI usage queries.
+ */
+export interface AiUsageSummaryOptions extends Omit<AiUsageListOptions, 'limit' | 'offset' | 'orderBy'> {
+    /** Dimension to group summary buckets by */
+    groupBy?: AiUsageGroupBy;
+}
+//# sourceMappingURL=ai-usage.d.ts.map

package/dist/ai-usage.d.ts.map

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

package/dist/capability.d.ts

@@ -0,0 +1,61 @@
+/**
+ * One capability classification contract shared by every WebMCP declaration
+ * site (#2587). This module intentionally has no runtime code.
+ *
+ * Core classifies every canonical model tool at build time
+ * (`packages/core/src/generators/tool-schema.ts`) and emits the resolved
+ * `effect` / `idempotent` / `openWorld` on each `webMcpToolDefinitions` entry.
+ * smrt-web's browser registrar trusts that emitted metadata for canonical
+ * definitions instead of recomputing it, and keeps its own CRUD switch only
+ * as the fail-closed fallback for legacy definitions that carry no metadata.
+ * View intents (#2588) classify by this same contract where they are
+ * declared; playbook steps (#2589) inherit classification from the model
+ * operation they reference and never classify anything themselves.
+ *
+ * `smrt-web` cannot import this package — its dependency-DAG guardrails keep
+ * it free of every `@happyvertical/*` dependency (see its AGENTS.md) — so its
+ * `WebMcpToolEffect` mirrors {@link CapabilityEffect} structurally rather than
+ * importing it, the same way `data-query.ts` mirrors this package's bounded
+ * query envelope there. `smrt-core`'s `ToolEffect` (`src/registry/types.ts`)
+ * DOES alias {@link CapabilityEffect} directly, since core already depends on
+ * this package.
+ */
+/**
+ * Browser/agent-visible effect classification for a generated capability.
+ * `'read'` never mutates; `'write'` mutates within the application;
+ * `'destructive'` may remove or irreversibly change data.
+ */
+export type CapabilityEffect = 'read' | 'write' | 'destructive';
+/**
+ * Fully resolved capability classification for one declared action.
+ *
+ * **Fail-closed rule**: an undeclared capability resolves to
+ * `{ effect: 'destructive', idempotent: false, openWorld: true }` — the most
+ * restrictive exposure a policy can select. Every classifier in the mirror
+ * (core's generator, smrt-web's legacy fallback, and any future declaration
+ * site) MUST apply this exact default rather than inventing its own.
+ *
+ * **CRUD is fixed** and never overridden by a declaration:
+ * - `list` / `get` → `{ effect: 'read', idempotent: true, openWorld: false }`
+ * - `create` → `{ effect: 'write', idempotent: false, openWorld: false }`
+ * - `update` → `{ effect: 'write', idempotent: true, openWorld: false }`
+ * - `delete` → `{ effect: 'destructive', idempotent: true, openWorld: false }`
+ *
+ * Anything else (a custom action, a view intent, a playbook step) resolves
+ * through an explicit {@link CapabilityDeclaration}, defaulted per-field by
+ * the fail-closed rule above.
+ */
+export interface CapabilityClassification {
+    effect: CapabilityEffect;
+    /** Whether repeating the action with the same arguments is safe. */
+    idempotent: boolean;
+    /** Whether the action may interact outside the SMRT application. */
+    openWorld: boolean;
+}
+/**
+ * An author-supplied, partial classification. Any field a declaration omits
+ * resolves through the fail-closed rule documented on
+ * {@link CapabilityClassification}, never through a CRUD- or name-based guess.
+ */
+export type CapabilityDeclaration = Partial<CapabilityClassification>;
+//# sourceMappingURL=capability.d.ts.map

package/dist/capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../src/capability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,aAAa,CAAC;AAEhE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,gBAAgB,CAAC;IACzB,oEAAoE;IACpE,UAAU,EAAE,OAAO,CAAC;IACpB,oEAAoE;IACpE,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC"}

package/dist/data-query.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Transport-neutral, bounded data-query contract (#2444).
+ *
+ * This module intentionally has no runtime code. The core package owns
+ * normalization, policy enforcement, canonical fingerprints, and result
+ * validation; browser, REST, MCP, WebMCP, ContentList, and report adapters
+ * share these serializable shapes without importing a server runtime.
+ *
+ * Authority is deliberately absent. A query can name only adapter-declared
+ * field ids and operators; tenant, principal, SQL, relationship paths, and
+ * execution details belong to the authenticated adapter, never this envelope.
+ */
+/** JSON scalar values accepted in predicates, facets, and normalized rows. */
+export type DataQueryScalar = string | number | boolean | null;
+/** A stable, adapter-defined field identifier. It is never a property path. */
+export type DataQueryFieldId = string;
+/** Operators map to an adapter's allowlisted, typed predicate implementation. */
+export type DataQueryFilterOperator = 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'notIn' | 'like';
+/** One typed predicate. `in` and `notIn` require a non-empty value array. */
+export interface DataQueryCondition {
+    kind: 'condition';
+    field: DataQueryFieldId;
+    operator: DataQueryFilterOperator;
+    value: DataQueryScalar | DataQueryScalar[];
+}
+/** Bounded, recursive filter expression with explicit boolean semantics. */
+export type DataQueryFilter = DataQueryCondition | {
+    kind: 'all' | 'any';
+    filters: DataQueryFilter[];
+} | {
+    kind: 'not';
+    filter: DataQueryFilter;
+};
+export type DataQuerySortDirection = 'asc' | 'desc';
+/** Deterministic sort precedence; earlier terms take precedence. */
+export interface DataQuerySort {
+    field: DataQueryFieldId;
+    direction: DataQuerySortDirection;
+}
+/** Offset pagination is explicit so callers cannot smuggle arbitrary bounds. */
+export interface DataQueryOffsetPage {
+    kind: 'offset';
+    offset: number;
+    limit: number;
+}
+/** Cursor values are opaque to callers and bound to a normalized query. */
+export interface DataQueryCursorPage {
+    kind: 'cursor';
+    after?: string;
+    limit: number;
+}
+export type DataQueryPage = DataQueryOffsetPage | DataQueryCursorPage;
+/** Read consistency requested by a caller; adapters decide whether they support it. */
+export type DataQueryConsistencyMode = 'eventual' | 'snapshot';
+export interface DataQueryConsistency {
+    /** Prefer the adapter's most recently available data. */
+    mode: DataQueryConsistencyMode;
+    /** Optional RFC 3339 instant requested by a time-travel capable adapter. */
+    asOf?: string;
+}
+/** A bounded request for one declared facet. */
+export interface DataQueryFacetRequest {
+    field: DataQueryFieldId;
+    limit: number;
+}
+/**
+ * Canonical data-query request.
+ *
+ * A request id correlates transport logs and results only; it is intentionally
+ * excluded from the semantic query fingerprint. The query does not contain
+ * authority, raw database expressions, property paths, functions, or a
+ * transport-specific filter object.
+ */
+export interface DataQueryRequest {
+    version: 1;
+    requestId: string;
+    mode: 'rows' | 'count' | 'facets';
+    projection?: DataQueryFieldId[];
+    filter?: DataQueryFilter;
+    sort?: DataQuerySort[];
+    page?: DataQueryPage;
+    consistency?: DataQueryConsistency;
+    facets?: DataQueryFacetRequest[];
+}
+/** An explicitly declared query field and its capability allowlist. */
+export interface DataQueryFieldDescriptor {
+    id: DataQueryFieldId;
+    type: 'string' | 'number' | 'boolean' | 'datetime' | 'json';
+    projectable?: boolean;
+    sortable?: boolean;
+    facetable?: boolean;
+    filterOperators?: DataQueryFilterOperator[];
+}
+/**
+ * Per-adapter execution policy. It is trusted adapter configuration, never
+ * client input, and therefore carries the field allowlists the normalizer
+ * applies to requests and returned rows.
+ */
+export interface DataQuerySchema {
+    version: 1;
+    identityField: DataQueryFieldId;
+    fields: DataQueryFieldDescriptor[];
+    defaultPageLimit?: number;
+    maxPageLimit?: number;
+    maxResultBytes?: number;
+    defaultSort?: DataQuerySort[];
+    supports?: {
+        cursorPagination?: boolean;
+        consistency?: boolean;
+        facets?: boolean;
+    };
+}
+/** How a returned total was obtained, including the absence of a total. */
+export type DataQueryTotal = {
+    kind: 'exact';
+    value: number;
+    asOf?: string;
+} | {
+    kind: 'estimated';
+    value: number;
+    asOf?: string;
+} | {
+    kind: 'unavailable';
+    reason?: string;
+};
+/** Freshness metadata is declarative; it does not grant access to a snapshot. */
+export interface DataQueryFreshness {
+    state: 'fresh' | 'stale' | 'unknown';
+    asOf?: string;
+}
+/** A bounded facet value/count pair. */
+export interface DataQueryFacetValue {
+    value: DataQueryScalar;
+    count: number;
+}
+export interface DataQueryFacetResult {
+    field: DataQueryFieldId;
+    values: DataQueryFacetValue[];
+    truncated: boolean;
+}
+/** Rows use JSON-safe values; adapters must project only declared fields. */
+export type DataQueryRow = Record<string, unknown>;
+/**
+ * Normalized adapter result. `queryFingerprint` identifies the semantic query
+ * (not the request id or page cursor), while pagination state stays explicit.
+ */
+export interface DataQueryResult {
+    version: 1;
+    requestId: string;
+    queryFingerprint: string;
+    identityField: DataQueryFieldId;
+    rows: DataQueryRow[];
+    page?: {
+        kind: 'offset';
+        limit: number;
+        offset: number;
+        hasMore: boolean;
+    } | {
+        kind: 'cursor';
+        limit: number;
+        nextCursor?: string;
+        hasMore: boolean;
+    };
+    total: DataQueryTotal;
+    facets?: DataQueryFacetResult[];
+    freshness: DataQueryFreshness;
+    warnings: string[];
+    truncated: boolean;
+}
+//# sourceMappingURL=data-query.d.ts.map

package/dist/data-query.d.ts.map

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

package/dist/data-surface.d.ts

@@ -0,0 +1,283 @@
+/**
+ * Transport-neutral data-surface contracts.
+ *
+ * These declarations describe bounded browser/server action envelopes and
+ * mounted-surface metadata. They carry neither authority nor execution:
+ * authenticated adapters own both.
+ */
+export type DataSurfaceJsonPrimitive = string | number | boolean | null;
+export type DataSurfaceJsonValue = DataSurfaceJsonPrimitive | DataSurfaceJsonValue[] | {
+    [key: string]: DataSurfaceJsonValue;
+};
+export type DataSurfaceJsonObject = {
+    [key: string]: DataSurfaceJsonValue;
+};
+export type DataSurfaceRowId = string | number;
+export type DataSurfaceKind = 'table' | 'list' | 'report' | 'custom';
+export type DataSurfaceSensitivity = 'public' | 'personal' | 'sensitive' | 'secret';
+export interface DataSurfaceSubject {
+    type: string;
+    id: string;
+    label?: string;
+}
+/** Stable address for one mounted instance, never an authority boundary. */
+export interface DataSurfaceIdentity {
+    surfaceId: string;
+    kind: DataSurfaceKind;
+    subject?: DataSurfaceSubject;
+}
+export type DataSurfaceColumnCapability = 'read' | 'search' | 'filter' | 'sort' | 'project';
+/** Presentation tier emitted by policy-aware domain adapters. */
+export type DataSurfaceColumnVisibility = 'basic' | 'advanced' | 'hidden';
+/** A domain-neutral column role. Adapters use roles to protect structural columns. */
+export type DataSurfaceColumnRole = 'data' | 'status' | 'computed' | 'row-key' | 'selection' | 'action';
+/** Operator allowlists are intentionally strings: #2444 owns query semantics. */
+export interface DataSurfaceColumnOperators {
+    search?: string[];
+    filter?: string[];
+    sort?: string[];
+}
+export interface DataSurfaceColumnDescriptor {
+    id: string;
+    label: string;
+    description?: string;
+    sensitivity?: DataSurfaceSensitivity;
+    capabilities: DataSurfaceColumnCapability[];
+    /** Domain field identity; never accepted as a request path. */
+    fieldName?: string;
+    /** Effective policy visibility, when a domain adapter supplies one. */
+    visibility?: DataSurfaceColumnVisibility;
+    /** Stable policy order; domain column ids remain unchanged. */
+    order?: number;
+    /** Structural columns are preserved even when field policy narrows data columns. */
+    role?: DataSurfaceColumnRole;
+    /** Responsive adapters consume this without importing DataTable types. */
+    responsivePriority?: number;
+    /** Per-operation operator allowlists, narrowed by policy adapters. */
+    operators?: DataSurfaceColumnOperators;
+    /** Explicit aliases for adapters that mirror the canonical query schema. */
+    searchOperators?: string[];
+    filterOperators?: string[];
+    sortOperators?: string[];
+    /** Explicit readability is useful when read capability is policy-gated. */
+    readable?: boolean;
+}
+/** #2444 owns the canonical query language; this declares only its bounds. */
+export type DataSurfaceQueryMode = 'rows' | 'count' | 'facets';
+export interface DataSurfaceQueryCapabilities {
+    modes: DataSurfaceQueryMode[];
+    /** Explicit allowlist; field paths are not accepted in requests. */
+    projectableColumnIds: string[];
+    /** Explicit allowlists for non-projection query operations. */
+    searchableColumnIds?: string[];
+    filterableColumnIds?: string[];
+    sortableColumnIds?: string[];
+}
+export interface DataSurfaceVisibleControl {
+    /** Stable command name accepted by the mounted surface. */
+    id: string;
+    label: string;
+    description?: string;
+}
+export type DataSurfaceSelectionScope = 'current-page' | 'explicit-ids' | 'all-matching';
+export interface DataSurfaceActionDescriptor {
+    id: string;
+    label: string;
+    description?: string;
+    sensitivity?: DataSurfaceSensitivity;
+    selectionScopes: DataSurfaceSelectionScope[];
+    requiresConfirmation?: boolean;
+    /** Optional column dependencies used by field-policy adapters. */
+    columnIds?: string[];
+}
+/** Per-surface limits; generic envelopes use DATA_SURFACE_MAX_REQUEST_BYTES. */
+export interface DataSurfaceLimits {
+    maxQueryRows: number;
+    maxQueryBytes: number;
+    maxSelectionSize: number;
+}
+/** Public, serializable discovery metadata for a mounted data surface. */
+export interface DataSurfaceDescriptor {
+    version: 1;
+    identity: DataSurfaceIdentity;
+    /** Version of the domain adapter's descriptor and view-state schema. */
+    schemaVersion: number;
+    label: string;
+    description?: string;
+    /** Stable row-identity column, including when it is not visibly rendered. */
+    rowKey: string;
+    columns: DataSurfaceColumnDescriptor[];
+    query: DataSurfaceQueryCapabilities;
+    controls: DataSurfaceVisibleControl[];
+    actions: DataSurfaceActionDescriptor[];
+    limits: DataSurfaceLimits;
+}
+export type DataSurfaceSelectionReference = {
+    scope: 'current-page';
+} | {
+    scope: 'explicit-ids';
+    rowIds: DataSurfaceRowId[];
+} | {
+    scope: 'all-matching';
+    queryFingerprint: string;
+};
+/** Input supplied by a mounted renderer/controller, before registry wrapping. */
+export interface DataSurfaceSnapshotState {
+    revision: number;
+    state: DataSurfaceJsonObject;
+    selection?: DataSurfaceSelectionReference | null;
+}
+/** Deterministic inspect/result envelope. It intentionally has no timestamp. */
+export interface DataSurfaceSnapshot {
+    version: 1;
+    descriptor: DataSurfaceDescriptor;
+    revision: number;
+    state: DataSurfaceJsonObject;
+    selection: DataSurfaceSelectionReference | null;
+}
+/** A browser-visible state transition, not a server-side query or mutation. */
+export interface DataSurfaceVisibleCommand {
+    version: 1;
+    commandId: string;
+    identity: DataSurfaceIdentity;
+    expectedRevision: number;
+    controlId: string;
+    payload?: DataSurfaceJsonValue;
+}
+export type DataSurfaceCommandFailureReason = 'not_found' | 'unsupported' | 'stale_revision' | 'idempotency_conflict' | 'denied' | 'execution_failed' | 'non_monotonic_revision';
+export interface DataSurfaceCommandResult {
+    ok: boolean;
+    commandId: string;
+    identity: DataSurfaceIdentity;
+    revision?: number;
+    snapshot?: DataSurfaceSnapshot;
+    reason?: DataSurfaceCommandFailureReason;
+}
+/**
+ * This intentionally contains only bounded read shape. #2444 adds the
+ * canonical filters, ordering, cursors, totals, and normalized result details.
+ */
+export type DataSurfaceQueryRequest = {
+    version: 1;
+    requestId: string;
+    identity: DataSurfaceIdentity;
+    kind: 'rows';
+    limit: number;
+    cursor?: string;
+    projection?: string[];
+} | {
+    version: 1;
+    requestId: string;
+    identity: DataSurfaceIdentity;
+    kind: 'count';
+} | {
+    version: 1;
+    requestId: string;
+    identity: DataSurfaceIdentity;
+    kind: 'facets';
+    columnId: string;
+    limit: number;
+};
+interface DataSurfaceQueryResultBase {
+    version: 1;
+    requestId: string;
+    identity: DataSurfaceIdentity;
+    revision: number;
+}
+/** Bounded read result shapes; #2444 owns their canonical query semantics. */
+export type DataSurfaceQueryResult = (DataSurfaceQueryResultBase & {
+    kind: 'rows';
+    rowKey: string;
+    rows: DataSurfaceJsonObject[];
+    hasMore: boolean;
+    truncated: boolean;
+    nextCursor?: string;
+}) | (DataSurfaceQueryResultBase & {
+    kind: 'count';
+    count: number;
+}) | (DataSurfaceQueryResultBase & {
+    kind: 'facets';
+    columnId: string;
+    facets: Array<{
+        value: DataSurfaceJsonPrimitive;
+        count: number;
+    }>;
+    truncated: boolean;
+});
+/** Preview/apply is a contract only here; server-side adapters execute it. */
+export interface DataSurfaceActionRequest {
+    version: 1;
+    requestId: string;
+    identity: DataSurfaceIdentity;
+    actionId: string;
+    phase: 'preview' | 'apply';
+    selection: DataSurfaceSelectionReference;
+    payload?: DataSurfaceJsonValue;
+    /** Opaque confirmation produced by a prior preview, never an authority. */
+    confirmationToken?: string;
+}
+/**
+ * Canonical wire request for principal-bound server adapters. A preview can
+ * omit the idempotency key; apply requires it at the server boundary.
+ */
+export interface DataSurfaceActionWireRequest extends DataSurfaceActionRequest {
+    expectedRevision: number;
+    idempotencyKey?: string;
+}
+export interface DataSurfaceActionResult {
+    version: 1;
+    requestId: string;
+    identity: DataSurfaceIdentity;
+    actionId: string;
+    phase: 'preview' | 'apply';
+    ok: boolean;
+    reason?: string;
+    confirmationToken?: string;
+    details?: DataSurfaceJsonObject;
+}
+/** Serializable outcome for one server-resolved row in an action. */
+export interface DataSurfaceActionRowOutcome {
+    rowId: DataSurfaceRowId;
+    status: 'accepted' | 'skipped' | 'failed';
+    reason?: string;
+    metadata?: DataSurfaceJsonObject;
+}
+export type DataSurfaceValidationReason = 'not_found' | 'unsupported' | 'invalid_request' | 'limit_exceeded' | 'projection_not_allowed' | 'selection_not_supported' | 'confirmation_required';
+export interface DataSurfaceValidationResult {
+    ok: boolean;
+    reason?: DataSurfaceValidationReason;
+}
+export type DataSurfaceCommandExecution = {
+    ok: false;
+} | undefined;
+/** Runtime-only handle supplied by a mounted renderer or controller. */
+export interface DataSurfaceRegistration {
+    descriptor: DataSurfaceDescriptor;
+    getSnapshot: () => DataSurfaceSnapshotState;
+    execute?: (command: DataSurfaceVisibleCommand) => DataSurfaceCommandExecution | Promise<DataSurfaceCommandExecution>;
+    /**
+     * A host-owned redaction boundary. It cannot change identity or revision and
+     * the registry validates its output before exposing it.
+     */
+    redact?: (snapshot: DataSurfaceSnapshot) => DataSurfaceSnapshot;
+}
+export interface DataSurfaceRegistryEvent {
+    type: 'registered' | 'unregistered' | 'command';
+    sequence: number;
+    identity: DataSurfaceIdentity;
+    revision: number;
+    command?: DataSurfaceVisibleCommand;
+    result?: DataSurfaceCommandResult;
+}
+export interface DataSurfaceRegistry {
+    register(registration: DataSurfaceRegistration): () => void;
+    unregister(identity: DataSurfaceIdentity): void;
+    list(): DataSurfaceDescriptor[];
+    inspect(identity: DataSurfaceIdentity): DataSurfaceSnapshot | undefined;
+    execute(command: DataSurfaceVisibleCommand): Promise<DataSurfaceCommandResult>;
+    validateQuery(request: DataSurfaceQueryRequest): DataSurfaceValidationResult;
+    validateAction(request: DataSurfaceActionRequest): DataSurfaceValidationResult;
+    subscribe(listener: (event: DataSurfaceRegistryEvent) => void): () => void;
+}
+export {};
+//# sourceMappingURL=data-surface.d.ts.map

package/dist/data-surface.d.ts.map

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