@mostra/protocol 0.0.0-stage → 0.1.0

package/dist/method.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"method.js","names":[],"sources":["../src/method.ts"],"sourcesContent":["/**\n * Host protocol methods (INTERFACES §6, D59): JSON-RPC 2.0 methods between clients and an\n * instance, each defined once with Zod schemas for its params and result. `pnpm gen\n * protocol-method <group>/<name>` adds one in the right shape; the method modules live in\n * `methods/` and are listed in `methods/index.ts`.\n */\nimport type * as z from \"zod\";\n\n/** Who sends the request: a client to the instance, or the instance to a registering host (ports). */\nexport type MethodDirection = \"client-to-instance\" | \"instance-to-host\";\n\n/** One protocol method. */\nexport interface MethodDefinition<Params, Result> {\n  /** The JSON-RPC method name: `group/name` (`artifact/publish`) or a bare name (`wait`). */\n  readonly method: string;\n  /** Who sends the request. */\n  readonly direction: MethodDirection;\n  /**\n   * Whether the method changes durable state. Mutating methods take an optional `requestId`, and a\n   * retry with the same ID returns the recorded result (H-03).\n   */\n  readonly mutating: boolean;\n  /** The schema of the request's `params`. */\n  readonly params: z.ZodType<Params>;\n  /** The schema of a successful response's `result`. */\n  readonly result: z.ZodType<Result>;\n}\n\n/** A method of any params and result type. */\nexport type AnyMethod = MethodDefinition<unknown, unknown>;\n\n/** Defines a protocol method, checking its name has the `group/name` (or bare `name`) form. */\nexport function defineMethod<Params, Result>(\n  definition: MethodDefinition<Params, Result>,\n): MethodDefinition<Params, Result> {\n  if (!/^([a-z][a-zA-Z]*\\/)?[a-z][a-zA-Z.]*$/.test(definition.method)) {\n    throw new Error(\n      `Protocol method names have the form group/name or name, got \"${definition.method}\".`,\n    );\n  }\n  return definition;\n}\n"],"mappings":";;AAgCA,SAAgB,aACd,YACkC;CAClC,IAAI,CAAC,uCAAuC,KAAK,WAAW,MAAM,GAChE,MAAM,IAAI,MACR,gEAAgE,WAAW,OAAO,GACpF;CAEF,OAAO;AACT"}

package/dist/methods/artifact/create.d.ts

@@ -0,0 +1,29 @@
+import { MethodDefinition } from "../../method.js";
+//#region src/methods/artifact/create.d.ts
+/** The params of `artifact/create` (INTERFACES §6). */
+export interface ArtifactCreateParams {
+  /** The new artifact's directory, absolute. It must not exist yet, or be empty. */
+  readonly dir: string;
+  /** A template to start from. Templates arrive with `mostra new` (WP-26); none is the default. */
+  readonly template?: string;
+  /** The artifact's title. Default: the directory's name. */
+  readonly title?: string;
+  /** Makes retries idempotent: a repeated `requestId` returns the recorded result (H-03). */
+  readonly requestId?: string;
+}
+/** The result of `artifact/create`. */
+export interface ArtifactCreateResult {
+  /** The generated artifact ID, written into the entry's manifest. */
+  readonly artifactId: string;
+  /** The artifact's directory (its real path). */
+  readonly dir: string;
+  /** The files written, relative to `dir`. */
+  readonly files: readonly string[];
+}
+/**
+ * `artifact/create`: writes a new artifact's entry, with a generated artifact ID in its manifest, into
+ * an empty directory. The artifact appears in `artifact/list` once it is published.
+ */
+export declare const artifactCreateMethod: MethodDefinition<ArtifactCreateParams, ArtifactCreateResult>;
+//#endregion
+//# sourceMappingURL=create.d.ts.map

package/dist/methods/artifact/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","names":[],"sources":["../../../src/methods/artifact/create.ts"],"mappings":";;;iBAMiB;;WAEN;;WAEA;;WAEA;;WAEA;;;iBAIM;;WAEN;;WAEA;;WAEA;;;;;;qBAwBE,sBAAsB,iBAAiB,sBAAsB"}

package/dist/methods/artifact/create.js

@@ -0,0 +1,31 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { ArtifactId } from "../../ids.js";
+import { defineMethod } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/artifact/create.ts
+const params = z.object({
+	dir: z.string().regex(/^\//),
+	template: z.string().min(1).exactOptional(),
+	title: z.string().min(1).exactOptional(),
+	requestId: z.string().min(1).exactOptional()
+}).register(wireRegistry, { id: "ArtifactCreateParams" });
+const result = z.object({
+	artifactId: ArtifactId.schema,
+	dir: z.string(),
+	files: z.array(z.string()).readonly()
+}).register(wireRegistry, { id: "ArtifactCreateResult" });
+/**
+* `artifact/create`: writes a new artifact's entry, with a generated artifact ID in its manifest, into
+* an empty directory. The artifact appears in `artifact/list` once it is published.
+*/
+const artifactCreateMethod = defineMethod({
+	method: "artifact/create",
+	direction: "client-to-instance",
+	mutating: true,
+	params,
+	result
+});
+//#endregion
+export { artifactCreateMethod };
+
+//# sourceMappingURL=create.js.map

package/dist/methods/artifact/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","names":[],"sources":["../../../src/methods/artifact/create.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { ArtifactId } from \"../../ids.ts\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\n\n/** The params of `artifact/create` (INTERFACES §6). */\nexport interface ArtifactCreateParams {\n  /** The new artifact's directory, absolute. It must not exist yet, or be empty. */\n  readonly dir: string;\n  /** A template to start from. Templates arrive with `mostra new` (WP-26); none is the default. */\n  readonly template?: string;\n  /** The artifact's title. Default: the directory's name. */\n  readonly title?: string;\n  /** Makes retries idempotent: a repeated `requestId` returns the recorded result (H-03). */\n  readonly requestId?: string;\n}\n\n/** The result of `artifact/create`. */\nexport interface ArtifactCreateResult {\n  /** The generated artifact ID, written into the entry's manifest. */\n  readonly artifactId: string;\n  /** The artifact's directory (its real path). */\n  readonly dir: string;\n  /** The files written, relative to `dir`. */\n  readonly files: readonly string[];\n}\n\nconst params: z.ZodType<ArtifactCreateParams> = z\n  .object({\n    dir: z.string().regex(/^\\//),\n    template: z.string().min(1).exactOptional(),\n    title: z.string().min(1).exactOptional(),\n    requestId: z.string().min(1).exactOptional(),\n  })\n  .register(wireRegistry, { id: \"ArtifactCreateParams\" });\n\nconst result: z.ZodType<ArtifactCreateResult> = z\n  .object({\n    artifactId: ArtifactId.schema,\n    dir: z.string(),\n    files: z.array(z.string()).readonly(),\n  })\n  .register(wireRegistry, { id: \"ArtifactCreateResult\" });\n\n/**\n * `artifact/create`: writes a new artifact's entry, with a generated artifact ID in its manifest, into\n * an empty directory. The artifact appears in `artifact/list` once it is published.\n */\nexport const artifactCreateMethod: MethodDefinition<ArtifactCreateParams, ArtifactCreateResult> =\n  defineMethod({\n    method: \"artifact/create\",\n    direction: \"client-to-instance\",\n    mutating: true,\n    params,\n    result,\n  });\n"],"mappings":";;;;;AA2BA,MAAM,SAA0C,EAC7C,OAAO;CACN,KAAK,EAAE,OAAO,CAAC,CAAC,MAAM,KAAK;CAC3B,UAAU,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc;CAC1C,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc;CACvC,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc;AAC7C,CAAC,CAAC,CACD,SAAS,cAAc,EAAE,IAAI,uBAAuB,CAAC;AAExD,MAAM,SAA0C,EAC7C,OAAO;CACN,YAAY,WAAW;CACvB,KAAK,EAAE,OAAO;CACd,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS;AACtC,CAAC,CAAC,CACD,SAAS,cAAc,EAAE,IAAI,uBAAuB,CAAC;;;;;AAMxD,MAAa,uBACX,aAAa;CACX,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA;AACF,CAAC"}

