@mostra/protocol 0.0.0-stage → 0.1.0

package/dist/methods/port/drafts-mirror.js

@@ -0,0 +1,33 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { ArtifactId, ViewerId } from "../../ids.js";
+import { DocumentRevision } from "../../interaction.js";
+import { defineMethod } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/port/drafts-mirror.ts
+/** The Zod schema of the `DraftMirror` type. */
+const DraftMirror = z.object({
+	kind: z.literal("draft"),
+	artifactId: ArtifactId.schema,
+	viewerId: ViewerId.schema,
+	epoch: z.int().min(1),
+	revision: DocumentRevision,
+	fields: z.record(z.string(), z.unknown())
+}).register(wireRegistry, {
+	id: "DraftMirror",
+	description: "A viewer's draft mirrored to a host: always kind draft, never a submission."
+});
+/**
+* `port/drafts.mirror`: Mostra sends the latest revision of a viewer's draft to a host that
+* registered the drafts port, best effort (D105). Mostra's ledger stays canonical (D58).
+*/
+const portDraftsMirrorMethod = defineMethod({
+	method: "port/drafts.mirror",
+	direction: "instance-to-host",
+	mutating: false,
+	params: DraftMirror,
+	result: z.unknown()
+});
+//#endregion
+export { DraftMirror, portDraftsMirrorMethod };
+
+//# sourceMappingURL=drafts-mirror.js.map

package/dist/methods/port/drafts-mirror.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drafts-mirror.js","names":[],"sources":["../../../src/methods/port/drafts-mirror.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { ArtifactId, ViewerId } from \"../../ids.ts\";\nimport { DocumentRevision } from \"../../interaction.ts\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\n\n/** A viewer's draft, mirrored to a host as it changes (INTERFACES §7, D105). */\nexport interface DraftMirror {\n  /** Always `draft`: a mirror is never a submission (IN-06). */\n  readonly kind: \"draft\";\n  /** The artifact. */\n  readonly artifactId: string;\n  /** Whose draft it is. */\n  readonly viewerId: string;\n  /** The draft's epoch (D103). */\n  readonly epoch: number;\n  /** The draft's revision; a later mirror has a higher one. */\n  readonly revision: DocumentRevision;\n  /** Every field of the draft by ID. */\n  readonly fields: Readonly<Record<string, unknown>>;\n}\n\n/** The result of `port/drafts.mirror`. */\nexport type DraftsMirrorResult = unknown;\n\n/** The Zod schema of the `DraftMirror` type. */\nexport const DraftMirror: z.ZodType<DraftMirror> = z\n  .object({\n    kind: z.literal(\"draft\"),\n    artifactId: ArtifactId.schema,\n    viewerId: ViewerId.schema,\n    epoch: z.int().min(1),\n    revision: DocumentRevision,\n    fields: z.record(z.string(), z.unknown()),\n  })\n  .register(wireRegistry, {\n    id: \"DraftMirror\",\n    description: \"A viewer's draft mirrored to a host: always kind draft, never a submission.\",\n  });\n\n/**\n * `port/drafts.mirror`: Mostra sends the latest revision of a viewer's draft to a host that\n * registered the drafts port, best effort (D105). Mostra's ledger stays canonical (D58).\n */\nexport const portDraftsMirrorMethod: MethodDefinition<DraftMirror, DraftsMirrorResult> =\n  defineMethod({\n    method: \"port/drafts.mirror\",\n    direction: \"instance-to-host\",\n    mutating: false,\n    params: DraftMirror,\n    result: z.unknown(),\n  });\n"],"mappings":";;;;;;;AA0BA,MAAa,cAAsC,EAChD,OAAO;CACN,MAAM,EAAE,QAAQ,OAAO;CACvB,YAAY,WAAW;CACvB,UAAU,SAAS;CACnB,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC;CACpB,UAAU;CACV,QAAQ,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC;AAC1C,CAAC,CAAC,CACD,SAAS,cAAc;CACtB,IAAI;CACJ,aAAa;AACf,CAAC;;;;;AAMH,MAAa,yBACX,aAAa;CACX,QAAQ;CACR,WAAW;CACX,UAAU;CACV,QAAQ;CACR,QAAQ,EAAE,QAAQ;AACpB,CAAC"}

package/dist/methods/port/secrets-get.d.ts

@@ -0,0 +1,19 @@
+import { MethodDefinition } from "../../method.js";
+//#region src/methods/port/secrets-get.d.ts
+/** The params of `port/secrets.get` (INTERFACES §7, D44). */
+export interface PortSecretsGetParams {
+  /** The artifact whose server code asks. */
+  readonly artifactId: string;
+  /** The secret's name. */
+  readonly name: string;
+}
+/** The result of `port/secrets.get`: the value, or `null` when the host has none. */
+export type PortSecretsGetResult = string | null;
+/**
+ * `port/secrets.get`: Mostra asks the host that registered the `secrets` port for a secret its
+ * artifact's server code reads (D44), with 30 seconds to answer. `null` falls back to the home's
+ * own store; a failure or a timeout fails the read with `MOSTRA_SECRET_MISSING`.
+ */
+export declare const portSecretsGetMethod: MethodDefinition<PortSecretsGetParams, PortSecretsGetResult>;
+//#endregion
+//# sourceMappingURL=secrets-get.d.ts.map

package/dist/methods/port/secrets-get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets-get.d.ts","names":[],"sources":["../../../src/methods/port/secrets-get.ts"],"mappings":";;;iBAKiB;;WAEN;;WAEA;;;YAIC;;;;;;qBAmBC,sBAAsB,iBAAiB,sBAAsB"}

package/dist/methods/port/secrets-get.js

