@mostra/protocol 0.0.0-placeholder → 0.1.0

package/dist/methods/events/ack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ack.d.ts","names":[],"sources":["../../../src/methods/events/ack.ts"],"mappings":";;;iBAMiB;;WAEN;;WAEA;;WAEA;;;YAIC,kBAAkB;;;;;qBAkBjB,iBAAiB,iBAAiB,iBAAiB"}

package/dist/methods/events/ack.js

@@ -0,0 +1,26 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { Cursor } from "../../ids.js";
+import { defineMethod } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/events/ack.ts
+const params = z.object({
+	subscriptionId: z.string().min(1),
+	cursor: Cursor.schema,
+	requestId: z.string().min(1).exactOptional()
+}).register(wireRegistry, { id: "EventsAckParams" });
+const result = z.object({}).register(wireRegistry, { id: "EventsAckResult" });
+/**
+* `events/ack`: records that a subscriber handled every event up to a cursor. For a named
+* subscription it is durable: the next subscription with that name resumes after it (IN-08).
+*/
+const eventsAckMethod = defineMethod({
+	method: "events/ack",
+	direction: "client-to-instance",
+	mutating: true,
+	params,
+	result
+});
+//#endregion
+export { eventsAckMethod };
+
+//# sourceMappingURL=ack.js.map

package/dist/methods/events/ack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ack.js","names":[],"sources":["../../../src/methods/events/ack.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { Cursor } from \"../../ids.ts\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\n\n/** The params of `events/ack` (INTERFACES §6). */\nexport interface EventsAckParams {\n  /** The subscription, as `events/subscribe` returned it. */\n  readonly subscriptionId: string;\n  /** Every event up to this cursor is handled. An earlier cursor than the last ack changes nothing. */\n  readonly cursor: string;\n  /** Accepted for uniformity (H-03); acknowledging is idempotent by itself. */\n  readonly requestId?: string;\n}\n\n/** The result of `events/ack`. */\nexport type EventsAckResult = Record<string, never>;\n\nconst params: z.ZodType<EventsAckParams> = z\n  .object({\n    subscriptionId: z.string().min(1),\n    cursor: Cursor.schema,\n    requestId: z.string().min(1).exactOptional(),\n  })\n  .register(wireRegistry, { id: \"EventsAckParams\" });\n\nconst result: z.ZodType<EventsAckResult> = z\n  .object({})\n  .register(wireRegistry, { id: \"EventsAckResult\" });\n\n/**\n * `events/ack`: records that a subscriber handled every event up to a cursor. For a named\n * subscription it is durable: the next subscription with that name resumes after it (IN-08).\n */\nexport const eventsAckMethod: MethodDefinition<EventsAckParams, EventsAckResult> = defineMethod({\n  method: \"events/ack\",\n  direction: \"client-to-instance\",\n  mutating: true,\n  params,\n  result,\n});\n"],"mappings":";;;;;AAkBA,MAAM,SAAqC,EACxC,OAAO;CACN,gBAAgB,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CAChC,QAAQ,OAAO;CACf,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc;AAC7C,CAAC,CAAC,CACD,SAAS,cAAc,EAAE,IAAI,kBAAkB,CAAC;AAEnD,MAAM,SAAqC,EACxC,OAAO,CAAC,CAAC,CAAC,CACV,SAAS,cAAc,EAAE,IAAI,kBAAkB,CAAC;;;;;AAMnD,MAAa,kBAAsE,aAAa;CAC9F,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA;AACF,CAAC"}

package/dist/methods/events/read.d.ts

@@ -0,0 +1,40 @@
+import { EventFilter, EventRecord } from "../../interaction.js";
+import { Diagnostic } from "../../diagnostics/diagnostic.js";
+import { MethodDefinition } from "../../method.js";
+//#region src/methods/events/read.d.ts
+/** The most events one `events/read` returns. */
+export declare const EVENTS_READ_MAX = 1e3;
+/** The params of `events/read` (INTERFACES §6). */
+export interface EventsReadParams {
+  /** Which events; absent: every event. */
+  readonly filter?: EventFilter;
+  /** Events after this cursor; absent: from the start. */
+  readonly after?: string;
+  /** At most this many events (default 100, at most 1000), and about 8 MiB. */
+  readonly limit?: number;
+  /**
+   * When `after` lies inside a compacted range, read on through it instead of being refused with
+   * `MOSTRA_HOST_CURSOR_COMPACTED`: the `artifact.compacted` summary arrives in cursor order among
+   * the other events, and `compacted` says that events after `after` were lost (DATA_MODEL §4).
+   */
+  readonly acceptCompacted?: boolean;
+}
+/** The result of `events/read`. */
+export interface EventsReadResult {
+  /** Matching events in cursor order. */
+  readonly events: readonly EventRecord[];
+  /** Where the next read continues: everything up to it was examined. */
+  readonly cursor: string;
+  /**
+   * `MOSTRA_HOST_CURSOR_COMPACTED`, when `acceptCompacted` let the read pass a summary of events
+   * this reader had partly seen: some events after `after` are gone, and `events` holds the summary.
+   */
+  readonly compacted?: Diagnostic;
+}
+/**
+ * `events/read`: reads durable events after a cursor, in order, without gaps (IN-08). Pass the
+ * returned cursor to continue.
+ */
+export declare const eventsReadMethod: MethodDefinition<EventsReadParams, EventsReadResult>;
+//#endregion
+//# sourceMappingURL=read.d.ts.map

package/dist/methods/events/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","names":[],"sources":["../../../src/methods/events/read.ts"],"mappings":";;;;;qBAQa;;iBAGI;;WAEN,SAAS;;WAET;;WAEA;;;;;;WAMA;;;iBAIM;;WAEN,iBAAiB;;WAEjB;;;;;WAKA,YAAY;;;;;;qBAwBV,kBAAkB,iBAAiB,kBAAkB"}

package/dist/methods/events/read.js

