File size: 3,141 Bytes
67d18ac | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 | /**
* ZCode system prompt blocks required by zcode.z.ai start-plan gateway.
*
* The gateway does content inspection — if it doesn't see the ZCode identity
* blocks in the `system` field, it rejects with 3012 "method not allowed".
*
* Static blocks (CLI Prefix, Agent Identity w/ Harness, Environment Info) live
* in zcode_system.json. When a model name is available, the dynamic
* `- You are powered by the model named ${currentModel}.` line is appended
* INSIDE the trailing Environment block's text (mirrors bundle 3.11.2 `T9o`
* / buildEnvInfoSection, which emits it as the block's last line — NOT as a
* separate 4th block).
*
* Source: extracted from ZCode Electron app's `buildCliPrefixSection`,
* `buildIdentitySection`, and `buildEnvInfoSection`. See PROMPT.md for the
* full prompt structure.
*
* @see zcode_system.json
* @see PROMPT.md
*/
// Inlined as a build-time constant (Bun `json` import attribute / esbuild json
// loader) so it ships inside the single-file compiled binary — a runtime
// `readFileSync` would resolve `__dirname` to the build-time CI path and crash
// with ENOENT on every other host. @see types.d.ts
import blocks from "./zcode_system.json" with { type: "json" };
interface SystemBlock {
type: "text";
text: string;
cache_control?: { type: "ephemeral" };
}
const ZCODE_SYSTEM_BLOCKS = blocks as SystemBlock[];
/**
* Prepend official ZCode gateway blocks to the request's `system` field.
* Client system blocks (if any) are preserved after the official blocks.
*
* When `currentModel` is a non-empty string, the powered-by line is merged
* into the LAST static block (Environment) as its trailing text line — the
* block's cache_control (if any) stays as-is, no extra breakpoint is created.
*/
export function buildStartPlanSystem(existingSystem: unknown, currentModel?: string): unknown[] {
const official = ZCODE_SYSTEM_BLOCKS.map((b) => structuredClone(b));
if (currentModel && currentModel.trim().length > 0) {
const env = official[official.length - 1];
if (env && typeof env === "object") {
env.text = `${env.text}\n- You are powered by the model named ${currentModel}.`;
}
}
const userBlocks = normalizeUserSystem(existingSystem);
return [...official, ...userBlocks];
}
function normalizeUserSystem(system: unknown): SystemBlock[] {
if (system == null) return [];
if (typeof system === "string") {
const text = system.trim();
return text ? [{ type: "text", text }] : [];
}
if (!Array.isArray(system)) return [];
const out: SystemBlock[] = [];
for (const item of system) {
if (typeof item === "string") {
if (item.trim()) out.push({ type: "text", text: item });
} else if (item && typeof item === "object") {
const b = item as Record<string, unknown>;
if (b.type === "text" && typeof b.text === "string" && b.text.trim()) {
out.push({
type: "text",
text: b.text,
...(typeof b.cache_control === "object" && b.cache_control !== null ? { cache_control: b.cache_control as { type: "ephemeral" } } : {}),
});
}
}
}
return out;
}
|