newo 3.1.0 → 3.2.0

package/CHANGELOG.md

@@ -7,6 +7,143 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.2.0] - 2025-10-17
+
+### Added
+
+- **Integration Management**: Complete integration and connector management system
+  - `newo pull-integrations` - Download all integrations, connectors, and webhooks to local YAML files
+  - `newo push-integrations` - Upload connector changes with full CRUD support (Create, Update, Delete)
+  - Combined integration files: `{integration_idn}.yaml` contains metadata + settings in single file
+  - Nested connector structure: Each connector in own subdirectory `connectors/{connector_idn}/{connector_idn}.yaml`
+  - Automatic webhook synchronization (outgoing + incoming webhooks)
+  - 15 integrations discovered and managed (api, sandbox, twilio, magic_browser, newo_chat, etc.)
+  - Full connector lifecycle: Create via YAML + push → Modify → Delete via YAML removal + push
+- **AKB Knowledge Base Management**: Complete knowledge base synchronization
+  - `newo pull-akb` - Download AKB articles for all personas linked to agents
+  - `newo push-akb` - Upload AKB articles from local YAML files to platform
+  - YAML format matches backup structure exactly for compatibility
+  - Automatic persona-to-agent mapping via agent IDN
+  - Pagination support for large knowledge bases
+  - Articles stored in `akb/{agent_idn}.yaml` format
+- **Project Attributes**: Full project-level attribute management
+  - Enhanced `newo pull-attributes` to pull both customer AND project attributes
+  - Project attributes saved to `projects/{project_idn}/attributes.yaml`
+  - Push integrated into main `newo push` command
+  - Automatic ID mapping for push operations
+  - Same YAML format as customer attributes with !enum tags
+  - Change detection and update mechanism
+- **Developer Tools**: Reference and productivity features
+  - `newo list-actions` - List all 78 available NSL/Jinja script actions with categorization
+  - `newo profile` - Display customer profile information (organization, email, platform links)
+  - Action categorization into 12 groups (Gen, Get, Create, Delete, Update, etc.)
+  - Verbose mode shows complete parameter schemas for each action
+- **API Integrations**: 17 new API endpoints
+  - Integration endpoints: GET integrations, connectors, settings
+  - Connector CRUD: POST, PUT, DELETE for connectors
+  - Webhook endpoints: GET outgoing/incoming webhooks
+  - AKB endpoints: GET personas, topics; POST import
+  - Project attribute endpoints: GET, PUT for project attributes
+  - Script actions endpoint: GET all NSL actions
+  - Customer profile endpoint: GET profile information
+- **TypeScript Types**: 22 new interfaces for complete type safety
+  - Integration types: Integration, Connector, IntegrationSetting, CreateConnectorRequest, UpdateConnectorRequest
+  - Webhook types: OutgoingWebhook, IncomingWebhook
+  - AKB types: Persona, AkbTopic, AkbTopicItem, AkbYamlTopic
+  - Script action types: ScriptAction, ArgumentSchema
+  - Metadata types: IntegrationMetadata, ConnectorMetadata, IntegrationsYamlData
+
+### Changed
+
+- **File Structure**: Enhanced directory hierarchy with new integration and AKB folders
+  - `newo_customers/{customer}/integrations/` - Integration configurations
+  - `newo_customers/{customer}/akb/` - AKB knowledge base articles
+  - `newo_customers/{customer}/projects/{project}/attributes.yaml` - Project attributes
+- **Pull Attributes Command**: Now pulls both customer and project attributes in single command
+- **Push Command**: Enhanced to push project attribute changes alongside skill changes
+- **Help Documentation**: Comprehensive updates with all new commands and file structure
+- **Integration Structure**: Nested connector directories with webhook subdirectories
+  - `integrations/{integration}/{integration}.yaml` - Combined metadata + settings
+  - `integrations/{integration}/connectors/{connector}/{connector}.yaml` - Connector config
+  - `integrations/{integration}/connectors/{connector}/webhooks/` - Webhook files
+
+### Technical Details
+
+- **Modular Architecture**: 8 new modules created
+  - `src/sync/integrations.ts` (340+ lines) - Integration/connector/webhook sync
+  - `src/sync/akb.ts` (205 lines) - AKB knowledge base sync
+  - `src/cli/commands/pull-integrations.ts` - Integration pull handler
+  - `src/cli/commands/push-integrations.ts` - Integration push handler
+  - `src/cli/commands/pull-akb.ts` - AKB pull handler
+  - `src/cli/commands/push-akb.ts` - AKB push handler
+  - `src/cli/commands/list-actions.ts` - Script actions listing
+  - `src/cli/commands/profile.ts` - Profile viewer
+- **Enhanced Modules**: 6 existing modules updated
+  - `src/types.ts` (+160 lines) - New type definitions
+  - `src/api.ts` (+110 lines) - New API functions
+  - `src/sync/attributes.ts` (+126 lines) - Project attribute support
+  - `src/sync/push.ts` (+15 lines) - Project attribute push integration
+  - `src/cli.ts` (+12 lines) - New command routing
+  - `src/cli/commands/help.ts` (+30 lines) - Documentation updates
+- **Webhook Association**: Webhooks grouped by connector_idn and stored in connector subdirectories
+- **Change Detection**: Smart comparison for connectors (title, status, settings)
+- **Error Handling**: Graceful handling of missing settings endpoints (404 errors)
+- **ID Mapping**: Separate JSON files for attribute ID mappings to enable push operations
+- **YAML Parsing**: Custom !enum tag handling for AttributeValueTypes
+
+### Example Usage
+
+```bash
+# Integration management
+newo pull-integrations                    # Download all integrations + webhooks
+newo push-integrations                    # Upload connector changes
+
+# Knowledge base management
+newo pull-akb                             # Download AKB for personas with agents
+newo push-akb                             # Upload AKB articles
+
+# Enhanced attributes
+newo pull-attributes                      # Now pulls customer + project attributes
+newo push                                 # Now pushes project attributes too
+
+# Developer tools
+newo profile                              # View customer information
+newo list-actions                         # Browse 78 NSL actions
+newo list-actions --verbose               # With parameter details
+```
+
+### Files Created
+
+**Integration Structure:**
+```
+newo_customers/{customer}/integrations/
+├── integrations.yaml
+└── {integration_idn}/
+    ├── {integration_idn}.yaml           # Combined metadata + settings
+    └── connectors/
+        └── {connector_idn}/
+            ├── {connector_idn}.yaml
+            └── webhooks/
+                ├── outgoing.yaml
+                └── incoming.yaml
+```
+
+**AKB Structure:**
+```
+newo_customers/{customer}/akb/
+└── {agent_idn}.yaml                     # AKB articles per agent
+```
+
+**Project Attributes:**
+```
+newo_customers/{customer}/projects/{project}/
+└── attributes.yaml                      # Project-specific attributes
+```
+
+### Breaking Changes
+
+None. All changes are additive and backward compatible.
+
 ## [3.1.0] - 2025-10-15
 
 ### Added
