@theokit/sdk 4.24.0 → 4.26.0

package/dist/inject-session-6MJUSGZP.cjs

@@ -0,0 +1,27 @@
+'use strict';
+
+var chunkYU6KON2I_cjs = require('./chunk-YU6KON2I.cjs');
+var chunkIT3PWBW4_cjs = require('./chunk-IT3PWBW4.cjs');
+var chunk4SXHEZIV_cjs = require('./chunk-4SXHEZIV.cjs');
+require('./chunk-TIZ4TS5V.cjs');
+require('./chunk-BEURCLDV.cjs');
+
+// src/internal/session/inject-session.ts
+async function injectSessionTurn(opts) {
+  await chunkYU6KON2I_cjs.enqueueSessionWrite(opts.loc.cwd, opts.loc.agentId, async () => {
+    const prior = await opts.store.readRecords(opts.loc.agentId);
+    const transcript = chunk4SXHEZIV_cjs.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));
+    chunkIT3PWBW4_cjs.invalidateSessionCache(opts.loc.cwd, opts.loc.agentId);
+  });
+}
+
+exports.injectSessionTurn = injectSessionTurn;
+//# sourceMappingURL=inject-session-6MJUSGZP.cjs.map
+//# sourceMappingURL=inject-session-6MJUSGZP.cjs.map

package/dist/inject-session-6MJUSGZP.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/internal/session/inject-session.ts"],"names":["enqueueSessionWrite","SessionTranscript","invalidateSessionCache"],"mappings":";;;;;;;;;AAWA,eAAsB,kBAAkB,IAAA,EAMtB;AAChB,EAAA,MAAMA,sCAAoB,IAAA,CAAK,GAAA,CAAI,KAAK,IAAA,CAAK,GAAA,CAAI,SAAS,YAAY;AACpE,IAAA,MAAM,QAAQ,MAAM,IAAA,CAAK,MAAM,WAAA,CAAY,IAAA,CAAK,IAAI,OAAO,CAAA;AAC3D,IAAA,MAAM,UAAA,GAAaC,mCAAA,CAAkB,WAAA,CAAY,KAAA,EAAO;AAAA,MACtD,GAAA,EAAK,KAAK,GAAA,CAAI,GAAA;AAAA,MACd,WAAW,IAAA,CAAK,SAAA;AAAA,MAChB,KAAA,EAAO,IAAA,CAAK,GAAA,CAAI,KAAA,IAAS;AAAA,KAC1B,CAAA;AACD,IAAA,UAAA,CAAW,cAAA,CAAe,KAAK,QAAQ,CAAA;AACvC,IAAA,UAAA,CAAW,mBAAA,CAAoB,EAAE,IAAA,EAAM,IAAA,CAAK,eAAe,CAAA;AAC3D,IAAA,MAAM,IAAA,CAAK,KAAA,CAAM,aAAA,CAAc,IAAA,CAAK,GAAA,CAAI,OAAA,EAAS,UAAA,CAAW,OAAA,EAAQ,CAAE,KAAA,CAAM,KAAA,CAAM,MAAM,CAAC,CAAA;AACzF,IAAAC,wCAAA,CAAuB,IAAA,CAAK,GAAA,CAAI,GAAA,EAAK,IAAA,CAAK,IAAI,OAAO,CAAA;AAAA,EACvD,CAAC,CAAA;AACH","file":"inject-session-6MJUSGZP.cjs","sourcesContent":["/**\n * M51 (agent-builder) — inject a SYNTHETIC user+assistant pair into a session's persisted transcript\n * WITHOUT running an LLM turn. This is the Codex review-exit mechanism (`exit_success.xml` appended to\n * the parent thread history so follow-ups like \"fix finding 2\" work): the pair chains onto the DAG\n * leaf (M50 pattern) and the in-memory cache is invalidated so the NEXT send re-hydrates with it.\n */\nimport type { SessionStore } from \"../../types/session-store.js\";\nimport { SessionTranscript } from \"../persistence/session-transcript.js\";\nimport { enqueueSessionWrite, invalidateSessionCache } from \"./agent-session.js\";\nimport type { CompactLocation } from \"./compact-session.js\";\n\nexport async function injectSessionTurn(opts: {\n  store: SessionStore;\n  loc: CompactLocation;\n  sessionId: string;\n  userText: string;\n  assistantText: string;\n}): Promise<void> {\n  await enqueueSessionWrite(opts.loc.cwd, opts.loc.agentId, async () => {\n    const prior = await opts.store.readRecords(opts.loc.agentId);\n    const transcript = SessionTranscript.fromRecords(prior, {\n      cwd: opts.loc.cwd,\n      sessionId: opts.sessionId,\n      model: opts.loc.model ?? \"unknown\",\n    });\n    transcript.appendUserTurn(opts.userText);\n    transcript.appendAssistantTurn({ text: opts.assistantText });\n    await opts.store.appendRecords(opts.loc.agentId, transcript.records().slice(prior.length));\n    invalidateSessionCache(opts.loc.cwd, opts.loc.agentId);\n  });\n}\n"]}

