@womp/spark-agent 3.0.3 → 4.0.1

package/dist/context.js

@@ -1,266 +0,0 @@
-export class SparkContextLimitError extends Error {
-    constructor() {
-        super("This conversation is too large to continue without losing required context. Completed work and full history are saved. Start a new conversation with the current target references and remaining task; inspect existing results before retrying any changes.");
-        this.name = "SparkContextLimitError";
-    }
-}
-function record(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value)
-        ? value
-        : undefined;
-}
-/** Heuristic, not provider tokenization. Encoded media bytes are not text tokens. */
-export function estimateSparkContextTokens(value) {
-    let mediaTokens = 0;
-    const json = JSON.stringify(value, (_key, item) => {
-        const part = record(item);
-        if (part &&
-            (part.type === "image" || part.type === "file" || part.type === "reasoning-file")) {
-            const isImage = part.type === "image" ||
-                (typeof part.mediaType === "string" && part.mediaType.startsWith("image/"));
-            mediaTokens += isImage ? 512 : 8192;
-            return { type: part.type, mediaType: part.mediaType };
-        }
-        return item;
-    }) ?? "";
-    return Math.ceil(new TextEncoder().encode(json).byteLength / 3) + mediaTokens;
-}
-function executionOutput(part) {
-    if (part.toolName !== "execute_javascript" || part.output.type !== "content")
-        return;
-    const first = part.output.value[0];
-    if (first?.type !== "text")
-        return;
-    try {
-        const value = record(JSON.parse(first.text));
-        if (value?.version === 2 && typeof value.ok === "boolean")
-            return value;
-    }
-    catch {
-        // Legacy and unrecognized results remain verbatim.
-    }
-}
-function shortenSkills(messages, keepLatest) {
-    let retained = 0;
-    const result = [...messages];
-    for (let index = result.length - 1; index >= 0; index--) {
-        const message = result[index];
-        if (message.role !== "tool")
-            continue;
-        result[index] = {
-            ...message,
-            content: message.content.map((part) => {
-                if (part.type !== "tool-result" ||
-                    part.toolName !== "read_skill" ||
-                    part.output.type !== "json")
-                    return part;
-                const skill = record(part.output.value);
-                if (skill?.ok !== true ||
-                    typeof skill.name !== "string" ||
-                    (typeof skill.instructions !== "string" && typeof skill.declarations !== "string"))
-                    return part;
-                if (retained++ < keepLatest)
-                    return part;
-                const summary = {
-                    ok: true,
-                    name: skill.name,
-                    version: typeof skill.version === "string" ? skill.version : "",
-                    contextNote: "This older skill body was removed from model context. Call read_skill again before using its API; do not guess its declarations.",
-                };
-                if (JSON.stringify(summary).length >= JSON.stringify(skill).length)
-                    return part;
-                return { ...part, output: { type: "json", value: summary } };
-            }),
-        };
-    }
-    return result;
-}
-/**
- * Project model input only. Never mutate persisted messages, remove call/result
- * pairs, summarize user requests, or discard receipts, references, and failures.
- */
-export function prepareSparkContext(messages, system, policy) {
-    if (!Number.isSafeInteger(policy.maxInputTokens) || policy.maxInputTokens < 1)
-        throw new Error("maxInputTokens must be a positive integer.");
-    // Reserve room for the two tool schemas and provider message framing.
-    const fits = (input) => estimateSparkContextTokens({ system, messages: input }) + 2048 <= policy.maxInputTokens;
-    if (fits(messages))
-        return messages;
-    const seenSkills = new Map();
-    const seenOutputs = new Map();
-    const compactableCalls = new Set();
-    const lastUser = messages.reduce((last, message, index) => (message.role === "user" ? index : last), -1);
-    const prepared = messages.map((message) => ({ ...message }));
-    for (let index = prepared.length - 1; index >= 0; index--) {
-        const message = prepared[index];
-        if (message.role !== "tool")
-            continue;
-        prepared[index] = {
-            ...message,
-            content: message.content.map((part) => {
-                if (part.type !== "tool-result")
-                    return part;
-                if (part.toolName === "read_skill" && part.output.type === "json") {
-                    const skill = record(part.output.value);
-                    if (skill?.ok !== true || typeof skill.name !== "string")
-                        return part;
-                    const key = JSON.stringify(skill);
-                    const later = seenSkills.get(key);
-                    if (later === undefined) {
-                        seenSkills.set(key, part.toolCallId);
-                        return part;
-                    }
-                    const summary = {
-                        ok: true,
-                        name: skill.name,
-                        version: typeof skill.version === "string" ? skill.version : "",
-                        contextNote: `Identical skill content is retained in tool result ${later}. Read the skill again if needed.`,
-                    };
-                    if (JSON.stringify(summary).length >= key.length)
-                        return part;
-                    return {
-                        ...part,
-                        output: { type: "json", value: summary },
-                    };
-                }
-                const output = executionOutput(part);
-                if (!output || part.output.type !== "content")
-                    return part;
-                const receipts = Array.isArray(output.receipts) ? output.receipts : [];
-                const settled = output.ok === true &&
-                    receipts.every((receipt) => record(receipt)?.status === "committed");
-                // Preserve code for unresolved work and for the current user turn.
-                if (index < lastUser && settled && receipts.length > 0)
-                    compactableCalls.add(part.toolCallId);
-                if (!settled)
-                    return part;
-                const key = JSON.stringify({ value: output.value, logs: output.logs });
-                const later = seenOutputs.get(key);
-                if (later === undefined) {
-                    seenOutputs.set(key, part.toolCallId);
-                    return part;
-                }
-                const abbreviated = {
-                    ...output,
-                    value: null,
-                    logs: [`Identical returned value and logs are retained in tool result ${later}.`],
-                    contextNote: "Only duplicate observations were omitted. This call's own receipts and artifacts remain below.",
-                };
-                const text = JSON.stringify(abbreviated);
-                if (text.length >= JSON.stringify(output).length)
-                    return part;
-                return {
-                    ...part,
-                    output: {
-                        ...part.output,
-                        value: [{ type: "text", text }, ...part.output.value.slice(1)],
-                    },
-                };
-            }),
-        };
-    }
-    if (fits(prepared))
-        return prepared;
-    // Prefer keeping the latest workflow and reference together while there is room.
-    const withRecentSkills = shortenSkills(prepared, 2);
-    if (fits(withRecentSkills))
-        return withRecentSkills;
-    const withoutOldCode = withRecentSkills.map((message) => {
-        if (message.role !== "assistant" ||
-            typeof message.content === "string" ||
-            message.providerOptions)
-            return message;
-        if (message.content.some((part) => part.type === "reasoning" ||
-            part.type === "reasoning-file" ||
-            ("providerOptions" in part && part.providerOptions)))
-            return message;
-        return {
-            ...message,
-            content: message.content.map((part) => {
-                // Signed/provider-owned tool inputs must remain byte-for-byte intact.
-                if (part.type !== "tool-call" ||
-                    part.toolName !== "execute_javascript" ||
-                    part.providerOptions ||
-                    !compactableCalls.has(part.toolCallId))
-                    return part;
-                const input = record(part.input);
-                if (typeof input?.code !== "string")
-                    return part;
-                const code = "// Historical code omitted from model context. This completed call must not be replayed; inspect its preserved result and receipts.";
-                if (input.code.length <= code.length)
-                    return part;
-                return {
-                    ...part,
-                    input: { ...input, code },
-                };
-            }),
-        };
-    });
-    if (fits(withoutOldCode))
-        return withoutOldCode;
-    // Older visual observations can be recovered from their retained artifact references.
-    // Keep the latest visual result and all user/provider-owned media verbatim.
-    // SDK call metadata can also appear on local tool results; preserve that metadata
-    // without treating the host's subsequently produced output as signed model content.
-    let latestVisualCall;
-    for (const message of withoutOldCode) {
-        if (message.role !== "tool")
-            continue;
-        for (const part of message.content) {
-            if (part.type !== "tool-result" || part.output.type !== "content")
-                continue;
-            if (part.output.value.some((item) => item.type === "file"))
-                latestVisualCall = part.toolCallId;
-        }
-    }
-    for (let index = 0; index < withoutOldCode.length; index++) {
-        const message = withoutOldCode[index];
-        if (message.role !== "tool" || message.providerOptions)
-            continue;
-        withoutOldCode[index] = {
-            ...message,
-            content: message.content.map((part) => {
-                if (part.type !== "tool-result" ||
-                    part.toolCallId === latestVisualCall ||
-                    part.output.type !== "content")
-                    return part;
-                const output = executionOutput(part);
-                if (output?.ok !== true ||
-                    !Array.isArray(output.artifacts) ||
-                    output.artifacts.length === 0)
-                    return part;
-                if (output.artifacts.some((item) => typeof record(record(item)?.artifact)?.id !== "string"))
-                    return part;
-                const receipts = Array.isArray(output.receipts) ? output.receipts : [];
-                if (receipts.some((receipt) => record(receipt)?.status !== "committed"))
-                    return part;
-                if (!part.output.value.some((item) => item.type === "file"))
-                    return part;
-                if (part.output.value.some((item) => "providerOptions" in item && item.providerOptions))
-                    return part;
-                const abbreviated = {
-                    ...output,
-                    contextNote: "Older image/file bytes were omitted from model context. The original artifact references remain in this result and full stored history. Use emitImage or emitFile with those references when you need to inspect them again.",
-                };
-                return {
-                    ...part,
-                    output: {
-                        type: "content",
-                        value: [
-                            { type: "text", text: JSON.stringify(abbreviated) },
-                            ...part.output.value.slice(1).filter((item) => item.type !== "file"),
-                        ],
-                    },
-                };
-            }),
-        };
-        if (fits(withoutOldCode))
-            return withoutOldCode;
-    }
-    // Documentation can be reread; keep current observations and receipts instead
-    // of stopping solely to retain a second skill body.
-    const withLatestSkill = shortenSkills(withoutOldCode, 1);
-    if (fits(withLatestSkill))
-        return withLatestSkill;
-    throw new SparkContextLimitError();
-}

