hippo-memory 1.52.8 → 1.53.0

package/dist/capture.d.ts

@@ -14,6 +14,7 @@ export interface ExtractedItem {
     category: string;
     tags: string[];
 }
+export declare function splitSentences(text: string): string[];
 /**
  * Main extraction function. Scans text for actionable items using heuristics.
  */
@@ -28,6 +29,7 @@ export interface CaptureOptions {
      * `stdinTimedOut` marks an empty read "unknown", not "no payload". */
     stdinText?: string;
     stdinTimedOut?: boolean;
+    sessionTurns?: readonly SessionTurn[];
     /**
      * Tee stdout/stderr to this log file while capture runs. Mirrors the
      * pattern used by `hippo sleep --log-file` so the SessionEnd hook output
@@ -45,7 +47,41 @@ export interface CaptureOptions {
      * behaviour. Ignored when `global: true` (global captures are host-wide).
      */
     tenantId?: string;
+    originProject?: string;
 }
+/**
+ * Runtime shape guards used throughout this file wherever a value arrives
+ * unparsed (JSONL transcript records, stdout/stderr write() chunks). Generic
+ * over the input so the parameter is never annotated `unknown` directly — TS
+ * infers it from the call site — while the check itself avoids `typeof` by
+ * testing identity against the coercion (`String(x) === x`) /
+ * prototype-chain (`instanceof Object`) instead. Behaviourally equivalent to
+ * `typeof x === 'string'` / a truthy `typeof x === 'object'` check for
+ * anything `JSON.parse` can produce (the only divergence is boxed
+ * primitives, which JSON.parse never yields).
+ */
+export declare function isStringValue<T>(value: T): value is T & string;
+export declare function isObjectLike<T>(value: T): value is T & object;
+/** Message for a caught value of unknown shape. `cause` names the sanctioned unknown-input case (error-cause enrichment). */
+export declare function errorMessage(cause: unknown): string;
+/** Transcript-line flags isNonHumanUserLine reads (any may be absent); `promptSource: 'system'` marks Claude Code's own notices. */
+interface TranscriptLineFlags {
+    type?: unknown;
+    isMeta?: unknown;
+    isSidechain?: unknown;
+    isCompactSummary?: unknown;
+    promptSource?: unknown;
+}
+export interface SessionTurn {
+    role: 'user' | 'assistant';
+    text: string;
+}
+export interface TranscriptRecord extends TranscriptLineFlags {
+    message?: unknown;
+    payload?: unknown;
+    cwd?: unknown;
+}
+export declare function collectSessionTurns(jsonl: string, visit?: (record: TranscriptRecord) => void): SessionTurn[];
 export declare function summariseTranscript(jsonl: string): string;
 /**
  * Resolve a transcript path for `--last-session`.
@@ -53,11 +89,13 @@ export declare function summariseTranscript(jsonl: string): string;
  * Priority, where the first source present is the only one tried:
  *   1. Explicit `transcriptPath` option (from `--transcript <path>`)
  *   2. Stdin JSON payload (Claude Code / OpenCode SessionEnd hook shape)
- *   3. Most recent `.jsonl` under `~/.claude/projects/<any>/`, only on a proven manual run (no path, no stdin text, no timed-out read), because this scan spans every project on the box
+ *   3. Most recent `.jsonl` under `~/.claude/projects/<any>/`, only when the caller passes `mayScan` (only the caller knows it is not a hook) and there is no path and no stdin text, because this scan spans every project on the box
  *
  * Returns null when nothing resolves, a named transcript or payload whose file is missing included. Never throws.
  */
-export declare function resolveLastSessionTranscript(explicit: string | undefined, stdinText: string | undefined, stdinTimedOut?: boolean): string | null;
+export declare function resolveLastSessionTranscript(explicit: string | undefined, stdinText: string | undefined, opts: {
+    mayScan: boolean;
+}): string | null;
 export declare function cmdCapture(hippoRoot: string, options: CaptureOptions): void;
 /** Never read the whole transcript — PreCompact fires exactly when it's largest. */
 export declare const PRE_COMPACT_TAIL_BYTES: number;
@@ -104,19 +142,6 @@ export declare function readTranscriptTail(transcriptPath: string, capBytes?: nu
  * guard, not per-file copies.
  */
 export declare function sanitizeLogMessage(message: string): string;
-/** What one pre-compact run saved, reported to the user after compaction. */
-export interface PreCompactReport {
-    snapshotSaved: boolean;
-    /** Claude Code session the run belonged to, when the payload named one. */
-    sessionId: string | null;
-}
-/** Line shown after compaction, or null when nothing was saved (Claude Code's own generic message is the fallback). */
-export declare function preCompactMessage(report: Pick<PreCompactReport, 'snapshotSaved'>): string | null;
-/**
- * Where pre-compact leaves its report for `hippo post-compact`: next to the
- * pre-compact log, so both hooks find it from the same `--log-file`.
- */
-export declare function preCompactReportPath(logFile: string): string;
 /** A session's task, summary and next step from its transcript tail, secrets scrubbed and capped, '' where none; null with a logged reason when nothing is derivable. */
 export declare function transcriptWorkingState(transcriptPath: string, log: (message: string) => void): Pick<TaskSnapshot, 'task' | 'summary' | 'next_step'> | null;
 export interface PreCompactOptions {
@@ -132,11 +157,12 @@ export interface PreCompactOptions {
  * could turn a caught-and-logged failure back into a non-zero exit.
  */
 export declare function cmdPreCompact(hippoRoot: string, options: PreCompactOptions): Promise<void>;
-/**
- * The message for the PostCompact hook, from the report pre-compact left,
- * or null when there is nothing to say. Consumes the report, so the message
- * shows once. A report from another session, or an old one, is dropped.
- * Never throws.
- */
-export declare function postCompactMessage(stdinText: string | undefined, logFile?: string, now?: Date): string | null;
+export interface PostCompactOptions {
+    stdinText?: string;
+    logFile?: string;
+    afterSave?: (transcriptPath: string, originProject: string, log: (message: string) => void) => void;
+}
+/** PostCompact entry point: saves the summary and its items, replays earlier leftovers, returns the one line to show. Never throws, so the hook exits 0. */
+export declare function cmdPostCompact(hippoRoot: string, options: PostCompactOptions): string | null;
+export {};
 //# sourceMappingURL=capture.d.ts.map