package/dist/methods/artifact/get.d.ts

@@ -0,0 +1,17 @@
+import { ArtifactDetail, ArtifactRef } from "../../artifact.js";
+import { MethodDefinition } from "../../method.js";
+//#region src/methods/artifact/get.d.ts
+/** The params of `artifact/get` (INTERFACES §6). */
+export interface ArtifactGetParams {
+  /** The artifact, by ID or by a source path bound to it. */
+  readonly artifact: ArtifactRef;
+}
+/** The result of `artifact/get`. */
+export type ArtifactGetResult = ArtifactDetail;
+/**
+ * `artifact/get`: one artifact with its metadata, policy, source and every version. An unknown
+ * artifact is `MOSTRA_ARTIFACT_NOT_FOUND`.
+ */
+export declare const artifactGetMethod: MethodDefinition<ArtifactGetParams, ArtifactGetResult>;
+//#endregion
+//# sourceMappingURL=get.d.ts.map

package/dist/methods/artifact/get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","names":[],"sources":["../../../src/methods/artifact/get.ts"],"mappings":";;;;iBAMiB;;WAEN,UAAU;;;YAIT,oBAAoB;;;;;qBAUnB,mBAAmB,iBAAiB,mBAAmB"}

package/dist/methods/artifact/get.js

@@ -0,0 +1,21 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { ArtifactDetail, ArtifactRef } from "../../artifact.js";
+import { defineMethod } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/artifact/get.ts
+const params = z.object({ artifact: ArtifactRef }).register(wireRegistry, { id: "ArtifactGetParams" });
+/**
+* `artifact/get`: one artifact with its metadata, policy, source and every version. An unknown
+* artifact is `MOSTRA_ARTIFACT_NOT_FOUND`.
+*/
+const artifactGetMethod = defineMethod({
+	method: "artifact/get",
+	direction: "client-to-instance",
+	mutating: false,
+	params,
+	result: ArtifactDetail
+});
+//#endregion
+export { artifactGetMethod };
+
+//# sourceMappingURL=get.js.map

package/dist/methods/artifact/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","names":[],"sources":["../../../src/methods/artifact/get.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { ArtifactDetail, ArtifactRef } from \"../../artifact.ts\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\n\n/** The params of `artifact/get` (INTERFACES §6). */\nexport interface ArtifactGetParams {\n  /** The artifact, by ID or by a source path bound to it. */\n  readonly artifact: ArtifactRef;\n}\n\n/** The result of `artifact/get`. */\nexport type ArtifactGetResult = ArtifactDetail;\n\nconst params: z.ZodType<ArtifactGetParams> = z\n  .object({ artifact: ArtifactRef })\n  .register(wireRegistry, { id: \"ArtifactGetParams\" });\n\n/**\n * `artifact/get`: one artifact with its metadata, policy, source and every version. An unknown\n * artifact is `MOSTRA_ARTIFACT_NOT_FOUND`.\n */\nexport const artifactGetMethod: MethodDefinition<ArtifactGetParams, ArtifactGetResult> =\n  defineMethod({\n    method: \"artifact/get\",\n    direction: \"client-to-instance\",\n    mutating: false,\n    params,\n    result: ArtifactDetail,\n  });\n"],"mappings":";;;;;AAcA,MAAM,SAAuC,EAC1C,OAAO,EAAE,UAAU,YAAY,CAAC,CAAC,CACjC,SAAS,cAAc,EAAE,IAAI,oBAAoB,CAAC;;;;;AAMrD,MAAa,oBACX,aAAa;CACX,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA,QAAQ;AACV,CAAC"}

package/dist/methods/artifact/list.d.ts

@@ -0,0 +1,22 @@
+import { ArtifactSummary } from "../../artifact.js";
+import { MethodDefinition } from "../../method.js";
+//#region src/methods/artifact/list.d.ts
+/** Narrows `artifact/list`. */
+export interface ArtifactListFilter {
+  /** Only artifacts of this family (INTERFACES §2.2). */
+  readonly family?: string;
+}
+/** The params of `artifact/list` (INTERFACES §6). */
+export interface ArtifactListParams {
+  /** Narrows the list; all artifacts when absent. */
+  readonly filter?: ArtifactListFilter;
+}
+/** The result of `artifact/list`. */
+export interface ArtifactListResult {
+  /** The home's published artifacts, most recently published first. */
+  readonly artifacts: readonly ArtifactSummary[];
+}
+/** `artifact/list`: lists the home's published artifacts. */
+export declare const artifactListMethod: MethodDefinition<ArtifactListParams, ArtifactListResult>;
+//#endregion
+//# sourceMappingURL=list.d.ts.map

