@nexusm/sdk 2.0.0 → 4.0.0

package/dist/index.mjs

@@ -1056,10 +1056,14 @@ var ConversationService = class extends BaseService {
     return this.http.get("/conversations", params, options?.signal);
   }
   /**
-   * Retrieve a conversation with its messages included.
+   * Retrieve a conversation.
    *
-   * @param conversationId - UUID of the conversation to retrieve.
-   * @returns Conversation detail including the full message list.
+   * v4.0.0 BREAKING: returns `Conversation` — the backend response has no
+   * `messages` array (the previous `ConversationDetail` shape was a
+   * phantom). Fetch messages via {@link getMessages}.
+   *
+   * @param conversationId - Compound conversation ID to retrieve.
+   * @returns The conversation record.
    * @throws {ApiError} 404 if the conversation does not exist.
    */
   async get(conversationId, options) {
@@ -1130,12 +1134,6 @@ var ConversationService = class extends BaseService {
 
 // src/schemas/knowledge.ts
 import { z as z4 } from "zod";
-var entityCreateSchema = z4.object({
-  name: z4.string().min(1),
-  entity_type: z4.string().min(1),
-  description: z4.string().optional(),
-  properties: z4.record(z4.unknown()).optional()
-});
 var graphQueryRequestSchema = z4.object({
   entity_name: z4.string().min(1),
   depth: z4.number().int().min(1).max(3).optional(),
@@ -1150,22 +1148,9 @@ var extractionRequestSchema = z4.object({
 // src/services/knowledge.ts
 var KnowledgeService = class extends BaseService {
   /**
-   * Create a new knowledge entity in the graph.
-   *
-   * @param data - Entity creation payload including name, type, and optional description/properties.
-   * @returns The newly created entity with generated entity_id.
-   */
-  async createEntity(data, options) {
-    const parsed = entityCreateSchema.safeParse(data);
-    if (!parsed.success) {
-      throw new InputValidationError(parsed.error);
-    }
-    return this.http.post("/knowledge/entities", data, options?.signal);
-  }
-  /**
-   * List knowledge entities with optional filtering.
+   * List knowledge entities for a user with optional filtering.
    *
-   * @param params - Optional filters for user_id, entity_type, and pagination controls.
+   * @param params - Filters: required user_id (backend-enforced), optional entity_type and pagination controls.
    * @returns Paginated list of knowledge entities.
    */
   async listEntities(params, options) {
@@ -1252,15 +1237,22 @@ var TenantService = class extends BaseService {
     return this.http.get("/tenants/me", void 0, options?.signal);
   }
   /**
-   * Retrieve the current tenant's resource usage statistics.
+   * Retrieve the current tenant's usage statistics.
    *
-   * Returns counts for memories, conversations, and today's API calls.
-   * Useful for monitoring quota consumption and building dashboards.
+   * Returns API-call counts, success rate, latency percentiles, resource
+   * counts, and storage usage for the requested period — the backend
+   * `UsageStatsResponse` shape (v3.0.0: previously mistyped as a 3-field
+   * `TenantUsage` that never matched the wire).
    *
-   * @returns Current resource usage for the authenticated tenant.
+   * @param period - Statistics window: `'day'` (default) | `'week'` | `'month'`.
+   * @returns Usage statistics for the authenticated tenant.
    */
-  async usage(options) {
-    return this.http.get("/tenants/me/usage", void 0, options?.signal);
+  async usage(period, options) {
+    return this.http.get(
+      "/tenants/me/usage",
+      period ? { period } : void 0,
+      options?.signal
+    );
   }
   /**
    * List all API keys for the current tenant.
@@ -1400,11 +1392,10 @@ var NexusClient = class {
 
 // src/schemas/tenant.ts
 import { z as z5 } from "zod";
-var apiKeyScopeSchema = z5.enum(["read", "write", "admin"]);
 var apiKeyCreateSchema = z5.object({
-  name: z5.string().min(1).max(100),
-  scopes: z5.array(apiKeyScopeSchema).optional(),
-  expires_days: z5.number().int().min(1).max(365).optional()
+  name: z5.string().min(1).max(255),
+  scopes: z5.array(z5.string()).optional(),
+  expires_in_days: z5.number().int().min(1).max(365).optional()
 });
 export {
   ActivityService,
@@ -1432,7 +1423,6 @@ export {
   apiKeyCreateSchema,
   contextRequestSchema,
   conversationCreateSchema,
-  entityCreateSchema,
   extractionRequestSchema,
   graphQueryRequestSchema,
   memoryCreateSchema,