@mostra/protocol 0.0.0-stage → 0.1.0

package/dist/methods/instance/status.d.ts

@@ -0,0 +1,102 @@
+import { MethodDefinition } from "../../method.js";
+import { InstanceInfo } from "../mostra/initialize.js";
+import * as z from "zod";
+//#region src/methods/instance/status.d.ts
+/** The params of `instance/status` (INTERFACES §6): none. */
+export type InstanceStatusParams = Record<string, never>;
+/** One child process the instance supervises. */
+export interface ChildProcessStatus {
+  /** The process ID. The child leads its own process group, so this is also its group ID. */
+  readonly pid: number;
+  /** What the child is: `builder`, `verify`, `worker`, `pty-host`, `demo`, `install` and so on. */
+  readonly kind: string;
+  /** What the child serves, such as an artifact or version ID. */
+  readonly ownerRef: string;
+  /** When the instance started it (RFC 3339, UTC). */
+  readonly startedAt: string;
+}
+/** Where the gateway listens (D99, WP-05). */
+export interface GatewayStatus {
+  /** The address its listeners bind: `127.0.0.1` unless the instance started with `--bind`. */
+  readonly bind: string;
+  /** The shell's origin, where every capability link points. */
+  readonly shell: string;
+  /** The artifact origins it is serving now, one per opened artifact. */
+  readonly artifacts: readonly {
+    readonly artifactId: string;
+    readonly origin: string;
+  }[];
+}
+/**
+ * The result of `instance/status`. The packages that add ports, deliveries, shares and versions
+ * add their fields here (INTERFACES §6).
+ */
+export interface InstanceStatusResult {
+  /** The instance itself. */
+  readonly instance: InstanceInfo;
+  /** When the instance took ownership of its home (RFC 3339, UTC). */
+  readonly startedAt: string;
+  /** The control socket clients attach to. */
+  readonly socket: string;
+  /** How many protocol connections are open, this one included. */
+  readonly connections: number;
+  /** The child processes the instance supervises. */
+  readonly processes: readonly ChildProcessStatus[];
+  /** Where the gateway listens, once it has started (WP-05). */
+  readonly gateway?: GatewayStatus;
+  /** The outbox per host (WP-06, D105): how many deliveries are in each state. */
+  readonly deliveries?: readonly DeliveryCounts[];
+  /** The artifact workers, one per active version with server code (WP-08, RT-03). */
+  readonly workers?: readonly WorkerStatus[];
+  /** When the daemon exits for lack of work, if it will (WP-08, RT-08); absent: it won't. */
+  readonly idleExitAt?: string;
+}
+/** One artifact version's worker (RT-03, D62). */
+export interface WorkerStatus {
+  /** The artifact. */
+  readonly artifactId: string;
+  /** The version. */
+  readonly versionId: string;
+  /**
+   * `starting`, `ready`, `backoff` (it crashed and restarts on the next request after `retryAt`),
+   * `parked` (it crashed more than 5 times in 10 minutes, FAILURE_MODEL §2), `stopped`.
+   */
+  readonly state: "starting" | "ready" | "backoff" | "parked" | "stopped";
+  /** The worker's process, while it runs locally. */
+  readonly pid?: number;
+  /** Crashes in the last 10 minutes. */
+  readonly crashes: number;
+  /** The last crash's cause, such as `out of memory` or `event loop blocked for 10 s`. */
+  readonly lastCause?: string;
+  /** When a worker in `backoff` may start again. */
+  readonly retryAt?: string;
+  /** Calls, runs and live producers it serves now. */
+  readonly active: number;
+}
+/** The Zod schema of the `WorkerStatus` type. */
+export declare const WorkerStatus: z.ZodType<WorkerStatus>;
+/** One host's deliveries by state (D105). */
+export interface DeliveryCounts {
+  /** The host's client name; empty for Mostra's built-in adapter (D105). */
+  readonly owner: string;
+  /** Whether a connection of this host has the submissions port registered now. */
+  readonly connected: boolean;
+  /** Deliveries not yet answered terminally. */
+  readonly pending: number;
+  /** Deliveries the host accepted. */
+  readonly delivered: number;
+  /** Deliveries the host rejected terminally. */
+  readonly rejected: number;
+  /** Deliveries the host declared undeliverable. */
+  readonly undeliverable: number;
+}
+/** The Zod schema of the `DeliveryCounts` type. */
+export declare const DeliveryCounts: z.ZodType<DeliveryCounts>;
+/** The Zod schema of the `GatewayStatus` type. */
+export declare const GatewayStatus: z.ZodType<GatewayStatus>;
+/** The Zod schema of the `ChildProcessStatus` type. */
+export declare const ChildProcessStatus: z.ZodType<ChildProcessStatus>;
+/** `instance/status`: reports the instance, its socket, its connections and its child processes. */
+export declare const instanceStatusMethod: MethodDefinition<InstanceStatusParams, InstanceStatusResult>;
+//#endregion
+//# sourceMappingURL=status.d.ts.map

package/dist/methods/instance/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","names":[],"sources":["../../../src/methods/instance/status.ts"],"mappings":";;;;;YAMY,uBAAuB;;iBAGlB;;WAEN;;WAEA;;WAEA;;WAEA;;;iBAIM;;WAEN;;WAEA;;WAEA;aAA+B;aAA6B;;;;;;;iBAOtD;;WAEN,UAAU;;WAEV;;WAEA;;WAEA;;WAEA,oBAAoB;;WAEpB,UAAU;;WAEV,sBAAsB;;WAEtB,mBAAmB;;WAEnB;;;iBAIM;;WAEN;;WAEA;;;;;WAKA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;;qBAIE,cAAc,EAAE,QAAQ;;iBAcpB;;WAEN;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;;qBAIE,gBAAgB,EAAE,QAAQ;;qBAe1B,eAAe,EAAE,QAAQ;;qBASzB,oBAAoB,EAAE,QAAQ;;qBA+B9B,sBAAsB,iBAAiB,sBAAsB"}

package/dist/methods/instance/status.js