package/dist/inject-session-KOFHS5K3.js

@@ -0,0 +1,25 @@
+import { enqueueSessionWrite } from './chunk-SQLZ7ONU.js';
+import { invalidateSessionCache } from './chunk-EEZ7CFMM.js';
+import { SessionTranscript } from './chunk-ZZWTY3RX.js';
+import './chunk-S2BBRVQX.js';
+import './chunk-JTFYYKDT.js';
+
+// src/internal/session/inject-session.ts
+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);
+  });
+}
+
+export { injectSessionTurn };
+//# sourceMappingURL=inject-session-KOFHS5K3.js.map
+//# sourceMappingURL=inject-session-KOFHS5K3.js.map

package/dist/inject-session-KOFHS5K3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/internal/session/inject-session.ts"],"names":[],"mappings":";;;;;;;AAWA,eAAsB,kBAAkB,IAAA,EAMtB;AAChB,EAAA,MAAM,oBAAoB,IAAA,CAAK,GAAA,CAAI,KAAK,IAAA,CAAK,GAAA,CAAI,SAAS,YAAY;AACpE,IAAA,MAAM,QAAQ,MAAM,IAAA,CAAK,MAAM,WAAA,CAAY,IAAA,CAAK,IAAI,OAAO,CAAA;AAC3D,IAAA,MAAM,UAAA,GAAa,iBAAA,CAAkB,WAAA,CAAY,KAAA,EAAO;AAAA,MACtD,GAAA,EAAK,KAAK,GAAA,CAAI,GAAA;AAAA,MACd,WAAW,IAAA,CAAK,SAAA;AAAA,MAChB,KAAA,EAAO,IAAA,CAAK,GAAA,CAAI,KAAA,IAAS;AAAA,KAC1B,CAAA;AACD,IAAA,UAAA,CAAW,cAAA,CAAe,KAAK,QAAQ,CAAA;AACvC,IAAA,UAAA,CAAW,mBAAA,CAAoB,EAAE,IAAA,EAAM,IAAA,CAAK,eAAe,CAAA;AAC3D,IAAA,MAAM,IAAA,CAAK,KAAA,CAAM,aAAA,CAAc,IAAA,CAAK,GAAA,CAAI,OAAA,EAAS,UAAA,CAAW,OAAA,EAAQ,CAAE,KAAA,CAAM,KAAA,CAAM,MAAM,CAAC,CAAA;AACzF,IAAA,sBAAA,CAAuB,IAAA,CAAK,GAAA,CAAI,GAAA,EAAK,IAAA,CAAK,IAAI,OAAO,CAAA;AAAA,EACvD,CAAC,CAAA;AACH","file":"inject-session-KOFHS5K3.js","sourcesContent":["/**\n * M51 (agent-builder) — inject a SYNTHETIC user+assistant pair into a session's persisted transcript\n * WITHOUT running an LLM turn. This is the Codex review-exit mechanism (`exit_success.xml` appended to\n * the parent thread history so follow-ups like \"fix finding 2\" work): the pair chains onto the DAG\n * leaf (M50 pattern) and the in-memory cache is invalidated so the NEXT send re-hydrates with it.\n */\nimport type { SessionStore } from \"../../types/session-store.js\";\nimport { SessionTranscript } from \"../persistence/session-transcript.js\";\nimport { enqueueSessionWrite, invalidateSessionCache } from \"./agent-session.js\";\nimport type { CompactLocation } from \"./compact-session.js\";\n\nexport async function injectSessionTurn(opts: {\n  store: SessionStore;\n  loc: CompactLocation;\n  sessionId: string;\n  userText: string;\n  assistantText: string;\n}): Promise<void> {\n  await enqueueSessionWrite(opts.loc.cwd, opts.loc.agentId, async () => {\n    const prior = await opts.store.readRecords(opts.loc.agentId);\n    const transcript = SessionTranscript.fromRecords(prior, {\n      cwd: opts.loc.cwd,\n      sessionId: opts.sessionId,\n      model: opts.loc.model ?? \"unknown\",\n    });\n    transcript.appendUserTurn(opts.userText);\n    transcript.appendAssistantTurn({ text: opts.assistantText });\n    await opts.store.appendRecords(opts.loc.agentId, transcript.records().slice(prior.length));\n    invalidateSessionCache(opts.loc.cwd, opts.loc.agentId);\n  });\n}\n"]}

