@theokit/sdk 4.16.7 → 4.17.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 4.17.1
+
+### Patch Changes
+
+- fix(session): hydration REPLACES the cache from disk (source of truth) instead of skipping when non-empty — after an invalidation (compact/inject), an in-flight turn repopulating the cache with one message used to pin the parent to a 1-message context until restart (M51 review F4; race test added).
+
+## 4.17.0
+
+### Minor Changes
+
+- feat(session): `Agent.injectSessionTurn(agentId, {userText, assistantText})` — append a SYNTHETIC user+assistant pair to a local session's persisted transcript WITHOUT running an LLM turn (the Codex review-exit mechanism: the parent conversation "learns" a result for follow-ups). Chains onto the DAG leaf, invalidates the in-memory cache, serialized on the per-agent write chain (M51 agent-builder).
+
 ## 4.16.7
 
 ### Patch Changes

package/dist/agent.d.ts

@@ -187,6 +187,18 @@ export declare class Agent {
         trigger?: "manual" | "auto";
         summarize?: (messages: readonly import("./compaction.js").CompressibleMessage[]) => Promise<string>;
     }): Promise<import("./internal/session/compact-session.js").CompactResult>;
+    /**
+     * M51 — inject a SYNTHETIC user+assistant pair into a LOCAL session's persisted transcript WITHOUT
+     * running an LLM turn (the Codex review-exit mechanism: the parent thread "learns" a result — e.g.
+     * review findings — so follow-ups work). Appends onto the DAG leaf and invalidates the in-memory
+     * cache; serialized on the per-agent write chain.
+     *
+     * @public
+     */
+    static injectSessionTurn(agentId: string, turn: {
+        userText: string;
+        assistantText: string;
+    }): Promise<void>;
     /**
      * Permanently delete a cloud agent.
      *

package/dist/cron.cjs

@@ -5948,9 +5948,7 @@ async function hydrateSession(agentId, loc) {
   hydratedKeys.add(key);
   const persisted = await readSessionMessages(loc.store, agentId);
   if (persisted.length === 0) return;
-  if (!sessions.has(agentId) || sessions.get(agentId)?.length === 0) {
-    sessions.set(agentId, persisted);
-  }
+  sessions.set(agentId, persisted);
 }
 async function flushSessionWrites() {
   while (pendingWrites.size > 0) {
@@ -7597,6 +7595,32 @@ var init_batch = __esm({
   }
 });
 
+// src/internal/session/inject-session.ts
+var inject_session_exports = {};
+__export(inject_session_exports, {
+  injectSessionTurn: () => injectSessionTurn
+});
+async function injectSessionTurn(opts) {
+  await enqueueSessionWrite(opts.loc.cwd, opts.loc.agentId, async () => {
+    const prior = await opts.store.readRecords(opts.loc.agentId);
+    const transcript = SessionTranscript.fromRecords(prior, {
+      cwd: opts.loc.cwd,
+      sessionId: opts.sessionId,
+      model: opts.loc.model ?? "unknown"
+    });
+    transcript.appendUserTurn(opts.userText);
+    transcript.appendAssistantTurn({ text: opts.assistantText });
+    await opts.store.appendRecords(opts.loc.agentId, transcript.records().slice(prior.length));
+    invalidateSessionCache(opts.loc.cwd, opts.loc.agentId);
+  });
+}
+var init_inject_session = __esm({
+  "src/internal/session/inject-session.ts"() {
+    init_session_transcript();
+    init_agent_session();
+  }
+});
+
 // src/agent-builder.ts
 var AgentBuilder = class {
   opts = {};
@@ -19904,6 +19928,39 @@ var Agent = class _Agent {
       })
     }));
   }
+  /**
+   * M51 — inject a SYNTHETIC user+assistant pair into a LOCAL session's persisted transcript WITHOUT
+   * running an LLM turn (the Codex review-exit mechanism: the parent thread "learns" a result — e.g.
+   * review findings — so follow-ups work). Appends onto the DAG leaf and invalidates the in-memory
+   * cache; serialized on the per-agent write chain.
+   *
+   * @public
+   */
+  static async injectSessionTurn(agentId, turn) {
+    let reg = getRegisteredAgent(agentId);
+    if (reg === void 0) {
+      await hydrateRegistryFromDisk(process.cwd());
+      reg = getRegisteredAgent(agentId);
+    }
+    if (reg === void 0 || reg.runtime !== "local") {
+      throw new UnknownAgentError(`No local agent "${agentId}" registered \u2014 injectSessionTurn targets local sessions.`);
+    }
+    const cwd = reg.cwd ?? process.cwd();
+    const optModel = reg.options.model;
+    const model = reg.model?.id ?? (typeof optModel === "string" ? optModel : optModel?.id) ?? "unknown";
+    const { injectSessionTurn: injectSessionTurn2 } = await Promise.resolve().then(() => (init_inject_session(), inject_session_exports));
+    const { FsSessionStore: FsSessionStore2 } = await Promise.resolve().then(() => (init_fs_session_store(), fs_session_store_exports));
+    const { defaultBaseDir: defaultBaseDir2, expandTilde: expandTilde2 } = await Promise.resolve().then(() => (init_session_transcript(), session_transcript_exports));
+    const baseDir = reg.options.local?.baseDir !== void 0 ? expandTilde2(reg.options.local.baseDir) : defaultBaseDir2();
+    const store = new FsSessionStore2({ baseDir, cwd });
+    await injectSessionTurn2({
+      store,
+      loc: { cwd, agentId, model },
+      sessionId: agentId,
+      userText: turn.userText,
+      assistantText: turn.assistantText
+    });
+  }
   /**
    * Permanently delete a cloud agent.
    *