@shipeasy/openapi 1.1.0 → 1.4.0

package/dist/index.js

@@ -108,12 +108,14 @@ var gateRuleSchema = z3.object({
     "semver_gt",
     "semver_gte",
     "semver_lt",
-    "semver_lte"
+    "semver_lte",
+    "gate_pass",
+    "exp_in"
   ]).describe(
-    "Comparison operator. Equality: `eq`/`neq`. Set membership: `in`/`not_in` (value is an array). Numeric order: `gt`/`gte`/`lt`/`lte`. Semver order: `semver_gt`/`semver_gte`/`semver_lt`/`semver_lte` (value is a dotted version like `4.2.0`). String: `contains` (substring), `regex` (JS-flavour pattern, value is the pattern string)."
+    'Comparison operator. Equality: `eq`/`neq`. Set membership: `in`/`not_in` (value is an array). Numeric order: `gt`/`gte`/`lt`/`lte`. Semver order: `semver_gt`/`semver_gte`/`semver_lt`/`semver_lte` (value is a dotted version like `4.2.0`). String: `contains` (substring), `regex` (JS-flavour pattern, value is the pattern string). Cross-resource references (evaluated only on the worker hot path, where both KV blobs load): `gate_pass` (`value` is another gate\'s name \u2014 true when that gate passes for the same caller); `exp_in` (`attr` is a running experiment\'s name, `value` is a group name, `"$holdout"`, or `"$any"` \u2014 true when the caller is in that variant / the universe holdout / any variant).'
   ),
   value: z3.unknown().describe(
-    "Operand. Shape depends on `op`: scalar for `eq/neq/gt/gte/lt/lte/contains/semver_*`; array of scalars for `in/not_in`; string pattern for `regex`."
+    'Operand. Shape depends on `op`: scalar for `eq/neq/gt/gte/lt/lte/contains/semver_*`; array of scalars for `in/not_in`; string pattern for `regex`; referenced gate name for `gate_pass`; group name / `"$holdout"` / `"$any"` for `exp_in`.'
   )
 }).describe(
   "Single targeting predicate. A gate's `rules` array is evaluated with AND semantics; use the gatekeeper `stack` for OR / fall-through logic."
@@ -124,9 +126,17 @@ var gateNameSchema = z3.string().regex(
 ).max(128).describe(
   "Stable gate key used by SDKs (`Shipeasy.checkGate(user, '<name>')`). Single segment or `folder.name`. Lowercase letters, digits, `_` or `-`; max 128 chars. Immutable after create \u2014 rename = delete + recreate."
 );
+var rampSchema = z3.object({
+  from: z3.number().int().min(0).max(1e4).describe("Start of the ramp in basis points (0\u201310000)."),
+  to: z3.number().int().min(0).max(1e4).describe("End of the ramp in basis points (0\u201310000)."),
+  startAt: z3.number().int().nonnegative().describe("Ramp start, epoch milliseconds (UTC)."),
+  durationMs: z3.number().int().positive().describe("Ramp length in milliseconds.")
+}).describe(
+  "Linear rollout ramp. The effective rollout % interpolates `from`\u2192`to` over `[startAt, startAt+durationMs]`, clamped outside that window, evaluated against the wall-clock at eval time. Overrides the entry's static `rolloutPct` while present."
+);
 var stackedConditionSchema = z3.object({
   id: z3.string().min(1).describe(
-    "Client-supplied stable id for the stack entry (used for React keys, audit diffs)."
+    "Client-supplied stable id for the stack entry (used for React keys, audit diffs, and as the default per-condition rollout salt)."
   ),
   type: z3.literal("condition").describe("Discriminator. `condition` = rule-based predicate sub-gate."),
   name: z3.string().optional().describe("Human label shown in the dashboard."),
@@ -135,9 +145,15 @@ var stackedConditionSchema = z3.object({
   ),
   pass: z3.enum(["all", "any"]).optional().describe("Combinator across `rules`. `all` = AND (default), `any` = OR."),
   rules: z3.array(gateRuleSchema).default([]).describe("Predicates evaluated under `pass`. Empty array = match nothing."),
+  rolloutPct: z3.number().int().min(0).max(1e4).optional().describe(
+    "Per-condition rollout in basis points. After the rules match, the caller is bucketed at this %; in-bucket \u2192 gate `true`, otherwise fall through to the next entry. Absent \u21D2 10000 (100%, every matching caller passes)."
+  ),
+  bucketBy: z3.string().optional().describe("Attribute used to hash the caller into the per-condition bucket. Default `userID`."),
+  salt: z3.string().optional().describe("Per-condition hash salt. Defaults to the entry `id`, then the gate salt."),
+  ramp: rampSchema.optional(),
   locked: z3.boolean().optional().describe("If `true`, dashboard hides edit controls (e.g. the trailing public-floor entry).")
 }).describe(
-  "Rule-based sub-gate. When matched, evaluation short-circuits and the gate returns `true` for the current caller."
+  "Rule-based sub-gate. When the rules match and the caller falls in the per-condition rollout bucket, evaluation short-circuits and the gate returns `true`; otherwise it falls through to the next entry."
 );
 var stackedRolloutSchema = z3.object({
   id: z3.string().min(1).describe("Client-supplied stable id for the stack entry."),
@@ -153,9 +169,10 @@ var stackedRolloutSchema = z3.object({
   salt: z3.string().optional().describe(
     "Per-entry hash salt. Defaults to the gate's salt. Set explicitly to keep two rollouts independent or correlated across gates."
   ),
+  ramp: rampSchema.optional(),
   locked: z3.boolean().optional().describe("If `true`, dashboard hides edit controls.")
 }).describe(
-  "Percentage-rollout sub-gate. Hashes `bucketBy` (default `userID`) with `salt` and returns `true` for `rolloutPct/10000` fraction of callers."
+  "Percentage-rollout sub-gate. Hashes `bucketBy` (default `userID`) with `salt` and returns `true` for `rolloutPct/10000` fraction of callers (or the ramp's effective % when `ramp` is set)."
 );
 var stackedGateEntrySchema = z3.discriminatedUnion("type", [stackedConditionSchema, stackedRolloutSchema]).describe(
   "One entry in the ordered gatekeeper stack. Evaluated top-to-bottom; first matching entry decides. Mix `condition` and `rollout` entries to express `internal-only` + `1% beta` + `50% public` in a single gate."
@@ -599,7 +616,12 @@ var experimentGroupSchema = z6.object({
 var paramSchemaSchema = z6.record(z6.string(), z6.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 bucketBySchema = z6.enum(["user_id", "session_id", "device_id"]).describe("Identifier used as the bucketing key. `user_id` is sticky across sessions.");
+var bucketBySchema = z6.string().min(1).max(128).regex(
+  /^[a-zA-Z_][a-zA-Z0-9_]*$/,
+  "Must be a user-attribute name (letters, digits, underscore; not starting with a digit)."
+).describe(
+  "User-attribute name used as the bucketing key \u2014 e.g. `user_id` (default), `session_id`, `device_id`, or a custom attribute like `company_id` to keep a whole org on one variant. Defaults to `user_id` when omitted."
+);
 var experimentCreateSchema = z6.object({
   name: experimentNameSchema,
   description: z6.string().max(2e3).nullable().default(null).describe("Free-form description. Max 2000 chars, markdown rendered in the dashboard."),
@@ -671,7 +693,7 @@ var experimentUpdateSchema = z6.object({
 );
 var experimentStatusUpdateSchema = z6.object({
   status: z6.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."
+    "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 = z6.object({
@@ -776,24 +798,29 @@ function experimentsClient(t) {
     if (opts.cursor) query.cursor = opts.cursor;
     return t.request("GET", BASE2, 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", BASE2, 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", `${BASE2}/${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;
   }
@@ -816,6 +843,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", `${BASE2}/${id}/metrics`, experimentMetricsUpdateSchema.parse(input)),
     results: (id) => t.request("GET", `${BASE2}/${id}/results`),
     timeseries: (id, metric) => t.request(
@@ -862,7 +890,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.",
       "",
@@ -881,6 +909,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: [
@@ -1061,8 +1090,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,
@@ -1083,6 +1113,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" }

package/dist/resources/experiments.d.ts

@@ -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[]>;
@@ -84,11 +86,7 @@ declare const experimentsResource: {
             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";
-            }>>>;
+            bucket_by: z.ZodDefault<z.ZodNullable<z.ZodString>>;
             folder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             universe: z.ZodString;
             targeting_gate: z.ZodDefault<z.ZodNullable<z.ZodString>>;
@@ -124,11 +122,7 @@ declare const experimentsResource: {
             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";
-            }>>>;
+            bucket_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             folder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             targeting_gate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             allocation_pct: z.ZodOptional<z.ZodNumber>;
@@ -167,6 +161,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";
@@ -186,11 +183,7 @@ declare const experimentsResource: {
                 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";
-                }>>;
+                bucketBy: z.ZodNullable<z.ZodString>;
                 folder: z.ZodNullable<z.ZodString>;
                 status: z.ZodEnum<{
                     draft: "draft";
@@ -273,11 +266,7 @@ declare const experimentsResource: {
             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";
-            }>>;
+            bucketBy: z.ZodNullable<z.ZodString>;
             folder: z.ZodNullable<z.ZodString>;
             status: z.ZodEnum<{
                 draft: "draft";
@@ -352,11 +341,7 @@ declare const experimentsResource: {
             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";
-            }>>>;
+            bucket_by: z.ZodDefault<z.ZodNullable<z.ZodString>>;
             folder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             universe: z.ZodString;
             targeting_gate: z.ZodDefault<z.ZodNullable<z.ZodString>>;
@@ -491,11 +476,7 @@ declare const experimentsResource: {
             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";
-            }>>>;
+            bucket_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             folder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             targeting_gate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             allocation_pct: z.ZodOptional<z.ZodNumber>;
@@ -637,6 +618,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

@@ -34,7 +34,12 @@ var experimentGroupSchema = z3.object({
 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 bucketBySchema = z3.enum(["user_id", "session_id", "device_id"]).describe("Identifier used as the bucketing key. `user_id` is sticky across sessions.");
+var bucketBySchema = z3.string().min(1).max(128).regex(
+  /^[a-zA-Z_][a-zA-Z0-9_]*$/,
+  "Must be a user-attribute name (letters, digits, underscore; not starting with a digit)."
+).describe(
+  "User-attribute name used as the bucketing key \u2014 e.g. `user_id` (default), `session_id`, `device_id`, or a custom attribute like `company_id` to keep a whole org on one variant. Defaults to `user_id` when omitted."
+);
 var experimentCreateSchema = z3.object({
   name: experimentNameSchema,
   description: z3.string().max(2e3).nullable().default(null).describe("Free-form description. Max 2000 chars, markdown rendered in the dashboard."),
@@ -106,7 +111,7 @@ var experimentUpdateSchema = z3.object({
 );
 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`. Restarting an archived experiment is not allowed."
+    "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 = z3.object({
@@ -221,24 +226,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;
   }
@@ -261,6 +271,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(
@@ -307,7 +318,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.",
       "",
@@ -326,6 +337,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: [
@@ -506,8 +518,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,
@@ -528,6 +541,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" }

package/dist/resources/gates.d.ts

@@ -90,6 +90,8 @@ declare const gatesResource: {
                     semver_gte: "semver_gte";
                     semver_lt: "semver_lt";
                     semver_lte: "semver_lte";
+                    gate_pass: "gate_pass";
+                    exp_in: "exp_in";
                 }>;
                 value: z.ZodUnknown;
             }, z.core.$strip>>>;
@@ -120,9 +122,20 @@ declare const gatesResource: {
                         semver_gte: "semver_gte";
                         semver_lt: "semver_lt";
                         semver_lte: "semver_lte";
+                        gate_pass: "gate_pass";
+                        exp_in: "exp_in";
                     }>;
                     value: z.ZodUnknown;
                 }, z.core.$strip>>>;
+                rolloutPct: z.ZodOptional<z.ZodNumber>;
+                bucketBy: z.ZodOptional<z.ZodString>;
+                salt: z.ZodOptional<z.ZodString>;
+                ramp: z.ZodOptional<z.ZodObject<{
+                    from: z.ZodNumber;
+                    to: z.ZodNumber;
+                    startAt: z.ZodNumber;
+                    durationMs: z.ZodNumber;
+                }, z.core.$strip>>;
                 locked: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>, z.ZodObject<{
                 id: z.ZodString;
@@ -132,6 +145,12 @@ declare const gatesResource: {
                 rolloutPct: z.ZodNumber;
                 bucketBy: z.ZodOptional<z.ZodString>;
                 salt: z.ZodOptional<z.ZodString>;
+                ramp: z.ZodOptional<z.ZodObject<{
+                    from: z.ZodNumber;
+                    to: z.ZodNumber;
+                    startAt: z.ZodNumber;
+                    durationMs: z.ZodNumber;
+                }, z.core.$strip>>;
                 locked: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>], "type">>>>;
         }, z.core.$strip>;
@@ -160,6 +179,8 @@ declare const gatesResource: {
                     semver_gte: "semver_gte";
                     semver_lt: "semver_lt";
                     semver_lte: "semver_lte";
+                    gate_pass: "gate_pass";
+                    exp_in: "exp_in";
                 }>;
                 value: z.ZodUnknown;
             }, z.core.$strip>>>;
@@ -190,9 +211,20 @@ declare const gatesResource: {
                         semver_gte: "semver_gte";
                         semver_lt: "semver_lt";
                         semver_lte: "semver_lte";
+                        gate_pass: "gate_pass";
+                        exp_in: "exp_in";
                     }>;
                     value: z.ZodUnknown;
                 }, z.core.$strip>>>;
+                rolloutPct: z.ZodOptional<z.ZodNumber>;
+                bucketBy: z.ZodOptional<z.ZodString>;
+                salt: z.ZodOptional<z.ZodString>;
+                ramp: z.ZodOptional<z.ZodObject<{
+                    from: z.ZodNumber;
+                    to: z.ZodNumber;
+                    startAt: z.ZodNumber;
+                    durationMs: z.ZodNumber;
+                }, z.core.$strip>>;
                 locked: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>, z.ZodObject<{
                 id: z.ZodString;
@@ -202,6 +234,12 @@ declare const gatesResource: {
                 rolloutPct: z.ZodNumber;
                 bucketBy: z.ZodOptional<z.ZodString>;
                 salt: z.ZodOptional<z.ZodString>;
+                ramp: z.ZodOptional<z.ZodObject<{
+                    from: z.ZodNumber;
+                    to: z.ZodNumber;
+                    startAt: z.ZodNumber;
+                    durationMs: z.ZodNumber;
+                }, z.core.$strip>>;
                 locked: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>], "type">>>>;
         }, z.core.$strip>;
@@ -248,6 +286,8 @@ declare const gatesResource: {
                         semver_gte: "semver_gte";
                         semver_lt: "semver_lt";
                         semver_lte: "semver_lte";
+                        gate_pass: "gate_pass";
+                        exp_in: "exp_in";
                     }>;
                     value: z.ZodUnknown;
                 }, z.core.$strip>>>;
@@ -283,9 +323,20 @@ declare const gatesResource: {
                             semver_gte: "semver_gte";
                             semver_lt: "semver_lt";
                             semver_lte: "semver_lte";
+                            gate_pass: "gate_pass";
+                            exp_in: "exp_in";
                         }>;
                         value: z.ZodUnknown;
                     }, z.core.$strip>>>;
+                    rolloutPct: z.ZodOptional<z.ZodNumber>;
+                    bucketBy: z.ZodOptional<z.ZodString>;
+                    salt: z.ZodOptional<z.ZodString>;
+                    ramp: z.ZodOptional<z.ZodObject<{
+                        from: z.ZodNumber;
+                        to: z.ZodNumber;
+                        startAt: z.ZodNumber;
+                        durationMs: z.ZodNumber;
+                    }, z.core.$strip>>;
                     locked: z.ZodOptional<z.ZodBoolean>;
                 }, z.core.$strip>, z.ZodObject<{
                     id: z.ZodString;
@@ -295,6 +346,12 @@ declare const gatesResource: {
                     rolloutPct: z.ZodNumber;
                     bucketBy: z.ZodOptional<z.ZodString>;
                     salt: z.ZodOptional<z.ZodString>;
+                    ramp: z.ZodOptional<z.ZodObject<{
+                        from: z.ZodNumber;
+                        to: z.ZodNumber;
+                        startAt: z.ZodNumber;
+                        durationMs: z.ZodNumber;
+                    }, z.core.$strip>>;
                     locked: z.ZodOptional<z.ZodBoolean>;
                 }, z.core.$strip>], "type">>>>;
                 updatedAt: z.ZodString;
@@ -364,6 +421,8 @@ declare const gatesResource: {
                     semver_gte: "semver_gte";
                     semver_lt: "semver_lt";
                     semver_lte: "semver_lte";
+                    gate_pass: "gate_pass";
+                    exp_in: "exp_in";
                 }>;
                 value: z.ZodUnknown;
             }, z.core.$strip>>>;
@@ -394,9 +453,20 @@ declare const gatesResource: {
                         semver_gte: "semver_gte";
                         semver_lt: "semver_lt";
                         semver_lte: "semver_lte";
+                        gate_pass: "gate_pass";
+                        exp_in: "exp_in";
                     }>;
                     value: z.ZodUnknown;
                 }, z.core.$strip>>>;
+                rolloutPct: z.ZodOptional<z.ZodNumber>;
+                bucketBy: z.ZodOptional<z.ZodString>;
+                salt: z.ZodOptional<z.ZodString>;
+                ramp: z.ZodOptional<z.ZodObject<{
+                    from: z.ZodNumber;
+                    to: z.ZodNumber;
+                    startAt: z.ZodNumber;
+                    durationMs: z.ZodNumber;
+                }, z.core.$strip>>;
                 locked: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>, z.ZodObject<{
                 id: z.ZodString;
@@ -406,6 +476,12 @@ declare const gatesResource: {
                 rolloutPct: z.ZodNumber;
                 bucketBy: z.ZodOptional<z.ZodString>;
                 salt: z.ZodOptional<z.ZodString>;
+                ramp: z.ZodOptional<z.ZodObject<{
+                    from: z.ZodNumber;
+                    to: z.ZodNumber;
+                    startAt: z.ZodNumber;
+                    durationMs: z.ZodNumber;
+                }, z.core.$strip>>;
                 locked: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>], "type">>>>;
         }, z.core.$strip>;
@@ -531,6 +607,8 @@ declare const gatesResource: {
                     semver_gte: "semver_gte";
                     semver_lt: "semver_lt";
                     semver_lte: "semver_lte";
+                    gate_pass: "gate_pass";
+                    exp_in: "exp_in";
                 }>;
                 value: z.ZodUnknown;
             }, z.core.$strip>>>;
@@ -561,9 +639,20 @@ declare const gatesResource: {
                         semver_gte: "semver_gte";
                         semver_lt: "semver_lt";
                         semver_lte: "semver_lte";
+                        gate_pass: "gate_pass";
+                        exp_in: "exp_in";
                     }>;
                     value: z.ZodUnknown;
                 }, z.core.$strip>>>;
+                rolloutPct: z.ZodOptional<z.ZodNumber>;
+                bucketBy: z.ZodOptional<z.ZodString>;
+                salt: z.ZodOptional<z.ZodString>;
+                ramp: z.ZodOptional<z.ZodObject<{
+                    from: z.ZodNumber;
+                    to: z.ZodNumber;
+                    startAt: z.ZodNumber;
+                    durationMs: z.ZodNumber;
+                }, z.core.$strip>>;
                 locked: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>, z.ZodObject<{
                 id: z.ZodString;
@@ -573,6 +662,12 @@ declare const gatesResource: {
                 rolloutPct: z.ZodNumber;
                 bucketBy: z.ZodOptional<z.ZodString>;
                 salt: z.ZodOptional<z.ZodString>;
+                ramp: z.ZodOptional<z.ZodObject<{
+                    from: z.ZodNumber;
+                    to: z.ZodNumber;
+                    startAt: z.ZodNumber;
+                    durationMs: z.ZodNumber;
+                }, z.core.$strip>>;
                 locked: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>], "type">>>>;
         }, z.core.$strip>;