@cognizant-ai-lab/ui-common 1.9.0 → 1.10.0

package/dist/utils/AgentName.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Strip a trailing UUID appended to an agent name or reservation_id, e.g.
+ * `copy_cat-hello_world-14ecb260-4389-44f3-afad-ea315dfa1966` → `copy_cat-hello_world`.
+ */
+export declare const removeTrailingUuid: (agentName: string) => string;
+/**
+ * Convert FOO_BAR to more human "Foo Bar".
+ * @param agentName Agent name in SNAKE_CASE format.
+ * @returns User-friendly agent name.
+ */
+export declare const cleanUpAgentName: (agentName: string) => string;
+/**
+ * Beautify a raw agent name for display: strip any trailing UUID and title-case the rest
+ * (e.g. `my_network_683b0dfb_4816_464d_9c83_7e59ce6497d3` → `My Network`). With `useNativeNames`
+ * on, the raw name is returned verbatim to match the appearance preference honored across the app.
+ */
+export declare const toDisplayName: (rawName: string, useNativeNames?: boolean) => string;

package/dist/utils/AgentName.js

@@ -0,0 +1,46 @@
+/*
+Copyright 2026 Cognizant Technology Solutions Corp, www.cognizant.com.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+/**
+ * One-stop shop for turning a raw agent-network name (or reservation_id) into the beautified name
+ * shown in the UI.
+ */
+import startCase from "lodash-es/startCase";
+/**
+ * Trailing UUID on an agent name or reservation_id.
+ *
+ * Each separator is `[_-]` because the canonical form is hyphen-delimited (e.g.
+ * `copy_cat-hello_world-14ecb260-4389-44f3-afad-ea315dfa1966`), but filename sanitization
+ * (`toSafeFilename`, neuro-san exports) flattens those hyphens to underscores. Matching either
+ * separator strips the UUID in both forms.
+ */
+const TRAILING_UUID_PATTERN = /[_-][0-9a-fA-F]{8}[_-][0-9a-fA-F]{4}[_-][0-9a-fA-F]{4}[_-][0-9a-fA-F]{4}[_-][0-9a-fA-F]{12}$/u;
+/**
+ * Strip a trailing UUID appended to an agent name or reservation_id, e.g.
+ * `copy_cat-hello_world-14ecb260-4389-44f3-afad-ea315dfa1966` → `copy_cat-hello_world`.
+ */
+export const removeTrailingUuid = (agentName) => agentName?.replace(TRAILING_UUID_PATTERN, "");
+/**
+ * Convert FOO_BAR to more human "Foo Bar".
+ * @param agentName Agent name in SNAKE_CASE format.
+ * @returns User-friendly agent name.
+ */
+export const cleanUpAgentName = (agentName) => startCase(agentName);
+/**
+ * Beautify a raw agent name for display: strip any trailing UUID and title-case the rest
+ * (e.g. `my_network_683b0dfb_4816_464d_9c83_7e59ce6497d3` → `My Network`). With `useNativeNames`
+ * on, the raw name is returned verbatim to match the appearance preference honored across the app.
+ */
+export const toDisplayName = (rawName, useNativeNames = false) => useNativeNames ? rawName : cleanUpAgentName(removeTrailingUuid(rawName));

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cognizant-ai-lab/ui-common",
   "description": "A shared UI component library for Cognizant AI Labs projects",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "type": "module",
   "scripts": {
     "build": "yarn clean && yarn generate && yarn run --top-level tsc --project tsconfig.build.json && fix-esm-import-path dist > /dev/null",

package/dist/components/MultiAgentAccelerator/Sidebar/ImportNetworkModal.d.ts

@@ -1,67 +0,0 @@
-import { FC } from "react";
-import { AgentNetworkDefinitionEntry } from "../const.js";
-export declare const IMPORT_MODAL_MAX_FILE_SIZE_BYTES: number;
-export type ImportFileValidation = "valid" | "unsupported_type" | "too_large";
-export interface ImportNetworkModalProps {
-    readonly existingNetworkNames?: readonly string[];
-    readonly isOpen: boolean;
-    readonly onClose: () => void;
-    readonly onImport?: (name: string, content: string) => void;
-}
-export interface NetworkSummary {
-    readonly agents: number;
-    readonly codedTools: number;
-    readonly externalAgents: number;
-    readonly frontman: string;
-}
-/**
- * Parse and validate a network definition file. Imports are JSON only.
- *
- * Returns the parsed value on success, or an error message on failure. The value is typed `unknown`,
- * so callers narrow it (see `jsonToNetworkDefinition`) or stringify it as needed.
- */
-export declare const parseNetworkFileContent: (text: string) => {
-    success: true;
-    data: unknown;
-} | {
-    success: false;
-    error: string;
-};
-/**
- * Converts a parsed network definition into an array of AgentNetworkDefinitionEntry objects
- * suitable for sendNetworkDesignerRequest.
- *
- * Expects the top-level array shape — each entry carrying `origin`, `tools`, `display_as`, etc.
- * Anything that isn't an array yields an empty result, and entries without a string `origin`
- * are dropped. The `instructions` and `description` fields are trimmed when present.
- */
-export declare const jsonToNetworkDefinition: (parsed: unknown) => AgentNetworkDefinitionEntry[];
-export declare const summarizeNetworkDefinition: (networkDef: AgentNetworkDefinitionEntry[]) => NetworkSummary;
-export declare const formatFileSize: (bytes: number) => string;
-/**
- * Validate a selected file against the advertised constraints before reading it.
- *
- * The `<input accept>` attribute only filters the file-picker dialog and is bypassed
- * entirely by drag/drop, so we re-check the extension here. We also enforce the
- * advertised size limit — purely a client-side guard so a pathological file can't be
- * fed into the synchronous parsing/regex pass and freeze the UI; the server imposes
- * no such limit.
- *
- * Returns a status the caller can branch on; rendering a message is left to the caller
- * (see `importFileValidationMessage`).
- */
-export declare const validateImportFile: (file: File) => ImportFileValidation;
-export declare const importFileValidationMessage: (validation: ImportFileValidation, file: File) => string | null;
-/** Convert a filename stem to a display-friendly network name.
- *
- * Strips a trailing UUID that neuro-san appends to exported filenames (e.g.
- * `my_network_683b0dfb_4816_464d_9c83_7e59ce6497d3.json` → `My Network`).
- */
-export declare const filenameToNetworkName: (filename: string) => string;
-/** Pick the first non-colliding name by appending an incrementing index (" 2", " 3", …).
- *
- * Starts at 2 and skips any index already in use, so importing "My Network" alongside an existing
- * "My Network" yields "My Network (2)" — or "My Network (3)" if "My Network (2)" is also taken.
- */
-export declare const nextAvailableNetworkName: (baseName: string, existingNames: readonly string[]) => string;
-export declare const ImportNetworkModal: FC<ImportNetworkModalProps>;