@namzu/sdk 5.1.0 → 5.2.0

package/dist/directory/load.js

@@ -0,0 +1,488 @@
+import { readFile } from 'node:fs/promises';
+import { pathToFileURL } from 'node:url';
+import { loadSkill } from '../skills/loader.js';
+import { canonicalRoot, scanSlot } from './scan.js';
+import { ALL_SLOTS } from './types.js';
+const DEFAULT_MODULE_TIMEOUT_MS = 10_000;
+/**
+ * Import a module with a deadline that bounds the LOADER, not the module.
+ *
+ * `import()` cannot be cancelled. When this races out, the module is still
+ * executing: it may finish, its top-level side effects may land after
+ * `loadDirectory` has returned, and Node caches the result — so a second load in
+ * the same process can see the same file resolve instantly. That was verified
+ * rather than assumed, and it is why `'abandoned'` exists as an outcome
+ * separate from `'failed'`.
+ */
+async function importWithDeadline(fileUrl, importModule, timeoutMs) {
+    let timer;
+    const deadline = new Promise((resolve) => {
+        timer = setTimeout(() => resolve({ status: 'abandoned' }), timeoutMs);
+    });
+    try {
+        const result = await Promise.race([
+            importModule(fileUrl).then((module) => ({
+                status: 'loaded',
+                module,
+            })),
+            deadline,
+        ]);
+        return result;
+    }
+    catch (err) {
+        const code = err?.code;
+        return {
+            status: 'failed',
+            cause: err instanceof Error ? err.message : String(err),
+            ...(typeof code === 'string' ? { code } : {}),
+        };
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}
+/**
+ * Translate Node's module-loading errors into something an author can act on.
+ *
+ * The codes matter more than the messages: `ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX`
+ * means the file used a construct type STRIPPING cannot express (an `enum`, a
+ * decorator, a parameter property) — stripping erases types, it does not
+ * transform code, and no flag rescues those. That is a different problem from
+ * a plain syntax error, and pointing at the wrong one costs an author an hour.
+ *
+ * That sentence was true and this function still matched on `cause`, which is
+ * `err.message` — and Node does not put the code in the message. Probed:
+ * `ERR_MODULE_NOT_FOUND` arrives as *"Cannot find module …"*, and
+ * `ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX` as *"TypeScript enum is not supported in
+ * strip-only mode"*. Neither contains its code, so every branch below was
+ * unreachable and every author got the bare message the doc-comment was
+ * explaining why not to give them. The code is read from `err.code` now, which
+ * is where it always was.
+ */
+function explainImportFailure(cause, code) {
+    if (code === 'ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX') {
+        return `${cause}\n\nNode strips types, it does not compile them: enums, decorators, parameter properties and runtime namespaces have no stripped form. Rewrite as plain TypeScript, or pass \`importModule\` with a transforming loader.`;
+    }
+    if (code === 'ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING') {
+        return `${cause}\n\nNode refuses to strip types from any .ts file resolved under node_modules/. If this is a workspace package, have it ship built .js.`;
+    }
+    if (code === 'ERR_MODULE_NOT_FOUND') {
+        return `${cause}\n\nRelative imports need their real extension here — write "./util.ts", not "./util". tsconfig "paths" aliases are not resolved; pass \`importModule\` if you need them.`;
+    }
+    // Node ≥20 but <22.6 has no type stripping at all, so the golden path — a
+    // `.ts` tool — dies here rather than at any of the codes above.
+    if (code === 'ERR_UNKNOWN_FILE_EXTENSION' && /\.[cm]?ts"?$/.test(cause)) {
+        return `${cause}\n\nThis Node cannot run TypeScript directly. Use Node 22.18 or newer, or pass \`importModule\` with a loader that transpiles.`;
+    }
+    return cause;
+}
+/**
+ * The fields `ToolDefinition` declares without a `?`.
+ *
+ * Checking `name` and `execute` alone was not a weaker version of this check,
+ * it was a check that let the failure through and moved it: a default export
+ * with no `inputSchema` passed here, registered clean, and then died inside
+ * `toLLMTools()` reading `inputSchema._def` — a `TypeError` naming a file this
+ * loader never mentions, at a point where the author is no longer looking at
+ * their tool. A loader whose job is to report bad files must reject the ones
+ * that crash later, not only the ones that are obviously not tools.
+ *
+ * Exactly the required set, and no more. `isReadOnly`, `isDestructive` and the
+ * other `defineTool` niceties are not on the interface, so demanding them would
+ * make this loader refuse a hand-written object that satisfies the SDK's own
+ * published type — the loader overruling the SDK.
+ */
+function isToolDefinition(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const c = value;
+    return (typeof c.name === 'string' &&
+        typeof c.description === 'string' &&
+        typeof c.execute === 'function' &&
+        typeof c.inputSchema === 'object' &&
+        c.inputSchema !== null);
+}
+/** The default export, tolerating a namespace that only has named exports. */
+function defaultExport(module) {
+    if (typeof module !== 'object' || module === null)
+        return undefined;
+    return module.default;
+}
+function readConfig(value, diagnostics, path) {
+    if (value === undefined)
+        return {};
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        diagnostics.push({
+            code: 'invalid_config',
+            severity: 'error',
+            message: 'agent.ts must default-export a plain object.',
+            path,
+        });
+        return {};
+    }
+    // Read field by field rather than spread: an unknown key is the author's
+    // business, but a known key of the wrong type would reach `runAgent` and
+    // fail somewhere with no mention of this file.
+    const raw = value;
+    const config = {};
+    const take = (key, ok, expected) => {
+        const found = raw[key];
+        if (found === undefined)
+            return;
+        if (!ok(found)) {
+            diagnostics.push({
+                code: 'invalid_config',
+                severity: 'error',
+                message: `agent.ts: "${key}" must be a ${expected}, received ${typeof found}.`,
+                path,
+            });
+            return;
+        }
+        config[key] = found;
+    };
+    const isString = (v) => typeof v === 'string';
+    // Rejects NaN and Infinity too. A budget of NaN compares false against
+    // every limit, so it would read as "no cap" rather than as a bad value.
+    const isNumber = (v) => typeof v === 'number' && Number.isFinite(v);
+    take('model', isString, 'string');
+    take('name', isString, 'string');
+    take('temperature', isNumber, 'finite number');
+    take('maxIterations', isNumber, 'finite number');
+    take('tokenBudget', isNumber, 'finite number');
+    take('timeoutMs', isNumber, 'finite number');
+    // `metadata` is typed `Record<string, string>` and was admitted on
+    // `typeof === 'object'` alone — which an array also satisfies, and which
+    // says nothing about the values. So `{ tags: ['a'] }` and `{ n: 1 }` both
+    // reached a consumer that had been promised strings, and the type was a
+    // claim this loader did not keep. Every other field here is checked; this
+    // one is the reason to check the values too, since it is the only field
+    // whose contents are forwarded verbatim to an inspector.
+    if (raw.metadata !== undefined) {
+        const m = raw.metadata;
+        if (typeof m !== 'object' || m === null || Array.isArray(m)) {
+            diagnostics.push({
+                code: 'invalid_config',
+                severity: 'error',
+                message: `agent.ts: "metadata" must be an object of string values, received ${Array.isArray(m) ? 'array' : typeof m}.`,
+                path,
+            });
+        }
+        else {
+            const bad = Object.entries(m).filter(([, v]) => typeof v !== 'string');
+            if (bad.length > 0) {
+                diagnostics.push({
+                    code: 'invalid_config',
+                    severity: 'error',
+                    message: `agent.ts: "metadata" values must be strings; ${bad
+                        .map(([k, v]) => `"${k}" is ${v === null ? 'null' : typeof v}`)
+                        .join(', ')}.`,
+                    path,
+                });
+            }
+            else {
+                config.metadata = m;
+            }
+        }
+    }
+    return config;
+}
+/**
+ * Read a conventional agent directory into typed, inspectable definitions.
+ *
+ * A LOADER, not a runner: it produces what is there and hands it back. Running
+ * it — a turn, a server, a schedule — is the host's job, which is what keeps
+ * this package free of any hosting model.
+ *
+ * It never throws on authored content. A broken tool, a missing file, a
+ * malformed config all come back as diagnostics, because a loader that throws
+ * on the first bad file tells you about one problem when you wanted the list.
+ */
+export async function loadDirectory(dir, options = {}) {
+    return loadAt(dir, options, 0);
+}
+/**
+ * Depth 0 is the project the caller named; 1 is a delegate it declares.
+ *
+ * A delegate does not get delegates of its own. The cap is a real decision,
+ * not a missing feature: unbounded nesting is a topology question — who may
+ * spawn whom, and how deep a run may fan out — and answering it by default is
+ * how a directory layout ends up deciding a system's shape. It also removes
+ * the cycle: `agents/a/agents/b/agents/a` cannot be built if the second level
+ * is never read.
+ */
+const MAX_DEPTH = 1;
+async function loadAt(dir, options, depth) {
+    if (typeof dir !== 'string' || dir.length === 0) {
+        throw new TypeError('loadDirectory(dir): dir must be a non-empty string.');
+    }
+    const modules = options.modules ?? 'evaluate';
+    const importModule = options.importModule ?? ((url) => import(url));
+    const timeoutMs = options.moduleTimeoutMs ?? DEFAULT_MODULE_TIMEOUT_MS;
+    // `?? ALL_SLOTS`, never `|| ALL_SLOTS`: an empty list means "scan nothing",
+    // which is the closed reading of an allow-list. The tuple type keeps a
+    // TypeScript caller from writing it at all.
+    const included = options.include ?? ALL_SLOTS;
+    const diagnostics = [];
+    const sources = [];
+    const tools = [];
+    const skills = [];
+    const agents = [];
+    let config = {};
+    let instructions = '';
+    const root = await canonicalRoot(dir);
+    if (!root) {
+        diagnostics.push({
+            code: 'root_missing',
+            severity: 'error',
+            message: `No directory at ${dir}.`,
+        });
+        return {
+            manifest: {
+                root: dir,
+                name: 'agent',
+                instructions: '',
+                config: {},
+                tools: [],
+                skills: [],
+                agents: [],
+                sources: [],
+                included,
+                modules,
+            },
+            diagnostics,
+            ok: false,
+        };
+    }
+    const record = (file, slot, outcome) => {
+        const ref = { ...file, slot, outcome };
+        sources.push(ref);
+        return ref;
+    };
+    // ─── instructions ─────────────────────────────────────────────────────
+    if (included.includes('instructions')) {
+        try {
+            const body = await readFile(`${root}/instructions.md`, 'utf8');
+            instructions = body.trimEnd();
+            if (instructions.length === 0) {
+                // Asymmetric on purpose: an absent file is a choice, a present
+                // file that says nothing is a mistake.
+                diagnostics.push({
+                    code: 'instructions_empty',
+                    severity: 'error',
+                    message: 'instructions.md exists but is empty.',
+                    path: `${root}/instructions.md`,
+                });
+            }
+            record({
+                path: `${root}/instructions.md`,
+                relativePath: 'instructions.md',
+                id: 'instructions',
+            }, 'instructions', 'loaded');
+        }
+        catch {
+            // A warning, not an error: `runAgent` treats instructions as fully
+            // optional, and this package does not get to overrule the kernel
+            // about what a valid agent is.
+            diagnostics.push({
+                code: 'instructions_missing',
+                severity: 'warning',
+                message: 'No instructions.md. The agent will run without a system prompt.',
+            });
+        }
+    }
+    // ─── agent.ts ─────────────────────────────────────────────────────────
+    if (included.includes('agent')) {
+        const found = (await scanSlot(root, 'agent', '.')).files.find((f) => f.id === 'agent');
+        if (found) {
+            if (modules === 'skip') {
+                record(found, 'agent', 'not_loaded');
+            }
+            else {
+                const outcome = await importWithDeadline(pathToFileURL(found.path).href, importModule, timeoutMs);
+                if (outcome.status === 'loaded') {
+                    config = readConfig(defaultExport(outcome.module), diagnostics, found.path);
+                    record(found, 'agent', 'loaded');
+                }
+                else if (outcome.status === 'abandoned') {
+                    diagnostics.push({
+                        code: 'module_load_abandoned',
+                        severity: 'error',
+                        message: `agent.ts did not finish importing within ${timeoutMs}ms. The import was not cancelled and may still complete.`,
+                        path: found.path,
+                    });
+                    record(found, 'agent', 'abandoned');
+                }
+                else {
+                    diagnostics.push({
+                        code: 'module_load_failed',
+                        severity: 'error',
+                        message: 'agent.ts could not be imported.',
+                        path: found.path,
+                        cause: explainImportFailure(outcome.cause, outcome.code),
+                    });
+                    record(found, 'agent', 'failed');
+                }
+            }
+        }
+    }
+    // ─── tools ────────────────────────────────────────────────────────────
+    if (included.includes('tools')) {
+        const scan = await scanSlot(root, 'tools', 'tools');
+        diagnostics.push(...scan.diagnostics);
+        const seen = new Map();
+        for (const file of scan.files) {
+            if (modules === 'skip') {
+                record(file, 'tools', 'not_loaded');
+                continue;
+            }
+            const outcome = await importWithDeadline(pathToFileURL(file.path).href, importModule, timeoutMs);
+            if (outcome.status === 'abandoned') {
+                diagnostics.push({
+                    code: 'module_load_abandoned',
+                    severity: 'error',
+                    message: `${file.relativePath} did not finish importing within ${timeoutMs}ms. The import was not cancelled and may still complete.`,
+                    path: file.path,
+                });
+                record(file, 'tools', 'abandoned');
+                continue;
+            }
+            if (outcome.status === 'failed') {
+                diagnostics.push({
+                    code: 'module_load_failed',
+                    severity: 'error',
+                    message: `${file.relativePath} could not be imported.`,
+                    path: file.path,
+                    cause: explainImportFailure(outcome.cause, outcome.code),
+                });
+                record(file, 'tools', 'failed');
+                continue;
+            }
+            const exported = defaultExport(outcome.module);
+            if (exported === undefined) {
+                diagnostics.push({
+                    code: 'no_default_export',
+                    severity: 'error',
+                    message: `${file.relativePath} has no default export. A tool file default-exports the result of defineTool().`,
+                    path: file.path,
+                });
+                record(file, 'tools', 'failed');
+                continue;
+            }
+            if (!isToolDefinition(exported)) {
+                diagnostics.push({
+                    code: 'not_a_tool',
+                    severity: 'error',
+                    message: `${file.relativePath} default-exports something that is not a tool definition (needs a "name" and an "execute").`,
+                    path: file.path,
+                });
+                record(file, 'tools', 'failed');
+                continue;
+            }
+            const previous = seen.get(exported.name);
+            if (previous) {
+                // Refuse both rather than let one win. A registry would warn and
+                // overwrite; here the author has two files claiming one name and
+                // picking either silently is the thing that hides the mistake.
+                diagnostics.push({
+                    code: 'duplicate_tool_name',
+                    severity: 'error',
+                    message: `Two tools both call themselves "${exported.name}": ${previous} and ${file.relativePath}. Neither was registered.`,
+                    path: file.path,
+                });
+                record(file, 'tools', 'failed');
+                continue;
+            }
+            seen.set(exported.name, file.relativePath);
+            tools.push({
+                source: record(file, 'tools', 'loaded'),
+                definition: exported,
+            });
+        }
+    }
+    // ─── skills ───────────────────────────────────────────────────────────
+    if (included.includes('skills')) {
+        const scan = await scanSlot(root, 'skills', 'skills');
+        diagnostics.push(...scan.diagnostics);
+        for (const file of scan.files) {
+            try {
+                // Delegated, not reimplemented. `Skill.dirPath` is required and
+                // the prompt assembler renders `<location>{dirPath}/SKILL.md`,
+                // so a flat `skills/*.md` would produce a skill the model is
+                // told to read at a path that does not exist. Directory form is
+                // the only form that survives to runtime.
+                // `loadSkill` returns a result wrapper; the Skill is inside it.
+                const { skill } = await loadSkill(file.path);
+                skills.push({ source: record(file, 'skills', 'loaded'), skill });
+            }
+            catch (err) {
+                diagnostics.push({
+                    code: 'skill_load_failed',
+                    severity: 'error',
+                    message: `${file.relativePath} is not a readable skill.`,
+                    path: file.path,
+                    cause: err instanceof Error ? err.message : String(err),
+                });
+                record(file, 'skills', 'failed');
+            }
+        }
+    }
+    // ─── agents (delegates) ───────────────────────────────────────────────
+    if (included.includes('agents')) {
+        const scan = await scanSlot(root, 'agents', 'agents');
+        diagnostics.push(...scan.diagnostics);
+        for (const entry of scan.files) {
+            if (depth >= MAX_DEPTH) {
+                diagnostics.push({
+                    code: 'subagent_too_deep',
+                    severity: 'warning',
+                    message: entry.relativePath +
+                        ' was not loaded: a delegate may not declare delegates of its own.',
+                    path: entry.path,
+                });
+                record(entry, 'agents', 'skipped');
+                continue;
+            }
+            const child = await loadAt(entry.path, options, depth + 1);
+            // The child's diagnostics are the parent's. A delegate that could
+            // not load is a fact about THIS project, and a caller reading one
+            // list should not have to walk the tree to find out the run will be
+            // short a specialist.
+            for (const d of child.diagnostics) {
+                diagnostics.push({ ...d, message: entry.relativePath + ': ' + d.message });
+            }
+            if (!child.ok) {
+                record(entry, 'agents', 'failed');
+                continue;
+            }
+            agents.push({
+                source: record(entry, 'agents', 'loaded'),
+                manifest: child.manifest,
+                id: entry.id,
+            });
+        }
+    }
+    const name = config.name ?? basenameOf(root);
+    return {
+        manifest: {
+            root,
+            name,
+            instructions,
+            config,
+            tools,
+            skills,
+            agents,
+            sources,
+            included,
+            modules,
+        },
+        diagnostics,
+        ok: diagnostics.every((d) => d.severity !== 'error'),
+    };
+}
+/** Basename, with the filesystem root falling back to a usable label. */
+function basenameOf(root) {
+    const parts = root.split(/[\\/]/).filter(Boolean);
+    return parts[parts.length - 1] ?? 'agent';
+}
+//# sourceMappingURL=load.js.map