package/dist/methods/artifact/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","names":[],"sources":["../../../src/methods/artifact/list.ts"],"mappings":";;;;iBAMiB;;WAEN;;;iBAIM;;WAEN,SAAS;;;iBAIH;;WAEN,oBAAoB;;;qBAclB,oBAAoB,iBAAiB,oBAAoB"}

package/dist/methods/artifact/list.js

@@ -0,0 +1,19 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { ArtifactSummary } from "../../artifact.js";
+import { defineMethod } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/artifact/list.ts
+const params = z.object({ filter: z.object({ family: z.string().min(1).exactOptional() }).exactOptional() }).register(wireRegistry, { id: "ArtifactListParams" });
+const result = z.object({ artifacts: z.array(ArtifactSummary).readonly() }).register(wireRegistry, { id: "ArtifactListResult" });
+/** `artifact/list`: lists the home's published artifacts. */
+const artifactListMethod = defineMethod({
+	method: "artifact/list",
+	direction: "client-to-instance",
+	mutating: false,
+	params,
+	result
+});
+//#endregion
+export { artifactListMethod };
+
+//# sourceMappingURL=list.js.map

package/dist/methods/artifact/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","names":[],"sources":["../../../src/methods/artifact/list.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { ArtifactSummary } from \"../../artifact.ts\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\n\n/** Narrows `artifact/list`. */\nexport interface ArtifactListFilter {\n  /** Only artifacts of this family (INTERFACES §2.2). */\n  readonly family?: string;\n}\n\n/** The params of `artifact/list` (INTERFACES §6). */\nexport interface ArtifactListParams {\n  /** Narrows the list; all artifacts when absent. */\n  readonly filter?: ArtifactListFilter;\n}\n\n/** The result of `artifact/list`. */\nexport interface ArtifactListResult {\n  /** The home's published artifacts, most recently published first. */\n  readonly artifacts: readonly ArtifactSummary[];\n}\n\nconst params: z.ZodType<ArtifactListParams> = z\n  .object({\n    filter: z.object({ family: z.string().min(1).exactOptional() }).exactOptional(),\n  })\n  .register(wireRegistry, { id: \"ArtifactListParams\" });\n\nconst result: z.ZodType<ArtifactListResult> = z\n  .object({ artifacts: z.array(ArtifactSummary).readonly() })\n  .register(wireRegistry, { id: \"ArtifactListResult\" });\n\n/** `artifact/list`: lists the home's published artifacts. */\nexport const artifactListMethod: MethodDefinition<ArtifactListParams, ArtifactListResult> =\n  defineMethod({\n    method: \"artifact/list\",\n    direction: \"client-to-instance\",\n    mutating: false,\n    params,\n    result,\n  });\n"],"mappings":";;;;;AAuBA,MAAM,SAAwC,EAC3C,OAAO,EACN,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,cAAc,EAChF,CAAC,CAAC,CACD,SAAS,cAAc,EAAE,IAAI,qBAAqB,CAAC;AAEtD,MAAM,SAAwC,EAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAC1D,SAAS,cAAc,EAAE,IAAI,qBAAqB,CAAC;;AAGtD,MAAa,qBACX,aAAa;CACX,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA;AACF,CAAC"}

package/dist/methods/artifact/publish.d.ts

@@ -0,0 +1,28 @@
+import { SubmissionPolicy } from "../../manifest.js";
+import { PublishReceipt, SourceRef } from "../../artifact.js";
+import { MethodDefinition } from "../../method.js";
+//#region src/methods/artifact/publish.d.ts
+/** The params of `artifact/publish` (INTERFACES §6). */
+export interface ArtifactPublishParams {
+  /** What to publish: a source path, or an artifact ID meaning the path it was last published from. */
+  readonly source: SourceRef;
+  /**
+   * Publish even when `verify` reports errors, recording their codes in the version (D41). The
+   * verify gate arrives with WP-09; until then publish runs no verify and `force` changes nothing.
+   */
+  readonly force?: boolean;
+  /** The submission policy the host decides on, overriding the manifest's request (D39). */
+  readonly policy?: SubmissionPolicy;
+  /** Makes retries idempotent: a repeated `requestId` returns the recorded result (H-03). */
+  readonly requestId?: string;
+}
+/** The result of `artifact/publish`: the receipt, durable before it is sent (H-07). */
+export type ArtifactPublishResult = PublishReceipt;
+/**
+ * `artifact/publish`: freezes an artifact's source into an immutable, content-addressed version and
+ * returns its receipt. A failed publish leaves no version (VR-02); the same source and environment
+ * publish as the existing version (`reused`).
+ */
+export declare const artifactPublishMethod: MethodDefinition<ArtifactPublishParams, ArtifactPublishResult>;
+//#endregion
+//# sourceMappingURL=publish.d.ts.map

package/dist/methods/artifact/publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","names":[],"sources":["../../../src/methods/artifact/publish.ts"],"mappings":";;;;;iBAOiB;;WAEN,QAAQ;;;;;WAKR;;WAEA,SAAS;;WAET;;;YAIC,wBAAwB;;;;;;qBAgBvB,uBAAuB,iBAAiB,uBAAuB"}

package/dist/methods/artifact/publish.js

@@ -0,0 +1,28 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { SubmissionPolicy } from "../../manifest.js";
+import { PublishReceipt, SourceRef } from "../../artifact.js";
+import { defineMethod } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/artifact/publish.ts
+const params = z.object({
+	source: SourceRef,
+	force: z.boolean().exactOptional(),
+	policy: SubmissionPolicy.exactOptional(),
+	requestId: z.string().min(1).exactOptional()
+}).register(wireRegistry, { id: "ArtifactPublishParams" });
+/**
+* `artifact/publish`: freezes an artifact's source into an immutable, content-addressed version and
+* returns its receipt. A failed publish leaves no version (VR-02); the same source and environment
+* publish as the existing version (`reused`).
+*/
+const artifactPublishMethod = defineMethod({
+	method: "artifact/publish",
+	direction: "client-to-instance",
+	mutating: true,
+	params,
+	result: PublishReceipt
+});
+//#endregion
+export { artifactPublishMethod };
+
+//# sourceMappingURL=publish.js.map