@@ -0,0 +1,35 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { Cursor } from "../../ids.js";
+import { Diagnostic } from "../../diagnostics/diagnostic.js";
+import { EventFilter, EventRecord } from "../../interaction.js";
+import { defineMethod } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/events/read.ts
+/** The most events one `events/read` returns. */
+const EVENTS_READ_MAX = 1e3;
+const params = z.object({
+	filter: EventFilter.exactOptional(),
+	after: Cursor.schema.exactOptional(),
+	limit: z.int().min(1).max(EVENTS_READ_MAX).exactOptional(),
+	acceptCompacted: z.boolean().exactOptional()
+}).register(wireRegistry, { id: "EventsReadParams" });
+const result = z.object({
+	events: z.array(EventRecord).readonly(),
+	cursor: Cursor.schema,
+	compacted: Diagnostic.exactOptional()
+}).register(wireRegistry, { id: "EventsReadResult" });
+/**
+* `events/read`: reads durable events after a cursor, in order, without gaps (IN-08). Pass the
+* returned cursor to continue.
+*/
+const eventsReadMethod = defineMethod({
+	method: "events/read",
+	direction: "client-to-instance",
+	mutating: false,
+	params,
+	result
+});
+//#endregion
+export { EVENTS_READ_MAX, eventsReadMethod };
+
+//# sourceMappingURL=read.js.map

package/dist/methods/events/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","names":[],"sources":["../../../src/methods/events/read.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { Diagnostic } from \"../../diagnostics/diagnostic.ts\";\nimport { Cursor } from \"../../ids.ts\";\nimport { EventFilter, EventRecord } from \"../../interaction.ts\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\n\n/** The most events one `events/read` returns. */\nexport const EVENTS_READ_MAX = 1000;\n\n/** The params of `events/read` (INTERFACES §6). */\nexport interface EventsReadParams {\n  /** Which events; absent: every event. */\n  readonly filter?: EventFilter;\n  /** Events after this cursor; absent: from the start. */\n  readonly after?: string;\n  /** At most this many events (default 100, at most 1000), and about 8 MiB. */\n  readonly limit?: number;\n  /**\n   * When `after` lies inside a compacted range, read on through it instead of being refused with\n   * `MOSTRA_HOST_CURSOR_COMPACTED`: the `artifact.compacted` summary arrives in cursor order among\n   * the other events, and `compacted` says that events after `after` were lost (DATA_MODEL §4).\n   */\n  readonly acceptCompacted?: boolean;\n}\n\n/** The result of `events/read`. */\nexport interface EventsReadResult {\n  /** Matching events in cursor order. */\n  readonly events: readonly EventRecord[];\n  /** Where the next read continues: everything up to it was examined. */\n  readonly cursor: string;\n  /**\n   * `MOSTRA_HOST_CURSOR_COMPACTED`, when `acceptCompacted` let the read pass a summary of events\n   * this reader had partly seen: some events after `after` are gone, and `events` holds the summary.\n   */\n  readonly compacted?: Diagnostic;\n}\n\nconst params: z.ZodType<EventsReadParams> = z\n  .object({\n    filter: EventFilter.exactOptional(),\n    after: Cursor.schema.exactOptional(),\n    limit: z.int().min(1).max(EVENTS_READ_MAX).exactOptional(),\n    acceptCompacted: z.boolean().exactOptional(),\n  })\n  .register(wireRegistry, { id: \"EventsReadParams\" });\n\nconst result: z.ZodType<EventsReadResult> = z\n  .object({\n    events: z.array(EventRecord).readonly(),\n    cursor: Cursor.schema,\n    compacted: Diagnostic.exactOptional(),\n  })\n  .register(wireRegistry, { id: \"EventsReadResult\" });\n\n/**\n * `events/read`: reads durable events after a cursor, in order, without gaps (IN-08). Pass the\n * returned cursor to continue.\n */\nexport const eventsReadMethod: MethodDefinition<EventsReadParams, EventsReadResult> = defineMethod({\n  method: \"events/read\",\n  direction: \"client-to-instance\",\n  mutating: false,\n  params,\n  result,\n});\n"],"mappings":";;;;;;;;AAQA,MAAa,kBAAkB;AA+B/B,MAAM,SAAsC,EACzC,OAAO;CACN,QAAQ,YAAY,cAAc;CAClC,OAAO,OAAO,OAAO,cAAc;CACnC,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC,cAAc;CACzD,iBAAiB,EAAE,QAAQ,CAAC,CAAC,cAAc;AAC7C,CAAC,CAAC,CACD,SAAS,cAAc,EAAE,IAAI,mBAAmB,CAAC;AAEpD,MAAM,SAAsC,EACzC,OAAO;CACN,QAAQ,EAAE,MAAM,WAAW,CAAC,CAAC,SAAS;CACtC,QAAQ,OAAO;CACf,WAAW,WAAW,cAAc;AACtC,CAAC,CAAC,CACD,SAAS,cAAc,EAAE,IAAI,mBAAmB,CAAC;;;;;AAMpD,MAAa,mBAAyE,aAAa;CACjG,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA;AACF,CAAC"}

package/dist/methods/events/subscribe.d.ts

@@ -0,0 +1,54 @@
+import { EventFilter, EventRecord } from "../../interaction.js";
+import { Diagnostic } from "../../diagnostics/diagnostic.js";
+import { MethodDefinition } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/events/subscribe.d.ts
+/** The notification that carries a subscription's events. */
+export declare const EVENTS_NOTIFY = "events/notify";
+/** The params of `events/subscribe` (INTERFACES §6). */
+export interface EventsSubscribeParams {
+  /** Which events; absent: every event. */
+  readonly filter?: EventFilter;
+  /**
+   * Deliver events after this cursor. Absent: after the named subscriber's acknowledged cursor
+   * (from the start for a new name), or from now on without a name.
+   */
+  readonly after?: string;
+  /**
+   * A durable subscriber name: `events/ack` keeps its cursor across connections and restarts,
+   * and a later subscription with the same name resumes there.
+   */
+  readonly name?: string;
+}
+/** The result of `events/subscribe`. */
+export interface EventsSubscribeResult {
+  /** The subscription's ID on this connection, for `events/ack` and `events/unsubscribe`. */
+  readonly subscriptionId: string;
+  /** Where delivery starts: events after this cursor follow as `events/notify`. */
+  readonly cursor: string;
+}
+/** The params of the `events/notify` notification. */
+export interface EventsNotifyParams {
+  /** The subscription the events belong to. */
+  readonly subscriptionId: string;
+  /** The next matching events, in cursor order. */
+  readonly events: readonly EventRecord[];
+  /** Everything up to this cursor was examined; acknowledge it once the events are handled. */
+  readonly cursor: string;
+  /**
+   * Set when compaction removed events after this subscription's cursor (DATA_MODEL §4):
+   * `MOSTRA_HOST_CURSOR_COMPACTED`, never a silent gap. `events` then holds the `artifact.compacted`
+   * summary, and the subscription continues after it.
+   */
+  readonly compacted?: Diagnostic;
+}
+/** The Zod schema of the `events/notify` notification's params. */
+export declare const EventsNotifyParams: z.ZodType<EventsNotifyParams>;
+/**
+ * `events/subscribe`: delivers matching events to this connection as `events/notify`
+ * notifications, in cursor order and without gaps (IN-08, H-09). The client must accept
+ * `events/notify` in `mostra/initialize`.
+ */
+export declare const eventsSubscribeMethod: MethodDefinition<EventsSubscribeParams, EventsSubscribeResult>;
+//#endregion
+//# sourceMappingURL=subscribe.d.ts.map