@@ -0,0 +1,83 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { defineMethod } from "../../method.js";
+import { InstanceInfo } from "../mostra/initialize.js";
+import * as z from "zod";
+//#region src/methods/instance/status.ts
+/** The Zod schema of the `WorkerStatus` type. */
+const WorkerStatus = z.object({
+	artifactId: z.string(),
+	versionId: z.string(),
+	state: z.enum([
+		"starting",
+		"ready",
+		"backoff",
+		"parked",
+		"stopped"
+	]),
+	pid: z.int().min(1).exactOptional(),
+	crashes: z.int().min(0),
+	lastCause: z.string().exactOptional(),
+	retryAt: z.string().exactOptional(),
+	active: z.int().min(0)
+}).register(wireRegistry, {
+	id: "WorkerStatus",
+	description: "One artifact version's worker."
+});
+/** The Zod schema of the `DeliveryCounts` type. */
+const DeliveryCounts = z.object({
+	owner: z.string(),
+	connected: z.boolean(),
+	pending: z.int().min(0),
+	delivered: z.int().min(0),
+	rejected: z.int().min(0),
+	undeliverable: z.int().min(0)
+}).register(wireRegistry, {
+	id: "DeliveryCounts",
+	description: "One host's deliveries by state, and whether it is connected."
+});
+/** The Zod schema of the `GatewayStatus` type. */
+const GatewayStatus = z.object({
+	bind: z.string(),
+	shell: z.string(),
+	artifacts: z.array(z.object({
+		artifactId: z.string(),
+		origin: z.string()
+	})).readonly()
+}).register(wireRegistry, {
+	id: "GatewayStatus",
+	description: "Where the gateway listens."
+});
+/** The Zod schema of the `ChildProcessStatus` type. */
+const ChildProcessStatus = z.object({
+	pid: z.int().min(1),
+	kind: z.string(),
+	ownerRef: z.string(),
+	startedAt: z.iso.datetime()
+}).register(wireRegistry, {
+	id: "ChildProcessStatus",
+	description: "One child process the instance supervises."
+});
+const params = z.object({}).register(wireRegistry, { id: "InstanceStatusParams" });
+const result = z.object({
+	instance: InstanceInfo,
+	startedAt: z.iso.datetime(),
+	socket: z.string(),
+	connections: z.int().min(0),
+	processes: z.array(ChildProcessStatus).readonly(),
+	gateway: GatewayStatus.exactOptional(),
+	deliveries: z.array(DeliveryCounts).readonly().exactOptional(),
+	workers: z.array(WorkerStatus).readonly().exactOptional(),
+	idleExitAt: z.string().exactOptional()
+}).register(wireRegistry, { id: "InstanceStatusResult" });
+/** `instance/status`: reports the instance, its socket, its connections and its child processes. */
+const instanceStatusMethod = defineMethod({
+	method: "instance/status",
+	direction: "client-to-instance",
+	mutating: false,
+	params,
+	result
+});
+//#endregion
+export { ChildProcessStatus, DeliveryCounts, GatewayStatus, WorkerStatus, instanceStatusMethod };
+
+//# sourceMappingURL=status.js.map

package/dist/methods/instance/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","names":[],"sources":["../../../src/methods/instance/status.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\nimport { InstanceInfo } from \"../mostra/initialize.ts\";\n\n/** The params of `instance/status` (INTERFACES §6): none. */\nexport type InstanceStatusParams = Record<string, never>;\n\n/** One child process the instance supervises. */\nexport interface ChildProcessStatus {\n  /** The process ID. The child leads its own process group, so this is also its group ID. */\n  readonly pid: number;\n  /** What the child is: `builder`, `verify`, `worker`, `pty-host`, `demo`, `install` and so on. */\n  readonly kind: string;\n  /** What the child serves, such as an artifact or version ID. */\n  readonly ownerRef: string;\n  /** When the instance started it (RFC 3339, UTC). */\n  readonly startedAt: string;\n}\n\n/** Where the gateway listens (D99, WP-05). */\nexport interface GatewayStatus {\n  /** The address its listeners bind: `127.0.0.1` unless the instance started with `--bind`. */\n  readonly bind: string;\n  /** The shell's origin, where every capability link points. */\n  readonly shell: string;\n  /** The artifact origins it is serving now, one per opened artifact. */\n  readonly artifacts: readonly { readonly artifactId: string; readonly origin: string }[];\n}\n\n/**\n * The result of `instance/status`. The packages that add ports, deliveries, shares and versions\n * add their fields here (INTERFACES §6).\n */\nexport interface InstanceStatusResult {\n  /** The instance itself. */\n  readonly instance: InstanceInfo;\n  /** When the instance took ownership of its home (RFC 3339, UTC). */\n  readonly startedAt: string;\n  /** The control socket clients attach to. */\n  readonly socket: string;\n  /** How many protocol connections are open, this one included. */\n  readonly connections: number;\n  /** The child processes the instance supervises. */\n  readonly processes: readonly ChildProcessStatus[];\n  /** Where the gateway listens, once it has started (WP-05). */\n  readonly gateway?: GatewayStatus;\n  /** The outbox per host (WP-06, D105): how many deliveries are in each state. */\n  readonly deliveries?: readonly DeliveryCounts[];\n  /** The artifact workers, one per active version with server code (WP-08, RT-03). */\n  readonly workers?: readonly WorkerStatus[];\n  /** When the daemon exits for lack of work, if it will (WP-08, RT-08); absent: it won't. */\n  readonly idleExitAt?: string;\n}\n\n/** One artifact version's worker (RT-03, D62). */\nexport interface WorkerStatus {\n  /** The artifact. */\n  readonly artifactId: string;\n  /** The version. */\n  readonly versionId: string;\n  /**\n   * `starting`, `ready`, `backoff` (it crashed and restarts on the next request after `retryAt`),\n   * `parked` (it crashed more than 5 times in 10 minutes, FAILURE_MODEL §2), `stopped`.\n   */\n  readonly state: \"starting\" | \"ready\" | \"backoff\" | \"parked\" | \"stopped\";\n  /** The worker's process, while it runs locally. */\n  readonly pid?: number;\n  /** Crashes in the last 10 minutes. */\n  readonly crashes: number;\n  /** The last crash's cause, such as `out of memory` or `event loop blocked for 10 s`. */\n  readonly lastCause?: string;\n  /** When a worker in `backoff` may start again. */\n  readonly retryAt?: string;\n  /** Calls, runs and live producers it serves now. */\n  readonly active: number;\n}\n\n/** The Zod schema of the `WorkerStatus` type. */\nexport const WorkerStatus: z.ZodType<WorkerStatus> = z\n  .object({\n    artifactId: z.string(),\n    versionId: z.string(),\n    state: z.enum([\"starting\", \"ready\", \"backoff\", \"parked\", \"stopped\"]),\n    pid: z.int().min(1).exactOptional(),\n    crashes: z.int().min(0),\n    lastCause: z.string().exactOptional(),\n    retryAt: z.string().exactOptional(),\n    active: z.int().min(0),\n  })\n  .register(wireRegistry, { id: \"WorkerStatus\", description: \"One artifact version's worker.\" });\n\n/** One host's deliveries by state (D105). */\nexport interface DeliveryCounts {\n  /** The host's client name; empty for Mostra's built-in adapter (D105). */\n  readonly owner: string;\n  /** Whether a connection of this host has the submissions port registered now. */\n  readonly connected: boolean;\n  /** Deliveries not yet answered terminally. */\n  readonly pending: number;\n  /** Deliveries the host accepted. */\n  readonly delivered: number;\n  /** Deliveries the host rejected terminally. */\n  readonly rejected: number;\n  /** Deliveries the host declared undeliverable. */\n  readonly undeliverable: number;\n}\n\n/** The Zod schema of the `DeliveryCounts` type. */\nexport const DeliveryCounts: z.ZodType<DeliveryCounts> = z\n  .object({\n    owner: z.string(),\n    connected: z.boolean(),\n    pending: z.int().min(0),\n    delivered: z.int().min(0),\n    rejected: z.int().min(0),\n    undeliverable: z.int().min(0),\n  })\n  .register(wireRegistry, {\n    id: \"DeliveryCounts\",\n    description: \"One host's deliveries by state, and whether it is connected.\",\n  });\n\n/** The Zod schema of the `GatewayStatus` type. */\nexport const GatewayStatus: z.ZodType<GatewayStatus> = z\n  .object({\n    bind: z.string(),\n    shell: z.string(),\n    artifacts: z.array(z.object({ artifactId: z.string(), origin: z.string() })).readonly(),\n  })\n  .register(wireRegistry, { id: \"GatewayStatus\", description: \"Where the gateway listens.\" });\n\n/** The Zod schema of the `ChildProcessStatus` type. */\nexport const ChildProcessStatus: z.ZodType<ChildProcessStatus> = z\n  .object({\n    pid: z.int().min(1),\n    kind: z.string(),\n    ownerRef: z.string(),\n    startedAt: z.iso.datetime(),\n  })\n  .register(wireRegistry, {\n    id: \"ChildProcessStatus\",\n    description: \"One child process the instance supervises.\",\n  });\n\nconst params: z.ZodType<InstanceStatusParams> = z\n  .object({})\n  .register(wireRegistry, { id: \"InstanceStatusParams\" });\n\nconst result: z.ZodType<InstanceStatusResult> = z\n  .object({\n    instance: InstanceInfo,\n    startedAt: z.iso.datetime(),\n    socket: z.string(),\n    connections: z.int().min(0),\n    processes: z.array(ChildProcessStatus).readonly(),\n    gateway: GatewayStatus.exactOptional(),\n    deliveries: z.array(DeliveryCounts).readonly().exactOptional(),\n    workers: z.array(WorkerStatus).readonly().exactOptional(),\n    idleExitAt: z.string().exactOptional(),\n  })\n  .register(wireRegistry, { id: \"InstanceStatusResult\" });\n\n/** `instance/status`: reports the instance, its socket, its connections and its child processes. */\nexport const instanceStatusMethod: MethodDefinition<InstanceStatusParams, InstanceStatusResult> =\n  defineMethod({\n    method: \"instance/status\",\n    direction: \"client-to-instance\",\n    mutating: false,\n    params,\n    result,\n  });\n"],"mappings":";;;;;;AA+EA,MAAa,eAAwC,EAClD,OAAO;CACN,YAAY,EAAE,OAAO;CACrB,WAAW,EAAE,OAAO;CACpB,OAAO,EAAE,KAAK;EAAC;EAAY;EAAS;EAAW;EAAU;CAAS,CAAC;CACnE,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc;CAClC,SAAS,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC;CACtB,WAAW,EAAE,OAAO,CAAC,CAAC,cAAc;CACpC,SAAS,EAAE,OAAO,CAAC,CAAC,cAAc;CAClC,QAAQ,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC;AACvB,CAAC,CAAC,CACD,SAAS,cAAc;CAAE,IAAI;CAAgB,aAAa;AAAiC,CAAC;;AAmB/F,MAAa,iBAA4C,EACtD,OAAO;CACN,OAAO,EAAE,OAAO;CAChB,WAAW,EAAE,QAAQ;CACrB,SAAS,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC;CACtB,WAAW,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC;CACxB,UAAU,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC;CACvB,eAAe,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC;AAC9B,CAAC,CAAC,CACD,SAAS,cAAc;CACtB,IAAI;CACJ,aAAa;AACf,CAAC;;AAGH,MAAa,gBAA0C,EACpD,OAAO;CACN,MAAM,EAAE,OAAO;CACf,OAAO,EAAE,OAAO;CAChB,WAAW,EAAE,MAAM,EAAE,OAAO;EAAE,YAAY,EAAE,OAAO;EAAG,QAAQ,EAAE,OAAO;CAAE,CAAC,CAAC,CAAC,CAAC,SAAS;AACxF,CAAC,CAAC,CACD,SAAS,cAAc;CAAE,IAAI;CAAiB,aAAa;AAA6B,CAAC;;AAG5F,MAAa,qBAAoD,EAC9D,OAAO;CACN,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC;CAClB,MAAM,EAAE,OAAO;CACf,UAAU,EAAE,OAAO;CACnB,WAAW,EAAE,IAAI,SAAS;AAC5B,CAAC,CAAC,CACD,SAAS,cAAc;CACtB,IAAI;CACJ,aAAa;AACf,CAAC;AAEH,MAAM,SAA0C,EAC7C,OAAO,CAAC,CAAC,CAAC,CACV,SAAS,cAAc,EAAE,IAAI,uBAAuB,CAAC;AAExD,MAAM,SAA0C,EAC7C,OAAO;CACN,UAAU;CACV,WAAW,EAAE,IAAI,SAAS;CAC1B,QAAQ,EAAE,OAAO;CACjB,aAAa,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC;CAC1B,WAAW,EAAE,MAAM,kBAAkB,CAAC,CAAC,SAAS;CAChD,SAAS,cAAc,cAAc;CACrC,YAAY,EAAE,MAAM,cAAc,CAAC,CAAC,SAAS,CAAC,CAAC,cAAc;CAC7D,SAAS,EAAE,MAAM,YAAY,CAAC,CAAC,SAAS,CAAC,CAAC,cAAc;CACxD,YAAY,EAAE,OAAO,CAAC,CAAC,cAAc;AACvC,CAAC,CAAC,CACD,SAAS,cAAc,EAAE,IAAI,uBAAuB,CAAC;;AAGxD,MAAa,uBACX,aAAa;CACX,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA;AACF,CAAC"}