@@ -0,0 +1,31 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { defineMethod } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/port/secrets-get.ts
+const params = z.object({
+	artifactId: z.string(),
+	name: z.string()
+}).register(wireRegistry, {
+	id: "PortSecretsGetParams",
+	description: "The artifact and the name of the secret its server code asks for."
+});
+const result = z.string().nullable().register(wireRegistry, {
+	id: "PortSecretsGetResult",
+	description: "The secret's value, or null when the host has none."
+});
+/**
+* `port/secrets.get`: Mostra asks the host that registered the `secrets` port for a secret its
+* artifact's server code reads (D44), with 30 seconds to answer. `null` falls back to the home's
+* own store; a failure or a timeout fails the read with `MOSTRA_SECRET_MISSING`.
+*/
+const portSecretsGetMethod = defineMethod({
+	method: "port/secrets.get",
+	direction: "instance-to-host",
+	mutating: false,
+	params,
+	result
+});
+//#endregion
+export { portSecretsGetMethod };
+
+//# sourceMappingURL=secrets-get.js.map

package/dist/methods/port/secrets-get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets-get.js","names":[],"sources":["../../../src/methods/port/secrets-get.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 `port/secrets.get` (INTERFACES §7, D44). */\nexport interface PortSecretsGetParams {\n  /** The artifact whose server code asks. */\n  readonly artifactId: string;\n  /** The secret's name. */\n  readonly name: string;\n}\n\n/** The result of `port/secrets.get`: the value, or `null` when the host has none. */\nexport type PortSecretsGetResult = string | null;\n\nconst params: z.ZodType<PortSecretsGetParams> = z\n  .object({ artifactId: z.string(), name: z.string() })\n  .register(wireRegistry, {\n    id: \"PortSecretsGetParams\",\n    description: \"The artifact and the name of the secret its server code asks for.\",\n  });\n\nconst result: z.ZodType<PortSecretsGetResult> = z.string().nullable().register(wireRegistry, {\n  id: \"PortSecretsGetResult\",\n  description: \"The secret's value, or null when the host has none.\",\n});\n\n/**\n * `port/secrets.get`: Mostra asks the host that registered the `secrets` port for a secret its\n * artifact's server code reads (D44), with 30 seconds to answer. `null` falls back to the home's\n * own store; a failure or a timeout fails the read with `MOSTRA_SECRET_MISSING`.\n */\nexport const portSecretsGetMethod: MethodDefinition<PortSecretsGetParams, PortSecretsGetResult> =\n  defineMethod({\n    method: \"port/secrets.get\",\n    direction: \"instance-to-host\",\n    mutating: false,\n    params,\n    result,\n  });\n"],"mappings":";;;;AAeA,MAAM,SAA0C,EAC7C,OAAO;CAAE,YAAY,EAAE,OAAO;CAAG,MAAM,EAAE,OAAO;AAAE,CAAC,CAAC,CACpD,SAAS,cAAc;CACtB,IAAI;CACJ,aAAa;AACf,CAAC;AAEH,MAAM,SAA0C,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,cAAc;CAC3F,IAAI;CACJ,aAAa;AACf,CAAC;;;;;;AAOD,MAAa,uBACX,aAAa;CACX,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA;AACF,CAAC"}

package/dist/methods/port/submissions-deliver.d.ts

@@ -0,0 +1,38 @@
+import { Results } from "../../interaction.js";
+import { MethodDefinition } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/port/submissions-deliver.d.ts
+/** One submission delivered to a host (INTERFACES §7, D105). */
+export interface SubmissionEnvelope {
+  /** Always `submission`: a draft never arrives through this port (IN-06). */
+  readonly kind: "submission";
+  /** Stable across redeliveries: treat a repeated ID as the same delivery (H-03). */
+  readonly deliveryId: string;
+  /** The submission. */
+  readonly submissionId: string;
+  /** Its artifact. */
+  readonly artifactId: string;
+  /** 1 for the first attempt; more after retries and restarts. */
+  readonly attempt: number;
+  /** The complete submission (INTERFACES §8), built from the immutable submission alone. */
+  readonly results: Results;
+}
+/** What a host answers a delivery. */
+export type SubmissionsDeliverResult = {
+  readonly accepted: true;
+} | {
+  readonly accepted: false;
+  /** `duplicate` (already held), `undeliverable` (terminal, shown to the viewer), or the host's own. */
+  readonly reason: string;
+  /** `true` keeps the delivery pending and retries it with backoff. */
+  readonly retry: boolean;
+};
+/** The Zod schema of the `SubmissionEnvelope` type. */
+export declare const SubmissionEnvelope: z.ZodType<SubmissionEnvelope>;
+/**
+ * `port/submissions.deliver`: Mostra delivers one submission to the host that registered the
+ * submissions port, after the submission is durable (IN-12), one at a time in submission order.
+ */
+export declare const portSubmissionsDeliverMethod: MethodDefinition<SubmissionEnvelope, SubmissionsDeliverResult>;
+//#endregion
+//# sourceMappingURL=submissions-deliver.d.ts.map

package/dist/methods/port/submissions-deliver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submissions-deliver.d.ts","names":[],"sources":["../../../src/methods/port/submissions-deliver.ts"],"mappings":";;;;;iBAOiB;;WAEN;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA,SAAS;;;YAIR;WACG;;WAEA;;WAEA;;WAEA;;;qBAIF,oBAAoB,EAAE,QAAQ;;;;;qBA0B9B,8BAA8B,iBACzC,oBACA"}

package/dist/methods/port/submissions-deliver.js