package/dist/methods/events/subscribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribe.d.ts","names":[],"sources":["../../../src/methods/events/subscribe.ts"],"mappings":";;;;;;qBAQa;;iBAGI;;WAEN,SAAS;;;;;WAKT;;;;;WAKA;;;iBAIM;;WAEN;;WAEA;;;iBAIM;;WAEN;;WAEA,iBAAiB;;WAEjB;;;;;;WAMA,YAAY;;;qBAmBV,oBAAoB,EAAE,QAAQ;;;;;;qBAiB9B,uBAAuB,iBAAiB,uBAAuB"}

package/dist/methods/events/subscribe.js

@@ -0,0 +1,44 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { Cursor } from "../../ids.js";
+import { Diagnostic } from "../../diagnostics/diagnostic.js";
+import { EventFilter, EventRecord } from "../../interaction.js";
+import { defineMethod } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/events/subscribe.ts
+/** The notification that carries a subscription's events. */
+const EVENTS_NOTIFY = "events/notify";
+const params = z.object({
+	filter: EventFilter.exactOptional(),
+	after: Cursor.schema.exactOptional(),
+	name: z.string().regex(/^[A-Za-z0-9][A-Za-z0-9._:@-]{0,127}$/).exactOptional()
+}).register(wireRegistry, { id: "EventsSubscribeParams" });
+const result = z.object({
+	subscriptionId: z.string().min(1),
+	cursor: Cursor.schema
+}).register(wireRegistry, { id: "EventsSubscribeResult" });
+/** The Zod schema of the `events/notify` notification's params. */
+const EventsNotifyParams = z.object({
+	subscriptionId: z.string().min(1),
+	events: z.array(EventRecord).readonly(),
+	cursor: Cursor.schema,
+	compacted: Diagnostic.exactOptional()
+}).register(wireRegistry, {
+	id: "EventsNotifyParams",
+	description: "A subscription's next events, in cursor order, and the cursor examined up to."
+});
+/**
+* `events/subscribe`: delivers matching events to this connection as `events/notify`
+* notifications, in cursor order and without gaps (IN-08, H-09). The client must accept
+* `events/notify` in `mostra/initialize`.
+*/
+const eventsSubscribeMethod = defineMethod({
+	method: "events/subscribe",
+	direction: "client-to-instance",
+	mutating: false,
+	params,
+	result
+});
+//#endregion
+export { EVENTS_NOTIFY, EventsNotifyParams, eventsSubscribeMethod };
+
+//# sourceMappingURL=subscribe.js.map

package/dist/methods/events/subscribe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribe.js","names":[],"sources":["../../../src/methods/events/subscribe.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { Diagnostic } from \"../../diagnostics/diagnostic.ts\";\nimport { Cursor } from \"../../ids.ts\";\nimport { EventFilter, EventRecord } from \"../../interaction.ts\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\n\n/** The notification that carries a subscription's events. */\nexport const EVENTS_NOTIFY = \"events/notify\";\n\n/** The params of `events/subscribe` (INTERFACES §6). */\nexport interface EventsSubscribeParams {\n  /** Which events; absent: every event. */\n  readonly filter?: EventFilter;\n  /**\n   * Deliver events after this cursor. Absent: after the named subscriber's acknowledged cursor\n   * (from the start for a new name), or from now on without a name.\n   */\n  readonly after?: string;\n  /**\n   * A durable subscriber name: `events/ack` keeps its cursor across connections and restarts,\n   * and a later subscription with the same name resumes there.\n   */\n  readonly name?: string;\n}\n\n/** The result of `events/subscribe`. */\nexport interface EventsSubscribeResult {\n  /** The subscription's ID on this connection, for `events/ack` and `events/unsubscribe`. */\n  readonly subscriptionId: string;\n  /** Where delivery starts: events after this cursor follow as `events/notify`. */\n  readonly cursor: string;\n}\n\n/** The params of the `events/notify` notification. */\nexport interface EventsNotifyParams {\n  /** The subscription the events belong to. */\n  readonly subscriptionId: string;\n  /** The next matching events, in cursor order. */\n  readonly events: readonly EventRecord[];\n  /** Everything up to this cursor was examined; acknowledge it once the events are handled. */\n  readonly cursor: string;\n  /**\n   * Set when compaction removed events after this subscription's cursor (DATA_MODEL §4):\n   * `MOSTRA_HOST_CURSOR_COMPACTED`, never a silent gap. `events` then holds the `artifact.compacted`\n   * summary, and the subscription continues after it.\n   */\n  readonly compacted?: Diagnostic;\n}\n\nconst params: z.ZodType<EventsSubscribeParams> = z\n  .object({\n    filter: EventFilter.exactOptional(),\n    after: Cursor.schema.exactOptional(),\n    name: z\n      .string()\n      .regex(/^[A-Za-z0-9][A-Za-z0-9._:@-]{0,127}$/)\n      .exactOptional(),\n  })\n  .register(wireRegistry, { id: \"EventsSubscribeParams\" });\n\nconst result: z.ZodType<EventsSubscribeResult> = z\n  .object({ subscriptionId: z.string().min(1), cursor: Cursor.schema })\n  .register(wireRegistry, { id: \"EventsSubscribeResult\" });\n\n/** The Zod schema of the `events/notify` notification's params. */\nexport const EventsNotifyParams: z.ZodType<EventsNotifyParams> = z\n  .object({\n    subscriptionId: z.string().min(1),\n    events: z.array(EventRecord).readonly(),\n    cursor: Cursor.schema,\n    compacted: Diagnostic.exactOptional(),\n  })\n  .register(wireRegistry, {\n    id: \"EventsNotifyParams\",\n    description: \"A subscription's next events, in cursor order, and the cursor examined up to.\",\n  });\n\n/**\n * `events/subscribe`: delivers matching events to this connection as `events/notify`\n * notifications, in cursor order and without gaps (IN-08, H-09). The client must accept\n * `events/notify` in `mostra/initialize`.\n */\nexport const eventsSubscribeMethod: MethodDefinition<EventsSubscribeParams, EventsSubscribeResult> =\n  defineMethod({\n    method: \"events/subscribe\",\n    direction: \"client-to-instance\",\n    mutating: false,\n    params,\n    result,\n  });\n"],"mappings":";;;;;;;;AAQA,MAAa,gBAAgB;AA0C7B,MAAM,SAA2C,EAC9C,OAAO;CACN,QAAQ,YAAY,cAAc;CAClC,OAAO,OAAO,OAAO,cAAc;CACnC,MAAM,EACH,OAAO,CAAC,CACR,MAAM,sCAAsC,CAAC,CAC7C,cAAc;AACnB,CAAC,CAAC,CACD,SAAS,cAAc,EAAE,IAAI,wBAAwB,CAAC;AAEzD,MAAM,SAA2C,EAC9C,OAAO;CAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CAAG,QAAQ,OAAO;AAAO,CAAC,CAAC,CACpE,SAAS,cAAc,EAAE,IAAI,wBAAwB,CAAC;;AAGzD,MAAa,qBAAoD,EAC9D,OAAO;CACN,gBAAgB,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CAChC,QAAQ,EAAE,MAAM,WAAW,CAAC,CAAC,SAAS;CACtC,QAAQ,OAAO;CACf,WAAW,WAAW,cAAc;AACtC,CAAC,CAAC,CACD,SAAS,cAAc;CACtB,IAAI;CACJ,aAAa;AACf,CAAC;;;;;;AAOH,MAAa,wBACX,aAAa;CACX,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA;AACF,CAAC"}

