@vibexp/api-client 0.26.0 → 0.28.0

package/dist/schema.d.ts

@@ -2901,6 +2901,70 @@ export interface paths {
         patch: operations["updateComment"];
         trace?: never;
     };
+    "/api/v1/{team_id}/relations": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List a resource's relations
+         * @description Returns a page of the relations touching the given resource — both directions (the resource as subject or as object) — newest first, each enriched with the other endpoint's resolved title. The caller must be a member of the team.
+         */
+        get: operations["listRelations"];
+        put?: never;
+        /**
+         * Create a relation
+         * @description Creates a typed edge between two resources. Any team member may create a relation; both endpoints must exist in the team and share a project, and the object type must satisfy the relation-type matrix. Creation is idempotent — a duplicate edge returns the existing row with 200 instead of 201.
+         */
+        post: operations["createRelation"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/{team_id}/relations/{relation_id}/confirm": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Confirm a suggested relation
+         * @description Promotes a suggested relation to confirmed, recording the caller as the confirmer. Requires permission to update any resource in the team. Confirming an already-confirmed relation returns 409.
+         */
+        post: operations["confirmRelation"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/{team_id}/relations/{relation_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Delete a relation
+         * @description Deletes a relation. The creator may delete their own; a team admin or owner may delete any relation.
+         */
+        delete: operations["deleteRelation"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/{team_id}/embedding-providers": {
         parameters: {
             query?: never;
@@ -4140,6 +4204,8 @@ export interface components {
              * @example 1
              */
             version: number;
+            /** @description 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: components["schemas"]["RelatedResource"][];
         };
         CreatePromptRequest: {
             /** @example Code Review Template */
@@ -5395,6 +5461,8 @@ export interface components {
             metadata?: {
                 [key: string]: unknown;
             };
+            /** @description 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: components["schemas"]["RelatedResource"][];
         };
         CreateArtifactRequest: {
             /**
@@ -6162,6 +6230,8 @@ export interface components {
              * @example 1
              */
             version: number;
+            /** @description 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: components["schemas"]["RelatedResource"][];
         };
         CreateMemoryRequest: {
             /**
@@ -6457,6 +6527,8 @@ export interface components {
              */
             content_sha?: string;
             source?: components["schemas"]["BlueprintSource"];
+            /** @description 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: components["schemas"]["RelatedResource"][];
         };
         /** @description Read-only import provenance; present only for imported blueprints. */
         BlueprintSource: {
@@ -8300,6 +8372,221 @@ export interface components {
              */
             total_count: number;
         };
+        /** @description A directed, typed edge between two resources within a project. */
+        Relation: {
+            /**
+             * Format: uuid
+             * @description Unique relation identifier
+             * @example 550e8400-e29b-41d4-a716-446655440000
+             */
+            id: string;
+            /**
+             * Format: uuid
+             * @description Owning team
+             * @example 660e8400-e29b-41d4-a716-446655440001
+             */
+            team_id: string;
+            /**
+             * Format: uuid
+             * @description Project both endpoints belong to
+             * @example 990e8400-e29b-41d4-a716-446655440004
+             */
+            project_id: string;
+            /**
+             * @description Subject resource type (artifact, memory, prompt, or blueprint)
+             * @example artifact
+             */
+            from_type: string;
+            /**
+             * Format: uuid
+             * @description Subject resource identifier
+             * @example 770e8400-e29b-41d4-a716-446655440002
+             */
+            from_id: string;
+            /**
+             * @description Object resource type (artifact, memory, prompt, or blueprint)
+             * @example blueprint
+             */
+            to_type: string;
+            /**
+             * Format: uuid
+             * @description Object resource identifier
+             * @example 880e8400-e29b-41d4-a716-446655440003
+             */
+            to_id: string;
+            /**
+             * @description The edge's intent
+             * @example governed-by
+             * @enum {string}
+             */
+            relation_type: "governed-by" | "supersedes" | "built-from" | "explained-by";
+            /**
+             * @description Whether a human or the AI proposed the edge
+             * @example human
+             * @enum {string}
+             */
+            origin: "ai" | "human";
+            /**
+             * @description Tiered-trust lifecycle state
+             * @example confirmed
+             * @enum {string}
+             */
+            status: "suggested" | "confirmed";
+            /**
+             * Format: uuid
+             * @description User who created the edge (absent if that user was deleted)
+             * @example aa0e8400-e29b-41d4-a716-446655440005
+             */
+            created_by?: string;
+            /**
+             * Format: uuid
+             * @description User who confirmed the edge (absent while suggested or if that user was deleted)
+             * @example bb0e8400-e29b-41d4-a716-446655440006
+             */
+            confirmed_by?: string;
+            /**
+             * Format: date-time
+             * @description When the edge was created
+             * @example 2026-07-21T09:00:00Z
+             */
+            created_at: string;
+            /**
+             * Format: date-time
+             * @description When the edge was last updated (e.g. confirmed)
+             * @example 2026-07-21T09:00:00Z
+             */
+            updated_at: string;
+        };
+        /** @description Request body for creating a typed relation between two resources. */
+        CreateRelationRequest: {
+            /**
+             * @description Subject resource type (artifact, memory, prompt, or blueprint)
+             * @example artifact
+             * @enum {string}
+             */
+            from_type: "artifact" | "memory" | "prompt" | "blueprint";
+            /**
+             * Format: uuid
+             * @description Subject resource identifier
+             * @example 770e8400-e29b-41d4-a716-446655440002
+             */
+            from_id: string;
+            /**
+             * @description Object resource type (artifact, memory, prompt, or blueprint)
+             * @example blueprint
+             * @enum {string}
+             */
+            to_type: "artifact" | "memory" | "prompt" | "blueprint";
+            /**
+             * Format: uuid
+             * @description Object resource identifier
+             * @example 880e8400-e29b-41d4-a716-446655440003
+             */
+            to_id: string;
+            /**
+             * @description 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.
+             * @example governed-by
+             * @enum {string}
+             */
+            relation_type: "governed-by" | "supersedes" | "built-from" | "explained-by";
+            /**
+             * @description Whether a human or the AI proposed the edge
+             * @example human
+             * @enum {string}
+             */
+            origin: "ai" | "human";
+        };
+        /** @description 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. */
+        RelatedResource: {
+            /**
+             * Format: uuid
+             * @description The relation this entry came from
+             * @example 550e8400-e29b-41d4-a716-446655440000
+             */
+            relation_id: string;
+            /**
+             * @description The edge's intent
+             * @example governed-by
+             * @enum {string}
+             */
+            relation_type: "governed-by" | "supersedes" | "built-from" | "explained-by";
+            /**
+             * @description Whether the queried resource is the subject (outgoing) or object (incoming) of the edge
+             * @example outgoing
+             * @enum {string}
+             */
+            direction: "outgoing" | "incoming";
+            /**
+             * @description Whether a human or the AI proposed the edge
+             * @example human
+             * @enum {string}
+             */
+            origin: "ai" | "human";
+            /**
+             * @description Tiered-trust lifecycle state
+             * @example confirmed
+             * @enum {string}
+             */
+            status: "suggested" | "confirmed";
+            /**
+             * @description Type of the related (other) resource
+             * @example blueprint
+             */
+            resource_type: string;
+            /**
+             * Format: uuid
+             * @description Identifier of the related (other) resource
+             * @example 880e8400-e29b-41d4-a716-446655440003
+             */
+            resource_id: string;
+            /**
+             * @description Resolved display title of the related resource
+             * @example Go coding standards
+             */
+            title: string;
+            /**
+             * Format: uuid
+             * @description Project the related resource belongs to
+             * @example 990e8400-e29b-41d4-a716-446655440004
+             */
+            project_id?: string;
+            /**
+             * @description Related resource slug for the detail link (absent for memories)
+             * @example go-coding-standards
+             */
+            slug?: string;
+            /**
+             * Format: date-time
+             * @description When the edge was created
+             * @example 2026-07-21T09:00:00Z
+             */
+            created_at: string;
+        };
+        /** @description A page of the relations touching a resource (both directions), newest first. */
+        RelationListResponse: {
+            /** @description Relations touching the resource, newest first */
+            relations: components["schemas"]["RelatedResource"][];
+            /**
+             * @description Total number of relations touching the resource
+             * @example 3
+             */
+            total_count: number;
+            /**
+             * @description Current page number
+             * @example 1
+             */
+            page: number;
+            /**
+             * @description Number of items per page
+             * @example 20
+             */
+            per_page: number;
+            /**
+             * @description Total number of pages
+             * @example 1
+             */
+            total_pages: number;
+        };
         /** @description Instance-wide totals for the top-level entities (unscoped counts). */
         AdminInstanceCounts: {
             /**
@@ -18954,6 +19241,302 @@ export interface operations {
             };
         };
     };
+    listRelations: {
+        parameters: {
+            query: {
+                /** @description Type of the resource whose relations to list (artifact, memory, prompt, or blueprint) */
+                resource_type: string;
+                /** @description Identifier of the resource whose relations to list */
+                resource_id: string;
+                /** @description Page number (1-based) */
+                page?: number;
+                /** @description Items per page */
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                /** @description Team identifier */
+                team_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Relations retrieved successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RelationListResponse"];
+                };
+            };
+            /** @description Invalid resource_type or query parameters */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Caller is not a member of the team */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Failed to list relations */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    createRelation: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Team identifier */
+                team_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateRelationRequest"];
+            };
+        };
+        responses: {
+            /** @description Relation already existed; the existing edge is returned (idempotent create) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Relation"];
+                };
+            };
+            /** @description Relation created successfully */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Relation"];
+                };
+            };
+            /** @description Invalid types, self-link, cross-project link, or matrix violation */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Caller may not create relations in the team */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description One of the endpoints does not exist in the team */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Failed to create relation */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    confirmRelation: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Team identifier */
+                team_id: string;
+                /** @description Relation identifier */
+                relation_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Relation confirmed successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Relation"];
+                };
+            };
+            /** @description relation_id is not a valid UUID */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Caller may not confirm relations in the team */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Relation not found in the team */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Relation is already confirmed */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Failed to confirm relation */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    deleteRelation: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Team identifier */
+                team_id: string;
+                /** @description Relation identifier */
+                relation_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Relation deleted (no content) */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description relation_id is not a valid UUID */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Caller may not delete this relation */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Relation not found in the team */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Failed to delete relation */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
     listEmbeddingProviders: {
         parameters: {
             query?: never;

package/package.json

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