@@ -0,0 +1,38 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { ArtifactId, DeliveryId, SubmissionId } from "../../ids.js";
+import { Results } from "../../interaction.js";
+import { defineMethod } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/port/submissions-deliver.ts
+/** The Zod schema of the `SubmissionEnvelope` type. */
+const SubmissionEnvelope = z.object({
+	kind: z.literal("submission"),
+	deliveryId: DeliveryId.schema,
+	submissionId: SubmissionId.schema,
+	artifactId: ArtifactId.schema,
+	attempt: z.int().min(1),
+	results: Results
+}).register(wireRegistry, {
+	id: "SubmissionEnvelope",
+	description: "One submission delivered to a host: delivery ID, attempt and the complete results."
+});
+const result = z.union([z.object({ accepted: z.literal(true) }), z.object({
+	accepted: z.literal(false),
+	reason: z.string().min(1),
+	retry: z.boolean()
+})]).register(wireRegistry, { id: "PortSubmissionsDeliverResult" });
+/**
+* `port/submissions.deliver`: Mostra delivers one submission to the host that registered the
+* submissions port, after the submission is durable (IN-12), one at a time in submission order.
+*/
+const portSubmissionsDeliverMethod = defineMethod({
+	method: "port/submissions.deliver",
+	direction: "instance-to-host",
+	mutating: false,
+	params: SubmissionEnvelope,
+	result
+});
+//#endregion
+export { SubmissionEnvelope, portSubmissionsDeliverMethod };
+
+//# sourceMappingURL=submissions-deliver.js.map

package/dist/methods/port/submissions-deliver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"submissions-deliver.js","names":[],"sources":["../../../src/methods/port/submissions-deliver.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { ArtifactId, DeliveryId, SubmissionId } from \"../../ids.ts\";\nimport { Results } from \"../../interaction.ts\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\n\n/** One submission delivered to a host (INTERFACES §7, D105). */\nexport interface SubmissionEnvelope {\n  /** Always `submission`: a draft never arrives through this port (IN-06). */\n  readonly kind: \"submission\";\n  /** Stable across redeliveries: treat a repeated ID as the same delivery (H-03). */\n  readonly deliveryId: string;\n  /** The submission. */\n  readonly submissionId: string;\n  /** Its artifact. */\n  readonly artifactId: string;\n  /** 1 for the first attempt; more after retries and restarts. */\n  readonly attempt: number;\n  /** The complete submission (INTERFACES §8), built from the immutable submission alone. */\n  readonly results: Results;\n}\n\n/** What a host answers a delivery. */\nexport type SubmissionsDeliverResult =\n  | { readonly accepted: true }\n  | {\n      readonly accepted: false;\n      /** `duplicate` (already held), `undeliverable` (terminal, shown to the viewer), or the host's own. */\n      readonly reason: string;\n      /** `true` keeps the delivery pending and retries it with backoff. */\n      readonly retry: boolean;\n    };\n\n/** The Zod schema of the `SubmissionEnvelope` type. */\nexport const SubmissionEnvelope: z.ZodType<SubmissionEnvelope> = z\n  .object({\n    kind: z.literal(\"submission\"),\n    deliveryId: DeliveryId.schema,\n    submissionId: SubmissionId.schema,\n    artifactId: ArtifactId.schema,\n    attempt: z.int().min(1),\n    results: Results,\n  })\n  .register(wireRegistry, {\n    id: \"SubmissionEnvelope\",\n    description:\n      \"One submission delivered to a host: delivery ID, attempt and the complete results.\",\n  });\n\nconst result: z.ZodType<SubmissionsDeliverResult> = z\n  .union([\n    z.object({ accepted: z.literal(true) }),\n    z.object({ accepted: z.literal(false), reason: z.string().min(1), retry: z.boolean() }),\n  ])\n  .register(wireRegistry, { id: \"PortSubmissionsDeliverResult\" });\n\n/**\n * `port/submissions.deliver`: Mostra delivers one submission to the host that registered the\n * submissions port, after the submission is durable (IN-12), one at a time in submission order.\n */\nexport const portSubmissionsDeliverMethod: MethodDefinition<\n  SubmissionEnvelope,\n  SubmissionsDeliverResult\n> = defineMethod({\n  method: \"port/submissions.deliver\",\n  direction: \"instance-to-host\",\n  mutating: false,\n  params: SubmissionEnvelope,\n  result,\n});\n"],"mappings":";;;;;;;AAkCA,MAAa,qBAAoD,EAC9D,OAAO;CACN,MAAM,EAAE,QAAQ,YAAY;CAC5B,YAAY,WAAW;CACvB,cAAc,aAAa;CAC3B,YAAY,WAAW;CACvB,SAAS,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC;CACtB,SAAS;AACX,CAAC,CAAC,CACD,SAAS,cAAc;CACtB,IAAI;CACJ,aACE;AACJ,CAAC;AAEH,MAAM,SAA8C,EACjD,MAAM,CACL,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,IAAI,EAAE,CAAC,GACtC,EAAE,OAAO;CAAE,UAAU,EAAE,QAAQ,KAAK;CAAG,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CAAG,OAAO,EAAE,QAAQ;AAAE,CAAC,CACxF,CAAC,CAAC,CACD,SAAS,cAAc,EAAE,IAAI,+BAA+B,CAAC;;;;;AAMhE,MAAa,+BAGT,aAAa;CACf,QAAQ;CACR,WAAW;CACX,UAAU;CACV,QAAQ;CACR;AACF,CAAC"}

package/dist/methods/port/trusted-controls-activated.d.ts

@@ -0,0 +1,27 @@
+import { TrustedControl } from "../../view.js";
+import { Viewer } from "../../interaction.js";
+import { MethodDefinition } from "../../method.js";
+//#region src/methods/port/trusted-controls-activated.d.ts
+/** The params of `port/trustedControls.activated` (INTERFACES §7): a person used a trusted control. */
+export interface PortTrustedControlsActivatedParams {
+  /** The artifact. */
+  readonly artifactId: string;
+  /** The control: `submit` or `choose`. */
+  readonly control: TrustedControl;
+  /** Who used it. */
+  readonly viewer: Viewer;
+  /** The view it was used in. */
+  readonly viewId: string;
+  /** What it did: the submission it made, or the review set and candidate it chose. */
+  readonly detail?: Readonly<Record<string, string>>;
+}
+/** The result of `port/trustedControls.activated`; its content is ignored. */
+export type PortTrustedControlsActivatedResult = unknown;
+/**
+ * `port/trustedControls.activated`: after a trusted control's change commits, Mostra tells the
+ * host that registered the `trustedControls` port, best effort and never retried (D108). The
+ * change itself is durable already; this call only lets a host react at once.
+ */
+export declare const portTrustedControlsActivatedMethod: MethodDefinition<PortTrustedControlsActivatedParams, PortTrustedControlsActivatedResult>;
+//#endregion
+//# sourceMappingURL=trusted-controls-activated.d.ts.map