@@ -698,7 +835,8 @@ Another Item: $Price [Modifiers: modifier3]
 - GitHub Actions CI/CD integration
 - Robust authentication with token refresh
 
-[Unreleased]: https://github.com/sabbah13/newo-cli/compare/v3.1.0...HEAD
+[Unreleased]: https://github.com/sabbah13/newo-cli/compare/v3.2.0...HEAD
+[3.2.0]: https://github.com/sabbah13/newo-cli/compare/v3.1.0...v3.2.0
 [3.1.0]: https://github.com/sabbah13/newo-cli/compare/v3.0.0...v3.1.0
 [3.0.0]: https://github.com/sabbah13/newo-cli/compare/v2.0.6...v3.0.0
 [2.0.6]: https://github.com/sabbah13/newo-cli/compare/v2.0.5...v2.0.6

package/dist/api.d.ts

@@ -1,5 +1,5 @@
 import { type AxiosInstance } from 'axios';
-import type { ProjectMeta, Agent, Skill, FlowEvent, FlowState, AkbImportArticle, CustomerProfile, CustomerAttribute, CustomerAttributesResponse, UserPersonaResponse, UserPersona, ChatHistoryParams, ChatHistoryResponse, CreateAgentRequest, CreateAgentResponse, CreateFlowRequest, CreateFlowResponse, CreateSkillRequest, CreateSkillResponse, CreateFlowEventRequest, CreateFlowEventResponse, CreateFlowStateRequest, CreateFlowStateResponse, CreateSkillParameterRequest, CreateSkillParameterResponse, CreateCustomerAttributeRequest, CreateCustomerAttributeResponse, CreatePersonaRequest, CreatePersonaResponse, CreateProjectRequest, CreateProjectResponse, PublishFlowRequest, PublishFlowResponse, Integration, Connector, CreateSandboxPersonaRequest, CreateSandboxPersonaResponse, CreateActorRequest, CreateActorResponse, SendChatMessageRequest, ConversationActsParams, ConversationActsResponse } from './types.js';
+import type { ProjectMeta, Agent, Skill, FlowEvent, FlowState, AkbImportArticle, CustomerProfile, CustomerAttribute, CustomerAttributesResponse, UserPersonaResponse, UserPersona, ChatHistoryParams, ChatHistoryResponse, CreateAgentRequest, CreateAgentResponse, CreateFlowRequest, CreateFlowResponse, CreateSkillRequest, CreateSkillResponse, CreateFlowEventRequest, CreateFlowEventResponse, CreateFlowStateRequest, CreateFlowStateResponse, CreateSkillParameterRequest, CreateSkillParameterResponse, CreateCustomerAttributeRequest, CreateCustomerAttributeResponse, CreatePersonaRequest, CreatePersonaResponse, CreateProjectRequest, CreateProjectResponse, PublishFlowRequest, PublishFlowResponse, Integration, Connector, CreateSandboxPersonaRequest, CreateSandboxPersonaResponse, CreateActorRequest, CreateActorResponse, SendChatMessageRequest, ConversationActsParams, ConversationActsResponse, ScriptAction, IntegrationSetting, CreateConnectorRequest, CreateConnectorResponse, UpdateConnectorRequest, OutgoingWebhook, IncomingWebhook, PersonaSearchResponse, AkbTopicsResponse } 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[]>;
@@ -13,6 +13,10 @@ export declare function importAkbArticle(client: AxiosInstance, articleData: Akb
 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>;
+export declare function getProjectAttributes(client: AxiosInstance, projectId: string, includeHidden?: boolean): Promise<CustomerAttributesResponse>;
+export declare function updateProjectAttribute(client: AxiosInstance, projectId: string, attribute: CustomerAttribute): Promise<void>;
+export declare function createProjectAttribute(client: AxiosInstance, projectId: string, attributeData: CreateCustomerAttributeRequest): Promise<CreateCustomerAttributeResponse>;
+export declare function deleteProjectAttribute(client: AxiosInstance, projectId: string, attributeId: string): Promise<void>;
 export declare function listUserPersonas(client: AxiosInstance, page?: number, per?: number): Promise<UserPersonaResponse>;
 export declare function getUserPersona(client: AxiosInstance, personaId: string): Promise<UserPersona>;
 export declare function getAccount(client: AxiosInstance): Promise<{
@@ -42,4 +46,13 @@ export declare function createSandboxPersona(client: AxiosInstance, personaData:
 export declare function createActor(client: AxiosInstance, personaId: string, actorData: CreateActorRequest): Promise<CreateActorResponse>;
 export declare function sendChatMessage(client: AxiosInstance, actorId: string, messageData: SendChatMessageRequest): Promise<void>;
 export declare function getConversationActs(client: AxiosInstance, params: ConversationActsParams): Promise<ConversationActsResponse>;
+export declare function getScriptActions(client: AxiosInstance): Promise<ScriptAction[]>;
+export declare function getIntegrationSettings(client: AxiosInstance, integrationId: string): Promise<IntegrationSetting[]>;
+export declare function createConnector(client: AxiosInstance, integrationId: string, connectorData: CreateConnectorRequest): Promise<CreateConnectorResponse>;
+export declare function updateConnector(client: AxiosInstance, connectorId: string, updateData: UpdateConnectorRequest): Promise<void>;
+export declare function deleteConnector(client: AxiosInstance, connectorId: string): Promise<void>;
+export declare function listOutgoingWebhooks(client: AxiosInstance): Promise<OutgoingWebhook[]>;
+export declare function listIncomingWebhooks(client: AxiosInstance): Promise<IncomingWebhook[]>;
+export declare function searchPersonas(client: AxiosInstance, isLinkedToAgent?: boolean, page?: number, per?: number): Promise<PersonaSearchResponse>;
+export declare function getAkbTopics(client: AxiosInstance, personaId: string, page?: number, per?: number, orderBy?: string): Promise<AkbTopicsResponse>;
 //# sourceMappingURL=api.d.ts.map

package/dist/api.js

@@ -121,6 +121,37 @@ export async function updateCustomerAttribute(client, attribute) {
         value_type: attribute.value_type
     });
 }
+export async function getProjectAttributes(client, projectId, includeHidden = false) {
+    const response = await client.get(`/api/v1/bff/projects/${projectId}/attributes`, {
+        params: {
+            query: '',
+            include_hidden: includeHidden
+        }
+    });
+    return response.data;
+}
+export async function updateProjectAttribute(client, projectId, attribute) {
+    if (!attribute.id) {
+        throw new Error(`Project attribute ${attribute.idn} is missing ID - cannot update`);
+    }
+    await client.put(`/api/v1/designer/projects/${projectId}/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
+    });
+}
+export async function createProjectAttribute(client, projectId, attributeData) {
+    const response = await client.post(`/api/v1/designer/projects/${projectId}/attributes`, attributeData);
+    return response.data;
+}
+export async function deleteProjectAttribute(client, projectId, attributeId) {
+    await client.delete(`/api/v1/designer/projects/${projectId}/attributes/${attributeId}`);
+}
 // Conversation API Functions
 export async function listUserPersonas(client, page = 1, per = 50) {
     const response = await client.get('/api/v1/bff/conversations/user-personas', {
@@ -265,4 +296,47 @@ export async function getConversationActs(client, params) {
     });
     return response.data;
 }
+// Script Actions API Functions
+export async function getScriptActions(client) {
+    const response = await client.get('/api/v1/script/actions');
+    return response.data;
+}
+// Integration API Functions
+export async function getIntegrationSettings(client, integrationId) {
+    const response = await client.get(`/api/v1/integrations/${integrationId}/settings`);
+    return response.data;
+}
+// Connector CRUD API Functions
+export async function createConnector(client, integrationId, connectorData) {
+    const response = await client.post(`/api/v1/integrations/${integrationId}/connectors`, connectorData);
+    return response.data;
+}
+export async function updateConnector(client, connectorId, updateData) {
+    await client.put(`/api/v1/integrations/connectors/${connectorId}`, updateData);
+}
+export async function deleteConnector(client, connectorId) {
+    await client.delete(`/api/v1/integrations/connectors/${connectorId}`);
+}
+// Webhook API Functions
+export async function listOutgoingWebhooks(client) {
+    const response = await client.get('/api/v1/webhooks');
+    return response.data;
+}
+export async function listIncomingWebhooks(client) {
+    const response = await client.get('/api/v1/webhooks/incoming');
+    return response.data;
+}
+// AKB (Knowledge Base) API Functions
+export async function searchPersonas(client, isLinkedToAgent = true, page = 1, per = 30) {
+    const response = await client.get('/api/v1/bff/personas/search', {
+        params: { is_linked_to_agent: isLinkedToAgent, page, per }
+    });
+    return response.data;
+}
+export async function getAkbTopics(client, personaId, page = 1, per = 100, orderBy = 'created_at') {
+    const response = await client.get('/api/v1/akb/topics', {
+        params: { persona_id: personaId, page, per, order_by: orderBy }
+    });
+    return response.data;
+}
 //# sourceMappingURL=api.js.map

package/dist/cli/commands/help.js

@@ -12,7 +12,7 @@ Core Commands:
   newo conversations [--customer <idn>] [--all] # download user conversations -> ./newo_customers/<idn>/conversations.yaml
   newo sandbox "<message>" [--customer <idn>]   # test agent in sandbox - single message mode (NEW v3.1.0)
   newo sandbox --actor <id> "message"           # continue existing sandbox conversation with chat ID
-  newo pull-attributes [--customer <idn>]       # download customer attributes -> ./newo_customers/<idn>/attributes.yaml
+  newo pull-attributes [--customer <idn>]       # download customer + project attributes -> ./newo_customers/<idn>/attributes.yaml + projects/{project}/attributes.yaml
   newo list-customers                           # list available customers and their configuration
   newo meta [--customer <idn>]                  # get project metadata (debug command)
   newo import-akb <file> <persona_id> [--customer <idn>]  # import AKB articles from structured text file
@@ -41,6 +41,12 @@ Enterprise Features:
   newo conversations [--customer <idn>] [--all]             # download conversation history
   newo pull-attributes [--customer <idn>]                   # sync customer attributes
   newo import-akb <file> <persona_id>                       # import knowledge base articles
+  newo pull-integrations [--customer <idn>]                 # download integrations and connectors → ./newo_customers/<idn>/integrations/
+  newo push-integrations [--customer <idn>]                 # upload integration and connector changes to platform
+  newo list-actions [--customer <idn>]                      # list all available NSL/Jinja script actions with parameters
+  newo profile [--customer <idn>]                           # display customer profile information
+  newo pull-akb [--customer <idn>]                          # download AKB articles for all personas with agents → ./newo_customers/<idn>/akb/
+  newo push-akb [--customer <idn>]                          # upload AKB articles from local YAML files to platform
 
 Flags:
   --customer <idn>             # specify customer (if not set, uses default or interactive selection)
@@ -122,8 +128,21 @@ File Structure:
   ├── <customer-idn>/
   │   ├── attributes.yaml                      # Customer attributes (pull-attributes)
   │   ├── conversations.yaml                   # User conversations and personas
+  │   ├── akb/                                 # AKB knowledge base articles (pull-akb)
+  │   │   └── <agent-idn>.yaml                # AKB articles per agent persona
+  │   ├── integrations/                        # Integration configurations (pull-integrations)
+  │   │   ├── integrations.yaml               # Master integrations list
+  │   │   └── <integration-idn>/
+  │   │       ├── <integration-idn>.yaml      # Integration metadata + settings (combined)
+  │   │       └── connectors/
+  │   │           └── <connector-idn>/        # Each connector in own directory
+  │   │               ├── <connector-idn>.yaml  # Connector config
+  │   │               └── webhooks/           # Webhooks subdirectory (if any)
+  │   │                   ├── outgoing.yaml   # Outgoing webhooks
+  │   │                   └── incoming.yaml   # Incoming webhooks
   │   └── projects/
   │       └── <project-idn>/
+  │           ├── attributes.yaml              # Project attributes (pull-attributes)
   │           ├── flows.yaml                   # Auto-generated project structure
   │           ├── metadata.yaml                # Project metadata
   │           └── <agent-idn>/

package/dist/cli/commands/list-actions.d.ts

@@ -0,0 +1,3 @@
+import type { MultiCustomerConfig, CliArgs } from '../../types.js';
+export declare function handleListActionsCommand(customerConfig: MultiCustomerConfig, args: CliArgs, verbose: boolean): Promise<void>;
+//# sourceMappingURL=list-actions.d.ts.map

package/dist/cli/commands/list-actions.js

@@ -0,0 +1,89 @@
+/**
+ * List actions command handler
+ * Displays all available NSL/Jinja script actions
+ */
+import { makeClient, getScriptActions } from '../../api.js';
+import { getValidAccessToken } from '../../auth.js';
+import { requireSingleCustomer } from '../customer-selection.js';
+export async function handleListActionsCommand(customerConfig, args, verbose) {
+    const selectedCustomer = requireSingleCustomer(customerConfig, args.customer);
+    const accessToken = await getValidAccessToken(selectedCustomer);
+    const client = await makeClient(verbose, accessToken);
+    console.log(`📋 Fetching available script actions...\n`);
+    const actions = await getScriptActions(client);
+    console.log(`✅ Found ${actions.length} script actions\n`);
+    // Group actions by category
+    const categories = new Map();
+    for (const action of actions) {
+        // Categorize by prefix (e.g., Get, Create, Delete, Gen, etc.)
+        const category = getCategoryFromActionTitle(action.title);
+        if (!categories.has(category)) {
+            categories.set(category, []);
+        }
+        categories.get(category).push(action);
+    }
+    // Display actions by category
+    const sortedCategories = Array.from(categories.entries()).sort(([a], [b]) => a.localeCompare(b));
+    for (const [category, categoryActions] of sortedCategories) {
+        console.log(`\n${category}:`);
+        for (const action of categoryActions.sort((a, b) => a.title.localeCompare(b.title))) {
+            console.log(`  • ${action.title}`);
+            // Show parameters if verbose
+            if (verbose && Object.keys(action.arguments).length > 0) {
+                console.log(`    Parameters:`);
+                for (const [paramName, paramSchema] of Object.entries(action.arguments)) {
+                    const required = paramSchema.default === undefined && !paramSchema.anyOf ? ' (required)' : '';
+                    console.log(`      - ${paramName}: ${paramSchema.type}${required}`);
+                }
+            }
+        }
+    }
+    console.log(`\n💡 Use --verbose flag to see parameter details\n`);
+}
+/**
+ * Categorize action by its title prefix
+ */
+function getCategoryFromActionTitle(title) {
+    // Common prefixes
+    const prefixes = [
+        'Gen',
+        'Get',
+        'Create',
+        'Delete',
+        'Update',
+        'Set',
+        'Send',
+        'Append',
+        'Build',
+        'Parse',
+        'Validate',
+        'Format',
+        'Convert',
+        'Filter',
+        'Sort',
+        'Search'
+    ];
+    for (const prefix of prefixes) {
+        if (title.startsWith(prefix)) {
+            return `${prefix} Actions`;
+        }
+    }
+    // Special cases
+    if (title.includes('Array') || title.includes('JSON')) {
+        return 'Data Manipulation';
+    }
+    if (title.includes('Actor') || title.includes('Persona')) {
+        return 'User Management';
+    }
+    if (title.includes('Message') || title.includes('Chat')) {
+        return 'Communication';
+    }
+    if (title.includes('Akb') || title.includes('Knowledge')) {
+        return 'Knowledge Base';
+    }
+    if (title.includes('Attribute')) {
+        return 'Attributes';
+    }
+    return 'Other Actions';
+}
+//# sourceMappingURL=list-actions.js.map

package/dist/cli/commands/profile.d.ts

@@ -0,0 +1,3 @@
+import type { MultiCustomerConfig, CliArgs } from '../../types.js';
+export declare function handleProfileCommand(customerConfig: MultiCustomerConfig, args: CliArgs, verbose: boolean): Promise<void>;
+//# sourceMappingURL=profile.d.ts.map

package/dist/cli/commands/profile.js

@@ -0,0 +1,62 @@
+/**
+ * Profile command handler
+ * Displays customer profile information
+ */
+import { makeClient, getCustomerProfile } from '../../api.js';
+import { getValidAccessToken } from '../../auth.js';
+import { requireSingleCustomer } from '../customer-selection.js';
+export async function handleProfileCommand(customerConfig, args, verbose) {
+    const selectedCustomer = requireSingleCustomer(customerConfig, args.customer);
+    const accessToken = await getValidAccessToken(selectedCustomer);
+    const client = await makeClient(verbose, accessToken);
+    console.log(`👤 Fetching customer profile for ${selectedCustomer.idn}...\n`);
+    const profile = await getCustomerProfile(client);
+    // Display formatted profile information
+    console.log(`Organization: ${profile.organization_name || 'N/A'}`);
+    console.log(`Customer IDN: ${profile.idn}`);
+    console.log(`Email: ${profile.email || 'N/A'}`);
+    console.log(`Status: ${profile.status || 'N/A'} ${profile.is_active ? '(active)' : '(inactive)'}`);
+    if (profile.phone_number) {
+        console.log(`Phone: ${profile.phone_number}`);
+    }
+    if (profile.website) {
+        console.log(`Website: ${profile.website}`);
+    }
+    if (profile.referral_code) {
+        console.log(`Referral Code: ${profile.referral_code}`);
+    }
+    // Platform links
+    if (profile.platform_links) {
+        console.log(`\nPlatform Links:`);
+        if (profile.platform_links.portal) {
+            console.log(`  Portal: ${profile.platform_links.portal}`);
+        }
+        if (profile.platform_links.builder) {
+            console.log(`  Builder: ${profile.platform_links.builder}`);
+        }
+        if (profile.platform_links.creator) {
+            console.log(`  Creator: ${profile.platform_links.creator}`);
+        }
+        if (profile.platform_links.chat_widget) {
+            console.log(`  Chat Widget: ${profile.platform_links.chat_widget}`);
+        }
+    }
+    // Show additional fields if verbose
+    if (verbose) {
+        console.log(`\nAdditional Information:`);
+        console.log(`  Customer ID: ${profile.id}`);
+        console.log(`  Tenant: ${profile.tenant || 'N/A'}`);
+        console.log(`  Organization Type: ${profile.organization_type || 'N/A'}`);
+        console.log(`  External Customer ID: ${profile.external_customer_id || 'N/A'}`);
+        if (profile.industry && profile.industry.length > 0) {
+            console.log(`  Industry: ${profile.industry.join(', ')}`);
+        }
+        if (profile.billing_email) {
+            console.log(`  Billing Email: ${profile.billing_email}`);
+        }
+        console.log(`  BAA Signed: ${profile.is_baa_signed ? 'Yes' : 'No'}`);
+        console.log(`  Marked for Deletion: ${profile.is_marked_for_deletion ? 'Yes' : 'No'}`);
+    }
+    console.log();
+}
+//# sourceMappingURL=profile.js.map

package/dist/cli/commands/pull-akb.d.ts

@@ -0,0 +1,3 @@
+import type { MultiCustomerConfig, CliArgs } from '../../types.js';
+export declare function handlePullAkbCommand(customerConfig: MultiCustomerConfig, args: CliArgs, verbose: boolean): Promise<void>;
+//# sourceMappingURL=pull-akb.d.ts.map

package/dist/cli/commands/pull-akb.js

@@ -0,0 +1,19 @@
+/**
+ * Pull AKB command handler
+ * Downloads AKB (knowledge base) articles for all personas linked to agents
+ */
+import path from 'path';
+import { makeClient } from '../../api.js';
+import { pullAkb } from '../../sync/akb.js';
+import { getValidAccessToken } from '../../auth.js';
+import { requireSingleCustomer } from '../customer-selection.js';
+export async function handlePullAkbCommand(customerConfig, args, verbose) {
+    const selectedCustomer = requireSingleCustomer(customerConfig, args.customer);
+    const accessToken = await getValidAccessToken(selectedCustomer);
+    const client = await makeClient(verbose, accessToken);
+    const customerDir = path.join(process.cwd(), 'newo_customers', selectedCustomer.idn);
+    console.log(`📚 Fetching AKB articles for ${selectedCustomer.idn}...`);
+    await pullAkb(client, customerDir, verbose);
+    console.log(`✅ AKB articles saved to newo_customers/${selectedCustomer.idn}/akb/`);
+}
+//# sourceMappingURL=pull-akb.js.map

package/dist/cli/commands/pull-attributes.js

@@ -1,16 +1,23 @@
 /**
  * Pull attributes command handler
+ * Pulls both customer and project attributes
  */
 import { makeClient } from '../../api.js';
 import { saveCustomerAttributes } from '../../sync.js';
+import { pullAllProjectAttributes } from '../../sync/attributes.js';
 import { getValidAccessToken } from '../../auth.js';
 import { requireSingleCustomer } from '../customer-selection.js';
 export async function handlePullAttributesCommand(customerConfig, args, verbose) {
     const selectedCustomer = requireSingleCustomer(customerConfig, args.customer);
     const accessToken = await getValidAccessToken(selectedCustomer);
     const client = await makeClient(verbose, accessToken);
+    // Pull customer 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`);
+    // Pull project attributes
+    console.log(`\n📋 Fetching project attributes for ${selectedCustomer.idn}...`);
+    await pullAllProjectAttributes(client, selectedCustomer, verbose);
+    console.log(`✅ Project attributes saved to newo_customers/${selectedCustomer.idn}/projects/{project_idn}/attributes.yaml`);
 }
 //# sourceMappingURL=pull-attributes.js.map

package/dist/cli/commands/pull-integrations.d.ts

@@ -0,0 +1,3 @@
+import type { MultiCustomerConfig, CliArgs } from '../../types.js';
+export declare function handlePullIntegrationsCommand(customerConfig: MultiCustomerConfig, args: CliArgs, verbose: boolean): Promise<void>;
+//# sourceMappingURL=pull-integrations.d.ts.map

package/dist/cli/commands/pull-integrations.js

@@ -0,0 +1,19 @@
+/**
+ * Pull integrations command handler
+ * Downloads all integrations and connectors from NEWO platform
+ */
+import path from 'path';
+import { makeClient } from '../../api.js';
+import { pullIntegrations } from '../../sync/integrations.js';
+import { getValidAccessToken } from '../../auth.js';
+import { requireSingleCustomer } from '../customer-selection.js';
+export async function handlePullIntegrationsCommand(customerConfig, args, verbose) {
+    const selectedCustomer = requireSingleCustomer(customerConfig, args.customer);
+    const accessToken = await getValidAccessToken(selectedCustomer);
+    const client = await makeClient(verbose, accessToken);
+    const customerDir = path.join(process.cwd(), 'newo_customers', selectedCustomer.idn);
+    console.log(`📦 Fetching integrations for ${selectedCustomer.idn}...`);
+    await pullIntegrations(client, customerDir, verbose);
+    console.log(`✅ Integrations saved to newo_customers/${selectedCustomer.idn}/integrations/`);
+}
+//# sourceMappingURL=pull-integrations.js.map

package/dist/cli/commands/push-akb.d.ts

@@ -0,0 +1,3 @@
+import type { MultiCustomerConfig, CliArgs } from '../../types.js';
+export declare function handlePushAkbCommand(customerConfig: MultiCustomerConfig, args: CliArgs, verbose: boolean): Promise<void>;
+//# sourceMappingURL=push-akb.d.ts.map

package/dist/cli/commands/push-akb.js

@@ -0,0 +1,19 @@
+/**
+ * Push AKB command handler
+ * Uploads AKB (knowledge base) articles to NEWO platform
+ */
+import path from 'path';
+import { makeClient } from '../../api.js';
+import { pushAkb } from '../../sync/akb.js';
+import { getValidAccessToken } from '../../auth.js';
+import { requireSingleCustomer } from '../customer-selection.js';
+export async function handlePushAkbCommand(customerConfig, args, verbose) {
+    const selectedCustomer = requireSingleCustomer(customerConfig, args.customer);
+    const accessToken = await getValidAccessToken(selectedCustomer);
+    const client = await makeClient(verbose, accessToken);
+    const customerDir = path.join(process.cwd(), 'newo_customers', selectedCustomer.idn);
+    console.log(`📤 Pushing AKB articles for ${selectedCustomer.idn}...`);
+    await pushAkb(client, customerDir, verbose);
+    console.log(`✅ AKB articles pushed successfully`);
+}
+//# sourceMappingURL=push-akb.js.map

package/dist/cli/commands/push-integrations.d.ts

@@ -0,0 +1,3 @@
+import type { MultiCustomerConfig, CliArgs } from '../../types.js';
+export declare function handlePushIntegrationsCommand(customerConfig: MultiCustomerConfig, args: CliArgs, verbose: boolean): Promise<void>;
+//# sourceMappingURL=push-integrations.d.ts.map

package/dist/cli/commands/push-integrations.js

@@ -0,0 +1,19 @@
+/**
+ * Push integrations command handler
+ * Uploads integration and connector changes to NEWO platform
+ */
+import path from 'path';
+import { makeClient } from '../../api.js';
+import { pushIntegrations } from '../../sync/integrations.js';
+import { getValidAccessToken } from '../../auth.js';
+import { requireSingleCustomer } from '../customer-selection.js';
+export async function handlePushIntegrationsCommand(customerConfig, args, verbose) {
+    const selectedCustomer = requireSingleCustomer(customerConfig, args.customer);
+    const accessToken = await getValidAccessToken(selectedCustomer);
+    const client = await makeClient(verbose, accessToken);
+    const customerDir = path.join(process.cwd(), 'newo_customers', selectedCustomer.idn);
+    console.log(`📤 Pushing integration changes for ${selectedCustomer.idn}...`);
+    await pushIntegrations(client, customerDir, verbose);
+    console.log(`✅ Integration changes pushed successfully`);
+}
+//# sourceMappingURL=push-integrations.js.map

package/dist/cli.js

@@ -29,6 +29,12 @@ import { handleCreateParameterCommand } from './cli/commands/create-parameter.js
 import { handleCreatePersonaCommand } from './cli/commands/create-persona.js';
 import { handleCreateAttributeCommand } from './cli/commands/create-attribute.js';
 import { handleSandboxCommand } from './cli/commands/sandbox.js';
+import { handlePullIntegrationsCommand } from './cli/commands/pull-integrations.js';
+import { handlePushIntegrationsCommand } from './cli/commands/push-integrations.js';
+import { handleListActionsCommand } from './cli/commands/list-actions.js';
+import { handleProfileCommand } from './cli/commands/profile.js';
+import { handlePullAkbCommand } from './cli/commands/pull-akb.js';
+import { handlePushAkbCommand } from './cli/commands/push-akb.js';
 dotenv.config();
 async function main() {
     try {
@@ -131,6 +137,24 @@ async function main() {
             case 'create-attribute':
                 await handleCreateAttributeCommand(customerConfig, args, verbose);
                 break;
+            case 'pull-integrations':
+                await handlePullIntegrationsCommand(customerConfig, args, verbose);
+                break;
+            case 'push-integrations':
+                await handlePushIntegrationsCommand(customerConfig, args, verbose);
+                break;
+            case 'list-actions':
+                await handleListActionsCommand(customerConfig, args, verbose);
+                break;
+            case 'profile':
+                await handleProfileCommand(customerConfig, args, verbose);
+                break;
+            case 'pull-akb':
+                await handlePullAkbCommand(customerConfig, args, verbose);
+                break;
+            case 'push-akb':
+                await handlePushAkbCommand(customerConfig, args, verbose);
+                break;
             default:
                 console.error('Unknown command:', cmd);
                 console.error('Run "newo --help" for usage information');