package/dist/methods/live/push.d.ts

@@ -0,0 +1,28 @@
+import { ArtifactRef } from "../../artifact.js";
+import { MethodDefinition } from "../../method.js";
+//#region src/methods/live/push.d.ts
+/** The params of `live/push` (INTERFACES §6, D56). */
+export interface LivePushParams {
+  /** The artifact. */
+  readonly artifact: ArtifactRef;
+  /** The live source's key; a key `live.ts` doesn't define is created by the push. */
+  readonly key: string;
+  /** Any JSON, at most 4 MiB. */
+  readonly value: unknown;
+  /** `replace` (default): the new latest value. `append`: also kept in the source's ring. */
+  readonly mode?: "replace" | "append";
+  /** Makes retries idempotent: a repeated `requestId` returns the recorded result (H-03). */
+  readonly requestId?: string;
+}
+/** The result of `live/push`. */
+export interface LivePushResult {
+  /** The value's revision. */
+  readonly revision: string;
+}
+/**
+ * `live/push`: writes a value into an artifact's live source (D56), which every open page reading
+ * it receives at once. The latest value persists; updates are never stored as events (D63).
+ */
+export declare const livePushMethod: MethodDefinition<LivePushParams, LivePushResult>;
+//#endregion
+//# sourceMappingURL=push.d.ts.map

package/dist/methods/live/push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.d.ts","names":[],"sources":["../../../src/methods/live/push.ts"],"mappings":";;;;iBAOiB;;WAEN,UAAU;;WAEV;;WAEA;;WAEA;;WAEA;;;iBAIM;;WAEN;;;;;;qBAwBE,gBAAgB,iBAAiB,gBAAgB"}

package/dist/methods/live/push.js

