@vibexp/api-client 0.26.0 → 0.28.0

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

@@ -288,6 +288,10 @@ export type Prompt = {
      * Version number for optimistic concurrency control
      */
     version: number;
+    /**
+     * Depth-1 typed neighborhood of this resource — the relations touching it in both directions, newest first, capped at 20. Typed summaries only, never bodies. Populated on the detail GET; empty in list responses.
+     */
+    related: Array<RelatedResource>;
 };
 export type CreatePromptRequest = {
     name: string;
@@ -1227,6 +1231,10 @@ export type Artifact = {
     metadata?: {
         [key: string]: unknown;
     };
+    /**
+     * Depth-1 typed neighborhood of this resource — the relations touching it in both directions, newest first, capped at 20. Typed summaries only, never bodies. Populated on the detail GET; empty in list responses.
+     */
+    related: Array<RelatedResource>;
 };
 export type CreateArtifactRequest = {
     /**
@@ -1809,6 +1817,10 @@ export type Memory = {
      * Version number for optimistic concurrency control
      */
     version: number;
+    /**
+     * Depth-1 typed neighborhood of this resource — the relations touching it in both directions, newest first, capped at 20. Typed summaries only, never bodies. Populated on the detail GET; empty in list responses.
+     */
+    related: Array<RelatedResource>;
 };
 export type CreateMemoryRequest = {
     /**
@@ -2028,6 +2040,10 @@ export type Blueprint = {
      */
     content_sha?: string;
     source?: BlueprintSource;
+    /**
+     * Depth-1 typed neighborhood of this resource — the relations touching it in both directions, newest first, capped at 20. Typed summaries only, never bodies. Populated on the detail GET; empty in list responses.
+     */
+    related: Array<RelatedResource>;
 };
 /**
  * Read-only import provenance; present only for imported blueprints.
@@ -3665,6 +3681,172 @@ export type RecentCommentListResponse = {
      */
     total_count: number;
 };
+/**
+ * A directed, typed edge between two resources within a project.
+ */
+export type Relation = {
+    /**
+     * Unique relation identifier
+     */
+    id: string;
+    /**
+     * Owning team
+     */
+    team_id: string;
+    /**
+     * Project both endpoints belong to
+     */
+    project_id: string;
+    /**
+     * Subject resource type (artifact, memory, prompt, or blueprint)
+     */
+    from_type: string;
+    /**
+     * Subject resource identifier
+     */
+    from_id: string;
+    /**
+     * Object resource type (artifact, memory, prompt, or blueprint)
+     */
+    to_type: string;
+    /**
+     * Object resource identifier
+     */
+    to_id: string;
+    /**
+     * The edge's intent
+     */
+    relation_type: 'governed-by' | 'supersedes' | 'built-from' | 'explained-by';
+    /**
+     * Whether a human or the AI proposed the edge
+     */
+    origin: 'ai' | 'human';
+    /**
+     * Tiered-trust lifecycle state
+     */
+    status: 'suggested' | 'confirmed';
+    /**
+     * User who created the edge (absent if that user was deleted)
+     */
+    created_by?: string;
+    /**
+     * User who confirmed the edge (absent while suggested or if that user was deleted)
+     */
+    confirmed_by?: string;
+    /**
+     * When the edge was created
+     */
+    created_at: string;
+    /**
+     * When the edge was last updated (e.g. confirmed)
+     */
+    updated_at: string;
+};
+/**
+ * Request body for creating a typed relation between two resources.
+ */
+export type CreateRelationRequest = {
+    /**
+     * Subject resource type (artifact, memory, prompt, or blueprint)
+     */
+    from_type: 'artifact' | 'memory' | 'prompt' | 'blueprint';
+    /**
+     * Subject resource identifier
+     */
+    from_id: string;
+    /**
+     * Object resource type (artifact, memory, prompt, or blueprint)
+     */
+    to_type: 'artifact' | 'memory' | 'prompt' | 'blueprint';
+    /**
+     * Object resource identifier
+     */
+    to_id: string;
+    /**
+     * The edge's intent. The object type is constrained per relation type: governed-by -> blueprint, built-from -> prompt, explained-by -> memory, supersedes -> same type as the subject.
+     *
+     */
+    relation_type: 'governed-by' | 'supersedes' | 'built-from' | 'explained-by';
+    /**
+     * Whether a human or the AI proposed the edge
+     */
+    origin: 'ai' | 'human';
+};
+/**
+ * One endpoint of a relation as seen from the other endpoint, enriched with the related resource's resolved title and link fields. project_id is present for every type; slug is present for artifact/blueprint/prompt and absent for memory.
+ *
+ */
+export type RelatedResource = {
+    /**
+     * The relation this entry came from
+     */
+    relation_id: string;
+    /**
+     * The edge's intent
+     */
+    relation_type: 'governed-by' | 'supersedes' | 'built-from' | 'explained-by';
+    /**
+     * Whether the queried resource is the subject (outgoing) or object (incoming) of the edge
+     */
+    direction: 'outgoing' | 'incoming';
+    /**
+     * Whether a human or the AI proposed the edge
+     */
+    origin: 'ai' | 'human';
+    /**
+     * Tiered-trust lifecycle state
+     */
+    status: 'suggested' | 'confirmed';
+    /**
+     * Type of the related (other) resource
+     */
+    resource_type: string;
+    /**
+     * Identifier of the related (other) resource
+     */
+    resource_id: string;
+    /**
+     * Resolved display title of the related resource
+     */
+    title: string;
+    /**
+     * Project the related resource belongs to
+     */
+    project_id?: string;
+    /**
+     * Related resource slug for the detail link (absent for memories)
+     */
+    slug?: string;
+    /**
+     * When the edge was created
+     */
+    created_at: string;
+};
+/**
+ * A page of the relations touching a resource (both directions), newest first.
+ */
+export type RelationListResponse = {
+    /**
+     * Relations touching the resource, newest first
+     */
+    relations: Array<RelatedResource>;
+    /**
+     * Total number of relations touching the resource
+     */
+    total_count: number;
+    /**
+     * Current page number
+     */
+    page: number;
+    /**
+     * Number of items per page
+     */
+    per_page: number;
+    /**
+     * Total number of pages
+     */
+    total_pages: number;
+};
 /**
  * Instance-wide totals for the top-level entities (unscoped counts).
  */
