hebbrix 2.2.0 → 2.2.1

package/CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog
+
+## 2.2.1 — 2026-08-26
+
+- Preserve bearer authentication, content type, user agent, idempotency, and
+  caller-supplied headers on every request.
+- Handle `204`, empty, and non-JSON successful responses without attempting an
+  unconditional JSON parse.
+- Preserve valid evidence-bound search rows during a degraded or abstaining
+  server response while retaining the safety metadata; malformed and explicit
+  no-match envelopes still fail closed.
+- Preserve caller-provided abort signals while retaining the default timeout.
+- Add `temporal.deleteFact(factId)` for tenant-scoped, idempotent cleanup of
+  facts created through the temporal API.
+- Align procedure create/list/get/update/execute/delete with the canonical
+  `/v1/procedures` REST and OpenAPI contract, including empty `204` deletion.
+- Add explicit synchronous/asynchronous batch readiness receipts and
+  `waitForBatchSearchable`, which polls every accepted memory, propagates
+  terminal failures, respects deadlines, and supports cancellation.
+
+The supported server/SDK release pair is published by the server OpenAPI
+document in `info.x-hebbrix-sdk-compatibility`. Patch releases preserve the
+public API within the same major version.
+
+## 2.2.0
+
+- Added the GA scoped memory, corrections, search proof, and ProofLoop surface.

package/README.md

@@ -50,8 +50,22 @@ const main = async () => {
     collection_id: collection.id,
     content: 'User prefers dark mode and loves TypeScript',
     importance: 0.9,
+    wait_for_index: true,
   });
 