@@ -0,0 +1,35 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { LIVE_KEY_PATTERN } from "../../actions.js";
+import { ArtifactRef } from "../../artifact.js";
+import { defineMethod } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/live/push.ts
+const params = z.object({
+	artifact: ArtifactRef,
+	key: z.string().regex(LIVE_KEY_PATTERN),
+	value: z.unknown(),
+	mode: z.enum(["replace", "append"]).exactOptional(),
+	requestId: z.string().min(1).exactOptional()
+}).register(wireRegistry, {
+	id: "LivePushParams",
+	description: "A value pushed into an artifact's live source."
+});
+const result = z.object({ revision: z.string() }).register(wireRegistry, {
+	id: "LivePushResult",
+	description: "The pushed value's revision."
+});
+/**
+* `live/push`: writes a value into an artifact's live source (D56), which every open page reading
+* it receives at once. The latest value persists; updates are never stored as events (D63).
+*/
+const livePushMethod = defineMethod({
+	method: "live/push",
+	direction: "client-to-instance",
+	mutating: true,
+	params,
+	result
+});
+//#endregion
+export { livePushMethod };
+
+//# sourceMappingURL=push.js.map

package/dist/methods/live/push.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.js","names":[],"sources":["../../../src/methods/live/push.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { LIVE_KEY_PATTERN } from \"../../actions.ts\";\nimport { ArtifactRef } from \"../../artifact.ts\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\n\n/** The params of `live/push` (INTERFACES §6, D56). */\nexport interface LivePushParams {\n  /** The artifact. */\n  readonly artifact: ArtifactRef;\n  /** The live source's key; a key `live.ts` doesn't define is created by the push. */\n  readonly key: string;\n  /** Any JSON, at most 4 MiB. */\n  readonly value: unknown;\n  /** `replace` (default): the new latest value. `append`: also kept in the source's ring. */\n  readonly mode?: \"replace\" | \"append\";\n  /** Makes retries idempotent: a repeated `requestId` returns the recorded result (H-03). */\n  readonly requestId?: string;\n}\n\n/** The result of `live/push`. */\nexport interface LivePushResult {\n  /** The value's revision. */\n  readonly revision: string;\n}\n\nconst params: z.ZodType<LivePushParams> = z\n  .object({\n    artifact: ArtifactRef,\n    key: z.string().regex(LIVE_KEY_PATTERN),\n    value: z.unknown(),\n    mode: z.enum([\"replace\", \"append\"]).exactOptional(),\n    requestId: z.string().min(1).exactOptional(),\n  })\n  .register(wireRegistry, {\n    id: \"LivePushParams\",\n    description: \"A value pushed into an artifact's live source.\",\n  }) as z.ZodType<LivePushParams>;\n\nconst result: z.ZodType<LivePushResult> = z\n  .object({ revision: z.string() })\n  .register(wireRegistry, { id: \"LivePushResult\", description: \"The pushed value's revision.\" });\n\n/**\n * `live/push`: writes a value into an artifact's live source (D56), which every open page reading\n * it receives at once. The latest value persists; updates are never stored as events (D63).\n */\nexport const livePushMethod: MethodDefinition<LivePushParams, LivePushResult> = defineMethod({\n  method: \"live/push\",\n  direction: \"client-to-instance\",\n  mutating: true,\n  params,\n  result,\n});\n"],"mappings":";;;;;;AA0BA,MAAM,SAAoC,EACvC,OAAO;CACN,UAAU;CACV,KAAK,EAAE,OAAO,CAAC,CAAC,MAAM,gBAAgB;CACtC,OAAO,EAAE,QAAQ;CACjB,MAAM,EAAE,KAAK,CAAC,WAAW,QAAQ,CAAC,CAAC,CAAC,cAAc;CAClD,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc;AAC7C,CAAC,CAAC,CACD,SAAS,cAAc;CACtB,IAAI;CACJ,aAAa;AACf,CAAC;AAEH,MAAM,SAAoC,EACvC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC,CAChC,SAAS,cAAc;CAAE,IAAI;CAAkB,aAAa;AAA+B,CAAC;;;;;AAM/F,MAAa,iBAAmE,aAAa;CAC3F,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA;AACF,CAAC"}

package/dist/methods/mostra/initialize.d.ts