package/dist/methods/artifact/publish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.js","names":[],"sources":["../../../src/methods/artifact/publish.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { PublishReceipt, SourceRef } from \"../../artifact.ts\";\nimport { SubmissionPolicy } from \"../../manifest.ts\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\n\n/** The params of `artifact/publish` (INTERFACES §6). */\nexport interface ArtifactPublishParams {\n  /** What to publish: a source path, or an artifact ID meaning the path it was last published from. */\n  readonly source: SourceRef;\n  /**\n   * Publish even when `verify` reports errors, recording their codes in the version (D41). The\n   * verify gate arrives with WP-09; until then publish runs no verify and `force` changes nothing.\n   */\n  readonly force?: boolean;\n  /** The submission policy the host decides on, overriding the manifest's request (D39). */\n  readonly policy?: SubmissionPolicy;\n  /** Makes retries idempotent: a repeated `requestId` returns the recorded result (H-03). */\n  readonly requestId?: string;\n}\n\n/** The result of `artifact/publish`: the receipt, durable before it is sent (H-07). */\nexport type ArtifactPublishResult = PublishReceipt;\n\nconst params: z.ZodType<ArtifactPublishParams> = z\n  .object({\n    source: SourceRef,\n    force: z.boolean().exactOptional(),\n    policy: SubmissionPolicy.exactOptional(),\n    requestId: z.string().min(1).exactOptional(),\n  })\n  .register(wireRegistry, { id: \"ArtifactPublishParams\" });\n\n/**\n * `artifact/publish`: freezes an artifact's source into an immutable, content-addressed version and\n * returns its receipt. A failed publish leaves no version (VR-02); the same source and environment\n * publish as the existing version (`reused`).\n */\nexport const artifactPublishMethod: MethodDefinition<ArtifactPublishParams, ArtifactPublishResult> =\n  defineMethod({\n    method: \"artifact/publish\",\n    direction: \"client-to-instance\",\n    mutating: true,\n    params,\n    result: PublishReceipt,\n  });\n"],"mappings":";;;;;;AAwBA,MAAM,SAA2C,EAC9C,OAAO;CACN,QAAQ;CACR,OAAO,EAAE,QAAQ,CAAC,CAAC,cAAc;CACjC,QAAQ,iBAAiB,cAAc;CACvC,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc;AAC7C,CAAC,CAAC,CACD,SAAS,cAAc,EAAE,IAAI,wBAAwB,CAAC;;;;;;AAOzD,MAAa,wBACX,aAAa;CACX,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA,QAAQ;AACV,CAAC"}

package/dist/methods/artifact/verify.d.ts

@@ -0,0 +1,29 @@
+import { SourceRef } from "../../artifact.js";
+import { MethodDefinition } from "../../method.js";
+import { ScreenshotPolicy, VerifyVerdict } from "../../verify.js";
+//#region src/methods/artifact/verify.d.ts
+/** The params of `artifact/verify` (INTERFACES §6). */
+export interface ArtifactVerifyParams {
+  /** What to verify: a source path, or an artifact ID meaning the path it was last published from. */
+  readonly source: SourceRef;
+  /**
+   * When the verdict's screenshots are returned to the caller (AX-05): `on-failure` (the default),
+   * `always` or `never`. Screenshots are taken either way; this sets their `returned` flag.
+   */
+  readonly screenshots?: ScreenshotPolicy;
+  /**
+   * Asks for `artifact/progress` notifications carrying this token as the stages run, when the
+   * client accepts them in `mostra/initialize`.
+   */
+  readonly progressToken?: string;
+}
+/** The result of `artifact/verify`: the verdict, also cached for the publish that follows (D41). */
+export type ArtifactVerifyResult = VerifyVerdict;
+/**
+ * `artifact/verify`: builds, type-checks, renders and exercises an artifact's source headlessly,
+ * compares it with its last passing version, and returns one verdict (D29, D138). It never
+ * publishes and never touches the home's drafts, state, events or deliveries.
+ */
+export declare const artifactVerifyMethod: MethodDefinition<ArtifactVerifyParams, ArtifactVerifyResult>;
+//#endregion
+//# sourceMappingURL=verify.d.ts.map

package/dist/methods/artifact/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","names":[],"sources":["../../../src/methods/artifact/verify.ts"],"mappings":";;;;;iBAOiB;;WAEN,QAAQ;;;;;WAKR,cAAc;;;;;WAKd;;;YAIC,uBAAuB;;;;;;qBAetB,sBAAsB,iBAAiB,sBAAsB"}

package/dist/methods/artifact/verify.js

@@ -0,0 +1,27 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { SourceRef } from "../../artifact.js";
+import { defineMethod } from "../../method.js";
+import { ScreenshotPolicy, VerifyVerdict } from "../../verify.js";
+import * as z from "zod";
+//#region src/methods/artifact/verify.ts
+const params = z.object({
+	source: SourceRef,
+	screenshots: ScreenshotPolicy.exactOptional(),
+	progressToken: z.string().min(1).max(200).exactOptional()
+}).register(wireRegistry, { id: "ArtifactVerifyParams" });
+/**
+* `artifact/verify`: builds, type-checks, renders and exercises an artifact's source headlessly,
+* compares it with its last passing version, and returns one verdict (D29, D138). It never
+* publishes and never touches the home's drafts, state, events or deliveries.
+*/
+const artifactVerifyMethod = defineMethod({
+	method: "artifact/verify",
+	direction: "client-to-instance",
+	mutating: false,
+	params,
+	result: VerifyVerdict
+});
+//#endregion
+export { artifactVerifyMethod };
+
+//# sourceMappingURL=verify.js.map

