@mostra/protocol 0.0.0-placeholder → 0.1.0

package/dist/interaction.js

@@ -0,0 +1,306 @@
+import { wireRegistry } from "./wire-registry.js";
+import { ArtifactId, Cursor, DeliveryId, SubmissionId, VersionId, ViewId, ViewerId } from "./ids.js";
+import { ArtifactLink, SubmissionPolicy } from "./manifest.js";
+import { ControlsPolicy, SubmitChannel, TrustedControl } from "./view.js";
+import * as z from "zod";
+//#region src/interaction.ts
+/**
+* The interaction ledger's wire types (INTERFACES §4, §6, §7, §8; DATA_MODEL §3, §4): viewers,
+* fields and their mutations, events and their filters, `wait` conditions, submissions, deliveries
+* and results. The host protocol methods (`state/*`, `results/get`, `wait`, `events/*`), the
+* submissions and drafts ports, and the browser protocol all speak these shapes.
+*/
+/** The Zod schema of the `Viewer` type. */
+const Viewer = z.object({
+	id: ViewerId.schema,
+	kind: z.enum([
+		"local",
+		"tailnet",
+		"token",
+		"host"
+	]),
+	name: z.string().exactOptional(),
+	ref: z.string().exactOptional()
+}).register(wireRegistry, {
+	id: "Viewer",
+	description: "A person who views an artifact: ID, kind, display name and the host's own key."
+});
+/** The Zod schema of the `ViewerSpec` type. */
+const ViewerSpec = z.object({
+	ref: z.string().min(1).max(256),
+	name: z.string().min(1).max(256).exactOptional()
+}).register(wireRegistry, {
+	id: "ViewerSpec",
+	description: "The person a capability link acts for: the host's stable key and a display name."
+});
+/** The Zod schema of the `Actor` type. */
+const Actor = z.object({
+	kind: z.enum([
+		"viewer",
+		"agent",
+		"host",
+		"mostra"
+	]),
+	id: z.string().exactOptional(),
+	name: z.string().exactOptional()
+}).register(wireRegistry, {
+	id: "Actor",
+	description: "Who caused an event or wrote a field: a viewer, an agent, a host or Mostra."
+});
+/** The longest field ID, in UTF-16 code units. */
+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.
+*/
+function isFieldId(id) {
+	return typeof id === "string" && id.length >= 1 && id.length <= 256 && !/[\u0000-\u001f\u007f]/.test(id) && !id.split(".").includes("");
+}
+/** The Zod schema of the `DocumentRevision` type. */
+const DocumentRevision = z.string().regex(/^(0|[1-9][0-9]{0,15})$/).register(wireRegistry, {
+	id: "DocumentRevision",
+	description: "A draft's or artifact state's revision: a non-negative decimal integer string."
+});
+/** The Zod schema of the `FieldOp` type. */
+const FieldOp = z.object({
+	id: z.string().min(1).max(256),
+	value: z.unknown().exactOptional(),
+	delete: z.literal(true).exactOptional(),
+	label: z.string().max(1024).exactOptional(),
+	required: z.boolean().exactOptional(),
+	sensitive: z.boolean().exactOptional()
+}).register(wireRegistry, {
+	id: "FieldOp",
+	description: "One change to one field: a value or a delete, with optional label, required and sensitive."
+});
+/** The Zod schema of the `FieldState` type. */
+const FieldState = z.object({
+	value: z.unknown(),
+	revision: DocumentRevision,
+	updatedBy: Actor.exactOptional(),
+	updatedAt: z.iso.datetime(),
+	label: z.string().exactOptional(),
+	required: z.boolean().exactOptional(),
+	sensitive: z.boolean().exactOptional()
+}).register(wireRegistry, {
+	id: "FieldState",
+	description: "A field's current value, the revision that wrote it, who wrote it and when."
+});
+/** The Zod schema of the `FieldConflict` type. */
+const FieldConflict = z.object({
+	id: z.string(),
+	revision: DocumentRevision,
+	value: z.unknown().exactOptional(),
+	deleted: z.literal(true).exactOptional(),
+	updatedBy: Actor.exactOptional(),
+	updatedAt: z.iso.datetime().exactOptional()
+}).register(wireRegistry, {
+	id: "FieldConflict",
+	description: "A field op not applied because the field changed after the base revision."
+});
+/** The Zod schema of the `MutationResult` type. */
+const MutationResult = z.object({
+	revision: DocumentRevision,
+	applied: z.array(z.string()).readonly(),
+	conflicts: z.array(FieldConflict).readonly()
+}).register(wireRegistry, {
+	id: "MutationResult",
+	description: "A mutation's outcome: the revision after it, the applied field IDs, the conflicts."
+});
+/** The Zod schema of the `EventRecord` type. */
+const EventRecord = z.object({
+	cursor: Cursor.schema,
+	artifactId: ArtifactId.schema.nullable(),
+	seq: z.int().min(1).nullable(),
+	type: z.string(),
+	at: z.iso.datetime(),
+	actor: Actor,
+	causation: z.record(z.string(), z.string()).exactOptional(),
+	payload: z.record(z.string(), z.unknown())
+}).register(wireRegistry, {
+	id: "EventRecord",
+	description: "One durable event: cursor, artifact, per-artifact sequence, type, time, actor, payload."
+});
+/** The Zod schema of the `EventTypePattern` type. */
+const EventTypePattern = z.string().regex(/^[a-z][a-zA-Z0-9_-]*(\.[a-zA-Z0-9_-]+)*(\.\*)?$/).register(wireRegistry, {
+	id: "EventTypePattern",
+	description: "An event type (submission.created) or a family of them (submission.*)."
+});
+/** The Zod schema of the `EventFilter` type. */
+const EventFilter = z.object({
+	artifacts: z.array(ArtifactId.schema).max(1e3).readonly().exactOptional(),
+	types: z.array(EventTypePattern).max(100).readonly().exactOptional()
+}).register(wireRegistry, {
+	id: "EventFilter",
+	description: "Which events a reader wants: these artifacts' and these types (patterns allowed)."
+});
+/** A signal's name: letters, digits, `.`, `_` and `-`, starting with a letter or digit (D106). */
+const SIGNAL_NAME_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;
+/** The Zod schema of the `WaitCondition` type. */
+const WaitCondition = z.string().regex(/^(submitted|signal:[A-Za-z0-9][A-Za-z0-9._-]{0,63}|state:[^\u0000-\u001f\u007f]{1,256}|event:[a-z][a-zA-Z0-9_-]*(\.[a-zA-Z0-9_-]+)*(\.\*)?)$/).register(wireRegistry, {
+	id: "WaitCondition",
+	description: "What wait waits for: submitted, signal:<name>, state:<fieldId> or event:<type>."
+});
+/** The Zod schema of the `DeliveryStatus` type. */
+const DeliveryStatus = z.object({
+	deliveryId: DeliveryId.schema,
+	owner: z.string(),
+	state: z.enum([
+		"pending",
+		"delivered",
+		"rejected",
+		"undeliverable"
+	]),
+	attempts: z.int().min(0),
+	reason: z.string().exactOptional(),
+	waiting: z.literal(true).exactOptional(),
+	updatedAt: z.iso.datetime()
+}).register(wireRegistry, {
+	id: "DeliveryStatus",
+	description: "One submission's delivery to one host: owner, state, attempts and reason."
+});
+/** The Zod schema of the `SubmissionSummary` type. */
+const SubmissionSummary = z.object({
+	id: SubmissionId.schema,
+	at: z.iso.datetime(),
+	epoch: z.int().min(1),
+	channel: z.enum(["shell", "artifact"]),
+	versionId: VersionId.schema,
+	version: z.int().min(1),
+	viewId: ViewId.schema,
+	staleView: z.boolean(),
+	draftRevision: DocumentRevision,
+	digest: z.string().regex(/^[0-9a-f]{64}$/),
+	delivery: z.enum([
+		"pending",
+		"delivered",
+		"rejected",
+		"undeliverable"
+	]),
+	deliveries: z.array(DeliveryStatus).readonly().exactOptional(),
+	duplicate: z.literal(true).exactOptional()
+}).register(wireRegistry, {
+	id: "SubmissionSummary",
+	description: "A submission as a submit answers it: ID, time, epoch, version, view, digest, delivery."
+});
+const RectSchema = z.object({
+	x: z.number(),
+	y: z.number(),
+	width: z.number(),
+	height: z.number()
+});
+/** The Zod schema of the `ResultComment` type. */
+const ResultComment = z.object({
+	threadId: z.string(),
+	status: z.enum(["open", "resolved"]),
+	messages: z.array(z.object({
+		author: Viewer,
+		at: z.iso.datetime(),
+		text: z.string()
+	})).readonly(),
+	anchor: z.object({
+		reviewId: z.string().exactOptional(),
+		selectors: z.array(z.unknown()).readonly().exactOptional(),
+		rect: RectSchema.exactOptional(),
+		viewport: z.object({
+			width: z.number(),
+			height: z.number(),
+			dpr: z.number()
+		}).exactOptional(),
+		page: z.string().exactOptional(),
+		candidateId: z.string().exactOptional(),
+		terminal: z.object({
+			rows: z.tuple([z.int(), z.int()]).readonly(),
+			cols: z.tuple([z.int(), z.int()]).readonly(),
+			t: z.number().exactOptional()
+		}).exactOptional(),
+		time: z.number().exactOptional(),
+		slide: z.object({
+			index: z.int(),
+			step: z.int()
+		}).exactOptional()
+	}),
+	crop: z.object({
+		path: z.string(),
+		width: z.int(),
+		height: z.int()
+	})
+}).register(wireRegistry, {
+	id: "ResultComment",
+	description: "One comment thread in results: messages, anchor layers and the screenshot crop."
+});
+/** The Zod schema of the `Results` type. */
+const Results = z.object({
+	artifact: z.object({
+		id: ArtifactId.schema,
+		title: z.string(),
+		description: z.string().exactOptional(),
+		family: z.string().exactOptional(),
+		links: z.array(ArtifactLink).readonly()
+	}),
+	submission: z.object({
+		id: SubmissionId.schema,
+		at: z.iso.datetime(),
+		epoch: z.int().min(1),
+		previous: SubmissionId.schema.exactOptional(),
+		policy: SubmissionPolicy,
+		channel: z.enum(["shell", "artifact"]),
+		viewer: Viewer,
+		versionId: VersionId.schema,
+		version: z.int().min(1),
+		viewId: ViewId.schema,
+		staleView: z.boolean(),
+		latestVersion: z.int().min(1).exactOptional(),
+		draftRevision: DocumentRevision,
+		stateRevision: DocumentRevision.exactOptional(),
+		digest: z.string().regex(/^[0-9a-f]{64}$/),
+		delivery: z.enum([
+			"pending",
+			"delivered",
+			"rejected",
+			"undeliverable"
+		]),
+		deliveries: z.array(DeliveryStatus).readonly()
+	}),
+	answers: z.record(z.string(), z.unknown()),
+	fields: z.array(z.object({
+		id: z.string(),
+		label: z.string().exactOptional(),
+		required: z.boolean().exactOptional(),
+		sensitive: z.boolean().exactOptional(),
+		scope: z.enum(["viewer", "artifact"])
+	})).readonly(),
+	state: z.record(z.string(), z.unknown()).exactOptional(),
+	choices: z.array(z.object({
+		reviewSetId: z.string(),
+		candidateId: z.string(),
+		label: z.string().exactOptional()
+	})).readonly(),
+	comments: z.array(ResultComment).readonly(),
+	orphaned: z.array(z.object({
+		id: z.string(),
+		label: z.string().exactOptional(),
+		value: z.unknown(),
+		fromVersion: z.int().min(1)
+	})).readonly(),
+	actions: z.array(z.object({
+		runId: z.string(),
+		action: z.string(),
+		status: z.string(),
+		at: z.iso.datetime()
+	})).readonly(),
+	signals: z.array(z.object({
+		name: z.string(),
+		at: z.iso.datetime(),
+		payload: z.unknown().exactOptional()
+	})).readonly(),
+	signalsOmitted: z.int().min(1).exactOptional(),
+	signalsCompacted: z.literal(true).exactOptional()
+}).register(wireRegistry, {
+	id: "Results",
+	description: "The complete submission: artifact, submission facts, answers, fields, state, choices, comments, orphans, actions, signals."
+});
+//#endregion
+export { Actor, ControlsPolicy, DeliveryStatus, DocumentRevision, EventFilter, EventRecord, EventTypePattern, FIELD_ID_MAX_LENGTH, FieldConflict, FieldOp, FieldState, MutationResult, ResultComment, Results, SIGNAL_NAME_PATTERN, SubmissionSummary, SubmitChannel, TrustedControl, Viewer, ViewerSpec, WaitCondition, isFieldId };
+
+//# sourceMappingURL=interaction.js.map

