@theokit/sdk 4.16.7 → 4.17.1

package/dist/index.d.cts

@@ -650,6 +650,18 @@ declare class Agent {
         trigger?: "manual" | "auto";
         summarize?: (messages: readonly CompressibleMessage[]) => Promise<string>;
     }): Promise<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/index.d.ts

@@ -650,6 +650,18 @@ declare class Agent {
         trigger?: "manual" | "auto";
         summarize?: (messages: readonly CompressibleMessage[]) => Promise<string>;
     }): Promise<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/index.js

@@ -6118,9 +6118,7 @@ async function hydrateSession(agentId, loc) {
   hydratedKeys.add(key2);
   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) {
@@ -9028,6 +9026,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/types/workflow.ts
 var WorkflowDuplicateStepIdError, WorkflowInputError, WorkflowOutputError, WorkflowStateError, WorkflowAlreadyRunningError, WorkflowSnapshotNotFoundError, WorkflowMaxIterationsExceededError, WorkflowNotSerializableError, WorkflowResumeStepNotFoundError, WorkflowParallelError, WorkflowCompensateNotImplementedError;
 var init_workflow = __esm({
@@ -21528,6 +21552,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.
    *