package/dist/internal/judge/judge-call.d.ts

@@ -1,21 +1,4 @@
-/**
- * Judge call primitive (T2.2, ADRs D119-D121).
- *
- * Instantiates a short-lived auxiliary agent that evaluates whether a
- * goal is satisfied. The auxiliary judge runs with `tools: []` and a
- * cheap model (default `openai/gpt-4o-mini`) — see ADR D119. The judge
- * model needs only API access; we read `OPENROUTER_API_KEY` directly
- * from the environment (EC-A — single source of truth) and let the
- * caller override via {@link JudgeOptions.apiKey} for Anthropic or
- * direct-OpenAI environments.
- *
- * NOTE: judge aux agents created from inside a `forkAgent` context will
- * inherit the parent fork's whitelist via AsyncLocalStorage (EC-J).
- * `tools: []` keeps this benign today; future callers that add tools to
- * a judge should be aware.
- *
- * @internal
- */
+import { TheokitAgentError } from "../../errors.js";
 /** Inputs to the judge — pure data. */
 export interface JudgeContext {
     goal: string;
@@ -24,11 +7,41 @@ export interface JudgeContext {
 }
 /** Caller-supplied tuning knobs for the judge call. */
 export interface JudgeOptions {
-    /** Judge model identifier. Default `"openai/gpt-4o-mini"` (ADR D119). */
+    /**
+     * Judge model identifier. Quando ausente, DERIVA de {@link agentModel} — e só cai no literal
+     * `"openai/gpt-4o-mini"` se nem esse for informado.
+     *
+     * M80 — o default fixo era provider-cego: ele só resolve em OpenRouter. Com chave Anthropic dá
+     * 404, com bearer OAuth dá 401, e em ambos o goal queimava 3 turnos inteiros antes de falhar com
+     * razão enganosa. O agent-builder já contornava isso derivando por conta própria; o conhecimento
+     * pertence aqui.
+     */
     judgeModel?: string;
+    /**
+     * M80 — o modelo do agente CONDUZIDO. É a base da derivação: um judge que roda no mesmo modelo do
+     * chat funciona onde o chat funciona.
+     */
+    agentModel?: string;
     /** Override env. Default `process.env.OPENROUTER_API_KEY` (EC-A). */
     apiKey?: string;
 }
+/**
+ * M80 — a credencial ou o modelo do judge não servem: 401/404.
+ *
+ * Falha RÁPIDA por design. `rules/error-handling.md § 2` separa recuperável de irrecuperável, e um
+ * modelo inexistente não passa a existir no retry — dobrar isso em `{parseFailed: true}` fazia o loop
+ * tentar três vezes e reportar "failed" por limite de falhas consecutivas, escondendo que a causa era
+ * credencial. Falha lenta e opaca trocada por rápida e clara.
+ *
+ * Falha de PARSE e erro de rede continuam dobrados: são recuperáveis, e o loop já decide por falhas
+ * consecutivas.
+ */
+export declare class JudgeCredentialError extends TheokitAgentError {
+    readonly httpStatus: number;
+    readonly judgeModel: string;
+    readonly name = "JudgeCredentialError";
+    constructor(httpStatus: number, judgeModel: string, cause: unknown);
+}
 /** Dependencies injected so `judge-call.ts` stays free of `Agent` import. */
 export interface JudgeDeps {
     create: (options: AgentOptions) => Promise<SDKAgent>;