package/dist/generated/health-declarations.d.ts

@@ -1 +0,0 @@
-export declare const WOMP_HEALTH_DECLARATIONS = "declare const womp: { health: {\n\"read\": ((objectIds: Array<number>) => Promise<{\n\"status\": \"within_limits\" | \"overflow\" | \"unverified\";\n\"freshness\": \"unverified\" | \"snapshot\" | \"post_ack_event\";\n\"revisionVerified\": false;\n\"affectedAreaIds\": Array<string>;\n\"emptyAreaIds\"?: undefined | Array<string>;\n\"thermometer\"?: undefined | {\n\"objects\": {\n[key: string]: {\n\"num_prims\": number;\n\"flag_prim_overflow\": number;\n\"flag_depth_overflow\": number;\n\"flag_vox_overflow\": number;\n\"voxels\": number;\n};\n};\n\"max_num_prims\": number;\n\"max_total_depth\": number;\n\"max_per_object\": number;\n\"total\": number;\n\"max_total\": number;\n\"assets_budget_used\": number;\n\"assets_budget_total\": number;\n\"mesh_instances_used\"?: undefined | number;\n\"mesh_instances_total\"?: undefined | number;\n\"decal_instances_used\"?: undefined | number;\n\"decal_instances_total\"?: undefined | number;\n\"field_instances_used\"?: undefined | number;\n\"field_instances_total\"?: undefined | number;\n};\n\"reason\"?: undefined | string;\n}>);\n} };\ndeclare function print(...values: unknown[]): void;\ndeclare function emitImage(ref: { id: string; mediaType: string; name?: string }): Promise<void>;\ndeclare function emitFile(ref: { id: string; mediaType: string; name?: string }): Promise<void>;\n";

