@inkeep/agents-cli 0.0.0-dev-20260212002106 → 0.0.0-dev-20260212003026

package/dist/api.js

@@ -141,6 +141,66 @@ var ManagementApiClient = class ManagementApiClient extends BaseApiClient {
 		}
 		return allProjects;
 	}
+	async getDataComponent(componentId) {
+		const tenantId = this.checkTenantId();
+		const projectId = this.getProjectId();
+		const response = await this.authenticatedFetch(`${this.apiUrl}/manage/tenants/${tenantId}/projects/${projectId}/data-components/${componentId}`, { method: "GET" });
+		if (response.status === 404) return null;
+		if (!response.ok) {
+			const err = await response.text().catch(() => "");
+			throw new Error(`Failed to fetch data component: ${response.statusText}${err ? `\n${err}` : ""}`);
+		}
+		return (await response.json()).data ?? null;
+	}
+	async listDataComponents() {
+		const tenantId = this.checkTenantId();
+		const projectId = this.getProjectId();
+		const all = [];
+		let page = 1;
+		const limit = 100;
+		let result;
+		do {
+			const response = await this.authenticatedFetch(`${this.apiUrl}/manage/tenants/${tenantId}/projects/${projectId}/data-components?page=${page}&limit=${limit}`, { method: "GET" });
+			if (!response.ok) {
+				const err = await response.text().catch(() => "");
+				throw new Error(`Failed to list data components: ${response.statusText}${err ? `\n${err}` : ""}`);
+			}
+			result = await response.json();
+			all.push(...result.data || []);
+			page++;
+		} while (result.data?.length === limit && all.length < (result.pagination?.total ?? 0));
+		return all;
+	}
+	async getArtifactComponent(componentId) {
+		const tenantId = this.checkTenantId();
+		const projectId = this.getProjectId();
+		const response = await this.authenticatedFetch(`${this.apiUrl}/manage/tenants/${tenantId}/projects/${projectId}/artifact-components/${componentId}`, { method: "GET" });
+		if (response.status === 404) return null;
+		if (!response.ok) {
+			const err = await response.text().catch(() => "");
+			throw new Error(`Failed to fetch artifact component: ${response.statusText}${err ? `\n${err}` : ""}`);
+		}
+		return (await response.json()).data ?? null;
+	}
+	async listArtifactComponents() {
+		const tenantId = this.checkTenantId();
+		const projectId = this.getProjectId();
+		const all = [];
+		let page = 1;
+		const limit = 100;
+		let result;
+		do {
+			const response = await this.authenticatedFetch(`${this.apiUrl}/manage/tenants/${tenantId}/projects/${projectId}/artifact-components?page=${page}&limit=${limit}`, { method: "GET" });
+			if (!response.ok) {
+				const err = await response.text().catch(() => "");
+				throw new Error(`Failed to list artifact components: ${response.statusText}${err ? `\n${err}` : ""}`);
+			}
+			result = await response.json();
+			all.push(...result.data || []);
+			page++;
+		} while (result.data?.length === limit && all.length < (result.pagination?.total ?? 0));
+		return all;
+	}
 };
 var ExecutionApiClient = class ExecutionApiClient extends BaseApiClient {
 	constructor(apiUrl, tenantId, projectId, apiKey, isCI = false) {

package/dist/commands/add-ui.js

@@ -0,0 +1,179 @@
+import { ManagementApiClient } from "../api.js";
+import { findConfigFile, findProjectConfig } from "../utils/config.js";
+import { initializeCommand } from "../utils/cli-pipeline.js";
+import path from "node:path";
+import * as p from "@clack/prompts";
+import chalk from "chalk";
+import { findUp } from "find-up";
+import fs from "fs-extra";
+import { Project } from "ts-morph";
+
+//#region src/commands/add-ui.ts
+const UI_DIR_RELATIVE = "apps/agents-ui/src/ui";
+function toPascalCase(name) {
+	if (!name?.trim()) return "Component";
+	return name.trim().replace(/[-_]+/g, " ").split(/\s+/).map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join("");
+}
+/**
+* Ensures the component declaration is exported using AST. Finds the first
+* function or const component (PascalCase name) and adds export if missing.
+*/
+function ensureExported(code) {
+	try {
+		const sourceFile = new Project({
+			useInMemoryFileSystem: true,
+			compilerOptions: { jsx: 1 }
+		}).createSourceFile("temp.tsx", code);
+		const candidates = [];
+		for (const fn of sourceFile.getFunctions()) if (fn.getName()) candidates.push({
+			start: fn.getStart(),
+			type: "function",
+			node: fn
+		});
+		for (const stmt of sourceFile.getVariableStatements()) {
+			const name = stmt.getDeclarationList().getDeclarations()[0]?.getName?.();
+			if (typeof name === "string" && name.length > 0 && name[0] === name[0].toUpperCase()) candidates.push({
+				start: stmt.getStart(),
+				type: "variable",
+				node: stmt
+			});
+		}
+		candidates.sort((a, b) => a.start - b.start);
+		const first = candidates[0];
+		if (!first) return code;
+		if (first.type === "function") {
+			if (!first.node.isExported()) first.node.setIsExported(true);
+		} else if (!first.node.hasExportKeyword()) first.node.toggleModifier("export", true);
+		return sourceFile.getFullText();
+	} catch {
+		return code;
+	}
+}
+async function findUiDirectory() {
+	const cwd = process.cwd();
+	const uiDir = path.join(cwd, UI_DIR_RELATIVE);
+	if (await fs.pathExists(uiDir)) return uiDir;
+	const found = await findUp(UI_DIR_RELATIVE, { type: "directory" });
+	if (found) return found;
+	const agentsUi = await findUp("apps/agents-ui", { type: "directory" });
+	if (agentsUi) return path.join(agentsUi, "src", "ui");
+	return path.join(cwd, UI_DIR_RELATIVE);
+}
+async function fetchAllComponentsWithRender(client) {
+	const [dataComponents, artifactComponents] = await Promise.all([client.listDataComponents(), client.listArtifactComponents()]);
+	return {
+		data: dataComponents,
+		artifact: artifactComponents
+	};
+}
+function formatComponentList(data, artifact) {
+	const withRender = (c) => c.render?.component?.trim();
+	const lines = [];
+	for (const c of data.filter(withRender)) lines.push(`  ${chalk.cyan(c.id)}  ${chalk.gray("(data)")}     ${c.name}`);
+	for (const c of artifact.filter(withRender)) lines.push(`  ${chalk.cyan(c.id)}  ${chalk.gray("(artifact)")}  ${c.name}`);
+	return lines.length ? lines.join("\n") : "  (none with render code)";
+}
+async function addUiCommand(options) {
+	const componentId = typeof options.ui === "string" ? options.ui : void 0;
+	const configPath = options.config ? path.resolve(process.cwd(), options.config) : findConfigFile(process.cwd());
+	if (!configPath) {
+		console.error(chalk.red("No Inkeep config found. Run from a project directory with inkeep.config.ts or pass --config <path>."));
+		process.exit(1);
+	}
+	const { config, isCI } = await initializeCommand({
+		configPath,
+		profileName: options.profile,
+		showSpinner: true,
+		spinnerText: "Loading configuration...",
+		logConfig: !options.quiet,
+		quiet: options.quiet
+	});
+	const projectId = (await findProjectConfig(path.dirname(configPath)))?.projectId ?? null;
+	if (!projectId) {
+		console.error(chalk.red("Project ID not found in config. Set projectId in your inkeep.config.ts."));
+		process.exit(1);
+	}
+	if (!config.agentsApiKey) {
+		console.error(chalk.red("Not authenticated. Run \"inkeep login\" or set agentsApi.apiKey in your config."));
+		process.exit(1);
+	}
+	let client;
+	try {
+		client = await ManagementApiClient.create(config.agentsApiUrl, configPath, config.tenantId, projectId, isCI ?? false, config.agentsApiKey);
+	} catch (err) {
+		const message = err instanceof Error ? err.message : String(err);
+		console.error(chalk.red(`Failed to create API client: ${message}`));
+		process.exit(1);
+	}
+	const toWrite = [];
+	const s = p.spinner();
+	if (options.list) {
+		s.start("Fetching components...");
+		const { data: dataComponents, artifact: artifactComponents } = await fetchAllComponentsWithRender(client);
+		s.stop();
+		console.log(chalk.cyan("\nAvailable UI components (use id with inkeep add --ui <id>):\n"));
+		console.log(formatComponentList(dataComponents, artifactComponents));
+		console.log("");
+		process.exit(0);
+	}
+	s.start("Resolving UI directory...");
+	const uiDir = await findUiDirectory();
+	await fs.ensureDir(uiDir);
+	s.stop();
+	if (componentId) {
+		let comp = await client.getDataComponent(componentId);
+		let kind = "data";
+		if (!comp) {
+			comp = await client.getArtifactComponent(componentId);
+			kind = "artifact";
+		}
+		if (!comp) {
+			s.start("Fetching available components...");
+			const { data: dataComponents, artifact: artifactComponents } = await fetchAllComponentsWithRender(client);
+			s.stop();
+			console.error(chalk.red(`Component "${componentId}" not found (tried data and artifact components).`));
+			console.log(chalk.cyan("\nAvailable UI components (use id with inkeep add --ui <id>):\n"));
+			console.log(formatComponentList(dataComponents, artifactComponents));
+			console.log("");
+			process.exit(1);
+		}
+		if (!comp.render?.component?.trim()) {
+			console.error(chalk.red(`Component "${comp.name}" (${kind}) has no render code. Generate a render in the dashboard first.`));
+			process.exit(1);
+		}
+		const pascalName = toPascalCase(comp.name);
+		toWrite.push({
+			pascalName,
+			code: ensureExported(comp.render.component)
+		});
+	} else {
+		s.start("Fetching data and artifact components...");
+		const [dataComponents, artifactComponents] = await Promise.all([client.listDataComponents(), client.listArtifactComponents()]);
+		s.stop();
+		const withRender = (c) => c.render?.component?.trim() ? {
+			pascalName: toPascalCase(c.name),
+			code: ensureExported(c.render.component)
+		} : null;
+		for (const c of dataComponents) {
+			const item = withRender(c);
+			if (item) toWrite.push(item);
+		}
+		for (const c of artifactComponents) {
+			const item = withRender(c);
+			if (item) toWrite.push(item);
+		}
+		if (toWrite.length === 0) {
+			console.log(chalk.yellow("No components with render code found. Generate renders in the dashboard first."));
+			process.exit(0);
+		}
+	}
+	s.start(`Writing ${toWrite.length} component(s) to ${uiDir}...`);
+	for (const { pascalName, code } of toWrite) {
+		const filePath = path.join(uiDir, `${pascalName}.tsx`);
+		await fs.writeFile(filePath, code, "utf-8");
+	}
+	s.stop(chalk.green(`Added ${toWrite.length} component(s) to ${path.relative(process.cwd(), uiDir)}. Import with: import { <Name> } from './ui/<Name>';`));
+}
+
+//#endregion
+export { addUiCommand, ensureExported };

package/dist/commands/add.js

@@ -1,4 +1,5 @@
 import { cloneTemplate, cloneTemplateLocal, getAvailableTemplates } from "../utils/templates.js";
+import { addUiCommand } from "./add-ui.js";
 import { ANTHROPIC_MODELS, GOOGLE_MODELS, OPENAI_MODELS } from "@inkeep/agents-core";
 import path from "node:path";
 import * as p from "@clack/prompts";
@@ -23,6 +24,16 @@ const defaultAnthropicModelConfigurations = {
 	summarizer: { model: ANTHROPIC_MODELS.CLAUDE_SONNET_4_5 }
 };
 async function addCommand(options) {
+	if (options.ui !== void 0) {
+		await addUiCommand({
+			ui: options.ui,
+			list: options.list,
+			config: options.config,
+			profile: options.profile,
+			quiet: options.quiet
+		});
+		return;
+	}
 	const projectTemplates = await getAvailableTemplates("template-projects", options.localPrefix);
 	const mcpTemplates = await getAvailableTemplates("template-mcps", options.localPrefix);
 	if (!options.project && !options.mcp) {

package/dist/commands/pull-v3/targeted-typescript-placeholders.js

@@ -1,5 +1,5 @@
-import { randomBytes } from "node:crypto";
 import { Node, Project } from "ts-morph";
+import { randomBytes } from "node:crypto";
 
 //#region src/commands/pull-v3/targeted-typescript-placeholders.ts
 /**

package/dist/index.js

@@ -25,7 +25,7 @@ const packageJsonPath = join(dirname(fileURLToPath(import.meta.url)), "..", "pac
 const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
 const program = new Command();
 program.name("inkeep").description("CLI tool for Inkeep Agent Framework").version(packageJson.version);
-program.command("add [template]").description("Add a new template to the project").option("--project <template>", "Project template to add").option("--mcp <template>", "MCP template to add").option("--target-path <path>", "Target path to add the template to").option("--local-prefix <path_prefix>", "Use local templates from the given path prefix").option("--config <path>", "Path to configuration file").action(async (template, options) => {
+program.command("add [template]").description("Add a new template to the project").option("--project <template>", "Project template to add").option("--mcp <template>", "MCP template to add").option("--ui [component-id]", "Add UI component(s) to apps/agents-ui/src/ui (omit id to add all)").option("--list", "List available UI components (use with --ui)").option("--target-path <path>", "Target path to add the template to").option("--local-prefix <path_prefix>", "Use local templates from the given path prefix").option("--config <path>", "Path to configuration file").option("--profile <name>", "Profile to use for authentication").option("--quiet", "Suppress profile/config logging").action(async (template, options) => {
 	await addCommand({
 		template,
 		...options

package/dist/utils/cli-pipeline.js

@@ -1,8 +1,8 @@
 import { getCredentialExpiryInfo, loadCredentials } from "./credentials.js";
-import { ProfileManager } from "./profiles/profile-manager.js";
-import "./profiles/index.js";
 import { detectCIEnvironment, loadCIEnvironmentConfig, logCIConfig } from "./ci-environment.js";
 import { validateConfiguration } from "./config.js";
+import { ProfileManager } from "./profiles/profile-manager.js";
+import "./profiles/index.js";
 import * as p from "@clack/prompts";
 import chalk from "chalk";
 

package/dist/utils/config.js

@@ -23,19 +23,28 @@ function isNestedConfig(config) {
 	return config && config.agentsApi !== void 0;
 }
 /**
+* Ensure URL has a scheme so fetch() works. Bare host:port gets http://.
+*/
+function ensureUrlScheme(url) {
+	if (!url?.trim()) return url;
+	const u = url.trim();
+	if (/^https?:\/\//i.test(u)) return u;
+	return `http://${u}`;
+}
+/**
 * Normalize config from either flat or nested format to internal format
 */
 function normalizeConfig(config) {
 	if (isNestedConfig(config)) return {
 		tenantId: config.tenantId,
-		agentsApiUrl: config.agentsApi?.url,
+		agentsApiUrl: ensureUrlScheme(config.agentsApi?.url),
 		agentsApiKey: config.agentsApi?.apiKey,
 		manageUiUrl: config.manageUiUrl,
 		outputDirectory: config.outputDirectory
 	};
 	return {
 		tenantId: config.tenantId,
-		agentsApiUrl: config.agentsApiUrl,
+		agentsApiUrl: ensureUrlScheme(config.agentsApiUrl),
 		manageUiUrl: config.manageUiUrl,
 		outputDirectory: config.outputDirectory
 	};
@@ -254,6 +263,14 @@ async function validateConfiguration(configPath, tag) {
 		config.agentsApiKey = cliCredentials.accessToken;
 		logger.info({}, "Using CLI session token as API key");
 	}
+	if (!config.agentsApiKey && !cliCredentials) {
+		const cloudCreds = await loadCredentials("inkeep-cloud");
+		if (cloudCreds?.accessToken) {
+			config.agentsApiKey = cloudCreds.accessToken;
+			if (!config.tenantId) config.tenantId = cloudCreds.organizationId;
+			logger.info({}, "Using CLI login credentials (inkeep-cloud)");
+		}
+	}
 	if (!config.tenantId && cliCredentials) {
 		config.tenantId = cliCredentials.organizationId;
 		logger.info({}, "Using CLI organization ID as tenant ID");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/agents-cli",
-  "version": "0.0.0-dev-20260212002106",
+  "version": "0.0.0-dev-20260212003026",
   "description": "Inkeep CLI tool",
   "type": "module",
   "main": "./dist/index.js",
@@ -40,8 +40,8 @@
     "tsx": "^4.20.5",
     "yaml": "^2.7.0",
     "zod": "^4.3.6",
-    "@inkeep/agents-core": "^0.0.0-dev-20260212002106",
-    "@inkeep/agents-sdk": "^0.0.0-dev-20260212002106"
+    "@inkeep/agents-core": "^0.0.0-dev-20260212003026",
+    "@inkeep/agents-sdk": "^0.0.0-dev-20260212003026"
   },
   "devDependencies": {
     "@types/degit": "^2.8.6",
@@ -52,7 +52,7 @@
     "vitest": "^3.2.4"
   },
   "peerDependencies": {
-    "@inkeep/agents-manage-ui": "0.0.0-dev-20260212002106"
+    "@inkeep/agents-manage-ui": "0.0.0-dev-20260212003026"
   },
   "publishConfig": {
     "access": "public",