@@ -0,0 +1,143 @@
+import { SubmissionPolicy } from "../../manifest.js";
+import { SubmitChannel } from "../../view.js";
+import "../../interaction.js";
+import { Diagnostic } from "../../diagnostics/diagnostic.js";
+import { MethodDefinition } from "../../method.js";
+import { Revision } from "../../revision.js";
+import * as z from "zod";
+//#region src/methods/mostra/initialize.d.ts
+/**
+ * A host port name (INTERFACES §7). Port names are open strings on the wire, so an older instance
+ * answers a newer port with a warning instead of refusing the session (D84). `ai` is reserved for
+ * the AI port, which is not part of v1 (D46).
+ */
+export type PortName = "identity" | "submissions" | "drafts" | "reviews" | "addressing" | "trustedControls" | "capture" | "secrets" | "pty" | "ai" | (string & {});
+/** The Zod schema of the `PortName` type. */
+export declare const PortName: z.ZodType<PortName, string>;
+/**
+ * The standalone CLI's client name (D140 item 4). The supervisor marks a home as configured by a
+ * host when any other client sends `home` or `ports`, and the CLI never sends telemetry for such a
+ * home. A host that uses this name as its own is out of scope.
+ */
+export declare const CLI_CLIENT_NAME = "mostra-cli";
+/** The client that opens a connection. */
+export interface ClientInfo {
+  /** The client's name, for logs and status (`mostra-cli`, `jcode`). */
+  readonly name: string;
+  /** The client's own version. */
+  readonly version: string;
+}
+/** What the client can handle (D84). */
+export interface ClientCapabilities {
+  /** Notification methods the client accepts. The instance sends no others. */
+  readonly notifications?: readonly string[];
+}
+/**
+ * Home settings from a spawning host (INTERFACES §6). Each setting arrives with the package that
+ * implements it.
+ */
+export interface HomeConfig {
+  /**
+   * The home the client expects. A check, not a setting (D84): the instance chose and locked its
+   * home at start-up, and refuses the session with `MOSTRA_HOME_MISMATCH` when this names a
+   * different one.
+   */
+  readonly path?: string;
+  /**
+   * The dependency policy (D43, D95), kept in the home's `config.json` for every later client:
+   * `auto` (the default) installs any package an artifact imports; `explicit` installs only what
+   * `deps/add` adds and reports other imports as `MOSTRA_DEP_MISSING`.
+   */
+  readonly dependencies?: DependencyPolicy;
+  /**
+   * The home's submission policy (D102), kept in `config.json`: it applies to every artifact whose
+   * `artifact/publish` names no policy, before the manifest's request.
+   */
+  readonly submission?: SubmissionPolicy;
+  /**
+   * The ports this client always provides, kept in `config.json` under its `client.name` (D105).
+   * Submissions made while it is away wait in the outbox for it; an empty list stops that.
+   */
+  readonly ports?: readonly PortName[];
+  /**
+   * The submit channels the home accepts (D40, D108), kept in `config.json`: `["shell"]` lets only
+   * the shell's trusted Submit and Choose make submissions and choices; absent, both channels are
+   * allowed. A host's `trustedControls` port answers per view instead, when it is connected.
+   */
+  readonly submitChannels?: readonly SubmitChannel[];
+}
+/** How packages enter an artifact's lockfile (D43). */
+export type DependencyPolicy = "auto" | "explicit";
+/** The Zod schema of the `DependencyPolicy` type. */
+export declare const DependencyPolicy: z.ZodType<DependencyPolicy>;
+/** The params of `mostra/initialize` (INTERFACES §6). */
+export interface MostraInitializeParams {
+  /** Who is connecting. */
+  readonly client: ClientInfo;
+  /**
+   * The host protocol revisions the client speaks. The instance picks the newest one it also
+   * supports, or refuses with `MOSTRA_HOST_REVISION_UNSUPPORTED`. Entries that aren't revisions
+   * never match.
+   */
+  readonly revisions: readonly string[];
+  /** What the client can handle. */
+  readonly capabilities: ClientCapabilities;
+  /**
+   * Ports the client implements. The instance calls a port only on the connection that registered
+   * it; ports it doesn't support get a `MOSTRA_HOST_PORT_UNSUPPORTED` warning.
+   */
+  readonly ports: readonly PortName[];
+  /** Home settings and the home check. */
+  readonly home?: HomeConfig;
+}
+/** The instance a client is connected to. */
+export interface InstanceInfo {
+  /** The runtime release (`@mostra/runtime` version). */
+  readonly version: string;
+  /** The home's real path. */
+  readonly home: string;
+  /** The platform as `<os>-<arch>`, for example `darwin-arm64`. */
+  readonly platform: string;
+  /** The supervisor's process ID. */
+  readonly pid: number;
+  /** `host` when spawned over stdio (`mostra-runtime host`), `daemon` when started as a daemon. */
+  readonly mode: "host" | "daemon";
+}
+/** What the instance offers (D84). */
+export interface InstanceCapabilities {
+  /** Every method the instance serves. */
+  readonly methods: readonly string[];
+  /** Every notification the instance may send. */
+  readonly notifications: readonly string[];
+  /** The ports the instance calls when a client registers them. */
+  readonly ports: readonly PortName[];
+}
+/** The result of `mostra/initialize`. */
+export interface MostraInitializeResult {
+  /** The negotiated host protocol revision: the newest both sides support. */
+  readonly revision: Revision;
+  /** The instance the client is connected to. */
+  readonly instance: InstanceInfo;
+  /** What the instance offers. */
+  readonly capabilities: InstanceCapabilities;
+  /** Warnings about the session, such as ports the instance doesn't support. */
+  readonly warnings: readonly Diagnostic[];
+}
+/** The Zod schema of the `ClientInfo` type. */
+export declare const ClientInfo: z.ZodType<ClientInfo>;
+/** The Zod schema of the `ClientCapabilities` type. */
+export declare const ClientCapabilities: z.ZodType<ClientCapabilities>;
+/** The Zod schema of the `HomeConfig` type. */
+export declare const HomeConfig: z.ZodType<HomeConfig>;
+/** The Zod schema of the `InstanceInfo` type. */
+export declare const InstanceInfo: z.ZodType<InstanceInfo>;
+/** The Zod schema of the `InstanceCapabilities` type. */
+export declare const InstanceCapabilities: z.ZodType<InstanceCapabilities>;
+/**
+ * `mostra/initialize`: opens a session. It must be the first request on a connection and is sent
+ * once. It negotiates the protocol revision, registers the client's ports on this connection and
+ * checks the home (D59, D84).
+ */
+export declare const mostraInitializeMethod: MethodDefinition<MostraInitializeParams, MostraInitializeResult>;
+//#endregion
+//# sourceMappingURL=initialize.d.ts.map

package/dist/methods/mostra/initialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialize.d.ts","names":[],"sources":["../../../src/methods/mostra/initialize.ts"],"mappings":";;;;;;;;;;;;;YAaY;;qBAcC,UAAU,EAAE,QAAQ;;;;;;qBAcpB;;iBAGI;;WAEN;;WAEA;;;iBAIM;;WAEN;;;;;;iBAOM;;;;;;WAMN;;;;;;WAMA,eAAe;;;;;WAKf,aAAa;;;;;WAKb,iBAAiB;;;;;;WAMjB,0BAA0B;;;YAIzB;;qBAGC,kBAAkB,EAAE,QAAQ;;iBASxB;;WAEN,QAAQ;;;;;;WAMR;;WAEA,cAAc;;;;;WAKd,gBAAgB;;WAEhB,OAAO;;;iBAID;;WAEN;;WAEA;;WAEA;;WAEA;;WAEA;;;iBAIM;;WAEN;;WAEA;;WAEA,gBAAgB;;;iBAIV;;WAEN,UAAU;;WAEV,UAAU;;WAEV,cAAc;;WAEd,mBAAmB;;;qBAIjB,YAAY,EAAE,QAAQ;;qBAKtB,oBAAoB,EAAE,QAAQ;;qBAQ9B,YAAY,EAAE,QAAQ;;qBAetB,cAAc,EAAE,QAAQ;;qBAcxB,sBAAsB,EAAE,QAAQ;;;;;;qBAmChC,wBAAwB,iBACnC,wBACA"}

package/dist/methods/mostra/initialize.js