package/dist/methods/port/trusted-controls-activated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trusted-controls-activated.d.ts","names":[],"sources":["../../../src/methods/port/trusted-controls-activated.ts"],"mappings":";;;;;iBAOiB;;WAEN;;WAEA,SAAS;;WAET,QAAQ;;WAER;;WAEA,SAAS,SAAS;;;YAIjB;;;;;;qBAoBC,oCAAoC,iBAC/C,oCACA"}

package/dist/methods/port/trusted-controls-activated.js

@@ -0,0 +1,33 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { ArtifactId, ViewId } from "../../ids.js";
+import { TrustedControl } from "../../view.js";
+import { Viewer } from "../../interaction.js";
+import { defineMethod } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/port/trusted-controls-activated.ts
+const params = z.object({
+	artifactId: ArtifactId.schema,
+	control: TrustedControl,
+	viewer: Viewer,
+	viewId: ViewId.schema,
+	detail: z.record(z.string(), z.string()).exactOptional()
+}).register(wireRegistry, {
+	id: "PortTrustedControlsActivatedParams",
+	description: "A trusted control a person used: the artifact, control, viewer, view and detail."
+});
+/**
+* `port/trustedControls.activated`: after a trusted control's change commits, Mostra tells the
+* host that registered the `trustedControls` port, best effort and never retried (D108). The
+* change itself is durable already; this call only lets a host react at once.
+*/
+const portTrustedControlsActivatedMethod = defineMethod({
+	method: "port/trustedControls.activated",
+	direction: "instance-to-host",
+	mutating: false,
+	params,
+	result: z.unknown()
+});
+//#endregion
+export { portTrustedControlsActivatedMethod };
+
+//# sourceMappingURL=trusted-controls-activated.js.map

package/dist/methods/port/trusted-controls-activated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trusted-controls-activated.js","names":[],"sources":["../../../src/methods/port/trusted-controls-activated.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { ArtifactId, ViewId } from \"../../ids.ts\";\nimport { TrustedControl, Viewer } from \"../../interaction.ts\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\n\n/** The params of `port/trustedControls.activated` (INTERFACES §7): a person used a trusted control. */\nexport interface PortTrustedControlsActivatedParams {\n  /** The artifact. */\n  readonly artifactId: string;\n  /** The control: `submit` or `choose`. */\n  readonly control: TrustedControl;\n  /** Who used it. */\n  readonly viewer: Viewer;\n  /** The view it was used in. */\n  readonly viewId: string;\n  /** What it did: the submission it made, or the review set and candidate it chose. */\n  readonly detail?: Readonly<Record<string, string>>;\n}\n\n/** The result of `port/trustedControls.activated`; its content is ignored. */\nexport type PortTrustedControlsActivatedResult = unknown;\n\nconst params: z.ZodType<PortTrustedControlsActivatedParams> = z\n  .object({\n    artifactId: ArtifactId.schema,\n    control: TrustedControl,\n    viewer: Viewer,\n    viewId: ViewId.schema,\n    detail: z.record(z.string(), z.string()).exactOptional(),\n  })\n  .register(wireRegistry, {\n    id: \"PortTrustedControlsActivatedParams\",\n    description: \"A trusted control a person used: the artifact, control, viewer, view and detail.\",\n  });\n\n/**\n * `port/trustedControls.activated`: after a trusted control's change commits, Mostra tells the\n * host that registered the `trustedControls` port, best effort and never retried (D108). The\n * change itself is durable already; this call only lets a host react at once.\n */\nexport const portTrustedControlsActivatedMethod: MethodDefinition<\n  PortTrustedControlsActivatedParams,\n  PortTrustedControlsActivatedResult\n> = defineMethod({\n  method: \"port/trustedControls.activated\",\n  direction: \"instance-to-host\",\n  mutating: false,\n  params,\n  result: z.unknown(),\n});\n"],"mappings":";;;;;;;AAuBA,MAAM,SAAwD,EAC3D,OAAO;CACN,YAAY,WAAW;CACvB,SAAS;CACT,QAAQ;CACR,QAAQ,OAAO;CACf,QAAQ,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,cAAc;AACzD,CAAC,CAAC,CACD,SAAS,cAAc;CACtB,IAAI;CACJ,aAAa;AACf,CAAC;;;;;;AAOH,MAAa,qCAGT,aAAa;CACf,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA,QAAQ,EAAE,QAAQ;AACpB,CAAC"}

package/dist/methods/port/trusted-controls-policy.d.ts

@@ -0,0 +1,21 @@
+import { ArtifactSummary } from "../../artifact.js";
+import { ControlsPolicy } from "../../view.js";
+import "../../interaction.js";
+import { MethodDefinition } from "../../method.js";
+//#region src/methods/port/trusted-controls-policy.d.ts
+/** The params of `port/trustedControls.policy` (INTERFACES §7). */
+export interface PortTrustedControlsPolicyParams {
+  /** The artifact a frame is about to show, with the metadata of its latest version. */
+  readonly artifact: ArtifactSummary;
+}
+/** The result of `port/trustedControls.policy`: the channels and controls for the view (D108). */
+export type PortTrustedControlsPolicyResult = ControlsPolicy;
+/**
+ * `port/trustedControls.policy`: Mostra asks the host that registered the `trustedControls` port
+ * which submit channels a new view of an artifact accepts and which trusted controls its shell
+ * renders (D108). Asked once per frame load, with 5 seconds to answer; a failure narrows the view
+ * to the shell channel.
+ */
+export declare const portTrustedControlsPolicyMethod: MethodDefinition<PortTrustedControlsPolicyParams, PortTrustedControlsPolicyResult>;
+//#endregion
+//# sourceMappingURL=trusted-controls-policy.d.ts.map

