@mostra/protocol 0.0.0-placeholder → 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,86 @@
+import { ARGUMENT_BIGINT_DIGITS_MAX, AnyFunction, Frame, RemoteError, SerializationError, SerializeMode, UNSERIALIZABLE_CODE, ValueReader, ValueReaderOptions, ValueWriter, ValueWriterOptions, WireError, checkArgumentFrames, deserializeAll, fromBase64, serializeAll, toBase64, wireError } from "./serializer.js";
+import { ACTION_ARGS_MAX, ACTION_RESULT_MAX, ActionError, Batches, CallLine, CallRequest, EphemeralMessage, LIVE_KEY_PATTERN, LIVE_RING_DEFAULT, LIVE_RING_MAX, LIVE_VALUE_MAX, LiveRequest, LiveState, LiveUpdate, RUN_KEY_MAX, RUN_LOG_MAX, RUN_LOG_TRUNCATED, RUN_STATUSES, RunAttachRequest, RunCancelRequest, RunDelta, RunProgress, RunReason, RunRequest, RunState, RunStatus, SECRET_NAME_PATTERN, SECRET_VALUE_MAX, isFinalRunStatus } from "./actions.js";
+import { ARTIFACT_MANIFEST_KEYS, ArtifactFamily, ArtifactLink, ArtifactManifest, DemoSpec, SubmissionPolicy, TerminalSpec } from "./manifest.js";
+import { ArtifactDetail, ArtifactRef, ArtifactSummary, PublishReceipt, SourceRef, VersionSummary } from "./artifact.js";
+import { ControlsPolicy, DeliveryTarget, REVIEW_SET_ID_PATTERN, SubmitChannel, TrustedControl, VersionRef, ViewContext, ViewContextWire, readViewContext } from "./view.js";
+import { AnyBridgeMessage, BRIDGE_FIELDS_MAX, BRIDGE_MESSAGES, BRIDGE_TEXT_MAX, Bridge, BridgeEvent, BridgeHostContext, BridgeImplementation, BridgeMessage, BridgeOptions, BridgePeer, BridgeReceiver, BridgeRejection, BridgeSide, CONTROL_LABEL_MAX, ControlRequest, FieldRegistration, FieldsParams, FlushResult, MCP_APPS_PROTOCOL_VERSION, OPEN_LINK_SCHEMES, SaveState, SubmitBlocker, UiInitializeParams, UiInitializeResult, VersionAvailableParams, connectBridge, mostraControlsRequest, mostraFieldFocus, mostraFields, mostraFlush, mostraPage, mostraReady, mostraVersionAvailable, uiInitialize, uiInitialized, uiOpenLink, uiSizeChanged } from "./bridge.js";
+import { ArtifactId, CommentId, Cursor, DeliveryId, GeneratedIdKind, Id, IdBody, IdKind, IdPrefix, MutationId, RunId, SubmissionId, ThreadId, TokenId, VersionId, VersionIdKind, ViewId, ViewerId } from "./ids.js";
+import { Actor, DeliveryState, DeliveryStatus, DocumentRevision, EventFilter, EventRecord, EventTypePattern, FIELD_ID_MAX_LENGTH, FieldConflict, FieldOp, FieldScope, FieldState, MutationResult, Rect, ResultComment, Results, SIGNAL_NAME_PATTERN, SubmissionSummary, Viewer, ViewerKind, ViewerSpec, Viewport, WaitCondition, isFieldId } from "./interaction.js";
+import { BROWSER_PROTOCOL_REVISION, BROWSER_PROTOCOL_REVISIONS, CarryOver, ChooseRequest, DocumentSnapshot, FieldsRequest, FollowRequest, FrameTicket, OrphanedField, PollResult, SIGNAL_PAYLOAD_MAX_BYTES, ShellSubmitRequest, SignalRequest, StreamSnapshot, SubmitRequest } from "./browser.js";
+import { BUNDLE_NAME, BUNDLE_PLATFORMS, BUNDLE_SETUP_MARKER, BundleAsset, BundleBrowser, BundleFileEntry, BundleFiles, BundleInfo, BundleLinkEntry, BundlePins, BundlePlatform, BundlePlatformSchema, BundleSetup, bundleAssetName } from "./bundle.js";
+import { canonicalJson } from "./canonical.js";
+import { ALL_SCOPES, CapabilityScope, Duration, durationMs, normalizeScopes, scopeAllows } from "./capability.js";
+import { DIAGNOSTIC_AREAS, Diagnostic, DiagnosticArea, DiagnosticCode, DiagnosticFix, DiagnosticLocation, DiagnosticPhase, DiagnosticSeverity } from "./diagnostics/diagnostic.js";
+import { AreaCatalog, DEFAULT_DOCS_BASE, DiagnosticDetails, DiagnosticSpec, docsUrl } from "./diagnostics/spec.js";
+import { A11yDiagnosticCode, a11yDiagnosticCodes } from "./diagnostics/codes/a11y.js";
+import { ActionDiagnosticCode, actionDiagnosticCodes } from "./diagnostics/codes/action.js";
+import { ArtifactDiagnosticCode, artifactDiagnosticCodes } from "./diagnostics/codes/artifact.js";
+import { BuildDiagnosticCode, buildDiagnosticCodes } from "./diagnostics/codes/build.js";
+import { CliDiagnosticCode, cliDiagnosticCodes } from "./diagnostics/codes/cli.js";
+import { ConsoleDiagnosticCode, consoleDiagnosticCodes } from "./diagnostics/codes/console.js";
+import { DepDiagnosticCode, depDiagnosticCodes } from "./diagnostics/codes/dep.js";
+import { EnvDiagnosticCode, envDiagnosticCodes } from "./diagnostics/codes/env.js";
+import { FieldDiagnosticCode, fieldDiagnosticCodes } from "./diagnostics/codes/field.js";
+import { HomeDiagnosticCode, homeDiagnosticCodes } from "./diagnostics/codes/home.js";
+import { HostDiagnosticCode, hostDiagnosticCodes } from "./diagnostics/codes/host.js";
+import { HygieneDiagnosticCode, hygieneDiagnosticCodes } from "./diagnostics/codes/hygiene.js";
+import { LiveDiagnosticCode, liveDiagnosticCodes } from "./diagnostics/codes/live.js";
+import { ManifestDiagnosticCode, manifestDiagnosticCodes } from "./diagnostics/codes/manifest.js";
+import { NetworkDiagnosticCode, networkDiagnosticCodes } from "./diagnostics/codes/network.js";
+import { PlatformDiagnosticCode, platformDiagnosticCodes } from "./diagnostics/codes/platform.js";
+import { PublishDiagnosticCode, publishDiagnosticCodes } from "./diagnostics/codes/publish.js";
+import { RegressionDiagnosticCode, regressionDiagnosticCodes } from "./diagnostics/codes/regression.js";
+import { RuntimeDiagnosticCode, runtimeDiagnosticCodes } from "./diagnostics/codes/runtime.js";
+import { SecretDiagnosticCode, secretDiagnosticCodes } from "./diagnostics/codes/secret.js";
+import { SmokeDiagnosticCode, smokeDiagnosticCodes } from "./diagnostics/codes/smoke.js";
+import { SubmitDiagnosticCode, submitDiagnosticCodes } from "./diagnostics/codes/submit.js";
+import { TargetDiagnosticCode, targetDiagnosticCodes } from "./diagnostics/codes/target.js";
+import { TypeDiagnosticCode, typeDiagnosticCodes } from "./diagnostics/codes/type.js";
+import { VerifyDiagnosticCode, verifyDiagnosticCodes } from "./diagnostics/codes/verify.js";
+import { CreateDiagnosticOptions, KnownDiagnosticCode, createDiagnostic, diagnosticCatalog } from "./diagnostics/codes/index.js";
+import { CSRF_HEADER, Refusal, RequestFacts, RequestIntent, RequestPolicy, checkRequest, headerValue, isJsonContentType, refusal, safeEqual, safePath } from "./hygiene.js";
+import { AnyMethod, MethodDefinition, MethodDirection, defineMethod } from "./method.js";
+import { ArtifactCreateParams, ArtifactCreateResult, artifactCreateMethod } from "./methods/artifact/create.js";
+import { ArtifactGetParams, ArtifactGetResult, artifactGetMethod } from "./methods/artifact/get.js";
+import { ArtifactListFilter, ArtifactListParams, ArtifactListResult, artifactListMethod } from "./methods/artifact/list.js";
+import { ArtifactPublishParams, ArtifactPublishResult, artifactPublishMethod } from "./methods/artifact/publish.js";
+import { ARTIFACT_PROGRESS, ArtifactProgressParams, CompareRequest, CompareResult, DEFAULT_VIEWPORTS, ProbedField, RenderRequest, RenderResult, ScreenshotPolicy, TokenEstimate, VERIFY_PROBE, VERIFY_REPORT, VERIFY_RUNNER_METHODS, VerdictAria, VerdictScreenshot, VerifyVerdict, VerifyViewport, ariaSummary, estimateImageTokens, viewportsFor } from "./verify.js";
+import { ArtifactVerifyParams, ArtifactVerifyResult, artifactVerifyMethod } from "./methods/artifact/verify.js";
+import { AddedPackage, DepsAddParams, DepsAddResult, depsAddMethod } from "./methods/deps/add.js";
+import { DEV_NOTIFY, DevEventKind, DevNotifyParams, DevStartParams, DevStartResult, devStartMethod } from "./methods/dev/start.js";
+import { DevStopParams, DevStopResult, devStopMethod } from "./methods/dev/stop.js";
+import { EventsAckParams, EventsAckResult, eventsAckMethod } from "./methods/events/ack.js";
+import { EVENTS_READ_MAX, EventsReadParams, EventsReadResult, eventsReadMethod } from "./methods/events/read.js";
+import { EVENTS_NOTIFY, EventsNotifyParams, EventsSubscribeParams, EventsSubscribeResult, eventsSubscribeMethod } from "./methods/events/subscribe.js";
+import { EventsUnsubscribeParams, EventsUnsubscribeResult, eventsUnsubscribeMethod } from "./methods/events/unsubscribe.js";
+import { GcCompactEvents, GcCompacted, GcCount, GcRunParams, GcRunResult, GcVersion, gcRunMethod } from "./methods/gc/run.js";
+import { hostMethods } from "./methods/index.js";
+import { InstanceCheck, InstanceCheckParams, InstanceCheckResult, instanceCheckMethod } from "./methods/instance/check.js";
+import { HOST_PROTOCOL_REVISIONS, Revision, RevisionNegotiation, negotiateRevision } from "./revision.js";
+import { CLI_CLIENT_NAME, ClientCapabilities, ClientInfo, DependencyPolicy, HomeConfig, InstanceCapabilities, InstanceInfo, MostraInitializeParams, MostraInitializeResult, PortName, mostraInitializeMethod } from "./methods/mostra/initialize.js";
+import { ChildProcessStatus, DeliveryCounts, GatewayStatus, InstanceStatusParams, InstanceStatusResult, WorkerStatus, instanceStatusMethod } from "./methods/instance/status.js";
+import { LivePushParams, LivePushResult, livePushMethod } from "./methods/live/push.js";
+import { MostraShutdownParams, MostraShutdownResult, mostraShutdownMethod } from "./methods/mostra/shutdown.js";
+import { DraftMirror, DraftsMirrorResult, portDraftsMirrorMethod } from "./methods/port/drafts-mirror.js";
+import { PortSecretsGetParams, PortSecretsGetResult, portSecretsGetMethod } from "./methods/port/secrets-get.js";
+import { SubmissionEnvelope, SubmissionsDeliverResult, portSubmissionsDeliverMethod } from "./methods/port/submissions-deliver.js";
+import { PortTrustedControlsActivatedParams, PortTrustedControlsActivatedResult, portTrustedControlsActivatedMethod } from "./methods/port/trusted-controls-activated.js";
+import { PortTrustedControlsPolicyParams, PortTrustedControlsPolicyResult, portTrustedControlsPolicyMethod } from "./methods/port/trusted-controls-policy.js";
+import { ResultsGetParams, ResultsGetResult, ResultsMarkdown, resultsGetMethod } from "./methods/results/get.js";
+import { SecretDeleteParams, SecretDeleteResult, secretDeleteMethod } from "./methods/secret/delete.js";
+import { SecretEntry, SecretSetParams, SecretSetResult, secretSetMethod } from "./methods/secret/set.js";
+import { SecretListParams, SecretListResult, secretListMethod } from "./methods/secret/list.js";
+import { StateGetParams, StateGetResult, stateGetMethod } from "./methods/state/get.js";
+import { StatePatchParams, StatePatchResult, statePatchMethod } from "./methods/state/patch.js";
+import { CapabilityLink, ViewUrlParams, ViewUrlResult, viewUrlMethod } from "./methods/view/url.js";
+import { ViewDefaultParams, ViewDefaultResult, viewDefaultMethod } from "./methods/view/default.js";
+import { ViewLaunchParams, ViewLaunchResult, viewLaunchMethod } from "./methods/view/launch.js";
+import { ViewRevokeParams, ViewRevokeResult, viewRevokeMethod } from "./methods/view/revoke.js";
+import { ViewRotateParams, ViewRotateResult, viewRotateMethod } from "./methods/view/rotate.js";
+import { WAIT_MAX_MS, WaitParams, WaitResult, waitMethod } from "./methods/wait/wait.js";
+import { ClassifiedMessage, JsonRpcErrorObject, JsonRpcFailure, JsonRpcId, JsonRpcMessage, JsonRpcNotification, JsonRpcParams, JsonRpcRequest, JsonRpcResponse, JsonRpcSuccess, classifyMessage } from "./rpc/messages.js";
+import { JSON_RPC_ERROR_CODES, RpcError } from "./rpc/error.js";
+import { LineSplitter, MAX_LINE_LENGTH, encodeLine } from "./rpc/lines.js";
+import { RpcPeer, RpcPeerOptions, RpcRequestContext, RpcRequestOptions, parseParams } from "./rpc/peer.js";
+import { CallContext, DEFAULT_WORKER_LIMITS, LiveSourceInfo, ServerEmitParams, ServerLiveValueParams, ServerLogParams, ServerProgressParams, ServerSecretParams, ServerSignalParams, ServerStateGetParams, ServerStatePatchParams, ServerStatePatchResult, WORKER_CHANNEL_REVISION, WORKER_METHODS, WorkerBatchParams, WorkerCallOutcome, WorkerCallParams, WorkerCancelParams, WorkerLimits, WorkerLiveParams, WorkerPingResult, WorkerStartParams, WorkerStartResult, WorkerVersionRef } from "./worker.js";
+export { type A11yDiagnosticCode, ACTION_ARGS_MAX, ACTION_RESULT_MAX, ALL_SCOPES, ARGUMENT_BIGINT_DIGITS_MAX, ARTIFACT_MANIFEST_KEYS, ARTIFACT_PROGRESS, type ActionDiagnosticCode, ActionError, Actor, AddedPackage, type AnyBridgeMessage, type AnyFunction, type AnyMethod, type AreaCatalog, type ArtifactCreateParams, type ArtifactCreateResult, ArtifactDetail, type ArtifactDiagnosticCode, type ArtifactFamily, type ArtifactGetParams, type ArtifactGetResult, ArtifactId, ArtifactLink, type ArtifactListFilter, type ArtifactListParams, type ArtifactListResult, ArtifactManifest, ArtifactProgressParams, type ArtifactPublishParams, type ArtifactPublishResult, ArtifactRef, ArtifactSummary, type ArtifactVerifyParams, type ArtifactVerifyResult, BRIDGE_FIELDS_MAX, BRIDGE_MESSAGES, BRIDGE_TEXT_MAX, BROWSER_PROTOCOL_REVISION, BROWSER_PROTOCOL_REVISIONS, BUNDLE_NAME, BUNDLE_PLATFORMS, BUNDLE_SETUP_MARKER, Batches, type Bridge, type BridgeEvent, type BridgeHostContext, type BridgeImplementation, type BridgeMessage, type BridgeOptions, type BridgePeer, type BridgeReceiver, type BridgeRejection, type BridgeSide, type BuildDiagnosticCode, BundleAsset, BundleBrowser, BundleFileEntry, BundleFiles, BundleInfo, BundleLinkEntry, BundlePins, type BundlePlatform, BundlePlatformSchema, BundleSetup, CLI_CLIENT_NAME, CONTROL_LABEL_MAX, CSRF_HEADER, type CallContext, type CallLine, CallRequest, CapabilityLink, CapabilityScope, CarryOver, ChildProcessStatus, ChooseRequest, type ClassifiedMessage, type CliDiagnosticCode, ClientCapabilities, ClientInfo, CommentId, type CompareRequest, type CompareResult, type ConsoleDiagnosticCode, type ControlRequest, ControlsPolicy, type CreateDiagnosticOptions, Cursor, DEFAULT_DOCS_BASE, DEFAULT_VIEWPORTS, DEFAULT_WORKER_LIMITS, DEV_NOTIFY, DIAGNOSTIC_AREAS, DeliveryCounts, DeliveryId, type DeliveryState, DeliveryStatus, type DeliveryTarget, type DemoSpec, type DepDiagnosticCode, DependencyPolicy, type DepsAddParams, type DepsAddResult, type DevEventKind, DevNotifyParams, type DevStartParams, type DevStartResult, type DevStopParams, type DevStopResult, Diagnostic, type DiagnosticArea, type DiagnosticCode, type DiagnosticDetails, DiagnosticFix, DiagnosticLocation, DiagnosticPhase, DiagnosticSeverity, type DiagnosticSpec, DocumentRevision, DocumentSnapshot, DraftMirror, type DraftsMirrorResult, Duration, EVENTS_NOTIFY, EVENTS_READ_MAX, type EnvDiagnosticCode, type EphemeralMessage, EventFilter, EventRecord, EventTypePattern, type EventsAckParams, type EventsAckResult, EventsNotifyParams, type EventsReadParams, type EventsReadResult, type EventsSubscribeParams, type EventsSubscribeResult, type EventsUnsubscribeParams, type EventsUnsubscribeResult, FIELD_ID_MAX_LENGTH, FieldConflict, type FieldDiagnosticCode, FieldOp, type FieldRegistration, type FieldScope, FieldState, type FieldsParams, FieldsRequest, type FlushResult, FollowRequest, type Frame, FrameTicket, GatewayStatus, type GcCompactEvents, type GcCompacted, type GcCount, type GcRunParams, type GcRunResult, type GcVersion, type GeneratedIdKind, HOST_PROTOCOL_REVISIONS, HomeConfig, type HomeDiagnosticCode, type HostDiagnosticCode, type HygieneDiagnosticCode, type Id, type IdBody, type IdKind, type IdPrefix, InstanceCapabilities, type InstanceCheck, type InstanceCheckParams, type InstanceCheckResult, InstanceInfo, type InstanceStatusParams, type InstanceStatusResult, JSON_RPC_ERROR_CODES, JsonRpcErrorObject, JsonRpcFailure, type JsonRpcId, type JsonRpcMessage, JsonRpcNotification, type JsonRpcParams, JsonRpcRequest, type JsonRpcResponse, JsonRpcSuccess, type KnownDiagnosticCode, LIVE_KEY_PATTERN, LIVE_RING_DEFAULT, LIVE_RING_MAX, LIVE_VALUE_MAX, LineSplitter, type LiveDiagnosticCode, type LivePushParams, type LivePushResult, LiveRequest, type LiveSourceInfo, type LiveState, type LiveUpdate, MAX_LINE_LENGTH, MCP_APPS_PROTOCOL_VERSION, type ManifestDiagnosticCode, type MethodDefinition, type MethodDirection, type MostraInitializeParams, type MostraInitializeResult, type MostraShutdownParams, type MostraShutdownResult, MutationId, MutationResult, type NetworkDiagnosticCode, OPEN_LINK_SCHEMES, OrphanedField, type PlatformDiagnosticCode, PollResult, PortName, type PortSecretsGetParams, type PortSecretsGetResult, type PortTrustedControlsActivatedParams, type PortTrustedControlsActivatedResult, type PortTrustedControlsPolicyParams, type PortTrustedControlsPolicyResult, type ProbedField, type PublishDiagnosticCode, PublishReceipt, REVIEW_SET_ID_PATTERN, RUN_KEY_MAX, RUN_LOG_MAX, RUN_LOG_TRUNCATED, RUN_STATUSES, type Rect, type Refusal, type RegressionDiagnosticCode, RemoteError, type RenderRequest, type RenderResult, type RequestFacts, type RequestIntent, type RequestPolicy, ResultComment, Results, type ResultsGetParams, type ResultsGetResult, ResultsMarkdown, Revision, type RevisionNegotiation, RpcError, RpcPeer, type RpcPeerOptions, type RpcRequestContext, type RpcRequestOptions, RunAttachRequest, RunCancelRequest, type RunDelta, RunId, RunProgress, type RunReason, RunRequest, RunState, type RunStatus, type RuntimeDiagnosticCode, SECRET_NAME_PATTERN, SECRET_VALUE_MAX, SIGNAL_NAME_PATTERN, SIGNAL_PAYLOAD_MAX_BYTES, type SaveState, ScreenshotPolicy, type SecretDeleteParams, type SecretDeleteResult, type SecretDiagnosticCode, SecretEntry, type SecretListParams, type SecretListResult, type SecretSetParams, type SecretSetResult, SerializationError, type SerializeMode, ServerEmitParams, ServerLiveValueParams, ServerLogParams, ServerProgressParams, ServerSecretParams, ServerSignalParams, ServerStateGetParams, ServerStatePatchParams, type ServerStatePatchResult, ShellSubmitRequest, SignalRequest, type SmokeDiagnosticCode, SourceRef, type StateGetParams, type StateGetResult, type StatePatchParams, type StatePatchResult, StreamSnapshot, SubmissionEnvelope, SubmissionId, SubmissionPolicy, SubmissionSummary, type SubmissionsDeliverResult, type SubmitBlocker, SubmitChannel, type SubmitDiagnosticCode, SubmitRequest, type TargetDiagnosticCode, type TerminalSpec, ThreadId, type TokenEstimate, TokenId, TrustedControl, type TypeDiagnosticCode, UNSERIALIZABLE_CODE, type UiInitializeParams, type UiInitializeResult, VERIFY_PROBE, VERIFY_REPORT, VERIFY_RUNNER_METHODS, ValueReader, type ValueReaderOptions, ValueWriter, type ValueWriterOptions, type VerdictAria, type VerdictScreenshot, type VerifyDiagnosticCode, VerifyVerdict, type VerifyViewport, type VersionAvailableParams, VersionId, type VersionIdKind, VersionRef, VersionSummary, ViewContext, ViewContextWire, type ViewDefaultParams, type ViewDefaultResult, ViewId, type ViewLaunchParams, type ViewLaunchResult, type ViewRevokeParams, type ViewRevokeResult, type ViewRotateParams, type ViewRotateResult, type ViewUrlParams, type ViewUrlResult, Viewer, ViewerId, type ViewerKind, ViewerSpec, type Viewport, WAIT_MAX_MS, WORKER_CHANNEL_REVISION, WORKER_METHODS, WaitCondition, type WaitParams, type WaitResult, type WireError, WorkerBatchParams, WorkerCallOutcome, WorkerCallParams, type WorkerCancelParams, type WorkerLimits, type WorkerLiveParams, WorkerPingResult, WorkerStartParams, WorkerStartResult, WorkerStatus, WorkerVersionRef, a11yDiagnosticCodes, actionDiagnosticCodes, ariaSummary, artifactCreateMethod, artifactDiagnosticCodes, artifactGetMethod, artifactListMethod, artifactPublishMethod, artifactVerifyMethod, buildDiagnosticCodes, bundleAssetName, canonicalJson, checkArgumentFrames, checkRequest, classifyMessage, cliDiagnosticCodes, connectBridge, consoleDiagnosticCodes, createDiagnostic, defineMethod, depDiagnosticCodes, depsAddMethod, deserializeAll, devStartMethod, devStopMethod, diagnosticCatalog, docsUrl, durationMs, encodeLine, envDiagnosticCodes, estimateImageTokens, eventsAckMethod, eventsReadMethod, eventsSubscribeMethod, eventsUnsubscribeMethod, fieldDiagnosticCodes, fromBase64, gcRunMethod, headerValue, homeDiagnosticCodes, hostDiagnosticCodes, hostMethods, hygieneDiagnosticCodes, instanceCheckMethod, instanceStatusMethod, isFieldId, isFinalRunStatus, isJsonContentType, liveDiagnosticCodes, livePushMethod, manifestDiagnosticCodes, mostraControlsRequest, mostraFieldFocus, mostraFields, mostraFlush, mostraInitializeMethod, mostraPage, mostraReady, mostraShutdownMethod, mostraVersionAvailable, negotiateRevision, networkDiagnosticCodes, normalizeScopes, parseParams, platformDiagnosticCodes, portDraftsMirrorMethod, portSecretsGetMethod, portSubmissionsDeliverMethod, portTrustedControlsActivatedMethod, portTrustedControlsPolicyMethod, publishDiagnosticCodes, readViewContext, refusal, regressionDiagnosticCodes, resultsGetMethod, runtimeDiagnosticCodes, safeEqual, safePath, scopeAllows, secretDeleteMethod, secretDiagnosticCodes, secretListMethod, secretSetMethod, serializeAll, smokeDiagnosticCodes, stateGetMethod, statePatchMethod, submitDiagnosticCodes, targetDiagnosticCodes, toBase64, typeDiagnosticCodes, uiInitialize, uiInitialized, uiOpenLink, uiSizeChanged, verifyDiagnosticCodes, viewDefaultMethod, viewLaunchMethod, viewRevokeMethod, viewRotateMethod, viewUrlMethod, viewportsFor, waitMethod, wireError };

