@namzu/sdk 5.0.0 → 5.2.0

package/dist/contracts/a2a.d.ts

@@ -60,13 +60,13 @@ export declare const DataPartSchema: z.ZodObject<{
     mimeType: z.ZodOptional<z.ZodString>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strict", z.ZodTypeAny, {
-    kind: "data";
     data: Record<string, unknown>;
+    kind: "data";
     metadata?: Record<string, unknown> | undefined;
     mimeType?: string | undefined;
 }, {
-    kind: "data";
     data: Record<string, unknown>;
+    kind: "data";
     metadata?: Record<string, unknown> | undefined;
     mimeType?: string | undefined;
 }>;
@@ -125,13 +125,13 @@ export declare const A2APartSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject
     mimeType: z.ZodOptional<z.ZodString>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strict", z.ZodTypeAny, {
-    kind: "data";
     data: Record<string, unknown>;
+    kind: "data";
     metadata?: Record<string, unknown> | undefined;
     mimeType?: string | undefined;
 }, {
-    kind: "data";
     data: Record<string, unknown>;
+    kind: "data";
     metadata?: Record<string, unknown> | undefined;
     mimeType?: string | undefined;
 }>]>;
@@ -192,13 +192,13 @@ export declare const A2AMessageSchema: z.ZodObject<{
         mimeType: z.ZodOptional<z.ZodString>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strict", z.ZodTypeAny, {
-        kind: "data";
         data: Record<string, unknown>;
+        kind: "data";
         metadata?: Record<string, unknown> | undefined;
         mimeType?: string | undefined;
     }, {
-        kind: "data";
         data: Record<string, unknown>;
+        kind: "data";
         metadata?: Record<string, unknown> | undefined;
         mimeType?: string | undefined;
     }>]>, "many">;
@@ -219,8 +219,8 @@ export declare const A2AMessageSchema: z.ZodObject<{
         };
         metadata?: Record<string, unknown> | undefined;
     } | {
-        kind: "data";
         data: Record<string, unknown>;
+        kind: "data";
         metadata?: Record<string, unknown> | undefined;
         mimeType?: string | undefined;
     })[];
@@ -241,8 +241,8 @@ export declare const A2AMessageSchema: z.ZodObject<{
         };
         metadata?: Record<string, unknown> | undefined;
     } | {
-        kind: "data";
         data: Record<string, unknown>;
+        kind: "data";
         metadata?: Record<string, unknown> | undefined;
         mimeType?: string | undefined;
     })[];
@@ -307,13 +307,13 @@ export declare const A2ATaskStatusSchema: z.ZodObject<{
             mimeType: z.ZodOptional<z.ZodString>;
             metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, "strict", z.ZodTypeAny, {
-            kind: "data";
             data: Record<string, unknown>;
+            kind: "data";
             metadata?: Record<string, unknown> | undefined;
             mimeType?: string | undefined;
         }, {
-            kind: "data";
             data: Record<string, unknown>;
+            kind: "data";
             metadata?: Record<string, unknown> | undefined;
             mimeType?: string | undefined;
         }>]>, "many">;
@@ -334,8 +334,8 @@ export declare const A2ATaskStatusSchema: z.ZodObject<{
             };
             metadata?: Record<string, unknown> | undefined;
         } | {
-            kind: "data";
             data: Record<string, unknown>;
+            kind: "data";
             metadata?: Record<string, unknown> | undefined;
             mimeType?: string | undefined;
         })[];
@@ -356,8 +356,8 @@ export declare const A2ATaskStatusSchema: z.ZodObject<{
             };
             metadata?: Record<string, unknown> | undefined;
         } | {
-            kind: "data";
             data: Record<string, unknown>;
+            kind: "data";
             metadata?: Record<string, unknown> | undefined;
             mimeType?: string | undefined;
         })[];
@@ -382,8 +382,8 @@ export declare const A2ATaskStatusSchema: z.ZodObject<{
             };
             metadata?: Record<string, unknown> | undefined;
         } | {
-            kind: "data";
             data: Record<string, unknown>;
+            kind: "data";
             metadata?: Record<string, unknown> | undefined;
             mimeType?: string | undefined;
         })[];