package/dist/methods/events/unsubscribe.d.ts

@@ -0,0 +1,16 @@
+import { MethodDefinition } from "../../method.js";
+//#region src/methods/events/unsubscribe.d.ts
+/** The params of `events/unsubscribe`. */
+export interface EventsUnsubscribeParams {
+  /** The subscription, as `events/subscribe` returned it. */
+  readonly subscriptionId: string;
+}
+/** The result of `events/unsubscribe`. */
+export type EventsUnsubscribeResult = Record<string, never>;
+/**
+ * `events/unsubscribe`: ends a subscription on this connection. A named subscriber's acknowledged
+ * cursor stays.
+ */
+export declare const eventsUnsubscribeMethod: MethodDefinition<EventsUnsubscribeParams, EventsUnsubscribeResult>;
+//#endregion
+//# sourceMappingURL=unsubscribe.d.ts.map

package/dist/methods/events/unsubscribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsubscribe.d.ts","names":[],"sources":["../../../src/methods/events/unsubscribe.ts"],"mappings":";;;iBAKiB;;WAEN;;;YAIC,0BAA0B;;;;;qBAczB,yBAAyB,iBACpC,yBACA"}

package/dist/methods/events/unsubscribe.js

@@ -0,0 +1,21 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { defineMethod } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/events/unsubscribe.ts
+const params = z.object({ subscriptionId: z.string().min(1) }).register(wireRegistry, { id: "EventsUnsubscribeParams" });
+const result = z.object({}).register(wireRegistry, { id: "EventsUnsubscribeResult" });
+/**
+* `events/unsubscribe`: ends a subscription on this connection. A named subscriber's acknowledged
+* cursor stays.
+*/
+const eventsUnsubscribeMethod = defineMethod({
+	method: "events/unsubscribe",
+	direction: "client-to-instance",
+	mutating: false,
+	params,
+	result
+});
+//#endregion
+export { eventsUnsubscribeMethod };
+
+//# sourceMappingURL=unsubscribe.js.map

package/dist/methods/events/unsubscribe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsubscribe.js","names":[],"sources":["../../../src/methods/events/unsubscribe.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 `events/unsubscribe`. */\nexport interface EventsUnsubscribeParams {\n  /** The subscription, as `events/subscribe` returned it. */\n  readonly subscriptionId: string;\n}\n\n/** The result of `events/unsubscribe`. */\nexport type EventsUnsubscribeResult = Record<string, never>;\n\nconst params: z.ZodType<EventsUnsubscribeParams> = z\n  .object({ subscriptionId: z.string().min(1) })\n  .register(wireRegistry, { id: \"EventsUnsubscribeParams\" });\n\nconst result: z.ZodType<EventsUnsubscribeResult> = z\n  .object({})\n  .register(wireRegistry, { id: \"EventsUnsubscribeResult\" });\n\n/**\n * `events/unsubscribe`: ends a subscription on this connection. A named subscriber's acknowledged\n * cursor stays.\n */\nexport const eventsUnsubscribeMethod: MethodDefinition<\n  EventsUnsubscribeParams,\n  EventsUnsubscribeResult\n> = defineMethod({\n  method: \"events/unsubscribe\",\n  direction: \"client-to-instance\",\n  mutating: false,\n  params,\n  result,\n});\n"],"mappings":";;;;AAaA,MAAM,SAA6C,EAChD,OAAO,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAC7C,SAAS,cAAc,EAAE,IAAI,0BAA0B,CAAC;AAE3D,MAAM,SAA6C,EAChD,OAAO,CAAC,CAAC,CAAC,CACV,SAAS,cAAc,EAAE,IAAI,0BAA0B,CAAC;;;;;AAM3D,MAAa,0BAGT,aAAa;CACf,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA;AACF,CAAC"}

package/dist/methods/gc/run.d.ts