package/dist/interaction.js.map

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

package/dist/manifest.d.ts

@@ -0,0 +1,97 @@
+import * as z from "zod";
+//#region src/manifest.d.ts
+/** The families Mostra's templates and gallery know; any other string is allowed too. */
+export type ArtifactFamily = "questionnaire" | "proposal" | "prototype" | "review" | "dashboard" | "deck" | "demo" | "inbox" | "tasks" | (string & {});
+/** A related artifact (PRODUCT J6): a later round, a follow-up, a replacement. */
+export interface ArtifactLink {
+  /** How this artifact relates to the other one. */
+  readonly rel: "round-of" | "follows" | "replaces" | (string & {});
+  /** The other artifact's ID. */
+  readonly artifact: string;
+}
+/**
+ * The submission policy an artifact requests (D10, D39, D63). The host decides the policy in force;
+ * the manifest only asks for one.
+ */
+export type SubmissionPolicy = {
+  readonly policy: "once";
+  readonly scope?: "per-artifact" | "per-viewer";
+} | {
+  readonly policy: "epochs";
+} | {
+  readonly policy: "none";
+};
+/** A live terminal session the artifact declares (ROUND-3 §5.1, D65). */
+export interface TerminalSpec {
+  /** The program and its arguments. */
+  readonly command: readonly string[];
+  /** Its working directory, relative to the artifact's source. */
+  readonly cwd?: string;
+  /** Extra environment variables. */
+  readonly env?: Readonly<Record<string, string>>;
+  /** The terminal's width in cells. */
+  readonly cols?: number;
+  /** The terminal's height in cells. */
+  readonly rows?: number;
+  /** Whether viewers may type into it. Sessions are read-only by default. */
+  readonly input?: boolean;
+}
+/** A web demo the artifact declares (ROUND-3 §5.4, TM-08): a command to run, or a port to attach to. */
+export type DemoSpec = {
+  readonly command: readonly string[];
+  readonly cwd?: string;
+  readonly ready?: string;
+  readonly bridge?: boolean;
+} | {
+  readonly attach: number;
+  readonly bridge?: boolean;
+};
+/** The artifact manifest (INTERFACES §2.2). Every field except `title` is optional. */
+export interface ArtifactManifest {
+  /** The artifact's ID. Written by `mostra new`; without one, the artifact is bound to its source path at first publish (D51). */
+  readonly id?: string;
+  /** The title people see. */
+  readonly title: string;
+  /** One or two sentences on what the artifact is for. */
+  readonly description?: string;
+  /** What kind of artifact it is; templates and the gallery group by it. */
+  readonly family?: ArtifactFamily;
+  /** Related artifacts. */
+  readonly links?: readonly ArtifactLink[];
+  /** How the artifact is built and served: `spa`, the default and the only mode in v1 (D19). */
+  readonly mode?: "spa";
+  /** The submission policy the artifact requests; the host decides (D39, D63). */
+  readonly submission?: SubmissionPolicy;
+  /** The kit's shadcn base (default `base`, D72) and theme. */
+  readonly kit?: {
+    readonly base?: "base" | "radix";
+    readonly theme?: string;
+  };
+  /** Live terminal sessions by name (D65). */
+  readonly terminals?: Readonly<Record<string, TerminalSpec>>;
+  /** Web demos by name (D65). */
+  readonly demos?: Readonly<Record<string, DemoSpec>>;
+  /** Stability limits for the artifact's worker (D62). */
+  readonly limits?: {
+    readonly heapMb?: number;
+    readonly watchdogMs?: number;
+    readonly idleMinutes?: number;
+  };
+  /** `verify` settings (D65). */
+  readonly verify?: {
+    readonly viewports?: readonly string[];
+    readonly frames?: readonly string[];
+    readonly extraChecks?: readonly string[];
+    readonly smoke?: boolean;
+  };
+}
+/** The keys of the artifact manifest, in INTERFACES §2.2 order. Other keys are warnings (FAILURE_MODEL §10). */
+export declare const ARTIFACT_MANIFEST_KEYS: readonly (keyof ArtifactManifest)[];
+/** The Zod schema of the `ArtifactLink` type. */
+export declare const ArtifactLink: z.ZodType<ArtifactLink>;
+/** The Zod schema of the `SubmissionPolicy` type. */
+export declare const SubmissionPolicy: z.ZodType<SubmissionPolicy>;
+/** The Zod schema of the `ArtifactManifest` type. Objects stay open, so newer keys pass through. */
+export declare const ArtifactManifest: z.ZodType<ArtifactManifest>;
+//#endregion
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","names":[],"sources":["../src/manifest.ts"],"mappings":";;;YAeY;;iBAaK;;WAEN;;WAEA;;;;;;YAOC;WACG;WAAyB;;WACzB;;WACA;;;iBAGE;;WAEN;;WAEA;;WAEA,MAAM,SAAS;;WAEf;;WAEA;;WAEA;;;YAIC;WAEG;WACA;WACA;WACA;;WAEA;WAAyB;;;iBAGvB;;WAEN;;WAEA;;WAEA;;WAEA,SAAS;;WAET,iBAAiB;;WAEjB;;WAEA,aAAa;;WAEb;aAAiB;aAAkC;;;WAEnD,YAAY,SAAS,eAAe;;WAEpC,QAAQ,SAAS,eAAe;;WAEhC;aACE;aACA;aACA;;;WAGF;aACE;aACA;aACA;aACA;;;;qBAKA,wCAAwC;;qBAkBxC,cAAc,EAAE,QAAQ;;qBAQxB,kBAAkB,EAAE,QAAQ;;qBAkC5B,kBAAkB,EAAE,QAAQ"}

