@vibexp/api-client 0.58.0 → 0.59.0

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

@@ -3599,6 +3599,139 @@ export type MetadataValuesResponse = {
      */
     truncated: boolean;
 };
+/**
+ * One team's rule for when a resource becomes stale.
+ */
+export type FreshnessRule = {
+    /**
+     * Rule identifier.
+     */
+    id: string;
+    /**
+     * Team the rule belongs to.
+     */
+    team_id: string;
+    /**
+     * Scopes the rule to a single project. `null` means the rule applies to EVERY project in the team.
+     *
+     */
+    project_id: string | null;
+    /**
+     * Resource types the rule applies to. Never empty.
+     */
+    resource_types: Array<FreshnessRuleResourceType>;
+    /**
+     * Access mediums that count as "accessed" for this rule. An EMPTY array means ANY medium counts — it does not mean "no medium".
+     *
+     */
+    mediums: Array<FreshnessRuleMedium>;
+    /**
+     * Days without a qualifying access after which the resource is stale. Capped at 36500 (100 years), mirroring the search-settings half-life cap: past that the rule can never fire, and the bound keeps the value inside the int32 the column and the wire format use.
+     *
+     */
+    threshold_days: number;
+    /**
+     * Whether evaluation runs apply this rule.
+     */
+    enabled: boolean;
+    created_at: string;
+    updated_at: string;
+};
+/**
+ * A resource type a freshness rule can cover.
+ */
+export type FreshnessRuleResourceType = 'artifact' | 'prompt' | 'blueprint' | 'memory';
+/**
+ * An access medium that counts as "accessed" for a freshness rule. Note this is narrower than the set of mediums recorded on the access path — `api` accesses are stored but are deliberately not selectable as rule criteria.
+ *
+ */
+export type FreshnessRuleMedium = 'web' | 'cli' | 'mcp';
+/**
+ * The team's freshness rules, oldest first.
+ */
+export type FreshnessRuleListResponse = {
+    /**
+     * Freshness rules. Serializes as `[]` when the team has none, never `null`.
+     */
+    rules: Array<FreshnessRule>;
+};
+/**
+ * Create a freshness rule.
+ */
+export type CreateFreshnessRuleRequest = {
+    /**
+     * Scope to one project; omit or send `null` for every project in the team.
+     */
+    project_id?: string | null;
+    resource_types: Array<FreshnessRuleResourceType>;
+    /**
+     * Omit or send an empty array to match any medium.
+     */
+    mediums?: Array<FreshnessRuleMedium>;
+    threshold_days: number;
+    /**
+     * Defaults to true when omitted.
+     */
+    enabled?: boolean;
+};
+/**
+ * Replace a freshness rule in full.
+ */
+export type UpdateFreshnessRuleRequest = {
+    /**
+     * Scope to one project; `null` means every project in the team.
+     */
+    project_id: string | null;
+    resource_types: Array<FreshnessRuleResourceType>;
+    /**
+     * An empty array matches any medium.
+     */
+    mediums: Array<FreshnessRuleMedium>;
+    threshold_days: number;
+    enabled: boolean;
+};
+/**
+ * The tunable freshness-evaluation values, shared by the current settings and the defaults.
+ */
+export type FreshnessSettingsValues = {
+    /**
+     * How often the team's rules are evaluated. Storage enforces a one-hour floor, matching the scheduler's own floor; the 31536000 (365-day) ceiling keeps the value inside the int32 the column and the wire format use, and an interval longer than a year is indistinguishable from off.
+     *
+     */
+    interval_seconds: number;
+    /**
+     * Whether accessing or editing a stale resource clears its stale state.
+     */
+    reversibility_enabled: boolean;
+};
+/**
+ * The freshness settings in effect for a team, with their provenance. A team that has never overridden them reports `source: instance` and the defaults.
+ *
+ */
+export type TeamFreshnessSettings = {
+    /**
+     * `team` when the team stores its own settings, `instance` when it inherits the defaults.
+     *
+     */
+    source: 'instance' | 'team';
+    interval_seconds: number;
+    reversibility_enabled: boolean;
+    /**
+     * The values a DELETE would restore. Present on every read so clients can preview a reset without a second call.
+     *
+     */
+    defaults: FreshnessSettingsValues;
+};
+/**
+ * Override the team's freshness settings.
+ */
+export type UpdateTeamFreshnessSettingsRequest = {
+    /**
+     * Rejected below 3600 (one hour) or above 31536000 (365 days).
+     */
+    interval_seconds: number;
+    reversibility_enabled: boolean;
+};
 /**
  * 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.
  *
@@ -11962,6 +12095,281 @@ export type UpdateTeamSearchSettingsResponses = {
     200: TeamSearchSettings;
 };
 export type UpdateTeamSearchSettingsResponse = UpdateTeamSearchSettingsResponses[keyof UpdateTeamSearchSettingsResponses];
+export type ListFreshnessRulesData = {
+    body?: never;
+    path: {
+        /**
+         * Team identifier
+         */
+        team_id: string;
+    };
+    query?: never;
+    url: '/api/v1/{team_id}/freshness/rules';
+};
+export type ListFreshnessRulesErrors = {
+    /**
+     * Invalid team_id
+     */
+    400: ErrorResponse;
+    /**
+     * Authentication required
+     */
+    401: ErrorResponse;
+    /**
+     * Caller is not a member of the team
+     */
+    403: ErrorResponse;
+    /**
+     * Failed to list the team's freshness rules
+     */
+    500: ErrorResponse;
+};
+export type ListFreshnessRulesError = ListFreshnessRulesErrors[keyof ListFreshnessRulesErrors];
+export type ListFreshnessRulesResponses = {
+    /**
+     * Rules retrieved successfully
+     */
+    200: FreshnessRuleListResponse;
+};
+export type ListFreshnessRulesResponse = ListFreshnessRulesResponses[keyof ListFreshnessRulesResponses];
+export type CreateFreshnessRuleData = {
+    body: CreateFreshnessRuleRequest;
+    path: {
+        /**
+         * Team identifier
+         */
+        team_id: string;
+    };
+    query?: never;
+    url: '/api/v1/{team_id}/freshness/rules';
+};
+export type CreateFreshnessRuleErrors = {
+    /**
+     * Invalid team_id or rule definition
+     */
+    400: ErrorResponse;
+    /**
+     * Authentication required
+     */
+    401: ErrorResponse;
+    /**
+     * Caller may not change the team's settings
+     */
+    403: ErrorResponse;
+    /**
+     * Failed to create the freshness rule
+     */
+    500: ErrorResponse;
+};
+export type CreateFreshnessRuleError = CreateFreshnessRuleErrors[keyof CreateFreshnessRuleErrors];
+export type CreateFreshnessRuleResponses = {
+    /**
+     * Rule created successfully
+     */
+    201: FreshnessRule;
+};
+export type CreateFreshnessRuleResponse = CreateFreshnessRuleResponses[keyof CreateFreshnessRuleResponses];
+export type DeleteFreshnessRuleData = {
+    body?: never;
+    path: {
+        /**
+         * Team identifier
+         */
+        team_id: string;
+        /**
+         * Freshness rule identifier
+         */
+        rule_id: string;
+    };
+    query?: never;
+    url: '/api/v1/{team_id}/freshness/rules/{rule_id}';
+};
+export type DeleteFreshnessRuleErrors = {
+    /**
+     * Invalid identifiers
+     */
+    400: ErrorResponse;
+    /**
+     * Authentication required
+     */
+    401: ErrorResponse;
+    /**
+     * Caller may not change the team's settings
+     */
+    403: ErrorResponse;
+    /**
+     * No such rule in this team
+     */
+    404: ErrorResponse;
+    /**
+     * Failed to delete the freshness rule
+     */
+    500: ErrorResponse;
+};
+export type DeleteFreshnessRuleError = DeleteFreshnessRuleErrors[keyof DeleteFreshnessRuleErrors];
+export type DeleteFreshnessRuleResponses = {
+    /**
+     * Rule deleted (no content)
+     */
+    204: void;
+};
+export type DeleteFreshnessRuleResponse = DeleteFreshnessRuleResponses[keyof DeleteFreshnessRuleResponses];
+export type UpdateFreshnessRuleData = {
+    body: UpdateFreshnessRuleRequest;
+    path: {
+        /**
+         * Team identifier
+         */
+        team_id: string;
+        /**
+         * Freshness rule identifier
+         */
+        rule_id: string;
+    };
+    query?: never;
+    url: '/api/v1/{team_id}/freshness/rules/{rule_id}';
+};
+export type UpdateFreshnessRuleErrors = {
+    /**
+     * Invalid identifiers or rule definition
+     */
+    400: ErrorResponse;
+    /**
+     * Authentication required
+     */
+    401: ErrorResponse;
+    /**
+     * Caller may not change the team's settings
+     */
+    403: ErrorResponse;
+    /**
+     * No such rule in this team
+     */
+    404: ErrorResponse;
+    /**
+     * Failed to update the freshness rule
+     */
+    500: ErrorResponse;
+};
+export type UpdateFreshnessRuleError = UpdateFreshnessRuleErrors[keyof UpdateFreshnessRuleErrors];
+export type UpdateFreshnessRuleResponses = {
+    /**
+     * Rule updated successfully
+     */
+    200: FreshnessRule;
+};
+export type UpdateFreshnessRuleResponse = UpdateFreshnessRuleResponses[keyof UpdateFreshnessRuleResponses];
+export type ResetTeamFreshnessSettingsData = {
+    body?: never;
+    path: {
+        /**
+         * Team identifier
+         */
+        team_id: string;
+    };
+    query?: never;
+    url: '/api/v1/{team_id}/settings/freshness';
+};
+export type ResetTeamFreshnessSettingsErrors = {
+    /**
+     * Invalid team_id
+     */
+    400: ErrorResponse;
+    /**
+     * Authentication required
+     */
+    401: ErrorResponse;
+    /**
+     * Caller may not change the team's settings
+     */
+    403: ErrorResponse;
+    /**
+     * Failed to reset the team's freshness settings
+     */
+    500: ErrorResponse;
+};
+export type ResetTeamFreshnessSettingsError = ResetTeamFreshnessSettingsErrors[keyof ResetTeamFreshnessSettingsErrors];
+export type ResetTeamFreshnessSettingsResponses = {
+    /**
+     * Settings reset (no content); the team now inherits the defaults
+     */
+    204: void;
+};
+export type ResetTeamFreshnessSettingsResponse = ResetTeamFreshnessSettingsResponses[keyof ResetTeamFreshnessSettingsResponses];
+export type GetTeamFreshnessSettingsData = {
+    body?: never;
+    path: {
+        /**
+         * Team identifier
+         */
+        team_id: string;
+    };
+    query?: never;
+    url: '/api/v1/{team_id}/settings/freshness';
+};
+export type GetTeamFreshnessSettingsErrors = {
+    /**
+     * Invalid team_id
+     */
+    400: ErrorResponse;
+    /**
+     * Authentication required
+     */
+    401: ErrorResponse;
+    /**
+     * Caller is not a member of the team
+     */
+    403: ErrorResponse;
+    /**
+     * Failed to read the team's freshness settings
+     */
+    500: ErrorResponse;
+};
+export type GetTeamFreshnessSettingsError = GetTeamFreshnessSettingsErrors[keyof GetTeamFreshnessSettingsErrors];
+export type GetTeamFreshnessSettingsResponses = {
+    /**
+     * Settings retrieved successfully
+     */
+    200: TeamFreshnessSettings;
+};
+export type GetTeamFreshnessSettingsResponse = GetTeamFreshnessSettingsResponses[keyof GetTeamFreshnessSettingsResponses];
+export type UpdateTeamFreshnessSettingsData = {
+    body: UpdateTeamFreshnessSettingsRequest;
+    path: {
+        /**
+         * Team identifier
+         */
+        team_id: string;
+    };
+    query?: never;
+    url: '/api/v1/{team_id}/settings/freshness';
+};
+export type UpdateTeamFreshnessSettingsErrors = {
+    /**
+     * Invalid team_id or settings
+     */
+    400: ErrorResponse;
+    /**
+     * Authentication required
+     */
+    401: ErrorResponse;
+    /**
+     * Caller may not change the team's settings
+     */
+    403: ErrorResponse;
+    /**
+     * Failed to update the team's freshness settings
+     */
+    500: ErrorResponse;
+};
+export type UpdateTeamFreshnessSettingsError = UpdateTeamFreshnessSettingsErrors[keyof UpdateTeamFreshnessSettingsErrors];
+export type UpdateTeamFreshnessSettingsResponses = {
+    /**
+     * Settings updated successfully
+     */
+    200: TeamFreshnessSettings;
+};
+export type UpdateTeamFreshnessSettingsResponse = UpdateTeamFreshnessSettingsResponses[keyof UpdateTeamFreshnessSettingsResponses];
 export type ListEmbeddingProvidersSettingsData = {
     body?: never;
     path: {