@@ -0,0 +1,76 @@
+import { Diagnostic } from "../../diagnostics/diagnostic.js";
+import { MethodDefinition } from "../../method.js";
+//#region src/methods/gc/run.d.ts
+/** Event compaction, which `gc/run` does only when asked (D47, DATA_MODEL §4). */
+export interface GcCompactEvents {
+  /** Compact every artifact's events before this cursor. */
+  readonly before: string;
+}
+/** The params of `gc/run` (INTERFACES §6, D140 item 18). */
+export interface GcRunParams {
+  /** List what a run would remove, and remove nothing. */
+  readonly dryRun?: boolean;
+  /** Also compact events before a cursor (`mostra gc --compact-events --before <cursor>`). */
+  readonly compactEvents?: GcCompactEvents;
+}
+/** One version gc collects, or would: its files go, its row, ID and number stay (D140). */
+export interface GcVersion {
+  /** Its artifact. */
+  readonly artifactId: string;
+  /** Its ID, which stays in the ledger. */
+  readonly versionId: string;
+  /** Its number, which stays too. */
+  readonly number: number;
+  /** The bytes its directory holds. */
+  readonly bytes: number;
+}
+/** What one kind of collection reclaims. */
+export interface GcCount {
+  /** How many items. */
+  readonly count: number;
+  /** How many bytes. */
+  readonly bytes: number;
+}
+/** What event compaction did, per artifact. */
+export interface GcCompacted {
+  /** The artifacts whose events were compacted, with how many events each lost. */
+  readonly artifacts: readonly {
+    readonly artifactId: string;
+    readonly removed: number;
+  }[];
+  /** Every event removed. */
+  readonly removed: number;
+}
+/** The result of `gc/run`: what it removed, or with `dryRun` what it would remove. */
+export interface GcRunResult {
+  /** Whether this was a dry run: then nothing was removed. */
+  readonly dryRun: boolean;
+  /** The unreferenced versions whose files go. */
+  readonly versions: readonly GcVersion[];
+  /** Source snapshots no kept version uses. */
+  readonly snapshots: GcCount;
+  /** Lock layouts in `deps/locks` no working lockfile and no kept version names (D95, D135). */
+  readonly lockLayouts: GcCount;
+  /** Packages `pnpm store prune` removes from the shared store. */
+  readonly storePackages: GcCount;
+  /** Build caches past the 5 GB cap, and verify's files no cached verdict names. */
+  readonly caches: GcCount;
+  /** Every byte reclaimed. */
+  readonly bytes: number;
+  /** Present when `compactEvents` was given. */
+  readonly compacted?: GcCompacted;
+  /**
+   * A step that couldn't finish (`MOSTRA_HOME_GC_INCOMPLETE`): it left its files in place, and
+   * the counts above say what this run did remove. Absent when every step finished.
+   */
+  readonly warnings?: readonly Diagnostic[];
+}
+/**
+ * `gc/run`: collects what nothing references (VR-06, D47, D140): versions' files (each keeps its
+ * ledger row as a tombstone), unused source snapshots, lock layouts, the shared store's unused
+ * packages and caches; with `compactEvents`, it also compacts events before a cursor. A dry run
+ * lists exactly what a real run removes. It runs one at a time with publish, verify and installs.
+ */
+export declare const gcRunMethod: MethodDefinition<GcRunParams, GcRunResult>;
+//#endregion
+//# sourceMappingURL=run.d.ts.map

package/dist/methods/gc/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","names":[],"sources":["../../../src/methods/gc/run.ts"],"mappings":";;;;iBAOiB;;WAEN;;;iBAIM;;WAEN;;WAEA,gBAAgB;;;iBAIV;;WAEN;;WAEA;;WAEA;;WAEA;;;iBAIM;;WAEN;;WAEA;;;iBAIM;;WAEN;aAA+B;aAA6B;;;WAE5D;;;iBAIM;;WAEN;;WAEA,mBAAmB;;WAEnB,WAAW;;WAEX,aAAa;;WAEb,eAAe;;WAEf,QAAQ;;WAER;;WAEA,YAAY;;;;;WAKZ,oBAAoB;;;;;;;;qBAgDlB,aAAa,iBAAiB,aAAa"}

package/dist/methods/gc/run.js

@@ -0,0 +1,56 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { ArtifactId, VersionId } from "../../ids.js";
+import { Diagnostic } from "../../diagnostics/diagnostic.js";
+import { defineMethod } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/gc/run.ts
+const count = z.object({
+	count: z.int().min(0),
+	bytes: z.int().min(0)
+});
+const params = z.object({
+	dryRun: z.boolean().exactOptional(),
+	compactEvents: z.object({ before: z.string().regex(/^[0-9]+$/) }).exactOptional()
+}).register(wireRegistry, { id: "GcRunParams" });
+const result = z.object({
+	dryRun: z.boolean(),
+	versions: z.array(z.object({
+		artifactId: ArtifactId.schema,
+		versionId: VersionId.schema,
+		number: z.int().min(1),
+		bytes: z.int().min(0)
+	})).readonly(),
+	snapshots: count,
+	lockLayouts: count,
+	storePackages: count,
+	caches: count,
+	bytes: z.int().min(0),
+	compacted: z.object({
+		artifacts: z.array(z.object({
+			artifactId: ArtifactId.schema,
+			removed: z.int().min(0)
+		})).readonly(),
+		removed: z.int().min(0)
+	}).exactOptional(),
+	warnings: z.array(Diagnostic).readonly().exactOptional()
+}).register(wireRegistry, {
+	id: "GcRunResult",
+	description: "What gc reclaimed."
+});
+/**
+* `gc/run`: collects what nothing references (VR-06, D47, D140): versions' files (each keeps its
+* ledger row as a tombstone), unused source snapshots, lock layouts, the shared store's unused
+* packages and caches; with `compactEvents`, it also compacts events before a cursor. A dry run
+* lists exactly what a real run removes. It runs one at a time with publish, verify and installs.
+*/
+const gcRunMethod = defineMethod({
+	method: "gc/run",
+	direction: "client-to-instance",
+	mutating: true,
+	params,
+	result
+});
+//#endregion
+export { gcRunMethod };
+
+//# sourceMappingURL=run.js.map