@@ -408,8 +408,8 @@ export declare const A2ATaskStatusSchema: z.ZodObject<{
             };
             metadata?: Record<string, unknown> | undefined;
         } | {
-            kind: "data";
             data: Record<string, unknown>;
+            kind: "data";
             metadata?: Record<string, unknown> | undefined;
             mimeType?: string | undefined;
         })[];
@@ -476,13 +476,13 @@ export declare const A2AArtifactSchema: z.ZodObject<{
         mimeType: z.ZodOptional<z.ZodString>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strict", z.ZodTypeAny, {
-        kind: "data";
         data: Record<string, unknown>;
+        kind: "data";
         metadata?: Record<string, unknown> | undefined;
         mimeType?: string | undefined;
     }, {
-        kind: "data";
         data: Record<string, unknown>;
+        kind: "data";
         metadata?: Record<string, unknown> | undefined;
         mimeType?: string | undefined;
     }>]>, "many">;
@@ -502,8 +502,8 @@ export declare const A2AArtifactSchema: z.ZodObject<{
         };
         metadata?: Record<string, unknown> | undefined;
     } | {
-        kind: "data";
         data: Record<string, unknown>;
+        kind: "data";
         metadata?: Record<string, unknown> | undefined;
         mimeType?: string | undefined;
     })[];
@@ -526,8 +526,8 @@ export declare const A2AArtifactSchema: z.ZodObject<{
         };
         metadata?: Record<string, unknown> | undefined;
     } | {
-        kind: "data";
         data: Record<string, unknown>;
+        kind: "data";
         metadata?: Record<string, unknown> | undefined;
         mimeType?: string | undefined;
     })[];
@@ -594,13 +594,13 @@ export declare const A2AMessageSendSchema: z.ZodObject<{
             mimeType: z.ZodOptional<z.ZodString>;
             metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, "strict", z.ZodTypeAny, {
-            kind: "data";
             data: Record<string, unknown>;
+            kind: "data";
             metadata?: Record<string, unknown> | undefined;
             mimeType?: string | undefined;
         }, {
-            kind: "data";
             data: Record<string, unknown>;
+            kind: "data";
             metadata?: Record<string, unknown> | undefined;
             mimeType?: string | undefined;
         }>]>, "many">;
@@ -621,8 +621,8 @@ export declare const A2AMessageSendSchema: z.ZodObject<{
             };
             metadata?: Record<string, unknown> | undefined;
         } | {
-            kind: "data";
             data: Record<string, unknown>;
+            kind: "data";
             metadata?: Record<string, unknown> | undefined;
             mimeType?: string | undefined;
         })[];
@@ -643,8 +643,8 @@ export declare const A2AMessageSendSchema: z.ZodObject<{
             };
             metadata?: Record<string, unknown> | undefined;
         } | {
-            kind: "data";
             data: Record<string, unknown>;
+            kind: "data";
             metadata?: Record<string, unknown> | undefined;
             mimeType?: string | undefined;
         })[];
@@ -670,8 +670,8 @@ export declare const A2AMessageSendSchema: z.ZodObject<{
             };
             metadata?: Record<string, unknown> | undefined;
         } | {
-            kind: "data";
             data: Record<string, unknown>;
+            kind: "data";
             metadata?: Record<string, unknown> | undefined;
             mimeType?: string | undefined;
         })[];
@@ -697,8 +697,8 @@ export declare const A2AMessageSendSchema: z.ZodObject<{
             };
             metadata?: Record<string, unknown> | undefined;
         } | {
-            kind: "data";
             data: Record<string, unknown>;
+            kind: "data";
             metadata?: Record<string, unknown> | undefined;
             mimeType?: string | undefined;
         })[];
@@ -803,13 +803,13 @@ export declare const A2ATaskSchema: z.ZodObject<{
                 mimeType: z.ZodOptional<z.ZodString>;
                 metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             }, "strict", z.ZodTypeAny, {
-                kind: "data";
                 data: Record<string, unknown>;
+                kind: "data";
                 metadata?: Record<string, unknown> | undefined;
                 mimeType?: string | undefined;
             }, {
-                kind: "data";
                 data: Record<string, unknown>;
+                kind: "data";
                 metadata?: Record<string, unknown> | undefined;
                 mimeType?: string | undefined;
             }>]>, "many">;
