hippo-memory 1.69.0 → 1.71.0

package/dist/cli/context.js

@@ -1,62 +1,40 @@
 // The `hippo context` verb, which the per-prompt hook also runs; main() loads it lazily from the command table.
-import * as path from 'path';
-import { createDeliveryRecorder } from '../delivery-recorder.js';
-import { loadConfig } from '../config.js';
-import { blockHash, estimateTokens, isSubagentPayload, recordTokenUse } from '../token-ledger.js';
-import { isGlobalStoreRoot } from '../project-identity.js';
-import { autoDetectContext } from '../context-auto.js';
-import { detectScope } from '../scope.js';
-import { ledgerRoot, withLedgerDb } from '../ledger-db.js';
-import { readHookStdin } from '../stdin.js';
-import * as api from '../api.js';
-import { resolveTenantId } from '../tenant.js';
-import { renderAmbientSummary } from '../ambient.js';
-import { contextBlockLines, contextCost, crossProjectLines, settleTokens } from '../context-render.js';
-import { additionalContextOutput, flushDeliveryRecorder, hasContextData, sessionStartEnvelope, toRenderItems, } from '../prompt-hook.js';
-import { printError } from './output.js';
-import { parseLimitFlag, parseCountFlag, parseBudgetFlag, requireInit, printActiveTaskSnapshot, printSessionEvents, printHandoff, hostSessionId, captureConsole, hookStoreRoot, hookRuntime, payloadCwdRoot, runHookWithStores, inPilotHoldout, } from './shared.js';
-export async function cmdContext(hippoRoot, args, flags, stdinText) {
-    const rec = startDeliveryRecorder(hippoRoot, flags, stdinText);
+import { isSubagentPayload } from '../store/token-ledger.js';
+import { estimateTokens } from '../util/token-text.js';
+import { autoDetectContext } from '../api/context-auto.js';
+import { detectScope } from '../sharing/scope.js';
+import { bookLedgerTurn } from '../api/ledger-db.js';
+import { readHookStdin } from './stdin.js';
+import { isJsonObject, isJsonString } from '../util/json.js';
+import * as api from '../api/index.js';
+import { DEFAULT_CONTEXT_BUDGET } from '../api/context.js';
+import { resolveTenantId } from '../store/tenant.js';
+import { cliApiContext } from './api-context.js';
+import { renderAmbientSummary } from '../core/ambient.js';
+import { contextBlockLines, contextCost, crossProjectLines, settleTokens } from '../api/context-render.js';
+import { additionalContextOutput, flushDeliveryRecorder, hasContextData, sessionStartEnvelope, toRenderItems, } from '../api/prompt-hook.js';
+import { parseLimitFlag, parseCountFlag, parseBudgetFlag, flagIsTrue } from './flag-values.js';
+import { requireInit } from './shared.js';
+import { printActiveTaskSnapshot, printSessionEvents, printHandoff, captureConsole } from './print.js';
+import { hostSessionId, hookStoreRoot, hookRuntime, payloadCwdRoot, runHookWithStores, inPilotHoldout, startDeliveryRecorder } from './hook-runtime.js';
+async function cmdContext(hippoRoot, args, flags, stdinText) {
+    const rec = startDeliveryRecorder(hippoRoot, stdinText, hookRuntime(flags), flagIsTrue(flags, 'pinned-only') ? undefined : 'context');
     // No try/finally: a render throw keeps its own exit code and writes no event.
     await renderContext(hippoRoot, args, flags, stdinText, rec);
     flushDeliveryRecorder(rec);
 }
-/** A delivery recorder for a pinned-only call when its ledger store enables one, else null; never throws. */
-function startDeliveryRecorder(hippoRoot, flags, stdinText) {
-    if (flags['pinned-only'] !== true)
-        return null;
-    try {
-        // The same store withLedgerDb writes the token ledger to, so its config governs both.
-        const root = ledgerRoot(hippoRoot);
-        if (root === null || !loadConfig(root).deliveryLedger.enabled)
-            return null;
-        return createDeliveryRecorder({
-            root,
-            storeHash: blockHash(path.resolve(root)),
-            writeStore: isGlobalStoreRoot(root) ? 'global' : 'local',
-            tenantId: resolveTenantId({}),
-            stdinText,
-            envSessionId: hostSessionId(),
-            runtime: hookRuntime(flags) === 'copilot' ? 'copilot' : undefined,
-        });
-    }
-    catch (error) {
-        // The hook's one-line stderr contract pins this exact text, so it bypasses the leveled logger.
-        printError(`[hippo] delivery ledger skipped:${error instanceof Error ? error.message : String(error)}`);
-        return null;
-    }
-}
 /** The hook payload's session id and raw prompt; a malformed or empty payload yields neither. */
 function readHookPayload(stdinText) {
     let sessionId;
     let prompt;
     if (stdinText && stdinText.trim() !== '') {
         try {
-            // SAFETY: both fields are type-checked below before use; `?? {}` covers a JSON null payload.
-            const { session_id: sid, prompt: raw } = (JSON.parse(stdinText.trim()) ?? {});
-            if (typeof sid === 'string' && sid.trim() !== '')
+            const payload = JSON.parse(stdinText.trim());
+            const sid = isJsonObject(payload) ? payload['session_id'] : undefined;
+            const raw = isJsonObject(payload) ? payload['prompt'] : undefined;
+            if (isJsonString(sid) && sid.trim() !== '')
                 sessionId = sid;
-            if (typeof raw === 'string')
+            if (isJsonString(raw))
                 prompt = raw;
         }
         catch {
@@ -68,7 +46,7 @@ function readHookPayload(stdinText) {
 async function renderContext(hippoRoot, args, flags, stdinText, rec) {
     // --pinned-only fires on every prompt, even where no local .hippo exists, so it skips requireInit
     // and api.getContext falls back to global-only.
-    const pinnedOnly = flags['pinned-only'] === true;
+    const pinnedOnly = flagIsTrue(flags, 'pinned-only');
     if (!pinnedOnly) {
         requireInit(hippoRoot);
     }
@@ -80,21 +58,14 @@ async function renderContext(hippoRoot, args, flags, stdinText, rec) {
         rec?.disabled();
         return;
     }
-    const budget = parseBudgetFlag(flags['budget'], 1500);
+    const budget = parseBudgetFlag(flags['budget'], DEFAULT_CONTEXT_BUDGET);
     if (budget <= 0) {
         rec?.disabled();
         return;
     }
     // --auto shells out to git, so it stays CLI-side; api.getContext stays host-agnostic and falls back to '*'.
-    let query = args.join(' ').trim();
-    if (!query && flags['auto']) {
-        query = autoDetectContext();
-    }
-    const ctx = {
-        hippoRoot,
-        tenantId: resolvedTenant,
-        actor: api.adminActor('cli'),
-    };
+    const query = contextQuery(args, flags);
+    const ctx = cliApiContext(hippoRoot, resolvedTenant);
     const format = String(flags['format'] ?? 'markdown');
     const framing = String(flags['framing'] ?? 'observe');
     const opts = buildContextOpts(flags, { query, budget, pinnedOnly, format, framing, session, rec });
@@ -105,6 +76,13 @@ async function renderContext(hippoRoot, args, flags, stdinText, rec) {
     }
     const envelope = format === 'copilot' ? sessionStartEnvelope(stdinText) : undefined;
     const view = { hippoRoot, tenantId: ctx.tenantId, ledgerSessionId, payloadSessionId, pinnedOnly, framing, rec, result, envelope };
+    renderContextView(view, format, query);
+}
+function contextQuery(args, flags) {
+    const query = args.join(' ').trim();
+    return !query && flags['auto'] ? autoDetectContext() : query;
+}
+function renderContextView(view, format, query) {
     if (format === 'json') {
         renderContextJson(view, query);
     }
@@ -135,7 +113,7 @@ function buildContextOpts(flags, input) {
     const ctxExplicitScope = flags['scope'] !== undefined ? String(flags['scope']).trim() : null;
     const ctxActiveScope = ctxExplicitScope || detectScope();
     // --cross-project re-includes other-project memories, rendered under their own section.
-    const crossProject = flags['cross-project'] === true;
+    const crossProject = flagIsTrue(flags, 'cross-project');
     return {
         q: input.query,
         budget: input.budget,
@@ -174,12 +152,12 @@ function renderContextJson(view, query) {
     });
     console.log(jsonText);
     rec?.delivered({ state: 'sent', emittedText: `${jsonText}\n` });
-    withLedgerDb(view.hippoRoot, (db) => {
-        recordTokenUse(db, {
-            tenantId: view.tenantId, sessionId: view.ledgerSessionId, surface: view.pinnedOnly ? 'hook' : 'context',
-            event: 'inject', items: output.length, tokens: estimateTokens(jsonText),
-        });
-        flushDeliveryRecorder(rec, db);
+    bookLedgerTurn(view.hippoRoot, {
+        uses: [{
+                tenantId: view.tenantId, sessionId: view.ledgerSessionId, surface: view.pinnedOnly ? 'hook' : 'context',
+                event: 'inject', items: output.length, tokens: estimateTokens(jsonText),
+            }],
+        delivery: (write) => flushDeliveryRecorder(rec, write),
     });
 }
 /** The default format; the header figure counts the whole block, sections included, as the ledger does. */
@@ -199,7 +177,8 @@ function renderContextMarkdown(view) {
             printSessionEvents(result.recentEvents);
         }
         if (renderItems.length > 0)
-            printContextMarkdown(renderItems, t, framing);
+            for (const line of contextBlockLines(renderItems, t, framing))
+                console.log(line);
         printCrossProjectSection(crossEntries);
         if (result.ambientState) {
             console.log(`\n${renderAmbientSummary(result.ambientState)}`);
@@ -208,23 +187,18 @@ function renderContextMarkdown(view) {
     if (text.length > 0)
         console.log(text);
     rec?.delivered(text.length > 0 ? { state: 'sent', emittedText: `${text}\n` } : { state: 'empty' });
-    withLedgerDb(view.hippoRoot, (db) => {
-        recordTokenUse(db, {
-            tenantId: view.tenantId, sessionId: view.ledgerSessionId, surface: view.pinnedOnly ? 'hook' : 'context',
-            event: 'inject', items: renderItems.length, tokens: estimateTokens(text),
-        });
-        flushDeliveryRecorder(rec, db);
+    bookLedgerTurn(view.hippoRoot, {
+        uses: [{
+                tenantId: view.tenantId, sessionId: view.ledgerSessionId, surface: view.pinnedOnly ? 'hook' : 'context',
+                event: 'inject', items: renderItems.length, tokens: estimateTokens(text),
+            }],
+        delivery: (write) => flushDeliveryRecorder(rec, write),
     });
 }
 function printCrossProjectSection(items) {
     for (const line of crossProjectLines(items))
         console.log(line);
 }
-/** @internal Exported for the render snapshot test; not a stable public API. */
-export function printContextMarkdown(items, totalTokens, framing = 'observe', opts = {}) {
-    for (const line of contextBlockLines(items, totalTokens, framing, opts))
-        console.log(line);
-}
 export async function handleContext({ hippoRoot, args, flags }) {
     // Bounded, not a TTY guard: the hot stdin path and a manual run share this one command.
     const { text: stdinText } = await readHookStdin();

package/dist/cli/continuity.d.ts

@@ -1,6 +1,7 @@
-export declare function cmdSnapshot(hippoRoot: string, args: string[], flags: Record<string, string | boolean | string[]>): void;
-export declare function cmdSession(hippoRoot: string, args: string[], flags: Record<string, string | boolean | string[]>): void;
-export declare function cmdHandoff(hippoRoot: string, args: string[], flags: Record<string, string | boolean | string[]>): void;
-export declare function cmdCurrent(hippoRoot: string, args: string[], flags: Record<string, string | boolean | string[]>): void;
-export declare function cmdWm(hippoRoot: string, args: string[], flags: Record<string, string | boolean | string[]>): void;
+import { type CommandContext } from './flag-values.js';
+export declare function handleSnapshot({ hippoRoot, tenantId, args, flags }: CommandContext): void;
+export declare function handleSession({ hippoRoot, tenantId, args, flags }: CommandContext): void;
+export declare function handleHandoff({ hippoRoot, tenantId, args, flags }: CommandContext): void;
+export declare function handleCurrent({ hippoRoot, tenantId, args, flags }: CommandContext): void;
+export declare function handleWm({ hippoRoot, args, flags }: CommandContext): void;
 //# sourceMappingURL=continuity.d.ts.map