opclawtm 1.4.0

package/dist/core/utils/openclaw-helper.d.ts

@@ -0,0 +1,250 @@
+/**
+ * OpenClaw Integration Helper Functions
+ */
+import { Agent } from '../models/types';
+/**
+ * OpenClaw Session info
+ */
+export interface OpenClawSession {
+    sessionKey: string;
+    agentId?: string;
+    workspacePath?: string;
+}
+/**
+ * Get Agent's Session Key
+ *
+ * In OpenClaw, each Agent can have independent session
+ * Session Key format: agent:<agentId>:main
+ */
+export declare function getAgentSessionKey(agentId: string): string;
+/**
+ * Get Agent's workspace path
+ */
+export declare function getAgentWorkspacePath(agentId: string): string;
+/**
+ * Prepare Agent Session context
+ *
+ * Returns context info needed to start Agent Session
+ */
+export declare function prepareAgentContext(agentId: string): {
+    success: boolean;
+    agent?: {
+        id: string;
+        name: string;
+        role: string;
+        department_id: string | null;
+        job_id: string | null;
+    };
+    workspace_path?: string;
+    session_key?: string;
+    message?: string;
+};
+/**
+ * Create Agent directory structure
+ *
+ * Follows OpenClaw official standard:
+ * - workspace-<agentId>/  workspace
+ * - agents/<agentId>/agent/  Agent directory (auth-profiles.json etc.)
+ * - agents/<agentId>/sessions/  session storage
+ */
+export declare function createAgentDirectories(agentId: string): {
+    workspace: string;
+    agentDir: string;
+    sessionsDir: string;
+};
+/**
+ * Create Agent files
+ *
+ * Includes:
+ * - AGENTS.md
+ * - SOUL.md
+ * - USER.md
+ * - MEMORY.md
+ * - TOOLS.md
+ * - auth-profiles.json
+ */
+export declare function createAgentFiles(agentId: string, options: {
+    name: string;
+    role: string;
+    departmentId?: string;
+    jobId?: string;
+}): void;
+/**
+ * Sync team member info to all affected agents
+ *
+ * When a new agent is created or deleted, update all agents in the same department
+ * with the new team member information in their AGENTS.md files.
+ */
+export declare function syncTeamMemberInfo(departmentId: string, excludeAgentId?: string): {
+    success: boolean;
+    updatedCount: number;
+    message: string;
+};
+/**
+ * Sync assistant's AGENTS.md with latest team member info
+ *
+ * The assistant sees all team members across all departments.
+ * This should be called when any agent is created or deleted.
+ */
+export declare function syncAssistantTeamMembers(): {
+    success: boolean;
+    message: string;
+};
+/**
+ * Sync Agent to OpenClaw config file
+ *
+ * After creating Agent, need to add it to openclaw.json config
+ * Follows official standard format
+ *
+ * Note: Never set default=true for any agent created by team-manager
+ * Preserve the original default agent if exists
+ */
+export declare function syncOpenClawConfig(agent: Agent): {
+    success: boolean;
+    message: string;
+};
+/**
+ * Remove Agent from OpenClaw config
+ *
+ * Cleans up:
+ * 1. agents.list - remove agent entry
+ * 2. bindings - remove all bindings for this agent
+ * 3. channels.feishu.accounts - remove feishu account config
+ * 4. tools.agentToAgent.allow - remove from communication whitelist
+ *
+ * Note: Cannot remove main/assistant agent
+ */
+export declare function removeAgentFromConfig(agentId: string): {
+    success: boolean;
+    message: string;
+};
+/**
+ * Update Agent Allow List for team isolation
+ *
+ * When an agent is created or deleted, update the allowAgents list
+ * for all agents in the same team.
+ *
+ * Rules:
+ * - Team members can spawn to each other
+ * - Assistant (main) has allowAgents: ["*"]
+ * - Cross-team spawning is not allowed
+ *
+ * @param agentId - The agent that was created or will be deleted
+ * @param departmentId - The department ID the agent belongs to
+ * @param action - 'add' | 'remove'
+ * @returns Result with affected agents and changes
+ */
+/**
+ * Update Agent-to-Agent Communication Allow List
+ *
+ * Updates tools.agentToAgent.allow in openclaw.json
+ * This is the official OpenClaw configuration for agent-to-agent communication control.
+ *
+ * Rules:
+ * - All team members can communicate with each other
+ * - Assistant (main) can communicate with all agents (use "*")
+ * - Cross-team communication is allowed through this shared allow list
+ *
+ * @param agentId - The agent that was created or will be deleted
+ * @param departmentId - The department ID the agent belongs to (not used in global config)
+ * @param action - 'add' | 'remove'
+ * @returns Result with old and new allow list values
+ */
+export declare function updateAgentToAgentAllow(agentId: string, departmentId: string | null, action: 'add' | 'remove'): {
+    success: boolean;
+    message: string;
+    oldValue: string[];
+    newValue: string[];
+};
+/**
+ * Initialize agentToAgent configuration
+ *
+ * Called during system initialization to set up agent-to-agent communication.
+ * Builds the allow list from all existing agents.
+ */
+export declare function initializeAgentToAgentConfig(): {
+    success: boolean;
+    message: string;
+    allowList: string[];
+};
+/**
+ * Legacy function for backward compatibility
+ * @deprecated Use updateAgentToAgentAllow instead
+ */
+export declare function updateAgentAllowList(agentId: string, departmentId: string | null, action: 'add' | 'remove'): {
+    success: boolean;
+    message: string;
+    affectedAgents: string[];
+    changes: Array<{
+        agentId: string;
+        oldValue: string[];
+        newValue: string[];
+    }>;
+};
+/**
+ * Get Gateway restart reminder message
+ *
+ * After deleting agents/departments, Feishu WebSocket connections
+ * are still stored in Gateway process memory. Manual restart is required.
+ *
+ * @returns Reminder message for user to restart Gateway manually
+ */
+export declare function getGatewayRestartReminder(): string;
+/**
+ * Sync Feishu group info to all team members
+ *
+ * When a department binds/unbinds a Feishu group, update all members' AGENTS.md
+ *
+ * @param departmentId Department ID
+ * @param groupId Feishu group ID (null for unbind)
+ * @returns Sync result
+ */
+export declare function syncTeamFeishuGroup(departmentId: string, groupId: string | null): {
+    success: boolean;
+    updatedCount: number;
+    message: string;
+};
+/**
+ * Regenerate Agent Files
+ *
+ * Regenerates all agent files (AGENTS.md, SOUL.md, USER.md, MEMORY.md)
+ * from the latest database templates and agent data.
+ *
+ * @param excludeAgentIds - Agent IDs to exclude (default: ['main', 'watchdog_main'])
+ * @returns Result with regenerated count and any errors
+ */
+export declare function regenerateAgentFiles(excludeAgentIds?: string[]): {
+    success: boolean;
+    regeneratedCount: number;
+    errors: string[];
+    message: string;
+};
+/**
+ * Regenerate files for a single agent
+ *
+ * @param agentId - Agent ID to regenerate files for
+ * @returns Result with details
+ */
+export declare function regenerateAgentFilesById(agentId: string): {
+    success: boolean;
+    message: string;
+};
+/**
+ * OpenClaw integration helper service
+ */
+export declare const openclawHelper: {
+    getAgentSessionKey: typeof getAgentSessionKey;
+    getAgentWorkspacePath: typeof getAgentWorkspacePath;
+    prepareAgentContext: typeof prepareAgentContext;
+    createAgentDirectories: typeof createAgentDirectories;
+    createAgentFiles: typeof createAgentFiles;
+    syncOpenClawConfig: typeof syncOpenClawConfig;
+    removeAgentFromConfig: typeof removeAgentFromConfig;
+    updateAgentAllowList: typeof updateAgentAllowList;
+    updateAgentToAgentAllow: typeof updateAgentToAgentAllow;
+    initializeAgentToAgentConfig: typeof initializeAgentToAgentConfig;
+    syncTeamFeishuGroup: typeof syncTeamFeishuGroup;
+    regenerateAgentFiles: typeof regenerateAgentFiles;
+    regenerateAgentFilesById: typeof regenerateAgentFilesById;
+};
+//# sourceMappingURL=openclaw-helper.d.ts.map

package/dist/core/utils/openclaw-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-helper.d.ts","sourceRoot":"","sources":["../../../src/core/utils/openclaw-helper.ts"],"names":[],"mappings":"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"}