@vibexp/api-client 0.59.0 → 0.61.0

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

@@ -292,6 +292,7 @@ export type Prompt = {
      * Computed embedding-similarity neighborhood of this resource (up to 5), derived live at read time from vector similarity — NOT stored edges and distinct from `related`. Populated on the detail GET; empty otherwise.
      */
     similar?: Array<SimilarResource>;
+    freshness?: ResourceFreshnessState;
 };
 export type CreatePromptRequest = {
     name: string;
@@ -1301,6 +1302,7 @@ export type Artifact = {
      * Computed embedding-similarity neighborhood of this resource (up to 5), derived live at read time from vector similarity — NOT stored edges and distinct from `related`. Populated on the detail GET; empty otherwise.
      */
     similar?: Array<SimilarResource>;
+    freshness?: ResourceFreshnessState;
 };
 export type CreateArtifactRequest = {
     /**
@@ -1899,6 +1901,7 @@ export type Memory = {
      * Computed embedding-similarity neighborhood of this resource (up to 5), derived live at read time from vector similarity — NOT stored edges and distinct from `related`. Populated on the detail GET; empty otherwise.
      */
     similar?: Array<SimilarResource>;
+    freshness?: ResourceFreshnessState;
 };
 export type CreateMemoryRequest = {
     /**
@@ -2126,6 +2129,7 @@ export type Blueprint = {
      * Computed embedding-similarity neighborhood of this resource (up to 5), derived live at read time from vector similarity — NOT stored edges and distinct from `related`. Populated on the detail GET; empty otherwise.
      */
     similar?: Array<SimilarResource>;
+    freshness?: ResourceFreshnessState;
 };
 /**
  * Read-only import provenance; present only for imported blueprints.
@@ -3732,6 +3736,209 @@ export type UpdateTeamFreshnessSettingsRequest = {
     interval_seconds: number;
     reversibility_enabled: boolean;
 };
+/**
+ * The reporting window for a time-series metric. The options mirror the other analytics endpoints so one range selector drives every chart.
+ *
+ */
+export type FreshnessMetricsRange = '7d' | '14d' | '30d' | '60d' | '90d' | '180d';
+/**
+ * One calendar day (UTC) of freshness activity, zero-filled: every day in the window is present even when nothing happened.
+ *
+ */
+export type FreshnessDailyStaleCount = {
+    date: string;
+    /**
+     * Resources that became stale on this day.
+     */
+    marked: number;
+    /**
+     * Resources that stopped being stale on this day, for any reason.
+     */
+    cleared: number;
+    /**
+     * How many resources were stale at the END of this day — the level, not the flow. It is reconstructed by walking today's live count backwards through the recorded transitions, so it is exact only for the period the audit log covers; days before freshness evaluation first ran on this team read as the earliest known level rather than as zero. The most recent day reports the live count as of the request. The reconstruction is clamped at zero, so on a team whose rows were removed by a project or team deletion — which writes no audit entry — the series can flatten at 0 instead of satisfying stale_total[i] = stale_total[i-1] + marked[i] - cleared[i].
+     *
+     */
+    stale_total: number;
+    /**
+     * The day's total ACTIVITY, marked + cleared — the sum of the two series, not the level. It is the field the shared time-series chart reads for its per-day total, which is why it is a flow rather than stale_total.
+     *
+     */
+    total: number;
+};
+export type FreshnessOverTimeMetricsData = {
+    range: FreshnessMetricsRange;
+    /**
+     * Resources marked stale across the whole window.
+     */
+    total_marked: number;
+    /**
+     * Resources cleared across the whole window.
+     */
+    total_cleared: number;
+    /**
+     * One entry per day in the window, oldest first. Serializes as `[]`, never `null`.
+     */
+    counts: Array<FreshnessDailyStaleCount>;
+};
+export type FreshnessOverTimeMetricsResponse = {
+    status: string;
+    message: string;
+    data: FreshnessOverTimeMetricsData;
+};
+/**
+ * How many of one resource type are stale right now.
+ */
+export type FreshnessTypeCount = {
+    resource_type: FreshnessRuleResourceType;
+    count: number;
+};
+export type FreshnessByTypeMetricsData = {
+    /**
+     * Total stale resources in the team, across every type.
+     */
+    total_stale: number;
+    /**
+     * One entry per resource type, always all four, in a stable order — a type with nothing stale reports 0 rather than being omitted, so the chart's bars never move. Serializes as `[]`, never `null`.
+     *
+     */
+    counts: Array<FreshnessTypeCount>;
+};
+export type FreshnessByTypeMetricsResponse = {
+    status: string;
+    message: string;
+    data: FreshnessByTypeMetricsData;
+};
+/**
+ * How many resources are stale right now in one project. `name` and `slug` are carried so the client can label and deep-link the bar without a second request.
+ *
+ */
+export type FreshnessProjectCount = {
+    project_id: string;
+    name: string;
+    slug: string;
+    count: number;
+};
+export type FreshnessByProjectMetricsData = {
+    total_stale: number;
+    /**
+     * One entry per project in the team, including projects with nothing stale (0), ordered by count descending then name. Serializes as `[]`, never `null`.
+     *
+     */
+    counts: Array<FreshnessProjectCount>;
+};
+export type FreshnessByProjectMetricsResponse = {
+    status: string;
+    message: string;
+    data: FreshnessByProjectMetricsData;
+};
+/**
+ * How many resources one rule currently marks. Rules have no name, so the defining fields travel with the count for the client to label the bar.
+ *
+ */
+export type FreshnessRuleImpact = {
+    rule_id: string;
+    /**
+     * The project the rule is scoped to, or null for every project in the team.
+     */
+    project_id: string | null;
+    resource_types: Array<FreshnessRuleResourceType>;
+    threshold_days: number;
+    /**
+     * A disabled rule reports 0 — it is listed so its absence from the chart is not mistaken for deletion.
+     */
+    enabled: boolean;
+    count: number;
+};
+export type FreshnessByRuleMetricsData = {
+    /**
+     * Distinct stale resources in the team. It is NOT the sum of the per-rule counts: a resource matched by two rules is counted once here and once under each rule, because staleness is a union across rules.
+     *
+     */
+    total_stale: number;
+    /**
+     * One entry per rule the team has defined, including rules matching nothing, ordered by count descending then rule id. Serializes as `[]`, never `null`.
+     *
+     */
+    counts: Array<FreshnessRuleImpact>;
+};
+export type FreshnessByRuleMetricsResponse = {
+    status: string;
+    message: string;
+    data: FreshnessByRuleMetricsData;
+};
+/**
+ * One recorded freshness transition. The log is append-only.
+ */
+export type FreshnessAuditEntry = {
+    id: string;
+    resource_type: FreshnessRuleResourceType;
+    resource_id: string;
+    /**
+     * The rule that caused the change, when exactly one did. Null for a reversal (caused by a read or an edit) and for a mark attributable to several rules at once — the resource's own state carries the full set.
+     *
+     */
+    rule_id: string | null;
+    /**
+     * Whether the resource became stale or stopped being stale.
+     */
+    action: 'marked' | 'cleared';
+    /**
+     * What caused it — a scheduled evaluation, a read, or an edit.
+     */
+    reason: 'rule_run' | 'accessed' | 'edited';
+    created_at: string;
+};
+/**
+ * A page of the team's freshness audit log, newest first.
+ */
+export type FreshnessAuditListResponse = {
+    /**
+     * Serializes as `[]` when the page is empty, never `null`.
+     */
+    entries: Array<FreshnessAuditEntry>;
+    /**
+     * Total entries in the team's log, ignoring pagination.
+     */
+    total_count: number;
+    /**
+     * Current page number (1-based)
+     */
+    page: number;
+    /**
+     * Number of entries per page
+     */
+    per_page: number;
+    /**
+     * Total number of pages
+     */
+    total_pages: number;
+};
+/**
+ * The resource's staleness state. Present only when the resource is stale; absent means fresh.
+ *
+ */
+export type ResourceFreshnessState = {
+    /**
+     * Today the only state a resource can be in while it has freshness state at all. It is modelled as an enum rather than a boolean so a future state can be added without changing the field's type.
+     *
+     */
+    status: 'stale';
+    /**
+     * When the resource was FIRST marked stale. It is preserved across re-evaluations that keep it stale, so it is the age a client can show.
+     *
+     */
+    since: string;
+    /**
+     * Every rule that currently marks this resource — staleness is a union across rules, so this answers "why is this stale". Serializes as `[]`, never `null`.
+     *
+     */
+    matched_rule_ids: Array<string>;
+    /**
+     * What produced the current state.
+     */
+    reason: 'rule_run' | 'accessed' | 'edited';
+};
 /**
  * The search ranking settings in effect for a team, with enough context for a client to render the whole settings surface from this one response: the effective values, where they came from, the instance defaults to preview a reset against, and the instance-owned candidate cap.
  *
@@ -5140,6 +5347,10 @@ export type ListArtifactsData = {
         team_id: string;
     };
     query?: {
+        /**
+         * 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';
         /**
          * Filter by project ID
          */
@@ -5280,6 +5491,10 @@ export type ListArtifactsByProjectData = {
         project_id: string;
     };
     query?: {
+        /**
+         * 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';
         /**
          * Filter by status
          */
@@ -6066,6 +6281,10 @@ export type ListMemoriesData = {
         team_id: string;
     };
     query?: {
+        /**
+         * 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';
         /**
          * Filter memories by project ID
          */
@@ -6466,6 +6685,10 @@ export type ListSpecLibrariesData = {
         team_id: string;
     };
     query?: {
+        /**
+         * 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';
         /**
          * Filter by project name
          */
@@ -6614,6 +6837,10 @@ export type ListSpecLibrariesByProjectData = {
         project_id: string;
     };
     query?: {
+        /**
+         * 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';
         /**
          * Filter by status
          */
@@ -6966,6 +7193,10 @@ export type ListPromptsData = {
         team_id: string;
     };
     query?: {
+        /**
+         * 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';
         /**
          * Page number for pagination
          */
@@ -12370,6 +12601,206 @@ export type UpdateTeamFreshnessSettingsResponses = {
     200: TeamFreshnessSettings;
 };
 export type UpdateTeamFreshnessSettingsResponse = UpdateTeamFreshnessSettingsResponses[keyof UpdateTeamFreshnessSettingsResponses];
+export type GetFreshnessOverTimeMetricsData = {
+    body?: never;
+    path: {
+        /**
+         * Team identifier
+         */
+        team_id: string;
+    };
+    query?: {
+        /**
+         * The reporting window. Defaults to 30d.
+         */
+        range?: FreshnessMetricsRange;
+    };
+    url: '/api/v1/{team_id}/freshness/metrics/over-time';
+};
+export type GetFreshnessOverTimeMetricsErrors = {
+    /**
+     * Invalid team_id or query parameter
+     */
+    400: ErrorResponse;
+    /**
+     * Authentication required
+     */
+    401: ErrorResponse;
+    /**
+     * Caller is not a member of the team
+     */
+    403: ErrorResponse;
+    /**
+     * Failed to build the team's freshness over-time metrics
+     */
+    500: ErrorResponse;
+};
+export type GetFreshnessOverTimeMetricsError = GetFreshnessOverTimeMetricsErrors[keyof GetFreshnessOverTimeMetricsErrors];
+export type GetFreshnessOverTimeMetricsResponses = {
+    /**
+     * Metrics retrieved successfully
+     */
+    200: FreshnessOverTimeMetricsResponse;
+};
+export type GetFreshnessOverTimeMetricsResponse = GetFreshnessOverTimeMetricsResponses[keyof GetFreshnessOverTimeMetricsResponses];
+export type GetFreshnessByTypeMetricsData = {
+    body?: never;
+    path: {
+        /**
+         * Team identifier
+         */
+        team_id: string;
+    };
+    query?: never;
+    url: '/api/v1/{team_id}/freshness/metrics/by-type';
+};
+export type GetFreshnessByTypeMetricsErrors = {
+    /**
+     * Invalid team_id or query parameter
+     */
+    400: ErrorResponse;
+    /**
+     * Authentication required
+     */
+    401: ErrorResponse;
+    /**
+     * Caller is not a member of the team
+     */
+    403: ErrorResponse;
+    /**
+     * Failed to build the team's freshness by-type metrics
+     */
+    500: ErrorResponse;
+};
+export type GetFreshnessByTypeMetricsError = GetFreshnessByTypeMetricsErrors[keyof GetFreshnessByTypeMetricsErrors];
+export type GetFreshnessByTypeMetricsResponses = {
+    /**
+     * Metrics retrieved successfully
+     */
+    200: FreshnessByTypeMetricsResponse;
+};
+export type GetFreshnessByTypeMetricsResponse = GetFreshnessByTypeMetricsResponses[keyof GetFreshnessByTypeMetricsResponses];
+export type GetFreshnessByProjectMetricsData = {
+    body?: never;
+    path: {
+        /**
+         * Team identifier
+         */
+        team_id: string;
+    };
+    query?: never;
+    url: '/api/v1/{team_id}/freshness/metrics/by-project';
+};
+export type GetFreshnessByProjectMetricsErrors = {
+    /**
+     * Invalid team_id or query parameter
+     */
+    400: ErrorResponse;
+    /**
+     * Authentication required
+     */
+    401: ErrorResponse;
+    /**
+     * Caller is not a member of the team
+     */
+    403: ErrorResponse;
+    /**
+     * Failed to build the team's freshness by-project metrics
+     */
+    500: ErrorResponse;
+};
+export type GetFreshnessByProjectMetricsError = GetFreshnessByProjectMetricsErrors[keyof GetFreshnessByProjectMetricsErrors];
+export type GetFreshnessByProjectMetricsResponses = {
+    /**
+     * Metrics retrieved successfully
+     */
+    200: FreshnessByProjectMetricsResponse;
+};
+export type GetFreshnessByProjectMetricsResponse = GetFreshnessByProjectMetricsResponses[keyof GetFreshnessByProjectMetricsResponses];
+export type GetFreshnessByRuleMetricsData = {
+    body?: never;
+    path: {
+        /**
+         * Team identifier
+         */
+        team_id: string;
+    };
+    query?: never;
+    url: '/api/v1/{team_id}/freshness/metrics/by-rule';
+};
+export type GetFreshnessByRuleMetricsErrors = {
+    /**
+     * Invalid team_id or query parameter
+     */
+    400: ErrorResponse;
+    /**
+     * Authentication required
+     */
+    401: ErrorResponse;
+    /**
+     * Caller is not a member of the team
+     */
+    403: ErrorResponse;
+    /**
+     * Failed to build the team's freshness by-rule metrics
+     */
+    500: ErrorResponse;
+};
+export type GetFreshnessByRuleMetricsError = GetFreshnessByRuleMetricsErrors[keyof GetFreshnessByRuleMetricsErrors];
+export type GetFreshnessByRuleMetricsResponses = {
+    /**
+     * Metrics retrieved successfully
+     */
+    200: FreshnessByRuleMetricsResponse;
+};
+export type GetFreshnessByRuleMetricsResponse = GetFreshnessByRuleMetricsResponses[keyof GetFreshnessByRuleMetricsResponses];
+export type ListFreshnessAuditData = {
+    body?: never;
+    path: {
+        /**
+         * Team identifier
+         */
+        team_id: string;
+    };
+    query?: {
+        /**
+         * Page number (1-based). The upper bound is not a storage limit — it keeps page * limit inside the range the offset arithmetic can represent, so an absurd page is rejected rather than silently wrapping around to the first one.
+         *
+         */
+        page?: number;
+        /**
+         * Entries per page
+         */
+        limit?: number;
+    };
+    url: '/api/v1/{team_id}/freshness/audit';
+};
+export type ListFreshnessAuditErrors = {
+    /**
+     * Invalid team_id or query parameter
+     */
+    400: ErrorResponse;
+    /**
+     * Authentication required
+     */
+    401: ErrorResponse;
+    /**
+     * Caller is not a member of the team
+     */
+    403: ErrorResponse;
+    /**
+     * Failed to list the team's freshness audit log
+     */
+    500: ErrorResponse;
+};
+export type ListFreshnessAuditError = ListFreshnessAuditErrors[keyof ListFreshnessAuditErrors];
+export type ListFreshnessAuditResponses = {
+    /**
+     * Audit log retrieved successfully
+     */
+    200: FreshnessAuditListResponse;
+};
+export type ListFreshnessAuditResponse = ListFreshnessAuditResponses[keyof ListFreshnessAuditResponses];
 export type ListEmbeddingProvidersSettingsData = {
     body?: never;
     path: {