snow-flow 1.4.49 → 2.0.0

package/src/types/index.ts

@@ -0,0 +1,183 @@
+// Core types for snow-flow CLI
+
+export interface CLIConfig {
+  version: string;
+  instanceUrl?: string;
+  authType?: 'oauth' | 'basic';
+  credentials?: AuthCredentials;
+  memory?: MemoryConfig;
+  claude?: ClaudeConfig;
+}
+
+export interface AuthCredentials {
+  oauth?: {
+    clientId: string;
+    clientSecret: string;
+    refreshToken?: string;
+    accessToken?: string;
+    tokenExpiry?: number;
+  };
+  basic?: {
+    username: string;
+    password: string;
+  };
+}
+
+export interface MemoryConfig {
+  storageDir: string;
+  maxSize: number;
+  ttl: number;
+}
+
+export interface ClaudeConfig {
+  apiKey?: string;
+  model?: string;
+  maxTokens?: number;
+}
+
+export interface SwarmOptions {
+  strategy?: 'research' | 'development' | '_analysis' | 'testing' | 'optimization' | 'maintenance';
+  mode?: 'centralized' | 'distributed' | 'hierarchical' | 'mesh' | 'hybrid';
+  maxAgents?: number;
+  parallel?: boolean;
+  monitor?: boolean;
+  output?: 'json' | 'sqlite' | 'csv' | 'html';
+}
+
+export interface Agent {
+  id: string;
+  name: string;
+  type: AgentType;
+  status: 'idle' | 'busy' | 'error';
+  capabilities: string[];
+  memory?: Record<string, any>;
+  createdAt: Date;
+}
+
+export type AgentType = 
+  | 'coordinator'
+  | 'researcher'
+  | 'coder'
+  | 'analyst'
+  | 'architect'
+  | 'tester'
+  | 'reviewer'
+  | 'optimizer'
+  | 'documenter'
+  | 'monitor'
+  | 'specialist'
+  | 'schema-designer'
+  | 'widget-builder'
+  | 'workflow-designer'
+  | 'script-generator'
+  | 'security-agent'
+  | 'update-set-manager'
+  | 'ui-ux-specialist'
+  | 'approval-specialist'
+  | 'security-specialist'
+  | 'css-specialist'
+  | 'backend-specialist'
+  | 'frontend-specialist'
+  | 'performance-specialist';
+
+export interface Task {
+  id: string;
+  description: string;
+  status: 'pending' | 'in_progress' | 'completed' | 'failed';
+  priority: 'low' | 'medium' | 'high' | 'critical';
+  assignedAgent?: string;
+  dependencies?: string[];
+  result?: any;
+  error?: string;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+export interface MemoryEntry {
+  key: string;
+  value: any;
+  namespace: string;
+  ttl?: number;
+  createdAt: Date;
+  expiresAt?: Date;
+}
+
+export interface ServiceNowWidget {
+  name: string;
+  id?: string;
+  template: string;
+  controller: string;
+  css?: string;
+  serverScript?: string;
+  clientScript?: string;
+  dependencies?: string[];
+  options?: Record<string, any>;
+}
+
+export interface ServiceNowApp {
+  name: string;
+  scope: string;
+  version: string;
+  description?: string;
+  tables?: ServiceNowTable[];
+  widgets?: ServiceNowWidget[];
+  scripts?: ServiceNowScript[];
+  workflows?: ServiceNowWorkflow[];
+  updateSets?: ServiceNowUpdateSet[];
+}
+
+export interface ServiceNowTable {
+  name: string;
+  label: string;
+  extends?: string;
+  fields: ServiceNowField[];
+}
+
+export interface ServiceNowField {
+  name: string;
+  label: string;
+  type: string;
+  reference?: string;
+  mandatory?: boolean;
+  defaultValue?: any;
+}
+
+export interface ServiceNowScript {
+  name: string;
+  type: 'business_rule' | 'script_include' | 'client_script' | 'ui_action';
+  script: string;
+  active: boolean;
+  table?: string;
+  when?: string;
+}
+
+export interface ServiceNowWorkflow {
+  name: string;
+  description?: string;
+  table: string;
+  active: boolean;
+  activities: WorkflowActivity[];
+}
+
+export interface WorkflowActivity {
+  name: string;
+  type: string;
+  config: Record<string, any>;
+  transitions: WorkflowTransition[];
+}
+
+export interface WorkflowTransition {
+  to: string;
+  condition?: string;
+}
+
+export interface ServiceNowUpdateSet {
+  name: string;
+  description?: string;
+  state: 'in_progress' | 'complete' | 'ignore';
+  release_date?: Date;
+  sys_id?: string;
+}
+
+// Re-export coordination framework types
+export * from './snow-flow.types';

package/src/types/neo4j-driver.d.ts

@@ -0,0 +1,23 @@
+declare module 'neo4j-driver' {
+  export interface Driver {
+    session(): Session;
+    close(): Promise<void>;
+    verifyConnectivity(): Promise<void>;
+  }
+
+  export interface Session {
+    run(query: string, params?: any): Promise<any>;
+    close(): Promise<void>;
+  }
+
+  export const auth: {
+    basic(username: string, password: string): any;
+  };
+
+  export function driver(url: string, auth: any): Driver;
+
+  export default {
+    driver,
+    auth
+  };
+}

package/src/types/servicenow.types.ts

@@ -0,0 +1,307 @@
+export interface ServicePortalWidget {
+  sys_id?: string;
+  name: string;
+  id: string;
+  template: string;
+  css?: string;
+  client_script?: string;
+  server_script?: string;
+  option_schema?: string;
+  public?: boolean;
+  roles?: string;
+  data?: any;
+}
+
+export interface FlowDesignerFlow {
+  sys_id?: string;
+  name: string;
+  description?: string;
+  active: boolean;
+  trigger: FlowTrigger;
+  actions: FlowAction[];
+  created_by?: string;
+  updated_on?: string;
+}
+
+export interface FlowTrigger {
+  type: 'record' | 'schedule' | 'application';
+  table?: string;
+  condition?: string;
+  schedule?: string;
+}
+
+export interface FlowAction {
+  name: string;
+  type: string;
+  configuration: Record<string, any>;
+  order: number;
+}
+
+export interface BusinessRule {
+  sys_id?: string;
+  name: string;
+  table: string;
+  when: 'before' | 'after' | 'async' | 'display';
+  insert: boolean;
+  update: boolean;
+  delete: boolean;
+  query: boolean;
+  active: boolean;
+  order: number;
+  condition?: string;
+  script: string;
+  description?: string;
+}
+
+export interface ScriptInclude {
+  sys_id?: string;
+  name: string;
+  api_name: string;
+  script: string;
+  active: boolean;
+  access?: 'package_private' | 'public';
+  client_callable?: boolean;
+  description?: string;
+}
+
+export interface UIBuilderPage {
+  sys_id?: string;
+  name: string;
+  title: string;
+  route: string;
+  layout: UIBuilderLayout;
+  data_resources: DataResource[];
+  client_scripts: ClientStateScript[];
+  parameters?: PageParameter[];
+}
+
+export interface UIBuilderLayout {
+  type: 'container' | 'grid' | 'flex';
+  components: UIComponent[];
+  styles?: Record<string, any>;
+}
+
+export interface UIComponent {
+  id: string;
+  type: string;
+  properties: Record<string, any>;
+  children?: UIComponent[];
+  events?: ComponentEvent[];
+}
+
+export interface DataResource {
+  name: string;
+  type: 'table' | 'script' | 'rest';
+  configuration: Record<string, any>;
+}
+
+export interface ClientStateScript {
+  name: string;
+  script: string;
+  parameters?: string[];
+}
+
+export interface PageParameter {
+  name: string;
+  type: string;
+  required: boolean;
+  default_value?: any;
+}
+
+export interface ComponentEvent {
+  name: string;
+  action_type: string;
+  action_configuration: Record<string, any>;
+}
+
+export interface ServiceNowApplication {
+  sys_id?: string;
+  name: string;
+  scope: string;
+  version: string;
+  short_description?: string;
+  description?: string;
+  vendor?: string;
+  vendor_prefix?: string;
+  active: boolean;
+  tables?: ApplicationTable[];
+  modules?: ApplicationModule[];
+  roles?: ApplicationRole[];
+}
+
+export interface ApplicationTable {
+  name: string;
+  label: string;
+  plural_label: string;
+  extends_table?: string;
+  fields: TableField[];
+}
+
+export interface TableField {
+  name: string;
+  label: string;
+  type: string;
+  max_length?: number;
+  mandatory?: boolean;
+  default_value?: any;
+  reference?: string;
+  choice_list?: Choice[];
+}
+
+export interface Choice {
+  value: string;
+  label: string;
+  order?: number;
+}
+
+export interface ApplicationModule {
+  name: string;
+  title: string;
+  table: string;
+  view?: string;
+  order: number;
+  active: boolean;
+  roles?: string[];
+}
+
+export interface ApplicationRole {
+  name: string;
+  suffix: string;
+  description?: string;
+  contains_roles?: string[];
+}
+
+export interface UpdateSet {
+  sys_id?: string;
+  name: string;
+  description?: string;
+  state: 'in_progress' | 'complete' | 'testing';
+  application?: string;
+  release_date?: string;
+}
+
+export interface ServiceNowAgentConfig {
+  instance: string;
+  auth: {
+    type: 'basic' | 'oauth2';
+    credentials: any;
+  };
+  updateSet?: string;
+  application?: string;
+}
+
+export type ServiceNowOperation = 
+  | 'widget.create'
+  | 'widget.update'
+  | 'widget.delete'
+  | 'flow.create'
+  | 'flow.update'
+  | 'flow.execute'
+  | 'script.create'
+  | 'script.update'
+  | 'ui.create'
+  | 'ui.update'
+  | 'app.create'
+  | 'app.update'
+  | 'table.create'
+  | 'table.update';
+
+export interface ServiceNowAPIResponse<T = any> {
+  result: T;
+  error?: {
+    message: string;
+    detail: string;
+  };
+}
+
+// Core agent types
+export type AgentType = 'widget-builder' | 'workflow-designer' | 'script-generator' | 'ui-builder' | 'app-creator' | 'generic';
+
+export interface ServiceNowConfig {
+  instance: string;
+  username: string;
+  password: string;
+  clientId?: string;
+  clientSecret?: string;
+}
+
+export interface AgentTask {
+  id: string;
+  type: string;
+  description: string;
+  payload: any;
+  priority: 'low' | 'medium' | 'high' | 'critical';
+  dependencies?: string[];
+  assignedAgent?: string;
+  status?: 'pending' | 'in_progress' | 'completed' | 'failed';
+}
+
+export interface AgentResult {
+  success: boolean;
+  data?: any;
+  error?: string;
+  artifacts?: ServiceNowArtifact[];
+  commands?: OrchestrationCommand[];
+}
+
+export interface ServiceNowAgent {
+  id: string;
+  name: string;
+  type: AgentType;
+  capabilities: string[];
+  active: boolean;
+  currentTask?: AgentTask;
+}
+
+export interface OrchestrationCommand {
+  tool: string;
+  parameters: any;
+}
+
+export interface ServiceNowArtifact {
+  type: string;
+  name: string;
+  content: any;
+  path?: string;
+}
+
+export interface ScopedApplication {
+  sys_id?: string;
+  name: string;
+  scope: string;
+  vendor: string;
+  vendor_prefix: string;
+  version: string;
+  description?: string;
+  active: boolean;
+  private?: boolean;
+  tables?: ApplicationTable[];
+  menus?: ApplicationMenu[];
+  roles?: ApplicationRole[];
+}
+
+export interface ApplicationMenu {
+  name: string;
+  label: string;
+  application: string;
+  modules: MenuModule[];
+  order?: number;
+}
+
+export interface MenuModule {
+  name: string;
+  label: string;
+  type: 'list' | 'form' | 'page' | 'separator';
+  table?: string;
+  view?: string;
+  order: number;
+  roles?: string[];
+}
+
+export interface UpdateSet {
+  sys_id?: string;
+  name: string;
+  description?: string;
+  state: 'in_progress' | 'complete' | 'testing';
+  application?: string;
+}

package/src/types/snow-flow.types.ts

@@ -0,0 +1,186 @@
+import { EventEmitter } from 'eventemitter3';
+
+export interface SnowAgent {
+  id: string;
+  name: string;
+  type: AgentType;
+  status: AgentStatus;
+  capabilities: string[];
+  metadata: Record<string, any>;
+  createdAt: Date;
+  lastActivity: Date;
+}
+
+export type AgentType = 
+  | 'coordinator'
+  | 'researcher' 
+  | 'coder'
+  | 'analyst'
+  | 'architect'
+  | 'tester'
+  | 'reviewer'
+  | 'optimizer'
+  | 'documenter'
+  | 'monitor'
+  | 'servicenow-specialist'
+  | 'workflow-designer'
+  | 'ui-builder'
+  | 'security-auditor'
+  | 'integration-specialist'
+  // 🚀 NEW: Specialized agents for parallel execution (v1.1.91)
+  | 'widget-creator'          // Widget development specialist
+  | 'widget-builder'          // Widget builder (alias)
+  | 'flow-builder'            // Flow development specialist
+  | 'script-writer'           // Script development specialist
+  | 'security-agent'          // Security _analysis specialist (alias)
+  | 'app-architect'           // Application architecture specialist
+  | 'css-specialist'          // Styling and responsive design specialist
+  | 'backend-specialist'      // Server script specialist
+  | 'frontend-specialist'     // Client script specialist
+  | 'ui-ux-specialist'        // User experience specialist
+  | 'performance-specialist'  // Performance optimization
+  | 'accessibility-specialist'// Accessibility compliance
+  | 'trigger-specialist'      // Flow trigger configuration
+  | 'action-specialist'       // Flow action development
+  | 'approval-specialist'     // Approval process specialist
+  | 'notification-specialist' // Notification configuration
+  | 'error-handler'          // Error handling specialist
+  | 'security-specialist'     // Security implementation
+  | 'api-specialist'         // API integration specialist
+  | 'transform-specialist'    // Data transformation specialist
+  | 'monitoring-specialist'   // Integration monitoring
+  | 'documentation-specialist';// Documentation specialist
+
+export type AgentStatus = 'idle' | 'busy' | 'error' | 'terminated';
+
+export interface Task {
+  id: string;
+  type: TaskType;
+  description: string;
+  priority: TaskPriority;
+  status: TaskStatus;
+  assignedAgent?: string;
+  dependencies: string[];
+  result?: any;
+  error?: Error;
+  createdAt: Date;
+  startedAt?: Date;
+  completedAt?: Date;
+  metadata: Record<string, any>;
+}
+
+export type TaskType = 
+  | 'research'
+  | 'development'
+  | '_analysis'
+  | 'testing'
+  | 'optimization'
+  | 'documentation'
+  | 'servicenow-config'
+  | 'servicenow-script'
+  | 'servicenow-workflow'
+  | 'servicenow-ui';
+
+export type TaskPriority = 'low' | 'medium' | 'high' | 'critical';
+export type TaskStatus = 'pending' | 'in_progress' | 'completed' | 'failed' | 'cancelled';
+
+export interface SwarmConfig {
+  maxAgents: number;
+  topology: SwarmTopology;
+  strategy: SwarmStrategy;
+  enableParallel: boolean;
+  enableMonitoring: boolean;
+  memoryNamespace: string;
+}
+
+export type SwarmTopology = 'hierarchical' | 'mesh' | 'ring' | 'star';
+export type SwarmStrategy = 'balanced' | 'specialized' | 'adaptive' | 'auto';
+
+export interface MemoryEntry {
+  key: string;
+  value: any;
+  namespace: string;
+  ttl?: number;
+  createdAt: Date;
+  updatedAt: Date;
+  accessCount: number;
+  metadata: Record<string, any>;
+}
+
+export interface OrchestratorEvents {
+  'agent:spawned': (agent: SnowAgent) => void;
+  'agent:terminated': (agentId: string) => void;
+  'agent:status': (agentId: string, status: AgentStatus) => void;
+  'task:created': (task: Task) => void;
+  'task:assigned': (taskId: string, agentId: string) => void;
+  'task:completed': (taskId: string, result: any) => void;
+  'task:failed': (taskId: string, error: Error) => void;
+  'swarm:initialized': (config: SwarmConfig) => void;
+  'error': (error: Error) => void;
+}
+
+export interface BaseOrchestratorOptions {
+  maxConcurrentTasks?: number;
+  taskTimeout?: number;
+  memoryNamespace?: string;
+  enableLogging?: boolean;
+  logLevel?: 'debug' | 'info' | 'warn' | 'error';
+}
+
+export interface ServiceNowConfig {
+  instance: string;
+  username?: string;
+  password?: string;
+  clientId?: string;
+  clientSecret?: string;
+  authMethod: 'basic' | 'oauth';
+  apiVersion?: string;
+}
+
+export interface ServiceNowContext {
+  config: ServiceNowConfig;
+  currentApp?: string;
+  updateSet?: string;
+  scope?: string;
+  tables?: string[];
+}
+
+export interface AgentMessage {
+  from: string;
+  to: string;
+  type: MessageType;
+  payload: any;
+  timestamp: Date;
+  correlationId?: string;
+}
+
+export type MessageType = 
+  | 'task_assignment'
+  | 'task_result'
+  | 'coordination'
+  | 'knowledge_share'
+  | 'status_update'
+  | 'error';
+
+export interface WorkflowDefinition {
+  id: string;
+  name: string;
+  description: string;
+  steps: WorkflowStep[];
+  triggers?: WorkflowTrigger[];
+  variables?: Record<string, any>;
+}
+
+export interface WorkflowStep {
+  id: string;
+  name: string;
+  type: string;
+  config: Record<string, any>;
+  dependencies: string[];
+  outputs?: string[];
+}
+
+export interface WorkflowTrigger {
+  type: 'manual' | 'schedule' | 'event' | 'webhook';
+  config: Record<string, any>;
+}