@vibexp/api-client 0.98.0 → 0.100.0

package/dist/axios/types.gen.d.ts

@@ -76,25 +76,25 @@ export type PaginatedResponse = {
     total_pages: number;
 };
 /**
- * The complete status vocabulary shared by prompts, artifacts, blueprints and memories. Each resource type accepts a named subset of these values, never the whole set; see PromptStatus, ArtifactStatus, BlueprintStatus and MemoryStatus.
+ * The system status vocabulary shared by prompts, artifacts, blueprints and memories. Each resource type has a named subset of these values as its system statuses; see PromptStatus, ArtifactStatus, BlueprintStatus and MemoryStatus. A team's custom status may not reuse any of these values.
  */
 export type ResourceStatus = 'active' | 'draft' | 'archived' | 'published' | 'expired';
 /**
- * Publication status of a prompt. A prompt is only exposed over MCP once it is `published`.
+ * Status of a prompt. The system values are `draft` and `published`; a prompt is only exposed over MCP once it is `published`. A team may define further statuses of its own for prompts, so this is an open string: any other value must be one of the team's custom prompt statuses, or the request is rejected with 400.
  */
-export type PromptStatus = 'draft' | 'published';
+export type PromptStatus = string;
 /**
- * Lifecycle status of an artifact.
+ * Status of an artifact. The system values are `active`, `draft` and `archived`. A team may define further statuses of its own for artifacts, so this is an open string: any other value must be one of the team's custom artifact statuses, or the request is rejected with 400.
  */
-export type ArtifactStatus = 'active' | 'draft' | 'archived';
+export type ArtifactStatus = string;
 /**
- * Lifecycle status of a blueprint. `expired` marks a blueprint whose rules no longer apply but whose content is kept for reference.
+ * Status of a blueprint. The system values are `active` and `expired`; `expired` marks a blueprint whose rules no longer apply but whose content is kept for reference. A team may define further statuses of its own for blueprints, so this is an open string: any other value must be one of the team's custom blueprint statuses, or the request is rejected with 400.
  */
-export type BlueprintStatus = 'active' | 'expired';
+export type BlueprintStatus = string;
 /**
- * Lifecycle status of a memory.
+ * Status of a memory. The system values are `active`, `draft` and `archived`. A team may define further statuses of its own for memories, so this is an open string: any other value must be one of the team's custom memory statuses, or the request is rejected with 400.
  */
-export type MemoryStatus = 'active' | 'draft' | 'archived';
+export type MemoryStatus = string;
 /**
  * Per-source access counts for a single calendar day (UTC), zero-filled.
  */
