@inkeep/create-agents 0.0.0-dev-20260224200401 → 0.0.0-dev-20260225021710

package/dist/__tests__/utils.test.js

@@ -494,6 +494,10 @@ describe('syncTemplateDependencies', () => {
     }
     beforeEach(() => {
         vi.clearAllMocks();
+        vi.stubGlobal('fetch', vi.fn().mockRejectedValue(new Error('no network in tests')));
+    });
+    afterEach(() => {
+        vi.unstubAllGlobals();
     });
     it('should update @inkeep/* dependencies to match CLI version', async () => {
         const mockPkg = {
@@ -588,21 +592,127 @@ describe('syncTemplateDependencies', () => {
             },
         }), { spaces: 2 });
     });
-    it('should not update excluded packages like @inkeep/agents-ui', async () => {
+    it('should resolve @inkeep/agents-ui version from npm registry', async () => {
+        const mockFetch = vi.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({ version: '0.16.0' }),
+        });
+        vi.stubGlobal('fetch', mockFetch);
         const mockPkg = {
             name: 'test-project',
             dependencies: {
                 '@inkeep/agents-core': '^0.50.3',
-                '@inkeep/agents-ui': '^0.50.3',
+                '@inkeep/agents-ui': '^0.15.12',
                 '@inkeep/agents-sdk': '^0.50.3',
             },
         };
         setupFlatTemplate(mockPkg);
         await syncTemplateDependencies('/test/path');
+        expect(mockFetch).toHaveBeenCalledWith('https://registry.npmjs.org/@inkeep/agents-ui/latest', expect.objectContaining({ signal: expect.any(AbortSignal) }));
+        expect(mockFetch).toHaveBeenCalledTimes(1);
+        expect(fs.writeJson).toHaveBeenCalledWith('/test/path/package.json', expect.objectContaining({
+            dependencies: {
+                '@inkeep/agents-core': '^1.2.3',
+                '@inkeep/agents-ui': '^0.16.0',
+                '@inkeep/agents-sdk': '^1.2.3',
+            },
+        }), { spaces: 2 });
+    });
+    it('should leave divergent package specifier unchanged when registry fetch fails', async () => {
+        const mockFetch = vi.fn().mockRejectedValue(new Error('network error'));
+        vi.stubGlobal('fetch', mockFetch);
+        const mockPkg = {
+            name: 'test-project',
+            dependencies: {
+                '@inkeep/agents-core': '^0.50.3',
+                '@inkeep/agents-ui': '^0.15.12',
+            },
+        };
+        setupFlatTemplate(mockPkg);
+        await syncTemplateDependencies('/test/path');
+        expect(fs.writeJson).toHaveBeenCalledWith('/test/path/package.json', expect.objectContaining({
+            dependencies: {
+                '@inkeep/agents-core': '^1.2.3',
+                '@inkeep/agents-ui': '^0.15.12',
+            },
+        }), { spaces: 2 });
+    });
+    it('should leave divergent package specifier unchanged when registry returns non-ok', async () => {
+        const mockFetch = vi.fn().mockResolvedValue({
+            ok: false,
+            status: 404,
+        });
+        vi.stubGlobal('fetch', mockFetch);
+        const mockPkg = {
+            name: 'test-project',
+            dependencies: {
+                '@inkeep/agents-ui': '^0.15.12',
+            },
+        };
+        setupFlatTemplate(mockPkg);
+        await syncTemplateDependencies('/test/path');
+        expect(fs.writeJson).toHaveBeenCalledWith('/test/path/package.json', expect.objectContaining({
+            dependencies: {
+                '@inkeep/agents-ui': '^0.15.12',
+            },
+        }), { spaces: 2 });
+    });
+    it('should resolve divergent package version in devDependencies from npm registry', async () => {
+        const mockFetch = vi.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({ version: '0.16.0' }),
+        });
+        vi.stubGlobal('fetch', mockFetch);
+        const mockPkg = {
+            name: 'test-project',
+            dependencies: { '@inkeep/agents-core': '^0.50.3' },
+            devDependencies: { '@inkeep/agents-ui': '^0.15.12' },
+        };
+        setupFlatTemplate(mockPkg);
+        await syncTemplateDependencies('/test/path');
+        expect(fs.writeJson).toHaveBeenCalledWith('/test/path/package.json', expect.objectContaining({
+            dependencies: { '@inkeep/agents-core': '^1.2.3' },
+            devDependencies: { '@inkeep/agents-ui': '^0.16.0' },
+        }), { spaces: 2 });
+    });
+    it('should only fetch once when same divergent package appears in multiple files', async () => {
+        const mockFetch = vi.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({ version: '0.16.0' }),
+        });
+        vi.stubGlobal('fetch', mockFetch);
+        const nodeFs = await import('node:fs');
+        vi.mocked(nodeFs.readFileSync).mockReturnValue(JSON.stringify({ version: '1.2.3' }));
+        const rootPkg = {
+            name: 'monorepo',
+            dependencies: { '@inkeep/agents-core': '^0.50.3', '@inkeep/agents-ui': '^0.15.12' },
+        };
+        const nestedPkg = {
+            name: 'nested-app',
+            dependencies: { '@inkeep/agents-ui': '^0.15.12', '@inkeep/agents-sdk': '^0.50.3' },
+        };
+        vi.mocked(fs.pathExists).mockImplementation(async (p) => {
+            const s = String(p);
+            return s === '/test/path/package.json' || s === '/test/path/apps/api/package.json';
+        });
+        vi.mocked(fs.readdir)
+            .mockResolvedValueOnce([mockDirent('apps', true)])
+            .mockResolvedValueOnce([mockDirent('api', true)])
+            .mockResolvedValueOnce([]);
+        vi.mocked(fs.readJson).mockResolvedValueOnce(rootPkg).mockResolvedValueOnce(nestedPkg);
+        vi.mocked(fs.writeJson).mockResolvedValue(undefined);
+        await syncTemplateDependencies('/test/path');
+        expect(mockFetch).toHaveBeenCalledTimes(1);
+        expect(fs.writeJson).toHaveBeenCalledTimes(2);
         expect(fs.writeJson).toHaveBeenCalledWith('/test/path/package.json', expect.objectContaining({
             dependencies: {
                 '@inkeep/agents-core': '^1.2.3',
-                '@inkeep/agents-ui': '^0.50.3',
+                '@inkeep/agents-ui': '^0.16.0',
+            },
+        }), { spaces: 2 });
+        expect(fs.writeJson).toHaveBeenCalledWith('/test/path/apps/api/package.json', expect.objectContaining({
+            dependencies: {
+                '@inkeep/agents-ui': '^0.16.0',
                 '@inkeep/agents-sdk': '^1.2.3',
             },
         }), { spaces: 2 });