package/dist/manifest.js

@@ -0,0 +1,101 @@
+import { wireRegistry } from "./wire-registry.js";
+import { ArtifactId } from "./ids.js";
+import * as z from "zod";
+//#region src/manifest.ts
+/**
+* The artifact manifest (INTERFACES §2.2, D51): the metadata an artifact declares in its entry, as
+* `export const artifact = defineArtifact({...})` in TSX or as YAML frontmatter in MDX. Mostra reads
+* it statically, so every value is a literal. The same type checks `defineArtifact` for authors,
+* validates the extracted literal in the supervisor and travels on the wire in `artifact/get`.
+*
+* ```ts
+* const checked = ArtifactManifest.safeParse(extracted);
+* ```
+*/
+/** The keys of the artifact manifest, in INTERFACES §2.2 order. Other keys are warnings (FAILURE_MODEL §10). */
+const ARTIFACT_MANIFEST_KEYS = [
+	"id",
+	"title",
+	"description",
+	"family",
+	"links",
+	"mode",
+	"submission",
+	"kit",
+	"terminals",
+	"demos",
+	"limits",
+	"verify"
+];
+const strings = z.array(z.string()).readonly();
+/** The Zod schema of the `ArtifactLink` type. */
+const ArtifactLink = z.object({
+	rel: z.string().min(1),
+	artifact: z.string().min(1)
+}).register(wireRegistry, {
+	id: "ArtifactLink",
+	description: "A related artifact: how this one relates (rel) and the other artifact's ID."
+});
+/** The Zod schema of the `SubmissionPolicy` type. */
+const SubmissionPolicy = z.discriminatedUnion("policy", [
+	z.object({
+		policy: z.literal("once"),
+		scope: z.enum(["per-artifact", "per-viewer"]).exactOptional()
+	}),
+	z.object({ policy: z.literal("epochs") }),
+	z.object({ policy: z.literal("none") })
+]).register(wireRegistry, {
+	id: "SubmissionPolicy",
+	description: "A submission policy: once (per-artifact or per-viewer), epochs, or none."
+});
+const TerminalSpec = z.object({
+	command: z.array(z.string()).min(1).readonly(),
+	cwd: z.string().exactOptional(),
+	env: z.record(z.string(), z.string()).readonly().exactOptional(),
+	cols: z.int().min(1).exactOptional(),
+	rows: z.int().min(1).exactOptional(),
+	input: z.boolean().exactOptional()
+});
+const DemoSpec = z.union([z.object({
+	command: z.array(z.string()).min(1).readonly(),
+	cwd: z.string().exactOptional(),
+	ready: z.string().exactOptional(),
+	bridge: z.boolean().exactOptional()
+}), z.object({
+	attach: z.int().min(1).max(65535),
+	bridge: z.boolean().exactOptional()
+})]);
+/** The Zod schema of the `ArtifactManifest` type. Objects stay open, so newer keys pass through. */
+const ArtifactManifest = z.object({
+	id: ArtifactId.schema.exactOptional(),
+	title: z.string().min(1),
+	description: z.string().exactOptional(),
+	family: z.string().min(1).exactOptional(),
+	links: z.array(ArtifactLink).readonly().exactOptional(),
+	mode: z.literal("spa").exactOptional(),
+	submission: SubmissionPolicy.exactOptional(),
+	kit: z.object({
+		base: z.enum(["base", "radix"]).exactOptional(),
+		theme: z.string().exactOptional()
+	}).exactOptional(),
+	terminals: z.record(z.string(), TerminalSpec).readonly().exactOptional(),
+	demos: z.record(z.string(), DemoSpec).readonly().exactOptional(),
+	limits: z.object({
+		heapMb: z.int().min(1).exactOptional(),
+		watchdogMs: z.int().min(1).exactOptional(),
+		idleMinutes: z.number().min(0).exactOptional()
+	}).exactOptional(),
+	verify: z.object({
+		viewports: strings.exactOptional(),
+		frames: strings.exactOptional(),
+		extraChecks: strings.exactOptional(),
+		smoke: z.boolean().exactOptional()
+	}).exactOptional()
+}).register(wireRegistry, {
+	id: "ArtifactManifest",
+	description: "The artifact manifest (INTERFACES §2.2): literal metadata from the entry's defineArtifact call or MDX frontmatter."
+});
+//#endregion
+export { ARTIFACT_MANIFEST_KEYS, ArtifactLink, ArtifactManifest, SubmissionPolicy };
+
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","names":[],"sources":["../src/manifest.ts"],"sourcesContent":["/**\n * The artifact manifest (INTERFACES §2.2, D51): the metadata an artifact declares in its entry, as\n * `export const artifact = defineArtifact({...})` in TSX or as YAML frontmatter in MDX. Mostra reads\n * it statically, so every value is a literal. The same type checks `defineArtifact` for authors,\n * validates the extracted literal in the supervisor and travels on the wire in `artifact/get`.\n *\n * ```ts\n * const checked = ArtifactManifest.safeParse(extracted);\n * ```\n */\nimport * as z from \"zod\";\nimport { ArtifactId } from \"./ids.ts\";\nimport { wireRegistry } from \"./wire-registry.ts\";\n\n/** The families Mostra's templates and gallery know; any other string is allowed too. */\nexport type ArtifactFamily =\n  | \"questionnaire\"\n  | \"proposal\"\n  | \"prototype\"\n  | \"review\"\n  | \"dashboard\"\n  | \"deck\"\n  | \"demo\"\n  | \"inbox\"\n  | \"tasks\"\n  | (string & {});\n\n/** A related artifact (PRODUCT J6): a later round, a follow-up, a replacement. */\nexport interface ArtifactLink {\n  /** How this artifact relates to the other one. */\n  readonly rel: \"round-of\" | \"follows\" | \"replaces\" | (string & {});\n  /** The other artifact's ID. */\n  readonly artifact: string;\n}\n\n/**\n * The submission policy an artifact requests (D10, D39, D63). The host decides the policy in force;\n * the manifest only asks for one.\n */\nexport type SubmissionPolicy =\n  | { readonly policy: \"once\"; readonly scope?: \"per-artifact\" | \"per-viewer\" }\n  | { readonly policy: \"epochs\" }\n  | { readonly policy: \"none\" };\n\n/** A live terminal session the artifact declares (ROUND-3 §5.1, D65). */\nexport interface TerminalSpec {\n  /** The program and its arguments. */\n  readonly command: readonly string[];\n  /** Its working directory, relative to the artifact's source. */\n  readonly cwd?: string;\n  /** Extra environment variables. */\n  readonly env?: Readonly<Record<string, string>>;\n  /** The terminal's width in cells. */\n  readonly cols?: number;\n  /** The terminal's height in cells. */\n  readonly rows?: number;\n  /** Whether viewers may type into it. Sessions are read-only by default. */\n  readonly input?: boolean;\n}\n\n/** A web demo the artifact declares (ROUND-3 §5.4, TM-08): a command to run, or a port to attach to. */\nexport type DemoSpec =\n  | {\n      readonly command: readonly string[];\n      readonly cwd?: string;\n      readonly ready?: string;\n      readonly bridge?: boolean;\n    }\n  | { readonly attach: number; readonly bridge?: boolean };\n\n/** The artifact manifest (INTERFACES §2.2). Every field except `title` is optional. */\nexport interface ArtifactManifest {\n  /** The artifact's ID. Written by `mostra new`; without one, the artifact is bound to its source path at first publish (D51). */\n  readonly id?: string;\n  /** The title people see. */\n  readonly title: string;\n  /** One or two sentences on what the artifact is for. */\n  readonly description?: string;\n  /** What kind of artifact it is; templates and the gallery group by it. */\n  readonly family?: ArtifactFamily;\n  /** Related artifacts. */\n  readonly links?: readonly ArtifactLink[];\n  /** How the artifact is built and served: `spa`, the default and the only mode in v1 (D19). */\n  readonly mode?: \"spa\";\n  /** The submission policy the artifact requests; the host decides (D39, D63). */\n  readonly submission?: SubmissionPolicy;\n  /** The kit's shadcn base (default `base`, D72) and theme. */\n  readonly kit?: { readonly base?: \"base\" | \"radix\"; readonly theme?: string };\n  /** Live terminal sessions by name (D65). */\n  readonly terminals?: Readonly<Record<string, TerminalSpec>>;\n  /** Web demos by name (D65). */\n  readonly demos?: Readonly<Record<string, DemoSpec>>;\n  /** Stability limits for the artifact's worker (D62). */\n  readonly limits?: {\n    readonly heapMb?: number;\n    readonly watchdogMs?: number;\n    readonly idleMinutes?: number;\n  };\n  /** `verify` settings (D65). */\n  readonly verify?: {\n    readonly viewports?: readonly string[];\n    readonly frames?: readonly string[];\n    readonly extraChecks?: readonly string[];\n    readonly smoke?: boolean;\n  };\n}\n\n/** The keys of the artifact manifest, in INTERFACES §2.2 order. Other keys are warnings (FAILURE_MODEL §10). */\nexport const ARTIFACT_MANIFEST_KEYS: readonly (keyof ArtifactManifest)[] = [\n  \"id\",\n  \"title\",\n  \"description\",\n  \"family\",\n  \"links\",\n  \"mode\",\n  \"submission\",\n  \"kit\",\n  \"terminals\",\n  \"demos\",\n  \"limits\",\n  \"verify\",\n];\n\nconst strings = z.array(z.string()).readonly();\n\n/** The Zod schema of the `ArtifactLink` type. */\nexport const ArtifactLink: z.ZodType<ArtifactLink> = z\n  .object({ rel: z.string().min(1), artifact: z.string().min(1) })\n  .register(wireRegistry, {\n    id: \"ArtifactLink\",\n    description: \"A related artifact: how this one relates (rel) and the other artifact's ID.\",\n  });\n\n/** The Zod schema of the `SubmissionPolicy` type. */\nexport const SubmissionPolicy: z.ZodType<SubmissionPolicy> = z\n  .discriminatedUnion(\"policy\", [\n    z.object({\n      policy: z.literal(\"once\"),\n      scope: z.enum([\"per-artifact\", \"per-viewer\"]).exactOptional(),\n    }),\n    z.object({ policy: z.literal(\"epochs\") }),\n    z.object({ policy: z.literal(\"none\") }),\n  ])\n  .register(wireRegistry, {\n    id: \"SubmissionPolicy\",\n    description: \"A submission policy: once (per-artifact or per-viewer), epochs, or none.\",\n  });\n\nconst TerminalSpec: z.ZodType<TerminalSpec> = z.object({\n  command: z.array(z.string()).min(1).readonly(),\n  cwd: z.string().exactOptional(),\n  env: z.record(z.string(), z.string()).readonly().exactOptional(),\n  cols: z.int().min(1).exactOptional(),\n  rows: z.int().min(1).exactOptional(),\n  input: z.boolean().exactOptional(),\n});\n\nconst DemoSpec: z.ZodType<DemoSpec> = z.union([\n  z.object({\n    command: z.array(z.string()).min(1).readonly(),\n    cwd: z.string().exactOptional(),\n    ready: z.string().exactOptional(),\n    bridge: z.boolean().exactOptional(),\n  }),\n  z.object({ attach: z.int().min(1).max(65535), bridge: z.boolean().exactOptional() }),\n]);\n\n/** The Zod schema of the `ArtifactManifest` type. Objects stay open, so newer keys pass through. */\nexport const ArtifactManifest: z.ZodType<ArtifactManifest> = z\n  .object({\n    id: ArtifactId.schema.exactOptional(),\n    title: z.string().min(1),\n    description: z.string().exactOptional(),\n    family: z.string().min(1).exactOptional(),\n    links: z.array(ArtifactLink).readonly().exactOptional(),\n    mode: z.literal(\"spa\").exactOptional(),\n    submission: SubmissionPolicy.exactOptional(),\n    kit: z\n      .object({\n        base: z.enum([\"base\", \"radix\"]).exactOptional(),\n        theme: z.string().exactOptional(),\n      })\n      .exactOptional(),\n    terminals: z.record(z.string(), TerminalSpec).readonly().exactOptional(),\n    demos: z.record(z.string(), DemoSpec).readonly().exactOptional(),\n    limits: z\n      .object({\n        heapMb: z.int().min(1).exactOptional(),\n        watchdogMs: z.int().min(1).exactOptional(),\n        idleMinutes: z.number().min(0).exactOptional(),\n      })\n      .exactOptional(),\n    verify: z\n      .object({\n        viewports: strings.exactOptional(),\n        frames: strings.exactOptional(),\n        extraChecks: strings.exactOptional(),\n        smoke: z.boolean().exactOptional(),\n      })\n      .exactOptional(),\n  })\n  .register(wireRegistry, {\n    id: \"ArtifactManifest\",\n    description:\n      \"The artifact manifest (INTERFACES §2.2): literal metadata from the entry's defineArtifact call or MDX frontmatter.\",\n  });\n"],"mappings":"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"}

