claude-cognitive 0.3.4 → 0.4.1

package/dist/client.d.ts

@@ -2,7 +2,7 @@
  * HindsightClient - TypeScript client for the Hindsight memory API.
  * @module client
  */
-import type { Bank, BankOptions, Disposition, HealthStatus, HindsightClientOptions, Memory, RecallOptions, TraitValue, ReflectResult } from "./types.js";
+import type { Bank, BankOptions, Disposition, FactUsefulnessStats, FactStatsInput, HealthStatus, HindsightClientOptions, Memory, RecallInput, ReflectInput, ReflectResult, RetainInput, SignalInput, SignalResult, TraitValue } from "./types.js";
 /**
  * HindsightClient provides a TypeScript interface to the Hindsight memory API.
  *
@@ -27,17 +27,39 @@ import type { Bank, BankOptions, Disposition, HealthStatus, HindsightClientOptio
  * });
  *
  * // Store a memory
- * await client.retain(
- *   'my-project',
- *   'Fixed auth redirect by moving AuthProvider to root',
- *   'User was experiencing infinite redirects'
- * );
+ * await client.retain({
+ *   bankId: 'my-project',
+ *   content: 'Fixed auth redirect by moving AuthProvider to root',
+ *   context: 'User was experiencing infinite redirects'
+ * });
  *
  * // Recall memories
- * const memories = await client.recall('my-project', 'authentication issues');
+ * const memories = await client.recall({
+ *   bankId: 'my-project',
+ *   query: 'authentication issues'
+ * });
+ *
+ * // Recall with usefulness boosting
+ * const boosted = await client.recall({
+ *   bankId: 'my-project',
+ *   query: 'authentication issues',
+ *   boostByUsefulness: true,
+ *   usefulnessWeight: 0.3
+ * });
  *
  * // Reflect and form opinions
- * const reflection = await client.reflect('my-project', 'What patterns have I noticed?');
+ * const reflection = await client.reflect({
+ *   bankId: 'my-project',
+ *   query: 'What patterns have I noticed?'
+ * });
+ *
+ * // Submit feedback signals
+ * await client.signal({
+ *   bankId: 'my-project',
+ *   signals: [
+ *     { factId: memories[0].id, signalType: 'used', query: 'auth issues' }
+ *   ]
+ * });
  * ```
  */
 export declare class HindsightClient {
@@ -99,16 +121,22 @@ export declare class HindsightClient {
      * Store content with automatic extraction.
      *
      * Hindsight automatically extracts entities, relationships, and metadata.
+     * You can optionally provide user-defined entities to combine with auto-extracted ones.
      *
-     * @param bankId - Bank identifier
-     * @param content - Content to store
-     * @param context - Optional additional context
+     * @param input - Retain input with bankId, content, and optional context/entities
      * @returns Number of items processed
      * @throws {HindsightError} If bank doesn't exist
+     *
+     * @example
+     * ```typescript
+     * await client.retain({
+     *   bankId: 'my-project',
+     *   content: 'Fixed auth redirect by moving AuthProvider to root',
+     *   context: 'User was experiencing infinite redirects'
+     * });
+     * ```
      */
-    retain(bankId: string, content: string, context?: string, options?: {
-        async?: boolean;
-    }): Promise<number>;
+    retain(input: RetainInput): Promise<number>;
     /**
      * Search memories using 4-way parallel retrieval.
      *
@@ -121,13 +149,30 @@ export declare class HindsightClient {
      * Results are fused using Reciprocal Rank Fusion (RRF),
      * then reranked with a neural cross-encoder.
      *
-     * @param bankId - Bank identifier
-     * @param query - Search query
-     * @param options - Search options
+     * Optionally boost results by usefulness score (based on feedback signals).
+     *
+     * @param input - Recall input with bankId, query, and optional search options
      * @returns Ranked list of matching memories
      * @throws {HindsightError} If bank doesn't exist
+     *
+     * @example
+     * ```typescript
+     * // Basic recall
+     * const memories = await client.recall({
+     *   bankId: 'my-project',
+     *   query: 'authentication issues'
+     * });
+     *
+     * // With usefulness boosting
+     * const boosted = await client.recall({
+     *   bankId: 'my-project',
+     *   query: 'authentication issues',
+     *   boostByUsefulness: true,
+     *   usefulnessWeight: 0.3
+     * });
+     * ```
      */
-    recall(bankId: string, query: string, options?: RecallOptions): Promise<Memory[]>;
+    recall(input: RecallInput): Promise<Memory[]>;
     /**
      * Reason about accumulated knowledge through disposition lens.
      *
@@ -139,13 +184,19 @@ export declare class HindsightClient {
      * 5. Stores opinions asynchronously (influences future reflects)
      * 6. Returns reasoned response with citations
      *
-     * @param bankId - Bank identifier
-     * @param query - What to think about or reason through
-     * @param context - Optional additional context
+     * @param input - Reflect input with bankId, query, and optional context
      * @returns Reflection result with text, opinions, and citations
      * @throws {HindsightError} If bank doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const reflection = await client.reflect({
+     *   bankId: 'my-project',
+     *   query: 'What patterns have I noticed in the codebase?'
+     * });
+     * ```
      */
-    reflect(bankId: string, query: string, context?: string): Promise<ReflectResult>;
+    reflect(input: ReflectInput): Promise<ReflectResult>;
     /**
      * Check Hindsight connection health.
      *
@@ -178,6 +229,54 @@ export declare class HindsightClient {
      * @deprecated Use forgetAll() instead - individual memory deletion not supported
      */
     forget(bankId: string, _memoryId?: string): Promise<void>;
+    /**
+     * Submit feedback signals for recalled facts.
+     *
+     * Signal types and their weights:
+     * - `used`: Fact was referenced in response (weight: +1.0)
+     * - `ignored`: Fact was recalled but not used (weight: -0.5)
+     * - `helpful`: Explicit positive feedback (weight: +1.5)
+     * - `not_helpful`: Explicit negative feedback (weight: -1.0)
+     *
+     * @param input - Signal input with bankId and array of signals
+     * @returns Result with number of signals processed
+     * @throws {HindsightError} If bank doesn't exist
+     *
+     * @example
+     * ```typescript
+     * await client.signal({
+     *   bankId: 'my-project',
+     *   signals: [
+     *     { factId: 'fact-1', signalType: 'used', query: 'auth issues', confidence: 1.0 },
+     *     { factId: 'fact-2', signalType: 'ignored', query: 'auth issues', confidence: 0.5 }
+     *   ]
+     * });
+     * ```
+     */
+    signal(input: SignalInput): Promise<SignalResult>;
+    /**
+     * Get usefulness statistics for a specific fact.
+     *
+     * @param input - Input with bankId and factId
+     * @returns Usefulness statistics for the fact
+     * @throws {HindsightError} If bank or fact doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const stats = await client.getFactStats({
+     *   bankId: 'my-project',
+     *   factId: 'fact-123'
+     * });
+     * console.log(`Usefulness: ${stats.usefulnessScore}`);
+     * ```
+     */
+    getFactStats(input: FactStatsInput): Promise<FactUsefulnessStats>;
+    /**
+     * List all memory banks.
+     *
+     * @returns Array of all banks
+     */
+    listBanks(): Promise<Bank[]>;
     /**
      * Make an HTTP request to the Hindsight API.
      * @internal

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EACV,IAAI,EACJ,WAAW,EAEX,WAAW,EAEX,YAAY,EACZ,sBAAsB,EACtB,MAAM,EACN,aAAa,EACb,UAAU,EACV,aAAa,EAEd,MAAM,YAAY,CAAC;AAuBpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IAEzC;;;;OAIG;gBACS,OAAO,GAAE,sBAA2B;IAehD;;;;;OAKG;IACG,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBrD;;;;;;OAMG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe5C;;;;;;OAMG;IACG,iBAAiB,CACrB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC,IAAI,CAAC;IAUhB;;;;;;OAMG;IACG,UAAU,CACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;QACP,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE;YACZ,UAAU,CAAC,EAAE,UAAU,CAAC;YACxB,UAAU,CAAC,EAAE,UAAU,CAAC;YACxB,OAAO,CAAC,EAAE,UAAU,CAAC;SACtB,CAAC;KACH,GACA,OAAO,CAAC,IAAI,CAAC;IA+BhB;;;;;OAKG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW/C;;;;;;;;;;OAUG;IACG,MAAM,CACV,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAC5B,OAAO,CAAC,MAAM,CAAC;IAuBlB;;;;;;;;;;;;;;;;;OAiBG;IACG,MAAM,CACV,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,MAAM,EAAE,CAAC;IAyCpB;;;;;;;;;;;;;;;;OAgBG;IACG,OAAO,CACX,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,CAAC;IA+DzB;;;;;;;OAOG;IACG,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC;IAuBrC;;;;;;;OAOG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAgCnE;;;;;;;;OAQG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9C;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/D;;;OAGG;YACW,OAAO;IA2DrB;;;OAGG;YACW,aAAa;IAQ3B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;;OAGG;IACH,OAAO,CAAC,eAAe;CAYxB"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EACV,IAAI,EACJ,WAAW,EAEX,WAAW,EAEX,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,sBAAsB,EACtB,MAAM,EACN,WAAW,EACX,YAAY,EACZ,aAAa,EACb,WAAW,EACX,WAAW,EACX,YAAY,EAEZ,UAAU,EACX,MAAM,YAAY,CAAC;AAuBpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IAEzC;;;;OAIG;gBACS,OAAO,GAAE,sBAA2B;IAehD;;;;;OAKG;IACG,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBrD;;;;;;OAMG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe5C;;;;;;OAMG;IACG,iBAAiB,CACrB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC,IAAI,CAAC;IAUhB;;;;;;OAMG;IACG,UAAU,CACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;QACP,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE;YACZ,UAAU,CAAC,EAAE,UAAU,CAAC;YACxB,UAAU,CAAC,EAAE,UAAU,CAAC;YACxB,OAAO,CAAC,EAAE,UAAU,CAAC;SACtB,CAAC;KACH,GACA,OAAO,CAAC,IAAI,CAAC;IA+BhB;;;;;OAKG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW/C;;;;;;;;;;;;;;;;;;OAkBG;IACG,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAwCjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACG,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAgEnD;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IA+D1D;;;;;;;OAOG;IACG,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC;IAuBrC;;;;;;;OAOG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAgCnE;;;;;;;;OAQG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9C;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/D;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IA4BvD;;;;;;;;;;;;;;;OAeG;IACG,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAiCvE;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAYlC;;;OAGG;YACW,OAAO;IA2DrB;;;OAGG;YACW,aAAa;IAQ3B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;;OAGG;IACH,OAAO,CAAC,eAAe;CAYxB"}

package/dist/client.js

@@ -38,17 +38,39 @@ const DEFAULT_TIMEOUTS = {
  * });
  *
  * // Store a memory
- * await client.retain(
- *   'my-project',
- *   'Fixed auth redirect by moving AuthProvider to root',
- *   'User was experiencing infinite redirects'
- * );
+ * await client.retain({
+ *   bankId: 'my-project',
+ *   content: 'Fixed auth redirect by moving AuthProvider to root',
+ *   context: 'User was experiencing infinite redirects'
+ * });
  *
  * // Recall memories
- * const memories = await client.recall('my-project', 'authentication issues');
+ * const memories = await client.recall({
+ *   bankId: 'my-project',
+ *   query: 'authentication issues'
+ * });
+ *
+ * // Recall with usefulness boosting
+ * const boosted = await client.recall({
+ *   bankId: 'my-project',
+ *   query: 'authentication issues',
+ *   boostByUsefulness: true,
+ *   usefulnessWeight: 0.3
+ * });
  *
  * // Reflect and form opinions
- * const reflection = await client.reflect('my-project', 'What patterns have I noticed?');
+ * const reflection = await client.reflect({
+ *   bankId: 'my-project',
+ *   query: 'What patterns have I noticed?'
+ * });
+ *
+ * // Submit feedback signals
+ * await client.signal({
+ *   bankId: 'my-project',
+ *   signals: [
+ *     { factId: memories[0].id, signalType: 'used', query: 'auth issues' }
+ *   ]
+ * });
  * ```
  */
 export class HindsightClient {
@@ -161,19 +183,41 @@ export class HindsightClient {
      * Store content with automatic extraction.
      *
      * Hindsight automatically extracts entities, relationships, and metadata.
+     * You can optionally provide user-defined entities to combine with auto-extracted ones.
      *
-     * @param bankId - Bank identifier
-     * @param content - Content to store
-     * @param context - Optional additional context
+     * @param input - Retain input with bankId, content, and optional context/entities
      * @returns Number of items processed
      * @throws {HindsightError} If bank doesn't exist
+     *
+     * @example
+     * ```typescript
+     * await client.retain({
+     *   bankId: 'my-project',
+     *   content: 'Fixed auth redirect by moving AuthProvider to root',
+     *   context: 'User was experiencing infinite redirects'
+     * });
+     * ```
      */
-    async retain(bankId, content, context, options) {
+    async retain(input) {
         // Use async mode for content > 2KB to avoid timeout from LLM extraction
-        const useAsync = options?.async ?? content.length > 2000;
-        const response = await this.request("POST", `/v1/default/banks/${encodeURIComponent(bankId)}/memories`, {
+        const useAsync = input.async ?? input.content.length > 2000;
+        // Build item with optional entities
+        const item = { content: input.content };
+        if (input.context) {
+            item.context = input.context;
+        }
+        if (input.entities && input.entities.length > 0) {
+            item.entities = input.entities.map((e) => {
+                const entity = { text: e.text };
+                if (e.type) {
+                    entity.type = e.type;
+                }
+                return entity;
+            });
+        }
+        const response = await this.request("POST", `/v1/default/banks/${encodeURIComponent(input.bankId)}/memories`, {
             body: {
-                items: [{ content, context }],
+                items: [item],
                 async: useAsync,
             },
             timeout: useAsync ? 5000 : this.timeouts.retain, // Quick return for async
@@ -192,20 +236,55 @@ export class HindsightClient {
      * Results are fused using Reciprocal Rank Fusion (RRF),
      * then reranked with a neural cross-encoder.
      *
-     * @param bankId - Bank identifier
-     * @param query - Search query
-     * @param options - Search options
+     * Optionally boost results by usefulness score (based on feedback signals).
+     *
+     * @param input - Recall input with bankId, query, and optional search options
      * @returns Ranked list of matching memories
      * @throws {HindsightError} If bank doesn't exist
+     *
+     * @example
+     * ```typescript
+     * // Basic recall
+     * const memories = await client.recall({
+     *   bankId: 'my-project',
+     *   query: 'authentication issues'
+     * });
+     *
+     * // With usefulness boosting
+     * const boosted = await client.recall({
+     *   bankId: 'my-project',
+     *   query: 'authentication issues',
+     *   boostByUsefulness: true,
+     *   usefulnessWeight: 0.3
+     * });
+     * ```
      */
-    async recall(bankId, query, options = {}) {
-        const response = await this.request("POST", `/v1/default/banks/${encodeURIComponent(bankId)}/memories/recall`, {
-            body: {
-                query,
-                budget: options.budget ?? "mid",
-                type: options.factType !== "all" ? options.factType : undefined,
-                max_tokens: options.maxTokens,
-            },
+    async recall(input) {
+        // Build request body
+        const body = {
+            query: input.query,
+            budget: input.budget ?? "mid",
+        };
+        // Add type filter if not 'all'
+        if (input.factType && input.factType !== "all") {
+            body.type = input.factType;
+        }
+        // Add max tokens if specified
+        if (input.maxTokens !== undefined) {
+            body.max_tokens = input.maxTokens;
+        }
+        // Add usefulness boosting parameters
+        if (input.boostByUsefulness) {
+            body.boost_by_usefulness = true;
+            if (input.usefulnessWeight !== undefined) {
+                body.usefulness_weight = input.usefulnessWeight;
+            }
+            if (input.minUsefulness !== undefined) {
+                body.min_usefulness = input.minUsefulness;
+            }
+        }
+        const response = await this.request("POST", `/v1/default/banks/${encodeURIComponent(input.bankId)}/memories/recall`, {
+            body,
             timeout: this.timeouts.recall,
         });
         return response.results.map((r) => {
@@ -235,15 +314,21 @@ export class HindsightClient {
      * 5. Stores opinions asynchronously (influences future reflects)
      * 6. Returns reasoned response with citations
      *
-     * @param bankId - Bank identifier
-     * @param query - What to think about or reason through
-     * @param context - Optional additional context
+     * @param input - Reflect input with bankId, query, and optional context
      * @returns Reflection result with text, opinions, and citations
      * @throws {HindsightError} If bank doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const reflection = await client.reflect({
+     *   bankId: 'my-project',
+     *   query: 'What patterns have I noticed in the codebase?'
+     * });
+     * ```
      */
-    async reflect(bankId, query, context) {
-        const response = await this.request("POST", `/v1/default/banks/${encodeURIComponent(bankId)}/reflect`, {
-            body: { query, context },
+    async reflect(input) {
+        const response = await this.request("POST", `/v1/default/banks/${encodeURIComponent(input.bankId)}/reflect`, {
+            body: { query: input.query, context: input.context },
             timeout: this.timeouts.reflect,
         });
         // Map the simpler API response to our ReflectResult structure
@@ -349,6 +434,93 @@ export class HindsightClient {
         await this.forgetAll(bankId);
     }
     // ============================================
+    // Feedback Signal Operations
+    // ============================================
+    /**
+     * Submit feedback signals for recalled facts.
+     *
+     * Signal types and their weights:
+     * - `used`: Fact was referenced in response (weight: +1.0)
+     * - `ignored`: Fact was recalled but not used (weight: -0.5)
+     * - `helpful`: Explicit positive feedback (weight: +1.5)
+     * - `not_helpful`: Explicit negative feedback (weight: -1.0)
+     *
+     * @param input - Signal input with bankId and array of signals
+     * @returns Result with number of signals processed
+     * @throws {HindsightError} If bank doesn't exist
+     *
+     * @example
+     * ```typescript
+     * await client.signal({
+     *   bankId: 'my-project',
+     *   signals: [
+     *     { factId: 'fact-1', signalType: 'used', query: 'auth issues', confidence: 1.0 },
+     *     { factId: 'fact-2', signalType: 'ignored', query: 'auth issues', confidence: 0.5 }
+     *   ]
+     * });
+     * ```
+     */
+    async signal(input) {
+        const response = await this.request("POST", `/v1/default/banks/${encodeURIComponent(input.bankId)}/signal`, {
+            body: {
+                signals: input.signals.map((s) => ({
+                    fact_id: s.factId,
+                    signal_type: s.signalType,
+                    confidence: s.confidence ?? 1.0,
+                    query: s.query,
+                    context: s.context,
+                })),
+            },
+        });
+        return {
+            success: response.success,
+            signalsProcessed: response.signals_processed,
+            updatedFacts: response.updated_facts,
+        };
+    }
+    /**
+     * Get usefulness statistics for a specific fact.
+     *
+     * @param input - Input with bankId and factId
+     * @returns Usefulness statistics for the fact
+     * @throws {HindsightError} If bank or fact doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const stats = await client.getFactStats({
+     *   bankId: 'my-project',
+     *   factId: 'fact-123'
+     * });
+     * console.log(`Usefulness: ${stats.usefulnessScore}`);
+     * ```
+     */
+    async getFactStats(input) {
+        const response = await this.request("GET", `/v1/default/banks/${encodeURIComponent(input.bankId)}/facts/${encodeURIComponent(input.factId)}/stats`);
+        const result = {
+            factId: response.fact_id,
+            usefulnessScore: response.usefulness_score,
+            signalCount: response.signal_count,
+            signalBreakdown: response.signal_breakdown,
+            createdAt: response.created_at,
+        };
+        if (response.last_signal_at) {
+            result.lastSignalAt = response.last_signal_at;
+        }
+        return result;
+    }
+    // ============================================
+    // Bank Listing
+    // ============================================
+    /**
+     * List all memory banks.
+     *
+     * @returns Array of all banks
+     */
+    async listBanks() {
+        const response = await this.request("GET", "/v1/default/banks");
+        return response.banks.map((b) => this.mapBankResponse(b));
+    }
+    // ============================================
     // Private Methods
     // ============================================
     /**

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/events.d.ts

@@ -57,6 +57,26 @@ export interface MindEventMap {
     "offline:synced": [info: {
         count: number;
     }];
+    /** Emitted when feedback is processed at session end */
+    "feedback:processed": [
+        info: {
+            sessionId: string;
+            summary: {
+                used: number;
+                ignored: number;
+                uncertain: number;
+            };
+        }
+    ];
+    /** Emitted when feedback signals are queued offline (degraded mode) */
+    "feedback:queued": [info: {
+        sessionId: string;
+        count: number;
+    }];
+    /** Emitted when offline feedback signals are synced to Hindsight */
+    "feedback:synced": [info: {
+        count: number;
+    }];
     /** Emitted on errors (non-fatal, allows continued operation) */
     error: [error: Error];
 }

package/dist/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"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"}

package/dist/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAoE3C,+CAA+C;AAC/C,qBAAqB;AACrB,+CAA+C;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,OAAO,iBAAkB,SAAQ,YAAY;IACjD;;;;;;OAMG;IACH,EAAE,CACA,KAAQ,EACR,QAA4C;QAE5C,OAAO,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,QAAwC,CAAC,CAAC;IACnE,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CACF,KAAQ,EACR,QAA4C;QAE5C,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,QAAwC,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;OAMG;IACH,GAAG,CACD,KAAQ,EACR,QAA4C;QAE5C,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,QAAwC,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;OAMG;IACH,IAAI,CAA0B,KAAQ,EAAE,GAAG,IAAqB;QAC9D,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;IACpC,CAAC;IAED;;;;;;OAMG;IACH,eAAe,CACb,KAAQ,EACR,QAA4C;QAE5C,OAAO,KAAK,CAAC,eAAe,CAC1B,KAAK,EACL,QAAwC,CACzC,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,mBAAmB,CACjB,KAAQ,EACR,QAA4C;QAE5C,OAAO,KAAK,CAAC,mBAAmB,CAC9B,KAAK,EACL,QAAwC,CACzC,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,kBAAkB,CAAC,KAAqB;QACtC,OAAO,KAAK,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAC,KAAoB;QAChC,OAAO,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;CACF"}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA+E3C,+CAA+C;AAC/C,qBAAqB;AACrB,+CAA+C;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,OAAO,iBAAkB,SAAQ,YAAY;IACjD;;;;;;OAMG;IACH,EAAE,CACA,KAAQ,EACR,QAA4C;QAE5C,OAAO,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,QAAwC,CAAC,CAAC;IACnE,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CACF,KAAQ,EACR,QAA4C;QAE5C,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,QAAwC,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;OAMG;IACH,GAAG,CACD,KAAQ,EACR,QAA4C;QAE5C,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,QAAwC,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;OAMG;IACH,IAAI,CAA0B,KAAQ,EAAE,GAAG,IAAqB;QAC9D,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;IACpC,CAAC;IAED;;;;;;OAMG;IACH,eAAe,CACb,KAAQ,EACR,QAA4C;QAE5C,OAAO,KAAK,CAAC,eAAe,CAC1B,KAAK,EACL,QAAwC,CACzC,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,mBAAmB,CACjB,KAAQ,EACR,QAA4C;QAE5C,OAAO,KAAK,CAAC,mBAAmB,CAC9B,KAAK,EACL,QAAwC,CACzC,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,kBAAkB,CAAC,KAAqB;QACtC,OAAO,KAAK,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAC,KAAoB;QAChC,OAAO,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;CACF"}