@@ -830,8 +830,8 @@ export declare const A2ATaskSchema: z.ZodObject<{
                 };
                 metadata?: Record<string, unknown> | undefined;
             } | {
-                kind: "data";
                 data: Record<string, unknown>;
+                kind: "data";
                 metadata?: Record<string, unknown> | undefined;
                 mimeType?: string | undefined;
             })[];
@@ -852,8 +852,8 @@ export declare const A2ATaskSchema: z.ZodObject<{
                 };
                 metadata?: Record<string, unknown> | undefined;
             } | {
-                kind: "data";
                 data: Record<string, unknown>;
+                kind: "data";
                 metadata?: Record<string, unknown> | undefined;
                 mimeType?: string | undefined;
             })[];
@@ -878,8 +878,8 @@ export declare const A2ATaskSchema: z.ZodObject<{
                 };
                 metadata?: Record<string, unknown> | undefined;
             } | {
-                kind: "data";
                 data: Record<string, unknown>;
+                kind: "data";
                 metadata?: Record<string, unknown> | undefined;
                 mimeType?: string | undefined;
             })[];
@@ -904,8 +904,8 @@ export declare const A2ATaskSchema: z.ZodObject<{
                 };
                 metadata?: Record<string, unknown> | undefined;
             } | {
-                kind: "data";
                 data: Record<string, unknown>;
+                kind: "data";
                 metadata?: Record<string, unknown> | undefined;
                 mimeType?: string | undefined;
             })[];
@@ -970,13 +970,13 @@ export declare const A2ATaskSchema: z.ZodObject<{
             mimeType: z.ZodOptional<z.ZodString>;
             metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, "strict", z.ZodTypeAny, {
-            kind: "data";
             data: Record<string, unknown>;
+            kind: "data";
             metadata?: Record<string, unknown> | undefined;
             mimeType?: string | undefined;
         }, {
-            kind: "data";
             data: Record<string, unknown>;
+            kind: "data";
             metadata?: Record<string, unknown> | undefined;
             mimeType?: string | undefined;
         }>]>, "many">;
@@ -997,8 +997,8 @@ export declare const A2ATaskSchema: z.ZodObject<{
             };
             metadata?: Record<string, unknown> | undefined;
         } | {
-            kind: "data";
             data: Record<string, unknown>;
+            kind: "data";
             metadata?: Record<string, unknown> | undefined;
             mimeType?: string | undefined;
         })[];
@@ -1019,8 +1019,8 @@ export declare const A2ATaskSchema: z.ZodObject<{
             };
             metadata?: Record<string, unknown> | undefined;
         } | {
-            kind: "data";
             data: Record<string, unknown>;
+            kind: "data";
             metadata?: Record<string, unknown> | undefined;
             mimeType?: string | undefined;
         })[];
@@ -1085,13 +1085,13 @@ export declare const A2ATaskSchema: z.ZodObject<{
             mimeType: z.ZodOptional<z.ZodString>;
             metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, "strict", z.ZodTypeAny, {
-            kind: "data";
             data: Record<string, unknown>;
+            kind: "data";
             metadata?: Record<string, unknown> | undefined;
             mimeType?: string | undefined;
         }, {
-            kind: "data";
             data: Record<string, unknown>;
+            kind: "data";
             metadata?: Record<string, unknown> | undefined;
             mimeType?: string | undefined;
         }>]>, "many">;
@@ -1111,8 +1111,8 @@ export declare const A2ATaskSchema: z.ZodObject<{
             };
             metadata?: Record<string, unknown> | undefined;
         } | {
-            kind: "data";
             data: Record<string, unknown>;
+            kind: "data";
             metadata?: Record<string, unknown> | undefined;
             mimeType?: string | undefined;
         })[];