package/dist/methods/artifact/verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.js","names":[],"sources":["../../../src/methods/artifact/verify.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { SourceRef } from \"../../artifact.ts\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { ScreenshotPolicy, VerifyVerdict } from \"../../verify.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\n\n/** The params of `artifact/verify` (INTERFACES §6). */\nexport interface ArtifactVerifyParams {\n  /** What to verify: a source path, or an artifact ID meaning the path it was last published from. */\n  readonly source: SourceRef;\n  /**\n   * When the verdict's screenshots are returned to the caller (AX-05): `on-failure` (the default),\n   * `always` or `never`. Screenshots are taken either way; this sets their `returned` flag.\n   */\n  readonly screenshots?: ScreenshotPolicy;\n  /**\n   * Asks for `artifact/progress` notifications carrying this token as the stages run, when the\n   * client accepts them in `mostra/initialize`.\n   */\n  readonly progressToken?: string;\n}\n\n/** The result of `artifact/verify`: the verdict, also cached for the publish that follows (D41). */\nexport type ArtifactVerifyResult = VerifyVerdict;\n\nconst params: z.ZodType<ArtifactVerifyParams> = z\n  .object({\n    source: SourceRef,\n    screenshots: ScreenshotPolicy.exactOptional(),\n    progressToken: z.string().min(1).max(200).exactOptional(),\n  })\n  .register(wireRegistry, { id: \"ArtifactVerifyParams\" });\n\n/**\n * `artifact/verify`: builds, type-checks, renders and exercises an artifact's source headlessly,\n * compares it with its last passing version, and returns one verdict (D29, D138). It never\n * publishes and never touches the home's drafts, state, events or deliveries.\n */\nexport const artifactVerifyMethod: MethodDefinition<ArtifactVerifyParams, ArtifactVerifyResult> =\n  defineMethod({\n    method: \"artifact/verify\",\n    direction: \"client-to-instance\",\n    mutating: false,\n    params,\n    result: VerifyVerdict,\n  });\n"],"mappings":";;;;;;AAyBA,MAAM,SAA0C,EAC7C,OAAO;CACN,QAAQ;CACR,aAAa,iBAAiB,cAAc;CAC5C,eAAe,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,cAAc;AAC1D,CAAC,CAAC,CACD,SAAS,cAAc,EAAE,IAAI,uBAAuB,CAAC;;;;;;AAOxD,MAAa,uBACX,aAAa;CACX,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA,QAAQ;AACV,CAAC"}

package/dist/methods/deps/add.d.ts

@@ -0,0 +1,43 @@
+import { SourceRef } from "../../artifact.js";
+import { MethodDefinition } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/deps/add.d.ts
+/** The params of `deps/add` (INTERFACES §6, D95). */
+export interface DepsAddParams {
+  /** The artifact whose lockfile gains the packages: a source path, or an artifact ID. */
+  readonly artifact: SourceRef;
+  /**
+   * npm package specs: `name`, `name@version`, `name@range` or `name@tag`, scoped names included.
+   * A spec without an exact version takes the newest release at least a day old (D95).
+   */
+  readonly packages: readonly string[];
+  /** Makes retries idempotent: a repeated `requestId` returns the recorded result (H-03). */
+  readonly requestId?: string;
+}
+/** One package `deps/add` settled. */
+export interface AddedPackage {
+  /** The package's name. */
+  readonly name: string;
+  /** The exact version the artifact's lockfile now holds. */
+  readonly version: string;
+  /** Whether it comes from the warm set, which every artifact resolves without an install. */
+  readonly warm: boolean;
+}
+/** The result of `deps/add`. */
+export interface DepsAddResult {
+  /** Each requested package, in request order, with the version it resolved to. */
+  readonly packages: readonly AddedPackage[];
+  /** The SHA-256 of the artifact's lockfile after the change: the `lockDigest` its next publish uses. */
+  readonly lockDigest: string;
+}
+/** The Zod schema of the `AddedPackage` type. */
+export declare const AddedPackage: z.ZodType<AddedPackage>;
+/**
+ * `deps/add`: installs npm packages into the home's shared store and records them, at exact
+ * versions, in the artifact's lockfile, so its next publish builds with them, offline too. The
+ * method behind `mostra add` (D43, D95), and the only way packages enter a lockfile under the
+ * `explicit` dependency policy.
+ */
+export declare const depsAddMethod: MethodDefinition<DepsAddParams, DepsAddResult>;
+//#endregion
+//# sourceMappingURL=add.d.ts.map

package/dist/methods/deps/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","names":[],"sources":["../../../src/methods/deps/add.ts"],"mappings":";;;;;iBAMiB;;WAEN,UAAU;;;;;WAKV;;WAEA;;;iBAIM;;WAEN;;WAEA;;WAEA;;;iBAIM;;WAEN,mBAAmB;;WAEnB;;;qBAIE,cAAc,EAAE,QAAQ;;;;;;;qBA4BxB,eAAe,iBAAiB,eAAe"}

package/dist/methods/deps/add.js

@@ -0,0 +1,40 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { SourceRef } from "../../artifact.js";
+import { defineMethod } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/deps/add.ts
+/** The Zod schema of the `AddedPackage` type. */
+const AddedPackage = z.object({
+	name: z.string().min(1),
+	version: z.string().min(1),
+	warm: z.boolean()
+}).register(wireRegistry, {
+	id: "AddedPackage",
+	description: "A package deps/add settled: its name, exact version and whether it is warm."
+});
+const params = z.object({
+	artifact: SourceRef,
+	packages: z.array(z.string().min(1)).min(1).readonly(),
+	requestId: z.string().min(1).exactOptional()
+}).register(wireRegistry, { id: "DepsAddParams" });
+const result = z.object({
+	packages: z.array(AddedPackage).readonly(),
+	lockDigest: z.string().regex(/^[0-9a-f]{64}$/)
+}).register(wireRegistry, { id: "DepsAddResult" });
+/**
+* `deps/add`: installs npm packages into the home's shared store and records them, at exact
+* versions, in the artifact's lockfile, so its next publish builds with them, offline too. The
+* method behind `mostra add` (D43, D95), and the only way packages enter a lockfile under the
+* `explicit` dependency policy.
+*/
+const depsAddMethod = defineMethod({
+	method: "deps/add",
+	direction: "client-to-instance",
+	mutating: true,
+	params,
+	result
+});
+//#endregion
+export { AddedPackage, depsAddMethod };
+
+//# sourceMappingURL=add.js.map