package/dist/methods/gc/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","names":[],"sources":["../../../src/methods/gc/run.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { Diagnostic } from \"../../diagnostics/diagnostic.ts\";\nimport { ArtifactId, VersionId } from \"../../ids.ts\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\n\n/** Event compaction, which `gc/run` does only when asked (D47, DATA_MODEL §4). */\nexport interface GcCompactEvents {\n  /** Compact every artifact's events before this cursor. */\n  readonly before: string;\n}\n\n/** The params of `gc/run` (INTERFACES §6, D140 item 18). */\nexport interface GcRunParams {\n  /** List what a run would remove, and remove nothing. */\n  readonly dryRun?: boolean;\n  /** Also compact events before a cursor (`mostra gc --compact-events --before <cursor>`). */\n  readonly compactEvents?: GcCompactEvents;\n}\n\n/** One version gc collects, or would: its files go, its row, ID and number stay (D140). */\nexport interface GcVersion {\n  /** Its artifact. */\n  readonly artifactId: string;\n  /** Its ID, which stays in the ledger. */\n  readonly versionId: string;\n  /** Its number, which stays too. */\n  readonly number: number;\n  /** The bytes its directory holds. */\n  readonly bytes: number;\n}\n\n/** What one kind of collection reclaims. */\nexport interface GcCount {\n  /** How many items. */\n  readonly count: number;\n  /** How many bytes. */\n  readonly bytes: number;\n}\n\n/** What event compaction did, per artifact. */\nexport interface GcCompacted {\n  /** The artifacts whose events were compacted, with how many events each lost. */\n  readonly artifacts: readonly { readonly artifactId: string; readonly removed: number }[];\n  /** Every event removed. */\n  readonly removed: number;\n}\n\n/** The result of `gc/run`: what it removed, or with `dryRun` what it would remove. */\nexport interface GcRunResult {\n  /** Whether this was a dry run: then nothing was removed. */\n  readonly dryRun: boolean;\n  /** The unreferenced versions whose files go. */\n  readonly versions: readonly GcVersion[];\n  /** Source snapshots no kept version uses. */\n  readonly snapshots: GcCount;\n  /** Lock layouts in `deps/locks` no working lockfile and no kept version names (D95, D135). */\n  readonly lockLayouts: GcCount;\n  /** Packages `pnpm store prune` removes from the shared store. */\n  readonly storePackages: GcCount;\n  /** Build caches past the 5 GB cap, and verify's files no cached verdict names. */\n  readonly caches: GcCount;\n  /** Every byte reclaimed. */\n  readonly bytes: number;\n  /** Present when `compactEvents` was given. */\n  readonly compacted?: GcCompacted;\n  /**\n   * A step that couldn't finish (`MOSTRA_HOME_GC_INCOMPLETE`): it left its files in place, and\n   * the counts above say what this run did remove. Absent when every step finished.\n   */\n  readonly warnings?: readonly Diagnostic[];\n}\n\nconst count = z.object({ count: z.int().min(0), bytes: z.int().min(0) });\n\nconst params: z.ZodType<GcRunParams> = z\n  .object({\n    dryRun: z.boolean().exactOptional(),\n    compactEvents: z.object({ before: z.string().regex(/^[0-9]+$/) }).exactOptional(),\n  })\n  .register(wireRegistry, { id: \"GcRunParams\" });\n\nconst result: z.ZodType<GcRunResult> = z\n  .object({\n    dryRun: z.boolean(),\n    versions: z\n      .array(\n        z.object({\n          artifactId: ArtifactId.schema,\n          versionId: VersionId.schema,\n          number: z.int().min(1),\n          bytes: z.int().min(0),\n        }),\n      )\n      .readonly(),\n    snapshots: count,\n    lockLayouts: count,\n    storePackages: count,\n    caches: count,\n    bytes: z.int().min(0),\n    compacted: z\n      .object({\n        artifacts: z\n          .array(z.object({ artifactId: ArtifactId.schema, removed: z.int().min(0) }))\n          .readonly(),\n        removed: z.int().min(0),\n      })\n      .exactOptional(),\n    warnings: z.array(Diagnostic).readonly().exactOptional(),\n  })\n  .register(wireRegistry, { id: \"GcRunResult\", description: \"What gc reclaimed.\" });\n\n/**\n * `gc/run`: collects what nothing references (VR-06, D47, D140): versions' files (each keeps its\n * ledger row as a tombstone), unused source snapshots, lock layouts, the shared store's unused\n * packages and caches; with `compactEvents`, it also compacts events before a cursor. A dry run\n * lists exactly what a real run removes. It runs one at a time with publish, verify and installs.\n */\nexport const gcRunMethod: MethodDefinition<GcRunParams, GcRunResult> = defineMethod({\n  method: \"gc/run\",\n  direction: \"client-to-instance\",\n  mutating: true,\n  params,\n  result,\n});\n"],"mappings":";;;;;;AAyEA,MAAM,QAAQ,EAAE,OAAO;CAAE,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC;CAAG,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC;AAAE,CAAC;AAEvE,MAAM,SAAiC,EACpC,OAAO;CACN,QAAQ,EAAE,QAAQ,CAAC,CAAC,cAAc;CAClC,eAAe,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,MAAM,UAAU,EAAE,CAAC,CAAC,CAAC,cAAc;AAClF,CAAC,CAAC,CACD,SAAS,cAAc,EAAE,IAAI,cAAc,CAAC;AAE/C,MAAM,SAAiC,EACpC,OAAO;CACN,QAAQ,EAAE,QAAQ;CAClB,UAAU,EACP,MACC,EAAE,OAAO;EACP,YAAY,WAAW;EACvB,WAAW,UAAU;EACrB,QAAQ,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC;EACrB,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC;CACtB,CAAC,CACH,CAAC,CACA,SAAS;CACZ,WAAW;CACX,aAAa;CACb,eAAe;CACf,QAAQ;CACR,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC;CACpB,WAAW,EACR,OAAO;EACN,WAAW,EACR,MAAM,EAAE,OAAO;GAAE,YAAY,WAAW;GAAQ,SAAS,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC;EAAE,CAAC,CAAC,CAAC,CAC3E,SAAS;EACZ,SAAS,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC;CACxB,CAAC,CAAC,CACD,cAAc;CACjB,UAAU,EAAE,MAAM,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,cAAc;AACzD,CAAC,CAAC,CACD,SAAS,cAAc;CAAE,IAAI;CAAe,aAAa;AAAqB,CAAC;;;;;;;AAQlF,MAAa,cAA0D,aAAa;CAClF,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA;AACF,CAAC"}

package/dist/methods/index.d.ts

@@ -0,0 +1,6 @@
+import { AnyMethod } from "../method.js";
+//#region src/methods/index.d.ts
+/** Every host protocol method, in the order they were added. */
+export declare const hostMethods: readonly AnyMethod[];
+//#endregion
+//# sourceMappingURL=index.d.ts.map

package/dist/methods/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/methods/index.ts"],"mappings":";;;qBA2Ca,sBAAsB"}

package/dist/methods/index.js