@@ -1135,8 +1135,8 @@ export declare const A2ATaskSchema: z.ZodObject<{
             };
             metadata?: Record<string, unknown> | undefined;
         } | {
-            kind: "data";
             data: Record<string, unknown>;
+            kind: "data";
             metadata?: Record<string, unknown> | undefined;
             mimeType?: string | undefined;
         })[];
@@ -1165,8 +1165,8 @@ export declare const A2ATaskSchema: z.ZodObject<{
                 };
                 metadata?: Record<string, unknown> | undefined;
             } | {
-                kind: "data";
                 data: Record<string, unknown>;
+                kind: "data";
                 metadata?: Record<string, unknown> | undefined;
                 mimeType?: string | undefined;
             })[];
@@ -1193,8 +1193,8 @@ export declare const A2ATaskSchema: z.ZodObject<{
             };
             metadata?: Record<string, unknown> | undefined;
         } | {
-            kind: "data";
             data: Record<string, unknown>;
+            kind: "data";
             metadata?: Record<string, unknown> | undefined;
             mimeType?: string | undefined;
         })[];
@@ -1215,8 +1215,8 @@ export declare const A2ATaskSchema: z.ZodObject<{
             };
             metadata?: Record<string, unknown> | undefined;
         } | {
-            kind: "data";
             data: Record<string, unknown>;
+            kind: "data";
             metadata?: Record<string, unknown> | undefined;
             mimeType?: string | undefined;
         })[];
@@ -1244,8 +1244,8 @@ export declare const A2ATaskSchema: z.ZodObject<{
                 };
                 metadata?: Record<string, unknown> | undefined;
             } | {
-                kind: "data";
                 data: Record<string, unknown>;
+                kind: "data";
                 metadata?: Record<string, unknown> | undefined;
                 mimeType?: string | undefined;
             })[];
@@ -1272,8 +1272,8 @@ export declare const A2ATaskSchema: z.ZodObject<{
             };
             metadata?: Record<string, unknown> | undefined;
         } | {
-            kind: "data";
             data: Record<string, unknown>;
+            kind: "data";
             metadata?: Record<string, unknown> | undefined;
             mimeType?: string | undefined;
         })[];
@@ -1294,8 +1294,8 @@ export declare const A2ATaskSchema: z.ZodObject<{
             };
             metadata?: Record<string, unknown> | undefined;
         } | {
-            kind: "data";
             data: Record<string, unknown>;
+            kind: "data";
             metadata?: Record<string, unknown> | undefined;
             mimeType?: string | undefined;
         })[];

package/dist/directory/__tests__/derive.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=derive.test.d.ts.map

package/dist/directory/__tests__/derive.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.test.d.ts","sourceRoot":"","sources":["../../../src/directory/__tests__/derive.test.ts"],"names":[],"mappings":""}

package/dist/directory/__tests__/derive.test.js