package/dist/methods/deps/add.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.js","names":[],"sources":["../../../src/methods/deps/add.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { SourceRef } from \"../../artifact.ts\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\n\n/** The params of `deps/add` (INTERFACES §6, D95). */\nexport interface DepsAddParams {\n  /** The artifact whose lockfile gains the packages: a source path, or an artifact ID. */\n  readonly artifact: SourceRef;\n  /**\n   * npm package specs: `name`, `name@version`, `name@range` or `name@tag`, scoped names included.\n   * A spec without an exact version takes the newest release at least a day old (D95).\n   */\n  readonly packages: readonly string[];\n  /** Makes retries idempotent: a repeated `requestId` returns the recorded result (H-03). */\n  readonly requestId?: string;\n}\n\n/** One package `deps/add` settled. */\nexport interface AddedPackage {\n  /** The package's name. */\n  readonly name: string;\n  /** The exact version the artifact's lockfile now holds. */\n  readonly version: string;\n  /** Whether it comes from the warm set, which every artifact resolves without an install. */\n  readonly warm: boolean;\n}\n\n/** The result of `deps/add`. */\nexport interface DepsAddResult {\n  /** Each requested package, in request order, with the version it resolved to. */\n  readonly packages: readonly AddedPackage[];\n  /** The SHA-256 of the artifact's lockfile after the change: the `lockDigest` its next publish uses. */\n  readonly lockDigest: string;\n}\n\n/** The Zod schema of the `AddedPackage` type. */\nexport const AddedPackage: z.ZodType<AddedPackage> = z\n  .object({ name: z.string().min(1), version: z.string().min(1), warm: z.boolean() })\n  .register(wireRegistry, {\n    id: \"AddedPackage\",\n    description: \"A package deps/add settled: its name, exact version and whether it is warm.\",\n  });\n\nconst params: z.ZodType<DepsAddParams> = z\n  .object({\n    artifact: SourceRef,\n    packages: z.array(z.string().min(1)).min(1).readonly(),\n    requestId: z.string().min(1).exactOptional(),\n  })\n  .register(wireRegistry, { id: \"DepsAddParams\" });\n\nconst result: z.ZodType<DepsAddResult> = z\n  .object({\n    packages: z.array(AddedPackage).readonly(),\n    lockDigest: z.string().regex(/^[0-9a-f]{64}$/),\n  })\n  .register(wireRegistry, { id: \"DepsAddResult\" });\n\n/**\n * `deps/add`: installs npm packages into the home's shared store and records them, at exact\n * versions, in the artifact's lockfile, so its next publish builds with them, offline too. The\n * method behind `mostra add` (D43, D95), and the only way packages enter a lockfile under the\n * `explicit` dependency policy.\n */\nexport const depsAddMethod: MethodDefinition<DepsAddParams, DepsAddResult> = defineMethod({\n  method: \"deps/add\",\n  direction: \"client-to-instance\",\n  mutating: true,\n  params,\n  result,\n});\n"],"mappings":";;;;;;AAqCA,MAAa,eAAwC,EAClD,OAAO;CAAE,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CAAG,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CAAG,MAAM,EAAE,QAAQ;AAAE,CAAC,CAAC,CAClF,SAAS,cAAc;CACtB,IAAI;CACJ,aAAa;AACf,CAAC;AAEH,MAAM,SAAmC,EACtC,OAAO;CACN,UAAU;CACV,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;CACrD,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc;AAC7C,CAAC,CAAC,CACD,SAAS,cAAc,EAAE,IAAI,gBAAgB,CAAC;AAEjD,MAAM,SAAmC,EACtC,OAAO;CACN,UAAU,EAAE,MAAM,YAAY,CAAC,CAAC,SAAS;CACzC,YAAY,EAAE,OAAO,CAAC,CAAC,MAAM,gBAAgB;AAC/C,CAAC,CAAC,CACD,SAAS,cAAc,EAAE,IAAI,gBAAgB,CAAC;;;;;;;AAQjD,MAAa,gBAAgE,aAAa;CACxF,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA;AACF,CAAC"}

package/dist/methods/dev/start.d.ts

@@ -0,0 +1,52 @@
+import { SourceRef } from "../../artifact.js";
+import { Diagnostic } from "../../diagnostics/diagnostic.js";
+import { MethodDefinition } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/dev/start.d.ts
+/** The params of `dev/start` (INTERFACES §6, D140 item 12, VR-08). */
+export interface DevStartParams {
+  /** The artifact source to serve with hot reload. */
+  readonly source: SourceRef;
+  /** The loopback port for the dev page; one the operating system assigns when absent. */
+  readonly port?: number;
+}
+/** The result of `dev/start`. */
+export interface DevStartResult {
+  /** The dev page, with the session's secret in its fragment (`#t=…`). Never a capability URL. */
+  readonly url: string;
+  /** The loopback port the dev page listens on. */
+  readonly port: number;
+  /** The session, for `dev/stop` and `dev/notify`. */
+  readonly sessionId: string;
+}
+/** The notification a dev session sends the connection that started it (D140 item 12). */
+export declare const DEV_NOTIFY = "dev/notify";
+/** What happened in a dev session. */
+export type DevEventKind = "built" | "reloaded" | "server-restarted" | "submission" | "diagnostics";
+/** The params of `dev/notify`. */
+export interface DevNotifyParams {
+  /** The session it happened in. */
+  readonly sessionId: string;
+  /** What happened. */
+  readonly kind: DevEventKind;
+  /** When it happened (RFC 3339, UTC). */
+  readonly at: string;
+  /** What the build or the server code reported (`built`, `diagnostics`, `server-restarted`). */
+  readonly diagnostics?: readonly Diagnostic[];
+  /** The changed files that caused it (`reloaded`, `server-restarted`), relative to the source. */
+  readonly files?: readonly string[];
+  /** A submission's Results JSON (INTERFACES §8), for `submission`; it was delivered nowhere. */
+  readonly results?: unknown;
+}
+/** The Zod schema of `dev/notify`'s params. */
+export declare const DevNotifyParams: z.ZodType<DevNotifyParams>;
+/**
+ * `dev/start`: serves an artifact's source with Vite's hot module reload on its own loopback
+ * port (VR-08, D140 item 12), with every server feature through a scratch sandbox like verify's:
+ * nothing reaches the home's drafts, state, events, hosts or deliveries, and no capability URL
+ * reaches it. The session belongs to this connection and ends when it closes or with `dev/stop`;
+ * a client that accepts `dev/notify` receives its events.
+ */
+export declare const devStartMethod: MethodDefinition<DevStartParams, DevStartResult>;
+//#endregion
+//# sourceMappingURL=start.d.ts.map

