@sema-agent/core 1.335.0 → 1.336.0

package/dist/prompt-assembly/artifact-store.js

@@ -0,0 +1,153 @@
+import { mkdirSync, promises as fs } from "node:fs";
+import path from "node:path";
+import { verifyPromptArtifact, } from "./artifact.js";
+export class MemoryPromptArtifactStore {
+    byDigest = new Map();
+    async get(artifactDigest, opts) {
+        const bytes = this.byDigest.get(artifactDigest);
+        if (bytes === undefined)
+            return undefined;
+        let parsed;
+        try {
+            parsed = JSON.parse(bytes);
+        }
+        catch {
+            return undefined;
+        }
+        const v = verifyPromptArtifact(parsed, opts);
+        if (!v.ok || v.artifact.artifactDigest !== artifactDigest)
+            return undefined;
+        return parsed;
+    }
+    async put(envelope) {
+        this.byDigest.set(envelope.artifact.artifactDigest, JSON.stringify(envelope));
+    }
+}
+export class FilePromptArtifactStore {
+    dir;
+    constructor(dir) {
+        this.dir = dir;
+        mkdirSync(path.join(dir, "artifacts"), { recursive: true });
+    }
+    fileFor(artifactDigest) {
+        const m = /^sha256:([0-9a-f]{64})$/.exec(artifactDigest);
+        return m ? path.join(this.dir, "artifacts", `${m[1]}.json`) : undefined;
+    }
+    async get(artifactDigest, opts) {
+        const file = this.fileFor(artifactDigest);
+        if (file === undefined)
+            return undefined;
+        let bytes;
+        try {
+            bytes = await fs.readFile(file, "utf8");
+        }
+        catch {
+            return undefined;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(bytes);
+        }
+        catch {
+            return undefined;
+        }
+        const v = verifyPromptArtifact(parsed, opts);
+        if (!v.ok || v.artifact.artifactDigest !== artifactDigest)
+            return undefined;
+        return parsed;
+    }
+    async put(envelope) {
+        const file = this.fileFor(envelope.artifact.artifactDigest);
+        if (file === undefined)
+            throw new Error(`prompt-artifact store: malformed digest ${JSON.stringify(envelope.artifact.artifactDigest).slice(0, 120)}`);
+        const tmp = `${file}.tmp-${process.pid}-${Date.now()}`;
+        await fs.writeFile(tmp, JSON.stringify(envelope), "utf8");
+        await fs.rename(tmp, file);
+    }
+}
+export class MemoryPromptSourceStateStore {
+    state;
+    async load() {
+        return this.state;
+    }
+    async save(state) {
+        this.state = state;
+    }
+}
+export class FilePromptSourceStateStore {
+    file;
+    constructor(dir) {
+        mkdirSync(dir, { recursive: true });
+        this.file = path.join(dir, "source-state.json");
+    }
+    async load() {
+        let bytes;
+        try {
+            bytes = await fs.readFile(this.file, "utf8");
+        }
+        catch {
+            return undefined;
+        }
+        try {
+            const raw = JSON.parse(bytes);
+            if (raw?.state === "active" && typeof raw.artifactDigest === "string" && typeof raw.sourceRevision === "string") {
+                return { state: "active", artifactDigest: raw.artifactDigest, sourceRevision: raw.sourceRevision };
+            }
+            if (raw?.state === "disabled" && typeof raw.sourceRevision === "string") {
+                return { state: "disabled", sourceRevision: raw.sourceRevision };
+            }
+        }
+        catch {
+        }
+        return undefined;
+    }
+    async save(state) {
+        const tmp = `${this.file}.tmp-${process.pid}-${Date.now()}`;
+        await fs.writeFile(tmp, JSON.stringify(state), "utf8");
+        await fs.rename(tmp, this.file);
+    }
+}
+export class CenterPromptSource {
+    store;
+    stateStore;
+    engineVersion;
+    candidate;
+    constructor(opts) {
+        this.store = opts.store;
+        this.stateStore = opts.stateStore ?? new MemoryPromptSourceStateStore();
+        this.engineVersion = opts.engineVersion;
+    }
+    current() {
+        return this.candidate;
+    }
+    async get(artifactDigest) {
+        if (this.candidate?.artifact.artifactDigest === artifactDigest)
+            return this.candidate.artifact;
+        const env = await this.store.get(artifactDigest, { engineVersion: this.engineVersion });
+        return env?.artifact;
+    }
+    async restore() {
+        const state = await this.stateStore.load();
+        if (state?.state !== "active") {
+            this.candidate = undefined;
+            return;
+        }
+        const env = await this.store.get(state.artifactDigest, { engineVersion: this.engineVersion });
+        this.candidate = env !== undefined ? { artifact: env.artifact, sourceRevision: state.sourceRevision } : undefined;
+    }
+    async applySnapshot(raw) {
+        const v = verifyPromptArtifact(raw, { engineVersion: this.engineVersion });
+        if (!v.ok)
+            return v;
+        const envelope = raw;
+        await this.store.put(envelope);
+        await this.stateStore.save({ state: "active", artifactDigest: v.artifact.artifactDigest, sourceRevision: envelope.sourceRevision });
+        this.candidate = { artifact: v.artifact, sourceRevision: envelope.sourceRevision };
+        return { ok: true, artifactDigest: v.artifact.artifactDigest };
+    }
+    async applyDisabled(sourceRevision) {
+        await this.stateStore.save({ state: "disabled", sourceRevision });
+        this.candidate = undefined;
+    }
+}
+//# sourceMappingURL=artifact-store.js.map