+  // Batch writes have an explicit two-mode contract. With wait_for_index=true,
+  // success means every item is searchable; a server deadline rejects with a
+  // retryable error instead of returning a misleading successful 202.
+  const batch = await client.memories.createBatch({
+    memories: [{ content: 'First fact' }, { content: 'Second fact' }],
+    collection_id: collection.id,
+    wait_for_index: true,
+    idempotency_key: 'import-42',
+  });
+
+  // For fire-and-forget batches, poll every item (with timeout/cancellation):
+  // await client.memories.waitForBatchSearchable(batch, { signal });
+
   // Search memories
   const results = await client.search({
     query: 'What programming language does user like?',
@@ -322,6 +336,8 @@ const updated = await client.procedural.update(procedure.id, {
 
 // Delete procedure
 await client.procedural.delete(procedure.id);
+// DELETE is tenant-scoped and idempotent: deleted, absent, and foreign IDs all
+// return 204 without revealing whether another tenant owns the identifier.
 ```
 
 ### 8. Temporal Knowledge Graphs

package/dist/index.d.mts

@@ -175,6 +175,45 @@ interface MemoryAddResponse {
     updated_count: number;
     skipped_count: number;
 }
+interface BatchMemoryItemParams {
+    content: string;
+    collection_id?: string;
+    importance?: number;
+    user_id?: string;
+    agent_id?: string;
+    run_id?: string;
+    tags?: string[];
+    metadata?: Record<string, any>;
+}
+interface BatchMemoryCreateParams {
+    memories: BatchMemoryItemParams[];
+    collection_id?: string;
+    user_id?: string;
+    agent_id?: string;
+    run_id?: string;
+    app_id?: string;
+    namespace?: string;
+    wait_for_index?: boolean;
+    /** Stable retry key sent as the Idempotency-Key transport header. */
+    idempotency_key?: string;
+    /** Optional caller cancellation signal; it is never serialized. */
+    signal?: AbortSignal;
+}
+interface BatchMemoryResponse {
+    created: number;
+    failed: number;
+    memory_ids: string[];
+    errors: string[];
+    results: Array<{
+        id: string;
+        memory_id?: string;
+        processing_status: string;
+    }>;
+    processing_status: string;
+    searchable: boolean;
+    outbox_event_id?: string;
+    status_url?: string;
+}
 interface UpdateMemoryParams {
     content?: string;
     importance?: number;
@@ -324,6 +363,19 @@ declare class MemoriesResource extends BaseResource {
      * Create a new memory
      */
     create(params: CreateMemoryParams): Promise<MemoryAddResponse>;
+    /**
+     * Create up to 100 memories with one unambiguous readiness contract.
+     * `wait_for_index=true` resolves only for a fully searchable batch; a server
+     * deadline or indexing failure rejects the request instead of returning a
+     * successful processing receipt.
+     */
+    createBatch(params: BatchMemoryCreateParams): Promise<BatchMemoryResponse>;
+    /** Poll every item in an asynchronous batch receipt until it is searchable. */
+    waitForBatchSearchable(receipt: BatchMemoryResponse, options?: {
+        timeoutMs?: number;
+        pollIntervalMs?: number;
+        signal?: AbortSignal;
+    }): Promise<BatchMemoryResponse>;
     /**
      * List memories
      */
@@ -429,6 +481,7 @@ declare class RLResource extends BaseResource {
     evaluate(agentType: string, collectionId?: string): Promise<any>;
 }
 declare class ProceduralResource extends BaseResource {
+    private unwrapProcedure;
     /**
      * Create a new procedure
      */
@@ -500,6 +553,8 @@ declare class TemporalResource extends BaseResource {
      * Query knowledge state at a specific point in time
      */
     pointInTime(timestamp: string, entity?: string): Promise<any>;
+    /** Permanently delete a tenant-scoped temporal fact by stable ID. */
+    deleteFact(factId: string): Promise<any>;
 }
 declare class WorkingMemoryResource extends BaseResource {
     /**
@@ -640,10 +695,10 @@ interface SafetyEnvelope {
 }
 /**
  * Validate the API-owned grounding receipt before exposing evidence to an agent.
- * A malformed, degraded, abstaining, or ungrounded response is converted into
- * one deterministic no-match envelope. This prevents SDK/API contract drift
- * from turning a nearest neighbour into verified evidence.
+ * A malformed or explicit no-match response is converted into one deterministic
+ * no-match envelope. Degraded, evidence-bound rows remain visible together with
+ * the API's abstention signal so the SDK cannot introduce a false negative.
  */
 declare function enforceSearchSafety<T extends object>(response: T, rowsKey?: "results" | "sources"): T & SafetyEnvelope;
 
-export { type APIKeyResponse, AuthResource, type AuthResponse, AuthenticationError, type ClientConfig, type Collection, CollectionsResource, ConsolidationResource, type CorrectionCreateParams, type CorrectionSearchParams, CorrectionsResource, type CreateCollectionParams, type CreateMemoryParams, type CursorPage, type EvidenceClaim, type GroundingReceipt, HebbrixError, type ListParams, MemoriesResource, type Memory, type MemoryAddResponse, type MemoryAddResult, MemoryClient, type MemoryJobReceipt, MemoryJobsResource, type MemoryListParams, MemoryToolsResource, type MemoryWithMetadata, NotFoundError, ProceduralResource, type ProofContext, type ProofLoopCandidate, type ProofLoopDecisionParams, type ProofLoopMetricParams, ProofLoopResource, RLResource, RateLimitError, type ReasonParams, type ReasoningResponse, type ReasoningSource, type SafetyEnvelope, type SearchParams, SearchResource, type SearchResponse, type SearchResult, ServerError, TemporalResource, type UpdateCollectionParams, type UpdateMemoryParams, type User, ValidationError, WorkingMemoryResource, WorldModelResource, enforceSearchSafety };
+export { type APIKeyResponse, AuthResource, type AuthResponse, AuthenticationError, type BatchMemoryCreateParams, type BatchMemoryItemParams, type BatchMemoryResponse, type ClientConfig, type Collection, CollectionsResource, ConsolidationResource, type CorrectionCreateParams, type CorrectionSearchParams, CorrectionsResource, type CreateCollectionParams, type CreateMemoryParams, type CursorPage, type EvidenceClaim, type GroundingReceipt, HebbrixError, type ListParams, MemoriesResource, type Memory, type MemoryAddResponse, type MemoryAddResult, MemoryClient, type MemoryJobReceipt, MemoryJobsResource, type MemoryListParams, MemoryToolsResource, type MemoryWithMetadata, NotFoundError, ProceduralResource, type ProofContext, type ProofLoopCandidate, type ProofLoopDecisionParams, type ProofLoopMetricParams, ProofLoopResource, RLResource, RateLimitError, type ReasonParams, type ReasoningResponse, type ReasoningSource, type SafetyEnvelope, type SearchParams, SearchResource, type SearchResponse, type SearchResult, ServerError, TemporalResource, type UpdateCollectionParams, type UpdateMemoryParams, type User, ValidationError, WorkingMemoryResource, WorldModelResource, enforceSearchSafety };

package/dist/index.d.ts

@@ -175,6 +175,45 @@ interface MemoryAddResponse {
     updated_count: number;
     skipped_count: number;
 }
+interface BatchMemoryItemParams {
+    content: string;
+    collection_id?: string;
+    importance?: number;
+    user_id?: string;
+    agent_id?: string;
+    run_id?: string;
+    tags?: string[];
+    metadata?: Record<string, any>;
+}
+interface BatchMemoryCreateParams {
+    memories: BatchMemoryItemParams[];
+    collection_id?: string;
+    user_id?: string;
+    agent_id?: string;
+    run_id?: string;
+    app_id?: string;
+    namespace?: string;
+    wait_for_index?: boolean;
+    /** Stable retry key sent as the Idempotency-Key transport header. */
+    idempotency_key?: string;
+    /** Optional caller cancellation signal; it is never serialized. */
+    signal?: AbortSignal;
+}
+interface BatchMemoryResponse {
+    created: number;
+    failed: number;
+    memory_ids: string[];
+    errors: string[];
+    results: Array<{
+        id: string;
+        memory_id?: string;
+        processing_status: string;
+    }>;
+    processing_status: string;
+    searchable: boolean;
+    outbox_event_id?: string;
+    status_url?: string;
+}
 interface UpdateMemoryParams {
     content?: string;
     importance?: number;
@@ -324,6 +363,19 @@ declare class MemoriesResource extends BaseResource {
      * Create a new memory
      */
     create(params: CreateMemoryParams): Promise<MemoryAddResponse>;
+    /**
+     * Create up to 100 memories with one unambiguous readiness contract.
+     * `wait_for_index=true` resolves only for a fully searchable batch; a server
+     * deadline or indexing failure rejects the request instead of returning a
+     * successful processing receipt.
+     */
+    createBatch(params: BatchMemoryCreateParams): Promise<BatchMemoryResponse>;
+    /** Poll every item in an asynchronous batch receipt until it is searchable. */
+    waitForBatchSearchable(receipt: BatchMemoryResponse, options?: {
+        timeoutMs?: number;
+        pollIntervalMs?: number;
+        signal?: AbortSignal;
+    }): Promise<BatchMemoryResponse>;
     /**
      * List memories
      */
@@ -429,6 +481,7 @@ declare class RLResource extends BaseResource {
     evaluate(agentType: string, collectionId?: string): Promise<any>;
 }
 declare class ProceduralResource extends BaseResource {
+    private unwrapProcedure;
     /**
      * Create a new procedure
      */
@@ -500,6 +553,8 @@ declare class TemporalResource extends BaseResource {
      * Query knowledge state at a specific point in time
      */
     pointInTime(timestamp: string, entity?: string): Promise<any>;
+    /** Permanently delete a tenant-scoped temporal fact by stable ID. */
+    deleteFact(factId: string): Promise<any>;
 }
 declare class WorkingMemoryResource extends BaseResource {
     /**
@@ -640,10 +695,10 @@ interface SafetyEnvelope {
 }
 /**
  * Validate the API-owned grounding receipt before exposing evidence to an agent.
- * A malformed, degraded, abstaining, or ungrounded response is converted into
- * one deterministic no-match envelope. This prevents SDK/API contract drift
- * from turning a nearest neighbour into verified evidence.
+ * A malformed or explicit no-match response is converted into one deterministic
+ * no-match envelope. Degraded, evidence-bound rows remain visible together with
+ * the API's abstention signal so the SDK cannot introduce a false negative.
  */
 declare function enforceSearchSafety<T extends object>(response: T, rowsKey?: "results" | "sources"): T & SafetyEnvelope;
 
-export { type APIKeyResponse, AuthResource, type AuthResponse, AuthenticationError, type ClientConfig, type Collection, CollectionsResource, ConsolidationResource, type CorrectionCreateParams, type CorrectionSearchParams, CorrectionsResource, type CreateCollectionParams, type CreateMemoryParams, type CursorPage, type EvidenceClaim, type GroundingReceipt, HebbrixError, type ListParams, MemoriesResource, type Memory, type MemoryAddResponse, type MemoryAddResult, MemoryClient, type MemoryJobReceipt, MemoryJobsResource, type MemoryListParams, MemoryToolsResource, type MemoryWithMetadata, NotFoundError, ProceduralResource, type ProofContext, type ProofLoopCandidate, type ProofLoopDecisionParams, type ProofLoopMetricParams, ProofLoopResource, RLResource, RateLimitError, type ReasonParams, type ReasoningResponse, type ReasoningSource, type SafetyEnvelope, type SearchParams, SearchResource, type SearchResponse, type SearchResult, ServerError, TemporalResource, type UpdateCollectionParams, type UpdateMemoryParams, type User, ValidationError, WorkingMemoryResource, WorldModelResource, enforceSearchSafety };
+export { type APIKeyResponse, AuthResource, type AuthResponse, AuthenticationError, type BatchMemoryCreateParams, type BatchMemoryItemParams, type BatchMemoryResponse, type ClientConfig, type Collection, CollectionsResource, ConsolidationResource, type CorrectionCreateParams, type CorrectionSearchParams, CorrectionsResource, type CreateCollectionParams, type CreateMemoryParams, type CursorPage, type EvidenceClaim, type GroundingReceipt, HebbrixError, type ListParams, MemoriesResource, type Memory, type MemoryAddResponse, type MemoryAddResult, MemoryClient, type MemoryJobReceipt, MemoryJobsResource, type MemoryListParams, MemoryToolsResource, type MemoryWithMetadata, NotFoundError, ProceduralResource, type ProofContext, type ProofLoopCandidate, type ProofLoopDecisionParams, type ProofLoopMetricParams, ProofLoopResource, RLResource, RateLimitError, type ReasonParams, type ReasoningResponse, type ReasoningSource, type SafetyEnvelope, type SearchParams, SearchResource, type SearchResponse, type SearchResult, ServerError, TemporalResource, type UpdateCollectionParams, type UpdateMemoryParams, type User, ValidationError, WorkingMemoryResource, WorldModelResource, enforceSearchSafety };

package/dist/index.js

@@ -81,7 +81,7 @@ function enforceSearchSafety(response, rowsKey = "results") {
       reason = "no_match_contains_evidence";
     }
   }
-  if (reason || data.degraded === true || data.no_match === true || data.abstain_recommended === true) {
+  if (reason || data.no_match === true) {
     data[rowsKey] = [];
     if (rowsKey === "results") data.total = 0;
     data.no_match = true;
@@ -93,6 +93,8 @@ function enforceSearchSafety(response, rowsKey = "results") {
       data.sdk_safety_reason = reason;
       data.grounding = { status: "no_grounded_match", reason };
     }
+  } else if (data.degraded === true || data.abstain_recommended === true) {
+    data.sdk_safety_reason = "degraded_evidence_preserved";
   }
   return data;
 }
@@ -191,6 +193,78 @@ var MemoriesResource = class extends BaseResource {
       })
     });
   }
+  /**
+   * Create up to 100 memories with one unambiguous readiness contract.
+   * `wait_for_index=true` resolves only for a fully searchable batch; a server
+   * deadline or indexing failure rejects the request instead of returning a
+   * successful processing receipt.
+   */
+  async createBatch(params) {
+    if (!params.memories?.length || params.memories.length > 100) {
+      throw new TypeError("memories must contain between 1 and 100 items");
+    }
+    if (params.memories.some((item) => !item.content?.trim())) {
+      throw new TypeError("every batch memory must contain non-empty content");
+    }
+    const { idempotency_key, signal, ...body } = params;
+    const receipt = await this.client.request(
+      "POST",
+      "/v1/memories/batch",
+      {
+        headers: idempotency_key ? { "Idempotency-Key": idempotency_key } : void 0,
+        body: JSON.stringify({ wait_for_index: false, ...body }),
+        signal
+      }
+    );
+    if (params.wait_for_index && !(receipt.searchable === true && receipt.processing_status === "completed")) {
+      throw new Error(
+        "wait_for_index batch response was not fully searchable; retry with the same Idempotency-Key"
+      );
+    }
+    return receipt;
+  }
+  /** Poll every item in an asynchronous batch receipt until it is searchable. */
+  async waitForBatchSearchable(receipt, options = {}) {
+    const ids = [...new Set(receipt.memory_ids || [])];
+    if (!ids.length) {
+      throw new Error("batch receipt does not contain memory_ids");
+    }
+    const timeoutMs = Math.max(0, options.timeoutMs ?? 6e4);
+    const pollIntervalMs = Math.max(50, options.pollIntervalMs ?? 500);
+    const deadline = Date.now() + timeoutMs;
+    while (true) {
+      if (options.signal?.aborted) {
+        throw options.signal.reason || new Error("batch readiness polling was aborted");
+      }
+      const rows = await Promise.all(ids.map((id) => this.get(id)));
+      const terminal = rows.find(
+        (row) => ["failed", "cancelled", "canceled"].includes(
+          String(row.processing_status || "").toLowerCase()
+        )
+      );
+      if (terminal) {
+        throw new Error(
+          `memory ${terminal.id} indexing reached terminal state ${terminal.processing_status}`
+        );
+      }
+      if (rows.every((row) => row.searchable === true)) {
+        return {
+          ...receipt,
+          processing_status: "completed",
+          searchable: true,
+          results: ids.map((id) => ({
+            id,
+            memory_id: id,
+            processing_status: "completed"
+          }))
+        };
+      }
+      if (Date.now() >= deadline) {
+        throw new Error(`batch was not searchable within ${timeoutMs}ms`);
+      }
+      await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
+    }
+  }
   /**
    * List memories
    */
@@ -413,56 +487,78 @@ var RLResource = class extends BaseResource {
   }
 };
 var ProceduralResource = class extends BaseResource {
+  unwrapProcedure(response) {
+    if (response?.procedure) return response.procedure;
+    if (response?.procedure_id && !response?.id) {
+      return { ...response, id: response.procedure_id };
+    }
+    return response;
+  }
   /**
    * Create a new procedure
    */
   async create(params) {
-    return this.client.post("/procedural", {
+    const response = await this.client.post("/v1/procedures", {
       name: params.name,
       description: params.description,
-      trigger_condition: params.trigger_condition,
-      action_sequence: params.action_sequence,
+      condition: { expression: params.trigger_condition },
+      action: { steps: params.action_sequence },
       collection_id: params.collection_id,
       category: params.category,
-      metadata: params.metadata || {}
+      parameters: params.metadata || {}
     });
+    return this.unwrapProcedure(response);
   }
   /**
    * List procedures
    */
   async list(params) {
-    return this.client.get("/procedural", {
+    const response = await this.client.get("/v1/procedures", {
       collection_id: params?.collection_id,
       category: params?.category,
       skip: params?.skip || 0,
       limit: params?.limit || 100
     });
+    return Array.isArray(response) ? response : response?.procedures || [];
   }
   /**
    * Get a specific procedure
    */
   async get(procedureId) {
-    return this.client.get(`/procedural/${procedureId}`);
+    const response = await this.client.get(`/v1/procedures/${procedureId}`);
+    return this.unwrapProcedure(response);
   }
   /**
    * Execute a procedure
    */
   async execute(procedureId, context) {
-    return this.client.post(`/procedural/${procedureId}/execute`, {
-      context: context || {}
+    const response = await this.client.post(`/v1/procedures/${procedureId}/execute`, {
+      input_state: context || {}
     });
+    return response?.execution_result || response;
   }
   /**
    * Update a procedure
    */
   async update(procedureId, params) {
-    return this.client.patch(`/procedural/${procedureId}`, params);
+    const body = {};
+    if (params.name !== void 0) body.name = params.name;
+    if (params.description !== void 0) body.description = params.description;
+    if (params.trigger_condition !== void 0) {
+      body.condition = { expression: params.trigger_condition };
+    }
+    if (params.action_sequence !== void 0) {
+      body.action = { steps: params.action_sequence };
+    }
+    if (params.metadata !== void 0) body.parameters = params.metadata;
+    const response = await this.client.patch(`/v1/procedures/${procedureId}`, body);
+    return this.unwrapProcedure(response);
   }
   /**
    * Delete a procedure
    */
   async delete(procedureId) {
-    await this.client.delete(`/procedural/${procedureId}`);
+    await this.client.delete(`/v1/procedures/${procedureId}`);
   }
 };
 var TemporalResource = class extends BaseResource {
@@ -501,6 +597,10 @@ var TemporalResource = class extends BaseResource {
       entity
     });
   }
+  /** Permanently delete a tenant-scoped temporal fact by stable ID. */
+  async deleteFact(factId) {
+    return this.client.delete(`/temporal/facts/${factId}`);
+  }
 };
 var WorkingMemoryResource = class extends BaseResource {
   /**
@@ -684,7 +784,7 @@ var MemoryClient = class {
   getHeaders() {
     const headers = {
       "Content-Type": "application/json",
-      "User-Agent": "hebbrix-typescript/2.2.0"
+      "User-Agent": "hebbrix-typescript/2.2.1"
     };
     if (this.apiKey) {
       headers["Authorization"] = `Bearer ${this.apiKey}`;
@@ -693,7 +793,8 @@ var MemoryClient = class {
   }
   handleError(response, data) {
     const statusCode = response.status;
-    const message = data?.error?.message || data?.detail || response.statusText;
+    const detail = data?.detail;
+    const message = data?.error?.message || (typeof detail === "string" ? detail : detail?.message) || response.statusText;
     if (statusCode === 401) {
       throw new AuthenticationError(message);
     } else if (statusCode === 404) {
@@ -711,21 +812,29 @@ var MemoryClient = class {
   }
   async request(method, path, options = {}) {
     const url = `${this.baseUrl}${path}`;
+    const { headers: requestHeaders, signal: requestSignal, ...requestOptions } = options;
     const response = await fetch(url, {
+      ...requestOptions,
       method,
       headers: {
         ...this.getHeaders(),
-        ...options.headers || {}
+        ...requestHeaders || {}
       },
-      ...options,
-      signal: AbortSignal.timeout(this.timeout)
+      signal: requestSignal || AbortSignal.timeout(this.timeout)
     });
-    let data;
+    let data = void 0;
     const contentType = response.headers.get("content-type");
-    if (contentType?.includes("application/json")) {
-      data = await response.json();
-    } else {
-      data = await response.text();
+    const responseText = await response.text();
+    if (responseText) {
+      if (contentType?.includes("application/json")) {
+        try {
+          data = JSON.parse(responseText);
+        } catch {
+          data = { detail: responseText };
+        }
+      } else {
+        data = responseText;
+      }
     }
     if (!response.ok) {
       this.handleError(response, data);

package/dist/index.mjs

@@ -34,7 +34,7 @@ function enforceSearchSafety(response, rowsKey = "results") {
       reason = "no_match_contains_evidence";
     }
   }
-  if (reason || data.degraded === true || data.no_match === true || data.abstain_recommended === true) {
+  if (reason || data.no_match === true) {
     data[rowsKey] = [];
     if (rowsKey === "results") data.total = 0;
     data.no_match = true;
@@ -46,6 +46,8 @@ function enforceSearchSafety(response, rowsKey = "results") {
       data.sdk_safety_reason = reason;
       data.grounding = { status: "no_grounded_match", reason };
     }
+  } else if (data.degraded === true || data.abstain_recommended === true) {
+    data.sdk_safety_reason = "degraded_evidence_preserved";
   }
   return data;
 }
@@ -144,6 +146,78 @@ var MemoriesResource = class extends BaseResource {
       })
     });
   }
+  /**
+   * Create up to 100 memories with one unambiguous readiness contract.
+   * `wait_for_index=true` resolves only for a fully searchable batch; a server
+   * deadline or indexing failure rejects the request instead of returning a
+   * successful processing receipt.
+   */
+  async createBatch(params) {
+    if (!params.memories?.length || params.memories.length > 100) {
+      throw new TypeError("memories must contain between 1 and 100 items");
+    }
+    if (params.memories.some((item) => !item.content?.trim())) {
+      throw new TypeError("every batch memory must contain non-empty content");
+    }
+    const { idempotency_key, signal, ...body } = params;
+    const receipt = await this.client.request(
+      "POST",
+      "/v1/memories/batch",
+      {
+        headers: idempotency_key ? { "Idempotency-Key": idempotency_key } : void 0,
+        body: JSON.stringify({ wait_for_index: false, ...body }),
+        signal
+      }
+    );
+    if (params.wait_for_index && !(receipt.searchable === true && receipt.processing_status === "completed")) {
+      throw new Error(
+        "wait_for_index batch response was not fully searchable; retry with the same Idempotency-Key"
+      );
+    }
+    return receipt;
+  }
+  /** Poll every item in an asynchronous batch receipt until it is searchable. */
+  async waitForBatchSearchable(receipt, options = {}) {
+    const ids = [...new Set(receipt.memory_ids || [])];
+    if (!ids.length) {
+      throw new Error("batch receipt does not contain memory_ids");
+    }
+    const timeoutMs = Math.max(0, options.timeoutMs ?? 6e4);
+    const pollIntervalMs = Math.max(50, options.pollIntervalMs ?? 500);
+    const deadline = Date.now() + timeoutMs;
+    while (true) {
+      if (options.signal?.aborted) {
+        throw options.signal.reason || new Error("batch readiness polling was aborted");
+      }
+      const rows = await Promise.all(ids.map((id) => this.get(id)));
+      const terminal = rows.find(
+        (row) => ["failed", "cancelled", "canceled"].includes(
+          String(row.processing_status || "").toLowerCase()
+        )
+      );
+      if (terminal) {
+        throw new Error(
+          `memory ${terminal.id} indexing reached terminal state ${terminal.processing_status}`
+        );
+      }
+      if (rows.every((row) => row.searchable === true)) {
+        return {
+          ...receipt,
+          processing_status: "completed",
+          searchable: true,
+          results: ids.map((id) => ({
+            id,
+            memory_id: id,
+            processing_status: "completed"
+          }))
+        };
+      }
+      if (Date.now() >= deadline) {
+        throw new Error(`batch was not searchable within ${timeoutMs}ms`);
+      }
+      await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
+    }
+  }
   /**
    * List memories
    */
@@ -366,56 +440,78 @@ var RLResource = class extends BaseResource {
   }
 };
 var ProceduralResource = class extends BaseResource {
+  unwrapProcedure(response) {
+    if (response?.procedure) return response.procedure;
+    if (response?.procedure_id && !response?.id) {
+      return { ...response, id: response.procedure_id };
+    }
+    return response;
+  }
   /**
    * Create a new procedure
    */
   async create(params) {
-    return this.client.post("/procedural", {
+    const response = await this.client.post("/v1/procedures", {
       name: params.name,
       description: params.description,
-      trigger_condition: params.trigger_condition,
-      action_sequence: params.action_sequence,
+      condition: { expression: params.trigger_condition },
+      action: { steps: params.action_sequence },
       collection_id: params.collection_id,
       category: params.category,
-      metadata: params.metadata || {}
+      parameters: params.metadata || {}
     });
+    return this.unwrapProcedure(response);
   }
   /**
    * List procedures
    */
   async list(params) {
-    return this.client.get("/procedural", {
+    const response = await this.client.get("/v1/procedures", {
       collection_id: params?.collection_id,
       category: params?.category,
       skip: params?.skip || 0,
       limit: params?.limit || 100
     });
+    return Array.isArray(response) ? response : response?.procedures || [];
   }
   /**
    * Get a specific procedure
    */
   async get(procedureId) {
-    return this.client.get(`/procedural/${procedureId}`);
+    const response = await this.client.get(`/v1/procedures/${procedureId}`);
+    return this.unwrapProcedure(response);
   }
   /**
    * Execute a procedure
    */
   async execute(procedureId, context) {
-    return this.client.post(`/procedural/${procedureId}/execute`, {
-      context: context || {}
+    const response = await this.client.post(`/v1/procedures/${procedureId}/execute`, {
+      input_state: context || {}
     });
+    return response?.execution_result || response;
   }
   /**
    * Update a procedure
    */
   async update(procedureId, params) {
-    return this.client.patch(`/procedural/${procedureId}`, params);
+    const body = {};
+    if (params.name !== void 0) body.name = params.name;
+    if (params.description !== void 0) body.description = params.description;
+    if (params.trigger_condition !== void 0) {
+      body.condition = { expression: params.trigger_condition };
+    }
+    if (params.action_sequence !== void 0) {
+      body.action = { steps: params.action_sequence };
+    }
+    if (params.metadata !== void 0) body.parameters = params.metadata;
+    const response = await this.client.patch(`/v1/procedures/${procedureId}`, body);
+    return this.unwrapProcedure(response);
   }
   /**
    * Delete a procedure
    */
   async delete(procedureId) {
-    await this.client.delete(`/procedural/${procedureId}`);
+    await this.client.delete(`/v1/procedures/${procedureId}`);
   }
 };
 var TemporalResource = class extends BaseResource {
@@ -454,6 +550,10 @@ var TemporalResource = class extends BaseResource {
       entity
     });
   }
+  /** Permanently delete a tenant-scoped temporal fact by stable ID. */
+  async deleteFact(factId) {
+    return this.client.delete(`/temporal/facts/${factId}`);
+  }
 };
 var WorkingMemoryResource = class extends BaseResource {
   /**
@@ -637,7 +737,7 @@ var MemoryClient = class {
   getHeaders() {
     const headers = {
       "Content-Type": "application/json",
-      "User-Agent": "hebbrix-typescript/2.2.0"
+      "User-Agent": "hebbrix-typescript/2.2.1"
     };
     if (this.apiKey) {
       headers["Authorization"] = `Bearer ${this.apiKey}`;
@@ -646,7 +746,8 @@ var MemoryClient = class {
   }
   handleError(response, data) {
     const statusCode = response.status;
-    const message = data?.error?.message || data?.detail || response.statusText;
+    const detail = data?.detail;
+    const message = data?.error?.message || (typeof detail === "string" ? detail : detail?.message) || response.statusText;
     if (statusCode === 401) {
       throw new AuthenticationError(message);
     } else if (statusCode === 404) {
@@ -664,21 +765,29 @@ var MemoryClient = class {
   }
   async request(method, path, options = {}) {
     const url = `${this.baseUrl}${path}`;
+    const { headers: requestHeaders, signal: requestSignal, ...requestOptions } = options;
     const response = await fetch(url, {
+      ...requestOptions,
       method,
       headers: {
         ...this.getHeaders(),
-        ...options.headers || {}
+        ...requestHeaders || {}
       },
-      ...options,
-      signal: AbortSignal.timeout(this.timeout)
+      signal: requestSignal || AbortSignal.timeout(this.timeout)
     });
-    let data;
+    let data = void 0;
     const contentType = response.headers.get("content-type");
-    if (contentType?.includes("application/json")) {
-      data = await response.json();
-    } else {
-      data = await response.text();
+    const responseText = await response.text();
+    if (responseText) {
+      if (contentType?.includes("application/json")) {
+        try {
+          data = JSON.parse(responseText);
+        } catch {
+          data = { detail: responseText };
+        }
+      } else {
+        data = responseText;
+      }
     }
     if (!response.ok) {
       this.handleError(response, data);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hebbrix",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "description": "Advanced Memory API for AI Agents with Reinforcement Learning - TypeScript/JavaScript SDK",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -14,7 +14,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "build": "tsup src/index.ts --format cjs,esm --dts",