newo 1.6.1 → 1.7.0

package/CHANGELOG.md

@@ -5,6 +5,36 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.7.0] - 2025-09-15
+
+### Added
+- **Customer Attributes Synchronization**: Complete pull/push functionality for customer attributes
+  - `GET /api/v1/bff/customer/attributes?include_hidden=true` - Fetches all 233 customer attributes including hidden system attributes
+  - `PUT /api/v1/customer/attributes/{attributeId}` - Updates individual customer attributes
+  - Saves to `newo_customers/{customerIdn}/attributes.yaml` in customer root directory
+  - YAML format matches reference specification exactly with literal blocks, enum types, and proper multi-line formatting
+  - Separate ID mapping stored in `.newo/{customerIdn}/attributes-map.json` for push operations
+  - Integrated into existing `pull` and `push` commands seamlessly
+  - Full TypeScript type safety with `CustomerAttribute` and `CustomerAttributesResponse` interfaces
+
+### Enhanced
+- **YAML Format Compliance**: Perfect format matching with reference files
+  - Literal block scalars (`|-`) for multi-line strings
+  - Proper enum format (`!enum "AttributeValueTypes.string"`)
+  - Complex JSON string formatting with proper line breaks
+  - No escaped quotes in output for better readability
+- **Metadata Generation**: Removed legacy JSON metadata files, YAML-only approach
+  - Eliminates redundant `metadata.json` files
+  - Cleaner file structure with single source of truth
+  - Improved performance with fewer file operations
+
+### Technical
+- **API Layer**: Added `updateCustomerAttribute()` and enhanced `getCustomerAttributes()` with `includeHidden` parameter
+- **Sync Engine**: Integrated attributes handling into `pullAll()` and `pushChanged()` functions
+- **File System**: Added `customerAttributesPath()` and `customerAttributesMapPath()` utilities
+- **Type Safety**: Extended type definitions with proper customer attribute interfaces
+- **Error Handling**: Comprehensive error handling for attributes operations with graceful fallbacks
+
 ## [1.6.1] - 2025-09-13
 
 ### Fixed

package/dist/api.d.ts

@@ -1,5 +1,5 @@
 import { type AxiosInstance } from 'axios';
-import type { ProjectMeta, Agent, Skill, FlowEvent, FlowState, AkbImportArticle, CustomerProfile } from './types.js';
+import type { ProjectMeta, Agent, Skill, FlowEvent, FlowState, AkbImportArticle, CustomerProfile, CustomerAttribute, CustomerAttributesResponse } from './types.js';
 export declare function makeClient(verbose?: boolean, token?: string): Promise<AxiosInstance>;
 export declare function listProjects(client: AxiosInstance): Promise<ProjectMeta[]>;
 export declare function listAgents(client: AxiosInstance, projectId: string): Promise<Agent[]>;
@@ -11,4 +11,6 @@ export declare function listFlowEvents(client: AxiosInstance, flowId: string): P
 export declare function listFlowStates(client: AxiosInstance, flowId: string): Promise<FlowState[]>;
 export declare function importAkbArticle(client: AxiosInstance, articleData: AkbImportArticle): Promise<unknown>;
 export declare function getCustomerProfile(client: AxiosInstance): Promise<CustomerProfile>;
+export declare function getCustomerAttributes(client: AxiosInstance, includeHidden?: boolean): Promise<CustomerAttributesResponse>;
+export declare function updateCustomerAttribute(client: AxiosInstance, attribute: CustomerAttribute): Promise<void>;
 //# sourceMappingURL=api.d.ts.map

package/dist/api.js

@@ -100,4 +100,25 @@ export async function getCustomerProfile(client) {
     const response = await client.get('/api/v1/customer/profile');
     return response.data;
 }
+export async function getCustomerAttributes(client, includeHidden = true) {
+    const response = await client.get('/api/v1/bff/customer/attributes', {
+        params: { include_hidden: includeHidden }
+    });
+    return response.data;
+}
+export async function updateCustomerAttribute(client, attribute) {
+    if (!attribute.id) {
+        throw new Error(`Attribute ${attribute.idn} is missing ID - cannot update`);
+    }
+    await client.put(`/api/v1/customer/attributes/${attribute.id}`, {
+        idn: attribute.idn,
+        value: attribute.value,
+        title: attribute.title,
+        description: attribute.description,
+        group: attribute.group,
+        is_hidden: attribute.is_hidden,
+        possible_values: attribute.possible_values,
+        value_type: attribute.value_type
+    });
+}
 //# sourceMappingURL=api.js.map

package/dist/cli.js

@@ -2,7 +2,7 @@
 import minimist from 'minimist';
 import dotenv from 'dotenv';
 import { makeClient, getProjectMeta, importAkbArticle } from './api.js';
-import { pullAll, pushChanged, status } from './sync.js';
+import { pullAll, pushChanged, status, saveCustomerAttributes } from './sync.js';
 import { parseAkbFile, prepareArticlesForImport } from './akb.js';
 import { initializeEnvironment, ENV, EnvValidationError } from './env.js';
 import { parseCustomerConfigAsync, listCustomers, getCustomer, getDefaultCustomer, tryGetDefaultCustomer, getAllCustomers, validateCustomerConfig } from './customerAsync.js';
@@ -278,6 +278,11 @@ File Structure:
         const meta = await getProjectMeta(client, selectedCustomer.projectId);
         console.log(JSON.stringify(meta, null, 2));
     }
