@pellux/goodvibes-sdk 1.0.0 → 1.2.0

package/dist/platform/runtime/memory-spine/recall-snapshot.js

@@ -0,0 +1,74 @@
+/**
+ * recall-snapshot.ts — the sync-recall seam for the memory spine.
+ *
+ * THE PROBLEM. Per-turn memory recall wants to inject the recall-eligible records
+ * into the system prompt. But the prompt builder is SYNCHRONOUS
+ * (`Orchestrator.getSystemPrompt()` returns a string, not a promise), while a wire
+ * client's memory reads are ASYNCHRONOUS (a fetch to the adopted daemon). A sync
+ * function cannot await a wire read, so it cannot pull fresh memory over the wire
+ * inline.
+ *
+ * THE DESIGN (cached snapshot, freshness-stamped, honest staleness note). Rather
+ * than make the whole prompt path async (a large, cross-consumer refactor) or open
+ * the store file from a wire client (which would break the single-writer invariant),
+ * the spine maintains a CACHED recall snapshot:
+ *
+ *   1. an ASYNC pre-turn hook calls `MemorySpineClient.refreshRecallSnapshot()` —
+ *      this awaits the wire (or local) honest recall search and stamps the result
+ *      with a capture time and the access mode it came from;
+ *   2. the SYNC prompt builder calls `MemorySpineClient.recallSnapshot()` — this
+ *      returns the cached records immediately, with a freshly-computed age, a
+ *      `stale` flag, and a human-readable `note`.
+ *
+ * HONESTY. The snapshot never lies about its own freshness. If it has never been
+ * refreshed, it returns an EMPTY snapshot whose note says exactly that — never a
+ * silent empty that a reader would misread as "nothing was ever stored". If the last
+ * refresh is older than the staleness window, `stale` is true and the note says so,
+ * so an injector can choose to note the staleness in the prompt rather than present
+ * possibly-old memory as live. The `mode` records WHERE the snapshot was captured
+ * (local host store vs the adopted daemon over the wire), so the note never implies
+ * a wire read happened when it did not.
+ */
+/** Default freshness window: a snapshot older than this reports `stale: true`. */
+export const DEFAULT_RECALL_SNAPSHOT_STALE_AFTER_MS = 30_000;
+const EMPTY_SEARCH_RECORDS = Object.freeze([]);
+/** The snapshot returned before any refresh has happened — empty, and it says so. */
+export function emptyRecallSnapshot(mode) {
+    return {
+        records: EMPTY_SEARCH_RECORDS,
+        search: null,
+        capturedAt: null,
+        ageMs: null,
+        stale: true,
+        mode,
+        note: 'memory recall snapshot not yet captured — no memory injected this turn. '
+            + 'Call refreshRecallSnapshot() in an async pre-turn hook before the synchronous prompt build.',
+    };
+}
+/**
+ * Build a snapshot from an honest search envelope captured at `capturedAt`, with age
+ * and staleness computed against `now`. The `note` states the source, the age, and
+ * — when stale — that the records may be out of date.
+ */
+export function buildRecallSnapshot(search, mode, capturedAt, staleAfterMs, now = Date.now()) {
+    const ageMs = Math.max(0, now - capturedAt);
+    const stale = ageMs > staleAfterMs;
+    const source = mode === 'client' ? 'over the wire from the adopted daemon' : 'from the local store';
+    const freshness = stale
+        ? `STALE — captured ${ageMs}ms ago (older than the ${staleAfterMs}ms freshness window); a refresh is due`
+        : `captured ${ageMs}ms ago`;
+    const degraded = search.indexUnavailableReason
+        ? ` Recall degraded to a literal scan: ${search.indexUnavailableReason}.`
+        : '';
+    const caveat = search.caveat ? ` ${search.caveat}.` : '';
+    return {
+        records: search.records,
+        search,
+        capturedAt,
+        ageMs,
+        stale,
+        mode,
+        note: `memory recall snapshot ${source}, ${freshness}; ${search.records.length} record(s) recall-eligible.`
+            + degraded + caveat,
+    };
+}

package/dist/platform/runtime/operator-client.d.ts