package/dist/prompt-assembly/artifact-store.js.map

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

package/dist/prompt-assembly/artifact.d.ts

@@ -0,0 +1,68 @@
+import type { PromptTextDeclaration } from "../prompts/default.js";
+export type CenterOverlaySlot = "identity" | "scenario" | "behavior";
+export interface CenterOverlaySection {
+    id: string;
+    slot: CenterOverlaySlot;
+    text: string;
+    contentHash: string;
+}
+export interface PromptCatalogSnapshot {
+    packId: string;
+    sections: ReadonlyArray<CenterOverlaySection>;
+}
+export interface PromptDependencyClosure {
+    basePackId: string;
+    promptCatalog: PromptCatalogSnapshot;
+}
+export interface CoreCompatRange {
+    minCore?: string;
+    maxCoreExclusive?: string;
+}
+export interface PromptEpochArtifactPayload {
+    schemaVersion: 1;
+    assemblyApi: 1;
+    catalogDigest: string;
+    compatibleCore?: CoreCompatRange;
+    closure: PromptDependencyClosure;
+}
+export interface PromptEpochArtifact {
+    payload: PromptEpochArtifactPayload;
+    artifactDigest: string;
+}
+export interface PublishedPromptArtifactEnvelope {
+    artifact: PromptEpochArtifact;
+    sourceRevision: string;
+}
+export declare const ARTIFACT_LIMITS: {
+    readonly maxSections: 64;
+    readonly maxSectionBytes: 32000;
+    readonly maxTotalBytes: 131072;
+    readonly maxIdLength: 128;
+    readonly maxPackIdLength: 200;
+};
+export declare function sha256Hex(text: string): string;
+export declare function computeCatalogDigest(catalog: PromptCatalogSnapshot): string;
+export declare function computeArtifactDigest(payload: PromptEpochArtifactPayload): string;
+export type ArtifactVerifyResult = {
+    ok: true;
+    artifact: PromptEpochArtifact;
+} | {
+    ok: false;
+    code: string;
+    reason: string;
+};
+export declare function verifyPromptArtifact(raw: unknown, opts: {
+    engineVersion: string;
+}): ArtifactVerifyResult;
+export declare function artifactDeclarations(artifact: PromptEpochArtifact): PromptTextDeclaration[];
+export declare function buildPromptArtifactEnvelope(opts: {
+    packId: string;
+    sections: ReadonlyArray<{
+        id: string;
+        slot: CenterOverlaySlot;
+        text: string;
+    }>;
+    sourceRevision: string;
+    compatibleCore?: CoreCompatRange;
+}): PublishedPromptArtifactEnvelope;
+//# sourceMappingURL=artifact.d.ts.map

