claude-cognitive 0.1.0

package/dist/cli/utils/output.d.ts

@@ -0,0 +1,90 @@
+/**
+ * CLI output utilities.
+ * @module cli/utils/output
+ */
+import type { Memory, Opinion } from "../../types.js";
+/**
+ * Output formatting options.
+ */
+export interface OutputOptions {
+    /** Output as JSON */
+    json?: boolean;
+    /** Suppress output */
+    quiet?: boolean;
+}
+/**
+ * Output data in the appropriate format.
+ *
+ * @param data - Data to output
+ * @param formatter - Function to format data for human-readable output
+ * @param options - Output options
+ */
+export declare function output<T>(data: T, formatter: (data: T) => string, options?: OutputOptions): void;
+/**
+ * Output to stderr (for messages that shouldn't interfere with piping).
+ *
+ * @param message - Message to output
+ * @param options - Output options
+ */
+export declare function info(message: string, options?: OutputOptions): void;
+/**
+ * Output a warning to stderr.
+ *
+ * @param message - Warning message
+ * @param options - Output options
+ */
+export declare function warn(message: string, options?: OutputOptions): void;
+/**
+ * Format memories for human-readable output.
+ */
+export declare function formatMemories(memories: Memory[]): string;
+/**
+ * Format opinions for human-readable output.
+ */
+export declare function formatOpinions(opinions: Opinion[]): string;
+/**
+ * Format a status object for human-readable output.
+ */
+export declare function formatStatus(status: {
+    hindsight: {
+        healthy: boolean;
+        version?: string;
+        error?: string;
+    };
+    bankId: string;
+    memoryCount?: number;
+    semanticPath: string;
+    semanticLoaded: boolean;
+    degraded: boolean;
+}): string;
+/**
+ * Format learn result for human-readable output.
+ */
+export declare function formatLearnResult(result: {
+    summary: string;
+    worldFacts: number;
+    opinions: Opinion[];
+    filesAnalyzed: number;
+    duration: number;
+}): string;
+/**
+ * Format configuration for human-readable output.
+ */
+export declare function formatConfig(config: {
+    hindsight: {
+        host: string;
+        port: number;
+        apiKey?: string;
+    };
+    bankId?: string;
+    disposition?: {
+        skepticism: number;
+        literalism: number;
+        empathy: number;
+    };
+    background?: string;
+    semantic?: {
+        path: string;
+    };
+}): string;
+//# sourceMappingURL=output.d.ts.map

package/dist/cli/utils/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/output.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAMtD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qBAAqB;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,sBAAsB;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAMD;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,CAAC,EACtB,IAAI,EAAE,CAAC,EACP,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,EAC9B,OAAO,GAAE,aAAkB,GAC1B,IAAI,CAQN;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,IAAI,CAIvE;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,IAAI,CAIvE;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAuBzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAW1D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE;IACnC,SAAS,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;CACnB,GAAG,MAAM,CA+BT;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,CAqBT;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE;IACnC,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7B,GAAG,MAAM,CA4BT"}

package/dist/cli/utils/output.js