package/dist/methods/port/trusted-controls-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trusted-controls-policy.d.ts","names":[],"sources":["../../../src/methods/port/trusted-controls-policy.ts"],"mappings":";;;;;;iBAOiB;;WAEN,UAAU;;;YAIT,kCAAkC;;;;;;;qBAejC,iCAAiC,iBAC5C,iCACA"}

package/dist/methods/port/trusted-controls-policy.js

@@ -0,0 +1,27 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { ArtifactSummary } from "../../artifact.js";
+import { ControlsPolicy } from "../../view.js";
+import { defineMethod } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/port/trusted-controls-policy.ts
+const params = z.object({ artifact: ArtifactSummary }).register(wireRegistry, {
+	id: "PortTrustedControlsPolicyParams",
+	description: "The artifact a frame is about to show, for its host's controls policy."
+});
+/**
+* `port/trustedControls.policy`: Mostra asks the host that registered the `trustedControls` port
+* which submit channels a new view of an artifact accepts and which trusted controls its shell
+* renders (D108). Asked once per frame load, with 5 seconds to answer; a failure narrows the view
+* to the shell channel.
+*/
+const portTrustedControlsPolicyMethod = defineMethod({
+	method: "port/trustedControls.policy",
+	direction: "instance-to-host",
+	mutating: false,
+	params,
+	result: ControlsPolicy
+});
+//#endregion
+export { portTrustedControlsPolicyMethod };
+
+//# sourceMappingURL=trusted-controls-policy.js.map

package/dist/methods/port/trusted-controls-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trusted-controls-policy.js","names":[],"sources":["../../../src/methods/port/trusted-controls-policy.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { ArtifactSummary } from \"../../artifact.ts\";\nimport { ControlsPolicy } from \"../../interaction.ts\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\n\n/** The params of `port/trustedControls.policy` (INTERFACES §7). */\nexport interface PortTrustedControlsPolicyParams {\n  /** The artifact a frame is about to show, with the metadata of its latest version. */\n  readonly artifact: ArtifactSummary;\n}\n\n/** The result of `port/trustedControls.policy`: the channels and controls for the view (D108). */\nexport type PortTrustedControlsPolicyResult = ControlsPolicy;\n\nconst params: z.ZodType<PortTrustedControlsPolicyParams> = z\n  .object({ artifact: ArtifactSummary })\n  .register(wireRegistry, {\n    id: \"PortTrustedControlsPolicyParams\",\n    description: \"The artifact a frame is about to show, for its host's controls policy.\",\n  });\n\n/**\n * `port/trustedControls.policy`: Mostra asks the host that registered the `trustedControls` port\n * which submit channels a new view of an artifact accepts and which trusted controls its shell\n * renders (D108). Asked once per frame load, with 5 seconds to answer; a failure narrows the view\n * to the shell channel.\n */\nexport const portTrustedControlsPolicyMethod: MethodDefinition<\n  PortTrustedControlsPolicyParams,\n  PortTrustedControlsPolicyResult\n> = defineMethod({\n  method: \"port/trustedControls.policy\",\n  direction: \"instance-to-host\",\n  mutating: false,\n  params,\n  result: ControlsPolicy,\n});\n"],"mappings":";;;;;;AAeA,MAAM,SAAqD,EACxD,OAAO,EAAE,UAAU,gBAAgB,CAAC,CAAC,CACrC,SAAS,cAAc;CACtB,IAAI;CACJ,aAAa;AACf,CAAC;;;;;;;AAQH,MAAa,kCAGT,aAAa;CACf,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA,QAAQ;AACV,CAAC"}

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

@@ -0,0 +1,32 @@
+import { ArtifactRef } from "../../artifact.js";
+import { Results } from "../../interaction.js";
+import { MethodDefinition } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/results/get.d.ts
+/** The params of `results/get` (INTERFACES §6, §8). */
+export interface ResultsGetParams {
+  /** The artifact whose submission to read. */
+  readonly artifact: ArtifactRef;
+  /** The submission to read; absent: the artifact's latest. */
+  readonly submission?: string;
+  /** `json` (the default): the Results structure; `md`: Markdown for agents to read. */
+  readonly format?: "json" | "md";
+}
+/** Results rendered as Markdown (ROUND-2 §1.1). */
+export interface ResultsMarkdown {
+  /** The submission rendered. */
+  readonly submissionId: string;
+  /** The Markdown: a header with IDs, answers by label, choices, comments, actions, signals, orphans. */
+  readonly markdown: string;
+}
+/** The result of `results/get`: the Results structure, or its Markdown for `format: "md"`. */
+export type ResultsGetResult = Results | ResultsMarkdown;
+/** The Zod schema of the `ResultsMarkdown` type. */
+export declare const ResultsMarkdown: z.ZodType<ResultsMarkdown>;
+/**
+ * `results/get`: the complete submission (INTERFACES §8), as JSON or as Markdown. Fails with
+ * `MOSTRA_SUBMIT_NOT_FOUND` when the artifact has no such submission yet.
+ */
+export declare const resultsGetMethod: MethodDefinition<ResultsGetParams, ResultsGetResult>;
+//#endregion
+//# sourceMappingURL=get.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","names":[],"sources":["../../../src/methods/results/get.ts"],"mappings":";;;;;;iBAQiB;;WAEN,UAAU;;WAEV;;WAEA;;;iBAIM;;WAEN;;WAEA;;;YAIC,mBAAmB,UAAU;;qBAW5B,iBAAiB,EAAE,QAAQ;;;;;qBAe3B,kBAAkB,iBAAiB,kBAAkB"}

package/dist/methods/results/get.js