package/dist/generated/health-declarations.js

@@ -1,3 +0,0 @@
-// Generated by scripts/generate-skill-declarations.mjs.
-// prettier-ignore
-export const WOMP_HEALTH_DECLARATIONS = "declare const womp: { health: {\n\"read\": ((objectIds: Array<number>) => Promise<{\n\"status\": \"within_limits\" | \"overflow\" | \"unverified\";\n\"freshness\": \"unverified\" | \"snapshot\" | \"post_ack_event\";\n\"revisionVerified\": false;\n\"affectedAreaIds\": Array<string>;\n\"emptyAreaIds\"?: undefined | Array<string>;\n\"thermometer\"?: undefined | {\n\"objects\": {\n[key: string]: {\n\"num_prims\": number;\n\"flag_prim_overflow\": number;\n\"flag_depth_overflow\": number;\n\"flag_vox_overflow\": number;\n\"voxels\": number;\n};\n};\n\"max_num_prims\": number;\n\"max_total_depth\": number;\n\"max_per_object\": number;\n\"total\": number;\n\"max_total\": number;\n\"assets_budget_used\": number;\n\"assets_budget_total\": number;\n\"mesh_instances_used\"?: undefined | number;\n\"mesh_instances_total\"?: undefined | number;\n\"decal_instances_used\"?: undefined | number;\n\"decal_instances_total\"?: undefined | number;\n\"field_instances_used\"?: undefined | number;\n\"field_instances_total\"?: undefined | number;\n};\n\"reason\"?: undefined | string;\n}>);\n} };\ndeclare function print(...values: unknown[]): void;\ndeclare function emitImage(ref: { id: string; mediaType: string; name?: string }): Promise<void>;\ndeclare function emitFile(ref: { id: string; mediaType: string; name?: string }): Promise<void>;\n";