@@ -0,0 +1,164 @@
+/**
+ * CLI output utilities.
+ * @module cli/utils/output
+ */
+// ============================================
+// Output Function
+// ============================================
+/**
+ * Output data in the appropriate format.
+ *
+ * @param data - Data to output
+ * @param formatter - Function to format data for human-readable output
+ * @param options - Output options
+ */
+export function output(data, formatter, options = {}) {
+    if (options.quiet)
+        return;
+    if (options.json) {
+        console.log(JSON.stringify(data, null, 2));
+    }
+    else {
+        console.log(formatter(data));
+    }
+}
+/**
+ * Output to stderr (for messages that shouldn't interfere with piping).
+ *
+ * @param message - Message to output
+ * @param options - Output options
+ */
+export function info(message, options = {}) {
+    if (options.quiet)
+        return;
+    if (options.json)
+        return; // Suppress info messages in JSON mode
+    console.error(message);
+}
+/**
+ * Output a warning to stderr.
+ *
+ * @param message - Warning message
+ * @param options - Output options
+ */
+export function warn(message, options = {}) {
+    if (options.quiet)
+        return;
+    if (options.json)
+        return;
+    console.error(`Warning: ${message}`);
+}
+// ============================================
+// Formatters
+// ============================================
+/**
+ * Format memories for human-readable output.
+ */
+export function formatMemories(memories) {
+    if (memories.length === 0) {
+        return "No memories found.";
+    }
+    const lines = [];
+    for (const memory of memories) {
+        const date = new Date(memory.createdAt).toLocaleDateString();
+        const type = memory.factType.toUpperCase();
+        const confidence = memory.confidence !== undefined
+            ? ` (${(memory.confidence * 100).toFixed(0)}%)`
+            : "";
+        lines.push(`[${type}] ${date}${confidence}`);
+        lines.push(`  ${memory.text}`);
+        if (memory.context) {
+            lines.push(`  Context: ${memory.context}`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n").trim();
+}
+/**
+ * Format opinions for human-readable output.
+ */
+export function formatOpinions(opinions) {
+    if (opinions.length === 0) {
+        return "No opinions formed.";
+    }
+    return opinions
+        .map((op) => {
+        const confidence = (op.confidence * 100).toFixed(0);
+        return `- ${op.opinion} (${confidence}% confidence)`;
+    })
+        .join("\n");
+}
+/**
+ * Format a status object for human-readable output.
+ */
+export function formatStatus(status) {
+    const lines = [];
+    // Hindsight status
+    if (status.hindsight.healthy) {
+        lines.push(`Hindsight: Connected${status.hindsight.version ? ` (v${status.hindsight.version})` : ""}`);
+    }
+    else {
+        lines.push(`Hindsight: Disconnected${status.hindsight.error ? ` - ${status.hindsight.error}` : ""}`);
+    }
+    // Bank info
+    lines.push(`Bank: ${status.bankId}`);
+    if (status.memoryCount !== undefined) {
+        lines.push(`Memories: ${status.memoryCount}`);
+    }
+    // Semantic memory
+    lines.push(`Semantic: ${status.semanticPath} (${status.semanticLoaded ? "loaded" : "not loaded"})`);
+    // Degraded mode
+    if (status.degraded) {
+        lines.push("\n*** Running in DEGRADED mode (Hindsight unavailable) ***");
+    }
+    return lines.join("\n");
+}
+/**
+ * Format learn result for human-readable output.
+ */
+export function formatLearnResult(result) {
+    const lines = [];
+    lines.push(result.summary);
+    lines.push("");
+    lines.push(`Stats:`);
+    lines.push(`  Files analyzed: ${result.filesAnalyzed}`);
+    lines.push(`  World facts stored: ${result.worldFacts}`);
+    lines.push(`  Opinions formed: ${result.opinions.length}`);
+    lines.push(`  Duration: ${(result.duration / 1000).toFixed(1)}s`);
+    if (result.opinions.length > 0) {
+        lines.push("");
+        lines.push("Opinions:");
+        for (const op of result.opinions) {
+            const confidence = (op.confidence * 100).toFixed(0);
+            lines.push(`  - ${op.opinion} (${confidence}%)`);
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * Format configuration for human-readable output.
+ */
+export function formatConfig(config) {
+    const lines = [];
+    lines.push("Hindsight:");
+    lines.push(`  Host: ${config.hindsight.host}`);
+    lines.push(`  Port: ${config.hindsight.port}`);
+    lines.push(`  API Key: ${config.hindsight.apiKey ? "***" : "(not set)"}`);
+    if (config.bankId) {
+        lines.push(`\nBank ID: ${config.bankId}`);
+    }
+    if (config.disposition) {
+        lines.push("\nDisposition:");
+        lines.push(`  Skepticism: ${config.disposition.skepticism}/5`);
+        lines.push(`  Literalism: ${config.disposition.literalism}/5`);
+        lines.push(`  Empathy: ${config.disposition.empathy}/5`);
+    }
+    if (config.background) {
+        lines.push(`\nBackground: ${config.background}`);
+    }
+    if (config.semantic) {
+        lines.push(`\nSemantic Memory: ${config.semantic.path}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=output.js.map

package/dist/cli/utils/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../../src/cli/utils/output.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkBH,+CAA+C;AAC/C,kBAAkB;AAClB,+CAA+C;AAE/C;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CACpB,IAAO,EACP,SAA8B,EAC9B,UAAyB,EAAE;IAE3B,IAAI,OAAO,CAAC,KAAK;QAAE,OAAO;IAE1B,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,IAAI,CAAC,OAAe,EAAE,UAAyB,EAAE;IAC/D,IAAI,OAAO,CAAC,KAAK;QAAE,OAAO;IAC1B,IAAI,OAAO,CAAC,IAAI;QAAE,OAAO,CAAC,sCAAsC;IAChE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AACzB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,IAAI,CAAC,OAAe,EAAE,UAAyB,EAAE;IAC/D,IAAI,OAAO,CAAC,KAAK;QAAE,OAAO;IAC1B,IAAI,OAAO,CAAC,IAAI;QAAE,OAAO;IACzB,OAAO,CAAC,KAAK,CAAC,YAAY,OAAO,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,+CAA+C;AAC/C,aAAa;AACb,+CAA+C;AAE/C;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,QAAkB;IAC/C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,kBAAkB,EAAE,CAAC;QAC7D,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,UAAU,GACd,MAAM,CAAC,UAAU,KAAK,SAAS;YAC7B,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;YAC/C,CAAC,CAAC,EAAE,CAAC;QAET,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,IAAI,GAAG,UAAU,EAAE,CAAC,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/B,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7C,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,QAAmB;IAChD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,qBAAqB,CAAC;IAC/B,CAAC;IAED,OAAO,QAAQ;SACZ,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;QACV,MAAM,UAAU,GAAG,CAAC,EAAE,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACpD,OAAO,KAAK,EAAE,CAAC,OAAO,KAAK,UAAU,eAAe,CAAC;IACvD,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAO5B;IACC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,mBAAmB;IACnB,IAAI,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CACR,uBAAuB,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC3F,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CACR,0BAA0B,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CACzF,CAAC;IACJ,CAAC;IAED,YAAY;IACZ,KAAK,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACrC,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,kBAAkB;IAClB,KAAK,CAAC,IAAI,CACR,aAAa,MAAM,CAAC,YAAY,KAAK,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,GAAG,CACxF,CAAC;IAEF,gBAAgB;IAChB,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAMjC;IACC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,KAAK,CAAC,IAAI,CAAC,qBAAqB,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;IACxD,KAAK,CAAC,IAAI,CAAC,yBAAyB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IACzD,KAAK,CAAC,IAAI,CAAC,sBAAsB,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3D,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAElE,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxB,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACjC,MAAM,UAAU,GAAG,CAAC,EAAE,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACpD,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,OAAO,KAAK,UAAU,IAAI,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAM5B;IACC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAE1E,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,WAAW,CAAC,UAAU,IAAI,CAAC,CAAC;QAC/D,KAAK,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,WAAW,CAAC,UAAU,IAAI,CAAC,CAAC;QAC/D,KAAK,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,WAAW,CAAC,OAAO,IAAI,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,sBAAsB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,200 @@
+/**
+ * HindsightClient - TypeScript client for the Hindsight memory API.
+ * @module client
+ */
+import type { Bank, BankOptions, Disposition, HealthStatus, HindsightClientOptions, Memory, RecallOptions, TraitValue, ReflectResult } from "./types.js";
+/**
+ * HindsightClient provides a TypeScript interface to the Hindsight memory API.
+ *
+ * @example
+ * ```typescript
+ * const client = new HindsightClient({
+ *   host: 'localhost',
+ *   port: 8888,
+ * });
+ *
+ * // Check health
+ * const health = await client.health();
+ * if (!health.healthy) {
+ *   console.error('Hindsight unavailable');
+ * }
+ *
+ * // Create a bank
+ * await client.createBank({
+ *   bankId: 'my-project',
+ *   disposition: { skepticism: 4, literalism: 4, empathy: 2 },
+ *   background: 'Developer assistant for a React app',
+ * });
+ *
+ * // Store a memory
+ * await client.retain(
+ *   'my-project',
+ *   'Fixed auth redirect by moving AuthProvider to root',
+ *   'User was experiencing infinite redirects'
+ * );
+ *
+ * // Recall memories
+ * const memories = await client.recall('my-project', 'authentication issues');
+ *
+ * // Reflect and form opinions
+ * const reflection = await client.reflect('my-project', 'What patterns have I noticed?');
+ * ```
+ */
+export declare class HindsightClient {
+    private readonly baseUrl;
+    private readonly apiKey?;
+    private readonly timeouts;
+    /**
+     * Create a new HindsightClient.
+     *
+     * @param options - Client configuration options
+     */
+    constructor(options?: HindsightClientOptions);
+    /**
+     * Create a new memory bank with disposition.
+     *
+     * @param options - Bank creation options
+     * @throws {HindsightError} If bank already exists or disposition is invalid
+     */
+    createBank(options: BankOptions): Promise<void>;
+    /**
+     * Get bank information.
+     *
+     * @param bankId - Bank identifier
+     * @returns Bank information
+     * @throws {HindsightError} If bank doesn't exist
+     */
+    getBank(bankId: string): Promise<Bank>;
+    /**
+     * Update bank disposition traits.
+     *
+     * @param bankId - Bank identifier
+     * @param disposition - New disposition values
+     * @throws {HindsightError} If bank doesn't exist or disposition is invalid
+     */
+    updateDisposition(bankId: string, disposition: Disposition): Promise<void>;
+    /**
+     * Update bank settings (background and/or disposition).
+     *
+     * @param bankId - Bank identifier
+     * @param updates - Fields to update
+     * @throws {HindsightError} If bank doesn't exist
+     */
+    updateBank(bankId: string, updates: {
+        background?: string;
+        disposition?: {
+            skepticism?: TraitValue;
+            literalism?: TraitValue;
+            empathy?: TraitValue;
+        };
+    }): Promise<void>;
+    /**
+     * Delete a memory bank and all its memories.
+     *
+     * @param bankId - Bank identifier
+     * @throws {HindsightError} If bank doesn't exist
+     */
+    deleteBank(bankId: string): Promise<void>;
+    /**
+     * Store content with automatic extraction.
+     *
+     * Hindsight automatically extracts entities, relationships, and metadata.
+     *
+     * @param bankId - Bank identifier
+     * @param content - Content to store
+     * @param context - Optional additional context
+     * @returns Number of items processed
+     * @throws {HindsightError} If bank doesn't exist
+     */
+    retain(bankId: string, content: string, context?: string): Promise<number>;
+    /**
+     * Search memories using 4-way parallel retrieval.
+     *
+     * Uses four search strategies in parallel:
+     * - Semantic: Vector similarity for conceptual matches
+     * - BM25: Full-text keyword search for exact terms
+     * - Graph: Entity traversal for indirect relationships
+     * - Temporal: Time-range + semantic for historical queries
+     *
+     * 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
+     * @returns Ranked list of matching memories
+     * @throws {HindsightError} If bank doesn't exist
+     */
+    recall(bankId: string, query: string, options?: RecallOptions): Promise<Memory[]>;
+    /**
+     * Reason about accumulated knowledge through disposition lens.
+     *
+     * Process:
+     * 1. Recalls relevant memories (world, experience, opinion)
+     * 2. Loads bank disposition (skepticism, literalism, empathy)
+     * 3. LLM reasons through disposition lens
+     * 4. Extracts new opinions with confidence scores
+     * 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
+     * @returns Reflection result with text, opinions, and citations
+     * @throws {HindsightError} If bank doesn't exist
+     */
+    reflect(bankId: string, query: string, context?: string): Promise<ReflectResult>;
+    /**
+     * Check Hindsight connection health.
+     *
+     * Unlike other methods, this returns a status object instead of
+     * throwing on failure. This makes it safe to use for health checks.
+     *
+     * @returns Health status
+     */
+    health(): Promise<HealthStatus>;
+    /**
+     * Get recent memories from a bank.
+     *
+     * @param bankId - Bank identifier
+     * @param limit - Maximum number of memories to return (default: 50)
+     * @returns Recent memories sorted by creation time (newest first)
+     * @throws {HindsightError} If bank doesn't exist
+     */
+    recent(bankId: string, limit?: number): Promise<Memory[]>;
+    /**
+     * Clear all memories from a bank.
+     *
+     * Note: The Hindsight API only supports clearing all memories at once,
+     * not removing individual memories.
+     *
+     * @param bankId - Bank identifier
+     * @throws {HindsightError} If bank doesn't exist
+     */
+    forgetAll(bankId: string): Promise<void>;
+    /**
+     * @deprecated Use forgetAll() instead - individual memory deletion not supported
+     */
+    forget(bankId: string, _memoryId?: string): Promise<void>;
+    /**
+     * Make an HTTP request to the Hindsight API.
+     * @internal
+     */
+    private request;
+    /**
+     * Safely parse JSON from response, returning undefined on failure.
+     * @internal
+     */
+    private safeParseJson;
+    /**
+     * Validate disposition values are in the valid range (1-5).
+     * @internal
+     */
+    private validateDisposition;
+    /**
+     * Map bank response DTO to public Bank interface.
+     * @internal
+     */
+    private mapBankResponse;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +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;AAsBpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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,GACf,OAAO,CAAC,MAAM,CAAC;IAqBlB;;;;;;;;;;;;;;;;;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;CAaxB"}