package/dist/prompt-assembly/artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../../src/prompt-assembly/artifact.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAGnE,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;AAErE,MAAM,WAAW,oBAAoB;IAEnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,iBAAiB,CAAC;IAExB,IAAI,EAAE,MAAM,CAAC;IAGb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IAEpC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,uBAAuB;IAEtC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,qBAAqB,CAAC;CACtC;AAGD,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,0BAA0B;IACzC,aAAa,EAAE,CAAC,CAAC;IACjB,WAAW,EAAE,CAAC,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,eAAe,CAAC;IACjC,OAAO,EAAE,uBAAuB,CAAC;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,0BAA0B,CAAC;IACpC,cAAc,EAAE,MAAM,CAAC;CACxB;AAID,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,EAAE,mBAAmB,CAAC;IAG9B,cAAc,EAAE,MAAM,CAAC;CACxB;AAID,eAAO,MAAM,eAAe;;;;;;CAMlB,CAAC;AAMX,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAE3E;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,0BAA0B,GAAG,MAAM,CAEjF;AAgBD,MAAM,MAAM,oBAAoB,GAC5B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,mBAAmB,CAAA;CAAE,GAC3C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAOhD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,oBAAoB,CAiGxG;AAMD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,qBAAqB,EAAE,CAO3F;AAID,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,aAAa,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,iBAAiB,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/E,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,eAAe,CAAC;CAClC,GAAG,+BAA+B,CAgBlC"}

package/dist/prompt-assembly/artifact.js

