@mnexium/sdk 0.1.0 → 0.2.0

package/dist/index.d.mts

@@ -258,6 +258,15 @@ interface MnxOptions {
     metadata?: Record<string, unknown>;
     /** Force regenerate trial key (for key recovery) */
     regenerateKey?: boolean;
+    /** Records configuration */
+    records?: {
+        /** Enable record recall (inject existing records as context) */
+        recall?: boolean;
+        /** Enable record extraction: true = async, "sync" = await and return results (non-streaming only) */
+        learn?: boolean | 'sync';
+        /** Limit extraction to specific record types */
+        types?: string[];
+    };
 }
 interface ChatCompletionOptions extends MnxOptions {
     /** Model to use (e.g., 'gpt-4o-mini', 'claude-3-sonnet', 'gemini-1.5-pro') */
@@ -419,6 +428,74 @@ interface SystemPromptCreateOptions {
     /** Set as default prompt for the project */
     isDefault?: boolean;
 }
+/** A record schema definition */
+interface RecordSchema {
+    project_id: string;
+    type_name: string;
+    fields: Record<string, RecordFieldDef>;
+    display_name?: string;
+    description?: string;
+    created_at: string;
+    updated_at: string;
+}
+/** A field definition within a record schema */
+interface RecordFieldDef {
+    type: string;
+    required?: boolean;
+    description?: string;
+    display_name?: string;
+}
+/** Options for defining a record schema */
+interface RecordSchemaDefineOptions {
+    /** Record type name (e.g. 'deal', 'contact') */
+    typeName: string;
+    /** Field definitions */
+    fields: Record<string, RecordFieldDef>;
+    /** Human-readable display name */
+    displayName?: string;
+    /** Description of this record type */
+    description?: string;
+}
+/** A record instance */
+interface MnxRecord {
+    record_id: string;
+    project_id: string;
+    type_name: string;
+    owner_id?: string;
+    visibility: 'public' | 'private';
+    collaborators?: string[];
+    data: globalThis.Record<string, unknown>;
+    summary_text?: string;
+    is_deleted?: boolean;
+    created_at: string;
+    updated_at: string;
+}
+/** Options for inserting a record */
+interface RecordInsertOptions {
+    /** Record data */
+    data: globalThis.Record<string, unknown>;
+    /** Owner subject ID */
+    ownerId?: string;
+    /** Visibility: 'public' (default) or 'private' */
+    visibility?: 'public' | 'private';
+    /** Subject IDs with write access (in addition to the owner) */
+    collaborators?: string[];
+}
+/** Options for querying records */
+interface RecordQueryOptions {
+    /** JSONB field filters */
+    where?: globalThis.Record<string, unknown>;
+    /** Order by field (prefix with - for DESC) */
+    orderBy?: string;
+    /** Maximum results */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+}
+/** A record search result with similarity score */
+interface RecordSearchResult extends MnxRecord {
+    similarity: number;
+}
 
 /**
  * Streaming support for Mnexium SDK
@@ -597,6 +674,7 @@ declare class SubjectMemoriesResource {
         source?: string;
         visibility?: 'private' | 'shared';
         metadata?: Record<string, unknown>;
+        no_supersede?: boolean;
     }): Promise<any>;
     list(options?: {
         limit?: number;
@@ -731,7 +809,13 @@ declare class ChatResource {
 declare class ChatCompletionsResource {
     private readonly client;
     constructor(client: Mnexium);
-    create(options: ChatCompletionOptions): Promise<ChatCompletionResponse>;
+    create(options: ChatCompletionOptions & {
+        stream: true;
+    }): Promise<StreamResponse>;
+    create(options: ChatCompletionOptions & {
+        stream?: false;
+    }): Promise<ChatCompletionResponse>;
+    create(options: ChatCompletionOptions): Promise<ChatCompletionResponse | StreamResponse>;
 }
 
 /**
@@ -806,6 +890,84 @@ declare class PromptsResource {
     }): Promise<any>;
 }
 
+/**
+ * Records Resource - Structured data management API
+ */
+
+declare class RecordsResource {
+    private readonly client;
+    constructor(client: Mnexium);
+    /**
+     * Define or update a record schema
+     *
+     * @example
+     * await mnx.records.defineSchema('deal', {
+     *   title: { type: 'string', required: true },
+     *   value: { type: 'number' },
+     *   stage: { type: 'string' },
+     *   account_id: { type: 'ref:account' },
+     * }, { displayName: 'Deal', description: 'Sales deals' });
+     */
+    defineSchema(typeName: string, fields: RecordSchemaDefineOptions['fields'], opts?: {
+        displayName?: string;
+        description?: string;
+    }): Promise<RecordSchema>;
+    /**
+     * Get a schema by type name
+     */
+    getSchema(typeName: string): Promise<RecordSchema | null>;
+    /**
+     * List all schemas for the project
+     */
+    listSchemas(): Promise<RecordSchema[]>;
+    /**
+     * Insert a new record
+     *
+     * @example
+     * const deal = await mnx.records.insert('deal', {
+     *   title: 'Acme Renewal',
+     *   value: 500000,
+     *   stage: 'negotiation',
+     * });
+     */
+    insert(typeName: string, data: Record<string, unknown>, opts?: Omit<RecordInsertOptions, 'data'>): Promise<MnxRecord>;
+    /**
+     * Get a record by ID
+     */
+    get(typeName: string, recordId: string): Promise<MnxRecord | null>;
+    /**
+     * Update a record (partial merge)
+     *
+     * @example
+     * await mnx.records.update('deal', 'rec_abc', { stage: 'closed_won', value: 550000 });
+     */
+    update(typeName: string, recordId: string, data: Record<string, unknown>): Promise<MnxRecord>;
+    /**
+     * Soft-delete a record
+     */
+    delete(typeName: string, recordId: string): Promise<void>;
+    /**
+     * Query records with JSONB filters
+     *
+     * @example
+     * const deals = await mnx.records.query('deal', {
+     *   where: { stage: 'closed_won' },
+     *   orderBy: '-value',
+     *   limit: 10,
+     * });
+     */
+    query(typeName: string, opts?: RecordQueryOptions): Promise<MnxRecord[]>;
+    /**
+     * Semantic search across records
+     *
+     * @example
+     * const results = await mnx.records.search('deal', 'large enterprise renewal');
+     */
+    search(typeName: string, query: string, opts?: {
+        limit?: number;
+    }): Promise<RecordSearchResult[]>;
+}
+
 /**
  * Mnexium SDK Client
  */
@@ -826,6 +988,7 @@ declare class Mnexium {
     readonly profiles: ProfilesResource;
     readonly state: StateResource;
     readonly prompts: PromptsResource;
+    readonly records: RecordsResource;
     constructor(config?: MnexiumConfig);
     /**
      * Process a message with Mnexium's memory-enhanced AI
@@ -903,6 +1066,7 @@ declare class Mnexium {
         body?: unknown;
         headers?: Record<string, string>;
         query?: Record<string, string | number | boolean | undefined>;
+        signal?: AbortSignal;
     }): Promise<Response>;
     /**
      * Internal: Make an API request

package/dist/index.d.ts

@@ -258,6 +258,15 @@ interface MnxOptions {
     metadata?: Record<string, unknown>;
     /** Force regenerate trial key (for key recovery) */
     regenerateKey?: boolean;
+    /** Records configuration */
+    records?: {
+        /** Enable record recall (inject existing records as context) */
+        recall?: boolean;
+        /** Enable record extraction: true = async, "sync" = await and return results (non-streaming only) */
+        learn?: boolean | 'sync';
+        /** Limit extraction to specific record types */
+        types?: string[];
+    };
 }
 interface ChatCompletionOptions extends MnxOptions {
     /** Model to use (e.g., 'gpt-4o-mini', 'claude-3-sonnet', 'gemini-1.5-pro') */
@@ -419,6 +428,74 @@ interface SystemPromptCreateOptions {
     /** Set as default prompt for the project */
     isDefault?: boolean;
 }
+/** A record schema definition */
+interface RecordSchema {
+    project_id: string;
+    type_name: string;
+    fields: Record<string, RecordFieldDef>;
+    display_name?: string;
+    description?: string;
+    created_at: string;
+    updated_at: string;
+}
+/** A field definition within a record schema */
+interface RecordFieldDef {
+    type: string;
+    required?: boolean;
+    description?: string;
+    display_name?: string;
+}
+/** Options for defining a record schema */
+interface RecordSchemaDefineOptions {
+    /** Record type name (e.g. 'deal', 'contact') */
+    typeName: string;
+    /** Field definitions */
+    fields: Record<string, RecordFieldDef>;
+    /** Human-readable display name */
+    displayName?: string;
+    /** Description of this record type */
+    description?: string;
+}
+/** A record instance */
+interface MnxRecord {
+    record_id: string;
+    project_id: string;
+    type_name: string;
+    owner_id?: string;
+    visibility: 'public' | 'private';
+    collaborators?: string[];
+    data: globalThis.Record<string, unknown>;
+    summary_text?: string;
+    is_deleted?: boolean;
+    created_at: string;
+    updated_at: string;
+}
+/** Options for inserting a record */
+interface RecordInsertOptions {
+    /** Record data */
+    data: globalThis.Record<string, unknown>;
+    /** Owner subject ID */
+    ownerId?: string;
+    /** Visibility: 'public' (default) or 'private' */
+    visibility?: 'public' | 'private';
+    /** Subject IDs with write access (in addition to the owner) */
+    collaborators?: string[];
+}
+/** Options for querying records */
+interface RecordQueryOptions {
+    /** JSONB field filters */
+    where?: globalThis.Record<string, unknown>;
+    /** Order by field (prefix with - for DESC) */
+    orderBy?: string;
+    /** Maximum results */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+}
+/** A record search result with similarity score */
+interface RecordSearchResult extends MnxRecord {
+    similarity: number;
+}
 
 /**
  * Streaming support for Mnexium SDK
@@ -597,6 +674,7 @@ declare class SubjectMemoriesResource {
         source?: string;
         visibility?: 'private' | 'shared';
         metadata?: Record<string, unknown>;
+        no_supersede?: boolean;
     }): Promise<any>;
     list(options?: {
         limit?: number;
@@ -731,7 +809,13 @@ declare class ChatResource {
 declare class ChatCompletionsResource {
     private readonly client;
     constructor(client: Mnexium);
-    create(options: ChatCompletionOptions): Promise<ChatCompletionResponse>;
+    create(options: ChatCompletionOptions & {
+        stream: true;
+    }): Promise<StreamResponse>;
+    create(options: ChatCompletionOptions & {
+        stream?: false;
+    }): Promise<ChatCompletionResponse>;
+    create(options: ChatCompletionOptions): Promise<ChatCompletionResponse | StreamResponse>;
 }
 
 /**
@@ -806,6 +890,84 @@ declare class PromptsResource {
     }): Promise<any>;
 }
 
+/**
+ * Records Resource - Structured data management API
+ */
+
+declare class RecordsResource {
+    private readonly client;
+    constructor(client: Mnexium);
+    /**
+     * Define or update a record schema
+     *
+     * @example
+     * await mnx.records.defineSchema('deal', {
+     *   title: { type: 'string', required: true },
+     *   value: { type: 'number' },
+     *   stage: { type: 'string' },
+     *   account_id: { type: 'ref:account' },
+     * }, { displayName: 'Deal', description: 'Sales deals' });
+     */
+    defineSchema(typeName: string, fields: RecordSchemaDefineOptions['fields'], opts?: {
+        displayName?: string;
+        description?: string;
+    }): Promise<RecordSchema>;
+    /**
+     * Get a schema by type name
+     */
+    getSchema(typeName: string): Promise<RecordSchema | null>;
+    /**
+     * List all schemas for the project
+     */
+    listSchemas(): Promise<RecordSchema[]>;
+    /**
+     * Insert a new record
+     *
+     * @example
+     * const deal = await mnx.records.insert('deal', {
+     *   title: 'Acme Renewal',
+     *   value: 500000,
+     *   stage: 'negotiation',
+     * });
+     */
+    insert(typeName: string, data: Record<string, unknown>, opts?: Omit<RecordInsertOptions, 'data'>): Promise<MnxRecord>;
+    /**
+     * Get a record by ID
+     */
+    get(typeName: string, recordId: string): Promise<MnxRecord | null>;
+    /**
+     * Update a record (partial merge)
+     *
+     * @example
+     * await mnx.records.update('deal', 'rec_abc', { stage: 'closed_won', value: 550000 });
+     */
+    update(typeName: string, recordId: string, data: Record<string, unknown>): Promise<MnxRecord>;
+    /**
+     * Soft-delete a record
+     */
+    delete(typeName: string, recordId: string): Promise<void>;
+    /**
+     * Query records with JSONB filters
+     *
+     * @example
+     * const deals = await mnx.records.query('deal', {
+     *   where: { stage: 'closed_won' },
+     *   orderBy: '-value',
+     *   limit: 10,
+     * });
+     */
+    query(typeName: string, opts?: RecordQueryOptions): Promise<MnxRecord[]>;
+    /**
+     * Semantic search across records
+     *
+     * @example
+     * const results = await mnx.records.search('deal', 'large enterprise renewal');
+     */
+    search(typeName: string, query: string, opts?: {
+        limit?: number;
+    }): Promise<RecordSearchResult[]>;
+}
+
 /**
  * Mnexium SDK Client
  */
@@ -826,6 +988,7 @@ declare class Mnexium {
     readonly profiles: ProfilesResource;
     readonly state: StateResource;
     readonly prompts: PromptsResource;
+    readonly records: RecordsResource;
     constructor(config?: MnexiumConfig);
     /**
      * Process a message with Mnexium's memory-enhanced AI
@@ -903,6 +1066,7 @@ declare class Mnexium {
         body?: unknown;
         headers?: Record<string, string>;
         query?: Record<string, string | number | boolean | undefined>;
+        signal?: AbortSignal;
     }): Promise<Response>;
     /**
      * Internal: Make an API request

package/dist/index.js

@@ -116,7 +116,8 @@ var EventStream = class {
   }
   async *[Symbol.asyncIterator]() {
     const response = await this.client._requestRaw("GET", "/events/memories", {
-      query: { subject_id: this.subjectId }
+      query: { subject_id: this.subjectId },
+      signal: this.abortController.signal
     });
     if (!response.body) {
       throw new Error("Response body is null \u2014 SSE not supported");
@@ -205,7 +206,8 @@ var SubjectMemoriesResource = class {
         text,
         source: options?.source,
         visibility: options?.visibility,
-        metadata: options?.metadata
+        metadata: options?.metadata,
+        no_supersede: options?.no_supersede
       }
     });
   }
@@ -619,9 +621,23 @@ var ChatCompletionsResource = class {
         state: options.state,
         system_prompt: options.systemPrompt,
         metadata: options.metadata,
-        regenerate_key: options.regenerateKey
+        regenerate_key: options.regenerateKey,
+        records: options.records
       }
     };
+    if (options.stream) {
+      const response = await this.client._requestRaw("POST", "/chat/completions", {
+        body,
+        headers
+      });
+      return new StreamResponse(response, {
+        chatId: response.headers.get("X-Mnx-Chat-Id") || options.chatId || "",
+        subjectId: response.headers.get("X-Mnx-Subject-Id") || options.subjectId || "",
+        model: options.model,
+        provisionedKey: response.headers.get("X-Mnx-Key-Provisioned") || void 0,
+        claimUrl: response.headers.get("X-Mnx-Claim-Url") || void 0
+      });
+    }
     return this.client._request("POST", "/chat/completions", {
       body,
       headers
@@ -656,20 +672,18 @@ var MemoriesResource = class {
         offset: options?.offset
       }
     });
-    return response.memories;
+    return response.data || [];
   }
   async search(options) {
-    const response = await this.client._request("POST", "/memories/search", {
-      body: {
+    const response = await this.client._request("GET", "/memories/search", {
+      query: {
         subject_id: options.subjectId,
-        query: options.query,
+        q: options.query,
         limit: options.limit,
-        min_score: options.minScore,
-        include_deleted: options.includeDeleted,
-        include_superseded: options.includeSuperseded
+        min_score: options.minScore
       }
     });
-    return response.results;
+    return response.data || [];
   }
   async delete(id) {
     await this.client._request("DELETE", `/memories/${id}`);
@@ -734,7 +748,7 @@ var StateResource = class {
   async get(key, subjectId) {
     try {
       return await this.client._request("GET", `/state/${key}`, {
-        query: subjectId ? { subject_id: subjectId } : void 0
+        headers: subjectId ? { "x-subject-id": subjectId } : void 0
       });
     } catch (error) {
       if (error instanceof NotFoundError) {
@@ -744,17 +758,21 @@ var StateResource = class {
     }
   }
   async set(options) {
-    return this.client._request("POST", `/state/${options.key}`, {
+    const headers = {};
+    if (options.subjectId) {
+      headers["x-subject-id"] = options.subjectId;
+    }
+    return this.client._request("PUT", `/state/${options.key}`, {
+      headers,
       body: {
         value: options.value,
-        subject_id: options.subjectId,
         ttl_seconds: options.ttlSeconds
       }
     });
   }
   async delete(key, subjectId) {
     await this.client._request("DELETE", `/state/${key}`, {
-      query: subjectId ? { subject_id: subjectId } : void 0
+      headers: subjectId ? { "x-subject-id": subjectId } : void 0
     });
   }
 };
@@ -804,6 +822,136 @@ var PromptsResource = class {
   }
 };
 
+// src/resources/records.ts
+var RecordsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Define or update a record schema
+   *
+   * @example
+   * await mnx.records.defineSchema('deal', {
+   *   title: { type: 'string', required: true },
+   *   value: { type: 'number' },
+   *   stage: { type: 'string' },
+   *   account_id: { type: 'ref:account' },
+   * }, { displayName: 'Deal', description: 'Sales deals' });
+   */
+  async defineSchema(typeName, fields, opts) {
+    return this.client._request("POST", "/records/schemas", {
+      body: {
+        type_name: typeName,
+        fields,
+        display_name: opts?.displayName,
+        description: opts?.description
+      }
+    });
+  }
+  /**
+   * Get a schema by type name
+   */
+  async getSchema(typeName) {
+    try {
+      return await this.client._request("GET", `/records/schemas/${typeName}`);
+    } catch (error) {
+      if (error instanceof NotFoundError) return null;
+      throw error;
+    }
+  }
+  /**
+   * List all schemas for the project
+   */
+  async listSchemas() {
+    const response = await this.client._request("GET", "/records/schemas");
+    return response.schemas;
+  }
+  /**
+   * Insert a new record
+   *
+   * @example
+   * const deal = await mnx.records.insert('deal', {
+   *   title: 'Acme Renewal',
+   *   value: 500000,
+   *   stage: 'negotiation',
+   * });
+   */
+  async insert(typeName, data, opts) {
+    return this.client._request("POST", `/records/${typeName}`, {
+      body: {
+        data,
+        owner_id: opts?.ownerId,
+        visibility: opts?.visibility,
+        collaborators: opts?.collaborators
+      }
+    });
+  }
+  /**
+   * Get a record by ID
+   */
+  async get(typeName, recordId) {
+    try {
+      return await this.client._request("GET", `/records/${typeName}/${recordId}`);
+    } catch (error) {
+      if (error instanceof NotFoundError) return null;
+      throw error;
+    }
+  }
+  /**
+   * Update a record (partial merge)
+   *
+   * @example
+   * await mnx.records.update('deal', 'rec_abc', { stage: 'closed_won', value: 550000 });
+   */
+  async update(typeName, recordId, data) {
+    return this.client._request("PUT", `/records/${typeName}/${recordId}`, {
+      body: { data }
+    });
+  }
+  /**
+   * Soft-delete a record
+   */
+  async delete(typeName, recordId) {
+    await this.client._request("DELETE", `/records/${typeName}/${recordId}`);
+  }
+  /**
+   * Query records with JSONB filters
+   *
+   * @example
+   * const deals = await mnx.records.query('deal', {
+   *   where: { stage: 'closed_won' },
+   *   orderBy: '-value',
+   *   limit: 10,
+   * });
+   */
+  async query(typeName, opts) {
+    const response = await this.client._request("POST", `/records/${typeName}/query`, {
+      body: {
+        where: opts?.where,
+        order_by: opts?.orderBy,
+        limit: opts?.limit,
+        offset: opts?.offset
+      }
+    });
+    return response.records;
+  }
+  /**
+   * Semantic search across records
+   *
+   * @example
+   * const results = await mnx.records.search('deal', 'large enterprise renewal');
+   */
+  async search(typeName, query, opts) {
+    const response = await this.client._request("POST", `/records/${typeName}/search`, {
+      body: {
+        query,
+        limit: opts?.limit
+      }
+    });
+    return response.records;
+  }
+};
+
 // src/client.ts
 var DEFAULT_BASE_URL = "https://mnexium.com/api/v1";
 var DEFAULT_TIMEOUT = 3e4;
@@ -833,6 +981,7 @@ var Mnexium = class {
     this.profiles = new ProfilesResource(this);
     this.state = new StateResource(this);
     this.prompts = new PromptsResource(this);
+    this.records = new RecordsResource(this);
   }
   async process(input) {
     const options = typeof input === "string" ? { content: input } : input;
@@ -1003,13 +1152,20 @@ var Mnexium = class {
     }
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), this.timeout);
-    const response = await fetch(url.toString(), {
-      method,
-      headers,
-      body: options.body ? JSON.stringify(options.body) : void 0,
-      signal: controller.signal
-    });
-    clearTimeout(timeoutId);
+    if (options.signal) {
+      options.signal.addEventListener("abort", () => controller.abort(), { once: true });
+    }
+    let response;
+    try {
+      response = await fetch(url.toString(), {
+        method,
+        headers,
+        body: options.body ? JSON.stringify(options.body) : void 0,
+        signal: controller.signal
+      });
+    } finally {
+      clearTimeout(timeoutId);
+    }
     const provisionedKey = response.headers.get("x-mnx-key-provisioned");
     if (provisionedKey) {
       this._setProvisionedKey(provisionedKey);
@@ -1042,16 +1198,15 @@ var Mnexium = class {
     }
     let lastError;
     for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+      const controller = new AbortController();
+      const timeoutId = setTimeout(() => controller.abort(), this.timeout);
       try {
-        const controller = new AbortController();
-        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
         const response = await fetch(url.toString(), {
           method,
           headers,
           body: options.body ? JSON.stringify(options.body) : void 0,
           signal: controller.signal
         });
-        clearTimeout(timeoutId);
         const provisionedKey = response.headers.get("x-mnx-key-provisioned");
         if (provisionedKey) {
           this._setProvisionedKey(provisionedKey);
@@ -1060,7 +1215,14 @@ var Mnexium = class {
           const errorBody = await response.json().catch(() => ({}));
           throw this._handleErrorResponse(response.status, errorBody);
         }
-        return await response.json();
+        if (response.status === 204) {
+          return void 0;
+        }
+        const text = await response.text();
+        if (!text) {
+          return void 0;
+        }
+        return JSON.parse(text);
       } catch (error) {
         lastError = error;
         if (error instanceof APIError && error.status < 500 && !(error instanceof RateLimitError)) {
@@ -1070,6 +1232,8 @@ var Mnexium = class {
           throw error;
         }
         await this._sleep(Math.pow(2, attempt) * 1e3);
+      } finally {
+        clearTimeout(timeoutId);
       }
     }
     throw lastError || new MnexiumError("Request failed");

package/dist/index.mjs

@@ -81,7 +81,8 @@ var EventStream = class {
   }
   async *[Symbol.asyncIterator]() {
     const response = await this.client._requestRaw("GET", "/events/memories", {
-      query: { subject_id: this.subjectId }
+      query: { subject_id: this.subjectId },
+      signal: this.abortController.signal
     });
     if (!response.body) {
       throw new Error("Response body is null \u2014 SSE not supported");
@@ -170,7 +171,8 @@ var SubjectMemoriesResource = class {
         text,
         source: options?.source,
         visibility: options?.visibility,
-        metadata: options?.metadata
+        metadata: options?.metadata,
+        no_supersede: options?.no_supersede
       }
     });
   }
@@ -584,9 +586,23 @@ var ChatCompletionsResource = class {
         state: options.state,
         system_prompt: options.systemPrompt,
         metadata: options.metadata,
-        regenerate_key: options.regenerateKey
+        regenerate_key: options.regenerateKey,
+        records: options.records
       }
     };
+    if (options.stream) {
+      const response = await this.client._requestRaw("POST", "/chat/completions", {
+        body,
+        headers
+      });
+      return new StreamResponse(response, {
+        chatId: response.headers.get("X-Mnx-Chat-Id") || options.chatId || "",
+        subjectId: response.headers.get("X-Mnx-Subject-Id") || options.subjectId || "",
+        model: options.model,
+        provisionedKey: response.headers.get("X-Mnx-Key-Provisioned") || void 0,
+        claimUrl: response.headers.get("X-Mnx-Claim-Url") || void 0
+      });
+    }
     return this.client._request("POST", "/chat/completions", {
       body,
       headers
@@ -621,20 +637,18 @@ var MemoriesResource = class {
         offset: options?.offset
       }
     });
-    return response.memories;
+    return response.data || [];
   }
   async search(options) {
-    const response = await this.client._request("POST", "/memories/search", {
-      body: {
+    const response = await this.client._request("GET", "/memories/search", {
+      query: {
         subject_id: options.subjectId,
-        query: options.query,
+        q: options.query,
         limit: options.limit,
-        min_score: options.minScore,
-        include_deleted: options.includeDeleted,
-        include_superseded: options.includeSuperseded
+        min_score: options.minScore
       }
     });
-    return response.results;
+    return response.data || [];
   }
   async delete(id) {
     await this.client._request("DELETE", `/memories/${id}`);
@@ -699,7 +713,7 @@ var StateResource = class {
   async get(key, subjectId) {
     try {
       return await this.client._request("GET", `/state/${key}`, {
-        query: subjectId ? { subject_id: subjectId } : void 0
+        headers: subjectId ? { "x-subject-id": subjectId } : void 0
       });
     } catch (error) {
       if (error instanceof NotFoundError) {
@@ -709,17 +723,21 @@ var StateResource = class {
     }
   }
   async set(options) {
-    return this.client._request("POST", `/state/${options.key}`, {
+    const headers = {};
+    if (options.subjectId) {
+      headers["x-subject-id"] = options.subjectId;
+    }
+    return this.client._request("PUT", `/state/${options.key}`, {
+      headers,
       body: {
         value: options.value,
-        subject_id: options.subjectId,
         ttl_seconds: options.ttlSeconds
       }
     });
   }
   async delete(key, subjectId) {
     await this.client._request("DELETE", `/state/${key}`, {
-      query: subjectId ? { subject_id: subjectId } : void 0
+      headers: subjectId ? { "x-subject-id": subjectId } : void 0
     });
   }
 };
@@ -769,6 +787,136 @@ var PromptsResource = class {
   }
 };
 
+// src/resources/records.ts
+var RecordsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Define or update a record schema
+   *
+   * @example
+   * await mnx.records.defineSchema('deal', {
+   *   title: { type: 'string', required: true },
+   *   value: { type: 'number' },
+   *   stage: { type: 'string' },
+   *   account_id: { type: 'ref:account' },
+   * }, { displayName: 'Deal', description: 'Sales deals' });
+   */
+  async defineSchema(typeName, fields, opts) {
+    return this.client._request("POST", "/records/schemas", {
+      body: {
+        type_name: typeName,
+        fields,
+        display_name: opts?.displayName,
+        description: opts?.description
+      }
+    });
+  }
+  /**
+   * Get a schema by type name
+   */
+  async getSchema(typeName) {
+    try {
+      return await this.client._request("GET", `/records/schemas/${typeName}`);
+    } catch (error) {
+      if (error instanceof NotFoundError) return null;
+      throw error;
+    }
+  }
+  /**
+   * List all schemas for the project
+   */
+  async listSchemas() {
+    const response = await this.client._request("GET", "/records/schemas");
+    return response.schemas;
+  }
+  /**
+   * Insert a new record
+   *
+   * @example
+   * const deal = await mnx.records.insert('deal', {
+   *   title: 'Acme Renewal',
+   *   value: 500000,
+   *   stage: 'negotiation',
+   * });
+   */
+  async insert(typeName, data, opts) {
+    return this.client._request("POST", `/records/${typeName}`, {
+      body: {
+        data,
+        owner_id: opts?.ownerId,
+        visibility: opts?.visibility,
+        collaborators: opts?.collaborators
+      }
+    });
+  }
+  /**
+   * Get a record by ID
+   */
+  async get(typeName, recordId) {
+    try {
+      return await this.client._request("GET", `/records/${typeName}/${recordId}`);
+    } catch (error) {
+      if (error instanceof NotFoundError) return null;
+      throw error;
+    }
+  }
+  /**
+   * Update a record (partial merge)
+   *
+   * @example
+   * await mnx.records.update('deal', 'rec_abc', { stage: 'closed_won', value: 550000 });
+   */
+  async update(typeName, recordId, data) {
+    return this.client._request("PUT", `/records/${typeName}/${recordId}`, {
+      body: { data }
+    });
+  }
+  /**
+   * Soft-delete a record
+   */
+  async delete(typeName, recordId) {
+    await this.client._request("DELETE", `/records/${typeName}/${recordId}`);
+  }
+  /**
+   * Query records with JSONB filters
+   *
+   * @example
+   * const deals = await mnx.records.query('deal', {
+   *   where: { stage: 'closed_won' },
+   *   orderBy: '-value',
+   *   limit: 10,
+   * });
+   */
+  async query(typeName, opts) {
+    const response = await this.client._request("POST", `/records/${typeName}/query`, {
+      body: {
+        where: opts?.where,
+        order_by: opts?.orderBy,
+        limit: opts?.limit,
+        offset: opts?.offset
+      }
+    });
+    return response.records;
+  }
+  /**
+   * Semantic search across records
+   *
+   * @example
+   * const results = await mnx.records.search('deal', 'large enterprise renewal');
+   */
+  async search(typeName, query, opts) {
+    const response = await this.client._request("POST", `/records/${typeName}/search`, {
+      body: {
+        query,
+        limit: opts?.limit
+      }
+    });
+    return response.records;
+  }
+};
+
 // src/client.ts
 var DEFAULT_BASE_URL = "https://mnexium.com/api/v1";
 var DEFAULT_TIMEOUT = 3e4;
@@ -798,6 +946,7 @@ var Mnexium = class {
     this.profiles = new ProfilesResource(this);
     this.state = new StateResource(this);
     this.prompts = new PromptsResource(this);
+    this.records = new RecordsResource(this);
   }
   async process(input) {
     const options = typeof input === "string" ? { content: input } : input;
@@ -968,13 +1117,20 @@ var Mnexium = class {
     }
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), this.timeout);
-    const response = await fetch(url.toString(), {
-      method,
-      headers,
-      body: options.body ? JSON.stringify(options.body) : void 0,
-      signal: controller.signal
-    });
-    clearTimeout(timeoutId);
+    if (options.signal) {
+      options.signal.addEventListener("abort", () => controller.abort(), { once: true });
+    }
+    let response;
+    try {
+      response = await fetch(url.toString(), {
+        method,
+        headers,
+        body: options.body ? JSON.stringify(options.body) : void 0,
+        signal: controller.signal
+      });
+    } finally {
+      clearTimeout(timeoutId);
+    }
     const provisionedKey = response.headers.get("x-mnx-key-provisioned");
     if (provisionedKey) {
       this._setProvisionedKey(provisionedKey);
@@ -1007,16 +1163,15 @@ var Mnexium = class {
     }
     let lastError;
     for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+      const controller = new AbortController();
+      const timeoutId = setTimeout(() => controller.abort(), this.timeout);
       try {
-        const controller = new AbortController();
-        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
         const response = await fetch(url.toString(), {
           method,
           headers,
           body: options.body ? JSON.stringify(options.body) : void 0,
           signal: controller.signal
         });
-        clearTimeout(timeoutId);
         const provisionedKey = response.headers.get("x-mnx-key-provisioned");
         if (provisionedKey) {
           this._setProvisionedKey(provisionedKey);
@@ -1025,7 +1180,14 @@ var Mnexium = class {
           const errorBody = await response.json().catch(() => ({}));
           throw this._handleErrorResponse(response.status, errorBody);
         }
-        return await response.json();
+        if (response.status === 204) {
+          return void 0;
+        }
+        const text = await response.text();
+        if (!text) {
+          return void 0;
+        }
+        return JSON.parse(text);
       } catch (error) {
         lastError = error;
         if (error instanceof APIError && error.status < 500 && !(error instanceof RateLimitError)) {
@@ -1035,6 +1197,8 @@ var Mnexium = class {
           throw error;
         }
         await this._sleep(Math.pow(2, attempt) * 1e3);
+      } finally {
+        clearTimeout(timeoutId);
       }
     }
     throw lastError || new MnexiumError("Request failed");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mnexium/sdk",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Official Mnexium SDK for JavaScript/TypeScript - Add memory to your AI applications",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -19,7 +19,7 @@
     "build": "tsup src/index.ts --format cjs,esm --dts --clean",
     "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
     "test": "vitest",
-    "lint": "eslint src/",
+    "lint": "eslint --ext .ts src/",
     "prepublishOnly": "npm run build",
     "examples:install": "npm run build && cd examples && npm pkg set dependencies.@mnexium/sdk=file:.. && npm install",
     "example:hello": "cd examples && npm run hello",
@@ -56,6 +56,7 @@
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
     "eslint": "^8.0.0",
     "tsup": "^8.0.0",
     "typescript": "^5.0.0",