+    else if (cmd === 'pull-attributes') {
+        console.log(`🔍 Fetching customer attributes for ${selectedCustomer.idn}...`);
+        await saveCustomerAttributes(client, selectedCustomer, verbose);
+        console.log(`✅ Customer attributes saved to newo_customers/${selectedCustomer.idn}/attributes.yaml`);
+    }
     else if (cmd === 'import-akb') {
         const akbFile = args._[1];
         const personaId = args._[2];

package/dist/fsutil.d.ts

@@ -9,7 +9,15 @@ export declare function hashesPath(customerIdn: string): string;
 export declare function ensureState(customerIdn: string): Promise<void>;
 export declare function projectDir(customerIdn: string, projectIdn: string): string;
 export declare function flowsYamlPath(customerIdn: string): string;
+export declare function customerAttributesPath(customerIdn: string): string;
+export declare function customerAttributesMapPath(customerIdn: string): string;
 export declare function skillPath(customerIdn: string, projectIdn: string, agentIdn: string, flowIdn: string, skillIdn: string, runnerType?: RunnerType): string;
+export declare function skillFolderPath(customerIdn: string, projectIdn: string, agentIdn: string, flowIdn: string, skillIdn: string): string;
+export declare function skillScriptPath(customerIdn: string, projectIdn: string, agentIdn: string, flowIdn: string, skillIdn: string, runnerType?: RunnerType): string;
+export declare function projectMetadataPath(customerIdn: string, projectIdn: string): string;
+export declare function agentMetadataPath(customerIdn: string, projectIdn: string, agentIdn: string): string;
+export declare function flowMetadataPath(customerIdn: string, projectIdn: string, agentIdn: string, flowIdn: string): string;
+export declare function skillMetadataPath(customerIdn: string, projectIdn: string, agentIdn: string, flowIdn: string, skillIdn: string): string;
 export declare function metadataPath(customerIdn: string, projectIdn: string): string;
 export declare const ROOT_DIR: string;
 export declare const MAP_PATH: string;

package/dist/fsutil.js

@@ -28,10 +28,39 @@ export function projectDir(customerIdn, projectIdn) {
 export function flowsYamlPath(customerIdn) {
     return path.posix.join(customerProjectsDir(customerIdn), 'flows.yaml');
 }
+export function customerAttributesPath(customerIdn) {
+    return path.posix.join(customerDir(customerIdn), 'attributes.yaml');
+}
+export function customerAttributesMapPath(customerIdn) {
+    return path.join(customerStateDir(customerIdn), 'attributes-map.json');
+}
+// Legacy skill path - direct file
 export function skillPath(customerIdn, projectIdn, agentIdn, flowIdn, skillIdn, runnerType = 'guidance') {
     const extension = runnerType === 'nsl' ? '.jinja' : '.guidance';
     return path.posix.join(customerProjectsDir(customerIdn), projectIdn, agentIdn, flowIdn, `${skillIdn}${extension}`);
 }
+// New hierarchical structure paths
+export function skillFolderPath(customerIdn, projectIdn, agentIdn, flowIdn, skillIdn) {
+    return path.posix.join(customerProjectsDir(customerIdn), projectIdn, agentIdn, flowIdn, skillIdn);
+}
+export function skillScriptPath(customerIdn, projectIdn, agentIdn, flowIdn, skillIdn, runnerType = 'guidance') {
+    const extension = runnerType === 'nsl' ? '.jinja' : '.guidance';
+    return path.posix.join(skillFolderPath(customerIdn, projectIdn, agentIdn, flowIdn, skillIdn), `skill${extension}`);
+}
+// Metadata paths for hierarchical structure
+export function projectMetadataPath(customerIdn, projectIdn) {
+    return path.posix.join(customerProjectsDir(customerIdn), projectIdn, 'metadata.yaml');
+}
+export function agentMetadataPath(customerIdn, projectIdn, agentIdn) {
+    return path.posix.join(customerProjectsDir(customerIdn), projectIdn, agentIdn, 'metadata.yaml');
+}
+export function flowMetadataPath(customerIdn, projectIdn, agentIdn, flowIdn) {
+    return path.posix.join(customerProjectsDir(customerIdn), projectIdn, agentIdn, flowIdn, 'metadata.yaml');
+}
+export function skillMetadataPath(customerIdn, projectIdn, agentIdn, flowIdn, skillIdn) {
+    return path.posix.join(skillFolderPath(customerIdn, projectIdn, agentIdn, flowIdn, skillIdn), 'metadata.yaml');
+}
+// Legacy metadata path - keep for backwards compatibility
 export function metadataPath(customerIdn, projectIdn) {
     return path.posix.join(customerProjectsDir(customerIdn), projectIdn, 'metadata.json');
 }

package/dist/sync.d.ts

@@ -1,5 +1,6 @@
 import type { AxiosInstance } from 'axios';
 import type { ProjectData, CustomerConfig } from './types.js';
+export declare function saveCustomerAttributes(client: AxiosInstance, customer: CustomerConfig, verbose?: boolean): Promise<void>;
 export declare function pullSingleProject(client: AxiosInstance, customer: CustomerConfig, projectId: string, projectIdn: string, verbose?: boolean): Promise<ProjectData>;
 export declare function pullAll(client: AxiosInstance, customer: CustomerConfig, projectId?: string | null, verbose?: boolean): Promise<void>;
 export declare function pushChanged(client: AxiosInstance, customer: CustomerConfig, verbose?: boolean): Promise<void>;