@shipeasy/openapi 1.0.0 → 1.2.0

package/dist/resources/experiments.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { experimentCreateSchema, experimentUpdateSchema } from '@shipeasy/core/schemas/experiments';
-import { PageQuery, Page } from '@shipeasy/core/pagination';
+import { experimentCreateSchema, experimentUpdateSchema } from '../schemas/experiments.js';
+import { PageQuery, Page } from '../schemas/pagination.js';
 import { Transport } from '../transport.js';
 
 /**
@@ -59,6 +59,8 @@ interface ExperimentsClient {
     start(id: string): Promise<Experiment>;
     stop(id: string): Promise<Experiment>;
     archive(id: string): Promise<Experiment>;
+    /** Restore a soft-deleted (archived) experiment back to `draft`. */
+    restore(id: string): Promise<Experiment>;
     setMetrics(id: string, input: ExperimentMetricsInput): Promise<unknown>;
     results(id: string): Promise<ExperimentResult[]>;
     timeseries(id: string, metric?: string): Promise<ExperimentTimeseriesPoint[]>;
@@ -80,7 +82,16 @@ declare const experimentsResource: {
         readonly create: z.ZodObject<{
             name: z.ZodString;
             description: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            hypothesis: z.ZodDefault<z.ZodNullable<z.ZodString>>;
             tag: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            owner_email: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            audience: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            bucket_by: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+                user_id: "user_id";
+                session_id: "session_id";
+                device_id: "device_id";
+            }>>>;
+            folder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             universe: z.ZodString;
             targeting_gate: z.ZodDefault<z.ZodNullable<z.ZodString>>;
             allocation_pct: z.ZodDefault<z.ZodNumber>;
@@ -99,11 +110,28 @@ declare const experimentsResource: {
             min_runtime_days: z.ZodDefault<z.ZodNumber>;
             min_sample_size: z.ZodDefault<z.ZodNumber>;
             sequential_testing: z.ZodDefault<z.ZodBoolean>;
+            goal_metric: z.ZodOptional<z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+                query: z.ZodString;
+            }, z.core.$strip>>;
+            guardrail_metrics: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+                query: z.ZodString;
+            }, z.core.$strip>>>;
         }, z.core.$strip>;
         readonly update: z.ZodObject<{
             name: z.ZodOptional<z.ZodString>;
             description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            hypothesis: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             tag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            owner_email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            audience: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            bucket_by: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                user_id: "user_id";
+                session_id: "session_id";
+                device_id: "device_id";
+            }>>>;
+            folder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             targeting_gate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             allocation_pct: z.ZodOptional<z.ZodNumber>;
             salt: z.ZodOptional<z.ZodString>;
