@sema-agent/core 1.342.0 → 1.344.0

package/dist/prompt-assembly/turn-snapshot.js

@@ -0,0 +1,99 @@
+import { createHash } from "node:crypto";
+import { canonical } from "./epoch.js";
+export const PREFIX_INPUT_CLASSIFICATION = {
+    provider: "cache-identity",
+    modelId: "cache-identity",
+    artifactDigest: "cache-identity",
+    promptProfile: "cache-identity",
+    fableMitigations: "cache-identity",
+    layoutGroups: "cache-identity",
+    stableSystemText: "cache-identity",
+    toolWire: "cache-identity",
+    thinkingLevel: "cache-identity",
+    maxTokens: "cache-identity",
+    hasOutputSchema: "cache-identity",
+    sessionId: "proven-irrelevant",
+    taskId: "proven-irrelevant",
+    turn: "volatile-no-reuse",
+    cacheRead: "volatile-no-reuse",
+};
+const sha = (text) => `sha256:${createHash("sha256").update(text, "utf8").digest("hex")}`;
+export const LOWERING_VERSION = "sema-lowering@1";
+export function loweringRecordFor(api) {
+    if (api.startsWith("anthropic")) {
+        return {
+            version: LOWERING_VERSION,
+            form: "anthropic-blocks",
+            intentionalDivergences: [
+                "system rides top-level `system` blocks (cache_control on the layout boundary), not a system message",
+                "reasoning replays via provider-native thinking blocks",
+            ],
+        };
+    }
+    if (api.startsWith("openai")) {
+        return {
+            version: LOWERING_VERSION,
+            form: "openai-merged",
+            intentionalDivergences: [
+                "multi-block system layouts merge into ONE system message (block boundaries erased — no per-block cache_control on this wire)",
+                "reasoning-content replay is provider-dialect dependent (loss: some dialects drop replayed reasoning)",
+            ],
+        };
+    }
+    return { version: LOWERING_VERSION, form: "other", intentionalDivergences: ["unknown wire family — lowering fidelity unverified"] };
+}
+function identityOf(e) {
+    return sha(canonical(e));
+}
+export function buildTurnPromptSnapshot(raw, api, promptHasher) {
+    const promptSha = promptHasher ?? sha;
+    const lowering = loweringRecordFor(api);
+    let requestPolicy = { thinkingLevel: raw.thinkingLevel, maxTokens: (raw.maxTokens ?? null), hasOutputSchema: raw.hasOutputSchema };
+    const elements = {
+        provider: raw.provider,
+        modelId: raw.modelId,
+        artifactDigest: raw.artifactDigest,
+        policyDigest: sha(canonical({ promptProfile: raw.promptProfile, fableMitigations: raw.fableMitigations })),
+        layoutDigest: sha(canonical(raw.layoutGroups)),
+        stableSystemDigest: promptSha(raw.stableSystemText),
+        toolWireDigest: sha(canonical(raw.toolWire.map((t) => ({ name: t.name, description: t.description, parameters: t.parameters })))),
+        requestPolicyDigest: sha(canonical(requestPolicy)),
+        loweringVersion: `${lowering.version}/${lowering.form}/${api}`,
+    };
+    const bump = () => {
+        snapshot.cacheIdentity = identityOf(elements);
+        snapshot.onChange?.(snapshot);
+    };
+    const snapshot = {
+        elements,
+        cacheIdentity: "",
+        lowering,
+        refreshTools(toolWire) {
+            elements.toolWireDigest = sha(canonical(toolWire.map((t) => ({ name: t.name, description: t.description, parameters: t.parameters }))));
+            bump();
+        },
+        refreshStableSystem(stableSystemText, artifactDigest) {
+            elements.stableSystemDigest = promptSha(stableSystemText);
+            if (artifactDigest !== undefined)
+                elements.artifactDigest = artifactDigest;
+            bump();
+        },
+        refreshRequestPolicy(p) {
+            requestPolicy = {
+                ...requestPolicy,
+                ...(p.thinkingLevel !== undefined ? { thinkingLevel: p.thinkingLevel } : {}),
+                ...(p.maxTokens !== undefined ? { maxTokens: p.maxTokens } : {}),
+            };
+            elements.requestPolicyDigest = sha(canonical(requestPolicy));
+            bump();
+        },
+        refreshModel(m) {
+            elements.provider = m.provider;
+            elements.modelId = m.modelId;
+            bump();
+        },
+    };
+    snapshot.cacheIdentity = identityOf(elements);
+    return snapshot;
+}
+//# sourceMappingURL=turn-snapshot.js.map

package/dist/prompt-assembly/turn-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-snapshot.js","sourceRoot":"","sources":["../../src/prompt-assembly/turn-snapshot.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/core",
-  "version": "1.342.0",
+  "version": "1.344.0",
   "description": "Stateless, task-oriented AI agent core",
   "type": "module",
   "license": "BUSL-1.1",