@@ -0,0 +1,170 @@
+import { createHash } from "node:crypto";
+import { canonical } from "./epoch.js";
+export const ARTIFACT_LIMITS = {
+    maxSections: 64,
+    maxSectionBytes: 32_000,
+    maxTotalBytes: 131_072,
+    maxIdLength: 128,
+    maxPackIdLength: 200,
+};
+const ID_RE = /^[a-z0-9][a-z0-9/._-]*$/;
+const DIGEST_RE = /^sha256:[0-9a-f]{64}$/;
+const SLOTS = new Set(["identity", "scenario", "behavior"]);
+export function sha256Hex(text) {
+    return `sha256:${createHash("sha256").update(text, "utf8").digest("hex")}`;
+}
+export function computeCatalogDigest(catalog) {
+    return sha256Hex(canonical(catalog));
+}
+export function computeArtifactDigest(payload) {
+    return sha256Hex(canonical(payload));
+}
+function triple(v) {
+    const m = /^(\d+)\.(\d+)\.(\d+)$/.exec(v.trim());
+    if (!m)
+        return undefined;
+    return [Number(m[1]), Number(m[2]), Number(m[3])];
+}
+function tripleCmp(a, b) {
+    for (let i = 0; i < 3; i++) {
+        if (a[i] !== b[i])
+            return a[i] < b[i] ? -1 : 1;
+    }
+    return 0;
+}
+export function verifyPromptArtifact(raw, opts) {
+    const fail = (code, reason) => ({ ok: false, code, reason });
+    if (raw === null || typeof raw !== "object")
+        return fail("shape", "envelope is not an object");
+    const env = raw;
+    if (typeof env.sourceRevision !== "string" || !env.sourceRevision || env.sourceRevision.length > 500) {
+        return fail("shape", "sourceRevision missing/oversized");
+    }
+    const art = env.artifact;
+    if (art === null || typeof art !== "object")
+        return fail("shape", "artifact is not an object");
+    const payload = art.payload;
+    if (payload === null || typeof payload !== "object")
+        return fail("shape", "payload is not an object");
+    if (payload.schemaVersion !== 1)
+        return fail("schema", `unsupported schemaVersion ${String(payload.schemaVersion)}`);
+    if (payload.assemblyApi !== 1)
+        return fail("schema", `unsupported assemblyApi ${String(payload.assemblyApi)}`);
+    if (typeof payload.catalogDigest !== "string" || !DIGEST_RE.test(payload.catalogDigest))
+        return fail("shape", "catalogDigest malformed");
+    let compatibleCore;
+    if (payload.compatibleCore !== undefined) {
+        const cc = payload.compatibleCore;
+        if (cc === null || typeof cc !== "object")
+            return fail("shape", "compatibleCore malformed");
+        compatibleCore = {};
+        for (const key of ["minCore", "maxCoreExclusive"]) {
+            const v = cc[key];
+            if (v === undefined)
+                continue;
+            if (typeof v !== "string" || triple(v) === undefined)
+                return fail("shape", `compatibleCore.${key} is not a dotted triple`);
+            compatibleCore[key] = v;
+        }
+        const engine = triple(opts.engineVersion);
+        if (engine === undefined)
+            return fail("core-range", `engine version "${opts.engineVersion}" is not a dotted triple`);
+        if (compatibleCore.minCore !== undefined && tripleCmp(engine, triple(compatibleCore.minCore)) < 0) {
+            return fail("core-range", `engine ${opts.engineVersion} < minCore ${compatibleCore.minCore}`);
+        }
+        if (compatibleCore.maxCoreExclusive !== undefined && tripleCmp(engine, triple(compatibleCore.maxCoreExclusive)) >= 0) {
+            return fail("core-range", `engine ${opts.engineVersion} >= maxCoreExclusive ${compatibleCore.maxCoreExclusive}`);
+        }
+    }
+    const closure = payload.closure;
+    if (closure === null || typeof closure !== "object")
+        return fail("shape", "closure is not an object");
+    if (closure.basePackId !== "sema-default@1") {
+        return fail("base-pack", `unsupported basePackId ${JSON.stringify(closure.basePackId).slice(0, 120)} (v1: bundled base only)`);
+    }
+    const catalog = closure.promptCatalog;
+    if (catalog === null || typeof catalog !== "object")
+        return fail("shape", "promptCatalog is not an object");
+    if (typeof catalog.packId !== "string" || !catalog.packId.trim() || catalog.packId.length > ARTIFACT_LIMITS.maxPackIdLength) {
+        return fail("shape", "promptCatalog.packId missing/oversized");
+    }
+    if (!Array.isArray(catalog.sections))
+        return fail("shape", "promptCatalog.sections is not an array");
+    if (catalog.sections.length === 0)
+        return fail("shape", "promptCatalog.sections is empty — publish at least one section, or disable the source instead");
+    if (catalog.sections.length > ARTIFACT_LIMITS.maxSections) {
+        return fail("limits", `${catalog.sections.length} sections > max ${ARTIFACT_LIMITS.maxSections}`);
+    }
+    const ids = new Set();
+    let totalBytes = 0;
+    const sections = [];
+    for (const rawSection of catalog.sections) {
+        if (rawSection === null || typeof rawSection !== "object")
+            return fail("shape", "section is not an object");
+        const s = rawSection;
+        if (typeof s.id !== "string" || s.id.startsWith("core/") || s.id.length > ARTIFACT_LIMITS.maxIdLength || !ID_RE.test(s.id)) {
+            return fail("shape", `invalid section id ${JSON.stringify(s.id).slice(0, 120)}`);
+        }
+        if (ids.has(s.id))
+            return fail("shape", `duplicate section id "${s.id}"`);
+        ids.add(s.id);
+        if (typeof s.slot !== "string" || !SLOTS.has(s.slot))
+            return fail("shape", `unknown slot ${JSON.stringify(s.slot).slice(0, 60)} ("${s.id}")`);
+        if (typeof s.text !== "string" || s.text.length === 0)
+            return fail("shape", `empty/missing text ("${s.id}")`);
+        const bytes = Buffer.byteLength(s.text, "utf8");
+        if (bytes > ARTIFACT_LIMITS.maxSectionBytes)
+            return fail("limits", `section "${s.id}" ${bytes} bytes > max ${ARTIFACT_LIMITS.maxSectionBytes}`);
+        totalBytes += bytes;
+        if (typeof s.contentHash !== "string" || !DIGEST_RE.test(s.contentHash))
+            return fail("shape", `contentHash missing/malformed ("${s.id}")`);
+        if (s.contentHash !== sha256Hex(s.text))
+            return fail("content-hash", `contentHash does not match text ("${s.id}")`);
+        sections.push({ id: s.id, slot: s.slot, text: s.text, contentHash: s.contentHash });
+    }
+    if (totalBytes > ARTIFACT_LIMITS.maxTotalBytes)
+        return fail("limits", `catalog ${totalBytes} bytes > max ${ARTIFACT_LIMITS.maxTotalBytes}`);
+    const normalizedCatalog = { packId: catalog.packId, sections };
+    const normalizedPayload = {
+        schemaVersion: 1,
+        assemblyApi: 1,
+        catalogDigest: payload.catalogDigest,
+        ...(compatibleCore !== undefined ? { compatibleCore } : {}),
+        closure: { basePackId: "sema-default@1", promptCatalog: normalizedCatalog },
+    };
+    if (computeCatalogDigest(normalizedCatalog) !== payload.catalogDigest) {
+        return fail("digest", "catalogDigest does not match canonical(promptCatalog)");
+    }
+    if (typeof art.artifactDigest !== "string" || !DIGEST_RE.test(art.artifactDigest))
+        return fail("shape", "artifactDigest malformed");
+    if (computeArtifactDigest(normalizedPayload) !== art.artifactDigest) {
+        return fail("digest", "artifactDigest does not match canonical(payload)");
+    }
+    return { ok: true, artifact: { payload: normalizedPayload, artifactDigest: art.artifactDigest } };
+}
+export function artifactDeclarations(artifact) {
+    return artifact.payload.closure.promptCatalog.sections.map((s) => ({
+        id: s.id,
+        slot: s.slot,
+        text: s.text,
+        contentHash: s.contentHash,
+    }));
+}
+export function buildPromptArtifactEnvelope(opts) {
+    const catalog = {
+        packId: opts.packId,
+        sections: opts.sections.map((s) => ({ ...s, contentHash: sha256Hex(s.text) })),
+    };
+    const payload = {
+        schemaVersion: 1,
+        assemblyApi: 1,
+        catalogDigest: computeCatalogDigest(catalog),
+        ...(opts.compatibleCore !== undefined ? { compatibleCore: opts.compatibleCore } : {}),
+        closure: { basePackId: "sema-default@1", promptCatalog: catalog },
+    };
+    return {
+        artifact: { payload, artifactDigest: computeArtifactDigest(payload) },
+        sourceRevision: opts.sourceRevision,
+    };
+}
+//# sourceMappingURL=artifact.js.map