@@ -11107,6 +11289,199 @@ export type UpdateCommentResponses = {
     200: Comment;
 };
 export type UpdateCommentResponse = UpdateCommentResponses[keyof UpdateCommentResponses];
+export type ListRelationsData = {
+    body?: never;
+    path: {
+        /**
+         * Team identifier
+         */
+        team_id: string;
+    };
+    query: {
+        /**
+         * Type of the resource whose relations to list (artifact, memory, prompt, or blueprint)
+         */
+        resource_type: string;
+        /**
+         * Identifier of the resource whose relations to list
+         */
+        resource_id: string;
+        /**
+         * Page number (1-based)
+         */
+        page?: number;
+        /**
+         * Items per page
+         */
+        limit?: number;
+    };
+    url: '/api/v1/{team_id}/relations';
+};
+export type ListRelationsErrors = {
+    /**
+     * Invalid resource_type or query parameters
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized
+     */
+    401: ErrorResponse;
+    /**
+     * Caller is not a member of the team
+     */
+    403: ErrorResponse;
+    /**
+     * Failed to list relations
+     */
+    500: ErrorResponse;
+};
+export type ListRelationsError = ListRelationsErrors[keyof ListRelationsErrors];
+export type ListRelationsResponses = {
+    /**
+     * Relations retrieved successfully
+     */
+    200: RelationListResponse;
+};
+export type ListRelationsResponse = ListRelationsResponses[keyof ListRelationsResponses];
+export type CreateRelationData = {
+    body: CreateRelationRequest;
+    path: {
+        /**
+         * Team identifier
+         */
+        team_id: string;
+    };
+    query?: never;
+    url: '/api/v1/{team_id}/relations';
+};
+export type CreateRelationErrors = {
+    /**
+     * Invalid types, self-link, cross-project link, or matrix violation
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized
+     */
+    401: ErrorResponse;
+    /**
+     * Caller may not create relations in the team
+     */
+    403: ErrorResponse;
+    /**
+     * One of the endpoints does not exist in the team
+     */
+    404: ErrorResponse;
+    /**
+     * Failed to create relation
+     */
+    500: ErrorResponse;
+};
+export type CreateRelationError = CreateRelationErrors[keyof CreateRelationErrors];
+export type CreateRelationResponses = {
+    /**
+     * Relation already existed; the existing edge is returned (idempotent create)
+     */
+    200: Relation;
+    /**
+     * Relation created successfully
+     */
+    201: Relation;
+};
+export type CreateRelationResponse = CreateRelationResponses[keyof CreateRelationResponses];
+export type ConfirmRelationData = {
+    body?: never;
+    path: {
+        /**
+         * Team identifier
+         */
+        team_id: string;
+        /**
+         * Relation identifier
+         */
+        relation_id: string;
+    };
+    query?: never;
+    url: '/api/v1/{team_id}/relations/{relation_id}/confirm';
+};
+export type ConfirmRelationErrors = {
+    /**
+     * relation_id is not a valid UUID
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized
+     */
+    401: ErrorResponse;
+    /**
+     * Caller may not confirm relations in the team
+     */
+    403: ErrorResponse;
+    /**
+     * Relation not found in the team
+     */
+    404: ErrorResponse;
+    /**
+     * Relation is already confirmed
+     */
+    409: ErrorResponse;
+    /**
+     * Failed to confirm relation
+     */
+    500: ErrorResponse;
+};
+export type ConfirmRelationError = ConfirmRelationErrors[keyof ConfirmRelationErrors];
+export type ConfirmRelationResponses = {
+    /**
+     * Relation confirmed successfully
+     */
+    200: Relation;
+};
+export type ConfirmRelationResponse = ConfirmRelationResponses[keyof ConfirmRelationResponses];
+export type DeleteRelationData = {
+    body?: never;
+    path: {
+        /**
+         * Team identifier
+         */
+        team_id: string;
+        /**
+         * Relation identifier
+         */
+        relation_id: string;
+    };
+    query?: never;
+    url: '/api/v1/{team_id}/relations/{relation_id}';
+};
+export type DeleteRelationErrors = {
+    /**
+     * relation_id is not a valid UUID
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized
+     */
+    401: ErrorResponse;
+    /**
+     * Caller may not delete this relation
+     */
+    403: ErrorResponse;
+    /**
+     * Relation not found in the team
+     */
+    404: ErrorResponse;
+    /**
+     * Failed to delete relation
+     */
+    500: ErrorResponse;
+};
+export type DeleteRelationError = DeleteRelationErrors[keyof DeleteRelationErrors];
+export type DeleteRelationResponses = {
+    /**
+     * Relation deleted (no content)
+     */
+    204: void;
+};
+export type DeleteRelationResponse = DeleteRelationResponses[keyof DeleteRelationResponses];
 export type ListEmbeddingProvidersData = {
     body?: never;
     path: {