package/dist/directory/load.js.map

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

package/dist/directory/scan.d.ts

@@ -0,0 +1,36 @@
+import type { DirectoryDiagnostic, DirectorySlot } from './types.js';
+export interface ScannedFile {
+    readonly path: string;
+    readonly relativePath: string;
+    readonly id: string;
+}
+export interface ScanResult {
+    readonly files: readonly ScannedFile[];
+    readonly diagnostics: readonly DirectoryDiagnostic[];
+}
+/**
+ * List the code files directly inside one slot directory.
+ *
+ * **Symlinks are refused, not followed.** A directory handed to this loader is
+ * caller-supplied, and a link inside it pointing anywhere else is the
+ * link-following weakness (CWE-59) with the loader as the vehicle: the file
+ * that gets imported is not the file that was listed. The estate already
+ * decided this for its filesystem tools; the same rule applies to a directory
+ * whose author may not be the host.
+ *
+ * That is stricter than the SDK's own `discoverSkills`, and deliberately so —
+ * that function walks a host's own trusted tree, where following a link is a
+ * convenience rather than a hole. Reusing it here would have inherited a
+ * threat model chosen for a different caller.
+ *
+ * Only the top level is read. A nested directory is reported so an author
+ * learns their file was not picked up, except when its name starts with `.`
+ * or `_`, which is the conventional way to say "not for you" and is honoured
+ * silently.
+ */
+export declare function scanSlot(root: string, slot: DirectorySlot, dirName: string): Promise<ScanResult>;
+/** Canonical absolute root, or undefined when the directory does not exist. */
+export declare function canonicalRoot(dir: string): Promise<string | undefined>;
+/** Posix-normalised, for a `relativePath` that reads the same on every platform. */
+export declare function toPosix(value: string): string;
+//# sourceMappingURL=scan.d.ts.map

package/dist/directory/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../src/directory/scan.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAKpE,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAA;IACtC,QAAQ,CAAC,WAAW,EAAE,SAAS,mBAAmB,EAAE,CAAA;CACpD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,QAAQ,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,MAAM,GACb,OAAO,CAAC,UAAU,CAAC,CAoGrB;AAED,+EAA+E;AAC/E,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAQ5E;AAED,oFAAoF;AACpF,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7C"}