@@ -122,6 +150,14 @@ declare const experimentsResource: {
             min_runtime_days: z.ZodOptional<z.ZodNumber>;
             min_sample_size: z.ZodOptional<z.ZodNumber>;
             sequential_testing: z.ZodOptional<z.ZodBoolean>;
+            goal_metric: z.ZodOptional<z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+                query: z.ZodString;
+            }, z.core.$strip>>;
+            guardrail_metrics: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+                query: z.ZodString;
+            }, z.core.$strip>>>;
         }, z.core.$strip>;
     };
     readonly actions: readonly [{
@@ -133,6 +169,9 @@ declare const experimentsResource: {
     }, {
         readonly name: "archive";
         readonly description: "Archive a stopped experiment";
+    }, {
+        readonly name: "restore";
+        readonly description: "Restore an archived (never-started) experiment to draft";
     }, {
         readonly name: "reanalyze";
         readonly description: "Re-run analysis pass for the experiment";
@@ -148,7 +187,16 @@ declare const experimentsResource: {
                 id: z.ZodString;
                 name: z.ZodString;
                 description: z.ZodNullable<z.ZodString>;
+                hypothesis: z.ZodNullable<z.ZodString>;
                 tag: z.ZodNullable<z.ZodString>;
+                ownerEmail: z.ZodNullable<z.ZodString>;
+                audience: z.ZodNullable<z.ZodString>;
+                bucketBy: z.ZodNullable<z.ZodEnum<{
+                    user_id: "user_id";
+                    session_id: "session_id";
+                    device_id: "device_id";
+                }>>;
+                folder: z.ZodNullable<z.ZodString>;
                 status: z.ZodEnum<{
                     draft: "draft";
                     running: "running";
@@ -226,7 +274,16 @@ declare const experimentsResource: {
             id: z.ZodString;
             name: z.ZodString;
             description: z.ZodNullable<z.ZodString>;
+            hypothesis: z.ZodNullable<z.ZodString>;
             tag: z.ZodNullable<z.ZodString>;
+            ownerEmail: z.ZodNullable<z.ZodString>;
+            audience: z.ZodNullable<z.ZodString>;
+            bucketBy: z.ZodNullable<z.ZodEnum<{
+                user_id: "user_id";
+                session_id: "session_id";
+                device_id: "device_id";
+            }>>;
+            folder: z.ZodNullable<z.ZodString>;
             status: z.ZodEnum<{
                 draft: "draft";
                 running: "running";
@@ -296,7 +353,16 @@ declare const experimentsResource: {
         readonly request: z.ZodObject<{
             name: z.ZodString;
             description: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            hypothesis: z.ZodDefault<z.ZodNullable<z.ZodString>>;
             tag: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            owner_email: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            audience: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            bucket_by: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+                user_id: "user_id";
+                session_id: "session_id";
+                device_id: "device_id";
+            }>>>;
+            folder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             universe: z.ZodString;
             targeting_gate: z.ZodDefault<z.ZodNullable<z.ZodString>>;
             allocation_pct: z.ZodDefault<z.ZodNumber>;
@@ -315,6 +381,14 @@ declare const experimentsResource: {
             min_runtime_days: z.ZodDefault<z.ZodNumber>;
             min_sample_size: z.ZodDefault<z.ZodNumber>;
             sequential_testing: z.ZodDefault<z.ZodBoolean>;
+            goal_metric: z.ZodOptional<z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+                query: z.ZodString;
+            }, z.core.$strip>>;
+            guardrail_metrics: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+                query: z.ZodString;
+            }, z.core.$strip>>>;
         }, z.core.$strip>;
         readonly response: z.ZodObject<{
             id: z.ZodString;
@@ -418,7 +492,16 @@ declare const experimentsResource: {
         readonly request: z.ZodObject<{
             name: z.ZodOptional<z.ZodString>;
             description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            hypothesis: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             tag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            owner_email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            audience: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            bucket_by: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                user_id: "user_id";
+                session_id: "session_id";
+                device_id: "device_id";
+            }>>>;
+            folder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             targeting_gate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             allocation_pct: z.ZodOptional<z.ZodNumber>;
             salt: z.ZodOptional<z.ZodString>;
@@ -437,6 +520,14 @@ declare const experimentsResource: {
             min_runtime_days: z.ZodOptional<z.ZodNumber>;
             min_sample_size: z.ZodOptional<z.ZodNumber>;
             sequential_testing: z.ZodOptional<z.ZodBoolean>;
+            goal_metric: z.ZodOptional<z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+                query: z.ZodString;
+            }, z.core.$strip>>;
+            guardrail_metrics: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+                query: z.ZodString;
+            }, z.core.$strip>>>;
         }, z.core.$strip>;
         readonly response: z.ZodObject<{
             id: z.ZodString;
@@ -551,6 +642,13 @@ declare const experimentsResource: {
                         readonly status: "archived";
                     };
                 };
+                readonly restore: {
+                    readonly summary: "Restore — archived → draft";
+                    readonly description: "Un-deletes a soft-deleted experiment so it can be re-completed and started. Allowed only if it never ran.";
+                    readonly value: {
+                        readonly status: "draft";
+                    };
+                };
             };
             readonly response: {
                 readonly id: "exp_01j7wb12c3d4e5f6g7h8j9k0l1";

package/dist/resources/experiments.js

@@ -1,48 +1,76 @@
 // src/resources/experiments.ts
-import { z as z2 } from "zod";
+import { z as z4 } from "zod";
+
+// src/schemas/experiments.ts
+import { z as z3 } from "zod";
 
-// ../core/src/schemas/experiments.ts
+// src/schemas/folder.ts
 import { z } from "zod";
-var experimentNameSchema = z.string().regex(/^[a-z0-9][a-z0-9_-]{0,63}$/).describe(
-  "Stable experiment key (a-z, 0-9, `_`/`-`, must start with letter/digit, max 64 chars). Used by SDKs as `Shipeasy.getExperiment(user, '<name>')`. Immutable after create."
+var folderSchema = z.string().max(256).regex(/^[a-zA-Z0-9_-]+$/, "Folder must be alphanumeric, `_` or `-` (no `/`).").nullable().optional().describe(
+  "Optional folder name used to group items in the dashboard. Part of the SDK lookup key: an item in folder `checkout` named `new-cart` is referenced as `checkout/new-cart` from the SDK."
+);
+
+// src/schemas/metric-name.ts
+import { z as z2 } from "zod";
+var metricNameSchema = z2.string().regex(/^[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?(?:\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?)?$/).max(128);
+
+// src/schemas/experiments.ts
+var experimentInlineMetricSchema = z3.object({
+  name: metricNameSchema.optional(),
+  query: z3.string().min(1).max(4096).describe("Metric DSL string, e.g. `count_users(checkout_completed)`.")
+});
+var experimentNameSchema = z3.string().regex(/^[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?(?:\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?)?$/).max(128).describe(
+  "Stable experiment key. Single segment or `folder.name` (a-z, 0-9, `_`/`-`; max 128 chars). Used by SDKs as `Shipeasy.getExperiment(user, '<name>')`. Immutable after create."
 );
-var experimentGroupSchema = z.object({
-  name: z.string().min(1).max(64).describe("Group label (e.g. `control`, `treatment_a`). Max 64 chars."),
-  weight: z.number().int().min(0).max(1e4).describe(
+var experimentGroupSchema = z3.object({
+  name: z3.string().min(1).max(64).describe("Group label (e.g. `control`, `treatment_a`). Max 64 chars."),
+  weight: z3.number().int().min(0).max(1e4).describe(
     "Allocation weight in basis points (0\u201310000). The sum across all groups must equal exactly **10000** (100%)."
   ),
-  params: z.record(z.string(), z.unknown()).default({}).describe(
+  params: z3.record(z3.string(), z3.unknown()).default({}).describe(
     "Per-group parameter values delivered to the SDK when a caller is hashed into this group. Keys must match the experiment's `params` schema."
   )
 }).describe("One variant in the experiment. Weights across all groups must sum to 10000.");
-var paramSchemaSchema = z.record(z.string(), z.enum(["string", "bool", "number"])).describe(
+var paramSchemaSchema = z3.record(z3.string(), z3.enum(["string", "bool", "number"])).describe(
   "Map of param-name \u2192 scalar type. Defines the shape of `groups[].params`. Example: `{ headline: 'string', show_cta: 'bool' }`."
 );
-var experimentCreateSchema = z.object({
+var bucketBySchema = z3.enum(["user_id", "session_id", "device_id"]).describe("Identifier used as the bucketing key. `user_id` is sticky across sessions.");
+var experimentCreateSchema = z3.object({
   name: experimentNameSchema,
-  description: z.string().max(2e3).nullable().default(null).describe("Free-form description. Max 2000 chars, markdown rendered in the dashboard."),
-  tag: z.string().max(64).nullable().default(null).describe("Optional tag used to group experiments in the dashboard."),
-  universe: z.string().min(1).describe(
+  description: z3.string().max(2e3).nullable().default(null).describe("Free-form description. Max 2000 chars, markdown rendered in the dashboard."),
+  hypothesis: z3.string().max(4e3).nullable().default(null).describe("Hypothesis statement shown in the editor. Display-only."),
+  tag: z3.string().max(64).nullable().default(null).describe("Short tag chip rendered next to the name. Display-only."),
+  owner_email: z3.string().max(254).nullable().default(null).describe("Owner email. Display-only."),
+  audience: z3.string().max(256).nullable().default(null).describe("Audience label shown in the editor. Display-only."),
+  bucket_by: bucketBySchema.nullable().default(null),
+  folder: folderSchema,
+  universe: z3.string().min(1).describe(
     "Name of an existing universe in the project. Returns `422` if the universe doesn't exist."
   ),
-  targeting_gate: z.string().nullable().default(null).describe(
+  targeting_gate: z3.string().nullable().default(null).describe(
     "Optional gate name. Only callers that pass the gate are enrolled in the experiment."
   ),
-  allocation_pct: z.number().int().min(0).max(1e4).default(0).describe(
+  allocation_pct: z3.number().int().min(0).max(1e4).default(0).describe(
     "Share of the (gated) audience allocated to the experiment, in basis points (0\u201310000 = 0%\u2013100%). `0` = unallocated. Immutable while the experiment is running."
   ),
-  salt: z.string().min(1).max(64).optional().describe("Hash salt for bucketing. Auto-generated if omitted. Immutable while running."),
+  salt: z3.string().min(1).max(64).optional().describe("Hash salt for bucketing. Auto-generated if omitted. Immutable while running."),
   params: paramSchemaSchema.default({}),
-  groups: z.array(experimentGroupSchema).min(2).describe(
+  groups: z3.array(experimentGroupSchema).min(2).describe(
     "Two or more variants. Weights must sum to exactly 10000 (100%). Immutable while running."
   ),
-  significance_threshold: z.number().min(1e-4).max(0.5).default(0.05).describe(
+  significance_threshold: z3.number().min(1e-4).max(0.5).default(0.05).describe(
     "p-value cutoff used by the analysis pass. Defaults to `0.05`. Values other than 0.05 require Pro plan or higher."
   ),
-  min_runtime_days: z.number().int().min(0).max(365).default(0).describe("Minimum days the experiment must run before results are considered conclusive."),
-  min_sample_size: z.number().int().min(1).default(100).describe("Minimum exposures per group before results are considered conclusive."),
-  sequential_testing: z.boolean().default(false).describe(
+  min_runtime_days: z3.number().int().min(0).max(365).default(0).describe("Minimum days the experiment must run before results are considered conclusive."),
+  min_sample_size: z3.number().int().min(1).default(100).describe("Minimum exposures per group before results are considered conclusive."),
+  sequential_testing: z3.boolean().default(false).describe(
     "Enable sequential testing (always-valid p-values). Requires Premium plan or higher."
+  ),
+  goal_metric: experimentInlineMetricSchema.optional().describe(
+    "Single goal metric defined inline as a DSL query. The underlying event is auto-created if missing."
+  ),
+  guardrail_metrics: z3.array(experimentInlineMetricSchema).max(10).default([]).describe(
+    "Up to 10 guardrail metrics defined inline. Each is upserted (event + metric) and attached with role=guardrail."
   )
 }).refine(
   (e) => e.groups.reduce((s, g) => s + g.weight, 0) === 1e4,
@@ -50,35 +78,42 @@ var experimentCreateSchema = z.object({
 ).describe(
   "Body for `POST /api/admin/experiments`. `name`, `universe`, and `groups` (\u22652, weights sum to 10000) required."
 );
-var experimentUpdateSchema = z.object({
+var experimentUpdateSchema = z3.object({
   name: experimentNameSchema.optional(),
-  description: z.string().max(2e3).nullable().optional(),
-  tag: z.string().max(64).nullable().optional(),
-  targeting_gate: z.string().nullable().optional(),
-  allocation_pct: z.number().int().min(0).max(1e4).optional().describe("Basis-points allocation (0\u201310000). Immutable while the experiment is running."),
-  salt: z.string().min(1).max(64).optional().describe("Hash salt. Immutable while running."),
-  universe: z.string().optional().describe(
+  description: z3.string().max(2e3).nullable().optional(),
+  hypothesis: z3.string().max(4e3).nullable().optional(),
+  tag: z3.string().max(64).nullable().optional(),
+  owner_email: z3.string().max(254).nullable().optional(),
+  audience: z3.string().max(256).nullable().optional(),
+  bucket_by: bucketBySchema.nullable().optional(),
+  folder: folderSchema,
+  targeting_gate: z3.string().nullable().optional(),
+  allocation_pct: z3.number().int().min(0).max(1e4).optional().describe("Basis-points allocation (0\u201310000). Immutable while the experiment is running."),
+  salt: z3.string().min(1).max(64).optional().describe("Hash salt. Immutable while running."),
+  universe: z3.string().optional().describe(
     "New universe name. Immutable while running. Returns `422` if the universe doesn't exist."
   ),
   params: paramSchemaSchema.optional(),
-  groups: z.array(experimentGroupSchema).min(2).optional().describe("Replacement groups. Weights must sum to 10000. Immutable while running."),
-  significance_threshold: z.number().min(1e-4).max(0.5).optional(),
-  min_runtime_days: z.number().int().min(0).max(365).optional(),
-  min_sample_size: z.number().int().min(1).optional(),
-  sequential_testing: z.boolean().optional()
+  groups: z3.array(experimentGroupSchema).min(2).optional().describe("Replacement groups. Weights must sum to 10000. Immutable while running."),
+  significance_threshold: z3.number().min(1e-4).max(0.5).optional(),
+  min_runtime_days: z3.number().int().min(0).max(365).optional(),
+  min_sample_size: z3.number().int().min(1).optional(),
+  sequential_testing: z3.boolean().optional(),
+  goal_metric: experimentInlineMetricSchema.optional().describe("Replaces the goal metric (event auto-upserted)."),
+  guardrail_metrics: z3.array(experimentInlineMetricSchema).max(10).optional().describe("Replaces the guardrail set wholesale (event auto-upserted per entry).")
 }).describe(
   "Body for `PATCH /api/admin/experiments/{id}`. Partial \u2014 only supplied fields change. `allocation_pct`, `groups`, `salt`, `universe`, `params` are immutable while the experiment is running (stop first)."
 );
-var experimentStatusUpdateSchema = z.object({
-  status: z.enum(["draft", "running", "stopped", "archived"]).describe(
-    "Target status. Allowed transitions: `draft \u2192 running`, `running \u2192 stopped`, `stopped \u2192 archived`, `draft \u2192 archived`. Restarting an archived experiment is not allowed."
+var experimentStatusUpdateSchema = z3.object({
+  status: z3.enum(["draft", "running", "stopped", "archived"]).describe(
+    "Target status. Allowed transitions: `draft \u2192 running`, `running \u2192 stopped`, `stopped \u2192 archived`, `draft \u2192 archived`, and `archived \u2192 draft` (restore \u2014 only if the experiment never started). Restarting an archived experiment directly is not allowed; restore it to draft first, then start."
   )
 }).describe("Body for `POST /api/admin/experiments/{id}/status`.");
-var experimentMetricsUpdateSchema = z.object({
-  metrics: z.array(
-    z.object({
-      metric_id: z.string().describe("Existing metric id in the project."),
-      role: z.enum(["goal", "guardrail", "secondary"]).describe(
+var experimentMetricsUpdateSchema = z3.object({
+  metrics: z3.array(
+    z3.object({
+      metric_id: z3.string().describe("Existing metric id in the project."),
+      role: z3.enum(["goal", "guardrail", "secondary"]).describe(
         "Metric role. `goal` drives the decision, `guardrail` blocks ship if degraded, `secondary` is informational."
       )
     })
@@ -86,76 +121,81 @@ var experimentMetricsUpdateSchema = z.object({
 }).describe(
   "Body for `POST /api/admin/experiments/{id}/metrics`. Replaces the experiment's metric attachments wholesale. Returns `422` if any `metric_id` is unknown."
 );
-var experimentResponseSchema = z.object({
-  id: z.string().describe("Stable opaque experiment id (`exp_\u2026`)."),
+var experimentResponseSchema = z3.object({
+  id: z3.string().describe("Stable opaque experiment id (`exp_\u2026`)."),
   name: experimentNameSchema,
-  description: z.string().nullable(),
-  tag: z.string().nullable(),
-  status: z.enum(["draft", "running", "stopped", "archived"]),
-  universe: z.string().describe("Universe name this experiment draws from."),
-  targetingGate: z.string().nullable(),
-  allocationPct: z.number().int().describe("Allocation in basis points (0\u201310000)."),
-  salt: z.string(),
-  params: z.record(z.string(), z.enum(["string", "bool", "number"])),
-  groups: z.array(experimentGroupSchema),
-  significanceThreshold: z.number(),
-  minRuntimeDays: z.number().int(),
-  minSampleSize: z.number().int(),
-  sequentialTesting: z.boolean(),
-  startedAt: z.string().nullable().describe("ISO-8601 timestamp the experiment last transitioned to `running`, or `null`."),
-  stoppedAt: z.string().nullable().optional(),
-  updatedAt: z.string()
+  description: z3.string().nullable(),
+  hypothesis: z3.string().nullable(),
+  tag: z3.string().nullable(),
+  ownerEmail: z3.string().nullable(),
+  audience: z3.string().nullable(),
+  bucketBy: bucketBySchema.nullable(),
+  folder: z3.string().nullable(),
+  status: z3.enum(["draft", "running", "stopped", "archived"]),
+  universe: z3.string().describe("Universe name this experiment draws from."),
+  targetingGate: z3.string().nullable(),
+  allocationPct: z3.number().int().describe("Allocation in basis points (0\u201310000)."),
+  salt: z3.string(),
+  params: z3.record(z3.string(), z3.enum(["string", "bool", "number"])),
+  groups: z3.array(experimentGroupSchema),
+  significanceThreshold: z3.number(),
+  minRuntimeDays: z3.number().int(),
+  minSampleSize: z3.number().int(),
+  sequentialTesting: z3.boolean(),
+  startedAt: z3.string().nullable().describe("ISO-8601 timestamp the experiment last transitioned to `running`, or `null`."),
+  stoppedAt: z3.string().nullable().optional(),
+  updatedAt: z3.string()
 });
-var experimentCreateResponseSchema = z.object({
-  id: z.string().describe("Newly assigned experiment id."),
+var experimentCreateResponseSchema = z3.object({
+  id: z3.string().describe("Newly assigned experiment id."),
   name: experimentNameSchema
 });
-var experimentUpdateResponseSchema = z.object({
-  id: z.string().describe("Experiment id that was updated.")
+var experimentUpdateResponseSchema = z3.object({
+  id: z3.string().describe("Experiment id that was updated.")
 });
-var experimentDeleteResponseSchema = z.object({ ok: z.literal(true) });
-var experimentStatusResponseSchema = z.object({
-  id: z.string(),
-  status: z.enum(["draft", "running", "stopped", "archived"])
+var experimentDeleteResponseSchema = z3.object({ ok: z3.literal(true) });
+var experimentStatusResponseSchema = z3.object({
+  id: z3.string(),
+  status: z3.enum(["draft", "running", "stopped", "archived"])
 });
-var experimentMetricsResponseSchema = z.object({
-  id: z.string(),
-  metrics: z.array(
-    z.object({
-      metric_id: z.string(),
-      role: z.enum(["goal", "guardrail", "secondary"])
+var experimentMetricsResponseSchema = z3.object({
+  id: z3.string(),
+  metrics: z3.array(
+    z3.object({
+      metric_id: z3.string(),
+      role: z3.enum(["goal", "guardrail", "secondary"])
     })
   )
 });
-var experimentResultRowSchema = z.object({
-  metric: z.string(),
-  group_name: z.string(),
-  ds: z.string().describe("Date slice (`YYYY-MM-DD`)."),
-  n: z.number().nullable(),
-  mean: z.number().nullable(),
-  delta_pct: z.number().nullable(),
-  p_value: z.number().nullable(),
-  srm_detected: z.number().nullable().describe("`1` if sample-ratio mismatch detected, else `0`.")
+var experimentResultRowSchema = z3.object({
+  metric: z3.string(),
+  group_name: z3.string(),
+  ds: z3.string().describe("Date slice (`YYYY-MM-DD`)."),
+  n: z3.number().nullable(),
+  mean: z3.number().nullable(),
+  delta_pct: z3.number().nullable(),
+  p_value: z3.number().nullable(),
+  srm_detected: z3.number().nullable().describe("`1` if sample-ratio mismatch detected, else `0`.")
 });
-var experimentResultsResponseSchema = z.object({
-  experiment: z.object({
-    id: z.string(),
+var experimentResultsResponseSchema = z3.object({
+  experiment: z3.object({
+    id: z3.string(),
     name: experimentNameSchema,
-    status: z.enum(["draft", "running", "stopped", "archived"])
+    status: z3.enum(["draft", "running", "stopped", "archived"])
   }),
-  results: z.array(experimentResultRowSchema)
+  results: z3.array(experimentResultRowSchema)
 });
-var experimentTimeseriesResponseSchema = z.object({
-  experiment: z.object({
-    id: z.string(),
+var experimentTimeseriesResponseSchema = z3.object({
+  experiment: z3.object({
+    id: z3.string(),
     name: experimentNameSchema,
-    status: z.enum(["draft", "running", "stopped", "archived"])
+    status: z3.enum(["draft", "running", "stopped", "archived"])
   }),
-  series: z.array(experimentResultRowSchema)
+  series: z3.array(experimentResultRowSchema)
 });
-var experimentReanalyzeResponseSchema = z.object({
-  id: z.string(),
-  queued: z.literal(true)
+var experimentReanalyzeResponseSchema = z3.object({
+  id: z3.string(),
+  queued: z3.literal(true)
 });
 
 // src/transport.ts
@@ -169,9 +209,9 @@ var ApiError = class extends Error {
 };
 
 // src/resources/experiments.ts
-var experimentListResponseSchema = z2.object({
-  data: z2.array(experimentResponseSchema),
-  next_cursor: z2.string().nullable()
+var experimentListResponseSchema = z4.object({
+  data: z4.array(experimentResponseSchema),
+  next_cursor: z4.string().nullable()
 });
 var BASE = "/api/admin/experiments";
 function experimentsClient(t) {
@@ -181,24 +221,29 @@ function experimentsClient(t) {
     if (opts.cursor) query.cursor = opts.cursor;
     return t.request("GET", BASE, void 0, query);
   }
-  async function listAll() {
+  async function listAllWith(status) {
     const out = [];
     let cursor;
     do {
-      const page = await list({ limit: 500, cursor });
+      const query = { limit: "500" };
+      if (cursor) query.cursor = cursor;
+      if (status) query.status = status;
+      const page = await t.request("GET", BASE, void 0, query);
       out.push(...page.data);
       cursor = page.next_cursor ?? void 0;
     } while (cursor);
     return out;
   }
+  async function listAll() {
+    return listAllWith();
+  }
   async function resolve(idOrName) {
     try {
       return await t.request("GET", `${BASE}/${idOrName}`);
     } catch (err) {
       if (!(err instanceof ApiError) || err.status !== 404) throw err;
     }
-    const all = await listAll();
-    const found = all.find((e) => e.name === idOrName);
+    const found = (await listAllWith()).find((e) => e.name === idOrName) ?? (await listAllWith("archived")).find((e) => e.name === idOrName);
     if (!found) throw new ApiError(`Experiment '${idOrName}' not found`, 404);
     return found;
   }
@@ -221,6 +266,7 @@ function experimentsClient(t) {
     start: (id) => setStatus(id, "running"),
     stop: (id) => setStatus(id, "stopped"),
     archive: (id) => setStatus(id, "archived"),
+    restore: (id) => setStatus(id, "draft"),
     setMetrics: (id, input) => t.request("POST", `${BASE}/${id}/metrics`, experimentMetricsUpdateSchema.parse(input)),
     results: (id) => t.request("GET", `${BASE}/${id}/results`),
     timeseries: (id, metric) => t.request(
@@ -267,7 +313,7 @@ var experimentsResource = {
       "",
       "**Identity.** Stable `name` (a-z, 0-9, `_`/`-`, max 64 chars). Immutable after create.",
       "",
-      "**Lifecycle.** `draft \u2192 running \u2192 stopped \u2192 archived`. Transition via `POST /{id}/status`. Restarting an archived experiment is not allowed.",
+      "**Lifecycle.** `draft \u2192 running \u2192 stopped \u2192 archived`. Transition via `POST /{id}/status`. An archived experiment that never started can be restored with `archived \u2192 draft`; restarting an archived experiment directly is not allowed.",
       "",
       "**Allocation.** `allocation_pct` (basis points, 0\u201310000) is the share of the targeted audience enrolled; `groups[].weight` (must sum to 10000) splits the enrolled audience. `targeting_gate` narrows the eligible audience before allocation.",
       "",
@@ -286,6 +332,7 @@ var experimentsResource = {
     { name: "start", description: "Transition draft experiment to running" },
     { name: "stop", description: "Stop a running experiment" },
     { name: "archive", description: "Archive a stopped experiment" },
+    { name: "restore", description: "Restore an archived (never-started) experiment to draft" },
     { name: "reanalyze", description: "Re-run analysis pass for the experiment" }
   ],
   endpoints: [
@@ -466,8 +513,9 @@ var experimentsResource = {
         "- `running \u2192 stopped` \u2014 halts allocation. Existing exposures stay in the dataset.",
         "- `stopped \u2192 archived` \u2014 soft-delete.",
         "- `draft \u2192 archived` \u2014 discard an unstarted experiment.",
+        "- `archived \u2192 draft` \u2014 restore a soft-deleted experiment so it can be re-completed and started. Allowed only if it never started; one that already ran must be cloned instead.",
         "",
-        "Restarting an `archived` experiment is not allowed; clone instead. Returns `409` on illegal transitions and `429` if the plan's `experiments_running` limit is exceeded on `\u2192 running`."
+        "Restarting an `archived` experiment directly is not allowed \u2014 restore it to `draft` first. Returns `409` on illegal transitions and `429` if the plan's `experiments_running` limit is exceeded on `\u2192 running`."
       ].join("\n"),
       pathParams: { id: "Stable opaque experiment id." },
       request: experimentStatusUpdateSchema,
@@ -488,6 +536,11 @@ var experimentsResource = {
             summary: "Archive \u2014 stopped \u2192 archived",
             description: "Soft-deletes the experiment. List endpoints exclude archived rows by default.",
             value: { status: "archived" }
+          },
+          restore: {
+            summary: "Restore \u2014 archived \u2192 draft",
+            description: "Un-deletes a soft-deleted experiment so it can be re-completed and started. Allowed only if it never ran.",
+            value: { status: "draft" }
           }
         },
         response: { id: "exp_01j7wb12c3d4e5f6g7h8j9k0l1", status: "running" }
@@ -592,7 +645,7 @@ var experimentsResource = {
       pathParams: { id: "Stable opaque experiment id." },
       queryParams: {
         metric: {
-          schema: z2.string().optional(),
+          schema: z4.string().optional(),
           description: "Optional metric name to filter the series."
         }
       },