newo 1.6.0 → 1.7.0

package/src/api.ts

@@ -1,14 +1,16 @@
 import axios, { type AxiosInstance, type InternalAxiosRequestConfig, type AxiosResponse, type AxiosError } from 'axios';
 import { getValidAccessToken, forceReauth } from './auth.js';
 import { ENV } from './env.js';
-import type { 
-  ProjectMeta, 
-  Agent, 
-  Skill, 
-  FlowEvent, 
+import type {
+  ProjectMeta,
+  Agent,
+  Skill,
+  FlowEvent,
   FlowState,
   AkbImportArticle,
-  CustomerProfile
+  CustomerProfile,
+  CustomerAttribute,
+  CustomerAttributesResponse
 } from './types.js';
 
 // Per-request retry tracking to avoid shared state issues
@@ -127,4 +129,27 @@ export async function importAkbArticle(client: AxiosInstance, articleData: AkbIm
 export async function getCustomerProfile(client: AxiosInstance): Promise<CustomerProfile> {
   const response = await client.get<CustomerProfile>('/api/v1/customer/profile');
   return response.data;
+}
+
+export async function getCustomerAttributes(client: AxiosInstance, includeHidden: boolean = true): Promise<CustomerAttributesResponse> {
+  const response = await client.get<CustomerAttributesResponse>('/api/v1/bff/customer/attributes', {
+    params: { include_hidden: includeHidden }
+  });
+  return response.data;
+}
+
+export async function updateCustomerAttribute(client: AxiosInstance, attribute: CustomerAttribute): Promise<void> {
+  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
+  });
 }

package/src/cli.ts

@@ -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';
@@ -281,6 +281,10 @@ 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/src/fsutil.ts

@@ -39,18 +39,74 @@ export function flowsYamlPath(customerIdn: string): string {
   return path.posix.join(customerProjectsDir(customerIdn), 'flows.yaml');
 }
 
+export function customerAttributesPath(customerIdn: string): string {
+  return path.posix.join(customerDir(customerIdn), 'attributes.yaml');
+}
+
+export function customerAttributesMapPath(customerIdn: string): string {
+  return path.join(customerStateDir(customerIdn), 'attributes-map.json');
+}
+
+// Legacy skill path - direct file
 export function skillPath(
   customerIdn: string,
-  projectIdn: string, 
-  agentIdn: string, 
-  flowIdn: string, 
-  skillIdn: string, 
+  projectIdn: string,
+  agentIdn: string,
+  flowIdn: string,
+  skillIdn: string,
   runnerType: RunnerType = 'guidance'
 ): string {
   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: string,
+  projectIdn: string,
+  agentIdn: string,
+  flowIdn: string,
+  skillIdn: string
+): string {
+  return path.posix.join(customerProjectsDir(customerIdn), projectIdn, agentIdn, flowIdn, skillIdn);
+}
+
+export function skillScriptPath(
+  customerIdn: string,
+  projectIdn: string,
+  agentIdn: string,
+  flowIdn: string,
+  skillIdn: string,
+  runnerType: RunnerType = 'guidance'
+): string {
+  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: string, projectIdn: string): string {
+  return path.posix.join(customerProjectsDir(customerIdn), projectIdn, 'metadata.yaml');
+}
+
+export function agentMetadataPath(customerIdn: string, projectIdn: string, agentIdn: string): string {
+  return path.posix.join(customerProjectsDir(customerIdn), projectIdn, agentIdn, 'metadata.yaml');
+}
+
+export function flowMetadataPath(customerIdn: string, projectIdn: string, agentIdn: string, flowIdn: string): string {
+  return path.posix.join(customerProjectsDir(customerIdn), projectIdn, agentIdn, flowIdn, 'metadata.yaml');
+}
+
+export function skillMetadataPath(
+  customerIdn: string,
+  projectIdn: string,
+  agentIdn: string,
+  flowIdn: string,
+  skillIdn: string
+): string {
+  return path.posix.join(skillFolderPath(customerIdn, projectIdn, agentIdn, flowIdn, skillIdn), 'metadata.yaml');
+}
+
+// Legacy metadata path - keep for backwards compatibility
 export function metadataPath(customerIdn: string, projectIdn: string): string {
   return path.posix.join(customerProjectsDir(customerIdn), projectIdn, 'metadata.json');
 }