@@ -0,0 +1,36 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { SubmissionId } from "../../ids.js";
+import { ArtifactRef } from "../../artifact.js";
+import { Results } from "../../interaction.js";
+import { defineMethod } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/results/get.ts
+const params = z.object({
+	artifact: ArtifactRef,
+	submission: SubmissionId.schema.exactOptional(),
+	format: z.enum(["json", "md"]).exactOptional()
+}).register(wireRegistry, { id: "ResultsGetParams" });
+/** The Zod schema of the `ResultsMarkdown` type. */
+const ResultsMarkdown = z.object({
+	submissionId: SubmissionId.schema,
+	markdown: z.string()
+}).register(wireRegistry, {
+	id: "ResultsMarkdown",
+	description: "A submission's results as Markdown for agents."
+});
+const result = z.union([Results, ResultsMarkdown]).register(wireRegistry, { id: "ResultsGetResult" });
+/**
+* `results/get`: the complete submission (INTERFACES §8), as JSON or as Markdown. Fails with
+* `MOSTRA_SUBMIT_NOT_FOUND` when the artifact has no such submission yet.
+*/
+const resultsGetMethod = defineMethod({
+	method: "results/get",
+	direction: "client-to-instance",
+	mutating: false,
+	params,
+	result
+});
+//#endregion
+export { ResultsMarkdown, resultsGetMethod };
+
+//# sourceMappingURL=get.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","names":[],"sources":["../../../src/methods/results/get.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { ArtifactRef } from \"../../artifact.ts\";\nimport { SubmissionId } from \"../../ids.ts\";\nimport { Results } from \"../../interaction.ts\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\n\n/** The params of `results/get` (INTERFACES §6, §8). */\nexport interface ResultsGetParams {\n  /** The artifact whose submission to read. */\n  readonly artifact: ArtifactRef;\n  /** The submission to read; absent: the artifact's latest. */\n  readonly submission?: string;\n  /** `json` (the default): the Results structure; `md`: Markdown for agents to read. */\n  readonly format?: \"json\" | \"md\";\n}\n\n/** Results rendered as Markdown (ROUND-2 §1.1). */\nexport interface ResultsMarkdown {\n  /** The submission rendered. */\n  readonly submissionId: string;\n  /** The Markdown: a header with IDs, answers by label, choices, comments, actions, signals, orphans. */\n  readonly markdown: string;\n}\n\n/** The result of `results/get`: the Results structure, or its Markdown for `format: \"md\"`. */\nexport type ResultsGetResult = Results | ResultsMarkdown;\n\nconst params: z.ZodType<ResultsGetParams> = z\n  .object({\n    artifact: ArtifactRef,\n    submission: SubmissionId.schema.exactOptional(),\n    format: z.enum([\"json\", \"md\"]).exactOptional(),\n  })\n  .register(wireRegistry, { id: \"ResultsGetParams\" });\n\n/** The Zod schema of the `ResultsMarkdown` type. */\nexport const ResultsMarkdown: z.ZodType<ResultsMarkdown> = z\n  .object({ submissionId: SubmissionId.schema, markdown: z.string() })\n  .register(wireRegistry, {\n    id: \"ResultsMarkdown\",\n    description: \"A submission's results as Markdown for agents.\",\n  });\n\nconst result: z.ZodType<ResultsGetResult> = z\n  .union([Results, ResultsMarkdown])\n  .register(wireRegistry, { id: \"ResultsGetResult\" });\n\n/**\n * `results/get`: the complete submission (INTERFACES §8), as JSON or as Markdown. Fails with\n * `MOSTRA_SUBMIT_NOT_FOUND` when the artifact has no such submission yet.\n */\nexport const resultsGetMethod: MethodDefinition<ResultsGetParams, ResultsGetResult> = defineMethod({\n  method: \"results/get\",\n  direction: \"client-to-instance\",\n  mutating: false,\n  params,\n  result,\n});\n"],"mappings":";;;;;;;AA4BA,MAAM,SAAsC,EACzC,OAAO;CACN,UAAU;CACV,YAAY,aAAa,OAAO,cAAc;CAC9C,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,cAAc;AAC/C,CAAC,CAAC,CACD,SAAS,cAAc,EAAE,IAAI,mBAAmB,CAAC;;AAGpD,MAAa,kBAA8C,EACxD,OAAO;CAAE,cAAc,aAAa;CAAQ,UAAU,EAAE,OAAO;AAAE,CAAC,CAAC,CACnE,SAAS,cAAc;CACtB,IAAI;CACJ,aAAa;AACf,CAAC;AAEH,MAAM,SAAsC,EACzC,MAAM,CAAC,SAAS,eAAe,CAAC,CAAC,CACjC,SAAS,cAAc,EAAE,IAAI,mBAAmB,CAAC;;;;;AAMpD,MAAa,mBAAyE,aAAa;CACjG,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA;AACF,CAAC"}

package/dist/methods/secret/delete.d.ts

@@ -0,0 +1,22 @@
+import { ArtifactRef } from "../../artifact.js";
+import { MethodDefinition } from "../../method.js";
+//#region src/methods/secret/delete.d.ts
+/** The params of `secret/delete` (INTERFACES §6). */
+export interface SecretDeleteParams {
+  /** The secret's name. */
+  readonly name: string;
+  /** The artifact whose own secret to delete; absent: the home's shared one. */
+  readonly artifact?: ArtifactRef;
+}
+/** The result of `secret/delete`. */
+export interface SecretDeleteResult {
+  /** Whether a secret was there to delete. */
+  readonly deleted: boolean;
+}
+/**
+ * `secret/delete`: removes a secret from the home's store. Deleting one that isn't there succeeds
+ * with `deleted: false`, so the method is idempotent and takes no `requestId`.
+ */
+export declare const secretDeleteMethod: MethodDefinition<SecretDeleteParams, SecretDeleteResult>;
+//#endregion
+//# sourceMappingURL=delete.d.ts.map

package/dist/methods/secret/delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.ts","names":[],"sources":["../../../src/methods/secret/delete.ts"],"mappings":";;;;iBAOiB;;WAEN;;WAEA,WAAW;;;iBAIL;;WAEN;;;;;;qBAkBE,oBAAoB,iBAAiB,oBAAoB"}

