@theokit/sdk 4.16.6 → 4.17.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 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
+
+- fix(session): a model-prefix profile only wins the summarizer route when its credential is actually RESOLVABLE (oauth/none own their auth; api_key needs one of the profile's env vars set) — an `openai` prefix with only OPENROUTER_API_KEY in the environment now falls through to env detection instead of failing with "No provider client".
+
 ## 4.16.6
 
 ### 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

@@ -6064,10 +6064,12 @@ function buildDefaultSummarizer(opts) {
   return async (messages) => {
     registerBuiltins();
     const modelPrefix = opts.agentModel.includes("/") ? opts.agentModel.slice(0, opts.agentModel.indexOf("/")) : void 0;
+    const prefixProfile = modelPrefix !== void 0 ? getProviderProfile(modelPrefix) : void 0;
+    const prefixUsable = prefixProfile !== void 0 && (prefixProfile.authType !== "api_key" || prefixProfile.envVars.some((v) => (process.env[v] ?? "").length > 0));
     const route = resolveSummarizerRoute({
       keyProvider: inferProviderFromApiKey(opts.apiKey),
       modelPrefix,
-      prefixHasProfile: modelPrefix !== void 0 && getProviderProfile(modelPrefix) !== void 0,
+      prefixHasProfile: prefixUsable,
       envProvider: detectPrimaryProvider()
     });
     const provider = route.provider;
@@ -7595,6 +7597,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 = {};
@@ -19902,6 +19930,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.
    *