@@ -0,0 +1,97 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { SubmissionPolicy } from "../../manifest.js";
+import { Diagnostic } from "../../diagnostics/diagnostic.js";
+import { SubmitChannel } from "../../view.js";
+import { defineMethod } from "../../method.js";
+import { Revision } from "../../revision.js";
+import * as z from "zod";
+//#region src/methods/mostra/initialize.ts
+/** The Zod schema of the `PortName` type. */
+const PortName = z.string().regex(/^[a-z][a-zA-Z0-9]*$/).register(wireRegistry, {
+	id: "PortName",
+	description: "A host port name: identity, submissions, drafts, reviews, addressing, trustedControls, capture, secrets, pty, or ai (reserved). Open for later ports."
+});
+/**
+* The standalone CLI's client name (D140 item 4). The supervisor marks a home as configured by a
+* host when any other client sends `home` or `ports`, and the CLI never sends telemetry for such a
+* home. A host that uses this name as its own is out of scope.
+*/
+const CLI_CLIENT_NAME = "mostra-cli";
+/** The Zod schema of the `DependencyPolicy` type. */
+const DependencyPolicy = z.enum(["auto", "explicit"]).register(wireRegistry, {
+	id: "DependencyPolicy",
+	description: "How packages enter an artifact's lockfile: auto installs what artifacts import; explicit only what deps/add adds (D43)."
+});
+/** The Zod schema of the `ClientInfo` type. */
+const ClientInfo = z.object({
+	name: z.string().min(1),
+	version: z.string()
+}).register(wireRegistry, {
+	id: "ClientInfo",
+	description: "The client that opens a connection."
+});
+/** The Zod schema of the `ClientCapabilities` type. */
+const ClientCapabilities = z.object({ notifications: z.array(z.string()).readonly().exactOptional() }).register(wireRegistry, {
+	id: "ClientCapabilities",
+	description: "What the client can handle: the notification methods it accepts."
+});
+/** The Zod schema of the `HomeConfig` type. */
+const HomeConfig = z.object({
+	path: z.string().min(1).exactOptional(),
+	dependencies: DependencyPolicy.exactOptional(),
+	submission: SubmissionPolicy.exactOptional(),
+	ports: z.array(PortName).max(32).readonly().exactOptional(),
+	submitChannels: z.array(SubmitChannel).min(1).max(2).readonly().exactOptional()
+}).register(wireRegistry, {
+	id: "HomeConfig",
+	description: "Home settings from a spawning host; path is a check against the instance's home (D84), dependencies the dependency policy (D43), submission the home's policy (D102), ports those the host always provides (D105)."
+});
+/** The Zod schema of the `InstanceInfo` type. */
+const InstanceInfo = z.object({
+	version: z.string(),
+	home: z.string(),
+	platform: z.string(),
+	pid: z.int().min(1),
+	mode: z.enum(["host", "daemon"])
+}).register(wireRegistry, {
+	id: "InstanceInfo",
+	description: "The instance a client is connected to."
+});
+/** The Zod schema of the `InstanceCapabilities` type. */
+const InstanceCapabilities = z.object({
+	methods: z.array(z.string()).readonly(),
+	notifications: z.array(z.string()).readonly(),
+	ports: z.array(PortName).readonly()
+}).register(wireRegistry, {
+	id: "InstanceCapabilities",
+	description: "What the instance offers: methods, notifications and supported ports."
+});
+const params = z.object({
+	client: ClientInfo,
+	revisions: z.array(z.string()).readonly(),
+	capabilities: ClientCapabilities,
+	ports: z.array(PortName).readonly(),
+	home: HomeConfig.exactOptional()
+}).register(wireRegistry, { id: "MostraInitializeParams" });
+const result = z.object({
+	revision: Revision.schema,
+	instance: InstanceInfo,
+	capabilities: InstanceCapabilities,
+	warnings: z.array(Diagnostic).readonly()
+}).register(wireRegistry, { id: "MostraInitializeResult" });
+/**
+* `mostra/initialize`: opens a session. It must be the first request on a connection and is sent
+* once. It negotiates the protocol revision, registers the client's ports on this connection and
+* checks the home (D59, D84).
+*/
+const mostraInitializeMethod = defineMethod({
+	method: "mostra/initialize",
+	direction: "client-to-instance",
+	mutating: false,
+	params,
+	result
+});
+//#endregion
+export { CLI_CLIENT_NAME, ClientCapabilities, ClientInfo, DependencyPolicy, HomeConfig, InstanceCapabilities, InstanceInfo, PortName, mostraInitializeMethod };
+
+//# sourceMappingURL=initialize.js.map

