mirror of
https://github.com/ggml-org/llama.cpp.git
synced 2026-07-23 11:10:55 -05:00
61328e6a91
* feat(ui): add symbolic math support to JS sandbox via nerdamer Preload nerdamer (with decimal.js) in the sandboxed worker, exposing the `nerdamer` global for symbolic computation: simplify, expand, factor, diff, integrate, solve, laplace, ilt, limit, partfrac, gcd/lcm, roots, coefficients, and more. Mirrors the math.js integration pattern from the feature/sandbox-symbolic-math branch, but uses nerdamer for a lighter, more focused symbolic math engine. * Update sandbox-harness.ts * docs(ui): update sandbox tool description with detailed nerdamer usage guide * Clarify nerdamer usage in sandbox tool description Updated the description of the sandbox tool to clarify usage of nerdamer. * ui: build nerdamer sandbox prelude from vendored source Replace the vendored all.min.js with the readable nerdamer-prime source and its two bundled deps (big-integer, decimal.js), licenses included. A vite plugin bundles and minifies them at build time with the upstream esbuild flags, exposed as virtual:nerdamer and imported lazily on first sandbox use. The vendors package.json pins commonjs so the project level type: module does not break esbuild format detection. The harness gains a CSP removing network egress from the worker, and browser tests cover the prelude, exact arithmetic, the fetch block and the timeout. Upstream snapshot: together-science/nerdamer-prime@1936145 * feat(ui): make symbolic math (nerdamer) a user-toggleable setting - Add SYMBOLIC_MATH_ENABLED setting key and registry entry (checkbox, default false) - Convert SANDBOX_TOOL_DEFINITION to buildSandboxToolDefinition(includeSymbolicMath) so the tool description includes/excludes nerdamer API docs dynamically - Cache sandbox harness per variant ('nerdamer' / 'plain') for instant toggle - Deprecate SANDBOX_TOOL_DEFINITION constant alias for backward compatibility - Update tools store to pass symbolic math config into tool definition * docs(ui): tell LLM to list nerdamer functions first, do not guess * test(ui): enable symbolic math in sandbox tests via settingsStore config * style(ui): fix formatting for tools.svelte.ts --------- Co-authored-by: Pascal <admin@serveurperso.com>
57 lines
2.7 KiB
TypeScript
57 lines
2.7 KiB
TypeScript
import { BuiltInTool, JsonSchemaType, ToolCallType } from '$lib/enums';
|
|
import type { OpenAIToolDefinition } from '$lib/types';
|
|
|
|
export const SANDBOX_TOOL_NAME = BuiltInTool.RUN_JAVASCRIPT;
|
|
|
|
export const SANDBOX_TIMEOUT_MS_DEFAULT = 10000;
|
|
|
|
export const SANDBOX_TIMEOUT_MS_MAX = 30000;
|
|
|
|
export const SANDBOX_OUTPUT_MAX_CHARS = 8192;
|
|
|
|
export const SANDBOX_EMPTY_OUTPUT = '(no output)';
|
|
|
|
export const SANDBOX_TRUNCATION_NOTICE = '[output truncated]';
|
|
|
|
const NERDAMER_DESCRIPTION = `
|
|
Symbolic/numeric math via \`nerdamer\` (pre-loaded, do not require, use it directly).
|
|
nerdamer('diff(sin(x)/x,x)') or nerdamer.diff('sin(x)/x','x') → Expression; convert with .toString()/.text()/.toTeX(), or .evaluate() (→ still Expression, then .toString()).
|
|
nerdamer(expr,{x:2}) substitutes only; chain .evaluate() or pass 'numer' for numeric result.
|
|
solve(expr,var)→Symbol[]; solveEquations([eq1,..])→[[var,val],..] pairs.
|
|
Functions: simplify/expand/factor(expr), diff(expr,var[,n]), integrate(expr,var), defint(expr,from,to,var), limit(expr,var,to), laplace(expr,t,s), ilt(expr,s,t), gcd/lcm(a,b), roots/coeffs/partfrac(expr,var), pfactor(n), numer/decimals/erf(expr), product/sum(expr,var,from,to), mean/median/stdev/variance(...vals).
|
|
Object.keys(nerdamer).filter(k=>typeof nerdamer[k]==='function') lists all available functions. If you need a function not documented above, list them first — do not guess function names.`;
|
|
|
|
/**
|
|
* Build the sandbox tool definition. When `includeSymbolicMath` is true,
|
|
* the description includes nerdamer API documentation; otherwise it
|
|
* describes a plain JavaScript sandbox.
|
|
*/
|
|
export function buildSandboxToolDefinition(includeSymbolicMath: boolean): OpenAIToolDefinition {
|
|
return {
|
|
type: ToolCallType.FUNCTION,
|
|
function: {
|
|
name: SANDBOX_TOOL_NAME,
|
|
description: includeSymbolicMath
|
|
? `Execute JS in a sandboxed browser worker (no DOM/page access). Top-level await ok; console.log for intermediates; top-level return is captured as result.${NERDAMER_DESCRIPTION}`
|
|
: 'Execute JS in a sandboxed browser worker (no DOM/page access). Top-level await ok; console.log for intermediates; top-level return is captured as result.',
|
|
parameters: {
|
|
type: JsonSchemaType.OBJECT,
|
|
properties: {
|
|
code: {
|
|
type: JsonSchemaType.STRING,
|
|
description: 'JavaScript source to execute'
|
|
},
|
|
timeout_ms: {
|
|
type: JsonSchemaType.NUMBER,
|
|
description: `Execution timeout in milliseconds, default ${SANDBOX_TIMEOUT_MS_DEFAULT}, max ${SANDBOX_TIMEOUT_MS_MAX}`
|
|
}
|
|
},
|
|
required: ['code']
|
|
}
|
|
}
|
|
};
|
|
}
|
|
|
|
/** @deprecated Use {@link buildSandboxToolDefinition} instead. Kept for backward compatibility. */
|
|
export const SANDBOX_TOOL_DEFINITION = buildSandboxToolDefinition(true);
|