agent-from-zero 0.5.0 → 0.27.0

package/dist/validate.js

@@ -0,0 +1,60 @@
+// Structured tool-call validation. A model's tool arguments are probabilistic
+// output: it will sometimes drop a required field, send a number as a string,
+// or pass the wrong shape. The harness job is to constrain that output to the
+// declared schema and, on mismatch, hand back a PRECISE repair instruction so
+// the model fixes it on the next turn — instead of the tool crashing or doing
+// the wrong thing silently.
+//
+// This is a deliberately small subset of JSON Schema — exactly what our tool
+// definitions (and MCP servers') actually use: an object with typed properties
+// and a `required` list. Not a general validator; just enough to catch the
+// mistakes models really make, with messages they can act on.
+// JSON Schema "type" → does this runtime value match it? Unknown/absent type
+// matches anything (we don't over-constrain what the schema didn't constrain).
+function typeMatches(value, type) {
+    switch (type) {
+        case undefined:
+            return true; // no declared type → anything goes
+        case "string":
+            return typeof value === "string";
+        case "number":
+        case "integer":
+            return typeof value === "number" && (type === "number" || Number.isInteger(value));
+        case "boolean":
+            return typeof value === "boolean";
+        case "array":
+            return Array.isArray(value);
+        case "object":
+            return typeof value === "object" && value !== null && !Array.isArray(value);
+        default:
+            return true; // a type we don't model — don't reject on it
+    }
+}
+// Validate parsed arguments against a schema. Returns a list of human-readable
+// problems; an empty list means the arguments are valid. Pure — no I/O.
+export function validateArgs(schema, args) {
+    if (!schema)
+        return []; // no schema → nothing to check
+    const problems = [];
+    // The arguments must be a plain object — every tool takes a named-arg object.
+    if (typeof args !== "object" || args === null || Array.isArray(args)) {
+        return ["arguments must be a JSON object of named parameters"];
+    }
+    const obj = args;
+    // Every required parameter must be present and not null/undefined.
+    for (const name of schema.required ?? []) {
+        if (obj[name] === undefined || obj[name] === null) {
+            problems.push(`missing required parameter "${name}"`);
+        }
+    }
+    // Every PRESENT parameter that has a declared type must match it. (We only
+    // type-check what was provided — absence is the `required` check's job.)
+    for (const [name, spec] of Object.entries(schema.properties ?? {})) {
+        if (obj[name] === undefined || obj[name] === null)
+            continue; // not provided — skip (required handled above)
+        if (!typeMatches(obj[name], spec.type)) {
+            problems.push(`parameter "${name}" should be ${spec.type}, got ${Array.isArray(obj[name]) ? "array" : typeof obj[name]}`);
+        }
+    }
+    return problems;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-from-zero",
-  "version": "0.5.0",
+  "version": "0.27.0",
   "description": "Build a Claude Code-style CLI agent from scratch, with AI as your pair programmer — companion code for a 10-day tutorial (DeepSeek by default, any OpenAI-compatible model)",
   "type": "module",
   "bin": {
@@ -16,7 +16,7 @@
     "eval": "tsx --env-file=.env eval/run.ts",
     "build": "tsc -p tsconfig.build.json",
     "prepare": "npm run build",
-    "test": "tsx tests/tools.test.ts && tsx tests/permissions.test.ts && tsx tests/context.test.ts && tsx tests/hooks.test.ts"
+    "test": "tsx tests/tools.test.ts && tsx tests/permissions.test.ts && tsx tests/context.test.ts && tsx tests/hooks.test.ts && tsx tests/mcp.test.ts && tsx tests/judge.test.ts && tsx tests/memory.test.ts && tsx tests/cost.test.ts && tsx tests/validate.test.ts && tsx tests/plan.test.ts && tsx tests/diff.test.ts && tsx tests/undo.test.ts && tsx tests/tiering.test.ts && tsx tests/mcp-http.test.ts && tsx tests/changes.test.ts && tsx tests/mentions.test.ts && tsx tests/session.test.ts && tsx tests/ui.test.ts && tsx tests/approval.test.ts && tsx tests/form.test.ts && tsx tests/model.test.ts && tsx tests/reasoning.test.ts && tsx tests/skills.test.ts"
   },
   "engines": {
     "node": ">=20.6"