package/dist/methods/secret/delete.js

@@ -0,0 +1,32 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { SECRET_NAME_PATTERN } from "../../actions.js";
+import { ArtifactRef } from "../../artifact.js";
+import { defineMethod } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/secret/delete.ts
+const params = z.object({
+	name: z.string().regex(SECRET_NAME_PATTERN),
+	artifact: ArtifactRef.exactOptional()
+}).register(wireRegistry, {
+	id: "SecretDeleteParams",
+	description: "The secret to delete."
+});
+const result = z.object({ deleted: z.boolean() }).register(wireRegistry, {
+	id: "SecretDeleteResult",
+	description: "Whether a secret was deleted."
+});
+/**
+* `secret/delete`: removes a secret from the home's store. Deleting one that isn't there succeeds
+* with `deleted: false`, so the method is idempotent and takes no `requestId`.
+*/
+const secretDeleteMethod = defineMethod({
+	method: "secret/delete",
+	direction: "client-to-instance",
+	mutating: false,
+	params,
+	result
+});
+//#endregion
+export { secretDeleteMethod };
+
+//# sourceMappingURL=delete.js.map

package/dist/methods/secret/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","names":[],"sources":["../../../src/methods/secret/delete.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { SECRET_NAME_PATTERN } from \"../../actions.ts\";\nimport { ArtifactRef } from \"../../artifact.ts\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\n\n/** The params of `secret/delete` (INTERFACES §6). */\nexport interface SecretDeleteParams {\n  /** The secret's name. */\n  readonly name: string;\n  /** The artifact whose own secret to delete; absent: the home's shared one. */\n  readonly artifact?: ArtifactRef;\n}\n\n/** The result of `secret/delete`. */\nexport interface SecretDeleteResult {\n  /** Whether a secret was there to delete. */\n  readonly deleted: boolean;\n}\n\nconst params: z.ZodType<SecretDeleteParams> = z\n  .object({ name: z.string().regex(SECRET_NAME_PATTERN), artifact: ArtifactRef.exactOptional() })\n  .register(wireRegistry, { id: \"SecretDeleteParams\", description: \"The secret to delete.\" });\n\nconst result: z.ZodType<SecretDeleteResult> = z\n  .object({ deleted: z.boolean() })\n  .register(wireRegistry, {\n    id: \"SecretDeleteResult\",\n    description: \"Whether a secret was deleted.\",\n  });\n\n/**\n * `secret/delete`: removes a secret from the home's store. Deleting one that isn't there succeeds\n * with `deleted: false`, so the method is idempotent and takes no `requestId`.\n */\nexport const secretDeleteMethod: MethodDefinition<SecretDeleteParams, SecretDeleteResult> =\n  defineMethod({\n    method: \"secret/delete\",\n    direction: \"client-to-instance\",\n    mutating: false,\n    params,\n    result,\n  });\n"],"mappings":";;;;;;AAoBA,MAAM,SAAwC,EAC3C,OAAO;CAAE,MAAM,EAAE,OAAO,CAAC,CAAC,MAAM,mBAAmB;CAAG,UAAU,YAAY,cAAc;AAAE,CAAC,CAAC,CAC9F,SAAS,cAAc;CAAE,IAAI;CAAsB,aAAa;AAAwB,CAAC;AAE5F,MAAM,SAAwC,EAC3C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,CAChC,SAAS,cAAc;CACtB,IAAI;CACJ,aAAa;AACf,CAAC;;;;;AAMH,MAAa,qBACX,aAAa;CACX,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA;AACF,CAAC"}

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

@@ -0,0 +1,21 @@
+import { ArtifactRef } from "../../artifact.js";
+import { MethodDefinition } from "../../method.js";
+import { SecretEntry } from "./set.js";
+//#region src/methods/secret/list.d.ts
+/** The params of `secret/list` (INTERFACES §6). */
+export interface SecretListParams {
+  /** Also list this artifact's own secrets; the home's shared ones are always listed. */
+  readonly artifact?: ArtifactRef;
+}
+/** The result of `secret/list`: names and scopes, never values. */
+export interface SecretListResult {
+  /** The secrets, home ones first. */
+  readonly secrets: readonly SecretEntry[];
+}
+/**
+ * `secret/list`: the names of the home's shared secrets, and of an artifact's own when one is
+ * named, with their scopes; a value is never returned (D44).
+ */
+export declare const secretListMethod: MethodDefinition<SecretListParams, SecretListResult>;
+//#endregion
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","names":[],"sources":["../../../src/methods/secret/list.ts"],"mappings":";;;;;iBAOiB;;WAEN,WAAW;;;iBAIL;;WAEN,kBAAkB;;;;;;qBAkBhB,kBAAkB,iBAAiB,kBAAkB"}

package/dist/methods/secret/list.js