@@ -0,0 +1,78 @@
+import { artifactCreateMethod } from "./artifact/create.js";
+import { artifactGetMethod } from "./artifact/get.js";
+import { artifactListMethod } from "./artifact/list.js";
+import { artifactPublishMethod } from "./artifact/publish.js";
+import { artifactVerifyMethod } from "./artifact/verify.js";
+import { depsAddMethod } from "./deps/add.js";
+import { devStartMethod } from "./dev/start.js";
+import { devStopMethod } from "./dev/stop.js";
+import { eventsAckMethod } from "./events/ack.js";
+import { eventsReadMethod } from "./events/read.js";
+import { eventsSubscribeMethod } from "./events/subscribe.js";
+import { eventsUnsubscribeMethod } from "./events/unsubscribe.js";
+import { gcRunMethod } from "./gc/run.js";
+import { instanceCheckMethod } from "./instance/check.js";
+import { mostraInitializeMethod } from "./mostra/initialize.js";
+import { instanceStatusMethod } from "./instance/status.js";
+import { livePushMethod } from "./live/push.js";
+import { mostraShutdownMethod } from "./mostra/shutdown.js";
+import { portDraftsMirrorMethod } from "./port/drafts-mirror.js";
+import { portSecretsGetMethod } from "./port/secrets-get.js";
+import { portSubmissionsDeliverMethod } from "./port/submissions-deliver.js";
+import { portTrustedControlsActivatedMethod } from "./port/trusted-controls-activated.js";
+import { portTrustedControlsPolicyMethod } from "./port/trusted-controls-policy.js";
+import { resultsGetMethod } from "./results/get.js";
+import { secretDeleteMethod } from "./secret/delete.js";
+import { secretSetMethod } from "./secret/set.js";
+import { secretListMethod } from "./secret/list.js";
+import { stateGetMethod } from "./state/get.js";
+import { statePatchMethod } from "./state/patch.js";
+import { viewUrlMethod } from "./view/url.js";
+import { viewDefaultMethod } from "./view/default.js";
+import { viewLaunchMethod } from "./view/launch.js";
+import { viewRevokeMethod } from "./view/revoke.js";
+import { viewRotateMethod } from "./view/rotate.js";
+import { waitMethod } from "./wait/wait.js";
+//#region src/methods/index.ts
+/** Every host protocol method, in the order they were added. */
+const hostMethods = [
+	mostraInitializeMethod,
+	mostraShutdownMethod,
+	instanceStatusMethod,
+	artifactCreateMethod,
+	artifactPublishMethod,
+	artifactListMethod,
+	artifactGetMethod,
+	depsAddMethod,
+	viewUrlMethod,
+	viewRevokeMethod,
+	viewRotateMethod,
+	stateGetMethod,
+	resultsGetMethod,
+	waitMethod,
+	eventsReadMethod,
+	eventsSubscribeMethod,
+	eventsUnsubscribeMethod,
+	statePatchMethod,
+	eventsAckMethod,
+	portSubmissionsDeliverMethod,
+	portDraftsMirrorMethod,
+	portTrustedControlsPolicyMethod,
+	portTrustedControlsActivatedMethod,
+	secretSetMethod,
+	secretListMethod,
+	secretDeleteMethod,
+	livePushMethod,
+	portSecretsGetMethod,
+	artifactVerifyMethod,
+	viewDefaultMethod,
+	viewLaunchMethod,
+	gcRunMethod,
+	instanceCheckMethod,
+	devStartMethod,
+	devStopMethod
+];
+//#endregion
+export { hostMethods };
+
+//# sourceMappingURL=index.js.map

package/dist/methods/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/methods/index.ts"],"sourcesContent":["/**\n * Every host protocol method this package defines. `pnpm gen protocol-method` adds entries at the\n * markers; the method itself lives in its own module under `methods/<group>/`.\n */\nimport type { AnyMethod } from \"../method.ts\";\nimport { artifactCreateMethod } from \"./artifact/create.ts\";\nimport { artifactGetMethod } from \"./artifact/get.ts\";\nimport { artifactListMethod } from \"./artifact/list.ts\";\nimport { artifactPublishMethod } from \"./artifact/publish.ts\";\nimport { artifactVerifyMethod } from \"./artifact/verify.ts\";\nimport { depsAddMethod } from \"./deps/add.ts\";\nimport { devStartMethod } from \"./dev/start.ts\";\nimport { devStopMethod } from \"./dev/stop.ts\";\nimport { eventsAckMethod } from \"./events/ack.ts\";\nimport { eventsReadMethod } from \"./events/read.ts\";\nimport { eventsSubscribeMethod } from \"./events/subscribe.ts\";\nimport { eventsUnsubscribeMethod } from \"./events/unsubscribe.ts\";\nimport { gcRunMethod } from \"./gc/run.ts\";\nimport { instanceCheckMethod } from \"./instance/check.ts\";\nimport { instanceStatusMethod } from \"./instance/status.ts\";\nimport { livePushMethod } from \"./live/push.ts\";\nimport { mostraInitializeMethod } from \"./mostra/initialize.ts\";\nimport { mostraShutdownMethod } from \"./mostra/shutdown.ts\";\nimport { portDraftsMirrorMethod } from \"./port/drafts-mirror.ts\";\nimport { portSecretsGetMethod } from \"./port/secrets-get.ts\";\nimport { portSubmissionsDeliverMethod } from \"./port/submissions-deliver.ts\";\nimport { portTrustedControlsActivatedMethod } from \"./port/trusted-controls-activated.ts\";\nimport { portTrustedControlsPolicyMethod } from \"./port/trusted-controls-policy.ts\";\nimport { resultsGetMethod } from \"./results/get.ts\";\nimport { secretDeleteMethod } from \"./secret/delete.ts\";\nimport { secretListMethod } from \"./secret/list.ts\";\nimport { secretSetMethod } from \"./secret/set.ts\";\nimport { stateGetMethod } from \"./state/get.ts\";\nimport { statePatchMethod } from \"./state/patch.ts\";\nimport { viewDefaultMethod } from \"./view/default.ts\";\nimport { viewLaunchMethod } from \"./view/launch.ts\";\nimport { viewRevokeMethod } from \"./view/revoke.ts\";\nimport { viewRotateMethod } from \"./view/rotate.ts\";\nimport { viewUrlMethod } from \"./view/url.ts\";\nimport { waitMethod } from \"./wait/wait.ts\";\n// gen:method-imports\n\n/** Every host protocol method, in the order they were added. */\nexport const hostMethods: readonly AnyMethod[] = [\n  mostraInitializeMethod,\n  mostraShutdownMethod,\n  instanceStatusMethod,\n  artifactCreateMethod,\n  artifactPublishMethod,\n  artifactListMethod,\n  artifactGetMethod,\n  depsAddMethod,\n  viewUrlMethod,\n  viewRevokeMethod,\n  viewRotateMethod,\n  stateGetMethod,\n  resultsGetMethod,\n  waitMethod,\n  eventsReadMethod,\n  eventsSubscribeMethod,\n  eventsUnsubscribeMethod,\n  statePatchMethod,\n  eventsAckMethod,\n  portSubmissionsDeliverMethod,\n  portDraftsMirrorMethod,\n  portTrustedControlsPolicyMethod,\n  portTrustedControlsActivatedMethod,\n  secretSetMethod,\n  secretListMethod,\n  secretDeleteMethod,\n  livePushMethod,\n  portSecretsGetMethod,\n  artifactVerifyMethod,\n  viewDefaultMethod,\n  viewLaunchMethod,\n  gcRunMethod,\n  instanceCheckMethod,\n  devStartMethod,\n  devStopMethod,\n  // gen:methods\n];\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2CA,MAAa,cAAoC;CAC/C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AAEF"}

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

