newo 3.1.0 → 3.3.0

package/CHANGELOG.md

@@ -7,6 +7,226 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.3.0] - 2025-10-20
+
+### Added
+
+- **Account Migration System**: Fully automated account copying from source to destination
+  - `newo migrate-account` - Complete migration command with progress tracking
+  - Automatic webhook creation from YAML configuration files
+  - API mapping built from live API queries to prevent content loss
+  - Comprehensive migration includes all entities: projects, agents, flows, skills, attributes, AKB, integrations, connectors, webhooks
+  - Interactive confirmation with multi-stage progress indicators
+- **Migration Verification**: Compare entity counts between source and destination accounts
+  - `newo verify` - Verification command showing detailed entity comparison
+  - Entity count validation for projects, agents, flows, and skills
+  - SHA256 checksum verification for file integrity
+  - Webhook existence verification
+- **Webhook Creation**: Direct webhook creation from YAML files
+  - `newo create-webhooks` - Batch webhook creation command
+  - Support for both outgoing and incoming webhook types
+  - YAML-based configuration with automatic detection
+- **Migration Module** (`src/sync/migrate.ts`):
+  - Complete migration orchestration logic
+  - API mapping generation from live queries
+  - Webhook creation automation
+  - Progress tracking and error handling
+- **Enhanced API Functions**:
+  - `updateProject()` - Update project metadata on platform
+  - `updateAgent()` - Update agent metadata on platform
+  - `createOutgoingWebhook()` - Create outgoing webhooks via API
+  - `createIncomingWebhook()` - Create incoming webhooks via API
+
+### Enhanced
+
+- **Pull Command**: Deletion detection for entities removed remotely
+  - Interactive confirmation before deleting local entities
+  - Confirmation options: y (yes), n (no), a (all), q (quit)
+  - Prevents accidental deletion of local work
+  - Graceful handling of remote entity removal
+- **Status Command**: Full path display in error messages
+  - Complete paths shown: project/agent/flow/skill hierarchy
+  - Improved debugging with clear file location information
+- **Type Definitions**: Extended for enhanced metadata support
+  - `Agent.persona` field for persona association
+  - `ProjectMeta` fields: `is_auto_update_enabled`, `registry_idn`, `display_idn`, `svc_catalog_slug`
+  - Enhanced event creation metadata: `skill_selector`, `interrupt_mode`, `skill_idn`, `connector_idn`
+- **Help Command**: Updated documentation for migration commands
+  - Complete migration workflow documentation
+  - Verification command usage examples
+  - Webhook creation command reference
+
+### Fixed
+
+- **Pull Command**: No longer overwrites local files with empty API content
+  - Protection against data loss from API errors
+  - Validation of API response before writing files
+  - Skip empty content writes with warning messages
+- **Event Creation**: Full metadata preservation from source
+  - Event skill_selector properly copied
+  - Interrupt mode settings preserved
+  - Skill and connector IDN associations maintained
+- **Migration Script**: Proper map.json generation from API
+  - Builds ID mappings directly from API queries
+  - No longer depends on pull command execution
+  - Ensures accurate entity relationships
+
+### Testing
+
+- **Complete Account Migration**: Successfully migrated account with 1,084 skills
+  - Tested across 3 different test accounts
+  - 100% entity match validation (projects, agents, flows, skills)
+  - 100% file integrity verification (SHA256 checksums on attributes)
+  - 100% webhook creation success (all 5 webhooks verified)
+  - Migration time: ~30 minutes (vs 8-10 hours manual process)
+- **Entity Count Verification**: Automated comparison validates all entity types
+- **Webhook Creation**: Batch webhook creation from YAML files tested and verified
+
+### Performance
+
+- **Migration Speed**: 96% time reduction compared to manual migration
+  - Automated process: ~30 minutes
+  - Manual process: 8-10 hours
+- **Reliability**: 100% success rate across multiple test migrations
+- **Data Integrity**: Full SHA256 verification ensures zero data loss
+
+## [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 +918,9 @@ 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.3.0...HEAD
+[3.3.0]: https://github.com/sabbah13/newo-cli/compare/v3.2.0...v3.3.0
+[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,43 @@ 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>;
+export declare function updateProject(client: AxiosInstance, projectId: string, updateData: Partial<{
+    title: string;
+    description: string;
+    is_auto_update_enabled: boolean;
+    registry_idn: string;
+    registry_item_idn: string | null;
+    registry_item_version: string | null;
+}>): Promise<void>;
+export declare function updateAgent(client: AxiosInstance, agentId: string, updateData: Partial<{
+    title: string;
+    description: string;
+    persona_id: string | null;
+}>): Promise<void>;
+export declare function createOutgoingWebhook(client: AxiosInstance, webhookData: {
+    connector_idn: string;
+    event_idn: string;
+    url: string;
+    method: string;
+    headers?: Record<string, string>;
+    body_template?: string;
+}): Promise<{
+    id: string;
+}>;
+export declare function createIncomingWebhook(client: AxiosInstance, webhookData: {
+    connector_idn: string;
+    event_idn: string;
+}): Promise<{
+    id: string;
+    url: string;
+}>;
 //# 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,64 @@ 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;
+}
+// Project update
+export async function updateProject(client, projectId, updateData) {
+    await client.put(`/api/v1/designer/projects/${projectId}`, updateData);
+}
+// Agent update
+export async function updateAgent(client, agentId, updateData) {
+    await client.put(`/api/v1/designer/agents/${agentId}`, updateData);
+}
+// Webhook creation
+export async function createOutgoingWebhook(client, webhookData) {
+    const response = await client.post('/api/v1/webhooks', webhookData);
+    return response.data;
+}
+export async function createIncomingWebhook(client, webhookData) {
+    const response = await client.post('/api/v1/webhooks/incoming', webhookData);
+    return response.data;
+}
 //# sourceMappingURL=api.js.map