package/dist/methods/dev/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","names":[],"sources":["../../../src/methods/dev/start.ts"],"mappings":";;;;;;iBAOiB;;WAEN,QAAQ;;WAER;;;iBAIM;;WAEN;;WAEA;;WAEA;;;qBAgBE;;YAGD;;iBAGK;;WAEN;;WAEA,MAAM;;WAEN;;WAEA,uBAAuB;;WAEvB;;WAEA;;;qBAIE,iBAAiB,EAAE,QAAQ;;;;;;;;qBAkB3B,gBAAgB,iBAAiB,gBAAgB"}

package/dist/methods/dev/start.js

@@ -0,0 +1,56 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { SourceRef } from "../../artifact.js";
+import { Diagnostic } from "../../diagnostics/diagnostic.js";
+import { defineMethod } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/dev/start.ts
+const params = z.object({
+	source: SourceRef,
+	port: z.int().min(1).max(65535).exactOptional()
+}).register(wireRegistry, { id: "DevStartParams" });
+const result = z.object({
+	url: z.string().min(1),
+	port: z.int().min(1).max(65535),
+	sessionId: z.string().min(1)
+}).register(wireRegistry, {
+	id: "DevStartResult",
+	description: "A running dev session."
+});
+/** The notification a dev session sends the connection that started it (D140 item 12). */
+const DEV_NOTIFY = "dev/notify";
+/** The Zod schema of `dev/notify`'s params. */
+const DevNotifyParams = z.object({
+	sessionId: z.string().min(1),
+	kind: z.enum([
+		"built",
+		"reloaded",
+		"server-restarted",
+		"submission",
+		"diagnostics"
+	]),
+	at: z.iso.datetime(),
+	diagnostics: z.array(Diagnostic).readonly().exactOptional(),
+	files: z.array(z.string()).readonly().exactOptional(),
+	results: z.unknown().exactOptional()
+}).register(wireRegistry, {
+	id: "DevNotifyParams",
+	description: "One event of a dev session."
+});
+/**
+* `dev/start`: serves an artifact's source with Vite's hot module reload on its own loopback
+* port (VR-08, D140 item 12), with every server feature through a scratch sandbox like verify's:
+* nothing reaches the home's drafts, state, events, hosts or deliveries, and no capability URL
+* reaches it. The session belongs to this connection and ends when it closes or with `dev/stop`;
+* a client that accepts `dev/notify` receives its events.
+*/
+const devStartMethod = defineMethod({
+	method: "dev/start",
+	direction: "client-to-instance",
+	mutating: true,
+	params,
+	result
+});
+//#endregion
+export { DEV_NOTIFY, DevNotifyParams, devStartMethod };
+
+//# sourceMappingURL=start.js.map

package/dist/methods/dev/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","names":[],"sources":["../../../src/methods/dev/start.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { SourceRef } from \"../../artifact.ts\";\nimport { Diagnostic } from \"../../diagnostics/diagnostic.ts\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\n\n/** The params of `dev/start` (INTERFACES §6, D140 item 12, VR-08). */\nexport interface DevStartParams {\n  /** The artifact source to serve with hot reload. */\n  readonly source: SourceRef;\n  /** The loopback port for the dev page; one the operating system assigns when absent. */\n  readonly port?: number;\n}\n\n/** The result of `dev/start`. */\nexport interface DevStartResult {\n  /** The dev page, with the session's secret in its fragment (`#t=…`). Never a capability URL. */\n  readonly url: string;\n  /** The loopback port the dev page listens on. */\n  readonly port: number;\n  /** The session, for `dev/stop` and `dev/notify`. */\n  readonly sessionId: string;\n}\n\nconst params: z.ZodType<DevStartParams> = z\n  .object({ source: SourceRef, port: z.int().min(1).max(65535).exactOptional() })\n  .register(wireRegistry, { id: \"DevStartParams\" });\n\nconst result: z.ZodType<DevStartResult> = z\n  .object({\n    url: z.string().min(1),\n    port: z.int().min(1).max(65535),\n    sessionId: z.string().min(1),\n  })\n  .register(wireRegistry, { id: \"DevStartResult\", description: \"A running dev session.\" });\n\n/** The notification a dev session sends the connection that started it (D140 item 12). */\nexport const DEV_NOTIFY = \"dev/notify\";\n\n/** What happened in a dev session. */\nexport type DevEventKind = \"built\" | \"reloaded\" | \"server-restarted\" | \"submission\" | \"diagnostics\";\n\n/** The params of `dev/notify`. */\nexport interface DevNotifyParams {\n  /** The session it happened in. */\n  readonly sessionId: string;\n  /** What happened. */\n  readonly kind: DevEventKind;\n  /** When it happened (RFC 3339, UTC). */\n  readonly at: string;\n  /** What the build or the server code reported (`built`, `diagnostics`, `server-restarted`). */\n  readonly diagnostics?: readonly Diagnostic[];\n  /** The changed files that caused it (`reloaded`, `server-restarted`), relative to the source. */\n  readonly files?: readonly string[];\n  /** A submission's Results JSON (INTERFACES §8), for `submission`; it was delivered nowhere. */\n  readonly results?: unknown;\n}\n\n/** The Zod schema of `dev/notify`'s params. */\nexport const DevNotifyParams: z.ZodType<DevNotifyParams> = z\n  .object({\n    sessionId: z.string().min(1),\n    kind: z.enum([\"built\", \"reloaded\", \"server-restarted\", \"submission\", \"diagnostics\"]),\n    at: z.iso.datetime(),\n    diagnostics: z.array(Diagnostic).readonly().exactOptional(),\n    files: z.array(z.string()).readonly().exactOptional(),\n    results: z.unknown().exactOptional(),\n  })\n  .register(wireRegistry, { id: \"DevNotifyParams\", description: \"One event of a dev session.\" });\n\n/**\n * `dev/start`: serves an artifact's source with Vite's hot module reload on its own loopback\n * port (VR-08, D140 item 12), with every server feature through a scratch sandbox like verify's:\n * nothing reaches the home's drafts, state, events, hosts or deliveries, and no capability URL\n * reaches it. The session belongs to this connection and ends when it closes or with `dev/stop`;\n * a client that accepts `dev/notify` receives its events.\n */\nexport const devStartMethod: MethodDefinition<DevStartParams, DevStartResult> = defineMethod({\n  method: \"dev/start\",\n  direction: \"client-to-instance\",\n  mutating: true,\n  params,\n  result,\n});\n"],"mappings":";;;;;;AAwBA,MAAM,SAAoC,EACvC,OAAO;CAAE,QAAQ;CAAW,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,cAAc;AAAE,CAAC,CAAC,CAC9E,SAAS,cAAc,EAAE,IAAI,iBAAiB,CAAC;AAElD,MAAM,SAAoC,EACvC,OAAO;CACN,KAAK,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CACrB,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK;CAC9B,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;AAC7B,CAAC,CAAC,CACD,SAAS,cAAc;CAAE,IAAI;CAAkB,aAAa;AAAyB,CAAC;;AAGzF,MAAa,aAAa;;AAsB1B,MAAa,kBAA8C,EACxD,OAAO;CACN,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CAC3B,MAAM,EAAE,KAAK;EAAC;EAAS;EAAY;EAAoB;EAAc;CAAa,CAAC;CACnF,IAAI,EAAE,IAAI,SAAS;CACnB,aAAa,EAAE,MAAM,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,cAAc;CAC1D,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,cAAc;CACpD,SAAS,EAAE,QAAQ,CAAC,CAAC,cAAc;AACrC,CAAC,CAAC,CACD,SAAS,cAAc;CAAE,IAAI;CAAmB,aAAa;AAA8B,CAAC;;;;;;;;AAS/F,MAAa,iBAAmE,aAAa;CAC3F,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA;AACF,CAAC"}