@@ -6437,18 +6437,22 @@ export type AdminInstanceSearchSettings = {
     updated_by_name: string | null;
     /**
      * The stored row's optimistic-lock version; null when nothing is stored.
-     * Send it back as `expected_version` to reject a save that would
-     * overwrite someone else's change.
+     * Send it back as `expected_version` (`0` when it is null) to reject a
+     * save that would overwrite someone else's change.
      *
      */
     version: number | null;
 };
 /**
  * A whole replacement of the instance search ranking defaults. Every value is
- * required. `expected_version` is optional: when present, the save is
- * rejected with 409 unless it equals the stored version (and when nothing is
- * stored, any `expected_version` other than null is a conflict). Omit it for
- * last-write-wins.
+ * required. `expected_version` is optional and makes the save a
+ * compare-and-set:
+ *
+ * - omitted or null: last-write-wins, never a conflict.
+ * - `0`: nothing may be stored yet; the save is rejected with 409 when a row
+ * is stored. Send it when the `version` last read was null.
+ * - a positive value: the save is rejected with 409 unless it equals the
+ * stored `version`, and also when nothing is stored.
  *
  */
 export type AdminInstanceSearchSettingsUpdate = {
@@ -6459,7 +6463,10 @@ export type AdminInstanceSearchSettingsUpdate = {
     rank_half_life_days: number;
     rank_candidate_cap: number;
     /**
-     * The `version` the caller last read; omit or null for last-write-wins.
+     * The `version` the caller last read. Send `0` when that `version` was
+     * null, to save only while nothing is stored. Omit it or send null for
+     * last-write-wins. A negative value matches nothing and is a 409.
+     *
      */
     expected_version?: number | null;
 };
@@ -6542,18 +6549,22 @@ export type AdminInstanceAiSummarySettings = {
     updated_by_name: string | null;
     /**
      * The stored row's optimistic-lock version; null when nothing is stored.
-     * Send it back as `expected_version` to reject a save that would
-     * overwrite someone else's change.
+     * Send it back as `expected_version` (`0` when it is null) to reject a
+     * save that would overwrite someone else's change.
      *
      */
     version: number | null;
 };
 /**
  * A whole replacement of the instance AI summary settings. Every value is
- * required. `expected_version` is optional: when present, the save is
- * rejected with 409 unless it equals the stored version (and when nothing is
- * stored, any `expected_version` other than null is a conflict). Omit it for
- * last-write-wins.
+ * required. `expected_version` is optional and makes the save a
+ * compare-and-set:
+ *
+ * - omitted or null: last-write-wins, never a conflict.
+ * - `0`: nothing may be stored yet; the save is rejected with 409 when a row
+ * is stored. Send it when the `version` last read was null.
+ * - a positive value: the save is rejected with 409 unless it equals the
+ * stored `version`, and also when nothing is stored.
  *
  */
 export type AdminInstanceAiSummarySettingsUpdate = {
@@ -6565,7 +6576,10 @@ export type AdminInstanceAiSummarySettingsUpdate = {
     total_context_chars: number;
     request_timeout_ms: number;
     /**
-     * The `version` the caller last read; omit or null for last-write-wins.
+     * The `version` the caller last read. Send `0` when that `version` was
+     * null, to save only while nothing is stored. Omit it or send null for
+     * last-write-wins. A negative value matches nothing and is a 409.
+     *
      */
     expected_version?: number | null;
 };
@@ -6814,7 +6828,10 @@ export type AdminAuthAllowlist = {
      */
     active: boolean;
     /**
-     * The stored allowlist's own version; null when nothing is stored.
+     * The stored allowlist's own version; null when nothing is stored. Send
+     * it back as `expected_version` (`0` when it is null) to reject a save
+     * that would overwrite someone else's change.
+     *
      */
     version: number | null;
     /**
@@ -6835,17 +6852,23 @@ export type AdminAuthAllowlist = {
  * is a DNS name of at least two labels with no leading `@`. Storing two empty
  * lists means open access.
  *
- * `expected_version` is optional: when present, the save is rejected with
- * 409 unless it equals the stored allowlist's `version` (and when nothing is
- * stored, any `expected_version` other than null is a conflict). Omit it for
- * last-write-wins.
+ * `expected_version` is optional and makes the save a compare-and-set:
+ *
+ * - omitted or null: last-write-wins, never a conflict.
+ * - `0`: no allowlist may be stored yet; the save is rejected with 409 when
+ * one is. Send it when the `version` last read was null.
+ * - a positive value: the save is rejected with 409 unless it equals the
+ * stored allowlist's `version`, and also when nothing is stored.
  *
  */
 export type AdminAuthAllowlistUpdate = {
     domains: Array<string>;
     emails: Array<string>;
     /**
-     * The `version` the caller last read; omit or null for last-write-wins.
+     * The `version` the caller last read. Send `0` when that `version` was
+     * null, to save only while nothing is stored. Omit it or send null for
+     * last-write-wins. A negative value matches nothing and is a 409.
+     *
      */
     expected_version?: number | null;
 };
@@ -7787,7 +7810,7 @@ export type ListArtifactsData = {
          */
         project_id?: string;
         /**
-         * Filter by status
+         * Filter by status: one of the system statuses or one of the team's custom statuses for this resource type. Returns 400 for unknown values.
          */
         status?: ArtifactStatus;
         /**
@@ -7931,7 +7954,7 @@ export type ListArtifactsByProjectData = {
          */
         freshness?: 'stale';
         /**
-         * Filter by status
+         * Filter by status: one of the system statuses or one of the team's custom statuses for this resource type. Returns 400 for unknown values.
          */
         status?: ArtifactStatus;
         /**
@@ -9194,7 +9217,7 @@ export type ListSpecLibrariesData = {
          */
         project_id?: string;
         /**
-         * Filter by status
+         * Filter by status: one of the system statuses or one of the team's custom statuses for this resource type. Returns 400 for unknown values.
          */
         status?: BlueprintStatus;
         /**
@@ -9342,7 +9365,7 @@ export type ListSpecLibrariesByProjectData = {
          */
         freshness?: 'stale';
         /**
-         * Filter by status
+         * Filter by status: one of the system statuses or one of the team's custom statuses for this resource type. Returns 400 for unknown values.
          */
         status?: BlueprintStatus;
         /**
@@ -9714,7 +9737,7 @@ export type ListPromptsData = {
          */
         search?: string;
         /**
-         * Filter by prompt status
+         * Filter by status: one of the system statuses or one of the team's custom statuses for this resource type. Returns 400 for unknown values.
          */
         status?: PromptStatus;
         /**

package/dist/schema.d.ts

@@ -5991,35 +5991,31 @@ export interface components {
             total_pages: number;
         };
         /**
-         * @description The complete status vocabulary shared by prompts, artifacts, blueprints and memories. Each resource type accepts a named subset of these values, never the whole set; see PromptStatus, ArtifactStatus, BlueprintStatus and MemoryStatus.
+         * @description The system status vocabulary shared by prompts, artifacts, blueprints and memories. Each resource type has a named subset of these values as its system statuses; see PromptStatus, ArtifactStatus, BlueprintStatus and MemoryStatus. A team's custom status may not reuse any of these values.
          * @example active
          * @enum {string}
          */
         ResourceStatus: "active" | "draft" | "archived" | "published" | "expired";
         /**
-         * @description Publication status of a prompt. A prompt is only exposed over MCP once it is `published`.
+         * @description Status of a prompt. The system values are `draft` and `published`; a prompt is only exposed over MCP once it is `published`. A team may define further statuses of its own for prompts, so this is an open string: any other value must be one of the team's custom prompt statuses, or the request is rejected with 400.
          * @example published
-         * @enum {string}
          */
-        PromptStatus: "draft" | "published";
+        PromptStatus: string;
         /**
-         * @description Lifecycle status of an artifact.
+         * @description Status of an artifact. The system values are `active`, `draft` and `archived`. A team may define further statuses of its own for artifacts, so this is an open string: any other value must be one of the team's custom artifact statuses, or the request is rejected with 400.
          * @example active
-         * @enum {string}
          */
-        ArtifactStatus: "active" | "draft" | "archived";
+        ArtifactStatus: string;
         /**
-         * @description Lifecycle status of a blueprint. `expired` marks a blueprint whose rules no longer apply but whose content is kept for reference.
+         * @description Status of a blueprint. The system values are `active` and `expired`; `expired` marks a blueprint whose rules no longer apply but whose content is kept for reference. A team may define further statuses of its own for blueprints, so this is an open string: any other value must be one of the team's custom blueprint statuses, or the request is rejected with 400.
          * @example active
-         * @enum {string}
          */
-        BlueprintStatus: "active" | "expired";
+        BlueprintStatus: string;
         /**
-         * @description Lifecycle status of a memory.
+         * @description Status of a memory. The system values are `active`, `draft` and `archived`. A team may define further statuses of its own for memories, so this is an open string: any other value must be one of the team's custom memory statuses, or the request is rejected with 400.
          * @example active
-         * @enum {string}
          */
-        MemoryStatus: "active" | "draft" | "archived";
+        MemoryStatus: string;
         /** @description Per-source access counts for a single calendar day (UTC), zero-filled. */
         ResourceAccessDailyCount: {
             /**
@@ -13418,18 +13414,22 @@ export interface components {
             /**
              * Format: int64
              * @description The stored row's optimistic-lock version; null when nothing is stored.
-             *     Send it back as `expected_version` to reject a save that would
-             *     overwrite someone else's change.
+             *     Send it back as `expected_version` (`0` when it is null) to reject a
+             *     save that would overwrite someone else's change.
              * @example 4
              */
             version: number | null;
         };
         /**
          * @description A whole replacement of the instance search ranking defaults. Every value is
-         *     required. `expected_version` is optional: when present, the save is
-         *     rejected with 409 unless it equals the stored version (and when nothing is
-         *     stored, any `expected_version` other than null is a conflict). Omit it for
-         *     last-write-wins.
+         *     required. `expected_version` is optional and makes the save a
+         *     compare-and-set:
+         *
+         *     - omitted or null: last-write-wins, never a conflict.
+         *     - `0`: nothing may be stored yet; the save is rejected with 409 when a row
+         *       is stored. Send it when the `version` last read was null.
+         *     - a positive value: the save is rejected with 409 unless it equals the
+         *       stored `version`, and also when nothing is stored.
          */
         AdminInstanceSearchSettingsUpdate: {
             recency_ranking_enabled: boolean;
@@ -13444,7 +13444,9 @@ export interface components {
             rank_candidate_cap: number;
             /**
              * Format: int64
-             * @description The `version` the caller last read; omit or null for last-write-wins.
+             * @description The `version` the caller last read. Send `0` when that `version` was
+             *     null, to save only while nothing is stored. Omit it or send null for
+             *     last-write-wins. A negative value matches nothing and is a 409.
              */
             expected_version?: number | null;
         };
@@ -13540,18 +13542,22 @@ export interface components {
             /**
              * Format: int64
              * @description The stored row's optimistic-lock version; null when nothing is stored.
-             *     Send it back as `expected_version` to reject a save that would
-             *     overwrite someone else's change.
+             *     Send it back as `expected_version` (`0` when it is null) to reject a
+             *     save that would overwrite someone else's change.
              * @example 4
              */
             version: number | null;
         };
         /**
          * @description A whole replacement of the instance AI summary settings. Every value is
-         *     required. `expected_version` is optional: when present, the save is
-         *     rejected with 409 unless it equals the stored version (and when nothing is
-         *     stored, any `expected_version` other than null is a conflict). Omit it for
-         *     last-write-wins.
+         *     required. `expected_version` is optional and makes the save a
+         *     compare-and-set:
+         *
+         *     - omitted or null: last-write-wins, never a conflict.
+         *     - `0`: nothing may be stored yet; the save is rejected with 409 when a row
+         *       is stored. Send it when the `version` last read was null.
+         *     - a positive value: the save is rejected with 409 unless it equals the
+         *       stored `version`, and also when nothing is stored.
          */
         AdminInstanceAISummarySettingsUpdate: {
             enabled: boolean;
@@ -13563,7 +13569,9 @@ export interface components {
             request_timeout_ms: number;
             /**
              * Format: int64
-             * @description The `version` the caller last read; omit or null for last-write-wins.
+             * @description The `version` the caller last read. Send `0` when that `version` was
+             *     null, to save only while nothing is stored. Omit it or send null for
+             *     last-write-wins. A negative value matches nothing and is a 409.
              */
             expected_version?: number | null;
         };
@@ -13841,7 +13849,9 @@ export interface components {
             active: boolean;
             /**
              * Format: int64
-             * @description The stored allowlist's own version; null when nothing is stored.
+             * @description The stored allowlist's own version; null when nothing is stored. Send
+             *     it back as `expected_version` (`0` when it is null) to reject a save
+             *     that would overwrite someone else's change.
              * @example 3
              */
             version: number | null;
@@ -13864,10 +13874,13 @@ export interface components {
          *     is a DNS name of at least two labels with no leading `@`. Storing two empty
          *     lists means open access.
          *
-         *     `expected_version` is optional: when present, the save is rejected with
-         *     409 unless it equals the stored allowlist's `version` (and when nothing is
-         *     stored, any `expected_version` other than null is a conflict). Omit it for
-         *     last-write-wins.
+         *     `expected_version` is optional and makes the save a compare-and-set:
+         *
+         *     - omitted or null: last-write-wins, never a conflict.
+         *     - `0`: no allowlist may be stored yet; the save is rejected with 409 when
+         *       one is. Send it when the `version` last read was null.
+         *     - a positive value: the save is rejected with 409 unless it equals the
+         *       stored allowlist's `version`, and also when nothing is stored.
          */
         AdminAuthAllowlistUpdate: {
             /**
@@ -13884,7 +13897,9 @@ export interface components {
             emails: string[];
             /**
              * Format: int64
-             * @description The `version` the caller last read; omit or null for last-write-wins.
+             * @description The `version` the caller last read. Send `0` when that `version` was
+             *     null, to save only while nothing is stored. Omit it or send null for
+             *     last-write-wins. A negative value matches nothing and is a 409.
              */
             expected_version?: number | null;
         };
@@ -15231,7 +15246,7 @@ export interface operations {
                 freshness?: "stale";
                 /** @description Filter by project ID */
                 project_id?: string;
-                /** @description Filter by status */
+                /** @description Filter by status: one of the system statuses or one of the team's custom statuses for this resource type. Returns 400 for unknown values. */
                 status?: components["schemas"]["ArtifactStatus"];
                 /** @description Filter by type. An open string matched against the team's registered types (the system defaults work_reports, static_contexts and general, plus any custom types the team has added), not a fixed enum. */
                 type?: string;
@@ -15412,7 +15427,7 @@ export interface operations {
             query?: {
                 /** @description Filter to resources currently flagged stale by the team's freshness rules (epic #726). Omit for no freshness filtering. Returns 400 for any other value — a silently ignored filter would return the full list, which looks like a legitimate answer. */
                 freshness?: "stale";
-                /** @description Filter by status */
+                /** @description Filter by status: one of the system statuses or one of the team's custom statuses for this resource type. Returns 400 for unknown values. */
                 status?: components["schemas"]["ArtifactStatus"];
                 /** @description Filter by type. An open string matched against the team's registered types (the system defaults work_reports, static_contexts and general, plus any custom types the team has added), not a fixed enum. */
                 type?: string;
@@ -17128,7 +17143,7 @@ export interface operations {
                 project_name?: string;
                 /** @description Filter by project ID. On this team-scoped variant the backend reads it only when a project is not already selected via a path parameter (i.e. not on listSpecLibrariesByProject). */
                 project_id?: string;
-                /** @description Filter by status */
+                /** @description Filter by status: one of the system statuses or one of the team's custom statuses for this resource type. Returns 400 for unknown values. */
                 status?: components["schemas"]["BlueprintStatus"];
                 /** @description Filter by type */
                 type?: "general" | "claude-code" | "claude" | "cursor" | "codex";
@@ -17325,7 +17340,7 @@ export interface operations {
             query?: {
                 /** @description Filter to resources currently flagged stale by the team's freshness rules (epic #726). Omit for no freshness filtering. Returns 400 for any other value — a silently ignored filter would return the full list, which looks like a legitimate answer. */
                 freshness?: "stale";
-                /** @description Filter by status */
+                /** @description Filter by status: one of the system statuses or one of the team's custom statuses for this resource type. Returns 400 for unknown values. */
                 status?: components["schemas"]["BlueprintStatus"];
                 /** @description Filter by type */
                 type?: "general" | "claude-code" | "claude" | "cursor" | "codex";
@@ -17805,7 +17820,7 @@ export interface operations {
                 limit?: number;
                 /** @description Search term to filter prompts by name or description */
                 search?: string;
-                /** @description Filter by prompt status */
+                /** @description Filter by status: one of the system statuses or one of the team's custom statuses for this resource type. Returns 400 for unknown values. */
                 status?: components["schemas"]["PromptStatus"];
                 /**
                  * @description Comma-separated list of labels to filter by. A resource matches when it carries at least one of the listed labels. At most 25 labels, each at most 50 characters; beyond that the request is rejected with 400.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibexp/api-client",
-  "version": "0.98.0",
+  "version": "0.100.0",
   "description": "Typed VibeXP API client generated from the OpenAPI spec (openapi-fetch main entrypoint, axios SDK at ./axios)",
   "license": "MIT",
   "repository": {