@@ -33,7 +33,7 @@ export interface OperatorSessionsClient {
     /** Detach a surface's participant/route from a session without closing it
      * (detach != close != kill). Idempotent; see sessions.detach. */
     detach(sessionId: string, surfaceId: string): Promise<SharedSessionRecord | null>;
-    /** Permanently remove a session (W5-S1: delete != close). Requires the
+    /** Permanently remove a session (delete != close). Requires the
      * session already closed — see sessions.delete. */
     delete(sessionId: string): Promise<'deleted' | 'not-found' | 'active'>;
     bindAgent(sessionId: string, agentId: string): Promise<SharedSessionRecord | null>;

package/dist/platform/runtime/services.d.ts

@@ -81,8 +81,8 @@ export interface RuntimeServicesOptions {
     readonly panelManager?: PanelManagerLike | undefined;
     readonly keybindingsManager?: KeybindingsManagerLike | undefined;
     /**
-     * Opt-in: kick off the repo source-tree code index's initial build (Wave-5
-     * wo802, W5.3 Stage A) right after construction. Fire-and-forget — never
+     * Opt-in: kick off the repo source-tree code index's initial build
+     * (Stage A) right after construction. Fire-and-forget — never
      * awaited, never blocks. Defaults off so building RuntimeServices never runs
      * an unrequested source-tree walk. Real interactive entry points pass `true`.
      */
@@ -119,7 +119,7 @@ export interface RuntimeServices {
     readonly memoryStore: MemoryStore;
     readonly memoryRegistry: MemoryRegistry;
     /**
-     * Repo source-tree code index (Wave-5 wo802, W5.3 Stage A). Constructed and
+     * Repo source-tree code index (Stage A). Constructed and
      * schema-initialized eagerly like memoryStore, but the actual walk/chunk/
      * embed build is NOT auto-triggered here — call `.scheduleBuild()` from an
      * explicit call site (a `/codebase reindex` command, a session-start hook,
@@ -130,7 +130,7 @@ export interface RuntimeServices {
      * surprising for embedders that never asked for it.
      */
     readonly codeIndexStore: CodeIndexStore;
-    /** Wave-5 Stage B tool-site incremental reindex scheduler (bound to codeIndexStore). */
+    /** Stage B tool-site incremental reindex scheduler (bound to codeIndexStore). */
     readonly codeIndexReindexScheduler: CodeIndexReindexScheduler;
     readonly serviceRegistry: ServiceRegistry;
     readonly secretsManager: SecretsManager;
@@ -185,7 +185,7 @@ export interface RuntimeServices {
     readonly agentOrchestrator: AgentOrchestrator;
     readonly wrfcController: WrfcController;
     /**
-     * Orchestration engine (Wave 4, wo701) — ships ALONGSIDE wrfcController,
+     * Orchestration engine — ships ALONGSIDE wrfcController,
      * stage 1 of the 3-stage migration (see platform/orchestration/
      * controller-compat.ts). WrfcController is unchanged; this is a new,
      * opt-in surface for callers that want the pipeline/capacity-matching
@@ -196,7 +196,7 @@ export interface RuntimeServices {
     readonly orchestrationEngine: OrchestrationEngine;
     readonly processManager: ProcessManager;
     /**
-     * Live process registry (W2.1): queryable + subscribable fleet aggregation
+     * Live process registry: queryable + subscribable fleet aggregation
      * over agentManager/wrfcController/processManager/watcherRegistry/workflow.
      * LIFECYCLE NOTE: RuntimeServices has no shutdown/dispose seam today, so
      * nothing calls processRegistry.dispose() here — the registry's coalesced

package/dist/platform/runtime/services.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../../src/platform/runtime/services.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,iBAAiB,EAAwB,MAAM,wBAAwB,CAAC;AAC5G,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACzH,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,mBAAmB,EAA8B,MAAM,2BAA2B,CAAC;AAElI,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EACL,gBAAgB,EAEhB,gBAAgB,EAGhB,sBAAsB,EAIvB,MAAM,uBAAuB,CAAC;AAM/B,OAAO,EAAE,qBAAqB,EAA+B,MAAM,mBAAmB,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AACpF,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAA+B,MAAM,mBAAmB,CAAC;AACrG,OAAO,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACrF,OAAO,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAuB,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC5F,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAG9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAErE,OAAO,EAGL,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAA6B,KAAK,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhG,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IACvE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,kBAAkB,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAC;IACjE;;;;;OAKG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClD,2EAA2E;IAC3E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChD;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,cAAc,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC;IACxC,QAAQ,CAAC,kBAAkB,EAAE,sBAAsB,CAAC;IACpD,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAC;IAC5C,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,cAAc,EAAE,qBAAqB,CAAC;IAC/C,QAAQ,CAAC,qBAAqB,EAAE,qBAAqB,CAAC;IACtD,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAC;IAC5C,QAAQ,CAAC,eAAe,EAAE,yBAAyB,CAAC;IACpD,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAC9C,QAAQ,CAAC,cAAc,EAAE,oBAAoB,CAAC;IAC9C,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,qBAAqB,EAAE,gBAAgB,CAAC;IACjD,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,sBAAsB,EAAE,sBAAsB,CAAC;IACxD,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,wFAAwF;IACxF,QAAQ,CAAC,yBAAyB,EAAE,yBAAyB,CAAC;IAC9D,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;IAClD,QAAQ,CAAC,oBAAoB,EAAE,eAAe,CAAC;IAC/C,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,oBAAoB,EAAE,wBAAwB,CAAC;IACxD,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;IAClD,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,qBAAqB,CAAC;IAC/C,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,kBAAkB,EAAE,yBAAyB,CAAC;IACvD,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,cAAc,EAAE,qBAAqB,CAAC;IAC/C,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAC9C,QAAQ,CAAC,uBAAuB,EAAE,+BAA+B,CAAC;IAClE,QAAQ,CAAC,aAAa,EAAE,oBAAoB,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IACvC,QAAQ,CAAC,sBAAsB,EAAE,sBAAsB,CAAC;IACxD,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,sBAAsB,EAAE,sBAAsB,CAAC;IACxD,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,yBAAyB,CAAC;IACjD,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAC9C,QAAQ,CAAC,0BAA0B,EAAE,0BAA0B,CAAC;IAChE,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IAChD,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,kBAAkB,EAAE,yBAAyB,CAAC;IACvD,QAAQ,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;IACpD,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IAChD,QAAQ,CAAC,qBAAqB,EAAE,qBAAqB,CAAC;IACtD,QAAQ,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;IACpD,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAC;IAC3C,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IAChD,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAC9C,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC;;;;;;;;OAQG;IACH,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;IAClD,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC;;;;;;;;;OASG;IACH,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,0BAA0B,EAAE,0BAA0B,CAAC;IAChE,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,CAAC;IACtD;;;;;;;;;;;;;;;;;OAiBG;IACH,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD;AAED,wBAAgB,gCAAgC,CAC9C,YAAY,EAAE,IAAI,CAAC,kBAAkB,EAAE,WAAW,GAAG,WAAW,CAAC,EACjE,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,EAAE,YAAY,CAAC,GACvD,MAAM,IAAI,CAOZ;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAkkBtF"}
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../../src/platform/runtime/services.ts"],"names":[],"mappings":"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"}

package/dist/platform/runtime/services.js

@@ -8,7 +8,7 @@ import { SubscriptionManager } from '../config/subscriptions.js';
 import { AutomationDeliveryManager, AutomationManager, AutomationRouteStore } from '../automation/index.js';
 import { ChannelPluginRegistry, ChannelPolicyManager, RouteBindingManager, SurfaceRegistry } from '../channels/index.js';
 import { ChannelDeliveryRouter } from '../channels/delivery-router.js';
-import { ApprovalBroker, GatewayMethodCatalog, SharedSessionBroker, registerW3S2GatewayMethods } from '../control-plane/index.js';
+import { ApprovalBroker, GatewayMethodCatalog, SharedSessionBroker, registerGatewayVerbGroups } from '../control-plane/index.js';
 import { buildSharedSessionAgentSpawnRoutingInput } from '../control-plane/session-intents.js';
 import { WatcherRegistry } from '../watchers/index.js';
 import { ArtifactStore } from '../artifacts/index.js';
@@ -176,7 +176,7 @@ export function createRuntimeServices(options) {
         executor: agentOrchestrator,
         configManager,
     });
-    // Wave-3 Part C6 bridge: AgentOrchestrator is constructed before
+    // Conversation-snapshot sink bridge: AgentOrchestrator is constructed before
     // AgentManager exists, so the conversation-snapshot sink is wired here via
     // setConversationSink rather than as a constructor dependency (same
     // ordering constraint as setRuntimeBus above).
@@ -184,7 +184,7 @@ export function createRuntimeServices(options) {
         register: (agentId, source) => agentManager.registerConversationSource(agentId, source),
         release: (agentId) => agentManager.releaseConversationSource(agentId),
     });
-    // Wave-4 cooperative cancellation bridge (wo701): same ordering constraint
+    // Cooperative cancellation bridge: same ordering constraint
     // and setter pattern as setConversationSink above — AgentOrchestrator is
     // constructed before AgentManager exists.
     agentOrchestrator.setCancellationSource({
@@ -230,7 +230,7 @@ export function createRuntimeServices(options) {
         embeddingRegistry: memoryEmbeddingRegistry,
     });
     const memoryRegistry = new MemoryRegistry(memoryStore);
-    // Repo source-tree code index (Wave-5 wo802, W5.3 Stage A) — shares
+    // Repo source-tree code index (Stage A) — shares
     // memoryEmbeddingRegistry so code + memory embeddings use one provider and
     // one dimensionality. Schema init only; build is not auto-triggered here
     // (see the RuntimeServices.codeIndexStore doc comment).
@@ -240,7 +240,7 @@ export function createRuntimeServices(options) {
     if (options.autoStartCodeIndex) {
         codeIndexStore.scheduleBuild();
     }
-    // Wave-5 Stage B: tool-site incremental reindex. Gated on the SDK's autoStartCodeIndex opt-in
+    // Stage B: tool-site incremental reindex. Gated on the SDK's autoStartCodeIndex opt-in
     // (this library's storage.codeIndexEnabled analog) AND the built-state check inside the
     // scheduler — an unbuilt index is a no-op either way.
     const codeInjectionSettingEnabled = () => options.autoStartCodeIndex === true;
@@ -491,7 +491,7 @@ export function createRuntimeServices(options) {
         const pricing = providerRegistry.getCostFromCatalog(model);
         return (usage.inputTokens * pricing.input + usage.outputTokens * pricing.output) / 1_000_000;
     };
-    // Orchestration engine (Wave 4, wo701) — ships alongside wrfcController, untouched by this change. See the RuntimeServices interface comment.
+    // Orchestration engine — ships alongside wrfcController, untouched by this change. See the RuntimeServices interface comment.
     const orchestrationEngine = createOrchestrationEngine({
         agentManager,
         configManager,
@@ -499,7 +499,7 @@ export function createRuntimeServices(options) {
         projectRoot: workingDirectory,
         priceUsage,
     });
-    // Live process registry (W2.1) — narrow structural deps only, constructed
+    // Live process registry — narrow structural deps only, constructed
     // after every source manager exists. See the RuntimeServices interface
     // comment for the dispose story (no RuntimeServices-wide shutdown seam yet).
     const processRegistry = createProcessRegistry({
@@ -519,7 +519,7 @@ export function createRuntimeServices(options) {
         priceUsage,
         codeIndexService: codeIndexStore,
     });
-    registerW3S2GatewayMethods(gatewayMethods, { processRegistry, workspaceCheckpointManager, sessionBroker }); // W3-S2 (routes/register-w3-s2.ts)
+    registerGatewayVerbGroups(gatewayMethods, { processRegistry, workspaceCheckpointManager, sessionBroker, secretsManager, approvalBroker, shellPaths }); // see routes/register-gateway-verb-groups.ts
     return {
         workingDirectory,
         homeDirectory,
@@ -614,7 +614,7 @@ export function createRuntimeServices(options) {
             const newMemoryDbPath = join(newWorkingDir, '.goodvibes', surfaceRoot, 'memory.sqlite');
             await memoryStore.reroot(newMemoryDbPath);
             // Step 1b: Re-root the code index alongside memory — otherwise it keeps
-            // pointing at the old tree after a workspace swap (Wave-5 wo802 risk #7).
+            // pointing at the old tree after a workspace swap.
             const newCodeIndexDbPath = join(newWorkingDir, '.goodvibes', surfaceRoot, 'code-index.sqlite');
             await codeIndexStore.reroot(newWorkingDir, newCodeIndexDbPath);
             // Step 2: Re-root ProjectIndex — flush current path, reset, load from new directory.

package/dist/platform/runtime/session-spine/union-cache.d.ts

@@ -31,7 +31,7 @@
  * from the render/keystroke hot path — reads are served from the cache
  * synchronously, so the facade adds zero awaits to any interactive path.
  *
- * MOVE NOTE (One-Platform Wave 3, S4): this generalizes cleanly (SDK-clean deps,
+ * MOVE NOTE (One-Platform): this generalizes cleanly (SDK-clean deps,
  * already parameterized via injected local + wireReader, generation-guarded probes)
  * and serves the union goal, so it now lives in the SDK alongside the spine client.
  * That "generalizes cleanly" is ARCHITECTURAL until a second real consumer imports

package/dist/platform/runtime/session-spine/union-cache.js

@@ -31,7 +31,7 @@
  * from the render/keystroke hot path — reads are served from the cache
  * synchronously, so the facade adds zero awaits to any interactive path.
  *
- * MOVE NOTE (One-Platform Wave 3, S4): this generalizes cleanly (SDK-clean deps,
+ * MOVE NOTE (One-Platform): this generalizes cleanly (SDK-clean deps,
  * already parameterized via injected local + wireReader, generation-guarded probes)
  * and serves the union goal, so it now lives in the SDK alongside the spine client.
  * That "generalizes cleanly" is ARCHITECTURAL until a second real consumer imports

package/dist/platform/state/canonical-memory.d.ts

@@ -1,28 +1,28 @@
 /**
- * canonical-memory.ts — the ONE cross-surface memory identity (Wave-6 E6).
+ * canonical-memory.ts — the ONE cross-surface memory identity (see CHANGELOG 1.0.0).
  *
- * BACKGROUND (the E6 silo). The MemoryStore engine (memory-store.ts) is a good
+ * BACKGROUND. The MemoryStore engine (memory-store.ts) is a good
  * single engine, but it is instantiated as disjoint SQLite files per surface:
  *   - the SDK daemon runtime  → <workingDir>/.goodvibes/<surface>/memory.sqlite
  *   - the agent               → <userRoot>/goodvibes-agent/memory.sqlite (global)
  *   - the TUI                 → <workingDir>/.goodvibes/tui/memory.sqlite
- * A fact learned in one surface is invisible to the others. E6 collapses those to
+ * A fact learned in one surface is invisible to the others. This module collapses those to
  * ONE canonical store identity.
  *
- * CANONICAL PLACEMENT (ruled in the Wave-6 decision record). The SQLiteStore is
+ * CANONICAL PLACEMENT (ruled in the memory-unification decision record). The SQLiteStore is
  * backed by sql.js: every open loads the whole database into memory and every
  * save() rewrites the entire file via writeFileSync. There is no row locking and
  * no WAL, so two live processes writing the SAME file would clobber each other on
  * save — a whole-file lost-update that would DELETE memory, the exact honesty
- * violation E6 must not introduce. Therefore:
+ * violation this module must not introduce. Therefore:
  *
  *   TARGET  (end-state): the daemon owns the single canonical store and surfaces
  *           read/write add/search/searchSemantic THROUGH it (one process = one
- *           writer). Deferred out of Wave-6 because it adds new wire methods that
+ *           writer). Deferred out of this step because it adds new wire methods that
  *           serialize the land and gate the release train, and cannot be proven
  *           under the no-real-daemons test rule.
  *
- *   Wave-6 STEP (what this module delivers): one canonical PATH resolver so every
+ *   THIS STEP (what this module delivers): one canonical PATH resolver so every
  *           surface names the same store identity, plus a no-loss FOLD/RECONCILE
  *           primitive built on the existing exportBundle/importBundle seam
  *           (memory-sync.ts prior art). Access is sequential/owned, never a naive

package/dist/platform/state/canonical-memory.js

@@ -1,28 +1,28 @@
 /**
- * canonical-memory.ts — the ONE cross-surface memory identity (Wave-6 E6).
+ * canonical-memory.ts — the ONE cross-surface memory identity (see CHANGELOG 1.0.0).
  *
- * BACKGROUND (the E6 silo). The MemoryStore engine (memory-store.ts) is a good
+ * BACKGROUND. The MemoryStore engine (memory-store.ts) is a good
  * single engine, but it is instantiated as disjoint SQLite files per surface:
  *   - the SDK daemon runtime  → <workingDir>/.goodvibes/<surface>/memory.sqlite
  *   - the agent               → <userRoot>/goodvibes-agent/memory.sqlite (global)
  *   - the TUI                 → <workingDir>/.goodvibes/tui/memory.sqlite
- * A fact learned in one surface is invisible to the others. E6 collapses those to
+ * A fact learned in one surface is invisible to the others. This module collapses those to
  * ONE canonical store identity.
  *
- * CANONICAL PLACEMENT (ruled in the Wave-6 decision record). The SQLiteStore is
+ * CANONICAL PLACEMENT (ruled in the memory-unification decision record). The SQLiteStore is
  * backed by sql.js: every open loads the whole database into memory and every
  * save() rewrites the entire file via writeFileSync. There is no row locking and
  * no WAL, so two live processes writing the SAME file would clobber each other on
  * save — a whole-file lost-update that would DELETE memory, the exact honesty
- * violation E6 must not introduce. Therefore:
+ * violation this module must not introduce. Therefore:
  *
  *   TARGET  (end-state): the daemon owns the single canonical store and surfaces
  *           read/write add/search/searchSemantic THROUGH it (one process = one
- *           writer). Deferred out of Wave-6 because it adds new wire methods that
+ *           writer). Deferred out of this step because it adds new wire methods that
  *           serialize the land and gate the release train, and cannot be proven
  *           under the no-real-daemons test rule.
  *
- *   Wave-6 STEP (what this module delivers): one canonical PATH resolver so every
+ *   THIS STEP (what this module delivers): one canonical PATH resolver so every
  *           surface names the same store identity, plus a no-loss FOLD/RECONCILE
  *           primitive built on the existing exportBundle/importBundle seam
  *           (memory-sync.ts prior art). Access is sequential/owned, never a naive
@@ -136,7 +136,7 @@ export async function foldMemoryStores(canonical, sources, options) {
 /** Render a human-readable summary of a fold report (for surfacing at boot). */
 export function formatMemoryFoldReport(report) {
     const lines = [
-        'Memory unification (E6) — fold into canonical store',
+        'Memory unification — fold into canonical store',
         `  canonical ${report.canonicalPath}`,
         `  imported ${report.totalImported}  already-present ${report.totalSkipped}  links ${report.totalLinks}`,
     ];

package/dist/platform/state/code-index-chunking.js

@@ -1,7 +1,7 @@
 /** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
 /**
  * Code-index chunking — pure content → chunk transformation for CodeIndexStore
- * (Wave-5, W5.3 Stage A; extracted from code-index-store.ts to keep that file
+ * (Stage A, see CHANGELOG 0.38.0; extracted from code-index-store.ts to keep that file
  * within the 800-line source discipline).
  *
  * Everything here is side-effect-free with respect to the store: given file

package/dist/platform/state/code-index-db.d.ts

@@ -1,7 +1,7 @@
 /** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
 /**
  * Code-index SQL layer — schema plus every direct table operation for
- * CodeIndexStore's bun:sqlite database (Wave-5, W5.3 Stage A; extracted from
+ * CodeIndexStore's bun:sqlite database (Stage A, see CHANGELOG 0.38.0; extracted from
  * code-index-store.ts to keep that file within the 800-line source discipline).
  *
  * Three tables:

package/dist/platform/state/code-index-store.js

@@ -1,7 +1,7 @@
 /** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
 /**
  * CodeIndexStore — an incremental, tree-sitter-chunked, embedding-backed index
- * of a repo's source tree (Wave-5, W5.3, Stage A).
+ * of a repo's source tree (Stage A; see CHANGELOG 0.38.0).
  *
  * Deliberately MIRRORS MemoryStore + SqliteVecMemoryIndex (state/memory-store.ts,
  * state/memory-vector-store.ts) rather than reusing them: those classes are

package/dist/platform/state/index.d.ts

@@ -21,8 +21,8 @@ export type { MemoryBundle, MemoryClass, MemoryRecord, MemoryLink, MemoryAddOpti
 export { buildIncidentMemoryAddOptions, buildMcpSecurityMemoryAddOptions, buildPluginSecurityMemoryAddOptions, buildPolicyPreflightMemoryAddOptions, } from './memory-ingest.js';
 export { resolveCanonicalMemoryDbPath, foldMemoryStores, formatMemoryFoldReport, } from './canonical-memory.js';
 export type { LegacyMemorySource, MemoryFoldSourceReport, MemoryFoldReport, FoldMemoryStoresOptions, } from './canonical-memory.js';
-export { MIN_PROMPT_MEMORY_CONFIDENCE, describeMemoryPromptEligibility, isPromptActiveMemory, describeMemoryIndexUnavailable, describeMemoryIndexCaveat, } from './memory-recall-contract.js';
-export type { MemoryPromptEligibility } from './memory-recall-contract.js';
+export { MIN_PROMPT_MEMORY_CONFIDENCE, describeMemoryPromptEligibility, isPromptActiveMemory, describeMemoryIndexUnavailable, describeMemoryIndexCaveat, runHonestMemorySearch, } from './memory-recall-contract.js';
+export type { MemoryPromptEligibility, HonestSearchStore, HonestMemorySearchOptions, HonestMemorySearchResult, } from './memory-recall-contract.js';
 export { VIBE_PERSONA_TAG, VIBE_PROJECTION_HEADING, VIBE_PROJECTION_CAVEAT, selectVibeRecords, renderVibeProjection, vibeBodyToConstraintOptions, } from './vibe-projection.js';
 export type { VibeProjectionOptions, VibeImportOptions } from './vibe-projection.js';
 export { MEMORY_VECTOR_DIMS, embedMemoryText, resolveMemoryVectorDbPath, SqliteVecMemoryIndex, } from './memory-vector-store.js';

package/dist/platform/state/index.d.ts.map

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

package/dist/platform/state/index.js

@@ -13,7 +13,7 @@ export { MemoryStore } from './memory-store.js';
 export { MemoryRegistry } from './memory-registry.js';
 export { buildIncidentMemoryAddOptions, buildMcpSecurityMemoryAddOptions, buildPluginSecurityMemoryAddOptions, buildPolicyPreflightMemoryAddOptions, } from './memory-ingest.js';
 export { resolveCanonicalMemoryDbPath, foldMemoryStores, formatMemoryFoldReport, } from './canonical-memory.js';
-export { MIN_PROMPT_MEMORY_CONFIDENCE, describeMemoryPromptEligibility, isPromptActiveMemory, describeMemoryIndexUnavailable, describeMemoryIndexCaveat, } from './memory-recall-contract.js';
+export { MIN_PROMPT_MEMORY_CONFIDENCE, describeMemoryPromptEligibility, isPromptActiveMemory, describeMemoryIndexUnavailable, describeMemoryIndexCaveat, runHonestMemorySearch, } from './memory-recall-contract.js';
 export { VIBE_PERSONA_TAG, VIBE_PROJECTION_HEADING, VIBE_PROJECTION_CAVEAT, selectVibeRecords, renderVibeProjection, vibeBodyToConstraintOptions, } from './vibe-projection.js';
 export { MEMORY_VECTOR_DIMS, embedMemoryText, resolveMemoryVectorDbPath, SqliteVecMemoryIndex, } from './memory-vector-store.js';
 export { DEFAULT_MEMORY_EMBEDDING_DIMS, HASHED_MEMORY_EMBEDDING_PROVIDER, MemoryEmbeddingProviderRegistry, normalizeMemoryEmbeddingVector, } from './memory-embeddings.js';

package/dist/platform/state/memory-recall-contract.d.ts

@@ -1,10 +1,10 @@
 /**
- * memory-recall-contract.ts — the CROSS-SURFACE recall-honesty contract (Wave-6 E6).
+ * memory-recall-contract.ts — the CROSS-SURFACE recall-honesty contract (see CHANGELOG 1.0.0).
  *
- * PROVENANCE. This is the agent's Wave-4 W4-A1 memory-honesty discipline, promoted
+ * PROVENANCE. This is the agent's memory-honesty discipline, promoted
  * verbatim from a single surface (the agent's memory-prompt.ts) into the SDK so it
  * is ONE shared contract, not a discipline re-derived (and re-weakened) per surface.
- * Under E6 the store is unified and cross-surface, which multiplies the cost of a
+ * Under memory unification the store is unified and cross-surface, which multiplies the cost of a
  * dishonest recall — so this discipline becomes MORE load-bearing, not less. A
  * unified store must not be able to lie more loudly than the siloed one did.
  *
@@ -23,7 +23,7 @@
  *      reads as "nothing was ever stored." 'no match' and 'index unavailable' are
  *      distinct and both said out loud.
  */
-import type { MemoryRecord } from './memory-store.js';
+import type { MemoryRecord, MemorySearchFilter, MemorySemanticSearchResult } from './memory-store.js';
 import type { MemoryVectorStats } from './memory-vector-store.js';
 /**
  * Recall-prompt confidence floor. Tied to the store's own baseline: MemoryStore.add
@@ -60,4 +60,59 @@ export declare function describeMemoryIndexUnavailable(stats: MemoryVectorStats)
  * presenting it as equivalent. Returns null when a real provider is configured.
  */
 export declare function describeMemoryIndexCaveat(stats: MemoryVectorStats): string | null;
+/**
+ * The minimal read surface a honest search needs. MemoryStore (and MemoryRegistry)
+ * satisfy this structurally — the function stays decoupled from either concrete
+ * class so it can run over any store that exposes the three read paths.
+ */
+export interface HonestSearchStore {
+    search(filter: MemorySearchFilter): MemoryRecord[];
+    searchSemantic(filter: MemorySearchFilter): MemorySemanticSearchResult[];
+    vectorStats(): MemoryVectorStats;
+}
+export interface HonestMemorySearchOptions {
+    /**
+     * Apply the recall-INJECTION contract to the result set: exclude flagged
+     * (stale/contradicted) records outright and drop records below the confidence
+     * floor, counting each exclusion honestly. Off by default — a review/browse
+     * caller wants to SEE flagged and low-confidence records; only a prompt-recall
+     * caller filters them out.
+     */
+    readonly recall?: boolean | undefined;
+}
+/**
+ * The honest search envelope. `records` is what a caller should use; the rest is
+ * the receipt: which path actually ran, and — when a degraded path was taken —
+ * WHY, out loud. A wire client and a local surface serialize the SAME envelope, so
+ * the honesty contract cannot be re-weakened per surface.
+ */
+export interface HonestMemorySearchResult {
+    readonly records: readonly MemoryRecord[];
+    /** The path that actually ran. `'literal'` even when semantic was requested but the index could not be consulted. */
+    readonly mode: 'literal' | 'semantic';
+    readonly requestedSemantic: boolean;
+    /** Non-null ONLY when semantic was requested and the index could not be consulted, forcing the literal fallback. The stated reason — never a silent empty. */
+    readonly indexUnavailableReason: string | null;
+    /** Soft caveat when the semantic path ran on the hashed-only fallback provider. */
+    readonly caveat: string | null;
+    /** Whether the recall-injection contract filtered the set (options.recall). */
+    readonly recallFiltered: boolean;
+    readonly excludedFlaggedCount: number;
+    readonly excludedBelowFloorCount: number;
+    /** Result count BEFORE any recall-injection filtering — so a caller can tell "index empty" from "everything filtered out". */
+    readonly totalBeforeRecallFilter: number;
+}
+/**
+ * Run a search that HONORS the recall-honesty contract end to end:
+ *  - semantic requested + index consultable → semantic ranking (+ soft caveat when
+ *    on the hashed fallback provider);
+ *  - semantic requested + index NOT consultable → literal scan WITH the stated
+ *    `indexUnavailableReason`, never a silent empty that reads as "nothing stored";
+ *  - `recall: true` → flagged records excluded outright and sub-floor records
+ *    dropped, each exclusion counted rather than silently vanished.
+ *
+ * This is the ONE composition every surface (daemon route, wire client, offline
+ * local store) calls, so the contract is applied identically everywhere.
+ */
+export declare function runHonestMemorySearch(store: HonestSearchStore, filter?: MemorySearchFilter, options?: HonestMemorySearchOptions): HonestMemorySearchResult;
 //# sourceMappingURL=memory-recall-contract.d.ts.map

package/dist/platform/state/memory-recall-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-recall-contract.d.ts","sourceRoot":"","sources":["../../../src/platform/state/memory-recall-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGlE;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,sHAAsH;IACtH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAOD;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,YAAY,GAAG,uBAAuB,CAkB7F;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAElE;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAKtF;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAKjF"}
+{"version":3,"file":"memory-recall-contract.d.ts","sourceRoot":"","sources":["../../../src/platform/state/memory-recall-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AACtG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGlE;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,sHAAsH;IACtH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAOD;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,YAAY,GAAG,uBAAuB,CAkB7F;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAElE;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAKtF;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAKjF;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,EAAE,CAAC;IACnD,cAAc,CAAC,MAAM,EAAE,kBAAkB,GAAG,0BAA0B,EAAE,CAAC;IACzE,WAAW,IAAI,iBAAiB,CAAC;CAClC;AAED,MAAM,WAAW,yBAAyB;IACxC;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACvC;AAED;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,qHAAqH;IACrH,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU,CAAC;IACtC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,8JAA8J;IAC9J,QAAQ,CAAC,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C,mFAAmF;IACnF,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,+EAA+E;IAC/E,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,8HAA8H;IAC9H,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;CAC1C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,iBAAiB,EACxB,MAAM,GAAE,kBAAuB,EAC/B,OAAO,GAAE,yBAA8B,GACtC,wBAAwB,CA+D1B"}

package/dist/platform/state/memory-recall-contract.js

@@ -1,10 +1,10 @@
 /**
- * memory-recall-contract.ts — the CROSS-SURFACE recall-honesty contract (Wave-6 E6).
+ * memory-recall-contract.ts — the CROSS-SURFACE recall-honesty contract (see CHANGELOG 1.0.0).
  *
- * PROVENANCE. This is the agent's Wave-4 W4-A1 memory-honesty discipline, promoted
+ * PROVENANCE. This is the agent's memory-honesty discipline, promoted
  * verbatim from a single surface (the agent's memory-prompt.ts) into the SDK so it
  * is ONE shared contract, not a discipline re-derived (and re-weakened) per surface.
- * Under E6 the store is unified and cross-surface, which multiplies the cost of a
+ * Under memory unification the store is unified and cross-surface, which multiplies the cost of a
  * dishonest recall — so this discipline becomes MORE load-bearing, not less. A
  * unified store must not be able to lie more loudly than the siloed one did.
  *
@@ -92,3 +92,79 @@ export function describeMemoryIndexCaveat(stats) {
     }
     return null;
 }
+/**
+ * Run a search that HONORS the recall-honesty contract end to end:
+ *  - semantic requested + index consultable → semantic ranking (+ soft caveat when
+ *    on the hashed fallback provider);
+ *  - semantic requested + index NOT consultable → literal scan WITH the stated
+ *    `indexUnavailableReason`, never a silent empty that reads as "nothing stored";
+ *  - `recall: true` → flagged records excluded outright and sub-floor records
+ *    dropped, each exclusion counted rather than silently vanished.
+ *
+ * This is the ONE composition every surface (daemon route, wire client, offline
+ * local store) calls, so the contract is applied identically everywhere.
+ */
+export function runHonestMemorySearch(store, filter = {}, options = {}) {
+    const requestedSemantic = filter.semantic === true;
+    let mode = 'literal';
+    let indexUnavailableReason = null;
+    let caveat = null;
+    let baseRecords;
+    if (requestedSemantic) {
+        const stats = store.vectorStats();
+        indexUnavailableReason = describeMemoryIndexUnavailable(stats);
+        if (indexUnavailableReason !== null) {
+            // Honest degrade: the index cannot be consulted, so fall back to a literal
+            // scan and SAY SO via indexUnavailableReason.
+            baseRecords = store.search({ ...filter, semantic: false });
+        }
+        else {
+            mode = 'semantic';
+            caveat = describeMemoryIndexCaveat(stats);
+            baseRecords = store.searchSemantic(filter).map((entry) => entry.record);
+        }
+    }
+    else {
+        baseRecords = store.search(filter);
+    }
+    const totalBeforeRecallFilter = baseRecords.length;
+    if (!options.recall) {
+        return {
+            records: baseRecords,
+            mode,
+            requestedSemantic,
+            indexUnavailableReason,
+            caveat,
+            recallFiltered: false,
+            excludedFlaggedCount: 0,
+            excludedBelowFloorCount: 0,
+            totalBeforeRecallFilter,
+        };
+    }
+    const kept = [];
+    let excludedFlaggedCount = 0;
+    let excludedBelowFloorCount = 0;
+    for (const record of baseRecords) {
+        if (isPromptActiveMemory(record)) {
+            kept.push(record);
+            continue;
+        }
+        if (record.reviewState === 'stale' || record.reviewState === 'contradicted') {
+            excludedFlaggedCount += 1;
+        }
+        else {
+            excludedBelowFloorCount += 1;
+        }
+    }
+    return {
+        records: kept,
+        mode,
+        requestedSemantic,
+        indexUnavailableReason,
+        caveat,
+        recallFiltered: true,
+        excludedFlaggedCount,
+        excludedBelowFloorCount,
+        totalBeforeRecallFilter,
+    };
+}