package/dist/index.js

@@ -0,0 +1,86 @@
+import { ArtifactId, CommentId, Cursor, DeliveryId, MutationId, RunId, SubmissionId, ThreadId, TokenId, VersionId, ViewId, ViewerId } from "./ids.js";
+import { ACTION_ARGS_MAX, ACTION_RESULT_MAX, ActionError, Batches, CallRequest, LIVE_KEY_PATTERN, LIVE_RING_DEFAULT, LIVE_RING_MAX, LIVE_VALUE_MAX, LiveRequest, RUN_KEY_MAX, RUN_LOG_MAX, RUN_LOG_TRUNCATED, RUN_STATUSES, RunAttachRequest, RunCancelRequest, RunProgress, RunRequest, RunState, SECRET_NAME_PATTERN, SECRET_VALUE_MAX, isFinalRunStatus } from "./actions.js";
+import { ARTIFACT_MANIFEST_KEYS, ArtifactLink, ArtifactManifest, SubmissionPolicy } from "./manifest.js";
+import { ArtifactDetail, ArtifactRef, ArtifactSummary, PublishReceipt, SourceRef, VersionSummary } from "./artifact.js";
+import { hostDiagnosticCodes } from "./diagnostics/codes/host.js";
+import { DIAGNOSTIC_AREAS, Diagnostic, DiagnosticFix, DiagnosticLocation, DiagnosticPhase, DiagnosticSeverity } from "./diagnostics/diagnostic.js";
+import { DEFAULT_DOCS_BASE, docsUrl } from "./diagnostics/spec.js";
+import { JSON_RPC_ERROR_CODES, RpcError } from "./rpc/error.js";
+import { JsonRpcErrorObject, JsonRpcFailure, JsonRpcNotification, JsonRpcRequest, JsonRpcSuccess, classifyMessage } from "./rpc/messages.js";
+import { RpcPeer, parseParams } from "./rpc/peer.js";
+import { ControlsPolicy, REVIEW_SET_ID_PATTERN, SubmitChannel, TrustedControl, VersionRef, ViewContext, ViewContextWire, readViewContext } from "./view.js";
+import { BRIDGE_FIELDS_MAX, BRIDGE_MESSAGES, BRIDGE_TEXT_MAX, CONTROL_LABEL_MAX, MCP_APPS_PROTOCOL_VERSION, OPEN_LINK_SCHEMES, connectBridge, mostraControlsRequest, mostraFieldFocus, mostraFields, mostraFlush, mostraPage, mostraReady, mostraVersionAvailable, uiInitialize, uiInitialized, uiOpenLink, uiSizeChanged } from "./bridge.js";
+import { Actor, DeliveryStatus, DocumentRevision, EventFilter, EventRecord, EventTypePattern, FIELD_ID_MAX_LENGTH, FieldConflict, FieldOp, FieldState, MutationResult, ResultComment, Results, SIGNAL_NAME_PATTERN, SubmissionSummary, Viewer, ViewerSpec, WaitCondition, isFieldId } from "./interaction.js";
+import { BROWSER_PROTOCOL_REVISION, BROWSER_PROTOCOL_REVISIONS, CarryOver, ChooseRequest, DocumentSnapshot, FieldsRequest, FollowRequest, FrameTicket, OrphanedField, PollResult, SIGNAL_PAYLOAD_MAX_BYTES, ShellSubmitRequest, SignalRequest, StreamSnapshot, SubmitRequest } from "./browser.js";
+import { BUNDLE_NAME, BUNDLE_PLATFORMS, BUNDLE_SETUP_MARKER, BundleAsset, BundleBrowser, BundleFileEntry, BundleFiles, BundleInfo, BundleLinkEntry, BundlePins, BundlePlatformSchema, BundleSetup, bundleAssetName } from "./bundle.js";
+import { canonicalJson } from "./canonical.js";
+import { ALL_SCOPES, CapabilityScope, Duration, durationMs, normalizeScopes, scopeAllows } from "./capability.js";
+import { a11yDiagnosticCodes } from "./diagnostics/codes/a11y.js";
+import { actionDiagnosticCodes } from "./diagnostics/codes/action.js";
+import { artifactDiagnosticCodes } from "./diagnostics/codes/artifact.js";
+import { buildDiagnosticCodes } from "./diagnostics/codes/build.js";
+import { cliDiagnosticCodes } from "./diagnostics/codes/cli.js";
+import { consoleDiagnosticCodes } from "./diagnostics/codes/console.js";
+import { depDiagnosticCodes } from "./diagnostics/codes/dep.js";
+import { envDiagnosticCodes } from "./diagnostics/codes/env.js";
+import { fieldDiagnosticCodes } from "./diagnostics/codes/field.js";
+import { homeDiagnosticCodes } from "./diagnostics/codes/home.js";
+import { hygieneDiagnosticCodes } from "./diagnostics/codes/hygiene.js";
+import { liveDiagnosticCodes } from "./diagnostics/codes/live.js";
+import { manifestDiagnosticCodes } from "./diagnostics/codes/manifest.js";
+import { networkDiagnosticCodes } from "./diagnostics/codes/network.js";
+import { platformDiagnosticCodes } from "./diagnostics/codes/platform.js";
+import { publishDiagnosticCodes } from "./diagnostics/codes/publish.js";
+import { regressionDiagnosticCodes } from "./diagnostics/codes/regression.js";
+import { runtimeDiagnosticCodes } from "./diagnostics/codes/runtime.js";
+import { secretDiagnosticCodes } from "./diagnostics/codes/secret.js";
+import { smokeDiagnosticCodes } from "./diagnostics/codes/smoke.js";
+import { submitDiagnosticCodes } from "./diagnostics/codes/submit.js";
+import { targetDiagnosticCodes } from "./diagnostics/codes/target.js";
+import { typeDiagnosticCodes } from "./diagnostics/codes/type.js";
+import { verifyDiagnosticCodes } from "./diagnostics/codes/verify.js";
+import { createDiagnostic, diagnosticCatalog } from "./diagnostics/codes/index.js";
+import { CSRF_HEADER, checkRequest, headerValue, isJsonContentType, refusal, safeEqual, safePath } from "./hygiene.js";
+import { defineMethod } from "./method.js";
+import { artifactCreateMethod } from "./methods/artifact/create.js";
+import { artifactGetMethod } from "./methods/artifact/get.js";
+import { artifactListMethod } from "./methods/artifact/list.js";
+import { artifactPublishMethod } from "./methods/artifact/publish.js";
+import { ARTIFACT_PROGRESS, ArtifactProgressParams, DEFAULT_VIEWPORTS, ScreenshotPolicy, VERIFY_PROBE, VERIFY_REPORT, VERIFY_RUNNER_METHODS, VerifyVerdict, ariaSummary, estimateImageTokens, viewportsFor } from "./verify.js";
+import { artifactVerifyMethod } from "./methods/artifact/verify.js";
+import { AddedPackage, depsAddMethod } from "./methods/deps/add.js";
+import { DEV_NOTIFY, DevNotifyParams, devStartMethod } from "./methods/dev/start.js";
+import { devStopMethod } from "./methods/dev/stop.js";
+import { eventsAckMethod } from "./methods/events/ack.js";
+import { EVENTS_READ_MAX, eventsReadMethod } from "./methods/events/read.js";
+import { EVENTS_NOTIFY, EventsNotifyParams, eventsSubscribeMethod } from "./methods/events/subscribe.js";
+import { eventsUnsubscribeMethod } from "./methods/events/unsubscribe.js";
+import { gcRunMethod } from "./methods/gc/run.js";
+import { instanceCheckMethod } from "./methods/instance/check.js";
+import { HOST_PROTOCOL_REVISIONS, Revision, negotiateRevision } from "./revision.js";
+import { CLI_CLIENT_NAME, ClientCapabilities, ClientInfo, DependencyPolicy, HomeConfig, InstanceCapabilities, InstanceInfo, PortName, mostraInitializeMethod } from "./methods/mostra/initialize.js";
+import { ChildProcessStatus, DeliveryCounts, GatewayStatus, WorkerStatus, instanceStatusMethod } from "./methods/instance/status.js";
+import { livePushMethod } from "./methods/live/push.js";
+import { mostraShutdownMethod } from "./methods/mostra/shutdown.js";
+import { DraftMirror, portDraftsMirrorMethod } from "./methods/port/drafts-mirror.js";
+import { portSecretsGetMethod } from "./methods/port/secrets-get.js";
+import { SubmissionEnvelope, portSubmissionsDeliverMethod } from "./methods/port/submissions-deliver.js";
+import { portTrustedControlsActivatedMethod } from "./methods/port/trusted-controls-activated.js";
+import { portTrustedControlsPolicyMethod } from "./methods/port/trusted-controls-policy.js";
+import { ResultsMarkdown, resultsGetMethod } from "./methods/results/get.js";
+import { secretDeleteMethod } from "./methods/secret/delete.js";
+import { SecretEntry, secretSetMethod } from "./methods/secret/set.js";
+import { secretListMethod } from "./methods/secret/list.js";
+import { stateGetMethod } from "./methods/state/get.js";
+import { statePatchMethod } from "./methods/state/patch.js";
+import { CapabilityLink, viewUrlMethod } from "./methods/view/url.js";
+import { viewDefaultMethod } from "./methods/view/default.js";
+import { viewLaunchMethod } from "./methods/view/launch.js";
+import { viewRevokeMethod } from "./methods/view/revoke.js";
+import { viewRotateMethod } from "./methods/view/rotate.js";
+import { WAIT_MAX_MS, waitMethod } from "./methods/wait/wait.js";
+import { hostMethods } from "./methods/index.js";
+import { LineSplitter, MAX_LINE_LENGTH, encodeLine } from "./rpc/lines.js";
+import { ARGUMENT_BIGINT_DIGITS_MAX, RemoteError, SerializationError, UNSERIALIZABLE_CODE, ValueReader, ValueWriter, checkArgumentFrames, deserializeAll, fromBase64, serializeAll, toBase64, wireError } from "./serializer.js";
+import { DEFAULT_WORKER_LIMITS, ServerEmitParams, ServerLiveValueParams, ServerLogParams, ServerProgressParams, ServerSecretParams, ServerSignalParams, ServerStateGetParams, ServerStatePatchParams, WORKER_CHANNEL_REVISION, WORKER_METHODS, WorkerBatchParams, WorkerCallOutcome, WorkerCallParams, WorkerPingResult, WorkerStartParams, WorkerStartResult, WorkerVersionRef } from "./worker.js";
+export { ACTION_ARGS_MAX, ACTION_RESULT_MAX, ALL_SCOPES, ARGUMENT_BIGINT_DIGITS_MAX, ARTIFACT_MANIFEST_KEYS, ARTIFACT_PROGRESS, ActionError, Actor, AddedPackage, ArtifactDetail, ArtifactId, ArtifactLink, ArtifactManifest, ArtifactProgressParams, ArtifactRef, ArtifactSummary, BRIDGE_FIELDS_MAX, BRIDGE_MESSAGES, BRIDGE_TEXT_MAX, BROWSER_PROTOCOL_REVISION, BROWSER_PROTOCOL_REVISIONS, BUNDLE_NAME, BUNDLE_PLATFORMS, BUNDLE_SETUP_MARKER, Batches, BundleAsset, BundleBrowser, BundleFileEntry, BundleFiles, BundleInfo, BundleLinkEntry, BundlePins, BundlePlatformSchema, BundleSetup, CLI_CLIENT_NAME, CONTROL_LABEL_MAX, CSRF_HEADER, CallRequest, CapabilityLink, CapabilityScope, CarryOver, ChildProcessStatus, ChooseRequest, ClientCapabilities, ClientInfo, CommentId, ControlsPolicy, Cursor, DEFAULT_DOCS_BASE, DEFAULT_VIEWPORTS, DEFAULT_WORKER_LIMITS, DEV_NOTIFY, DIAGNOSTIC_AREAS, DeliveryCounts, DeliveryId, DeliveryStatus, DependencyPolicy, DevNotifyParams, Diagnostic, DiagnosticFix, DiagnosticLocation, DiagnosticPhase, DiagnosticSeverity, DocumentRevision, DocumentSnapshot, DraftMirror, Duration, EVENTS_NOTIFY, EVENTS_READ_MAX, EventFilter, EventRecord, EventTypePattern, EventsNotifyParams, FIELD_ID_MAX_LENGTH, FieldConflict, FieldOp, FieldState, FieldsRequest, FollowRequest, FrameTicket, GatewayStatus, HOST_PROTOCOL_REVISIONS, HomeConfig, InstanceCapabilities, InstanceInfo, JSON_RPC_ERROR_CODES, JsonRpcErrorObject, JsonRpcFailure, JsonRpcNotification, JsonRpcRequest, JsonRpcSuccess, LIVE_KEY_PATTERN, LIVE_RING_DEFAULT, LIVE_RING_MAX, LIVE_VALUE_MAX, LineSplitter, LiveRequest, MAX_LINE_LENGTH, MCP_APPS_PROTOCOL_VERSION, MutationId, MutationResult, OPEN_LINK_SCHEMES, OrphanedField, PollResult, PortName, PublishReceipt, REVIEW_SET_ID_PATTERN, RUN_KEY_MAX, RUN_LOG_MAX, RUN_LOG_TRUNCATED, RUN_STATUSES, RemoteError, ResultComment, Results, ResultsMarkdown, Revision, RpcError, RpcPeer, RunAttachRequest, RunCancelRequest, RunId, RunProgress, RunRequest, RunState, SECRET_NAME_PATTERN, SECRET_VALUE_MAX, SIGNAL_NAME_PATTERN, SIGNAL_PAYLOAD_MAX_BYTES, ScreenshotPolicy, SecretEntry, SerializationError, ServerEmitParams, ServerLiveValueParams, ServerLogParams, ServerProgressParams, ServerSecretParams, ServerSignalParams, ServerStateGetParams, ServerStatePatchParams, ShellSubmitRequest, SignalRequest, SourceRef, StreamSnapshot, SubmissionEnvelope, SubmissionId, SubmissionPolicy, SubmissionSummary, SubmitChannel, SubmitRequest, ThreadId, TokenId, TrustedControl, UNSERIALIZABLE_CODE, VERIFY_PROBE, VERIFY_REPORT, VERIFY_RUNNER_METHODS, ValueReader, ValueWriter, VerifyVerdict, VersionId, VersionRef, VersionSummary, ViewContext, ViewContextWire, ViewId, Viewer, ViewerId, ViewerSpec, WAIT_MAX_MS, WORKER_CHANNEL_REVISION, WORKER_METHODS, WaitCondition, WorkerBatchParams, WorkerCallOutcome, WorkerCallParams, WorkerPingResult, WorkerStartParams, WorkerStartResult, WorkerStatus, WorkerVersionRef, a11yDiagnosticCodes, actionDiagnosticCodes, ariaSummary, artifactCreateMethod, artifactDiagnosticCodes, artifactGetMethod, artifactListMethod, artifactPublishMethod, artifactVerifyMethod, buildDiagnosticCodes, bundleAssetName, canonicalJson, checkArgumentFrames, checkRequest, classifyMessage, cliDiagnosticCodes, connectBridge, consoleDiagnosticCodes, createDiagnostic, defineMethod, depDiagnosticCodes, depsAddMethod, deserializeAll, devStartMethod, devStopMethod, diagnosticCatalog, docsUrl, durationMs, encodeLine, envDiagnosticCodes, estimateImageTokens, eventsAckMethod, eventsReadMethod, eventsSubscribeMethod, eventsUnsubscribeMethod, fieldDiagnosticCodes, fromBase64, gcRunMethod, headerValue, homeDiagnosticCodes, hostDiagnosticCodes, hostMethods, hygieneDiagnosticCodes, instanceCheckMethod, instanceStatusMethod, isFieldId, isFinalRunStatus, isJsonContentType, liveDiagnosticCodes, livePushMethod, manifestDiagnosticCodes, mostraControlsRequest, mostraFieldFocus, mostraFields, mostraFlush, mostraInitializeMethod, mostraPage, mostraReady, mostraShutdownMethod, mostraVersionAvailable, negotiateRevision, networkDiagnosticCodes, normalizeScopes, parseParams, platformDiagnosticCodes, portDraftsMirrorMethod, portSecretsGetMethod, portSubmissionsDeliverMethod, portTrustedControlsActivatedMethod, portTrustedControlsPolicyMethod, publishDiagnosticCodes, readViewContext, refusal, regressionDiagnosticCodes, resultsGetMethod, runtimeDiagnosticCodes, safeEqual, safePath, scopeAllows, secretDeleteMethod, secretDiagnosticCodes, secretListMethod, secretSetMethod, serializeAll, smokeDiagnosticCodes, stateGetMethod, statePatchMethod, submitDiagnosticCodes, targetDiagnosticCodes, toBase64, typeDiagnosticCodes, uiInitialize, uiInitialized, uiOpenLink, uiSizeChanged, verifyDiagnosticCodes, viewDefaultMethod, viewLaunchMethod, viewRevokeMethod, viewRotateMethod, viewUrlMethod, viewportsFor, waitMethod, wireError };