package/dist/method.d.ts

@@ -0,0 +1,26 @@
+import * as z from "zod";
+//#region src/method.d.ts
+/** Who sends the request: a client to the instance, or the instance to a registering host (ports). */
+export type MethodDirection = "client-to-instance" | "instance-to-host";
+/** One protocol method. */
+export interface MethodDefinition<Params, Result> {
+  /** The JSON-RPC method name: `group/name` (`artifact/publish`) or a bare name (`wait`). */
+  readonly method: string;
+  /** Who sends the request. */
+  readonly direction: MethodDirection;
+  /**
+   * Whether the method changes durable state. Mutating methods take an optional `requestId`, and a
+   * retry with the same ID returns the recorded result (H-03).
+   */
+  readonly mutating: boolean;
+  /** The schema of the request's `params`. */
+  readonly params: z.ZodType<Params>;
+  /** The schema of a successful response's `result`. */
+  readonly result: z.ZodType<Result>;
+}
+/** A method of any params and result type. */
+export type AnyMethod = MethodDefinition<unknown, unknown>;
+/** Defines a protocol method, checking its name has the `group/name` (or bare `name`) form. */
+export declare function defineMethod<Params, Result>(definition: MethodDefinition<Params, Result>): MethodDefinition<Params, Result>;
+//#endregion
+//# sourceMappingURL=method.d.ts.map

package/dist/method.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"method.d.ts","names":[],"sources":["../src/method.ts"],"mappings":";;;YASY;;iBAGK,iBAAiB,QAAQ;;WAE/B;;WAEA,WAAW;;;;;WAKX;;WAEA,QAAQ,EAAE,QAAQ;;WAElB,QAAQ,EAAE,QAAQ;;;YAIjB,YAAY;;wBAGR,aAAa,QAAQ,QACnC,YAAY,iBAAiB,QAAQ,UACpC,iBAAiB,QAAQ"}

package/dist/method.js

@@ -0,0 +1,10 @@
+//#region src/method.ts
+/** Defines a protocol method, checking its name has the `group/name` (or bare `name`) form. */
+function defineMethod(definition) {
+	if (!/^([a-z][a-zA-Z]*\/)?[a-z][a-zA-Z.]*$/.test(definition.method)) throw new Error(`Protocol method names have the form group/name or name, got "${definition.method}".`);
+	return definition;
+}
+//#endregion
+export { defineMethod };
+
+//# sourceMappingURL=method.js.map