@@ -0,0 +1,30 @@
+import { Diagnostic } from "../../diagnostics/diagnostic.js";
+import { MethodDefinition } from "../../method.js";
+//#region src/methods/instance/check.d.ts
+/** The params of `instance/check` (INTERFACES §6, D140 item 18). */
+export interface InstanceCheckParams {
+  /** Also hash every version directory against its `outputDigest` (`mostra doctor --deep`). */
+  readonly deep?: boolean;
+}
+/** One check's outcome. */
+export interface InstanceCheck {
+  /** What was checked: `ledger`, `versions`, `ports`, `browser`, `shell`, `warm` and so on. */
+  readonly name: string;
+  /** `ok`, or how serious what it found is. */
+  readonly status: "ok" | "warning" | "error";
+  /** What is wrong and what to do, for a warning or an error. */
+  readonly diagnostic?: Diagnostic;
+}
+/** The result of `instance/check`. */
+export interface InstanceCheckResult {
+  /** Every check, in the order it ran. */
+  readonly checks: readonly InstanceCheck[];
+}
+/**
+ * `instance/check`: the checks only the supervisor can run, because it holds the ledger's lock
+ * (D81): the ledger's integrity, the version store, leased ports another program holds, and the
+ * runtime's browser, shell and warm set. `mostra doctor` adds the checks a client runs itself.
+ */
+export declare const instanceCheckMethod: MethodDefinition<InstanceCheckParams, InstanceCheckResult>;
+//#endregion
+//# sourceMappingURL=check.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","names":[],"sources":["../../../src/methods/instance/check.ts"],"mappings":";;;;iBAMiB;;WAEN;;;iBAIM;;WAEN;;WAEA;;WAEA,aAAa;;;iBAIP;;WAEN,iBAAiB;;;;;;;qBA6Bf,qBAAqB,iBAAiB,qBAAqB"}

package/dist/methods/instance/check.js

@@ -0,0 +1,34 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { Diagnostic } from "../../diagnostics/diagnostic.js";
+import { defineMethod } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/instance/check.ts
+const params = z.object({ deep: z.boolean().exactOptional() }).register(wireRegistry, { id: "InstanceCheckParams" });
+const result = z.object({ checks: z.array(z.object({
+	name: z.string().min(1),
+	status: z.enum([
+		"ok",
+		"warning",
+		"error"
+	]),
+	diagnostic: Diagnostic.exactOptional()
+})).readonly() }).register(wireRegistry, {
+	id: "InstanceCheckResult",
+	description: "The supervisor's own checks of its home."
+});
+/**
+* `instance/check`: the checks only the supervisor can run, because it holds the ledger's lock
+* (D81): the ledger's integrity, the version store, leased ports another program holds, and the
+* runtime's browser, shell and warm set. `mostra doctor` adds the checks a client runs itself.
+*/
+const instanceCheckMethod = defineMethod({
+	method: "instance/check",
+	direction: "client-to-instance",
+	mutating: false,
+	params,
+	result
+});
+//#endregion
+export { instanceCheckMethod };
+
+//# sourceMappingURL=check.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","names":[],"sources":["../../../src/methods/instance/check.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { Diagnostic } from \"../../diagnostics/diagnostic.ts\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\n\n/** The params of `instance/check` (INTERFACES §6, D140 item 18). */\nexport interface InstanceCheckParams {\n  /** Also hash every version directory against its `outputDigest` (`mostra doctor --deep`). */\n  readonly deep?: boolean;\n}\n\n/** One check's outcome. */\nexport interface InstanceCheck {\n  /** What was checked: `ledger`, `versions`, `ports`, `browser`, `shell`, `warm` and so on. */\n  readonly name: string;\n  /** `ok`, or how serious what it found is. */\n  readonly status: \"ok\" | \"warning\" | \"error\";\n  /** What is wrong and what to do, for a warning or an error. */\n  readonly diagnostic?: Diagnostic;\n}\n\n/** The result of `instance/check`. */\nexport interface InstanceCheckResult {\n  /** Every check, in the order it ran. */\n  readonly checks: readonly InstanceCheck[];\n}\n\nconst params: z.ZodType<InstanceCheckParams> = z\n  .object({ deep: z.boolean().exactOptional() })\n  .register(wireRegistry, { id: \"InstanceCheckParams\" });\n\nconst result: z.ZodType<InstanceCheckResult> = z\n  .object({\n    checks: z\n      .array(\n        z.object({\n          name: z.string().min(1),\n          status: z.enum([\"ok\", \"warning\", \"error\"]),\n          diagnostic: Diagnostic.exactOptional(),\n        }),\n      )\n      .readonly(),\n  })\n  .register(wireRegistry, {\n    id: \"InstanceCheckResult\",\n    description: \"The supervisor's own checks of its home.\",\n  });\n\n/**\n * `instance/check`: the checks only the supervisor can run, because it holds the ledger's lock\n * (D81): the ledger's integrity, the version store, leased ports another program holds, and the\n * runtime's browser, shell and warm set. `mostra doctor` adds the checks a client runs itself.\n */\nexport const instanceCheckMethod: MethodDefinition<InstanceCheckParams, InstanceCheckResult> =\n  defineMethod({\n    method: \"instance/check\",\n    direction: \"client-to-instance\",\n    mutating: false,\n    params,\n    result,\n  });\n"],"mappings":";;;;;AA2BA,MAAM,SAAyC,EAC5C,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAC7C,SAAS,cAAc,EAAE,IAAI,sBAAsB,CAAC;AAEvD,MAAM,SAAyC,EAC5C,OAAO,EACN,QAAQ,EACL,MACC,EAAE,OAAO;CACP,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CACtB,QAAQ,EAAE,KAAK;EAAC;EAAM;EAAW;CAAO,CAAC;CACzC,YAAY,WAAW,cAAc;AACvC,CAAC,CACH,CAAC,CACA,SAAS,EACd,CAAC,CAAC,CACD,SAAS,cAAc;CACtB,IAAI;CACJ,aAAa;AACf,CAAC;;;;;;AAOH,MAAa,sBACX,aAAa;CACX,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA;AACF,CAAC"}