package/dist/methods/mostra/initialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialize.js","names":[],"sources":["../../../src/methods/mostra/initialize.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { Diagnostic } from \"../../diagnostics/diagnostic.ts\";\nimport { SubmitChannel } from \"../../interaction.ts\";\nimport { SubmissionPolicy } from \"../../manifest.ts\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { Revision } from \"../../revision.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\n\n/**\n * A host port name (INTERFACES §7). Port names are open strings on the wire, so an older instance\n * answers a newer port with a warning instead of refusing the session (D84). `ai` is reserved for\n * the AI port, which is not part of v1 (D46).\n */\nexport type PortName =\n  | \"identity\"\n  | \"submissions\"\n  | \"drafts\"\n  | \"reviews\"\n  | \"addressing\"\n  | \"trustedControls\"\n  | \"capture\"\n  | \"secrets\"\n  | \"pty\"\n  | \"ai\"\n  | (string & {});\n\n/** The Zod schema of the `PortName` type. */\nexport const PortName: z.ZodType<PortName, string> = z\n  .string()\n  .regex(/^[a-z][a-zA-Z0-9]*$/)\n  .register(wireRegistry, {\n    id: \"PortName\",\n    description:\n      \"A host port name: identity, submissions, drafts, reviews, addressing, trustedControls, capture, secrets, pty, or ai (reserved). Open for later ports.\",\n  });\n\n/**\n * The standalone CLI's client name (D140 item 4). The supervisor marks a home as configured by a\n * host when any other client sends `home` or `ports`, and the CLI never sends telemetry for such a\n * home. A host that uses this name as its own is out of scope.\n */\nexport const CLI_CLIENT_NAME = \"mostra-cli\";\n\n/** The client that opens a connection. */\nexport interface ClientInfo {\n  /** The client's name, for logs and status (`mostra-cli`, `jcode`). */\n  readonly name: string;\n  /** The client's own version. */\n  readonly version: string;\n}\n\n/** What the client can handle (D84). */\nexport interface ClientCapabilities {\n  /** Notification methods the client accepts. The instance sends no others. */\n  readonly notifications?: readonly string[];\n}\n\n/**\n * Home settings from a spawning host (INTERFACES §6). Each setting arrives with the package that\n * implements it.\n */\nexport interface HomeConfig {\n  /**\n   * The home the client expects. A check, not a setting (D84): the instance chose and locked its\n   * home at start-up, and refuses the session with `MOSTRA_HOME_MISMATCH` when this names a\n   * different one.\n   */\n  readonly path?: string;\n  /**\n   * The dependency policy (D43, D95), kept in the home's `config.json` for every later client:\n   * `auto` (the default) installs any package an artifact imports; `explicit` installs only what\n   * `deps/add` adds and reports other imports as `MOSTRA_DEP_MISSING`.\n   */\n  readonly dependencies?: DependencyPolicy;\n  /**\n   * The home's submission policy (D102), kept in `config.json`: it applies to every artifact whose\n   * `artifact/publish` names no policy, before the manifest's request.\n   */\n  readonly submission?: SubmissionPolicy;\n  /**\n   * The ports this client always provides, kept in `config.json` under its `client.name` (D105).\n   * Submissions made while it is away wait in the outbox for it; an empty list stops that.\n   */\n  readonly ports?: readonly PortName[];\n  /**\n   * The submit channels the home accepts (D40, D108), kept in `config.json`: `[\"shell\"]` lets only\n   * the shell's trusted Submit and Choose make submissions and choices; absent, both channels are\n   * allowed. A host's `trustedControls` port answers per view instead, when it is connected.\n   */\n  readonly submitChannels?: readonly SubmitChannel[];\n}\n\n/** How packages enter an artifact's lockfile (D43). */\nexport type DependencyPolicy = \"auto\" | \"explicit\";\n\n/** The Zod schema of the `DependencyPolicy` type. */\nexport const DependencyPolicy: z.ZodType<DependencyPolicy> = z\n  .enum([\"auto\", \"explicit\"])\n  .register(wireRegistry, {\n    id: \"DependencyPolicy\",\n    description:\n      \"How packages enter an artifact's lockfile: auto installs what artifacts import; explicit only what deps/add adds (D43).\",\n  });\n\n/** The params of `mostra/initialize` (INTERFACES §6). */\nexport interface MostraInitializeParams {\n  /** Who is connecting. */\n  readonly client: ClientInfo;\n  /**\n   * The host protocol revisions the client speaks. The instance picks the newest one it also\n   * supports, or refuses with `MOSTRA_HOST_REVISION_UNSUPPORTED`. Entries that aren't revisions\n   * never match.\n   */\n  readonly revisions: readonly string[];\n  /** What the client can handle. */\n  readonly capabilities: ClientCapabilities;\n  /**\n   * Ports the client implements. The instance calls a port only on the connection that registered\n   * it; ports it doesn't support get a `MOSTRA_HOST_PORT_UNSUPPORTED` warning.\n   */\n  readonly ports: readonly PortName[];\n  /** Home settings and the home check. */\n  readonly home?: HomeConfig;\n}\n\n/** The instance a client is connected to. */\nexport interface InstanceInfo {\n  /** The runtime release (`@mostra/runtime` version). */\n  readonly version: string;\n  /** The home's real path. */\n  readonly home: string;\n  /** The platform as `<os>-<arch>`, for example `darwin-arm64`. */\n  readonly platform: string;\n  /** The supervisor's process ID. */\n  readonly pid: number;\n  /** `host` when spawned over stdio (`mostra-runtime host`), `daemon` when started as a daemon. */\n  readonly mode: \"host\" | \"daemon\";\n}\n\n/** What the instance offers (D84). */\nexport interface InstanceCapabilities {\n  /** Every method the instance serves. */\n  readonly methods: readonly string[];\n  /** Every notification the instance may send. */\n  readonly notifications: readonly string[];\n  /** The ports the instance calls when a client registers them. */\n  readonly ports: readonly PortName[];\n}\n\n/** The result of `mostra/initialize`. */\nexport interface MostraInitializeResult {\n  /** The negotiated host protocol revision: the newest both sides support. */\n  readonly revision: Revision;\n  /** The instance the client is connected to. */\n  readonly instance: InstanceInfo;\n  /** What the instance offers. */\n  readonly capabilities: InstanceCapabilities;\n  /** Warnings about the session, such as ports the instance doesn't support. */\n  readonly warnings: readonly Diagnostic[];\n}\n\n/** The Zod schema of the `ClientInfo` type. */\nexport const ClientInfo: z.ZodType<ClientInfo> = z\n  .object({ name: z.string().min(1), version: z.string() })\n  .register(wireRegistry, { id: \"ClientInfo\", description: \"The client that opens a connection.\" });\n\n/** The Zod schema of the `ClientCapabilities` type. */\nexport const ClientCapabilities: z.ZodType<ClientCapabilities> = z\n  .object({ notifications: z.array(z.string()).readonly().exactOptional() })\n  .register(wireRegistry, {\n    id: \"ClientCapabilities\",\n    description: \"What the client can handle: the notification methods it accepts.\",\n  });\n\n/** The Zod schema of the `HomeConfig` type. */\nexport const HomeConfig: z.ZodType<HomeConfig> = z\n  .object({\n    path: z.string().min(1).exactOptional(),\n    dependencies: DependencyPolicy.exactOptional(),\n    submission: SubmissionPolicy.exactOptional(),\n    ports: z.array(PortName).max(32).readonly().exactOptional(),\n    submitChannels: z.array(SubmitChannel).min(1).max(2).readonly().exactOptional(),\n  })\n  .register(wireRegistry, {\n    id: \"HomeConfig\",\n    description:\n      \"Home settings from a spawning host; path is a check against the instance's home (D84), dependencies the dependency policy (D43), submission the home's policy (D102), ports those the host always provides (D105).\",\n  });\n\n/** The Zod schema of the `InstanceInfo` type. */\nexport const InstanceInfo: z.ZodType<InstanceInfo> = z\n  .object({\n    version: z.string(),\n    home: z.string(),\n    platform: z.string(),\n    pid: z.int().min(1),\n    mode: z.enum([\"host\", \"daemon\"]),\n  })\n  .register(wireRegistry, {\n    id: \"InstanceInfo\",\n    description: \"The instance a client is connected to.\",\n  });\n\n/** The Zod schema of the `InstanceCapabilities` type. */\nexport const InstanceCapabilities: z.ZodType<InstanceCapabilities> = z\n  .object({\n    methods: z.array(z.string()).readonly(),\n    notifications: z.array(z.string()).readonly(),\n    ports: z.array(PortName).readonly(),\n  })\n  .register(wireRegistry, {\n    id: \"InstanceCapabilities\",\n    description: \"What the instance offers: methods, notifications and supported ports.\",\n  });\n\nconst params: z.ZodType<MostraInitializeParams> = z\n  .object({\n    client: ClientInfo,\n    revisions: z.array(z.string()).readonly(),\n    capabilities: ClientCapabilities,\n    ports: z.array(PortName).readonly(),\n    home: HomeConfig.exactOptional(),\n  })\n  .register(wireRegistry, { id: \"MostraInitializeParams\" });\n\nconst result: z.ZodType<MostraInitializeResult> = z\n  .object({\n    revision: Revision.schema,\n    instance: InstanceInfo,\n    capabilities: InstanceCapabilities,\n    warnings: z.array(Diagnostic).readonly(),\n  })\n  .register(wireRegistry, { id: \"MostraInitializeResult\" });\n\n/**\n * `mostra/initialize`: opens a session. It must be the first request on a connection and is sent\n * once. It negotiates the protocol revision, registers the client's ports on this connection and\n * checks the home (D59, D84).\n */\nexport const mostraInitializeMethod: MethodDefinition<\n  MostraInitializeParams,\n  MostraInitializeResult\n> = defineMethod({\n  method: \"mostra/initialize\",\n  direction: \"client-to-instance\",\n  mutating: false,\n  params,\n  result,\n});\n"],"mappings":";;;;;;;;;AA2BA,MAAa,WAAwC,EAClD,OAAO,CAAC,CACR,MAAM,qBAAqB,CAAC,CAC5B,SAAS,cAAc;CACtB,IAAI;CACJ,aACE;AACJ,CAAC;;;;;;AAOH,MAAa,kBAAkB;;AAuD/B,MAAa,mBAAgD,EAC1D,KAAK,CAAC,QAAQ,UAAU,CAAC,CAAC,CAC1B,SAAS,cAAc;CACtB,IAAI;CACJ,aACE;AACJ,CAAC;;AA4DH,MAAa,aAAoC,EAC9C,OAAO;CAAE,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CAAG,SAAS,EAAE,OAAO;AAAE,CAAC,CAAC,CACxD,SAAS,cAAc;CAAE,IAAI;CAAc,aAAa;AAAsC,CAAC;;AAGlG,MAAa,qBAAoD,EAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CACzE,SAAS,cAAc;CACtB,IAAI;CACJ,aAAa;AACf,CAAC;;AAGH,MAAa,aAAoC,EAC9C,OAAO;CACN,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc;CACtC,cAAc,iBAAiB,cAAc;CAC7C,YAAY,iBAAiB,cAAc;CAC3C,OAAO,EAAE,MAAM,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,cAAc;CAC1D,gBAAgB,EAAE,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,cAAc;AAChF,CAAC,CAAC,CACD,SAAS,cAAc;CACtB,IAAI;CACJ,aACE;AACJ,CAAC;;AAGH,MAAa,eAAwC,EAClD,OAAO;CACN,SAAS,EAAE,OAAO;CAClB,MAAM,EAAE,OAAO;CACf,UAAU,EAAE,OAAO;CACnB,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC;CAClB,MAAM,EAAE,KAAK,CAAC,QAAQ,QAAQ,CAAC;AACjC,CAAC,CAAC,CACD,SAAS,cAAc;CACtB,IAAI;CACJ,aAAa;AACf,CAAC;;AAGH,MAAa,uBAAwD,EAClE,OAAO;CACN,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS;CACtC,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS;CAC5C,OAAO,EAAE,MAAM,QAAQ,CAAC,CAAC,SAAS;AACpC,CAAC,CAAC,CACD,SAAS,cAAc;CACtB,IAAI;CACJ,aAAa;AACf,CAAC;AAEH,MAAM,SAA4C,EAC/C,OAAO;CACN,QAAQ;CACR,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS;CACxC,cAAc;CACd,OAAO,EAAE,MAAM,QAAQ,CAAC,CAAC,SAAS;CAClC,MAAM,WAAW,cAAc;AACjC,CAAC,CAAC,CACD,SAAS,cAAc,EAAE,IAAI,yBAAyB,CAAC;AAE1D,MAAM,SAA4C,EAC/C,OAAO;CACN,UAAU,SAAS;CACnB,UAAU;CACV,cAAc;CACd,UAAU,EAAE,MAAM,UAAU,CAAC,CAAC,SAAS;AACzC,CAAC,CAAC,CACD,SAAS,cAAc,EAAE,IAAI,yBAAyB,CAAC;;;;;;AAO1D,MAAa,yBAGT,aAAa;CACf,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA;AACF,CAAC"}