package/dist/interaction.d.ts

@@ -0,0 +1,391 @@
+import { ArtifactLink, SubmissionPolicy } from "./manifest.js";
+import { ControlsPolicy, SubmitChannel, TrustedControl } from "./view.js";
+import { Cursor } from "./ids.js";
+import * as z from "zod";
+//#region src/interaction.d.ts
+/** How Mostra knows a viewer (DATA_MODEL §3 `viewer.kind`). */
+export type ViewerKind = "local" | "tailnet" | "token" | "host";
+/**
+ * A person who views an artifact (PRODUCT vocabulary). The home's local user is one viewer of kind
+ * `local`; a link minted with `viewer` acts as a viewer of kind `token` (D104).
+ */
+export interface Viewer {
+  /** The viewer's ID. */
+  readonly id: string;
+  /** How Mostra knows the viewer. */
+  readonly kind: ViewerKind;
+  /** The display name, when one is known. */
+  readonly name?: string;
+  /** The host's own key for this person, as given to `view/url` (D104). */
+  readonly ref?: string;
+}
+/** The Zod schema of the `Viewer` type. */
+export declare const Viewer: z.ZodType<Viewer>;
+/**
+ * The person a capability link acts for (`view/url`'s `viewer`, D104): the host's stable key for
+ * them, such as an email or an account ID, and a display name.
+ */
+export interface ViewerSpec {
+  /** The host's stable key for this person: the same `ref` always names the same viewer. */
+  readonly ref: string;
+  /** The name people see; updated when given again. */
+  readonly name?: string;
+}
+/** The Zod schema of the `ViewerSpec` type. */
+export declare const ViewerSpec: z.ZodType<ViewerSpec>;
+/** Who caused an event or wrote a field (DATA_MODEL §4). */
+export interface Actor {
+  /** Who: a viewer, an agent (a protocol client), a host, or Mostra itself. */
+  readonly kind: "viewer" | "agent" | "host" | "mostra";
+  /** A viewer's ID, or the protocol client's name for agents and hosts. */
+  readonly id?: string;
+  /** A display name, when one is known. */
+  readonly name?: string;
+}
+/** The Zod schema of the `Actor` type. */
+export declare const Actor: z.ZodType<Actor>;
+/** The longest field ID, in UTF-16 code units. */
+export declare const FIELD_ID_MAX_LENGTH = 256;
+/**
+ * Whether `id` is a field ID (D52): 1 to 256 characters without control characters; dots separate
+ * the parts that nest in results, so none is empty.
+ */
+export declare function isFieldId(id: unknown): id is string;
+/** Which document a field belongs to: the viewer's draft, or the artifact's shared state (D63). */
+export type FieldScope = "viewer" | "artifact";
+/**
+ * A document revision: the decimal string of a document's monotonic counter (DATA_MODEL §3).
+ * `"0"` is a document nothing has written yet.
+ */
+export type DocumentRevision = string;
+/** The Zod schema of the `DocumentRevision` type. */
+export declare const DocumentRevision: z.ZodType<DocumentRevision>;
+/**
+ * One change to one field. Exactly one of `value` and `delete` is given. The optional metadata
+ * travels with the field into results and decides what events redact (D52, D106).
+ */
+export interface FieldOp {
+  /** The field ID (D52). */
+  readonly id: string;
+  /** The new value: any JSON value, `null` included. */
+  readonly value?: unknown;
+  /** Removes the field. */
+  readonly delete?: true;
+  /** The label people see in results and the shell's blocker list. */
+  readonly label?: string;
+  /** Whether the shell asks for it before submit. */
+  readonly required?: boolean;
+  /** Kept in submissions and results, redacted from events and logs (D52). */
+  readonly sensitive?: boolean;
+}
+/** The Zod schema of the `FieldOp` type. */
+export declare const FieldOp: z.ZodType<FieldOp>;
+/** A field's current state. */
+export interface FieldState {
+  /** The field's value: any JSON value. */
+  readonly value: unknown;
+  /** The document revision that last wrote it. */
+  readonly revision: DocumentRevision;
+  /** Who wrote it last. */
+  readonly updatedBy?: Actor;
+  /** When it was written last. */
+  readonly updatedAt: string;
+  /** The label people see. */
+  readonly label?: string;
+  /** Whether the shell asks for it before submit. */
+  readonly required?: boolean;
+  /** Whether events and logs redact its value (D52). */
+  readonly sensitive?: boolean;
+}
+/** The Zod schema of the `FieldState` type. */
+export declare const FieldState: z.ZodType<FieldState>;
+/**
+ * A field op that wasn't applied because the field changed after the mutation's base revision
+ * (D22, FAILURE_MODEL §5): what the field holds now, so the writer can keep theirs or take it.
+ */
+export interface FieldConflict {
+  /** The field's ID. */
+  readonly id: string;
+  /** The revision that last changed the field. */
+  readonly revision: DocumentRevision;
+  /** Its current value; absent when it was deleted. */
+  readonly value?: unknown;
+  /** `true` when the field was deleted. */
+  readonly deleted?: true;
+  /** Who changed it. */
+  readonly updatedBy?: Actor;
+  /** When it changed. */
+  readonly updatedAt?: string;
+}
+/** The Zod schema of the `FieldConflict` type. */
+export declare const FieldConflict: z.ZodType<FieldConflict>;
+/** What a mutation did: the document's revision after it, the ops applied, and the conflicts. */
+export interface MutationResult {
+  /** The document's revision after the mutation; unchanged when nothing applied. */
+  readonly revision: DocumentRevision;
+  /** The field IDs whose ops were applied. */
+  readonly applied: readonly string[];
+  /** The ops not applied, with what each field holds now. */
+  readonly conflicts: readonly FieldConflict[];
+}
+/** The Zod schema of the `MutationResult` type. */
+export declare const MutationResult: z.ZodType<MutationResult>;
+/**
+ * One durable event (DATA_MODEL §4). Its cursor is its stable ID and its place in the home-wide
+ * order; `seq` orders an artifact's own events without gaps.
+ */
+export interface EventRecord {
+  /** The event's stable ID and home-wide position. */
+  readonly cursor: Cursor;
+  /** The artifact, or `null` for a home-wide event. */
+  readonly artifactId: string | null;
+  /** The artifact's sequence number, or `null` for a home-wide event. */
+  readonly seq: number | null;
+  /** The type from DATA_MODEL §4's catalog. */
+  readonly type: string;
+  /** When it was appended. */
+  readonly at: string;
+  /** Who caused it. */
+  readonly actor: Actor;
+  /** What caused it: a run, a mutation, a submission. */
+  readonly causation?: Readonly<Record<string, string>>;
+  /** The event's data; sensitive field values are redacted (D52). */
+  readonly payload: Readonly<Record<string, unknown>>;
+}
+/** The Zod schema of the `EventRecord` type. */
+export declare const EventRecord: z.ZodType<EventRecord>;
+/**
+ * An event type, or a family of them: `submission.created`, or `submission.*` for every type that
+ * starts with `submission.`.
+ */
+export type EventTypePattern = string;
+/** The Zod schema of the `EventTypePattern` type. */
+export declare const EventTypePattern: z.ZodType<EventTypePattern>;
+/**
+ * Which events a reader wants (IN-08, H-09). Both parts are optional, and an event must pass both.
+ * `artifact.compacted` always passes for a matching artifact, so a filtered reader still learns of
+ * a compaction (DATA_MODEL §4).
+ */
+export interface EventFilter {
+  /** Only these artifacts' events; absent: every artifact's, and home-wide ones. */
+  readonly artifacts?: readonly string[];
+  /** Only these types; absent: every type. */
+  readonly types?: readonly EventTypePattern[];
+}
+/** The Zod schema of the `EventFilter` type. */
+export declare const EventFilter: z.ZodType<EventFilter>;
+/**
+ * What `wait` waits for (ARCHITECTURE §6, D103): `submitted`, `signal:<name>`, `state:<fieldId>`
+ * or `event:<type pattern>`.
+ */
+export type WaitCondition = string;
+/** A signal's name: letters, digits, `.`, `_` and `-`, starting with a letter or digit (D106). */
+export declare const SIGNAL_NAME_PATTERN: RegExp;
+/** The Zod schema of the `WaitCondition` type. */
+export declare const WaitCondition: z.ZodType<WaitCondition>;
+/** A delivery's state (FAILURE_MODEL §4). */
+export type DeliveryState = "pending" | "delivered" | "rejected" | "undeliverable";
+/** One submission's delivery to one host (D105). */
+export interface DeliveryStatus {
+  /** The delivery's stable ID (`dlv_`), repeated by every redelivery. */
+  readonly deliveryId: string;
+  /**
+   * The host: its client name. Empty for Mostra's built-in adapter, which takes submissions when no
+   * host does; client names are never empty, so no host can be mistaken for it (D105).
+   */
+  readonly owner: string;
+  /** Where the delivery stands. */
+  readonly state: DeliveryState;
+  /** How many times Mostra called the host for it. */
+  readonly attempts: number;
+  /** The host's reason, for a rejection. */
+  readonly reason?: string;
+  /**
+   * `true` while a pending delivery waits: its host isn't connected, or an attempt failed and it
+   * will be retried (D47's "Pending delivery"). Absent while the first attempt is under way.
+   */
+  readonly waiting?: true;
+  /** When its state last changed. */
+  readonly updatedAt: string;
+}
+/** The Zod schema of the `DeliveryStatus` type. */
+export declare const DeliveryStatus: z.ZodType<DeliveryStatus>;
+/** A submission as a submit answers it (INTERFACES §4). */
+export interface SubmissionSummary {
+  /** The submission's ID. */
+  readonly id: string;
+  /** When it was made. */
+  readonly at: string;
+  /** The draft epoch it closed (D103); 1 outside `epochs`. */
+  readonly epoch: number;
+  /** Where the submit came from (D40). */
+  readonly channel: SubmitChannel;
+  /** The version the view showed. */
+  readonly versionId: string;
+  /** That version's number. */
+  readonly version: number;
+  /** The view it was made from. */
+  readonly viewId: string;
+  /** Whether a newer version existed when the viewer submitted (H-10). */
+  readonly staleView: boolean;
+  /** The draft revision it was made from. */
+  readonly draftRevision: DocumentRevision;
+  /** SHA-256 of the snapshot's canonical JSON (RFC 8785), lowercase hex. */
+  readonly digest: string;
+  /** Every delivery's state, summed up: the worst of them. */
+  readonly delivery: DeliveryState;
+  /** Each host's delivery, so a viewer sees which host has it (IN-13). */
+  readonly deliveries?: readonly DeliveryStatus[];
+  /** `true` when this submit repeated an earlier one and got it back (D22). */
+  readonly duplicate?: true;
+}
+/** The Zod schema of the `SubmissionSummary` type. */
+export declare const SubmissionSummary: z.ZodType<SubmissionSummary>;
+/** A rectangle in CSS pixels, relative to its frame. */
+export interface Rect {
+  /** Distance from the frame's left edge. */
+  readonly x: number;
+  /** Distance from the frame's top edge. */
+  readonly y: number;
+  /** Width. */
+  readonly width: number;
+  /** Height. */
+  readonly height: number;
+}
+/** A viewport: its size in CSS pixels and its device pixel ratio. */
+export interface Viewport {
+  /** Width in CSS pixels. */
+  readonly width: number;
+  /** Height in CSS pixels. */
+  readonly height: number;
+  /** Device pixel ratio. */
+  readonly dpr: number;
+}
+/** One comment thread in results (INTERFACES §8; built by the review layer, WP-20). */
+export interface ResultComment {
+  /** The thread's ID. */
+  readonly threadId: string;
+  /** Whether the thread is open or resolved. */
+  readonly status: "open" | "resolved";
+  /** The thread's messages, oldest first, each with its author. */
+  readonly messages: readonly {
+    readonly author: Viewer;
+    readonly at: string;
+    readonly text: string;
+  }[];
+  /** Every layer of the anchor that applies (D23). */
+  readonly anchor: {
+    readonly reviewId?: string;
+    /** W3C Web Annotation selectors. */
+    readonly selectors?: readonly unknown[];
+    readonly rect?: Rect;
+    readonly viewport?: Viewport;
+    readonly page?: string;
+    readonly candidateId?: string;
+    readonly terminal?: {
+      readonly rows: readonly [number, number];
+      readonly cols: readonly [number, number];
+      readonly t?: number;
+    };
+    readonly time?: number;
+    readonly slide?: {
+      readonly index: number;
+      readonly step: number;
+    };
+  };
+  /** The screenshot crop, always stored (D23). */
+  readonly crop: {
+    readonly path: string;
+    readonly width: number;
+    readonly height: number;
+  };
+}
+/**
+ * The complete submission (INTERFACES §8): what `results/get`, `mostra results` and the
+ * submissions port carry. Everything in it comes from the immutable submission and the version it
+ * names, never from the live draft (IN-06).
+ */
+export interface Results {
+  /** The artifact, with the metadata of the version the viewer saw. */
+  readonly artifact: {
+    readonly id: string;
+    readonly title: string;
+    readonly description?: string;
+    readonly family?: string;
+    readonly links: readonly ArtifactLink[];
+  };
+  /** The submission's facts: when, how, by whom, from which version and view, and its delivery. */
+  readonly submission: {
+    readonly id: string;
+    readonly at: string;
+    readonly epoch: number;
+    /** The same viewer's previous submission, under `epochs` (D103). */
+    readonly previous?: string;
+    readonly policy: SubmissionPolicy;
+    readonly channel: SubmitChannel;
+    readonly viewer: Viewer;
+    readonly versionId: string;
+    readonly version: number;
+    readonly viewId: string;
+    /** Whether a newer version existed when the viewer submitted (H-10). */
+    readonly staleView: boolean;
+    /** The newest version's number at the time, when the view was stale. */
+    readonly latestVersion?: number;
+    readonly draftRevision: DocumentRevision;
+    readonly stateRevision?: DocumentRevision;
+    readonly digest: string;
+    readonly delivery: DeliveryState;
+    readonly deliveries: readonly DeliveryStatus[];
+  };
+  /** The draft's fields by ID, dotted IDs nested (D52). */
+  readonly answers: Readonly<Record<string, unknown>>;
+  /** Every field in `answers` and `state`, with its label and scope. */
+  readonly fields: readonly {
+    readonly id: string;
+    readonly label?: string;
+    readonly required?: boolean;
+    readonly sensitive?: boolean;
+    readonly scope: FieldScope;
+  }[];
+  /** Artifact state at `stateRevision`, dotted IDs nested (D63). */
+  readonly state?: Readonly<Record<string, unknown>>;
+  /** The review sets' choices: the fields `review.<set>.choice` (D65). */
+  readonly choices: readonly {
+    readonly reviewSetId: string;
+    readonly candidateId: string;
+    readonly label?: string;
+  }[];
+  /** Comment threads with their anchors and crops (WP-20). */
+  readonly comments: readonly ResultComment[];
+  /** Answers a newer version couldn't map (D42). */
+  readonly orphaned: readonly {
+    readonly id: string;
+    readonly label?: string;
+    readonly value: unknown;
+    readonly fromVersion: number;
+  }[];
+  /** Action runs started in this view (WP-08). */
+  readonly actions: readonly {
+    readonly runId: string;
+    readonly action: string;
+    readonly status: string;
+    readonly at: string;
+  }[];
+  /** Signals raised in this view before the submission: the newest 100, within 1 MiB of payloads. */
+  readonly signals: readonly {
+    readonly name: string;
+    readonly at: string;
+    readonly payload?: unknown;
+  }[];
+  /** How many older signals of the view the limit left out; absent when none. */
+  readonly signalsOmitted?: number;
+  /** Set when compaction removed events of this view before it submitted, so signals may be missing. */
+  readonly signalsCompacted?: true;
+}
+/** The Zod schema of the `ResultComment` type. */
+export declare const ResultComment: z.ZodType<ResultComment>;
+/** The Zod schema of the `Results` type. */
+export declare const Results: z.ZodType<Results>;
+//#endregion
+export { ControlsPolicy, SubmitChannel, TrustedControl };
+//# sourceMappingURL=interaction.d.ts.map

