Helios-9 MCP Server

Instructions

Implementation Reference

• src/tools/initiatives.ts:594-613 (handler)

  The primary handler function that executes the disassociate_document_from_initiative tool logic. It validates the initiative_id and document_id using Zod, logs the action, calls the Supabase service method to perform the disassociation, logs success, and returns a structured success response.

  export const disassociateDocumentFromInitiative = requireAuth(async (args: any) => {
    const { initiative_id, document_id } = z.object({
      initiative_id: z.string().uuid(),
      document_id: z.string().uuid()
    }).parse(args)
    
    logger.info('Disassociating document from initiative', { initiative_id, document_id })
    
    // Call the API to remove the association
    const response = await supabaseService.disassociateDocumentFromInitiative(initiative_id, document_id)
    
    logger.info('Document disassociated from initiative successfully')
    
    return {
      success: true,
      message: `Document successfully disassociated from initiative`,
      initiative_id,
      document_id
    }
  })

• src/tools/initiatives.ts:573-592 (schema)

  The MCPTool object definition providing the tool name, description, and input schema (JSON Schema) for validation of initiative_id and document_id parameters.

  export const disassociateDocumentFromInitiativeTool: MCPTool = {
    name: 'disassociate_document_from_initiative',
    description: 'Remove the link between a document and an initiative',
    inputSchema: {
      type: 'object',
      properties: {
        initiative_id: {
          type: 'string',
          format: 'uuid',
          description: 'The initiative ID to disassociate the document from'
        },
        document_id: {
          type: 'string',
          format: 'uuid',
          description: 'The document ID to disassociate from the initiative'
        }
      },
      required: ['initiative_id', 'document_id']
    }
  }

• src/tools/initiatives.ts:630-642 (registration)

  Local registry mapping tool names to their handler functions, including disassociate_document_from_initiative mapped to its handler.

  export const initiativeHandlers = {
    list_initiatives: listInitiatives,
    get_initiative: getInitiative,
    create_initiative: createInitiative,
    update_initiative: updateInitiative,
    get_initiative_context: getInitiativeContext,
    get_initiative_insights: getInitiativeInsights,
    search_workspace: searchWorkspace,
    get_enhanced_project_context: getEnhancedProjectContext,
    get_workspace_context: getWorkspaceContext,
    associate_document_with_initiative: associateDocumentWithInitiative,
    disassociate_document_from_initiative: disassociateDocumentFromInitiative
  }

• src/index.ts:143-155 (registration)

  Global MCP server handler registry where initiativeHandlers (containing disassociate_document_from_initiative) is spread into the master allHandlers object used for tool execution.

  this.allHandlers = {
    ...projectHandlers,
    ...taskHandlers,
    ...documentHandlers,
    ...conversationHandlers,
    ...contextAggregationHandlers,
    ...workflowAutomationHandlers,
    ...intelligentSearchHandlers,
    ...analyticsInsightsHandlers,
    ...initiativeHandlers,
    ...promptToProjectTools.reduce((acc, tool) => ({ ...acc, [tool.name]: tool.handler }), {}),
    ...debugHandlers,
  }

• src/lib/api-client.ts:576-583 (helper)

  Supporting API client method invoked by the tool handler to send a DELETE request to the backend API endpoint for disassociating a document from an initiative.

  async disassociateDocumentFromInitiative(initiativeId: string, documentId: string): Promise<any> {
    const response = await this.request<{ success: boolean }>(`/api/mcp/initiatives/${initiativeId}/documents/${documentId}`, {
      method: 'DELETE',
    })
    
    logger.info(`Document ${documentId} disassociated from initiative ${initiativeId}`)
    return response
  }