@@ -632,23 +742,22 @@ describe('syncTemplateDependencies', () => {
             name: 'nested-app',
             dependencies: { '@inkeep/agents-sdk': '^0.50.3', express: '^4.0.0' },
         };
-        vi.mocked(fs.pathExists).mockResolvedValue(true);
+        vi.mocked(fs.pathExists).mockImplementation(async (p) => {
+            const s = String(p);
+            return s === '/test/path/package.json' || s === '/test/path/apps/api/package.json';
+        });
         vi.mocked(fs.readdir)
             .mockResolvedValueOnce([mockDirent('apps', true), mockDirent('README.md', false)])
             .mockResolvedValueOnce([mockDirent('api', true)])
             .mockResolvedValueOnce([]);
-        vi.mocked(fs.readJson)
-            .mockResolvedValueOnce(rootPkg)
-            .mockResolvedValueOnce(nestedPkg)
-            .mockResolvedValueOnce(nestedPkg);
+        vi.mocked(fs.readJson).mockResolvedValueOnce(rootPkg).mockResolvedValueOnce(nestedPkg);
         vi.mocked(fs.writeJson).mockResolvedValue(undefined);
         await syncTemplateDependencies('/test/path');
-        expect(fs.writeJson).toHaveBeenCalledTimes(3);
+        expect(fs.writeJson).toHaveBeenCalledTimes(2);
         expect(fs.writeJson).toHaveBeenCalledWith('/test/path/package.json', expect.objectContaining({
             dependencies: { '@inkeep/agents-core': '^1.2.3' },
         }), { spaces: 2 });
-        expect(fs.writeJson).toHaveBeenCalledWith(expect.stringContaining('apps/package.json'), expect.anything(), { spaces: 2 });
-        expect(fs.writeJson).toHaveBeenCalledWith(expect.stringContaining('apps/api/package.json'), expect.objectContaining({
+        expect(fs.writeJson).toHaveBeenCalledWith('/test/path/apps/api/package.json', expect.objectContaining({
             dependencies: { '@inkeep/agents-sdk': '^1.2.3', express: '^4.0.0' },
         }), { spaces: 2 });
     });

package/dist/utils.js

@@ -34,6 +34,7 @@ const agentsTemplateRepo = 'https://github.com/inkeep/agents/create-agents-templ
 const projectTemplateRepo = 'https://github.com/inkeep/agents/agents-cookbook/template-projects';
 const execAsync = promisify(exec);
 const agentsApiPort = '3002';
+const DIVERGENT_PACKAGES = new Set(['@inkeep/agents-ui']);
 function getCliVersion() {
     try {
         const __dirname = path.dirname(fileURLToPath(import.meta.url));
@@ -44,19 +45,66 @@ function getCliVersion() {
         return '';
     }
 }
+async function fetchLatestVersion(packageName) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), 10000);
+    try {
+        const response = await fetch(`https://registry.npmjs.org/${packageName}/latest`, {
+            signal: controller.signal,
+        });
+        if (!response.ok)
+            return null;
+        const data = (await response.json());
+        return data.version ?? null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
 export async function syncTemplateDependencies(templatePath) {
     const cliVersion = getCliVersion();
     if (!cliVersion)
         return;
     const packageJsonPaths = await findPackageJsonFiles(templatePath);
-    await Promise.all(packageJsonPaths.map(async (pkgPath) => {
+    const divergentVersions = new Map();
+    const allDeps = new Set();
+    const pkgDataList = [];
+    for (const pkgPath of packageJsonPaths) {
         const pkg = await fs.readJson(pkgPath);
+        pkgDataList.push({ pkgPath, pkg });
         for (const depType of ['dependencies', 'devDependencies']) {
             const deps = pkg[depType];
             if (!deps)
                 continue;
             for (const name of Object.keys(deps)) {
-                if (name.startsWith('@inkeep/') && name !== '@inkeep/agents-ui') {
+                if (name.startsWith('@inkeep/') && DIVERGENT_PACKAGES.has(name)) {
+                    allDeps.add(name);
+                }
+            }
+        }
+    }
+    await Promise.all([...allDeps].map(async (name) => {
+        const version = await fetchLatestVersion(name);
+        if (version)
+            divergentVersions.set(name, version);
+    }));
+    await Promise.all(pkgDataList.map(async ({ pkgPath, pkg }) => {
+        for (const depType of ['dependencies', 'devDependencies']) {
+            const deps = pkg[depType];
+            if (!deps)
+                continue;
+            for (const name of Object.keys(deps)) {
+                if (!name.startsWith('@inkeep/'))
+                    continue;
+                if (DIVERGENT_PACKAGES.has(name)) {
+                    const resolved = divergentVersions.get(name);
+                    if (resolved)
+                        deps[name] = `^${resolved}`;
+                }
+                else {
                     deps[name] = `^${cliVersion}`;
                 }
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/create-agents",
-  "version": "0.0.0-dev-20260224200401",
+  "version": "0.0.0-dev-20260225021710",
   "description": "Create an Inkeep Agent Framework project",
   "type": "module",
   "bin": {
@@ -33,7 +33,7 @@
     "degit": "^2.8.4",
     "fs-extra": "^11.0.0",
     "picocolors": "^1.0.0",
-    "@inkeep/agents-core": "0.0.0-dev-20260224200401"
+    "@inkeep/agents-core": "0.0.0-dev-20260225021710"
   },
   "devDependencies": {
     "@types/degit": "^2.8.6",