package/dist/interaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.d.ts","names":[],"sources":["../src/interaction.ts"],"mappings":";;;;;;YAyBY;;;;;iBAMK;;WAEN;;WAEA,MAAM;;WAEN;;WAEA;;;qBAIE,QAAQ,EAAE,QAAQ;;;;;iBAgBd;;WAEN;;WAEA;;;qBAIE,YAAY,EAAE,QAAQ;;iBAWlB;;WAEN;;WAEA;;WAEA;;;qBAIE,OAAO,EAAE,QAAQ;;qBAcjB;;;;;wBAMG,UAAU,cAAc;;YAY5B;;;;;YAMA;;qBAGC,kBAAkB,EAAE,QAAQ;;;;;iBAYxB;;WAEN;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;;qBAIE,SAAS,EAAE,QAAQ;;iBAgBf;;WAEN;;WAEA,UAAU;;WAEV,YAAY;;WAEZ;;WAEA;;WAEA;;WAEA;;;qBAIE,YAAY,EAAE,QAAQ;;;;;iBAmBlB;;WAEN;;WAEA,UAAU;;WAEV;;WAEA;;WAEA,YAAY;;WAEZ;;;qBAIE,eAAe,EAAE,QAAQ;;iBAerB;;WAEN,UAAU;;WAEV;;WAEA,oBAAoB;;;qBAIlB,gBAAgB,EAAE,QAAQ;;;;;iBAkBtB;;WAEN,QAAQ;;WAER;;WAEA;;WAEA;;WAEA;;WAEA,OAAO;;WAEP,YAAY,SAAS;;WAErB,SAAS,SAAS;;;qBAIhB,aAAa,EAAE,QAAQ;;;;;YAqBxB;;qBAGC,kBAAkB,EAAE,QAAQ;;;;;;iBAaxB;;WAEN;;WAEA,iBAAiB;;;qBAIf,aAAa,EAAE,QAAQ;;;;;YAexB;;qBAGC,qBAAqB;;qBAGrB,eAAe,EAAE,QAAQ;;YAc1B;;iBAGK;;WAEN;;;;;WAKA;;WAEA,OAAO;;WAEP;;WAEA;;;;;WAKA;;WAEA;;;qBAIE,gBAAgB,EAAE,QAAQ;;iBAgBtB;;WAEN;;WAEA;;WAEA;;WAEA,SAAS;;WAET;;WAEA;;WAEA;;WAEA;;WAEA,eAAe;;WAEf;;WAEA,UAAU;;WAEV,sBAAsB;;WAEtB;;;qBAIE,mBAAmB,EAAE,QAAQ;;iBAuBzB;;WAEN;;WAEA;;WAEA;;WAEA;;;iBAIM;;WAEN;;WAEA;;WAEA;;;iBAIM;;WAEN;;WAEA;;WAEA;aACE,QAAQ;aACR;aACA;;;WAGF;aACE;;aAEA;aACA,OAAO;aACP,WAAW;aACX;aACA;aACA;eACE;eACA;eACA;;aAEF;aACA;eAAmB;eAAwB;;;;WAG7C;aAAiB;aAAuB;aAAwB;;;;;;;;iBAQ1D;;WAEN;aACE;aACA;aACA;aACA;aACA,gBAAgB;;;WAGlB;aACE;aACA;aACA;;aAEA;aACA,QAAQ;aACR,SAAS;aACT,QAAQ;aACR;aACA;aACA;;aAEA;;aAEA;aACA,eAAe;aACf,gBAAgB;aAChB;aACA,UAAU;aACV,qBAAqB;;;WAGvB,SAAS,SAAS;;WAElB;aACE;aACA;aACA;aACA;aACA,OAAO;;;WAGT,QAAQ,SAAS;;WAEjB;aACE;aACA;aACA;;;WAGF,mBAAmB;;WAEnB;aACE;aACA;aACA;aACA;;;WAGF;aACE;aACA;aACA;aACA;;;WAGF;aACE;aACA;aACA;;;WAGF;;WAEA;;;qBAWE,eAAe,EAAE,QAAQ;;qBAkCzB,SAAS,EAAE,QAAQ"}