package/dist/prompt-assembly/artifact.js.map

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

package/dist/prompt-assembly/assemble.d.ts

@@ -1,5 +1,5 @@
 import type { AgentTool } from "../internal/harness.js";
-import { type PromptProvider } from "../prompts/default.js";
+import { type PromptProvider, type PromptTextDeclaration } from "../prompts/default.js";
 import type { CompiledSection, CompiledSystemBlock, PromptRuntimeFacts } from "./types.js";
 export interface AssembleInputs {
     provider: PromptProvider;
@@ -13,10 +13,12 @@ export interface AssembleInputs {
     buildEnvBlock: (date: string) => string | undefined;
     date: string;
     modelGuidance?: string;
+    centerDeclarations?: PromptTextDeclaration[];
     onWarn?: (message: string, phase: "prompt-constitution" | "prompt-cache") => void;
 }
 export interface AssembledPrompt {
     constitution: "core" | "replaced" | "provider-assembled" | "legacy";
+    centerMounted?: boolean;
     renderWithDate?: (date: string) => string;
     systemPrompt: string;
     legacyBlocks: Array<{

package/dist/prompt-assembly/assemble.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assemble.d.ts","sourceRoot":"","sources":["../../src/prompt-assembly/assemble.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAwF,KAAK,cAAc,EAA8B,MAAM,uBAAuB,CAAC;AAG9K,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAc,kBAAkB,EAAuB,MAAM,YAAY,CAAC;AAE5H,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,cAAc,CAAC;IAGzB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAEpD,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,cAAc,KAAK,IAAI,CAAC;CACnF;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,GAAG,UAAU,GAAG,oBAAoB,GAAG,QAAQ,CAAC;IAEpE,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAE1C,YAAY,EAAE,MAAM,CAAC;IAErB,YAAY,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAElD,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAG7B,YAAY,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACtC;AAsCD,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,eAAe,CAgPtE"}
+{"version":3,"file":"assemble.d.ts","sourceRoot":"","sources":["../../src/prompt-assembly/assemble.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAwF,KAAK,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAG9K,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAc,kBAAkB,EAAuB,MAAM,YAAY,CAAC;AAE5H,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,cAAc,CAAC;IAGzB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAEpD,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IAMvB,kBAAkB,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAE7C,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,cAAc,KAAK,IAAI,CAAC;CACnF;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,GAAG,UAAU,GAAG,oBAAoB,GAAG,QAAQ,CAAC;IAIpE,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAE1C,YAAY,EAAE,MAAM,CAAC;IAErB,YAAY,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAElD,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAG7B,YAAY,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACtC;AAwFD,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,eAAe,CAqPtE"}

package/dist/prompt-assembly/assemble.js

@@ -25,6 +25,43 @@ function verifyDeclaredContentHash(d, onWarn) {
     onWarn?.(`prompt-provider stableBlocks: contentHash on "${d.id}" does not match sha256 of its text (expected shape sha256:<64 lowercase hex>) — dropped from the manifest`, "prompt-constitution");
     return undefined;
 }
+function mountDeclarations(basePack, decls, onWarn) {
+    const SLOT_BASE = { identity: 100, scenario: 350, behavior: 460 };
+    const counters = {};
+    const extra = [];
+    let replacesRoleBase = false;
+    for (const d of decls) {
+        if (!d.id || d.id.startsWith("core/") || d.id.length > 128 || !/^[a-z0-9][a-z0-9/._-]*$/.test(d.id)) {
+            throw new Error(`prompt-provider stableBlocks: invalid section id ${JSON.stringify(d.id).slice(0, 140)} (must match ^[a-z0-9][a-z0-9/._-]*$, ≤128 chars, non-core/)`);
+        }
+        const base = SLOT_BASE[d.slot];
+        if (base === undefined)
+            throw new Error(`prompt-provider stableBlocks: unknown slot "${String(d.slot)}" ("${d.id}")`);
+        if (d.slot === "identity")
+            replacesRoleBase = true;
+        const n = (counters[d.slot] = (counters[d.slot] ?? 0) + 1);
+        const declaredContentHash = verifyDeclaredContentHash(d, onWarn);
+        extra.push({
+            id: d.id,
+            slot: d.slot,
+            rank: base + n * 0.001,
+            owner: "deployment",
+            trust: "operator",
+            mutability: "replaceable",
+            cadence: "epoch",
+            cacheClass: "prefix-stable",
+            carrier: "system.block",
+            content: () => d.text,
+            legacyBlockId: d.id,
+            ...(declaredContentHash !== undefined ? { declaredContentHash } : {}),
+            origin: "provider",
+        });
+    }
+    return {
+        ...basePack,
+        sections: [...basePack.sections.filter((s) => !(replacesRoleBase && s.id === "core/role.base")), ...extra],
+    };
+}
 export function assemblePrompt(inputs) {
     const { provider, facts } = inputs;
     const onWarn = inputs.onWarn
@@ -45,6 +82,9 @@ export function assemblePrompt(inputs) {
         ...facts,
     };
     if (!inputs.isDefaultProvider && !provider.stableBlocks && !provider.stableSystem && provider.system) {
+        if (inputs.centerDeclarations && inputs.centerDeclarations.length > 0) {
+            onWarn?.("prompt-constitution: a center prompt artifact is adopted but this PromptProvider uses the legacy free-form system() hook, which owns the whole prompt — the center sections cannot mount on this path. Upgrade to stableBlocks/stableSystem to compose center content.", "prompt-constitution");
+        }
         let systemPrompt = provider.system({ ...stableCtx, memoryBlock: inputs.memoryBlock });
         const memTrim = inputs.memoryBlock?.trim();
         if (memTrim && systemPrompt.includes(memTrim) && !systemPrompt.trimEnd().endsWith(memTrim)) {
@@ -61,6 +101,7 @@ export function assemblePrompt(inputs) {
     let roleBase = inputs.userSystemPrompt ?? DEFAULT_SYSTEM_PROMPT;
     let roleBaseFromProvider = false;
     let constitution = "core";
+    let centerMounted = false;
     if (!inputs.isDefaultProvider && provider.stableBlocks) {
         const decls = provider.stableBlocks(stableCtx).map((d) => ({
             id: d.id,
@@ -71,6 +112,9 @@ export function assemblePrompt(inputs) {
         const assembledIdentity = decls.find((d) => d.slot === "identity" && d.text.includes(CYBER_RISK) && d.text.includes(URL_SAFETY) && d.text.includes("# Harness"));
         if (assembledIdentity) {
             onWarn?.("prompt-constitution: a stableBlocks identity declaration carries an already-assembled prompt (constitution anchors found). Passed through un-doubled — provide ONLY the role layer in identity blocks.", "prompt-constitution");
+            if (inputs.centerDeclarations && inputs.centerDeclarations.length > 0) {
+                onWarn?.("prompt-constitution: a center prompt artifact is adopted but the provider's assembled-identity pass-through owns the prompt — the center sections cannot mount on this migration path.", "prompt-constitution");
+            }
             const renderInputsPT = (date) => ({
                 roleBase: assembledIdentity.text,
                 facts,
@@ -88,6 +132,7 @@ export function assemblePrompt(inputs) {
             let lastPT = compose(ptPack, renderInputsPT(inputs.date));
             return {
                 constitution: "provider-assembled",
+                centerMounted: false,
                 renderWithDate: (date) => {
                     lastPT = compose(ptPack, renderInputsPT(date));
                     return lastPT.text;
@@ -106,41 +151,16 @@ export function assemblePrompt(inputs) {
                 },
             };
         }
-        const SLOT_BASE = { identity: 100, scenario: 350, behavior: 460 };
-        const counters = {};
-        const extra = [];
-        let replacesRoleBase = false;
-        for (const d of decls) {
-            if (!d.id || d.id.startsWith("core/") || d.id.length > 128 || !/^[a-z0-9][a-z0-9/._-]*$/.test(d.id)) {
-                throw new Error(`prompt-provider stableBlocks: invalid section id ${JSON.stringify(d.id).slice(0, 140)} (must match ^[a-z0-9][a-z0-9/._-]*$, ≤128 chars, non-core/)`);
+        const providerIds = new Set(decls.map((d) => d.id));
+        const centerDecls = (inputs.centerDeclarations ?? []).filter((c) => {
+            if (providerIds.has(c.id)) {
+                onWarn?.(`prompt-constitution: center section "${c.id}" collides with a provider stableBlocks declaration of the same id — the provider declaration wins (deployment-local SHADOW); the center section is not mounted this run.`, "prompt-constitution");
+                return false;
             }
-            const base = SLOT_BASE[d.slot];
-            if (base === undefined)
-                throw new Error(`prompt-provider stableBlocks: unknown slot "${String(d.slot)}" ("${d.id}")`);
-            if (d.slot === "identity")
-                replacesRoleBase = true;
-            const n = (counters[d.slot] = (counters[d.slot] ?? 0) + 1);
-            const declaredContentHash = verifyDeclaredContentHash(d, onWarn);
-            extra.push({
-                id: d.id,
-                slot: d.slot,
-                rank: base + n * 0.001,
-                owner: "deployment",
-                trust: "operator",
-                mutability: "replaceable",
-                cadence: "epoch",
-                cacheClass: "prefix-stable",
-                carrier: "system.block",
-                content: () => d.text,
-                legacyBlockId: d.id,
-                ...(declaredContentHash !== undefined ? { declaredContentHash } : {}),
-                origin: "provider",
-            });
-        }
-        pack = {
-            ...SEMA_DEFAULT_PACK,
-            sections: [...SEMA_DEFAULT_PACK.sections.filter((s) => !(replacesRoleBase && s.id === "core/role.base")), ...extra],
-        };
+            return true;
+        });
+        centerMounted = inputs.centerDeclarations !== undefined && inputs.centerDeclarations.length > 0;
+        pack = mountDeclarations(SEMA_DEFAULT_PACK, [...centerDecls, ...decls], onWarn);
     }
     else if (!inputs.isDefaultProvider && provider.stableSystem) {
         const roleOut = provider.stableSystem(stableCtx);
@@ -164,6 +184,10 @@ export function assemblePrompt(inputs) {
     }
     if (!roleBaseFromProvider && facts.promptProfile !== "classic" && roleBase === CODE_SYSTEM_PROMPT)
         roleBase = CODE_AGENT_PROMPT;
+    if (inputs.centerDeclarations && inputs.centerDeclarations.length > 0 && !(!inputs.isDefaultProvider && provider.stableBlocks)) {
+        pack = mountDeclarations(pack, inputs.centerDeclarations, onWarn);
+        centerMounted = true;
+    }
     const renderInputs = (date) => ({
         roleBase,
         roleAppend: inputs.userAppendSystemPrompt,
@@ -180,6 +204,7 @@ export function assemblePrompt(inputs) {
     };
     return {
         constitution,
+        centerMounted,
         renderWithDate,
         get systemPrompt() {
             return last.text;