@@ -0,0 +1,111 @@
+import { mkdirSync, mkdtempSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { deriveRunOptions } from '../derive.js';
+import { loadDirectory } from '../load.js';
+const provider = { id: 'mock', name: 'Mock' };
+function project(files) {
+    const root = mkdtempSync(join(tmpdir(), 'namzu-derive-'));
+    for (const [relative, body] of Object.entries(files)) {
+        const full = join(root, relative);
+        mkdirSync(join(full, '..'), { recursive: true });
+        writeFileSync(full, body);
+    }
+    return root;
+}
+const TOOL = (name) => `
+export default {
+  name: ${JSON.stringify(name)},
+  description: 'a tool',
+  inputSchema: { parse: (v) => v, safeParse: (v) => ({ success: true, data: v }) },
+  execute: async () => ({ success: true, output: 'ok' }),
+}
+`;
+describe('turning a manifest into run options', () => {
+    it('carries instructions, config and tools across', async () => {
+        const root = project({
+            'instructions.md': 'You are terse.',
+            'agent.js': 'export default { model: "m", maxIterations: 3 }',
+            'tools/a.js': TOOL('a'),
+        });
+        const { manifest } = await loadDirectory(root);
+        const options = deriveRunOptions(manifest, { provider, prompt: 'hi' });
+        expect(options.model).toBe('m');
+        expect(options.instructions).toBe('You are terse.');
+        expect(options.maxIterations).toBe(3);
+        expect(options.tools?.has('a')).toBe(true);
+    });
+    it('points the working directory at the project, not the host', async () => {
+        // Left unset this defaults to the host's cwd, which aims the file
+        // tools' containment at the host's own source tree.
+        const root = project({
+            'instructions.md': 'hi',
+            'agent.js': 'export default { model: "m" }',
+        });
+        const { manifest } = await loadDirectory(root);
+        expect(deriveRunOptions(manifest, { provider, prompt: 'hi' }).workingDirectory).toBe(manifest.root);
+    });
+    it('lets an explicit model win over agent.ts', async () => {
+        const root = project({
+            'instructions.md': 'hi',
+            'agent.js': 'export default { model: "from-file" }',
+        });
+        const { manifest } = await loadDirectory(root);
+        expect(deriveRunOptions(manifest, { provider, prompt: 'hi', model: 'explicit' }).model).toBe('explicit');
+    });
+    it('refuses when nothing names a model', async () => {
+        const root = project({ 'instructions.md': 'hi' });
+        const { manifest } = await loadDirectory(root);
+        expect(() => deriveRunOptions(manifest, { provider, prompt: 'hi' })).toThrow(/No model/);
+    });
+    it('forwards a name only when agent.ts declared one', async () => {
+        // A name guessed from a directory basename becomes the agent id in
+        // traces, where two sibling projects both called `agent` merge into one
+        // attribution bucket.
+        const declared = project({
+            'instructions.md': 'hi',
+            'agent.js': 'export default { model: "m", name: "researcher" }',
+        });
+        const guessed = project({
+            'instructions.md': 'hi',
+            'agent.js': 'export default { model: "m" }',
+        });
+        const withName = deriveRunOptions((await loadDirectory(declared)).manifest, {
+            provider,
+            prompt: 'x',
+        });
+        const without = deriveRunOptions((await loadDirectory(guessed)).manifest, {
+            provider,
+            prompt: 'x',
+        });
+        expect(withName.name).toBe('researcher');
+        expect(without.name).toBeUndefined();
+    });
+    it('refuses a manifest whose modules were never loaded', async () => {
+        // `manifest.tools` is empty for a reason that has nothing to do with
+        // the project. Running it would produce an agent with no capabilities
+        // and no indication why.
+        const root = project({
+            'instructions.md': 'hi',
+            'agent.js': 'export default { model: "m" }',
+            'tools/a.js': TOOL('a'),
+        });
+        const { manifest } = await loadDirectory(root, { modules: 'skip' });
+        expect(() => deriveRunOptions(manifest, { provider, prompt: 'hi' })).toThrow(/modules: "skip"/);
+    });
+    it('lets overrides win over everything', async () => {
+        const root = project({
+            'instructions.md': 'hi',
+            'agent.js': 'export default { model: "m", maxIterations: 3 }',
+        });
+        const { manifest } = await loadDirectory(root);
+        const options = deriveRunOptions(manifest, {
+            provider,
+            prompt: 'hi',
+            overrides: { maxIterations: 99 },
+        });
+        expect(options.maxIterations).toBe(99);
+    });
+});
+//# sourceMappingURL=derive.test.js.map

package/dist/directory/__tests__/derive.test.js.map

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

package/dist/directory/__tests__/load-diagnostics.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=load-diagnostics.test.d.ts.map

package/dist/directory/__tests__/load-diagnostics.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-diagnostics.test.d.ts","sourceRoot":"","sources":["../../../src/directory/__tests__/load-diagnostics.test.ts"],"names":[],"mappings":""}

package/dist/directory/__tests__/load-diagnostics.test.js

@@ -0,0 +1,106 @@
+import { mkdirSync, mkdtempSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { loadDirectory } from '../load.js';
+/**
+ * Three refusals this loader claimed to make and did not.
+ *
+ * Each is the same shape: a check that existed, read the wrong thing, and
+ * therefore reported the wrong answer while looking correct in review. A
+ * loader whose entire job is to say what is wrong with a directory has to be
+ * held to the diagnostics it actually emits, not the ones its code appears to
+ * emit.
+ */
+function project(files) {
+    const root = mkdtempSync(join(tmpdir(), 'namzu-diag-'));
+    for (const [relative, body] of Object.entries(files)) {
+        const full = join(root, relative);
+        mkdirSync(join(full, '..'), { recursive: true });
+        writeFileSync(full, body);
+    }
+    return root;
+}
+describe('a tool that would crash later is refused now', () => {
+    it('rejects a default export with no inputSchema', async () => {
+        // `name` and `execute` alone used to pass. The object then registered
+        // clean and died in `toLLMTools()` on `inputSchema._def` — a TypeError
+        // naming neither this file nor this loader.
+        const root = project({
+            'tools/broken.js': `
+export default {
+  name: 'broken',
+  description: 'no schema',
+  execute: async () => ({ success: true }),
+}
+`,
+        });
+        const { manifest, diagnostics, ok } = await loadDirectory(root);
+        expect(ok).toBe(false);
+        expect(diagnostics.map((d) => d.code)).toContain('not_a_tool');
+        expect(manifest.tools).toHaveLength(0);
+    });
+    it('still accepts a hand-written tool that satisfies the published type', async () => {
+        // The required set and no more: demanding `defineTool`'s extras would
+        // make this loader refuse an object the SDK's own type accepts.
+        const root = project({
+            'tools/fine.js': `
+export default {
+  name: 'fine',
+  description: 'a tool',
+  inputSchema: { parse: (v) => v },
+  execute: async () => ({ success: true }),
+}
+`,
+        });
+        const { manifest, ok } = await loadDirectory(root);
+        expect(ok).toBe(true);
+        expect(manifest.tools).toHaveLength(1);
+    });
+});
+describe('an import failure explains itself', () => {
+    it('gives the extension hint for a module it cannot resolve', async () => {
+        // The hint is chosen from Node's error CODE. It used to be matched
+        // against the message, which never contains the code, so every hint in
+        // the function was unreachable and every author got the bare error.
+        const root = project({
+            'tools/importer.js': `
+import './nowhere-at-all.js'
+export default { name: 'x', description: 'x', inputSchema: {}, execute: async () => ({}) }
+`,
+        });
+        const { diagnostics } = await loadDirectory(root);
+        const failed = diagnostics.find((d) => d.code === 'module_load_failed');
+        expect(failed).toBeDefined();
+        expect(failed?.cause).toContain('real extension');
+    });
+});
+describe('agent.ts metadata is checked, not assumed', () => {
+    it('refuses metadata values that are not strings', async () => {
+        // Typed `Record<string, string>` and admitted on `typeof === 'object'`,
+        // so the values were never looked at and the type was a promise this
+        // loader did not keep.
+        const root = project({
+            'agent.js': 'export default { model: "m", metadata: { count: 1 } }',
+        });
+        const { diagnostics, ok } = await loadDirectory(root);
+        expect(ok).toBe(false);
+        expect(diagnostics.some((d) => d.code === 'invalid_config')).toBe(true);
+    });
+    it('refuses an array, which typeof calls an object', async () => {
+        const root = project({
+            'agent.js': 'export default { model: "m", metadata: ["a", "b"] }',
+        });
+        const { ok } = await loadDirectory(root);
+        expect(ok).toBe(false);
+    });
+    it('accepts a metadata object of strings', async () => {
+        const root = project({
+            'agent.js': 'export default { model: "m", metadata: { team: "core" } }',
+        });
+        const { manifest, ok } = await loadDirectory(root);
+        expect(ok).toBe(true);
+        expect(manifest.config.metadata).toEqual({ team: 'core' });
+    });
+});
+//# sourceMappingURL=load-diagnostics.test.js.map

package/dist/directory/__tests__/load-diagnostics.test.js.map

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

package/dist/directory/__tests__/load-directory.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=load-directory.test.d.ts.map

package/dist/directory/__tests__/load-directory.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-directory.test.d.ts","sourceRoot":"","sources":["../../../src/directory/__tests__/load-directory.test.ts"],"names":[],"mappings":""}