package/dist/cli/commands/create-webhooks.d.ts

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

package/dist/cli/commands/create-webhooks.js

@@ -0,0 +1,83 @@
+/**
+ * Webhook creation command handler
+ */
+import { makeClient } from '../../api.js';
+import { getValidAccessToken } from '../../auth.js';
+import { selectSingleCustomer } from '../customer-selection.js';
+import { customerDir } from '../../fsutil.js';
+import fs from 'fs-extra';
+import yaml from 'js-yaml';
+import path from 'path';
+export async function handleCreateWebhooksCommand(customerConfig, args, verbose) {
+    const { selectedCustomer } = selectSingleCustomer(customerConfig, args.customer);
+    if (!selectedCustomer) {
+        console.error('❌ No customer selected');
+        process.exit(1);
+    }
+    const accessToken = await getValidAccessToken(selectedCustomer);
+    const client = await makeClient(verbose, accessToken);
+    console.log(`\n📡 Creating webhooks for ${selectedCustomer.idn}...\n`);
+    const custDir = customerDir(selectedCustomer.idn);
+    let outgoingCreated = 0;
+    let incomingCreated = 0;
+    // Create outgoing webhooks
+    const outgoingFile = path.join(custDir, 'integrations/api/connectors/webhook/webhooks/outgoing.yaml');
+    if (await fs.pathExists(outgoingFile)) {
+        const outgoingData = yaml.load(await fs.readFile(outgoingFile, 'utf8'));
+        const webhooks = outgoingData.webhooks || [];
+        console.log(`Found ${webhooks.length} outgoing webhooks in YAML file`);
+        for (const webhook of webhooks) {
+            try {
+                await client.post('/api/v1/webhooks', {
+                    idn: webhook.idn,
+                    description: webhook.description || '',
+                    connector_idn: webhook.connector_idn,
+                    url: webhook.url,
+                    command_idns: webhook.command_idns || []
+                });
+                outgoingCreated++;
+                console.log(`   ✅ Created outgoing: ${webhook.idn}`);
+            }
+            catch (error) {
+                const status = error.response?.status;
+                if (status === 409) {
+                    console.log(`   ℹ️  Already exists: ${webhook.idn}`);
+                }
+                else {
+                    console.error(`   ❌ Failed: ${webhook.idn} - ${error.response?.data?.reason || error.message}`);
+                }
+            }
+        }
+    }
+    // Create incoming webhooks
+    const incomingFile = path.join(custDir, 'integrations/api/connectors/webhook/webhooks/incoming.yaml');
+    if (await fs.pathExists(incomingFile)) {
+        const incomingData = yaml.load(await fs.readFile(incomingFile, 'utf8'));
+        const webhooks = incomingData.webhooks || [];
+        console.log(`\nFound ${webhooks.length} incoming webhooks in YAML file`);
+        for (const webhook of webhooks) {
+            try {
+                await client.post('/api/v1/webhooks/incoming', {
+                    idn: webhook.idn,
+                    description: webhook.description || '',
+                    connector_idn: webhook.connector_idn,
+                    event_idns: webhook.event_idns || [],
+                    allowed_ips: webhook.allowed_ips || []
+                });
+                incomingCreated++;
+                console.log(`   ✅ Created incoming: ${webhook.idn}`);
+            }
+            catch (error) {
+                const status = error.response?.status;
+                if (status === 409) {
+                    console.log(`   ℹ️  Already exists: ${webhook.idn}`);
+                }
+                else {
+                    console.error(`   ❌ Failed: ${webhook.idn} - ${error.response?.data?.reason || error.message}`);
+                }
+            }
+        }
+    }
+    console.log(`\n✅ Created ${outgoingCreated} outgoing and ${incomingCreated} incoming webhooks\n`);
+}
+//# sourceMappingURL=create-webhooks.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,17 @@ 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
+
+Account Migration (NEW):
+  newo migrate-account --source <idn> --dest <idn> [--yes]  # migrate complete account from source to destination
+  newo verify --source <idn> --dest <idn>                    # verify migration by comparing entity counts
+  newo create-webhooks [--customer <idn>]                    # create webhooks from YAML files
 
 Flags:
   --customer <idn>             # specify customer (if not set, uses default or interactive selection)
@@ -122,8 +133,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/migrate-account.d.ts

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