package/dist/methods/mostra/shutdown.d.ts

@@ -0,0 +1,14 @@
+import { MethodDefinition } from "../../method.js";
+//#region src/methods/mostra/shutdown.d.ts
+/** The params of `mostra/shutdown` (INTERFACES §6): none. */
+export type MostraShutdownParams = Record<string, never>;
+/** The result of `mostra/shutdown`, sent before the instance stops: empty. */
+export type MostraShutdownResult = Record<string, never>;
+/**
+ * `mostra/shutdown`: stops the instance cleanly. The instance answers first, then finishes its
+ * ledger work, stops its children, removes its socket and `instance.json`, and exits. Available to
+ * the spawning host and to every attached client of a daemon (D87).
+ */
+export declare const mostraShutdownMethod: MethodDefinition<MostraShutdownParams, MostraShutdownResult>;
+//#endregion
+//# sourceMappingURL=shutdown.d.ts.map

package/dist/methods/mostra/shutdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.d.ts","names":[],"sources":["../../../src/methods/mostra/shutdown.ts"],"mappings":";;;YAKY,uBAAuB;;YAGvB,uBAAuB;;;;;;qBAetB,sBAAsB,iBAAiB,sBAAsB"}

package/dist/methods/mostra/shutdown.js

@@ -0,0 +1,22 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { defineMethod } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/mostra/shutdown.ts
+const params = z.object({}).register(wireRegistry, { id: "MostraShutdownParams" });
+const result = z.object({}).register(wireRegistry, { id: "MostraShutdownResult" });
+/**
+* `mostra/shutdown`: stops the instance cleanly. The instance answers first, then finishes its
+* ledger work, stops its children, removes its socket and `instance.json`, and exits. Available to
+* the spawning host and to every attached client of a daemon (D87).
+*/
+const mostraShutdownMethod = defineMethod({
+	method: "mostra/shutdown",
+	direction: "client-to-instance",
+	mutating: false,
+	params,
+	result
+});
+//#endregion
+export { mostraShutdownMethod };
+
+//# sourceMappingURL=shutdown.js.map

package/dist/methods/mostra/shutdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.js","names":[],"sources":["../../../src/methods/mostra/shutdown.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\n\n/** The params of `mostra/shutdown` (INTERFACES §6): none. */\nexport type MostraShutdownParams = Record<string, never>;\n\n/** The result of `mostra/shutdown`, sent before the instance stops: empty. */\nexport type MostraShutdownResult = Record<string, never>;\n\nconst params: z.ZodType<MostraShutdownParams> = z\n  .object({})\n  .register(wireRegistry, { id: \"MostraShutdownParams\" });\n\nconst result: z.ZodType<MostraShutdownResult> = z\n  .object({})\n  .register(wireRegistry, { id: \"MostraShutdownResult\" });\n\n/**\n * `mostra/shutdown`: stops the instance cleanly. The instance answers first, then finishes its\n * ledger work, stops its children, removes its socket and `instance.json`, and exits. Available to\n * the spawning host and to every attached client of a daemon (D87).\n */\nexport const mostraShutdownMethod: MethodDefinition<MostraShutdownParams, MostraShutdownResult> =\n  defineMethod({\n    method: \"mostra/shutdown\",\n    direction: \"client-to-instance\",\n    mutating: false,\n    params,\n    result,\n  });\n"],"mappings":";;;;AAUA,MAAM,SAA0C,EAC7C,OAAO,CAAC,CAAC,CAAC,CACV,SAAS,cAAc,EAAE,IAAI,uBAAuB,CAAC;AAExD,MAAM,SAA0C,EAC7C,OAAO,CAAC,CAAC,CAAC,CACV,SAAS,cAAc,EAAE,IAAI,uBAAuB,CAAC;;;;;;AAOxD,MAAa,uBACX,aAAa;CACX,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA;AACF,CAAC"}

package/dist/methods/port/drafts-mirror.d.ts

@@ -0,0 +1,30 @@
+import { DocumentRevision } from "../../interaction.js";
+import { MethodDefinition } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/port/drafts-mirror.d.ts
+/** A viewer's draft, mirrored to a host as it changes (INTERFACES §7, D105). */
+export interface DraftMirror {
+  /** Always `draft`: a mirror is never a submission (IN-06). */
+  readonly kind: "draft";
+  /** The artifact. */
+  readonly artifactId: string;
+  /** Whose draft it is. */
+  readonly viewerId: string;
+  /** The draft's epoch (D103). */
+  readonly epoch: number;
+  /** The draft's revision; a later mirror has a higher one. */
+  readonly revision: DocumentRevision;
+  /** Every field of the draft by ID. */
+  readonly fields: Readonly<Record<string, unknown>>;
+}
+/** The result of `port/drafts.mirror`. */
+export type DraftsMirrorResult = unknown;
+/** The Zod schema of the `DraftMirror` type. */
+export declare const DraftMirror: z.ZodType<DraftMirror>;
+/**
+ * `port/drafts.mirror`: Mostra sends the latest revision of a viewer's draft to a host that
+ * registered the drafts port, best effort (D105). Mostra's ledger stays canonical (D58).
+ */
+export declare const portDraftsMirrorMethod: MethodDefinition<DraftMirror, DraftsMirrorResult>;
+//#endregion
+//# sourceMappingURL=drafts-mirror.d.ts.map

package/dist/methods/port/drafts-mirror.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drafts-mirror.d.ts","names":[],"sources":["../../../src/methods/port/drafts-mirror.ts"],"mappings":";;;;;iBAOiB;;WAEN;;WAEA;;WAEA;;WAEA;;WAEA,UAAU;;WAEV,QAAQ,SAAS;;;YAIhB;;qBAGC,aAAa,EAAE,QAAQ;;;;;qBAkBvB,wBAAwB,iBAAiB,aAAa"}