@@ -0,0 +1,29 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { ArtifactRef } from "../../artifact.js";
+import { defineMethod } from "../../method.js";
+import { SecretEntry } from "./set.js";
+import * as z from "zod";
+//#region src/methods/secret/list.ts
+const params = z.object({ artifact: ArtifactRef.exactOptional() }).register(wireRegistry, {
+	id: "SecretListParams",
+	description: "The artifact whose secrets to list."
+});
+const result = z.object({ secrets: z.array(SecretEntry).readonly() }).register(wireRegistry, {
+	id: "SecretListResult",
+	description: "Secrets by name and scope."
+});
+/**
+* `secret/list`: the names of the home's shared secrets, and of an artifact's own when one is
+* named, with their scopes; a value is never returned (D44).
+*/
+const secretListMethod = defineMethod({
+	method: "secret/list",
+	direction: "client-to-instance",
+	mutating: false,
+	params,
+	result
+});
+//#endregion
+export { secretListMethod };
+
+//# sourceMappingURL=list.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","names":[],"sources":["../../../src/methods/secret/list.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { ArtifactRef } from \"../../artifact.ts\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\nimport { SecretEntry } from \"./set.ts\";\n\n/** The params of `secret/list` (INTERFACES §6). */\nexport interface SecretListParams {\n  /** Also list this artifact's own secrets; the home's shared ones are always listed. */\n  readonly artifact?: ArtifactRef;\n}\n\n/** The result of `secret/list`: names and scopes, never values. */\nexport interface SecretListResult {\n  /** The secrets, home ones first. */\n  readonly secrets: readonly SecretEntry[];\n}\n\nconst params: z.ZodType<SecretListParams> = z\n  .object({ artifact: ArtifactRef.exactOptional() })\n  .register(wireRegistry, {\n    id: \"SecretListParams\",\n    description: \"The artifact whose secrets to list.\",\n  });\n\nconst result: z.ZodType<SecretListResult> = z\n  .object({ secrets: z.array(SecretEntry).readonly() })\n  .register(wireRegistry, { id: \"SecretListResult\", description: \"Secrets by name and scope.\" });\n\n/**\n * `secret/list`: the names of the home's shared secrets, and of an artifact's own when one is\n * named, with their scopes; a value is never returned (D44).\n */\nexport const secretListMethod: MethodDefinition<SecretListParams, SecretListResult> = defineMethod({\n  method: \"secret/list\",\n  direction: \"client-to-instance\",\n  mutating: false,\n  params,\n  result,\n});\n"],"mappings":";;;;;;AAkBA,MAAM,SAAsC,EACzC,OAAO,EAAE,UAAU,YAAY,cAAc,EAAE,CAAC,CAAC,CACjD,SAAS,cAAc;CACtB,IAAI;CACJ,aAAa;AACf,CAAC;AAEH,MAAM,SAAsC,EACzC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CACpD,SAAS,cAAc;CAAE,IAAI;CAAoB,aAAa;AAA6B,CAAC;;;;;AAM/F,MAAa,mBAAyE,aAAa;CACjG,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA;AACF,CAAC"}

package/dist/methods/secret/set.d.ts

@@ -0,0 +1,37 @@
+import { ArtifactRef } from "../../artifact.js";
+import { MethodDefinition } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/secret/set.d.ts
+/** The params of `secret/set` (INTERFACES §6, D44). */
+export interface SecretSetParams {
+  /** Letters, digits, `_`, `.` and `-`, starting with a letter or `_`, at most 128 characters. */
+  readonly name: string;
+  /** The value, at most 64 KiB of UTF-8. Never returned by any method. */
+  readonly value: string;
+  /** The artifact the secret belongs to; absent: shared by every artifact of the home. */
+  readonly artifact?: ArtifactRef;
+}
+/** Where a secret lives. */
+export interface SecretEntry {
+  /** The secret's name. */
+  readonly name: string;
+  /** `artifact` for one artifact's secret, `home` for one every artifact shares. */
+  readonly scope: "artifact" | "home";
+  /** The artifact, for `scope: "artifact"`. */
+  readonly artifactId?: string;
+  /** When it was last set. */
+  readonly updatedAt: string;
+}
+/** The Zod schema of the `SecretEntry` type. */
+export declare const SecretEntry: z.ZodType<SecretEntry>;
+/** The result of `secret/set`: the secret, without its value. */
+export type SecretSetResult = SecretEntry;
+/**
+ * `secret/set`: stores a named secret in the home's owner-only store (D44), for one artifact or
+ * for every artifact of the home; server code reads it with `secret(name)`. Setting it again
+ * replaces the value. Setting is idempotent by nature, so it takes no `requestId`: the ledger
+ * never records anything derived from a secret's value.
+ */
+export declare const secretSetMethod: MethodDefinition<SecretSetParams, SecretSetResult>;
+//#endregion
+//# sourceMappingURL=set.d.ts.map

package/dist/methods/secret/set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.d.ts","names":[],"sources":["../../../src/methods/secret/set.ts"],"mappings":";;;;;iBAOiB;;WAEN;;WAEA;;WAEA,WAAW;;;iBAIL;;WAEN;;WAEA;;WAEA;;WAEA;;;qBAIE,aAAa,EAAE,QAAQ;;YAaxB,kBAAkB;;;;;;;qBAoBjB,iBAAiB,iBAAiB,iBAAiB"}

package/dist/methods/secret/set.js

@@ -0,0 +1,41 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { SECRET_NAME_PATTERN, SECRET_VALUE_MAX } from "../../actions.js";
+import { ArtifactRef } from "../../artifact.js";
+import { defineMethod } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/secret/set.ts
+/** The Zod schema of the `SecretEntry` type. */
+const SecretEntry = z.object({
+	name: z.string(),
+	scope: z.enum(["artifact", "home"]),
+	artifactId: z.string().exactOptional(),
+	updatedAt: z.string()
+}).register(wireRegistry, {
+	id: "SecretEntry",
+	description: "A secret's name, scope and when it was set; never its value."
+});
+const params = z.object({
+	name: z.string().regex(SECRET_NAME_PATTERN),
+	value: z.string().min(1).max(SECRET_VALUE_MAX),
+	artifact: ArtifactRef.exactOptional()
+}).register(wireRegistry, {
+	id: "SecretSetParams",
+	description: "A secret's name, value and optional artifact scope."
+});
+/**
+* `secret/set`: stores a named secret in the home's owner-only store (D44), for one artifact or
+* for every artifact of the home; server code reads it with `secret(name)`. Setting it again
+* replaces the value. Setting is idempotent by nature, so it takes no `requestId`: the ledger
+* never records anything derived from a secret's value.
+*/
+const secretSetMethod = defineMethod({
+	method: "secret/set",
+	direction: "client-to-instance",
+	mutating: false,
+	params,
+	result: SecretEntry
+});
+//#endregion
+export { SecretEntry, secretSetMethod };
+
+//# sourceMappingURL=set.js.map