package/dist/methods/dev/stop.d.ts

@@ -0,0 +1,16 @@
+import { MethodDefinition } from "../../method.js";
+//#region src/methods/dev/stop.d.ts
+/** The params of `dev/stop` (INTERFACES §6, D140 item 12). */
+export interface DevStopParams {
+  /** The session `dev/start` returned. */
+  readonly sessionId: string;
+}
+/** The result of `dev/stop`. */
+export type DevStopResult = Record<string, never>;
+/**
+ * `dev/stop`: ends a dev session this connection started, stopping its Vite child and workers
+ * and deleting its scratch state. Stopping a session that already ended succeeds.
+ */
+export declare const devStopMethod: MethodDefinition<DevStopParams, DevStopResult>;
+//#endregion
+//# sourceMappingURL=stop.d.ts.map

package/dist/methods/dev/stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.d.ts","names":[],"sources":["../../../src/methods/dev/stop.ts"],"mappings":";;;iBAKiB;;WAEN;;;YAIC,gBAAgB;;;;;qBAcf,eAAe,iBAAiB,eAAe"}

package/dist/methods/dev/stop.js

@@ -0,0 +1,21 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { defineMethod } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/dev/stop.ts
+const params = z.object({ sessionId: z.string().min(1) }).register(wireRegistry, { id: "DevStopParams" });
+const result = z.object({}).register(wireRegistry, { id: "DevStopResult" });
+/**
+* `dev/stop`: ends a dev session this connection started, stopping its Vite child and workers
+* and deleting its scratch state. Stopping a session that already ended succeeds.
+*/
+const devStopMethod = defineMethod({
+	method: "dev/stop",
+	direction: "client-to-instance",
+	mutating: true,
+	params,
+	result
+});
+//#endregion
+export { devStopMethod };
+
+//# sourceMappingURL=stop.js.map

package/dist/methods/dev/stop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.js","names":[],"sources":["../../../src/methods/dev/stop.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 `dev/stop` (INTERFACES §6, D140 item 12). */\nexport interface DevStopParams {\n  /** The session `dev/start` returned. */\n  readonly sessionId: string;\n}\n\n/** The result of `dev/stop`. */\nexport type DevStopResult = Record<string, never>;\n\nconst params: z.ZodType<DevStopParams> = z\n  .object({ sessionId: z.string().min(1) })\n  .register(wireRegistry, { id: \"DevStopParams\" });\n\nconst result: z.ZodType<DevStopResult> = z\n  .object({})\n  .register(wireRegistry, { id: \"DevStopResult\" });\n\n/**\n * `dev/stop`: ends a dev session this connection started, stopping its Vite child and workers\n * and deleting its scratch state. Stopping a session that already ended succeeds.\n */\nexport const devStopMethod: MethodDefinition<DevStopParams, DevStopResult> = defineMethod({\n  method: \"dev/stop\",\n  direction: \"client-to-instance\",\n  mutating: true,\n  params,\n  result,\n});\n"],"mappings":";;;;AAaA,MAAM,SAAmC,EACtC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CACxC,SAAS,cAAc,EAAE,IAAI,gBAAgB,CAAC;AAEjD,MAAM,SAAmC,EACtC,OAAO,CAAC,CAAC,CAAC,CACV,SAAS,cAAc,EAAE,IAAI,gBAAgB,CAAC;;;;;AAMjD,MAAa,gBAAgE,aAAa;CACxF,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA;AACF,CAAC"}

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

@@ -0,0 +1,20 @@
+import { MethodDefinition } from "../../method.js";
+//#region src/methods/events/ack.d.ts
+/** The params of `events/ack` (INTERFACES §6). */
+export interface EventsAckParams {
+  /** The subscription, as `events/subscribe` returned it. */
+  readonly subscriptionId: string;
+  /** Every event up to this cursor is handled. An earlier cursor than the last ack changes nothing. */
+  readonly cursor: string;
+  /** Accepted for uniformity (H-03); acknowledging is idempotent by itself. */
+  readonly requestId?: string;
+}
+/** The result of `events/ack`. */
+export type EventsAckResult = Record<string, never>;
+/**
+ * `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).
+ */
+export declare const eventsAckMethod: MethodDefinition<EventsAckParams, EventsAckResult>;
+//#endregion
+//# sourceMappingURL=ack.d.ts.map