@nexusm/sdk 2.0.0 → 4.0.0

package/dist/index.js

@@ -55,7 +55,6 @@ __export(index_exports, {
   apiKeyCreateSchema: () => apiKeyCreateSchema,
   contextRequestSchema: () => contextRequestSchema,
   conversationCreateSchema: () => conversationCreateSchema,
-  entityCreateSchema: () => entityCreateSchema,
   extractionRequestSchema: () => extractionRequestSchema,
   graphQueryRequestSchema: () => graphQueryRequestSchema,
   memoryCreateSchema: () => memoryCreateSchema,
@@ -1124,10 +1123,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) {
@@ -1198,12 +1201,6 @@ var ConversationService = class extends BaseService {
 
 // src/schemas/knowledge.ts
 var import_zod4 = require("zod");
-var entityCreateSchema = import_zod4.z.object({
-  name: import_zod4.z.string().min(1),
-  entity_type: import_zod4.z.string().min(1),
-  description: import_zod4.z.string().optional(),
-  properties: import_zod4.z.record(import_zod4.z.unknown()).optional()
-});
 var graphQueryRequestSchema = import_zod4.z.object({
   entity_name: import_zod4.z.string().min(1),
   depth: import_zod4.z.number().int().min(1).max(3).optional(),
@@ -1218,22 +1215,9 @@ var extractionRequestSchema = import_zod4.z.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) {
@@ -1320,15 +1304,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.
@@ -1468,11 +1459,10 @@ var NexusClient = class {
 
 // src/schemas/tenant.ts
 var import_zod5 = require("zod");
-var apiKeyScopeSchema = import_zod5.z.enum(["read", "write", "admin"]);
 var apiKeyCreateSchema = import_zod5.z.object({
-  name: import_zod5.z.string().min(1).max(100),
-  scopes: import_zod5.z.array(apiKeyScopeSchema).optional(),
-  expires_days: import_zod5.z.number().int().min(1).max(365).optional()
+  name: import_zod5.z.string().min(1).max(255),
+  scopes: import_zod5.z.array(import_zod5.z.string()).optional(),
+  expires_in_days: import_zod5.z.number().int().min(1).max(365).optional()
 });
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
@@ -1501,7 +1491,6 @@ var apiKeyCreateSchema = import_zod5.z.object({
   apiKeyCreateSchema,
   contextRequestSchema,
   conversationCreateSchema,
-  entityCreateSchema,
   extractionRequestSchema,
   graphQueryRequestSchema,
   memoryCreateSchema,